Skip to main content
Version: 1.9.1

Type Alias: CantonConfig

CantonConfig = { ccipParty: string; ccvs?: string[]; chainId?: string; edsUrl: string; externalEdsUrlsByOwner?: Record<string, string>; indexerUrl?: string; jwt: string; packages?: Partial<{ ccipReceiver: string; ccipSender: string; perPartyRouter: string; }>; party: string; senderInstanceId?: string; transferInstructionUrl: string; }

Defined in: chain.ts:198

Configuration for connecting to a Canton Ledger API and fetch CCIP disclosures.

Properties

ccipParty

ccipParty: string

Defined in: chain.ts:203

CCIP operator party (CCIPSender signatory / fee recipient on ledger).


ccvs?

optional ccvs?: string[]

Defined in: chain.ts:257

Optional Canton CCV instance addresses (hex hashes and/or raw instanceId@party). Used for execute (EDS disclosures + receiver matching) and as the default for Canton send senderRequiredCCVs when extraArgs.ccvRawAddresses is omitted. CLI -x ccvRawAddresses=… overrides this list for send.


chainId?

optional chainId?: string

Defined in: chain.ts:232

Optional CCIP Canton chain ID (e.g. canton:TestNet). When set, skips synchronizer-alias detection — required when the ledger reports a generic alias such as global.


edsUrl

edsUrl: string

Defined in: chain.ts:209

Base URL for the EDS (Explicit Disclosure Service) API.


externalEdsUrlsByOwner?

optional externalEdsUrlsByOwner?: Record<string, string>

Defined in: chain.ts:216

Optional mapping from a Canton RawInstanceAddress owner party to that owner's external EDS base URL. When absent, edsUrl is used for both global and external EDS endpoints.


indexerUrl?

optional indexerUrl?: string

Defined in: chain.ts:225

Optional base URL for a transaction indexer to fetch CCV verifications. Used when --indexer is omitted on ccip-cli (CLI --indexer overrides this).


jwt

jwt: string

Defined in: chain.ts:206

JSON Web Token for authentication with the Canton Ledger API.


packages?

optional packages?: Partial<{ ccipReceiver: string; ccipSender: string; perPartyRouter: string; }>

Defined in: chain.ts:238

Optional DAR package names for ACS template filters. Prod testnet bundles PerPartyRouter in ccip-runtime instead of the dev default ccip-perpartyrouter.


party

party: string

Defined in: chain.ts:200

User ledger party for actAs, ACS queries, and transaction visibility (often differs from ccipParty).


senderInstanceId?

optional senderInstanceId?: string

Defined in: chain.ts:249

Optional CCIPSender instance id for Canton-source sends (ccip-cli -r on Canton lanes). Used only for CLI/SDK routing; on-ledger Send resolves CCIPSender from party via ACS. CLI -r overrides this value.


transferInstructionUrl

transferInstructionUrl: string

Defined in: chain.ts:219

Base URL for the Transfer Instruction API.