Fission Redeem Off-Chain
Technical Overview: This API is a GraphQL endpoint, and the draft is given in this document. A time sequence diagram is also given. Feedback is appreciated.
Basic Call and Security Measures
The API path for all GraphQL is https://api.fission.xyz/graphql/redeem
All API calls will require an API key via the header field Authorization: Bearer xxx
The API request redemption call shall be protected by HMAC (hash-based message authentication code) based authentication using three additional header fields ‘HMAC-Signature’, ‘HMAC-Timestamp’, and ‘HMAC-Nonce’.
Flow: Common Parts For both flows, requesting fees is the same Sequence Diagram:
Example API Calls Asking for ACRED on Ethereum { redeemable( token_address: “0x17418038ecF73BA4026c4f428547BF099706F27B” network: ethereum ) { id symbol name paused current_price redemption_counterparty_wallet_address settlement_balance commission_fee_info { schedule_expires_at fee_schedule { commission_fee_percentage inclusive_lower_redeem_amount exclusive_upper_redeem_amount } } } } Response
{ “data”: { “redeemable”: { “id”: “redeemable_abc123”, “symbol”: “ACRED”, “name”: “Apollo’s ACRED”, “paused”: false, “current_price”: 1024.50 “redemption_counterparty_wallet_address”: “0x742d35Cc6634C0532925a3b844Bc454e4438f44e”, “settlement_balance”: 1500000.50, “commission_fee_info”: { “schedule_expires_at”: “2026-02-19T12:00:00Z”, “fee_schedule”: [{ “commission_fee_percentage”: 0.25, “inclusive_lower_redeem_amount”: “0”, “exclusive_upper_redeem_amount”: “1000000000000” },{ “commission_fee_percentage”: 4.25, “inclusive_lower_redeem_amount”: “1000000000000”, “exclusive_upper_redeem_amount”: “2000000000000” }] } } } }