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
Household Beneficiaries Receive and spend CARBON credit tokens for emission reductions
Suppliers Accept vouchers and submit verifiable claims
Implementers Manage emission reduction projects and ITMO conversions
Regulators 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
Must have valid emission reduction certificate
Recipient must be registered household
Value must match verified reduction amount
Voucher must be active and non-expired
Supplier must be authorized
Amount must not exceed available balance
Product must be approved for scheme
Must include verifiable delivery proof
Must align with monitoring plan
Must be submitted within time limit
{ "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)
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
Next Steps
Supplier Integration Set up merchant integration
Monitoring Guide Learn about verification and monitoring
API Reference View complete API documentation
