{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developers/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Developers","type":"markdown"},"seo":{"title":"Canton Claiming Assets","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"canton-claiming-assets","__idx":0},"children":["Canton Claiming Assets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Claim operations are created through the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.fordefi.com/api/openapi/transactions/create_transaction_api_v1_transactions_post"},"children":["Create Transaction"]}," endpoint using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canton_transaction"]}," type, with the specific operation selected by the nested ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.type"]}," field. Fordefi supports Canton Coin (CC), the native asset, and any asset based on the CIP-56 token standard."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"claiming-assets","__idx":1},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claiming assets"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When your vault is the recipient of a pending incoming transfer, that transfer appears in your vault with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim_status"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claimable"]},". To settle the assets into your vault, submit a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canton_approve_transfer"]}," request that references the incoming transaction."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You identify the transfer to accept with its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_id"]}," (the ID of the incoming Fordefi transaction) and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chain"]}," it lives on."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"signer_type\": \"api_signer\",\n  \"type\": \"canton_transaction\",\n  \"vault_id\": \"your_canton_vault_id\",\n  \"details\": {\n    \"type\": \"canton_approve_transfer\",\n    \"transaction_id\": \"the_incoming_transaction_id\",\n    \"chain\": \"canton_mainnet\"\n  },\n  \"note\": \"Approve a specific incoming Canton transfer\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the transaction is signed and pushed, the incoming transfer is accepted and its assets are settled into the vault. Its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim_status"]}," transitions from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claimable"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claimed"]},"."]}]},"headings":[{"value":"Canton Claiming Assets","id":"canton-claiming-assets","depth":1},{"value":"Claiming assets","id":"claiming-assets","depth":2}],"frontmatter":{"seo":{"title":"Canton Claiming Assets"}},"lastModified":"2026-07-12T09:49:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developers/transaction-types/canton-claim-assets","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}