This page documents the Emerging Household Energy solution workflow for digital vouchers. It covers voucher issuance, redemption, and claim-linked benefit transfer operations.
Key Actors
Receive and spend CARBON credit tokens for emission reductions
Accept vouchers and submit verifiable claims
Manage emission reduction projects and ITMO conversions
Monitor and approve mitigation activities
Voucher Lifecycle
1. Issuance
curl -X POST https://api.emerging.eco/v1/vouchers/issue \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"recipientDid": "did:ixo:household/123",
"emissionCertificateId": "CERT-456",
"value": 100.00,
"attributes": {
"batchId": "BATCH-789",
"issuanceDate": "2024-03-15",
"expiryDate": "2024-12-31"
}
}'from emerging import Client
client = Client('YOUR_API_KEY')
voucher = client.vouchers.issue(
recipient_did="did:ixo:household/123",
emission_certificate_id="CERT-456",
value=100.00,
attributes={
"batch_id": "BATCH-789",
"issuance_date": "2024-03-15",
"expiry_date": "2024-12-31"
}
)2. Redemption
curl -X POST https://api.emerging.eco/v1/vouchers/redeem \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"voucherId": "VCHR-123",
"supplierDid": "did:ixo:supplier/456",
"amount": 50.00,
"productId": "PROD-789"
}'from emerging import Client
client = Client('YOUR_API_KEY')
redemption = client.vouchers.redeem(
voucher_id="VCHR-123",
supplier_did="did:ixo:supplier/456",
amount=50.00,
product_id="PROD-789"
)3. Claim Submission
curl -X POST https://api.emerging.eco/v1/claims \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"redemptionId": "REDM-123",
"verifiableCredential": {
"type": "ProductDeliveryCredential",
"proof": "..."
}
}'from emerging import Client
client = Client('YOUR_API_KEY')
claim = client.claims.submit(
redemption_id="REDM-123",
verifiable_credential={
"type": "ProductDeliveryCredential",
"proof": "..."
}
)Token Conversion Flow
CARBON → USDC
Suppliers make claims to convert received CARBON tokens to USDC through the liquidity pool
USDC → Local Currency
Suppliers convert USDC to local currency via payment processors
USDC → CARBON
Implementers swap USDC for CARBON tokens through the liquidity pool
CARBON → ITMO
Implementers convert CARBON tokens to ITMO claims with on-chain transfer proofs
ITMO → Fiat
Implementers convert ITMO claims and transfer prooofs to ITMO Certificates through National Registy Implementers receive fiat payments for ITMO certificates through Mitigation Outcome Purchase Agreements (MOPA)
Fiat → USDC
Implementers convert fiat payments to USDC through a regulated exchange operator (Circle)
Validation Rules
Issuance Rules
- Must have valid emission reduction certificate
- Recipient must be registered household
- Value must match verified reduction amount
Redemption Rules
- Voucher must be active and non-expired
- Supplier must be authorized
- Amount must not exceed available balance
- Product must be approved for scheme
Claim Rules
- Must include verifiable delivery proof
- Must align with monitoring plan
- Must be submitted within time limit
Response Format
{
"id": "VCHR-123",
"status": "active",
"recipientDid": "did:ixo:household/123",
"emissionCertificateId": "CERT-456",
"value": 100.00,
"remainingBalance": 50.00,
"attributes": {
"batchId": "BATCH-789",
"issuanceDate": "2024-03-15",
"expiryDate": "2024-12-31"
}
}Error Codes
Invalid parameters or validation failure
Unauthorized access or invalid credentials
Forbidden operation (e.g., unauthorized supplier)
Resource not found
Conflict with existing state
Security Considerations
Never expose API keys or private keys in client-side code. Always use secure server-side implementations for token conversions and claims processing.
- All transactions are recorded on the Impact Hub blockchain
- Multi-party controls govern the liquidity pool
- Strong authentication required for supplier applications
- Compliance with Article 6.2 ITMO regulations