On the Canton Network, addresses are identified by a party ID, and incoming transfers are not credited automatically — the recipient must accept each incoming transfer before the assets are settled into the vault. Claiming assets means approving a specific pending incoming transfer so its assets are settled into your vault.
Claim operations are created through the Create Transaction endpoint using the canton_transaction type, with the specific operation selected by the nested details.type field. Fordefi supports Canton Coin (CC), the native asset, and any asset based on the CIP-56 token standard.
When your vault is the recipient of a pending incoming transfer, that transfer appears in your vault with a claim_status of claimable. To settle the assets into your vault, submit a canton_approve_transfer request that references the incoming transaction.
You identify the transfer to accept with its transaction_id (the ID of the incoming Fordefi transaction) and the chain it lives on.
{
"signer_type": "api_signer",
"type": "canton_transaction",
"vault_id": "your_canton_vault_id",
"details": {
"type": "canton_approve_transfer",
"transaction_id": "the_incoming_transaction_id",
"chain": "canton_mainnet"
},
"note": "Approve a specific incoming Canton transfer"
}Once the transaction is signed and pushed, the incoming transfer is accepted and its assets are settled into the vault. Its claim_status transitions from claimable to claimed.