# BitSafe documentation, full text # Home URL: https://docs.bitsafe.finance/ ### Build and operate decentralized infrastructure on Canton Network BitSafe documentation helps institutions, developers, and node operators use and integrate BitSafe assets and Decentralization Manager. ### Explore products #### Assets Guides for minting, redeeming, transferring, and integrating BitSafe assets on Canton. * [CBTC: Bitcoin on Canton](https://docs.bitsafe.finance/cbtc) * [BETH: Ether on Canton](https://docs.bitsafe.finance/beth) * [CHYPE: HYPE on Canton](https://docs.bitsafe.finance/chype) * [Asset Faucet](https://faucet.bitsafe.finance/) The Asset Faucet lists the assets and networks available for test-token requests. #### Decentralization Manager Create and operate Decentralized Parties and governed applications across independent Canton nodes with BitSafe's open-source multi-sig framework. * [Decentralization Manager overview](https://docs.bitsafe.finance/decentralization-manager) * [Decentralization Manager architecture overview](https://docs.bitsafe.finance/decentralization-manager/concepts-and-development/architecture-overview) ### Trust and support * [Security and trust index](https://docs.bitsafe.finance/security-and-trust) * [BitSafe documentation glossary](https://docs.bitsafe.finance/glossary) * [Support and developer resources](https://docs.bitsafe.finance/support-and-developer-resources) ### Start here Choose by role or task: [Start here: choose a product or task](/start-here/). ### Building for institutions? Talk to BitSafe --- # Start here URL: https://docs.bitsafe.finance/start-here/ Start with the product or task that matches your immediate goal. Complete a read-only check before you submit a state-changing workflow. ### Choose by goal
| I want to | Start with |
|---|---|
| Understand CBTC | How CBTC works |
| Integrate CBTC | CBTC developer Quick Start |
| Mint, redeem, or transfer CBTC | Choose a CBTC path |
| Evaluate Decentralization Manager | Decentralization Manager overview |
| Prepare to run Decentralization Manager | Decentralization Manager prerequisites |
| Create a Decentralized Party | Create a Decentralized Party |
| Review security and trust boundaries | Security and trust index |
| Goal | Canonical guide |
|---|---|
| Evaluate in a controlled environment | Run Decentralization Manager with Docker |
| Deploy for production | Decentralization Manager production deployment |
| Configure access | Decentralization Manager authentication and operator roles |
| Connect independent operators | Connect Decentralization Manager peers |
| Join the BitSafe Node Operator Network | Join the BitSafe Node Operator Network: Onboarding Guide |
| Operate packages and contracts | Decentralization Manager package and contract operations |
| Recover or upgrade | Decentralization Manager backup, recovery, and mesh upgrades |
| Review trust boundaries | Decentralization Manager security architecture |
| Cover image | |||
|---|---|---|---|
| Decentralization Manager | Govern on-chain actions with Decentralized Parties. Architecture, setup, operations, and API reference. | decentralization-manager | DecMan.png |
| CBTC | Understand CBTC's architecture, security model, operational guides, and user flows. | cbtc | CBTC.png |
| Trading Firms | Evaluate and onboard to CBTC. Strategies, venues, wallets, and compliance for trading firms. | trading-firms | Trading.png |
| Developers | Build apps, wallets, and DeFi protocols with CBTC on Canton. API reference, SDKs, and guides. | developers | Dev.png |
| Symptom | Check | Safe next action |
|---|---|---|
| No recipients found | CSV path, header, and parsed row count | Correct the file. Do not submit an unreviewed replacement. |
| Invalid amount | Decimal syntax and business amount rules | Reject the row before any submission. |
| No holdings available | Sender party, environment, active holdings, and pending operations | Stop and reconcile the sender. Do not retry with another party implicitly. |
| Some rows succeed and later rows fail | Per-item results, current holdings, token refresh, and errors | Do not rerun the complete CSV. Requery authoritative state and resume only proven-uncommitted rows. |
| Ledger response exists but parsing fails | Raw response, update visibility, outgoing offers, and client compatibility | Treat the row as ambiguous. Reconcile before any retry. |
| Sender-side success but receiver balance is unchanged | Incoming offer, receiver acceptance, preapproval policy, rejection, cancellation, and expiry | Complete or resolve the receiver-side flow. Do not duplicate the sender submission. |
| Generated references repeat | Repeated receiver identifiers and shared reference_base | Use application-side row identifiers. Escalate before relying on the library reference for replay protection. |
| Consolidation returns an unexpected holding set | Input holdings, concurrent operations, transaction response, and final active holdings | Stop new operations and reconcile total amount and contract identifiers. |
| Split stops after creating earlier outputs | Completed split steps, current change holdings, and remaining requested amounts | Requery holdings. Do not restart from the original input identifiers. |
| Component | Responsibility | Primary boundary |
|---|---|---|
| Ethereum bridge contract | Receive eligible deposits and release approved redemptions | Contract logic, signature threshold, limits, upgrade governance, and Ethereum finality |
| Attestor Network | Verify eligible events and participate in threshold authorization | Independent operation, policy, and signing keys |
| BETH workflow services | Associate accounts and events, coordinate workflows, and reconcile state | Authentication, availability, and correct state handling |
| Canton participants and parties | Host parties, contracts, and authorized commands | Canton identity, rights, topology, and privacy |
| BETH Daml packages | Define holdings, transfers, accounts, credentials, and administrative behavior | Approved package versions and contract authorization |
| Client libraries and applications | Expose supported workflows and submit authorized requests | Pinned releases, credentials, validation, and retries |
| Proof of Reserve and reconciliation | Provide scoped evidence about reserves and system state | Completeness, freshness, source integrity, and stated limitations |
| Symptom | Check | Safe next action |
|---|---|---|
| No recipients found | CSV path, header, and parsed row count | Correct the file. Do not submit an unreviewed replacement. |
| Invalid amount | Decimal syntax and business amount rules | Reject the row before any submission. |
| No holdings available | Sender party, environment, active holdings, and pending operations | Stop and reconcile the sender. Do not retry with another party implicitly. |
| Some rows succeed and later rows fail | Per-item results, current holdings, token refresh, and errors | Do not rerun the complete CSV. Requery authoritative state and resume only proven-uncommitted rows. |
| Ledger response exists but parsing fails | Raw response, update visibility, outgoing offers, and client compatibility | Treat the row as ambiguous. Reconcile before any retry. |
| Sender-side success but receiver balance is unchanged | Incoming offer, receiver acceptance, preapproval policy, rejection, cancellation, and expiry | Complete or resolve the receiver-side flow. Do not duplicate the sender submission. |
| Generated references repeat | Repeated receiver identifiers and shared reference_base | Use application-side row identifiers. Escalate before relying on the library reference for replay protection. |
| Consolidation returns an unexpected holding set | Input holdings, concurrent operations, transaction response, and final active holdings | Stop new operations and reconcile total amount and contract identifiers. |
| Split stops after creating earlier outputs | Completed split steps, current change holdings, and remaining requested amounts | Requery holdings. Do not restart from the original input identifiers. |
| Component | Responsibility | Primary boundary |
|---|---|---|
| HyperEVM bridge contract | Receive eligible deposits and release approved redemptions | Contract logic, signature threshold, limits, upgrade governance, and HyperEVM finality |
| Attestor Network | Verify eligible events and participate in threshold authorization | Independent operation, policy, and signing keys |
| CHYPE workflow services | Associate accounts and events, coordinate workflows, and reconcile state | Authentication, availability, and correct state handling |
| Canton participants and parties | Host parties, contracts, and authorized commands | Canton identity, rights, topology, and privacy |
| CHYPE Daml packages | Define holdings, transfers, accounts, credentials, and administrative behavior | Approved package versions and contract authorization |
| Client libraries and applications | Expose supported workflows and submit authorized requests | Pinned releases, credentials, validation, and retries |
| Proof of Reserve and reconciliation | Provide scoped evidence about reserves and system state | Completeness, freshness, source integrity, and stated limitations |
| Wallet or custodian | Description | Website |
|---|---|---|
| Bron | Non-custodial wallet with MPC technology and configurable policy controls. | bron.org |
| Console | Self-custodial browser wallet with passkey authentication, name-based sending, phishing protection, and searchable transaction history. | consolewallet.io |
| Finoa | Institutional digital-asset custodian offering custody and trading services. | finoa.io |
| Meteor Wallet | Self-custodial wallet for supported Canton assets, swaps, and access to supported lending markets. | app.canton.meteorwallet.app |
| Nightly Wallet | Multi-chain, non-custodial wallet for key management, asset holding, and application access. | nightly.app |
| C8 Wallet | Canton wallet from Cantor8 for asset access and supported application interactions. | cantor8.io |
| Cypherock Wallet | Hardware and software wallet interface for managing supported Canton assets across desktop, mobile, and web. | cypherock.com |
| Loop | Self-custodial Canton wallet accessible through mobile and desktop browsers. | cantonloop.com |
| Modulo | Multi-chain self-custody wallet and protocol interface for supported lending, borrowing, swapping, and trading services. | modulo.finance |
| Node Fortress Wallet | Non-custodial wallet for Canton Coin and supported Canton token-standard assets. | wallet.nodefortress.io |
| Walley | Non-custodial wallet for holding and transacting supported Canton assets. | walley.cc |
| Zoro Wallet | Non-custodial Canton wallet that runs in mobile and desktop web browsers. | zorowallet.com |
| Canton Wallet | Privacy-first self-custody wallet with passkey onboarding and multisig support. | cantonwallet.com |
| Supanova | Self-custody wallet for supported Canton assets. | supanova.app |
| Cauri | Self-custody wallet for supported Canton assets. | cauri.cc |
| Venue | Type | CBTC availability | Website |
|---|---|---|---|
| Temple Trading | Central limit order book | CBTC pairs include CC–CBTC and USDCx–CBTC | app.templedigitalgroup.com |
| Cancore | Wallet and trading venue | Check the provider for current pairs | cancore.io |
| Cantex | Wallet and trading venue | Multiple pairs; check the provider for current availability | cantex.io |
| C8 Wallet DEX | Wallet and trading venue | Check the provider for current pairs | wallet.cantor8.tech |
| Kora | Request-for-quote venue | Check the provider for current spot, derivatives, and tokenized-asset markets | kora.so |
| Rho Relay | Request-for-quote venue and bridge | Cross-chain CBTC swaps | relay.rho.trading |
| Silvana Book | Off-chain matching with on-chain settlement | Check the provider for current pairs | silvana.one |
| Kairo | Request-for-quote venue | Multiple pairs; check the provider for current availability | kairo.ag |
| HelvetSwap | Automated market maker | CBTC and Canton Coin markets | helvetswap.app |
| OneSwap | Automated market maker | Check the provider for current pairs | oneswap.cc |
| Pool Party | Automated market maker | CBTC swaps and liquidity provision | send.cantonwallet.com |
| Tradecraft | Atomic swap venue | CBTC and other CIP-56 token swaps | cantonswap.com |
| Rocky Exchange | Perpetuals venue | CBTC perpetual markets; check the provider for current availability | rocky.exchange |