For the complete documentation index, see llms.txt. This page is also available as Markdown.

Technical Reference

⚠️


Token Details

Property
Value

Name

CBTC (Canton Bitcoin)

Standard

CIP-56 (Canton Instrument Protocol)

Backing

1:1 with native BTC

Network

Canton Network

Deposit requirement

Taproot-compatible Bitcoin wallet (P2TR)

Transaction limits

0.0001 BTC minimum, 5 BTC maximum by default. Set per account and adjustable on request

Confirmations

6 Bitcoin blocks (~60 minutes)

Audit

Quantstamp


Network Environments

Environment
Registry URL
Coordinator URL
Bitcoin Network

Devnet

Bitcoin Testnet

Testnet

Bitcoin Testnet

Mainnet

Bitcoin Mainnet

For full Instrument IDs per network, see Instrument ID Management.


Canton Network Requirements

To interact with CBTC you need:

  1. Canton participant node - connected to the target network (devnet/testnet/mainnet)

  2. CBTC DAR files - installed on your participant. All versions must be installed to access all live contract versions.

  1. OIDC provider - Keycloak (officially supported) or Auth0 (community example)

  2. Canton CLI - version 3.3.0+ for DAR upload scripts

  3. Prerequisites for CLI: jq, curl, java (11+)

DAR Upload

The upload script is idempotent - safe to re-run.


Fee Structure

Confirmed: Mint and burn fees are 0%. There are no BitSafe fees on CBTC mint or burn operations.

Canton Transfer Costs

  • CBTC transfers on Canton cost approximately $3-5 per transaction (network gas, not BitSafe fees)

  • Cost varies based on payload size and UTXO count

  • Sending CBTC is generally more expensive than sending Canton Coin (CC) due to larger payload


GitHub Repositories

Repository
Version
Description
Link

cbtc-lib

v0.6.4

Rust SDK for CBTC operations (mint, burn, transfer)

GitHub

canton-lib

v0.6.1

Lower-level Canton interaction library

GitHub

CBTC DAR

cbtc-1.2.1

Daml packages, upload scripts, connect config

GitHub

Note: The crate name is cbtc. DAR versions and crate versions are numbered independently: cbtc-lib v0.6.4 ships DAR cbtc-1.2.1.


Transfer Speed

  • Canton transfers take a few seconds each

  • Practical throughput: ~500 transfers per 10-minute period

  • UTXO limit: 10 UTXOs per party (Canton recommendation). Exceeding this increases load and fees.



Last updated