Canton CIP-56 indexer sample

[IvanNik]

Canton CIP-56 Indexer Template

New Workflow Engine SDK template that indexes Canton CIP-56 token holding and transfer events into the Kaleido Asset Manager.

See readme and Flow details

What it does

Processes Canton ledger events for CIP-56 compliant tokens (Holdings and TransferInstructions) and maps them to Asset Manager entities (fragments, transfers, addresses, assets, pools).

Key features

• Holding indexing: Fragments and balance-tracking transfers for CIP-56 Holding creates/archives, with locked holding detection (locked: true label)
• Transfer enrichment: Correlates TransferInstruction exercises with Holding events via transactionId to produce enriched send/receive transfers, even across WFE batch boundaries (cross-batch txTransferContext + AM fallback on restart)
• Decimal scaling: Converts Daml Decimal (Numeric 10) to integer base units via 10^10 multiplier, matching BTC satoshis (10^8) / ERC20 wei
• Batched AM queries: bulkQuery with 100-item chunking for cache-miss lookups (adopted from btc-indexer)
• Transfer direction labels: direction: send|receive and transferInstructionId on enriched transfers
• Multi-stage batch pipeline: Two scan passes (index creates, resolve TI context, collect misses) -> batched AM query -> dispatch to handlers -> single bulkUpsert flush