Skip to content

chore: add cbtc to assets.json for all networks#1905

Merged
davidrichards-da merged 6 commits into
canton-network:mainfrom
gyorgybalazsi:chore/add-cbtc-assets
May 29, 2026
Merged

chore: add cbtc to assets.json for all networks#1905
davidrichards-da merged 6 commits into
canton-network:mainfrom
gyorgybalazsi:chore/add-cbtc-assets

Conversation

@gyorgybalazsi
Copy link
Copy Markdown
Contributor

@gyorgybalazsi gyorgybalazsi commented May 28, 2026

Summary

Adds CBTC (BitSafe wrapped Bitcoin, CIP-56) to api-specs/assets.json for MainNet, TestNet, and DevNet.

CBTC is the first wrapped Bitcoin asset on Canton Network, issued by BitSafe via a decentralized network of Attestor nodes using FROST threshold signatures. Live on MainNet since 2025-08-05.

Per-network entries:

Network admin (dec_party) utility host
MainNet cbtc-network::12205af3b949a04776fc48cdcc05a060f6bda2e470632935f375d1049a8546a3b262 api.utilities.digitalasset.com
TestNet cbtc-network::12201b1741b63e2494e4214cf0bedc3d5a224da53b3bf4d76dba468f8e97eb15508f api.utilities.digitalasset-staging.com
DevNet cbtc-network::12202a83c6f4082217c175e29bc53da5f2703ba2675778ab99217a5a881a949203ff api.utilities.digitalasset-dev.com

instrumentId.id = "CBTC" and symbol = "CBTC" on all three networks.

Sources for the on-chain identifiers

  • Per-network dec_party (admin) and utility_registry_url: public Yaak environment files in DLC-link/api-collections-public (yaak.ev_u5JtmikP9v.yaml MainNet, yaak.ev_7suemqNhpB.yaml TestNet, yaak.ev_Rtc57Rr3rF.yaml DevNet).
  • instrumentId.id = "CBTC": confirmed from CBTC transfer-factory request bodies in the same repo (yaak.rq_cdT4pzDF9X.yaml, yaak.rq_XHJhBt7YrZ.yaml).
  • linkToDAR: DLC-link/cbtc-lib/cbtc-dars/dars/cbtc — contains the versioned cbtc-*.dar files. Same precedent as the Amulet entry (linking to a public DAR folder rather than a docs page).
  • assetLogo: pinned to the immutable tag cbtc-1.2.0 of DLC-link/cbtc-lib, aligned with the latest DAR version: https://raw.githubusercontent.com/DLC-link/cbtc-lib/cbtc-1.2.0/assets/cbtc-logo.svg.

Notes for reviewers

  • Legal/DAR review: the linkToDAR flagged in docs: adding an asset json doc #1262 points to a public folder owned by BitSafe (DLC-link is the BitSafe engineering org), containing only DARs for the CBTC token standard implementation.

Test plan

  • python3 -c "import json; json.load(open('api-specs/assets.json'))" parses (verified locally; only 36-line insertion, no other changes)
  • Each new entry uses the same shape as existing per-network entries (instrumentId.admin/id, symbol, registryURLs, linkToDAR, assetLogo)
  • Registrar URLs follow the established pattern <utility_host>/api/token-standard/v0/registrars/<admin>/registry/
  • Verify in a wallet that CBTC appears and balances resolve via the DA Utility registrar on the relevant network

🤖 Generated with Claude Code

Adds CBTC (BitSafe wrapped Bitcoin, CIP-56) listings for MainNet,
TestNet, and DevNet. CBTC is the first wrapped Bitcoin asset on
Canton Network, issued by BitSafe via a decentralized network of
Attestor nodes using FROST threshold signatures.

Per-network admin (dec_party) and utility registrar host are taken
from the public Yaak environment files in
DLC-link/api-collections-public. linkToDAR points to the public DAR
folder in DLC-link/cbtc-lib.

Note on assetLogo: temporarily set to the BitSafe corporate logo
(https://www.bitsafe.finance/Logo.svg) because no token-specific
icon URL is currently hosted publicly. Happy to update once a
CBTC icon is published.

Sources:
- https://github.com/DLC-link/api-collections-public
- https://github.com/DLC-link/cbtc-lib/tree/main/cbtc-dars/dars/cbtc
- https://www.canton.network/blog/cbtc-launch-on-canton-network-wrapped-bitcoin-as-institutional-grade-collateral

Signed-off-by: gyorgybalazsi <gyorgy@bitsafe.finance>

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@gyorgybalazsi gyorgybalazsi requested a review from a team as a code owner May 28, 2026 12:29
@gyorgybalazsi gyorgybalazsi marked this pull request as draft May 28, 2026 12:29
Swap assetLogo from the BitSafe corporate Logo.svg placeholder to the
official CBTC token mark, taken from the BitSafe brand kit
(https://www.bitsafe.finance/brand-kit). Same URL on all three
networks.

Signed-off-by: gyorgybalazsi <gyorgy@bitsafe.finance>

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
gyorgybalazsi and others added 2 commits May 28, 2026 17:18
Swap the brand-kit URL on www.bitsafe.finance for an immutable raw
URL pinned to the cbtc-1.2.0 tag on DLC-link/cbtc-lib, where the
brand assets are now hosted (DLC-link/cbtc-lib#55).

Signed-off-by: gyorgybalazsi <gyorgy@bitsafe.finance>

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The brand assets are versioned with the cbtc crate's library version,
not the DAR version. Repoint to v0.6.1 (the release that introduces
the assets/ directory).

Signed-off-by: gyorgybalazsi <gyorgy@bitsafe.finance>

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@gyorgybalazsi gyorgybalazsi marked this pull request as ready for review May 28, 2026 15:32
@gyorgybalazsi
Copy link
Copy Markdown
Contributor Author

@davidrichards-da could you please review?

Copy link
Copy Markdown
Contributor

@davidrichards-da davidrichards-da left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@davidrichards-da davidrichards-da enabled auto-merge (squash) May 29, 2026 15:29
@davidrichards-da davidrichards-da merged commit ca4403a into canton-network:main May 29, 2026
25 of 26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants