Core concepts

Canton network

C8 Wallet is built on Canton, a privacy-enabled blockchain designed for institutional finance.

Rather than Ethereum-style addresses, Canton uses:

• partyId — string identifier for a participant (account)
• instrumentId — string identifier for a tokenized asset

Your dApp works with these identifiers throughout the SDK.

Popup + postMessage architecture

The SDK uses two channels to talk to the wallet, depending on the request type:

window.postMessage

Interactive actions that require user consent, auth, or cryptographic signatures — e.g. connecting an account or signing a transaction.

HTTP API

Read-only data retrieval that does not require user intervention — e.g. fetching instruments or balances.

Instruments and holdings

An instrument is a Canton asset type (e.g. a tokenized currency or security). A holding is a specific account’s balance of that instrument.

The typical flow:

1. List instruments

   getInstruments() — pick an instrumentId.

2. List accounts

   getAccounts(instrumentId) — pick a partyId and holding.

3. Submit transfer

   send({ senderPartyId, instrumentId, amount, receiverPartyId }).