Type Alias: CantonConfig

CantonConfig = { ccipParty: string; ccvs?: string[]; chainId?: string; defaultSendGasLimit?: number | bigint; edsUrl: string; externalEdsUrlsByOwner?: Record<string, string>; feeTransferFactoryAmount?: string; indexerUrl?: string; jwt?: string | (() => Promise<string>); packages?: Partial<{ ccipReceiver: string; ccipSender: string; perPartyRouter: string; }>; party: string; senderInstanceId?: string; transferInstructionUrl: string; }

Defined in: chain.ts:206

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

Properties

ccipParty

ccipParty: string

Defined in: chain.ts:211

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

---

ccvs?

optional ccvs?: string[]

Defined in: chain.ts:286

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:249

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.

---

defaultSendGasLimit?

optional defaultSendGasLimit?: number | bigint

Defined in: chain.ts:272

Default gas limit for Canton → destination sends when message.extraArgs.gasLimit is omitted. ccip-cli --gas-limit and extraArgs.gasLimit override this.

---

edsUrl

edsUrl: string

Defined in: chain.ts:226

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

---

externalEdsUrlsByOwner?

optional externalEdsUrlsByOwner?: Record<string, string>

Defined in: chain.ts:233

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.

---

feeTransferFactoryAmount?

optional feeTransferFactoryAmount?: string

Defined in: chain.ts:278

Transfer-factory preview amount for Canton fee-token payments. Rarely needs changing; defaults to "1.0".

---

indexerUrl?

optional indexerUrl?: string

Defined in: chain.ts:242

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

---

jwt?

optional jwt?: string | (() => Promise<string>)

Defined in: chain.ts:223

JSON Web Token for authentication with the Canton Ledger API.

Pass a string for a static (pre-obtained) token, or a () => Promise<string> getter for a refreshable token (e.g. an OAuth2 caching provider). When a getter is supplied, the SDK clients call it per request to obtain a fresh JWT, enabling automatic refresh. The CLI resolves its auth block upfront and injects either a string or a getter here; web/Electron embedders inject their own.

---

packages?

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

Defined in: chain.ts:255

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:208

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

---

senderInstanceId?

optional senderInstanceId?: string

Defined in: chain.ts:266

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:236

Base URL for the Transfer Instruction API.