Skip to main content
Qustody is designed to expose a familiar institutional-custody API shape. Where it makes sense, concepts in the Qustody API map to widely-used custody-platform workflows. Qustody adds:
  • Quantum Chain-specific post-quantum signing for every authorized transaction.
  • QRC token support rather than ERC-style standards.
  • A non-custodial model where keys live in an external signer, not in Qustody.

Compatibility matrix

CapabilityQustody APIFamiliar custody-platform shape
Vault account model/v1/vault/accounts, /v1/vault/accounts/{id}/walletsHierarchical custody account + sub-account model
Vault account asset balances/v1/vault/accounts/{id}/assetsPer-account asset balance lookup
Token transfer (fungible)POST /v1/transactions with TRANSFER + QRC-20, or /v1/tokens/{id}/transfersTokenization / contract-call transfer
Token mintPOST /v1/tokens/{id}/mintTokenization mint operation
Token burnPOST /v1/tokens/{id}/burnTokenization burn operation
Token contract deploymentPOST /v1/tokens/{id}/deploy (Path A) or CONTRACT_CALL/RAW (Path B)Tokenization deploy + custody-controlled signing
Roles management/v1/tokens/{id}/roles[/grant|/revoke]Role-based contract administration
Pause / freeze/v1/tokens/{id}/{pause|unpause|freeze|unfreeze}Emergency-control workflows
Allowlist / compliance/v1/tokens/{id}/allowlist, /v1/tokens/{id}/compliancePermissioned-asset administration
Approval workflowExisting approval-policy engine (MAX_AMOUNT, WHITELIST_ADDRESS, REQUIRE_APPROVAL, …)Policy-based multi-approver workflow
Webhook event delivery/v1/webhooks with HMAC-SHA256 deliveriesEvent-driven custody integration
Audit log/v1/audit and /v1/audit/verifyTamper-evident audit trail
IdempotencyIdempotency-Key header, 24h windowIdempotent custody requests

What Qustody intentionally does not promise

  • Drop-in compatibility. Qustody is not a re-implementation of any specific custody platform. URLs, schemas, and event names are similar in shape but are not byte-for-byte identical.
  • ERC-named token standards. Qustody publishes QRC standards. If you migrate from a platform that uses ERC names, expect a translation layer at the integration boundary.
  • ECDSA signing. Quantum Chain transactions are authorized with post-quantum signatures. ECDSA-only signers cannot produce valid Quantum Chain transactions.

How to migrate from a familiar custody platform

1

Map the resource model

tenant → vault account → wallet → asset balance aligns 1:1 with most institutional custody platforms.
2

Translate Ethereum standard references to QRC

Any reference to the Ethereum equivalent of QRC-20 in your existing configuration becomes QRC-20. The on-chain operations are the same shape; the standard name is different. The same mapping applies to every other QRC standard listed in token standards.
3

Replace ECDSA signers with a post-quantum signer

Swap the signing component for a Qustody-compatible external signer (callback, gRPC, or remote). See external signing.
4

Re-bind webhooks

Subscribe to transaction.* events for transaction lifecycle and token.* events for typed token operations.
5

Re-evaluate approval policies

The approval-policy engine maps onto most multi-approver workflows. Re-encode your existing rules using the Qustody rule types.