The Give Hub Developer Platform

Build applications that connect remote communities with global donors through our secure, blockchain-enabled crowdfunding platform.

Quick Start

Get Started in 3 Steps
  1. Create a developer account and get your API keys
  2. Install our SDK for your platform
  3. Make your first API call

// Initialize the app
const app = {
    init() {
        // Initialize The Give Hub client
        this.client = new GiveHubSDK({
            apiKey: 'YOUR_API_KEY',
            environment: 'sandbox' // or 'production'
        });
        
        // Set up event listeners
        this.setupEventListeners();
    },
    
    async createCampaign() {
        try {
            const campaign = await this.client.campaigns.create({
                title: 'Solar-Powered Water Pump',
                description: 'Providing clean water access to remote village',
                targetAmount: 5000,
                location: {
                    country: 'Kenya',
                    region: 'Samburu'
                }
            });
            console.log('Campaign created:', campaign.id);
        } catch (error) {
            console.error('Error creating campaign:', error);
        }
    }
};

// Initialize app
window.app = app;
app.init();

Platform Overview

Since our launch in 2021, The Give Hub has been connecting remote communities with global donors through our blockchain-enabled platform. Our infrastructure is built on three core principles:

Transparency

Every transaction is recorded on the Stellar blockchain, providing immutable proof of fund movement and utilization.

Impact Verification

Our unique impact tracking system ensures donors can see the real-world results of their contributions.

Global Access

Supporting 32 countries with mobile-first infrastructure and minimal technical requirements.

Authentication

The Give Hub uses JWT-based authentication. All API requests must include an Authorization header with a valid access token.


// Authenticate user
async function login(email, password) {
    try {
        const response = await app.client.auth.login(email, password);
        localStorage.setItem('accessToken', response.tokens.accessToken);
        localStorage.setItem('refreshToken', response.tokens.refreshToken);
        return response.user;
    } catch (error) {
        console.error('Authentication failed:', error);
        throw error;
    }
}

API Reference

Campaigns

GET /v1/campaigns

List all campaigns with optional filtering


// List active campaigns
const campaigns = await app.client.campaigns.list({
    status: 'active',
    category: 'water',
    limit: 20,
    page: 1
});

POST /v1/campaigns

Create a new campaign


// Create new campaign
const campaign = await app.client.campaigns.create({
    title: 'Community Solar Project',
    description: 'Installing solar panels for school',
    targetAmount: 15000,
    category: 'energy',
    location: {
        country: 'Tanzania',
        coordinates: [-6.369028, 34.888822]
    },
    milestones: [
        {
            title: 'Equipment Purchase',
            amount: 8000,
            description: 'Solar panels and inverters'
        },
        {
            title: 'Installation',
            amount: 7000,
            description: 'Professional installation and training'
        }
    ]
});

Donations

POST /v1/donations

Process a donation


// Process donation with Stellar
const donation = await app.client.donations.create({
    campaignId: 'campaign_123',
    amount: {
        value: 100,
        currency: 'USD'
    },
    type: 'one-time',
    donor: {
        walletAddress: 'GXXXXXXXXXXXXXXXXXXXXXX'
    }
});

Impact Metrics

POST /v1/impact/metrics

Record impact metrics for a campaign


// Update impact metrics
const impact = await app.client.impact.updateMetrics('campaign_123', {
    metrics: [
        {
            name: 'People Served',
            value: 250,
            unit: 'individuals',
            verificationMethod: 'community_survey'
        },
        {
            name: 'Solar Output',
            value: 5000,
            unit: 'watts',
            verificationMethod: 'meter_reading'
        }
    ]
});

SDKs & Libraries

We provide official SDKs for JavaScript, Python, and PHP to help you integrate with The Give Hub platform quickly and securely.

JavaScript SDK

Complete SDK for browser and Node.js environments.

npm install @givehub/sdk
Python SDK

Python SDK for backend integration.

pip install givehub-sdk
PHP SDK

PHP SDK for web applications.

composer require givehub/sdk

Blockchain Integration

The Give Hub leverages the Stellar blockchain for transparent and efficient fund management. Our Soroban smart contracts handle:

  • Automated milestone-based fund releases
  • Multi-signature verification for large transactions
  • Impact metric verification and storage
  • Cross-border payment processing

// Example: Process milestone verification and fund release
const milestoneVerification = await app.client.campaigns.verifyMilestone({
    campaignId: 'campaign_123',
    milestoneId: 'milestone_456',
    verification: {
        status: 'completed',
        evidence: [{
            type: 'image',
            url: 'https://storage.thegivehub.com/evidence/123.jpg',
            timestamp: '2024-03-15T10:30:00Z'
        }],
        verifierSignature: 'GXXXXXXXXXXXXXXXXXXXXXX'
    }
});

Webhooks

Stay updated with real-time events by configuring webhooks for your application. We'll send HTTP POST requests to your endpoint whenever relevant events occur.


// Example webhook payload for successful donation
{
    "event": "donation.completed",
    "created": "2024-03-15T10:30:00Z",
    "data": {
        "donationId": "don_123",
        "campaignId": "campaign_456",
        "amount": {
            "value": "100.00",
            "currency": "USD"
        },
        "status": "completed",
        "transaction": {
            "stellarTxId": "tx_789",
            "timestamp": "2024-03-15T10:30:00Z"
        }
    }
}

Available Webhook Events

  • donation.completed
  • campaign.milestone.reached
  • campaign.funded
  • impact.verified
  • user.verified

Best Practices

Follow these guidelines to build reliable and efficient integrations with The Give Hub platform:

Error Handling
  • ✓ Implement proper error handling
  • ✓ Retry failed requests with exponential backoff
  • ✓ Monitor webhook delivery status
  • ✓ Handle rate limiting gracefully
Security
  • ✓ Store API keys securely
  • ✓ Validate webhook signatures
  • ✓ Use HTTPS for all requests
  • ✓ Implement proper authentication
Development Support

Need help with your integration? Join our developer community on Discord or contact our support team at developers@thegivehub.com.