Version: 1.14.0

Class: SuiChain

Defined in: sui/index.ts:129

Sui chain implementation supporting Sui networks.

Extends

Chain<typeof Sui>

Indexable

[key: symbol]: () => string

Constructors

Constructor

new SuiChain(client: SuiJsonRpcClient, network: NetworkInfo<"SUI">, ctx?: ChainContext): SuiChain

Defined in: sui/index.ts:144

Creates a new SuiChain instance.

Parameters

Parameter	Type	Description
`client`	`SuiJsonRpcClient`	Sui client for interacting with the Sui network.
`network`	`NetworkInfo`<`"SUI"`>	Network information for this chain.
`ctx?`	`ChainContext`	-

Returns

SuiChain

Overrides

Chain<typeof ChainFamily.Sui>.constructor

Properties

abort

readonly abort: AbortSignal

Defined in: chain.ts:890

Fires when the chain should tear down: either Chain.destroy was called, or the ChainContext abort signal fired. Listeners registered with { once: true } therefore self-unregister on whichever condition happens first, so no listener ever outlives its chain on a long-lived context.

Inherited from

Chain.abort

apiClient

readonly apiClient: CCIPAPIClient | null

Defined in: chain.ts:877

CCIP API client (null if opted out)

Inherited from

Chain.apiClient

apiRetryConfig

readonly apiRetryConfig: Required<ApiRetryConfig> | null

Defined in: chain.ts:879

Retry configuration for API fallback operations (null if API client is disabled)

Inherited from

Chain.apiRetryConfig

client

readonly client: SuiJsonRpcClient

Defined in: sui/index.ts:137

destroy

destroy: (reason?: unknown) => void

Defined in: chain.ts:942

Cleanup method to release resources (e.g., close connections).

Parameters

Parameter	Type
`reason?`	`unknown`

Returns

void

Inherited from

Chain.destroy

logger

logger: Logger

Defined in: chain.ts:875

Inherited from

Chain.logger

network

readonly network: NetworkInfo<"SUI">

Defined in: sui/index.ts:136

Overrides

Chain.network

verificationsIndexer?

readonly optional verificationsIndexer?: readonly string[]

Defined in: chain.ts:881

Default CCIP v2 indexer base URLs for getVerifications (undefined → network defaults)

Inherited from

Chain.verificationsIndexer

verifierTransport?

readonly optional verifierTransport?: VerifierTransport

Defined in: chain.ts:883

Transport for direct verifier reads (undefined → grpc-web over fetch)

Inherited from

Chain.verifierTransport

decimals

readonly static decimals: 9 = 9

Defined in: sui/index.ts:134

family

readonly static family: "SUI" = ChainFamily.Sui

Defined in: sui/index.ts:133

Methods

estimateReceiveExecution()?

optional estimateReceiveExecution(opts: { message: Omit<EstimateMessageInput, "onRampAddress" | "offRampAddress">; offRamp: string; } | { messageId: string; }): Promise<number>

Defined in: chain.ts:2657

Estimate ccipReceive execution cost (gas, computeUnits) for this destination chain.

Parameters

Parameter	Type	Description
`opts`	{ `message`: `Omit`<`EstimateMessageInput`, `"onRampAddress"` \| `"offRampAddress"`>; `offRamp`: `string`; } \| { `messageId`: `string`; }	Either: - `{ offRamp, message }` — estimate from message fields directly. `message` must include `sourceChainSelector`, `messageId`, `receiver`, and optionally `sender`, `data`, `destTokenAmounts`. - `{ messageId }` — fetch the message from the CCIP API via `getMessageById`, resolve the offRamp from the message metadata or `getExecutionInput`, then estimate. Requires `apiClient` to be available.

Returns

Promise<number>

Estimated execution cost (gas for EVM, compute units for Solana)

Inherited from

Chain.estimateReceiveExecution

execute()

execute(opts: ExecuteOpts & { wallet: unknown; } & { receiverObjectIds?: string[]; }): Promise<CCIPExecution>

Defined in: sui/index.ts:2069

Execute messages in report in an offRamp.

Parameters

Parameter	Type	Description
`opts`	ExecuteOpts & { wallet: unknown; } & { `receiverObjectIds?`: `string`[]; }	ExecuteOpts with chain-specific wallet to sign and send tx.

Returns

Promise<CCIPExecution>

Promise resolving to transaction of the execution.

Throws

CCIPError if transaction submission fails

Throws

CCIPExecTxRevertedError if transaction reverts

Overrides

Chain.execute

fetchCCVResults()

protected fetchCCVResults(messageId: string, policy: VerificationPolicy, opts: { indexer?: NetworkType | readonly string[]; offRamp: string; request: { lane: { destChainSelector: bigint; onRamp: string; sourceChainSelector: bigint; version: CCIPVersion; }; log: { blockTimestamp: number; }; message: { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; }; }; } & VerificationSourcesOpts & Pick<LogFilter, "startBlock" | "watch" | "page">): Promise<VerifierResult[]>

Defined in: chain.ts:1983

Collect a CCIP v2.0 message's CCV results against the destination policy, from every source: opts.ccvData, then the CCIP API raced against the indexers, then opts.verifiers (read via ChainContext.verifierTransport). For families' getVerifications implementations.

Parameters

Parameter	Type	Description
`messageId`	`string`	The message id
`policy`	`VerificationPolicy`	This destination's CCV policy for the message
`opts`	{ `indexer?`: `NetworkType` \| readonly `string`[]; `offRamp`: `string`; `request`: { `lane`: { `destChainSelector`: `bigint`; `onRamp`: `string`; `sourceChainSelector`: `bigint`; `version`: `CCIPVersion`; }; `log`: { `blockTimestamp`: `number`; }; `message`: { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; }; }; } & `VerificationSourcesOpts` & `Pick`<`LogFilter`, `"startBlock"` \| `"watch"` \| `"page"`>	The `getVerifications` options

Returns

Promise<VerifierResult[]>

The results covering policy

Throws

CCIPMessageNotVerifiedYetError if the sources can't cover policy

Inherited from

Chain.fetchCCVResults

generateUnsignedExecute()

generateUnsignedExecute(opts: ExecuteOpts & { payer: string; }): Promise<UnsignedSuiTx>

Defined in: sui/index.ts:2044

Generate unsigned tx to manuallyExecute a message.

Parameters

Parameter	Type	Description
`opts`	`ExecuteOpts` & { `payer`: `string`; }	ExecuteOpts with payer address which will send the exec tx

Returns

Promise<UnsignedSuiTx>

Promise resolving to chain-family specific unsigned txs

Throws

CCIPExecutionReportChainMismatchError if input is not a Sui v1.6 execution report

Overrides

Chain.generateUnsignedExecute

generateUnsignedSendMessage()

generateUnsignedSendMessage(_opts: SendMessageOpts & { sender: string; }): Promise<never>

Defined in: sui/index.ts:1603

Generate unsigned txs for ccipSend'ing a message.

Parameters

Parameter	Type	Description
`_opts`	`SendMessageOpts` & { `sender`: `string`; }	SendMessageOpts with sender address

Returns

Promise<never>

Promise resolving to chain-family specific unsigned txs

Overrides

Chain.generateUnsignedSendMessage

getBalance()

getBalance(opts: GetBalanceOpts): Promise<bigint>

Defined in: sui/index.ts:1356

Query token balance for an address.

Parameters

Parameter	Type	Description
`opts`	`GetBalanceOpts`	Balance query options

Returns

Promise<bigint>

Token balance information including raw and formatted values

Throws

CCIPArgumentInvalidError if holder or token is invalid

Overrides

Chain.getBalance

getBlockInfo()

getBlockInfo(block: number | "finalized" | "latest"): Promise<BlockInfo>

Defined in: sui/index.ts:447

Gets checkpoint metadata for a sequence number or tag. Sui checkpoints are finalized once committed, so 'finalized' and 'latest' both resolve to the latest checkpoint. Non-positive numbers are treated as depths relative to latest (e.g. -5 means 5 checkpoints behind latest).

Parameters

Parameter	Type	Description
`block`	`number` \| `"finalized"` \| `"latest"`	Checkpoint sequence number, depth, or tag.

Returns

Promise<BlockInfo>

Checkpoint number and Unix timestamp (seconds).

Overrides

Chain.getBlockInfo

getBlockTimestamp()

getBlockTimestamp(block: number | bigint | "finalized" | "latest"): Promise<number>

Defined in: chain.ts:971

Fetch the timestamp of a given block.

Parameters

Parameter	Type	Description
`block`	`number` \| `bigint` \| `"finalized"` \| `"latest"`	Block number or finality tag

Returns

Promise<number>

Unix timestamp in seconds

Deprecated

Use Chain.getBlockInfo instead.

Inherited from

Chain.getBlockTimestamp

getExecutionInput()

getExecutionInput(opts: { request: CCIPRequest; verifications: CCIPVerifications; } & Pick<LogFilter, "page">): Promise<ExecutionInput>

Defined in: chain.ts:1240

Fetch input data needed for executing messages Should be called on the source instance

Parameters

Parameter	Type	Description
`opts`	{ `request`: `CCIPRequest`; `verifications`: `CCIPVerifications`; } & `Pick`<`LogFilter`, `"page"`>	getExecutionInput options containing request and verifications

Returns

Promise<ExecutionInput>

input payload to be passed to execute

See

execute - method to execute a message

Inherited from

Chain.getExecutionInput

getExecutionReceipts()

getExecutionReceipts(opts: { messageId?: string; offRamp: string; sequenceNumber?: bigint; sourceChainSelector?: bigint; verifications?: CCIPVerifications; } & Pick<LogFilter, "startBlock" | "startTime" | "watch" | "page" | "since">): AsyncIterableIterator<CCIPExecution>

Defined in: sui/index.ts:930

Yields execution receipts for an offramp (Sui override of Chain.getExecutionReceipts).

Sui fullnodes can no longer serve event queries over ranges whose txs were pruned from the event-tx linkage ("Could not find the referenced transaction events", on every provider tested); the indexer's transaction listing by the offramp's execution moves is the only queryable event source, and each listed tx carries its ExecutionStateChanged or SkippedAlreadyExecuted events.

Parameters

Parameter	Type
`opts`	{ `messageId?`: `string`; `offRamp`: `string`; `sequenceNumber?`: `bigint`; `sourceChainSelector?`: `bigint`; `verifications?`: `CCIPVerifications`; } & `Pick`<`LogFilter`, `"startBlock"` \| `"startTime"` \| `"watch"` \| `"page"` \| `"since"`>

Returns

AsyncIterableIterator<CCIPExecution>

Overrides

Chain.getExecutionReceipts

getExecutionReceiptsInTx()

getExecutionReceiptsInTx(tx: string | ChainTransaction, filters?: { messageId?: string; offRamp?: string | null; sequenceNumber?: bigint; sourceChainSelector?: bigint; }): Promise<CCIPExecution[]>

Defined in: sui/index.ts:1069

Canonicalizes BOTH sides of the base class's exact offRamp address match.

Sui log addresses are <package>::<module> (Move event types are <package>::<module>::<Struct>; getTransaction slices the struct off) with the node's full padded package id, while callers pass the OffRamp in whatever form their source used — a bare package id, short (unpadded) from the API (the CLI's show <messageId>) or a decoded message, <package>::offramp from SDK discovery. Both are converted to <normalized-package>::offramp up front, so an exact compare downstream matches successes and failures alike instead of silently dropping every receipt.

Parameters

Parameter	Type
`tx`	`string` \| `ChainTransaction`
`filters?`	{ `messageId?`: `string`; `offRamp?`: `string` \| `null`; `sequenceNumber?`: `bigint`; `sourceChainSelector?`: `bigint`; }
`filters.messageId?`	`string`
`filters.offRamp?`	`string` \| `null`
`filters.sequenceNumber?`	`bigint`
`filters.sourceChainSelector?`	`bigint`

Returns

Promise<CCIPExecution[]>

Overrides

Chain.getExecutionReceiptsInTx

getFee()

getFee(opts: Omit<SendMessageOpts, "approveMax">): Promise<bigint>

Defined in: sui/index.ts:1563

Fetch the current fee for a given intended message.

Parameters

Parameter	Type	Description
`opts`	`Omit`<`SendMessageOpts`, `"approveMax"`>	SendMessageOpts without approveMax

Returns

Promise<bigint>

Fee amount in the feeToken's smallest units

Overrides

Chain.getFee

getFeeTokens()

getFeeTokens(router: string): Promise<Record<string, TokenInfo>>

Defined in: sui/index.ts:2349

Fetch list and info of supported feeTokens.

Parameters

Parameter	Type	Description
`router`	`string`	Router address on this chain

Returns

Promise<Record<string, TokenInfo>>

Promise resolving to mapping of token addresses to TokenInfo objects

Overrides

Chain.getFeeTokens

getLaneFeatures()

getLaneFeatures(opts: { destChainSelector: bigint; router: string; token?: string; }): Promise<Partial<LaneFeatures>>

Defined in: chain.ts:2089

Retrieve features for a lane (router/destChainSelector/token triplet).

Parameters

Parameter	Type
`opts`	{ `destChainSelector`: `bigint`; `router`: `string`; `token?`: `string`; }
`opts.destChainSelector`	`bigint`
`opts.router`	`string`
`opts.token?`	`string`

Returns

Promise<Partial<LaneFeatures>>

Promise resolving to partial lane features record

Throws

CCIPNotImplementedError if not implemented for this chain family

Example

Get lane features

TypeScript

const features = await chain.getLaneFeatures({
  router: '0x...',
  destChainSelector: 4949039107694359620n,
})
// FINALITY_FAST has three states:
// - undefined: FTF is not supported on this lane (pre-v2.0)
// - 0: the lane supports FTF, but it is not enabled for this token
// - > 0: FTF is enabled with this many block confirmations
const ftf = features[LaneFeature.FINALITY_FAST]
if (ftf != null && ftf > 0) {
  console.log(`FTF enabled with ${ftf} block confirmations`)
} else if (ftf === 0) {
  console.log('FTF supported on this lane but not enabled for this token')
}

Inherited from

Chain.getLaneFeatures

getLaneLatency()

getLaneLatency(destChainSelector: bigint, numberOfBlocks?: number): Promise<LaneLatencyResponse>

Defined in: chain.ts:2048

Fetches estimated lane latency to a destination chain. Uses this chain's selector as the source.

Parameters

Parameter	Type	Description
`destChainSelector`	`bigint`	Destination CCIP chain selector (bigint)
`numberOfBlocks?`	`number`	Optional number of block confirmations to use for latency calculation. When omitted or 0, uses the lane's default finality. When provided as a positive integer, the API returns latency for that custom finality value.

Returns

Promise<LaneLatencyResponse>

Promise resolving to LaneLatencyResponse containing:

totalMs - Estimated delivery time in milliseconds

Throws

CCIPApiClientNotAvailableError if apiClient was disabled (set to null)

Throws

CCIPLaneLatencyInsufficientDataError if the API has too little history for the lane

Throws

CCIPHttpError if API request fails (network error, 4xx, 5xx status)

Remarks

Each call makes a fresh API request. Consider caching results if making frequent calls for the same lane.

Examples

Get estimated delivery time

TypeScript

const chain = await EVMChain.fromUrl('https://eth-mainnet.example.com')
try {
  const latency = await chain.getLaneLatency(4949039107694359620n) // Arbitrum
  console.log(`Estimated delivery: ${Math.round(latency.totalMs / 60000)} minutes`)
} catch (err) {
  if (err instanceof CCIPHttpError) {
    console.error(`API error: ${err.context.apiErrorCode}`)
  }
}

Get latency with custom block confirmations

TypeScript

const latency = await chain.getLaneLatency(4949039107694359620n, 10)
console.log(`Latency with 10 confirmations: ${Math.round(latency.totalMs / 60000)} minutes`)

Inherited from

Chain.getLaneLatency

getLogs()

getLogs(opts: SuiLogStreamOpts): AsyncGenerator<{ address: string; blockNumber: number; blockTimestamp: number; data: Record<string, unknown>; index: number; topics: string[]; transactionHash: string; }, void, unknown>

Defined in: sui/index.ts:532

An async generator that yields logs based on the provided options.

Parameters

Parameter	Type	Description
`opts`	`SuiLogStreamOpts`	Options object containing: - `startBlock`: fetch and generate logs forward starting from this block; required unless startTime is provided; explicit 0 is allowed - `startTime`: instead of a startBlock, a start timestamp may be provided; if either is provided, fetch logs forward from this starting point - `since`: a previous log (preferably the last finalized from a previous call), as log cursor; may be more efficient in some chains for paginating, and may replace `startTime` or `startBlock` - `endBlock`: a fixed block height, finality tag or negative finality depth to stop iteration at; defaults to `latest` - `endBefore`: optional hint signature for end of iteration, instead of endBlock - `address`: if provided, fetch logs for this address only (may be required in some networks/implementations) - `topics`: if provided, fetch logs for these topics only; if string[], it's assumed to be a list of topic0s (i.e. string[] or string[][0], event_ids); some networks/implementations may not be able to filter topics other than topic0s, so one may want to assume those are optimization hints, instead of hard filters, and verify results - `page`: if provided, try to use this page/range for batches - `watch`: true or cancellation promise, stream logs after initial catch-up until endBlock finality tag (e.g. 'finalized'); requires endBlock to be a finality tag

Returns

AsyncGenerator<{ address: string; blockNumber: number; blockTimestamp: number; data: Record<string, unknown>; index: number; topics: string[]; transactionHash: string; }, void, unknown>

An async iterable iterator of logs.

Throws

CCIPLogsAddressRequiredError if address is not provided

Throws

CCIPTopicsInvalidError if topics format is invalid (thrown by streamSuiLogs)

Overrides

Chain.getLogs

getMessageById()

getMessageById(messageId: string, _opts?: { onRamp?: string; page?: number; }): Promise<CCIPRequest<CCIPVersion>>

Defined in: chain.ts:1188

Fetch a CCIP message by its unique message ID.

Parameters

Parameter	Type	Description
`messageId`	`string`	The unique message ID (0x + 64 hex chars)
`_opts?`	{ `onRamp?`: `string`; `page?`: `number`; }	Optional: `onRamp` hint for non-EVM chains
`_opts.onRamp?`	`string`	-
`_opts.page?`	`number`	-

Returns

Promise<CCIPRequest<CCIPVersion>>

CCIPRequest with metadata populated from API

Remarks

Uses the CCIP API to retrieve message details. The returned request includes a metadata field with API-specific information.

Example

TypeScript

const request = await chain.getMessageById(messageId)
console.log(`Sender: ${request.message.sender}`)

if (request.metadata) {
  console.log(`Status: ${request.metadata.status}`)
  if (request.metadata.deliveryTime) {
    console.log(`Delivered in ${request.metadata.deliveryTime}ms`)
  }
}

Throws

CCIPApiClientNotAvailableError if API disabled

Throws

CCIPMessageIdNotFoundError if message not found

Throws

CCIPOnRampRequiredError if onRamp is required but not provided

Throws

CCIPHttpError if API request fails

Inherited from

Chain.getMessageById

getMessagesInBatch()

getMessagesInBatch<R extends { lane: { destChainSelector: bigint; onRamp: string; sourceChainSelector: bigint; version: CCIPVersion; }; log: { blockTimestamp: number; }; message: { sequenceNumber: bigint; } | { sequenceNumber: bigint; } | { sequenceNumber: bigint; } | { sequenceNumber: bigint; } | { sequenceNumber: bigint; } | { sequenceNumber: bigint; }; }>(request: R, range: Pick<CommitReport, "minSeqNr" | "maxSeqNr">, opts?: { page?: number; }): Promise<R["message"][]>

Defined in: chain.ts:1218

Fetches all CCIP messages contained in a given commit batch. To be implemented for chains supporting CCIPVersion v1.6.0 and earlier

Type Parameters

Type Parameter
`R` extends { `lane`: { `destChainSelector`: `bigint`; `onRamp`: `string`; `sourceChainSelector`: `bigint`; `version`: `CCIPVersion`; }; `log`: { `blockTimestamp`: `number`; }; `message`: { `sequenceNumber`: `bigint`; } \| { `sequenceNumber`: `bigint`; } \| { `sequenceNumber`: `bigint`; } \| { `sequenceNumber`: `bigint`; } \| { `sequenceNumber`: `bigint`; } \| { `sequenceNumber`: `bigint`; }; }

Parameters

Parameter	Type	Description
`request`	`R`	CCIPRequest to fetch batch for
`range`	`Pick`<`CommitReport`, `"minSeqNr"` \| `"maxSeqNr"`>	batch range { minSeqnr, maxSeqNr }, e.g. from CommitReport
`opts?`	{ `page?`: `number`; }	Optional parameters (e.g., `page` for pagination width)
`opts.page?`	`number`	-

Returns

Promise<R["message"][]>

Array of messages in the batch

Throws

CCIPMessageBatchIncompleteError if not all messages in range could be fetched

Example

Get all messages in a batch

TypeScript

const verifications = await dest.getVerifications({ offRamp, request })
const messages = await source.getMessagesInBatch(request, verifications.report)
console.log(`Found ${messages.length} messages in batch`)

Inherited from

Chain.getMessagesInBatch

getMessagesInRange()

getMessagesInRange(opts: { address?: string; endBefore?: string; endBlock?: number | bigint | "finalized" | "latest"; page?: number | bigint; since?: { blockTimestamp?: number | bigint; }; startBlock?: number | bigint; startTime?: number | bigint; topics?: (string | string[] | null)[]; typeAndVersions?: readonly (string | RegExp)[]; watch?: boolean | AbortSignal; }): AsyncIterableIterator<CCIPRequest<CCIPVersion>>

Defined in: chain.ts:1154

Discover and decode CCIP messages within a block/slot/checkpoint range.

Parameters

Parameter	Type	Description
`opts`	{ `address?`: `string`; `endBefore?`: `string`; `endBlock?`: `number` \| `bigint` \| `"finalized"` \| `"latest"`; `page?`: `number` \| `bigint`; `since?`: { `blockTimestamp?`: `number` \| `bigint`; }; `startBlock?`: `number` \| `bigint`; `startTime?`: `number` \| `bigint`; `topics?`: (`string` \| `string`[] \| `null`)[]; `typeAndVersions?`: readonly (`string` \| `RegExp`)[]; `watch?`: `boolean` \| `AbortSignal`; }	LogFilter options (startBlock, endBlock, address, topics, page)
`opts.address?`	`string`	Contract address to filter logs by.
`opts.endBefore?`	`string`	Cursor hint for the exclusive upper end of iteration on chains that support it.
`opts.endBlock?`	`number` \| `bigint` \| `"finalized"` \| `"latest"`	Ending block number (inclusive).
`opts.page?`	`number` \| `bigint`	Page size for pagination.
`opts.since?`	{ `blockTimestamp?`: `number` \| `bigint`; }	Resume hint: the last log emitted by a previous getLogs call on the same address/filter. Any subset of fields may be provided; each chain uses what it can. Two layers of behavior: 1. Start floors (ALL chains — see withSinceStart): `blockNumber` and `blockTimestamp` stand in for `startBlock`/`startTime` — each effective floor is the LARGER of the explicitly requested bound and the hint's — so a `since` carrying either satisfies the start requirement on its own. Blocks/versions are always fetched and emitted complete. 2. Block completeness: all chains implementations must guarantee all logs in some block are yielded in the same call before it returns. 3. Exclusive resume (chains with a native per-log cursor): the hinted log itself is NOT re-emitted, and other logs in the same block/tx may also not be; some chains may attempt to yield logs in the same block or transaction, but from 2., the contract guarantees only that logs from the next block or tx on are emitted, so for an hermetic poller, it's safer to only ever pass the last finalized log in the previous call as `since` hint. The hint only ever RAISES the start floors — `startBlock` is the scan floor (the scan never starts below it) and, when a `startBlock` exists, `startTime` is evaluated at filter-time just before emitting. A stale, foreign or malformed hint may be ignored (the usual walk runs). At-least-once is the only guarantee all families share: dedupe by `(transactionHash, index)`. Cursors are FILTER-SCOPED: a hint produced by a NARROWER filter must never be replayed on a wider one. Where the cursor is a per-block prefix (EVM), the wider filter's earlier-index logs in the hinted block count as already emitted and are SKIPPED — a loss, not a duplicate. The SDK cannot validate this: the hint carries the log's own `topics`, never the breadth of the filter that produced it, so a wide sweep and a narrow one over the same block hand out a byte-identical hint while requiring opposite resume behavior (an address mismatch IS detectable and is rejected; a topic-subset resume is not). Key each cursor by the filter that produced it, and start a new filter from its own `startBlock`. Per-family resume — EVM/Solana/TON: the hinted block/tx streams whole and logs at/before the hinted `index` are skipped (later same-block/same-tx logs still flow; TON floors its v3 `/messages` fast path at the hint's created_lt). Aptos: event `index` on single-topic streams, `blockNumber + 1` on multi-topic ones. Sui: inclusive checkpoint floors (re-delivered). Canton: unsupported.
`opts.since.blockTimestamp?`	`number` \| `bigint`	-
`opts.startBlock?`	`number` \| `bigint`	Starting block number (inclusive). Required unless startTime is provided; explicit 0 is allowed.
`opts.startTime?`	`number` \| `bigint`	Starting Unix timestamp (inclusive).
`opts.topics?`	(`string` \| `string`[] \| `null`)[]	Topics to filter logs by.
`opts.typeAndVersions?`	readonly (`string` \| `RegExp`)[]	Restrict logs to contracts whose Chain.typeAndVersion matches any of these. Useful when filtering by topic alone (no `address`) would otherwise match logs from many unrelated contract types — e.g. `ConfigSet` is emitted by OnRamp, OffRamp, CommitStore, FeeQuoter, TokenPool, and PriceRegistry alike. Pass e.g. `['OnRamp']` to keep only on-ramps. See passesTypeAndVersion for the exact matching rule. `undefined`/empty means no restriction (default), and costs nothing — `typeAndVersion` is never called.
`opts.watch?`	`boolean` \| `AbortSignal`	watch mode: polls for new logs after fetching since start (required), until endBlock finality tag (e.g. endBlock=finalized polls only finalized logs); can be an AbortSignal to cancel loop

Returns

AsyncIterableIterator<CCIPRequest<CCIPVersion>>

Async iterator of CCIPRequest objects in native log order

Remarks

This is the range-scanning equivalent of getMessagesInTx. Results are yielded in native log order (block number + log index for EVM, slot order for Solana). Non-CCIP logs in the range are silently skipped.

On Solana, the address parameter is required (router program address). On EVM, it is optional but recommended for public RPCs that require address filtering.

Throws

CCIPChainFamilyUnsupportedError if a pre-v1.6 message is found on a non-EVM chain

Throws

CCIPLogsAddressRequiredError on Solana if address is not provided (thrown by underlying Chain.getLogs)

See

getMessagesInBatch - Batch discovery by sequence number range
getMessagesInTx - Per-transaction message discovery

Example

Scan a block range on EVM

TypeScript

for await (const request of chain.getMessagesInRange({
  startBlock: 1000000,
  endBlock: 1001000,
  address: '0xOnRampAddress...', // optional on EVM
})) {
  console.log(`seqNr=${request.message.sequenceNumber} dest=${request.lane.destChainSelector}`)
}

Inherited from

Chain.getMessagesInRange

getMessagesInTx()

getMessagesInTx(tx: string | ChainTransaction): Promise<CCIPRequest<CCIPVersion>[]>

Defined in: chain.ts:1095

Fetch all CCIP requests in a transaction.

Parameters

Parameter	Type	Description
`tx`	`string` \| `ChainTransaction`	ChainTransaction or txHash to fetch requests from

Returns

Promise<CCIPRequest<CCIPVersion>[]>

Promise resolving to CCIP messages in the transaction (at least one)

Throws

CCIPTransactionNotFoundError if transaction does not exist

Throws

CCIPMessageNotFoundInTxError if no CCIPSendRequested events in tx

Example

Get messages from transaction

TypeScript

const chain = await EVMChain.fromUrl('https://eth-mainnet.example.com')
const requests = await chain.getMessagesInTx('0xabc123...')
for (const req of requests) {
  console.log(`Message ID: ${req.message.messageId}`)
}

Inherited from

Chain.getMessagesInTx

getNativeTokenForRouter()

getNativeTokenForRouter(): Promise<string>

Defined in: sui/index.ts:828

Get the native token address for a Router.

Returns

Promise<string>

Promise resolving to native token address (usually wrapped)

Overrides

Chain.getNativeTokenForRouter

getOffchainTokenData()

getOffchainTokenData(request: { log: { }; message: { ccipReceiveGasLimit: number; ccvAndExecutorHash: string; data: string; destBlob: string; destChainSelector: bigint; encodedMessage: string; executionGasLimit: number; feeToken: string; feeTokenAmount: bigint; finality: FinalityRequested; messageId: string; messageNumber: bigint; offRampAddress: string; onRampAddress: string; receipts: readonly { destBytesOverhead: bigint; destGasLimit: bigint; extraArgs: string; feeTokenAmount: bigint; issuer: string; }[]; receiver: string; sender: string; sequenceNumber: bigint; sourceChainSelector: bigint; tokenAmountBeforeTokenPoolFees: bigint; tokenAmounts: readonly { amount: bigint; destTokenAddress: string; extraData: string; sourcePoolAddress: string; sourceTokenAddress: string; tokenReceiver: string; }[]; verifierBlobs: readonly string[]; } | { data: string; feeToken: string; feeTokenAmount: bigint; gasLimit: bigint; messageId: string; nonce: bigint; receiver: string; sender: string; sequenceNumber: bigint; sourceChainSelector: bigint; sourceTokenData: readonly string[]; strict: boolean; tokenAmounts: readonly { amount: bigint; token: string; }[]; } | { data: string; feeToken: string; feeTokenAmount: bigint; gasLimit: bigint; messageId: string; nonce: bigint; receiver: string; sender: string; sequenceNumber: bigint; sourceChainSelector: bigint; sourceTokenData: readonly string[]; strict: boolean; tokenAmounts: readonly { amount: bigint; destGasAmount: bigint; destTokenAddress: string; extraData: string; sourcePoolAddress: string; token: string; }[]; } | { allowOutOfOrderExecution: boolean; data: string; destChainSelector: bigint; extraArgs: string; feeToken: string; feeTokenAmount: bigint; feeValueJuels: bigint; gasLimit: bigint; messageId: string; nonce: bigint; receiver: string; sender: string; sequenceNumber: bigint; sourceChainSelector: bigint; tokenAmounts: readonly { amount: bigint; destExecData: string; destGasAmount: bigint; destTokenAddress: string; extraData: string; sourcePoolAddress: string; }[]; } | { accountIsWritableBitmap: bigint; accounts: string[]; allowOutOfOrderExecution: boolean; computeUnits: bigint; data: string; destChainSelector: bigint; extraArgs: string; feeToken: string; feeTokenAmount: bigint; feeValueJuels: bigint; messageId: string; nonce: bigint; receiver: string; sender: string; sequenceNumber: bigint; sourceChainSelector: bigint; tokenAmounts: readonly { amount: bigint; destExecData: string; destGasAmount: bigint; destTokenAddress: string; extraData: string; sourcePoolAddress: string; }[]; tokenReceiver: string; } | { allowOutOfOrderExecution: boolean; data: string; destChainSelector: bigint; extraArgs: string; feeToken: string; feeTokenAmount: bigint; feeValueJuels: bigint; gasLimit: bigint; messageId: string; nonce: bigint; receiver: string; receiverObjectIds: string[]; sender: string; sequenceNumber: bigint; sourceChainSelector: bigint; tokenAmounts: readonly { amount: bigint; destExecData: string; destGasAmount: bigint; destTokenAddress: string; extraData: string; sourcePoolAddress: string; }[]; tokenReceiver: string; }; }): Promise<OffchainTokenData[]>

Defined in: chain.ts:1734

Fetch supported offchain token data for a request from this network. It logs but doesn't throw in case it can't fetch attestation, as the transfers may not be from the expected attestation providers. It returns default offchainData=undefined for those.

Parameters

Parameter	Type	Description
`request`	{ `log`: { }; `message`: { `ccipReceiveGasLimit`: `number`; `ccvAndExecutorHash`: `string`; `data`: `string`; `destBlob`: `string`; `destChainSelector`: `bigint`; `encodedMessage`: `string`; `executionGasLimit`: `number`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `finality`: `FinalityRequested`; `messageId`: `string`; `messageNumber`: `bigint`; `offRampAddress`: `string`; `onRampAddress`: `string`; `receipts`: readonly { `destBytesOverhead`: `bigint`; `destGasLimit`: `bigint`; `extraArgs`: `string`; `feeTokenAmount`: `bigint`; `issuer`: `string`; }[]; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmountBeforeTokenPoolFees`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; `sourceTokenAddress`: `string`; `tokenReceiver`: `string`; }[]; `verifierBlobs`: readonly `string`[]; } \| { `data`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `sourceTokenData`: readonly `string`[]; `strict`: `boolean`; `tokenAmounts`: readonly { `amount`: `bigint`; `token`: `string`; }[]; } \| { `data`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `sourceTokenData`: readonly `string`[]; `strict`: `boolean`; `tokenAmounts`: readonly { `amount`: `bigint`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; `token`: `string`; }[]; } \| { `allowOutOfOrderExecution`: `boolean`; `data`: `string`; `destChainSelector`: `bigint`; `extraArgs`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `feeValueJuels`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destExecData`: `string`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; }[]; } \| { `accountIsWritableBitmap`: `bigint`; `accounts`: `string`[]; `allowOutOfOrderExecution`: `boolean`; `computeUnits`: `bigint`; `data`: `string`; `destChainSelector`: `bigint`; `extraArgs`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `feeValueJuels`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destExecData`: `string`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; }[]; `tokenReceiver`: `string`; } \| { `allowOutOfOrderExecution`: `boolean`; `data`: `string`; `destChainSelector`: `bigint`; `extraArgs`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `feeValueJuels`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `receiverObjectIds`: `string`[]; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destExecData`: `string`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; }[]; `tokenReceiver`: `string`; }; }	CCIP request, with tx.hash and message
`request.log`	{ }	-
`request.message`	{ `ccipReceiveGasLimit`: `number`; `ccvAndExecutorHash`: `string`; `data`: `string`; `destBlob`: `string`; `destChainSelector`: `bigint`; `encodedMessage`: `string`; `executionGasLimit`: `number`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `finality`: `FinalityRequested`; `messageId`: `string`; `messageNumber`: `bigint`; `offRampAddress`: `string`; `onRampAddress`: `string`; `receipts`: readonly { `destBytesOverhead`: `bigint`; `destGasLimit`: `bigint`; `extraArgs`: `string`; `feeTokenAmount`: `bigint`; `issuer`: `string`; }[]; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmountBeforeTokenPoolFees`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; `sourceTokenAddress`: `string`; `tokenReceiver`: `string`; }[]; `verifierBlobs`: readonly `string`[]; } \| { `data`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `sourceTokenData`: readonly `string`[]; `strict`: `boolean`; `tokenAmounts`: readonly { `amount`: `bigint`; `token`: `string`; }[]; } \| { `data`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `sourceTokenData`: readonly `string`[]; `strict`: `boolean`; `tokenAmounts`: readonly { `amount`: `bigint`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; `token`: `string`; }[]; } \| { `allowOutOfOrderExecution`: `boolean`; `data`: `string`; `destChainSelector`: `bigint`; `extraArgs`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `feeValueJuels`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destExecData`: `string`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; }[]; } \| { `accountIsWritableBitmap`: `bigint`; `accounts`: `string`[]; `allowOutOfOrderExecution`: `boolean`; `computeUnits`: `bigint`; `data`: `string`; `destChainSelector`: `bigint`; `extraArgs`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `feeValueJuels`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destExecData`: `string`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; }[]; `tokenReceiver`: `string`; } \| { `allowOutOfOrderExecution`: `boolean`; `data`: `string`; `destChainSelector`: `bigint`; `extraArgs`: `string`; `feeToken`: `string`; `feeTokenAmount`: `bigint`; `feeValueJuels`: `bigint`; `gasLimit`: `bigint`; `messageId`: `string`; `nonce`: `bigint`; `receiver`: `string`; `receiverObjectIds`: `string`[]; `sender`: `string`; `sequenceNumber`: `bigint`; `sourceChainSelector`: `bigint`; `tokenAmounts`: readonly { `amount`: `bigint`; `destExecData`: `string`; `destGasAmount`: `bigint`; `destTokenAddress`: `string`; `extraData`: `string`; `sourcePoolAddress`: `string`; }[]; `tokenReceiver`: `string`; }	-

Returns

Promise<OffchainTokenData[]>

Promise resolving to array with one offchain token data for each token transfer

Example

Get offchain token data for USDC transfer

TypeScript

const offchainData = await source.getOffchainTokenData(request)
// Use in execution report

Inherited from

Chain.getOffchainTokenData

getOffRampConfig()

getOffRampConfig(offRamp: string, sourceChainSelector: bigint): Promise<{ chainSelector: bigint; feeQuoter: string; isEnabled: boolean; isRmnVerificationDisabled: boolean; latestPriceSequenceNumber: bigint; minSeqNr: bigint; nonceManager: string; onRamps: string[]; owner: string; permissionlessExecutionThresholdSeconds: number; rmnRemote: string; rmnRemoteConfig: SuiRmnRemoteConfig | undefined; router: string; sourceChainSelector: bigint; tokenAdminRegistry: string; typeAndVersion: string; }>

Defined in: sui/index.ts:786

Fetch the full OffRamp configuration for a given source chain.

Parameters

Parameter	Type	Description
`offRamp`	`string`	OffRamp contract address.
`sourceChainSelector`	`bigint`	Source chain selector.

Returns

Promise<{ chainSelector: bigint; feeQuoter: string; isEnabled: boolean; isRmnVerificationDisabled: boolean; latestPriceSequenceNumber: bigint; minSeqNr: bigint; nonceManager: string; onRamps: string[]; owner: string; permissionlessExecutionThresholdSeconds: number; rmnRemote: string; rmnRemoteConfig: SuiRmnRemoteConfig | undefined; router: string; sourceChainSelector: bigint; tokenAdminRegistry: string; typeAndVersion: string; }>

Merged OffRamp config — at minimum router, onRamp, type, version, typeAndVersion.

Remarks

Returns a merged object containing every static (per-contract) and per-source field exposed by the underlying contract. Concrete subclasses preserve the contract-native field names and return richer objects than the OffRampConfig base interface declares — they may include extra fields available only on specific versions (e.g. EVM v2.0 exposes onRamps: string[]).

Overrides

Chain.getOffRampConfig

getOffRampsForRouter()

getOffRampsForRouter(router: string, _sourceChainSelector: bigint): Promise<string[]>

Defined in: sui/index.ts:834

Fetch the OffRamps allowlisted in a Router. Used to discover OffRamp connected to an OnRamp.

Parameters

Parameter	Type	Description
`router`	`string`	Router contract address
`_sourceChainSelector`	`bigint`	Source chain selector

Returns

Promise<string[]>

Promise resolving to array of OffRamp addresses

Overrides

Chain.getOffRampsForRouter

getOnRampConfig()

getOnRampConfig(onRamp: string, destChainSelector: bigint): Promise<{ allowedSenders: string[]; allowlistAdmin: string; allowlistEnabled: boolean; chainSelector: bigint; destChainSelector: bigint; destRouter: string; expectedNextSequenceNumber: bigint; feeAggregator: string; feeQuoter: string; feeQuoterConfig: SuiFeeQuoterConfig | undefined; nonceManager: string; owner: string; rmnRemote: string; rmnRemoteConfig: SuiRmnRemoteConfig | undefined; router: string; sequenceNumber: bigint; tokenAdminRegistry: string; typeAndVersion: string; }>

Defined in: sui/index.ts:723

Fetch the full OnRamp configuration for a given destination chain.

Parameters

Parameter	Type	Description
`onRamp`	`string`	OnRamp contract address.
`destChainSelector`	`bigint`	Destination chain selector.

Returns

Promise<{ allowedSenders: string[]; allowlistAdmin: string; allowlistEnabled: boolean; chainSelector: bigint; destChainSelector: bigint; destRouter: string; expectedNextSequenceNumber: bigint; feeAggregator: string; feeQuoter: string; feeQuoterConfig: SuiFeeQuoterConfig | undefined; nonceManager: string; owner: string; rmnRemote: string; rmnRemoteConfig: SuiRmnRemoteConfig | undefined; router: string; sequenceNumber: bigint; tokenAdminRegistry: string; typeAndVersion: string; }>

Merged OnRamp config — at minimum router, type, version, typeAndVersion.

Remarks

Returns a merged object containing every static (per-contract) and per-destination field exposed by the underlying contract. Concrete subclasses (e.g. EVMChain) preserve the contract-native field names and return richer objects than the OnRampConfig base interface declares — they may include extra fields available only on specific versions.

Overrides

Chain.getOnRampConfig

getOnRampForRouter()

getOnRampForRouter(router: string, destChainSelector: bigint): Promise<string>

Defined in: sui/index.ts:862

Fetch the OnRamp registered in a Router for a destination chain.

Parameters

Parameter	Type	Description
`router`	`string`	Router contract address
`destChainSelector`	`bigint`	Destination chain selector

Returns

Promise<string>

Promise resolving to OnRamp address

Throws

CCIPError if no onramp of the deployment serves destChainSelector

Overrides

Chain.getOnRampForRouter

getOnRampsForOffRamp()

getOnRampsForOffRamp(offRamp: string, sourceChainSelector: bigint): Promise<string[]>

Defined in: chain.ts:1438

Fetch the OnRamps addresses set in OffRamp config. Used to discover OffRamp connected to an OnRamp.

Parameters

Parameter	Type	Description
`offRamp`	`string`	OffRamp contract address
`sourceChainSelector`	`bigint`	Source chain selector

Returns

Promise<string[]>

Promise resolving to OnRamps addresses

Remarks

Default implementation reads from Chain.getOffRampConfig; if the concrete config exposes an onRamps: string[] (e.g. EVM v2.0 with multiple historical OnRamps), it is returned as-is; otherwise [cfg.onRamp] is returned.

Example

Get onRamp from offRamp config

TypeScript

const [onRamp] = await dest.getOnRampsForOffRamp(offRampAddress, sourceSelector)
console.log(`OnRamp: ${onRamp}`)

Inherited from

Chain.getOnRampsForOffRamp

getRegistryTokenConfig()

getRegistryTokenConfig(registry: string, token: string): Promise<{ administrator: string; pendingAdministrator?: string; tokenPool?: string; }>

Defined in: sui/index.ts:2154

Fetch token configuration from a TokenAdminRegistry.

Parameters

Parameter	Type	Description
`registry`	`string`	TokenAdminRegistry contract address.
`token`	`string`	Token address to query.

Returns

Promise<{ administrator: string; pendingAdministrator?: string; tokenPool?: string; }>

RegistryTokenConfig containing administrator and pool information.

Remarks

The TokenAdminRegistry is a contract that tracks token administrators and their associated pools. Each token has an administrator who can update pool configurations.

Overrides

Chain.getRegistryTokenConfig

getRequiredCCVs()?

optional getRequiredCCVs(opts: { message: GetRequiredCCVsMessage; offRamp: string; }): Promise<GetRequiredCCVsResult>

Defined in: chain.ts:2675

Resolve the CCV set the destination OffRamp will require for a candidate message, and whether its finality is accepted (a rejection throws CCIPFinalityNotAllowedError). A read via the getCCVsForMessage resolver; EVM destinations only. The set is informative and sender-scoped.

Parameters

Parameter	Type	Description
`opts`	{ `message`: `GetRequiredCCVsMessage`; `offRamp`: `string`; }	Destination OffRamp (v2.0) address and the candidate message (GetRequiredCCVsMessage).
`opts.message`	`GetRequiredCCVsMessage`	-
`opts.offRamp`	`string`	-

Returns

Promise<GetRequiredCCVsResult>

{ requiredCCVs, optionalCCVs, optionalThreshold }.

Inherited from

Chain.getRequiredCCVs

getRouterForOffRamp()

getRouterForOffRamp(offRamp: string, sourceChainSelector: bigint): Promise<string>

Defined in: chain.ts:1372

Fetch the Router address set in OffRamp config.

Parameters

Parameter	Type	Description
`offRamp`	`string`	OffRamp contract address
`sourceChainSelector`	`bigint`	Source chain selector

Returns

Promise<string>

Promise resolving to Router address

Remarks

Default implementation reads .router from Chain.getOffRampConfig; subclasses generally need not override this.

Throws

CCIPContractTypeInvalidError if address is not an OffRamp

Example

Get router from offRamp

TypeScript

const router = await chain.getRouterForOffRamp(offRampAddress, sourceSelector)
console.log(`Router: ${router}`)

Inherited from

Chain.getRouterForOffRamp

getRouterForOnRamp()

getRouterForOnRamp(onRamp: string, destChainSelector: bigint): Promise<string>

Defined in: chain.ts:1350

Fetch the Router address set in OnRamp config. Used to discover OffRamp connected to OnRamp.

Parameters

Parameter	Type	Description
`onRamp`	`string`	OnRamp contract address
`destChainSelector`	`bigint`	Destination chain selector

Returns

Promise<string>

Promise resolving to Router address

Remarks

Default implementation reads .router from Chain.getOnRampConfig; subclasses generally need not override this.

Throws

CCIPContractTypeInvalidError if address is not an OnRamp

Example

Get router from onRamp

TypeScript

const router = await chain.getRouterForOnRamp(onRampAddress, destSelector)
console.log(`Router: ${router}`)

Inherited from

Chain.getRouterForOnRamp

getSupportedTokens()

getSupportedTokens(registry: string): Promise<string[]>

Defined in: sui/index.ts:2124

List tokens supported by given TokenAdminRegistry contract.

Parameters

Parameter	Type	Description
`registry`	`string`	Usually TokenAdminRegistry, but chain may support receiving Router, OnRamp, etc.

Returns

Promise<string[]>

Promise resolving to array of supported token addresses

Overrides

Chain.getSupportedTokens

getTokenAdminRegistryFor()

getTokenAdminRegistryFor(address: string, _destChainSelector?: bigint): Promise<string>

Defined in: sui/index.ts:1397

Gets the token admin registry for a ramp of this CCIP deployment. The token admin registry is a module of the ccip package, reachable from any ramp of the deployment through get_ccip_package_id.

Parameters

Parameter	Type	Description
`address`	`string`	Ramp (onramp/offramp) or router (ccip state object) address.
`_destChainSelector?`	`bigint`	Unused on Sui (registry is global to the deployment).

Returns

Promise<string>

Token admin registry address in package::module form.

Overrides

Chain.getTokenAdminRegistryFor

getTokenForTokenPool()

getTokenForTokenPool(tokenPool: string): Promise<string>

Defined in: sui/index.ts:1090

Fetch the TokenPool's token/mint.

Parameters

Parameter	Type	Description
`tokenPool`	`string`	TokenPool address

Returns

Promise<string>

Promise resolving to token or mint address

Throws

CCIPError if token pool type is invalid or state not found

Throws

CCIPDataFormatUnsupportedError if view call fails

Overrides

Chain.getTokenForTokenPool

getTokenInfo()

getTokenInfo(token: string): Promise<{ decimals: number; symbol: string; }>

Defined in: sui/index.ts:1259

Fetch token metadata.

Parameters

Parameter	Type	Description
`token`	`string`	Token address

Returns

Promise<{ decimals: number; symbol: string; }>

Promise resolving to token symbol, decimals, and optionally name

Throws

CCIPError if token address is invalid or metadata cannot be loaded

Overrides

Chain.getTokenInfo

getTokenPoolConfig()

getTokenPoolConfig(tokenPool: string, _feeOpts?: TokenTransferFeeOpts): Promise<TokenPoolConfig>

Defined in: sui/index.ts:2221

Fetch configuration of a token pool.

Parameters

Parameter	Type	Description
`tokenPool`	`string`	Token pool contract address.
`_feeOpts?`	`TokenTransferFeeOpts`	Optional parameters to also fetch token transfer fee config.

Returns

Promise<TokenPoolConfig>

TokenPoolConfig containing token, router, version info, and optionally fee config.

Remarks

Return type varies by chain:

EVM: typeAndVersion is always present (required)
Solana: Includes extra tokenPoolProgram field
Aptos: Standard fields only
Sui/TON: Throws CCIPNotImplementedError

Overrides

Chain.getTokenPoolConfig

getTokenPoolRemote()

getTokenPoolRemote(tokenPool: string, remoteChainSelector: bigint): Promise<TokenPoolRemote>

Defined in: chain.ts:2438

Fetch remote chain configuration for a token pool for a specific destination.

Parameters

Parameter	Type	Description
`tokenPool`	`string`	Token pool address on the current chain.
`remoteChainSelector`	`bigint`	Chain selector of the desired remote chain.

Returns

Promise<TokenPoolRemote>

TokenPoolRemote config for the specified remote chain.

Remarks

Convenience wrapper around getTokenPoolRemotes that returns a single configuration instead of a Record. Use this when you need configuration for a specific destination chain.

Example

TypeScript

const arbitrumSelector = 4949039107694359620n
const remote = await chain.getTokenPoolRemote(poolAddress, arbitrumSelector)
console.log(`Remote token: ${remote.remoteToken}`)
console.log(`Remote pools: ${remote.remotePools.join(', ')}`)

Throws

CCIPTokenPoolChainConfigNotFoundError if no configuration found for the specified remote chain.

Inherited from

Chain.getTokenPoolRemote

getTokenPoolRemotes()

getTokenPoolRemotes(tokenPool: string, remoteChainSelector?: bigint): Promise<Record<string, TokenPoolRemote>>

Defined in: sui/index.ts:2279

Fetch remote chain configurations for a token pool.

Parameters

Parameter	Type	Description
`tokenPool`	`string`	Token pool address on the current chain.
`remoteChainSelector?`	`bigint`	Optional chain selector to filter results to a single destination.

Returns

Promise<Record<string, TokenPoolRemote>>

Record where keys are chain names (e.g., "ethereum-mainnet") and values are TokenPoolRemote configs.

Remarks

A token pool maintains configurations for each destination chain it supports. The returned Record maps chain names to their respective configurations.

Overrides

Chain.getTokenPoolRemotes

getTokenPrice()

getTokenPrice(_opts: { router: string; timestamp?: number; token: string; }): Promise<TokenPrice>

Defined in: chain.ts:2597

Fetch the on-chain USD price of a token from the FeeQuoter or PriceRegistry.

Parameters

Parameter	Type
`_opts`	{ `router`: `string`; `timestamp?`: `number`; `token`: `string`; }
`_opts.router`	`string`
`_opts.timestamp?`	`number`
`_opts.token`	`string`

Returns

Promise<TokenPrice>

Promise resolving to TokenPrice with the USD price per whole token.

Remarks

On EVM, the price contract is resolved via the Router's OnRamp: PriceRegistry for v1.2/v1.5 lanes, FeeQuoter for v1.6+ lanes. When timestamp is provided on EVM, the price is read at the block closest to that timestamp (requires archive node). On Solana and Aptos, the FeeQuoter is resolved directly from the Router config; timestamp is not yet supported and will be ignored.

Throws

CCIPNotImplementedError if not implemented for this chain family

Example

TypeScript

const { price } = await chain.getTokenPrice({
  router: routerAddress,
  token: linkAddress,
})
console.log(`LINK: $${price.toFixed(2)}`)

Inherited from

Chain.getTokenPrice

getTotalFeesEstimate()

getTotalFeesEstimate(_opts: Omit<SendMessageOpts, "approveMax">): Promise<TotalFeesEstimate>

Defined in: chain.ts:2563

Estimate total fees for a cross-chain message.

Returns two components:

ccipFee: from Router.getFee(), denominated in the message's feeToken (native token if omitted). Includes gas, DON costs, and FeeQuoter-level token transfer overhead (all CCIP versions).
tokenTransferFee: pool-level BPS fee deducted from the transferred token amount (v2.0+ only). The recipient receives amount - feeDeducted on the destination chain. Absent on pre-v2.0 lanes or data-only messages.

Parameters

Parameter	Type	Description
`_opts`	`Omit`<`SendMessageOpts`, `"approveMax"`>	SendMessageOpts without approveMax

Returns

Promise<TotalFeesEstimate>

Promise resolving to TotalFeesEstimate

Throws

CCIPNotImplementedError if not implemented for this chain family

Inherited from

Chain.getTotalFeesEstimate

getTransaction()

getTransaction(hash: string | number): Promise<ChainTransaction>

Defined in: sui/index.ts:468

Fetch a transaction by its hash.

Parameters

Parameter	Type	Description
`hash`	`string` \| `number`	Transaction hash

Returns

Promise<ChainTransaction>

Promise resolving to generic transaction details

Overrides

Chain.getTransaction

getVerifications()

getVerifications(opts: { indexer?: NetworkType | readonly string[]; offRamp: string; request: { lane: { destChainSelector: bigint; onRamp: string; sourceChainSelector: bigint; version: CCIPVersion; }; log: { blockTimestamp: number; }; message: { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; } | { messageId: string; sequenceNumber: bigint; }; }; } & VerificationSourcesOpts & Pick<LogFilter, "startBlock" | "watch" | "page">): Promise<CCIPVerifications>

Defined in: chain.ts:1933

Look for a CommitReport at dest for given CCIP request. May be specialized by some subclasses.

Parameters

Parameter	Type	Description
`opts`	{ `indexer?`: `NetworkType` \| readonly `string`[]; `offRamp`: `string`; `request`: { `lane`: { `destChainSelector`: `bigint`; `onRamp`: `string`; `sourceChainSelector`: `bigint`; `version`: `CCIPVersion`; }; `log`: { `blockTimestamp`: `number`; }; `message`: { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; } \| { `messageId`: `string`; `sequenceNumber`: `bigint`; }; }; } & `VerificationSourcesOpts` & `Pick`<`LogFilter`, `"startBlock"` \| `"watch"` \| `"page"`>	getVerifications options

Returns

Promise<CCIPVerifications>

CCIPVerifications

Throws

CCIPCommitNotFoundError if no commit found for the request (transient)

Examples

Get commit for a request

TypeScript

const verifications = await dest.getVerifications({
  offRamp: offRampAddress,
  request,
})
console.log(`Committed at block: ${verifications.log.blockNumber}`)

CCIP v2.0: fall back to a verifier the indexers don't carry

TypeScript

const { verificationPolicy, verifications } = await dest.getVerifications({
  offRamp,
  request,
  verifiers: ['https://verifier.example'], // grpc-web proxy in front of its aggregator
})

Inherited from

Chain.getVerifications

resolveEncodedMessage()

protected resolveEncodedMessage(request: { message: { messageId: string; } | { messageId: string; } | { messageId: string; } | { messageId: string; } | { messageId: string; } | { messageId: string; }; }): Promise<string>

Defined in: chain.ts:1963

The MessageV1Codec-encoded form of a CCIP v2.0 request's message: taken from the request when it carries one (decoded from source logs), else fetched from the CCIP API (whose getMessageById requests don't).

Parameters

Parameter	Type	Description
`request`	{ `message`: { `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; }; }	The v2.0 request
`request.message`	{ `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; } \| { `messageId`: `string`; }	-

Returns

Promise<string>

The 0x-prefixed encoded message

Throws

CCIPApiClientNotAvailableError if it must be fetched and the API is disabled

Inherited from

Chain.resolveEncodedMessage

resolveExecuteOpts()

protected resolveExecuteOpts(opts: ExecuteOpts): Promise<{ input: ExecutionInput; offRamp: string; } & { forceBuffer?: boolean; forceLookupTable?: boolean; gasLimit?: number; receiver?: string; tokensGasLimit?: number; txGasLimit?: number; }>

Defined in: chain.ts:1751

Resolves ExecuteOpts that may contain a messageId (API shorthand) into the canonical { offRamp, input } form required by generateUnsignedExecute.

When opts already contains input the method is a no-op and returns it unchanged. When opts contains only a messageId it calls apiClient.getExecutionInput and merges the result back with any extra opts fields (e.g. gasLimit). If opts.gasLimit is undefined and estimateReceiveExecution is available, try to estimate gasLimitOverride

Parameters

Parameter	Type
`opts`	`ExecuteOpts`

Returns

Promise<{ input: ExecutionInput; offRamp: string; } & { forceBuffer?: boolean; forceLookupTable?: boolean; gasLimit?: number; receiver?: string; tokensGasLimit?: number; txGasLimit?: number; }>

Throws

CCIPApiClientNotAvailableError if messageId is provided but no apiClient

Inherited from

Chain.resolveExecuteOpts

sendMessage()

sendMessage(opts: SendMessageOpts & { txGasLimit?: number; wallet: unknown; }): Promise<CCIPRequest<CCIPVersion>>

Defined in: sui/index.ts:1610

Send a CCIP message through a router using provided wallet.

Parameters

Parameter	Type	Description
`opts`	`SendMessageOpts` & { `txGasLimit?`: `number`; `wallet`: `unknown`; }	SendMessageOpts with chain-specific wallet for signing

Returns

Promise<CCIPRequest<CCIPVersion>>

Promise resolving to CCIP request with message details

Overrides

Chain.sendMessage

simulateLockOrBurn()?

optional simulateLockOrBurn(opts: { amount: bigint; destChainSelector: bigint; finality?: FinalityRequested; onRamp: string; originalSender?: string; receiver?: string; token: string; tokenArgs?: string; tokenReceiver?: string; }): Promise<{ destPoolData: string; destTokenAddress: string; destTokenAmount: bigint; sourcePoolAddress: string; }>

Defined in: chain.ts:2616

Simulate the source pool's lockOrBurn for a prospective token transfer and return the pool-reported destTokenAddress, destPoolData (the value the destination pool's releaseOrMint consumes as sourcePoolData) and destTokenAmount (the post-fee amount the OnRamp writes into the emitted message), plus the resolved source pool address.

Optional; currently implemented for EVM chains. Used by estimateReceiveExecution to feed the destination-liquidity simulation the same source pool data a real transfer would carry.

Parameters

Parameter	Type	Description
`opts`	{ `amount`: `bigint`; `destChainSelector`: `bigint`; `finality?`: `FinalityRequested`; `onRamp`: `string`; `originalSender?`: `string`; `receiver?`: `string`; `token`: `string`; `tokenArgs?`: `string`; `tokenReceiver?`: `string`; }	lane (`onRamp`, `destChainSelector`), `token` and `amount` (source decimals), and optionally `originalSender`, `receiver`, `tokenReceiver`, `tokenArgs`, and the requested `finality`
`opts.amount`	`bigint`	Amount in the source token's decimals
`opts.destChainSelector`	`bigint`	Destination chain selector
`opts.finality?`	`FinalityRequested`	Requested finality (v2 pools take it as the 2nd `lockOrBurn` argument)
`opts.onRamp`	`string`	OnRamp registered on the source Router for the destination chain
`opts.originalSender?`	`string`	Sender of the prospective message
`opts.receiver?`	`string`	Receiver on the destination chain
`opts.token`	`string`	Source token address
`opts.tokenArgs?`	`string`	Message-level `GenericExtraArgsV3.tokenArgs`, passed through to IPoolV2 pools
`opts.tokenReceiver?`	`string`	Token receiver on the destination chain (v3 extraArgs); when set, takes precedence over `receiver` as the pool's `lockOrBurnIn.receiver`, mirroring the OnRamp

Returns

Promise<{ destPoolData: string; destTokenAddress: string; destTokenAmount: bigint; sourcePoolAddress: string; }>

resolved sourcePoolAddress, destTokenAddress + destPoolData as returned by the pool, and the post-fee destTokenAmount

Inherited from

Chain.simulateLockOrBurn

typeAndVersion()

typeAndVersion(address: string): Promise<[string, string, string, string]>

Defined in: sui/index.ts:572

Fetch typeAndVersion for a given CCIP contract address.

Parameters

Parameter	Type	Description
`address`	`string`	CCIP contract address

Returns

Promise<[string, string, string, string]>

Promise resolving to tuple:

type - Parsed type of the contract, e.g. OnRamp
version - Parsed version of the contract, e.g. 1.6.0
typeAndVersion - Original (unparsed) typeAndVersion() string
suffix - Suffix of the version, if any (e.g. -dev)

Throws

CCIPDataFormatUnsupportedError if view call fails

Overrides

Chain.typeAndVersion

waitFinalized()

waitFinalized(opts: { abort?: AbortSignal; finality?: number | bigint | "finalized" | "latest"; pollInterval?: number; reorgSafetyBlocks?: number; } & { request: { log: { blockTimestamp: number | bigint; }; }; } | { log: { blockTimestamp: number | bigint; }; }): Promise<BlockInfo | undefined>

Defined in: chain.ts:1017

Confirm a log tx is finalized or wait for it to be finalized.

Parameters

Parameter	Type	Description
`opts`	{ `abort?`: `AbortSignal`; `finality?`: `number` \| `bigint` \| `"finalized"` \| `"latest"`; `pollInterval?`: `number`; `reorgSafetyBlocks?`: `number`; } & { `request`: { `log`: { `blockTimestamp`: `number` \| `bigint`; }; }; } \| { `log`: { `blockTimestamp`: `number` \| `bigint`; }; }	Options containing the request, finality level, and optional cancel promise

Returns

Promise<BlockInfo | undefined>

Some block info at or after tx finalization

Throws

CCIPTransactionNotFinalizedError if the transaction is not included (e.g., due to a reorg)

Example

Wait for message finality

TypeScript

const request = await source.getMessagesInTx(txHash)
try {
  await source.waitFinalized({ request: request[0] })
  console.log('Transaction finalized')
} catch (err) {
  if (err instanceof CCIPTransactionNotFinalizedError) {
    console.log('Transaction not yet finalized')
  }
}

Inherited from

Chain.waitFinalized

buildMessageForDest()

static buildMessageForDest(message: MessageInput): AnyMessage & { extraArgs: SuiExtraArgsV1; }

Defined in: sui/index.ts:2376

Returns a copy of a message, populating missing fields like extraArgs with defaults. It's expected to return a message suitable at least for basic token transfers.

Parameters

Parameter	Type	Description
`message`	`MessageInput`	AnyMessage (from source), containing at least `receiver`

Returns

AnyMessage & { extraArgs: SuiExtraArgsV1; }

A message suitable for sendMessage to this destination chain family

Throws

CCIPArgumentInvalidError if extraArgs contains unknown fields for SuiExtraArgsV1

Overrides

Chain.buildMessageForDest

decodeCommits()

static decodeCommits(log: { data: Record<string, unknown> | BytesLike; }, lane?: Lane<CCIPVersion>): { maxSeqNr: bigint; merkleRoot: string; minSeqNr: bigint; onRampAddress: string; sourceChainSelector: bigint; }[] | undefined

Defined in: sui/index.ts:1458

Decodes commit reports from a log entry.

Parameters

Parameter	Type	Description
`log`	{ `data`: `Record`<`string`, `unknown`> \| `BytesLike`; }	The log entry to decode.
`log.data`	`Record`<`string`, `unknown`> \| `BytesLike`	Log data as bytes or parsed object.
`lane?`	`Lane`<`CCIPVersion`>	Optional lane information.

Returns

{ maxSeqNr: bigint; merkleRoot: string; minSeqNr: bigint; onRampAddress: string; sourceChainSelector: bigint; }[] | undefined

Array of decoded commit reports or undefined.

decodeExtraArgs()

static decodeExtraArgs(extraArgs: BytesLike): EVMExtraArgsV1 & { allowOutOfOrderExecution: boolean; } & { _tag: "EVMExtraArgsV2"; } | SVMExtraArgsV1 & { _tag: "SVMExtraArgsV1"; } | EVMExtraArgsV1 & { allowOutOfOrderExecution: boolean; } & { receiverObjectIds: string[]; tokenReceiver: string; } & { _tag: "SuiExtraArgsV1"; } | undefined

Defined in: sui/index.ts:1429

Decodes extra arguments from Sui CCIP messages.

Parameters

Parameter	Type	Description
`extraArgs`	`BytesLike`	Encoded extra arguments bytes.

Returns

Decoded extra arguments or undefined if unknown format.

EVMExtraArgsV1 & { allowOutOfOrderExecution: boolean; } & { _tag: "EVMExtraArgsV2"; }

SVMExtraArgsV1 & { _tag: "SVMExtraArgsV1"; }

EVMExtraArgsV1 & { allowOutOfOrderExecution: boolean; } & { receiverObjectIds: string[]; tokenReceiver: string; } & { _tag: "SuiExtraArgsV1"; }

undefined

decodeMessage()

static decodeMessage(log: { blockTimestamp: number; data: Record<string, unknown> | BytesLike; tx?: { blockNumber: number; error?: unknown; from: string; hash: string; logs?: readonly { transactionHash: string; blockNumber: number; address: string; topics: readonly string[]; index: number; blockTimestamp: number; data: Record<string, unknown> | BytesLike; tx?: { hash: string; ... 4 more ...; logs?: readonly ...[] | undefined; } | undefined; }[]; timestamp: number; }; }): CCIPMessage | undefined

Defined in: sui/index.ts:1409

Decodes a CCIP message from a Sui log event.

Parameters

Parameter	Type	Description
`log`	{ `blockTimestamp`: `number`; `data`: `Record`<`string`, `unknown`> \| `BytesLike`; `tx?`: { `blockNumber`: `number`; `error?`: `unknown`; `from`: `string`; `hash`: `string`; `logs?`: readonly { transactionHash: string; blockNumber: number; address: string; topics: readonly string[]; index: number; blockTimestamp: number; data: Record<string, unknown> \| BytesLike; tx?: { hash: string; ... 4 more ...; logs?: readonly ...[] \| undefined; } \| undefined; }[]; `timestamp`: `number`; }; }	Log event data.
`log.blockTimestamp`	`number`	-
`log.data`	`Record`<`string`, `unknown`> \| `BytesLike`	Log data as bytes or parsed object.
`log.tx?`	{ `blockNumber`: `number`; `error?`: `unknown`; `from`: `string`; `hash`: `string`; `logs?`: readonly { transactionHash: string; blockNumber: number; address: string; topics: readonly string[]; index: number; blockTimestamp: number; data: Record<string, unknown> \| BytesLike; tx?: { hash: string; ... 4 more ...; logs?: readonly ...[] \| undefined; } \| undefined; }[]; `timestamp`: `number`; }	Optional reference to the containing transaction.
`log.tx.blockNumber`	`number`	Block number containing this transaction.
`log.tx.error?`	`unknown`	Optional error if transaction failed.
`log.tx.from`	`string`	Sender address.
`log.tx.hash`	`string`	Transaction hash.
`log.tx.logs?`	readonly { transactionHash: string; blockNumber: number; address: string; topics: readonly string[]; index: number; blockTimestamp: number; data: Record<string, unknown> \| BytesLike; tx?: { hash: string; ... 4 more ...; logs?: readonly ...[] \| undefined; } \| undefined; }[]	Logs emitted by this transaction.
`log.tx.timestamp`	`number`	Unix timestamp of the block.

Returns

CCIPMessage | undefined

Decoded CCIPMessage or undefined if not valid.

Throws

CCIPSuiLogInvalidError if log data format is invalid

decodeReceipt()

static decodeReceipt(log: { data: Record<string, unknown> | BytesLike; }): ExecutionReceipt | undefined

Defined in: sui/index.ts:1492

Decodes an execution receipt from a log entry.

Parameters

Parameter	Type	Description
`log`	{ `data`: `Record`<`string`, `unknown`> \| `BytesLike`; }	The log entry to decode.
`log.data`	`Record`<`string`, `unknown`> \| `BytesLike`	Log data as bytes or parsed object.

Returns

ExecutionReceipt | undefined

Decoded execution receipt or undefined.

encodeExtraArgs()

static encodeExtraArgs(args: ExtraArgs): string

Defined in: sui/index.ts:1448

Encodes extra arguments for Sui CCIP messages in BCS format. Dispatches to the correct encoder based on the destination chain's extraArgs type:

SVMExtraArgsV1 (Solana dest): BCS {computeUnits, accountIsWritableBitmap, ...}
SuiExtraArgsV1 (Sui dest): BCS {gasLimit, allowOutOfOrderExecution, ...}
EVMExtraArgsV2 / GenericExtraArgsV2 (EVM dest): BCS {gasLimit: u256, ...}

Parameters

Parameter	Type	Description
`args`	`ExtraArgs`	Extra arguments to encode.

Returns

string

Encoded extra arguments as a hex string.

fromUrl()

static fromUrl(url: string, ctx?: ChainContext): Promise<SuiChain>

Defined in: sui/index.ts:369

Creates a SuiChain instance from an RPC URL.

Parameters

Parameter	Type	Description
`url`	`string`	HTTP or WebSocket endpoint URL for the Sui network.
`ctx?`	`ChainContext`	-

Returns

Promise<SuiChain>

A new SuiChain instance.

Throws

CCIPDataFormatUnsupportedError if the endpoint doesn't answer Sui RPCs, or if its chain identifier can't be determined

Throws

CCIPError if chain identifier is not supported

getAddress()

static getAddress(bytes: BytesLike | readonly number[]): string

Defined in: sui/index.ts:1540

Converts bytes to a Sui address.

Parameters

Parameter	Type	Description
`bytes`	`BytesLike` \| readonly `number`[]	Bytes to convert.

Returns

string

Sui address in canonical short form (0x-prefixed hex, leading zero nibbles stripped).

getDestLeafHasher()

static getDestLeafHasher(lane: Lane, _ctx?: WithLogger): LeafHasher

Defined in: sui/index.ts:1558

Gets the leaf hasher for Sui destination chains.

Parameters

Parameter	Type	Description
`lane`	`Lane`	Lane configuration.
`_ctx?`	`WithLogger`	-

Returns

LeafHasher

Leaf hasher function.

isTxHash()

static isTxHash(v: unknown): v is string

Defined in: sui/index.ts:1547

Validates a transaction hash format for Sui

Parameters

Parameter	Type
`v`	`unknown`

Returns

v is string

parse()

static parse(data: unknown): Record<string, unknown> | undefined

Defined in: sui/index.ts:2106

Parses raw Sui data into typed structures.

Parameters

Parameter	Type	Description
`data`	`unknown`	Raw data to parse.

Returns

Record<string, unknown> | undefined

Parsed data or undefined.

Extends​

Indexable​

Constructors​

Constructor​

Parameters​

Returns​

Overrides​

Properties​

abort​

Inherited from​

apiClient​

Inherited from​

apiRetryConfig​

Inherited from​

client​

destroy​

Parameters​

Returns​

Inherited from​

logger​

Inherited from​

network​

Overrides​

verificationsIndexer?​

Inherited from​

verifierTransport?​

Inherited from​

decimals​

family​

Methods​

estimateReceiveExecution()?​

Parameters​

Returns​

Inherited from​

execute()​

Parameters​

Returns​

Throws​

Throws​

Overrides​

fetchCCVResults()​

Parameters​

Returns​

Throws​

Inherited from​

generateUnsignedExecute()​

Parameters​

Returns​

Throws​

Overrides​

generateUnsignedSendMessage()​

Parameters​

Returns​

Overrides​

getBalance()​

Parameters​

Returns​

Throws​

Overrides​

getBlockInfo()​

Parameters​

Returns​

Overrides​

getBlockTimestamp()​

Parameters​

Returns​

Deprecated​

Inherited from​

getExecutionInput()​

Parameters​

Returns​

See​

Inherited from​

getExecutionReceipts()​

Parameters​

Returns​

Overrides​

getExecutionReceiptsInTx()​

Parameters​

Returns​

Extends

Indexable

Constructors

Constructor

Parameters

Returns

Overrides

Properties

abort

Inherited from

apiClient

Inherited from

apiRetryConfig

Inherited from

client

destroy

Parameters

Returns

Inherited from

logger

Inherited from

network

Overrides

verificationsIndexer?

Inherited from

verifierTransport?

Inherited from

decimals

family

Methods

estimateReceiveExecution()?

Parameters

Returns

Inherited from

execute()

Parameters

Returns

Throws

Throws

Overrides

fetchCCVResults()

Parameters

Returns

Throws

Inherited from

generateUnsignedExecute()

Parameters

Returns

Throws

Overrides

generateUnsignedSendMessage()

Parameters

Returns

Overrides

getBalance()

Parameters

Returns

Throws

Overrides

getBlockInfo()

Parameters

Returns

Overrides

getBlockTimestamp()

Parameters

Returns

Deprecated

Inherited from

getExecutionInput()

Parameters

Returns

See

Inherited from

getExecutionReceipts()

Parameters

Returns

Overrides

getExecutionReceiptsInTx()

Parameters

Returns