@chainlink/ccip-sdk 0.92.1 → 0.93.0

package/src/index.ts

@@ -1,5 +1,9 @@
+export type { APIErrorResponse, CCIPAPIClientContext, LaneLatencyResponse } from './api/index.ts'
+export { CCIPAPIClient, DEFAULT_API_BASE_URL } from './api/index.ts'
+
 export type {
   Chain,
+  ChainContext,
   ChainGetter,
   ChainStatic,
   LogFilter,
@@ -18,7 +22,7 @@ export {
   encodeExtraArgs,
 } from './extra-args.ts'
 export { estimateExecGasForRequest } from './gas.ts'
-export { decodeMessage, fetchRequestsForSender, sourceToDestTokenAmounts } from './requests.ts'
+export { decodeMessage, getMessagesForSender, sourceToDestTokenAmounts } from './requests.ts'
 export {
   type AnyMessage,
   type CCIPCommit,
@@ -36,6 +40,8 @@ export {
   type WithLogger,
   CCIPVersion,
   ExecutionState,
+  IntentStatus,
+  MessageStatus,
 } from './types.ts'
 export {
   bigIntReplacer,
@@ -46,16 +52,27 @@ export {
   isSupportedTxHash,
   networkInfo,
 } from './utils.ts'
+export {
+  type CCIPExplorerLinks,
+  type ExplorerLinkType,
+  CCIP_EXPLORER_BASE_URL,
+  getCCIPExplorerLinks,
+  getCCIPExplorerUrl,
+} from './explorer.ts'
 
 // errors
 export * from './errors/index.ts'
 
 // chains
 import { AptosChain } from './aptos/index.ts'
+export type { UnsignedAptosTx } from './aptos/index.ts'
 import { EVMChain } from './evm/index.ts'
+export type { UnsignedEVMTx } from './evm/index.ts'
 import { SolanaChain } from './solana/index.ts'
+export type { UnsignedSolanaTx } from './solana/index.ts'
 import { SuiChain } from './sui/index.ts'
 import { TONChain } from './ton/index.ts'
+export type { UnsignedTONTx } from './ton/index.ts'
 import { ChainFamily } from './types.ts'
 export { AptosChain, ChainFamily, EVMChain, SolanaChain, SuiChain, TONChain }
 // use `supportedChains` to override/register derived classes, if needed

package/src/offchain.ts

@@ -64,7 +64,7 @@ export async function getLbtcAttestation(
     method: 'POST',
     body: JSON.stringify({ messageHash: [payloadHash] }),
   })
-  const response = (await res.json()) as LombardAttestationsResponse
+  const response = (await res.json()) as LombardAttestationsResponse | null
   if (response == null || !('attestations' in response)) {
     throw new CCIPLbtcAttestationNotFoundError(payloadHash, response)
   }

package/src/requests.ts

@@ -25,7 +25,7 @@ import {
 } from './types.ts'
 import { convertKeysToCamelCase, decodeAddress, leToBigInt, networkInfo } from './utils.ts'
 
-function decodeJsonMessage(data: Record<string, unknown>) {
+function decodeJsonMessage(data: Record<string, unknown> | undefined) {
   if (!data || typeof data != 'object') throw new CCIPMessageInvalidError(data)
   if (data.message) data = data.message as Record<string, unknown>
   if (data.header) {
@@ -60,7 +60,7 @@ function decodeJsonMessage(data: Record<string, unknown>) {
   }
 
   for (const ta of data_.tokenAmounts) {
-    if (ta.destGasAmount != null || ta.destExecData == null) continue
+    if (ta.destGasAmount != null || !ta.destExecData) continue
     switch (sourceNetwork.family) {
       // EVM & Solana encode destExecData as big-endian
       case ChainFamily.EVM:
@@ -90,7 +90,7 @@ function decodeJsonMessage(data: Record<string, unknown>) {
 export function decodeMessage(data: string | Uint8Array | Record<string, unknown>): CCIPMessage {
   if (
     (typeof data === 'string' && data.startsWith('{')) ||
-    (typeof data === 'object' && data !== null && !isBytesLike(data))
+    (typeof data === 'object' && !isBytesLike(data))
   ) {
     if (typeof data === 'string')
       data = yaml.parse(data, { intAsBigInt: true }) as Record<string, unknown>
@@ -115,10 +115,7 @@ export function decodeMessage(data: string | Uint8Array | Record<string, unknown
  * @param tx - ChainTransaction to search in
  * @returns CCIP requests (messages) in the transaction (at least one)
  **/
-export async function fetchCCIPRequestsInTx(
-  source: Chain,
-  tx: ChainTransaction,
-): Promise<CCIPRequest[]> {
+export async function getMessagesInTx(source: Chain, tx: ChainTransaction): Promise<CCIPRequest[]> {
   const txHash = tx.hash
 
   const requests: CCIPRequest[] = []
@@ -156,7 +153,7 @@ export async function fetchCCIPRequestsInTx(
  * @param hints - Optional hints for pagination (e.g., `address` for onRamp, `page` for pagination size).
  * @returns CCIPRequest with given messageId.
  */
-export async function fetchCCIPRequestById(
+export async function getMessageById(
   source: Chain,
   messageId: string,
   hints?: { page?: number; address?: string },
@@ -201,7 +198,7 @@ const BLOCK_LOG_WINDOW_SIZE = 5000
  * @param opts - Optional log filtering parameters.
  * @returns Array of messages in the batch.
  */
-export async function fetchAllMessagesInBatch<
+export async function getMessagesInBatch<
   C extends Chain,
   R extends PickDeep<
     CCIPRequest,
@@ -249,7 +246,7 @@ export async function fetchAllMessagesInBatch<
       messages.push(message)
       if (message.sequenceNumber >= maxSeqNr) break
     }
-    if (messages.length && messages[0].sequenceNumber > minSeqNr) {
+    if (messages.length && messages[0]!.sequenceNumber > minSeqNr) {
       // still work to be done backwards
       delete filter['startBlock']
       filter['endBlock'] = backwardsEndBlock
@@ -287,7 +284,7 @@ export async function fetchAllMessagesInBatch<
  * @param filter - Log filter options.
  * @returns Async generator of CCIP requests.
  */
-export async function* fetchRequestsForSender(
+export async function* getMessagesForSender(
   source: Chain,
   sender: string,
   filter: Pick<LogFilter, 'address' | 'startBlock' | 'startTime' | 'endBlock'>,
@@ -348,7 +345,7 @@ export async function sourceToDestTokenAmounts<S extends { token: string }>(
       return {
         ...rest,
         sourcePoolAddress,
-        destTokenAddress: remotes[networkInfo(destChainSelector).name].remoteToken,
+        destTokenAddress: remotes[networkInfo(destChainSelector).name]!.remoteToken,
       }
     }),
   )

package/src/solana/cleanup.ts

@@ -92,7 +92,7 @@ export async function cleanUpBuffers(
         logger.info('🗑️  Closed lookup table', altAddr, ': tx =>', sig)
       } catch (err) {
         const info = await connection.getAddressLookupTable(lookupTable)
-        if (!info?.value) break
+        if (!info.value) break
         else if (info.value.state.deactivationSlot < 2n ** 63n)
           deactivationSlot = Number(info.value.state.deactivationSlot)
         logger.warn('Failed to close lookup table', altAddr, err)
@@ -181,12 +181,12 @@ export async function cleanUpBuffers(
       }
       case 'Instruction: DeactivateLookupTable':
       case 'Instruction: CreateLookupTable': {
-        const lookupTable = tx.tx.transaction.message.staticAccountKeys[1]
+        const lookupTable = tx.tx.transaction.message.staticAccountKeys[1]!
         if (seenAccs.has(lookupTable.toBase58())) continue
         seenAccs.add(lookupTable.toBase58())
 
         const info = await connection.getAddressLookupTable(lookupTable)
-        if (!info?.value) {
+        if (!info.value) {
           alreadyClosed++ // assume we're done when we hit Nth closed ALT; maybe add an option to keep going?
           logger.debug('Lookup table', lookupTable.toBase58(), 'already closed')
         } else if (info.value.state.authority?.toBase58() !== wallet.publicKey.toBase58()) {
@@ -201,7 +201,7 @@ export async function cleanUpBuffers(
           pendingPromises.push(closeAlt(lookupTable, Number(info.value.state.deactivationSlot)))
         } else if (
           info.value.state.addresses.length >= 18 &&
-          info.value.state.addresses[6].equals(wallet.publicKey)
+          info.value.state.addresses[6]!.equals(wallet.publicKey)
         ) {
           // the conditions above match for ALTs created for ccip manualExec
           const deactivateIx = AddressLookupTableProgram.deactivateLookupTable({

package/src/solana/exec.ts

@@ -105,18 +105,18 @@ export async function generateUnsignedExecuteReport(
   const execIx = await program.methods
     .manuallyExecute(serializedReport, tokenIndexes)
     .accounts({
-      config: accounts[0].pubkey,
-      referenceAddresses: accounts[1].pubkey,
-      sourceChain: accounts[2].pubkey,
-      commitReport: accounts[3].pubkey,
-      offramp: accounts[4].pubkey,
-      allowedOfframp: accounts[5].pubkey,
-      authority: accounts[6].pubkey,
-      systemProgram: accounts[7].pubkey,
-      sysvarInstructions: accounts[8].pubkey,
-      rmnRemote: accounts[9].pubkey,
-      rmnRemoteCurses: accounts[10].pubkey,
-      rmnRemoteConfig: accounts[11].pubkey,
+      config: accounts[0]!.pubkey,
+      referenceAddresses: accounts[1]!.pubkey,
+      sourceChain: accounts[2]!.pubkey,
+      commitReport: accounts[3]!.pubkey,
+      offramp: accounts[4]!.pubkey,
+      allowedOfframp: accounts[5]!.pubkey,
+      authority: accounts[6]!.pubkey,
+      systemProgram: accounts[7]!.pubkey,
+      sysvarInstructions: accounts[8]!.pubkey,
+      rmnRemote: accounts[9]!.pubkey,
+      rmnRemoteCurses: accounts[10]!.pubkey,
+      rmnRemoteConfig: accounts[11]!.pubkey,
     })
     .remainingAccounts(accounts.slice(12))
     .instruction()
@@ -414,7 +414,7 @@ async function autoDeriveExecutionAccounts({
 
   const [configPDA] = PublicKey.findProgramAddressSync([Buffer.from('config')], offramp.programId)
 
-  while (true) {
+  while (stage) {
     const params: IdlTypes<typeof CCIP_OFFRAMP_IDL>['DeriveAccountsExecuteParams'] = {
       executeCaller: payer,
       messageAccounts: messagingAccounts,
@@ -481,11 +481,6 @@ async function autoDeriveExecutionAccounts({
     // Collect lookup tables
     lookupTables.push(...response.lookUpTablesToSave)
 
-    // Check if derivation is complete
-    if (!response.nextStage || response.nextStage.length === 0) {
-      break
-    }
-
     stage = response.nextStage
   }