Skip to main content
Version: 1.15.0

Function: fetchVerifications()

fetchVerifications(messageId: string, opts?: FetchVerificationsOpts): Promise<VerifierResult[]>

Defined in: commits.ts:146

Fetch CCV verifications for a CCIP v2.0 message.

Sources, by precedence: opts.known; then the API client raced against every indexer URL via Promise.any; then opts.verifiers, one at a time. Without opts.policy the first managed source to answer wins. With it, partial answers are merged per destination CCV until the policy is covered, and the verifiers are contacted only if the API and indexers leave it uncovered, so routine reads stay on managed infrastructure.

When opts.watch is supplied the function retries on CCIPMessageNotVerifiedYetError at opts.pollInterval ms intervals until the signal fires.

Parameters​

ParameterTypeDescription
messageIdstringThe CCIP message ID (hex string)
optsFetchVerificationsOptsSee FetchVerificationsOpts

Returns​

Promise<VerifierResult[]>

The verifier results, one per destination CCV

Throws​

CCIPMessageNotVerifiedYetError if the sources don't cover opts.policy (or, without one, all fail) and opts.watch is not live; its context names the missing CCVs and why each verifier endpoint failed

Throws​

CCIPArgumentInvalidError if opts.indexer contains a non-string entry