@chainlink/ccip-sdk 0.91.0 → 0.92.0

package/README.md

@@ -1,118 +1,165 @@
 # @chainlink/ccip-sdk
 
-## Typescript SDK to interact with CCIP.
-
-This tool can be used to query and interact with [CCIP](https://ccip.chain.link) contracts deployed
-in supported blockchains, through its publicly accessible data and methods, requiring only
-compatible RPCs for each involved network.
+TypeScript SDK for integrating [CCIP](https://chain.link/cross-chain) (Cross-Chain Interoperability Protocol) into your applications.
 
 > [!IMPORTANT]
 > This tool is provided under an MIT license and is for convenience and illustration purposes only.
 
-## Installation
+📖 **[Full SDK Documentation](https://github.com/smartcontractkit/ccip-tools-ts/blob/main/docs/sdk/index.md)** - Complete API reference, advanced patterns, and tree-shaking guide.
 
-To install it from latest NpmJS release, do:
+## Installation
 
-```sh
-npm install @smartcontractkit/ccip-sdk
+```bash
+npm install @chainlink/ccip-sdk
 ```
 
 > [!NOTE]
-> NodeJS version v20+ is required, with v23+ recommended.
+> Node.js v20+ required. v23+ recommended for native TypeScript execution.
 
-## Chain
+## Chain Classes
 
-The [Chain](./src/chain.ts) abstract class provides the specification of an interface which must be
-implemented to provide support for a given chain family. Static methods are required by the
-`ChainStatic` interface, and are used for functions that don't require an instance or provider.
+The SDK provides a unified `Chain` class interface for each blockchain family. Create instances using `fromUrl`:
 
-Currently, there are implementations for:
-- [EVM](./src/evm/index.ts): uses [ethers.js](https://docs.ethers.org/v6/)
-- [Solana](./src/solana/index.ts): uses [solana-web3.js](https://github.com/solana-foundation/solana-web3.js) and [Anchor](https://github.com/solana-foundation/anchor)
-- [Aptos](./src/aptos/index.ts): uses [aptos-ts-sdk](https://github.com/aptos-labs/aptos-ts-sdk)
+```ts
+import { EVMChain, SolanaChain, AptosChain } from '@chainlink/ccip-sdk'
 
-We try to not expose or require users to comply with these libraries, returning generic values and
-errors, but some factories may receive specific providers types.
+// EVM chains (Ethereum, Arbitrum, Optimism, etc.)
+const evmChain = await EVMChain.fromUrl('https://ethereum-sepolia-rpc.publicnode.com')
 
-The Chain class defines some methods, which can be overriden by specific families to offer optimized
-implementations. One can extend any of the subclasses and get them registered in the
-[supportedChains](./src/supported-chains.ts) mapping, or even construct directly.
+// Solana
+const solanaChain = await SolanaChain.fromUrl('https://api.devnet.solana.com')
 
-```ts
-import { SolanaChain, supportedChains, ChainFamily } from '@chainlink/ccip-sdk'
-class MySolanaChain extends SolanaChain {
-  // ...custom implementation
-}
-supportedChains[ChainFamily.Solana] = MySolanaChain
+// Aptos
+const aptosChain = await AptosChain.fromUrl('https://api.testnet.aptoslabs.com/v1')
 ```
 
-## Async constructors
+## Common Tasks
 
-Each chain family class has an static async constructor, which can be used to create a new instance
-of the chain class with a provider. The only common/required signature is
-`fromUrl(url: string): Promise<Chain>`, but each chain family class usually also provides a
-constructor from the specific library provider (e.g. `EVMChain.fromProvider(provider: ethers.JsonRpcApiProvider)`)
+### Track a CCIP Message
 
-## Wallet
+```ts
+import { EVMChain } from '@chainlink/ccip-sdk'
 
-Transaction-sending high-level methods, namely `Chain.sendMessage` and `Chain.executeReport`,
-require a `wallet` property in last `opts` parameter. This is marked as `unknown` in generic Chain
-abstract class, but required to be an asynchronous signer wallet respective to each chain family:
+const source = await EVMChain.fromUrl('https://ethereum-sepolia-rpc.publicnode.com')
 
-- `EVMChain` requires an `ethers` `Signer`
-- `SolanaChain` requires an `anchor` `Wallet`
-- `AptosChain` requires an `aptos-ts-sdk` `Account`
+// Fetch message details from a transaction
+const requests = await source.fetchRequestsInTx(
+  '0xb8b27d9811509e3c364c9afaf8f14d8ebc65dec06327493981d7f7f4a00f2918'
+)
 
-These signers are used in the simplest way possible (i.e. using address accessors where needed,
-and `async signTransaction`-like methods), so developers may be able to easily inject their own
-implementations, to get called or intercept signature requests by these methods.
+const request = requests[0]
+console.log('Message ID:', request.message.messageId)
+console.log('Sender:', request.message.sender)
+console.log('Destination chain:', request.lane.destChainSelector)
+```
 
-Optionally, `sendMessage` and `executeReport` also have companion `generateUnsignedSendMessage` and
-`generateUnsignedExecuteReport` methods, returning chain-family-specific unsigned data, which one
-can use to sign and send the transactions manually.
+### Get Fee Estimate
 
-Notice that these are lower-level methods, and require the developer to handle the signing and
-sending of the transactions themselves, skipping niceties from the higher-level methods, like
-retries, gas estimation and transactions batching.
+```ts
+import { EVMChain, networkInfo } from '@chainlink/ccip-sdk'
 
-> [!TIP]
-> For EVMChain on Browsers, one can use `chain.provider.getSigner(numberOrAddress)` to fetch a
-provider-backed signer from compatible wallets, like Metamask.
+const source = await EVMChain.fromUrl('https://ethereum-sepolia-rpc.publicnode.com')
+const router = '0x0BF3dE8c5D3e8A2B34D2BEeB17ABfCeBaf363A59' // Sepolia Router
+const destSelector = networkInfo('ethereum-testnet-sepolia-arbitrum-1').chainSelector
 
-## Tree-shakers
+const fee = await source.getFee(router, destSelector, {
+  receiver: '0xYourReceiverAddress',
+  data: '0x48656c6c6f', // "Hello" in hex
+  extraArgs: { gasLimit: 200_000 }, // Gas limit for receiver's ccipReceive callback
+})
 
-If you're using a tree-shaking bundler, make sure to `import { allSupportedChains } from '@chainlink/ccip-sdk'`,
-or only the chains you want to support, e.g. `import { EVMChain, SolanaChain } from '@chainlink/ccip-sdk'`.
-This should ensure those chain family implementations are registered and used by utility functions.
+console.log('Fee in native token:', fee.toString())
+```
 
-## Recipes
+### Send a Cross-Chain Message
 
-### Fetching details of a CCIP message
 ```ts
-import { AptosChain } from '@chainlink/ccip-sdk'
-const source = await AptosChain.fromUrl('mainnet')
-const requests = await source.fetchRequestsInTx('0xTransactionHash')
-console.log(requests[0])
+import { EVMChain, networkInfo } from '@chainlink/ccip-sdk'
+import { Wallet } from 'ethers'
+
+const source = await EVMChain.fromUrl('https://ethereum-sepolia-rpc.publicnode.com')
+const wallet = new Wallet('YOUR_PRIVATE_KEY', source.provider)
+
+const router = '0x0BF3dE8c5D3e8A2B34D2BEeB17ABfCeBaf363A59'
+const destSelector = networkInfo('ethereum-testnet-sepolia-arbitrum-1').chainSelector
+
+// Get fee first
+const fee = await source.getFee(router, destSelector, {
+  receiver: '0xYourReceiverAddress',
+  data: '0x48656c6c6f',
+  extraArgs: {
+    gasLimit: 200_000,
+    allowOutOfOrderExecution: true, // Don't wait for prior messages from this sender
+  },
+})
+
+// Send the message
+const request = await source.sendMessage(
+  router,
+  destSelector,
+  {
+    receiver: '0xYourReceiverAddress',
+    data: '0x48656c6c6f',
+    extraArgs: { gasLimit: 200_000, allowOutOfOrderExecution: true },
+    fee,
+  },
+  { wallet }
+)
+
+console.log('Transaction hash:', request.tx.hash)
+console.log('Message ID:', request.message.messageId)
 ```
 
-### Sending a message
+## Wallet Configuration
+
+Transaction-sending methods require a chain-specific wallet:
+
+| Chain  | Wallet Type     | Example                                    |
+| ------ | --------------- | ------------------------------------------ |
+| EVM    | `ethers.Signer` | `new Wallet(privateKey, provider)`         |
+| Solana | `anchor.Wallet` | `new Wallet(Keypair.fromSecretKey(...))` |
+| Aptos  | `aptos.Account` | `Account.fromPrivateKey(...)`              |
+
+### Unsigned Transactions
+
+For custom signing workflows (e.g., browser wallets, hardware wallets), use the `generateUnsigned*` methods:
+
 ```ts
-import { type AnyMessage, SolanaChain, networkInfo } from '@chainlink/ccip-sdk'
-const source = await SolanaChain.fromUrl('https://api.mainnet-beta.solana.com')
-const router = 'Ccip842gzYHhvdDkSyi2YVCoAWPbYJoApMFzSxQroE9C' // https://docs.chain.link/ccip/directory/mainnet
-const dest = networkInfo('ethereum-mainnet').chainSelector
-const message: AnyMessage = {
-  receiver: '0xReceiverAddress',
-  data: '0xbeef',
-  extraArgs: { gasLimit: 250000, allowOutOfOrderExecution: true },
-}
-const fee = await source.getFee(router, dest, message)
-const request = await source.sendMessage(
+// Generate unsigned transaction data
+const unsignedTx = await source.generateUnsignedSendMessage(
+  senderAddress, // Your wallet address
   router,
-  dest,
-  { ...message, fee },
-  { wallet: process.env['SOLANA_PRIVATE_KEY'] },
+  destSelector,
+  message
 )
-const messageId = request.message.header.messageId
-const txHash = request.tx.hash
+
+// Sign and send with your own logic
+const signedTx = await customSigner.sign(unsignedTx)
+await customSender.broadcast(signedTx)
 ```
+
+For EVM chains in browsers, get a signer from the connected wallet:
+
+```ts
+const signer = await source.provider.getSigner()
+```
+
+## Supported Chains
+
+| Chain Family | Class         | Library                                                                  | Status         |
+| ------------ | ------------- | ------------------------------------------------------------------------ | -------------- |
+| EVM          | `EVMChain`    | [ethers.js v6](https://docs.ethers.org/v6/)                              | Supported      |
+| Solana       | `SolanaChain` | [solana-web3.js](https://github.com/solana-foundation/solana-web3.js)    | Supported      |
+| Aptos        | `AptosChain`  | [aptos-ts-sdk](https://github.com/aptos-labs/aptos-ts-sdk)               | Supported      |
+| Sui          | `SuiChain`    | [@mysten/sui](https://github.com/MystenLabs/sui)                         | In Development |
+| TON          | `TONChain`    | [@ton/ton](https://github.com/ton-org/ton)                               | In Development |
+
+## Related
+
+- [@chainlink/ccip-cli](https://www.npmjs.com/package/@chainlink/ccip-cli) - Command-line interface
+- [CCIP Official Docs](https://docs.chain.link/ccip) - Protocol documentation
+- [CCIP Directory](https://docs.chain.link/ccip/directory) - Router addresses
+
+## License
+
+MIT

package/dist/aptos/hasher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/aptos/hasher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,qBAAqB,CAAA;AAC5E,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAIlF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACtE,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,EACN,OAAO,GACR,EAAE;IACD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,CAAC,CAAA;CACX,GAAG,UAAU,CAAC,CAAC,CAAC,CAUhB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,EAChE,YAAY,EAAE,MAAM,GACnB,MAAM,CA6CR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,qBAAqB,MAAM,EAC3B,mBAAmB,MAAM,EACzB,QAAQ,MAAM,KACb,MAOF,CAAA"}
+{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/aptos/hasher.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,qBAAqB,CAAA;AAC5E,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAIlF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACtE,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,EACN,OAAO,GACR,EAAE;IACD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,CAAC,CAAA;CACX,GAAG,UAAU,CAAC,CAAC,CAAC,CAUhB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,EAChE,YAAY,EAAE,MAAM,GACnB,MAAM,CA6CR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,qBAAqB,MAAM,EAC3B,mBAAmB,MAAM,EACzB,QAAQ,MAAM,KACb,MAOF,CAAA"}

package/dist/aptos/hasher.js

@@ -1,4 +1,5 @@
 import { concat, id, keccak256, zeroPadValue } from 'ethers';
+import { CCIPAptosHasherVersionUnsupportedError, CCIPExtraArgsInvalidError, } from "../errors/index.js";
 import { decodeExtraArgs } from "../extra-args.js";
 import { LEAF_DOMAIN_SEPARATOR } from "../hasher/common.js";
 import { CCIPVersion } from "../types.js";
@@ -16,7 +17,7 @@ export function getAptosLeafHasher({ sourceChainSelector, destChainSelector, onR
             metadataHash = hashAptosMetadata(sourceChainSelector, destChainSelector, onRamp);
             return ((message) => hashV16AptosMessage(message, metadataHash));
         default:
-            throw new Error(`Unsupported hasher version for Aptos: ${version}`);
+            throw new CCIPAptosHasherVersionUnsupportedError(version);
     }
 }
 /**
@@ -28,20 +29,20 @@ export function getAptosLeafHasher({ sourceChainSelector, destChainSelector, onR
 export function hashV16AptosMessage(message, metadataHash) {
     let gasLimit;
     if (!('gasLimit' in message)) {
-        const parsedArgs = decodeExtraArgs(message.extraArgs, networkInfo(message.header.sourceChainSelector).family);
+        const parsedArgs = decodeExtraArgs(message.extraArgs, networkInfo(message.sourceChainSelector).family);
         if (!parsedArgs || !('gasLimit' in parsedArgs))
-            throw new Error('Invalid extraArgs, not EVMExtraArgsV1|2');
+            throw new CCIPExtraArgsInvalidError('Aptos', message.extraArgs);
         gasLimit = parsedArgs.gasLimit;
     }
     else {
         gasLimit = message.gasLimit;
     }
     const innerHash = concat([
-        message.header.messageId,
+        message.messageId,
         zeroPadValue(message.receiver, 32),
-        encodeNumber(message.header.sequenceNumber),
+        encodeNumber(message.sequenceNumber),
         encodeNumber(gasLimit), // Aptos as dest uses EVMExtraArgs
-        encodeNumber(message.header.nonce),
+        encodeNumber(message.nonce),
     ]);
     const tokenHash = concat([
         encodeNumber(message.tokenAmounts.length),

package/dist/aptos/hasher.js.map

@@ -1 +1 @@
-{"version":3,"file":"hasher.js","sourceRoot":"","sources":["../../src/aptos/hasher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hasher.js","sourceRoot":"","sources":["../../src/aptos/hasher.ts"],"names":[],"mappings":"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"}

package/dist/aptos/index.d.ts

@@ -3,15 +3,16 @@ import { type BytesLike } from 'ethers';
 import type { PickDeep } from 'type-fest';
 import { type LogFilter, type TokenInfo, type TokenPoolRemote, Chain } from '../chain.ts';
 import { type EVMExtraArgsV2, type ExtraArgs, type SVMExtraArgsV1 } from '../extra-args.ts';
+import { type UnsignedAptosTx } from './types.ts';
 import type { LeafHasher } from '../hasher/common.ts';
 import { type AnyMessage, type CCIPMessage, type CCIPRequest, type ChainTransaction, type CommitReport, type ExecutionReceipt, type ExecutionReport, type Lane, type Log_, type NetworkInfo, type OffchainTokenData, type WithLogger, ChainFamily } from '../types.ts';
-import { type UnsignedAptosTx } from './types.ts';
 /**
  * Aptos chain implementation supporting Aptos networks.
  */
 export declare class AptosChain extends Chain<typeof ChainFamily.Aptos> {
     static readonly family: "aptos";
     static readonly decimals = 8;
+    readonly destroy$: Promise<void>;
     provider: Aptos;
     getTokenInfo: (token: string) => Promise<TokenInfo>;
     _getAccountModulesNames: (address: string) => Promise<string[]>;
@@ -57,7 +58,7 @@ export declare class AptosChain extends Chain<typeof ChainFamily.Aptos> {
         page?: number;
     }): Promise<CCIPRequest>;
     /** {@inheritDoc Chain.fetchAllMessagesInBatch} */
-    fetchAllMessagesInBatch<R extends PickDeep<CCIPRequest, 'lane' | `log.${'topics' | 'address' | 'blockNumber'}` | 'message.header.sequenceNumber'>>(request: R, commit: Pick<CommitReport, 'minSeqNr' | 'maxSeqNr'>, opts?: {
+    fetchAllMessagesInBatch<R extends PickDeep<CCIPRequest, 'lane' | `log.${'topics' | 'address' | 'blockNumber'}` | 'message.sequenceNumber'>>(request: R, commit: Pick<CommitReport, 'minSeqNr' | 'maxSeqNr'>, opts?: {
         page?: number;
     }): Promise<R['message'][]>;
     /** {@inheritDoc Chain.typeAndVersion} */
@@ -123,6 +124,10 @@ export declare class AptosChain extends Chain<typeof ChainFamily.Aptos> {
      * @returns Aptos address (0x-prefixed hex, 32 bytes padded).
      */
     static getAddress(bytes: BytesLike): string;
+    /**
+     * Validates a transaction hash format for Aptos
+     */
+    static isTxHash(v: unknown): v is `0x${string}`;
     /**
      * Gets the leaf hasher for Aptos destination chains.
      * @param lane - Lane configuration.

package/dist/aptos/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aptos/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aptos/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,WAAW,EAEX,OAAO,EAGR,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,KAAK,SAAS,EAUf,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,WAAW,CAAA;AAEtD,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAgBzF,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,cAAc,EAGpB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,WAAW,EACZ,MAAM,aAAa,CAAA;AAuBpB;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC;IAI7D,MAAM,CAAC,QAAQ,CAAC,MAAM,UAAoB;IAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAI;IAE5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,QAAQ,EAAE,KAAK,CAAA;IAEf,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IACnD,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE/D;;;;OAIG;gBACS,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,UAAU;IAyCnE;;;;;OAKG;WACU,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjF;;;;;OAKG;WACU,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAKxF;;;;;OAKG;WACU,OAAO,CAClB,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,GAAG,CAAC,EAAE,UAAU,GACf,OAAO,CAAC,UAAU,CAAC;IAiBtB,4CAA4C;IACtC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvE,yCAAyC;IACnC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6B/E,kCAAkC;IAC3B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAI1F,4CAA4C;IACtC,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9E,2CAA2C;IAC5B,gBAAgB,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACvB,OAAO,CAAC,WAAW,CAAC;IAQvB,kDAAkD;IAC5C,uBAAuB,CAC3B,CAAC,SAAS,QAAQ,CAChB,WAAW,EACX,MAAM,GAAG,OAAO,QAAQ,GAAG,SAAS,GAAG,aAAa,EAAE,GAAG,wBAAwB,CAClF,EAED,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,CAAC,EACnD,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACvB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;IAI1B,yCAAyC;IACnC,cAAc,CAAC,OAAO,EAAE,MAAM;IAUpC,6CAA6C;IAC7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/E,8CAA8C;IAC9C,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInF,kDAAkD;IAClD,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD,+CAA+C;IAC/C,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIrF,6CAA6C;IAC7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/E,8CAA8C;IACxC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWxF,mDAAmD;IACnD,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,+CAA+C;IACzC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB9D,mDAAmD;IAC7C,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAShE;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE;QACxB,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC1C,GAAG,WAAW,GAAG,SAAS;IAe3B;;;;OAIG;IACH,MAAM,CAAC,eAAe,CACpB,SAAS,EAAE,SAAS,GAElB,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC7C,SAAS;IA8Bb;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAgBpD;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE,GAAG,SAAS;IAyB3F;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,gBAAgB,GAAG,SAAS;IAShF;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAe3C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE;IAI/C;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU;IAInE,iCAAiC;IAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7F,oDAAoD;IAC9C,2BAA2B,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,UAAU,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EACtC,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,eAAe,CAAC;IAgB3B,sCAAsC;IAChC,WAAW,CACf,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,UAAU,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EACtC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9C,OAAO,CAAC,WAAW,CAAC;IA+BvB,iDAAiD;IACjD,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAK1E,gEAAgE;IAC1D,6BAA6B,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,eAAe,CAAC;IAkB3B,wCAAwC;IAClC,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,gBAAgB,CAAC;IA4B5B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO;;;cA3QI,gBAAgB;;cAChB,gBAAgB;;IAiR9C,6CAA6C;IACvC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBtF,iDAAiD;IAC3C,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QACT,aAAa,EAAE,MAAM,CAAA;QACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAC;IAkBF,8CAA8C;IACxC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACpD,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;IAkCF,8CAA8C;IACxC,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IA6F3C,uCAAuC;IACjC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAavE"}

package/dist/aptos/index.js

@@ -1,9 +1,11 @@
 import { Aptos, AptosConfig, Deserializer, Network, SimpleTransaction, TransactionResponseType, } from '@aptos-labs/ts-sdk';
 import { concat, dataLength, dataSlice, decodeBase64, getBytes, hexlify, isBytesLike, isHexString, zeroPadValue, } from 'ethers';
 import { memoize } from 'micro-memoize';
-import { generateUnsignedCcipSend, getFee } from "./send.js";
 import { Chain } from "../chain.js";
+import { generateUnsignedCcipSend, getFee } from "./send.js";
+import { CCIPAptosAddressInvalidError, CCIPAptosExtraArgsEncodingError, CCIPAptosExtraArgsV2RequiredError, CCIPAptosLogInvalidError, CCIPAptosNetworkUnknownError, CCIPAptosRegistryTypeInvalidError, CCIPAptosTokenNotRegisteredError, CCIPAptosTransactionInvalidError, CCIPAptosTransactionTypeInvalidError, CCIPAptosWalletInvalidError, CCIPError, CCIPOnRampRequiredError, } from "../errors/index.js";
 import { EVMExtraArgsV2Tag, SVMExtraArgsV1Tag, } from "../extra-args.js";
+import { EVMExtraArgsV2Codec, SVMExtraArgsV1Codec, isAptosAccount, } from "./types.js";
 import { supportedChains } from "../supported-chains.js";
 import { ChainFamily, } from "../types.js";
 import { convertKeysToCamelCase, decodeAddress, decodeOnRampAddress, getAddressBytes, getDataBytes, networkInfo, parseTypeAndVersion, util, } from "../utils.js";
@@ -11,7 +13,6 @@ import { generateUnsignedExecuteReport } from "./exec.js";
 import { getAptosLeafHasher } from "./hasher.js";
 import { getUserTxByVersion, getVersionTimestamp, streamAptosLogs } from "./logs.js";
 import { getTokenInfo } from "./token.js";
-import { EVMExtraArgsV2Codec, SVMExtraArgsV1Codec, isAptosAccount, } from "./types.js";
 import { decodeMessage, fetchAllMessagesInBatch, fetchCCIPRequestById, fetchCCIPRequestsInTx, } from "../requests.js";
 /**
  * Aptos chain implementation supporting Aptos networks.
@@ -22,6 +23,7 @@ export class AptosChain extends Chain {
     }
     static family = ChainFamily.Aptos;
     static decimals = 8;
+    destroy$;
     provider;
     getTokenInfo;
     _getAccountModulesNames;
@@ -32,6 +34,7 @@ export class AptosChain extends Chain {
      */
     constructor(provider, network, ctx) {
         super(network, ctx);
+        this.destroy$ = new Promise((resolve) => (this.destroy = resolve));
         this.provider = provider;
         this.typeAndVersion = memoize(this.typeAndVersion.bind(this), {
             maxSize: 100,
@@ -99,7 +102,7 @@ export class AptosChain extends Chain {
         else if (url.includes('local'))
             network = Network.LOCAL;
         else
-            throw new Error(`Unknown Aptos network: ${util.inspect(url)}`);
+            throw new CCIPAptosNetworkUnknownError(util.inspect(url));
         const config = new AptosConfig({
             network,
             fullnode: typeof url === 'string' && url.includes('://') ? url : undefined,
@@ -123,10 +126,10 @@ export class AptosChain extends Chain {
             tx = await getUserTxByVersion(this.provider, +hashOrVersion);
         }
         else {
-            throw new Error(`Invalid transaction hash or version: ${hashOrVersion}`);
+            throw new CCIPAptosTransactionInvalidError(hashOrVersion);
         }
         if (tx.type !== TransactionResponseType.User)
-            throw new Error('Invalid transaction type');
+            throw new CCIPAptosTransactionTypeInvalidError();
         return {
             hash: tx.hash,
             blockNumber: +tx.version,
@@ -144,7 +147,7 @@ export class AptosChain extends Chain {
     }
     /** {@inheritDoc Chain.getLogs} */
     async *getLogs(opts) {
-        yield* streamAptosLogs(this.provider, opts);
+        yield* streamAptosLogs(this, opts);
     }
     /** {@inheritDoc Chain.fetchRequestsInTx} */
     async fetchRequestsInTx(tx) {
@@ -153,7 +156,7 @@ export class AptosChain extends Chain {
     /** {@inheritDoc Chain.fetchRequestById} */
     async fetchRequestById(messageId, onRamp, opts) {
         if (!onRamp)
-            throw new Error('onRamp is required');
+            throw new CCIPOnRampRequiredError();
         return fetchCCIPRequestById(this, messageId, {
             address: await this.getOnRampForRouter(onRamp, 0n),
             ...opts,
@@ -227,14 +230,14 @@ export class AptosChain extends Chain {
                 firstErr ??= err;
             }
         }
-        throw firstErr ?? new Error(`Could not view 'get_token' in ${tokenPool}`);
+        throw CCIPError.from(firstErr ?? `Could not view 'get_token' in ${tokenPool}`, 'UNKNOWN');
     }
     /** {@inheritDoc Chain.getTokenAdminRegistryFor} */
     async getTokenAdminRegistryFor(address) {
         const registry = address.split('::')[0] + '::token_admin_registry';
         const [type] = await this.typeAndVersion(registry);
         if (type !== 'TokenAdminRegistry') {
-            throw new Error(`Expected ${registry} to have TokenAdminRegistry type, got=${type}`);
+            throw new CCIPAptosRegistryTypeInvalidError(registry, type);
         }
         return registry;
     }
@@ -247,7 +250,7 @@ export class AptosChain extends Chain {
         const { data } = log;
         if ((typeof data !== 'string' || !data.startsWith('{')) &&
             (typeof data !== 'object' || data == null || isBytesLike(data)))
-            throw new Error(`invalid log data: ${util.inspect(log)}`);
+            throw new CCIPAptosLogInvalidError(util.inspect(log));
         // offload massaging to generic decodeJsonMessage
         try {
             return decodeMessage(data);
@@ -305,7 +308,7 @@ export class AptosChain extends Chain {
                     accounts: extraArgs.accounts.map(getAddressBytes),
                 }).toBytes(),
             ]);
-        throw new Error('Aptos can only encode EVMExtraArgsV2 & SVMExtraArgsV1');
+        throw new CCIPAptosExtraArgsEncodingError();
     }
     /**
      * Decodes commit reports from an Aptos log event.
@@ -315,7 +318,7 @@ export class AptosChain extends Chain {
      */
     static decodeCommits({ data }, lane) {
         if (!data || typeof data != 'object')
-            throw new Error('invalid aptos log');
+            throw new CCIPAptosLogInvalidError(data);
         const data_ = data;
         if (!data_.blessed_merkle_roots)
             return;
@@ -335,7 +338,7 @@ export class AptosChain extends Chain {
      */
     static decodeReceipt({ data }) {
         if (!data || typeof data != 'object')
-            throw new Error('invalid aptos log');
+            throw new CCIPAptosLogInvalidError(data);
         const data_ = data;
         if (!data_.message_id || !data_.state)
             return;
@@ -359,9 +362,15 @@ export class AptosChain extends Chain {
             }
         }
         if (dataLength(bytes) > 32)
-            throw new Error(`Invalid aptos address: "${hexlify(bytes)}"`);
+            throw new CCIPAptosAddressInvalidError(hexlify(bytes));
         return zeroPadValue(bytes, 32) + suffix;
     }
+    /**
+     * Validates a transaction hash format for Aptos
+     */
+    static isTxHash(v) {
+        return typeof v === 'string' && /^0x[0-9a-fA-F]{64}$/.test(v);
+    }
     /**
      * Gets the leaf hasher for Aptos destination chains.
      * @param lane - Lane configuration.
@@ -388,7 +397,7 @@ export class AptosChain extends Chain {
     async sendMessage(router, destChainSelector, message, opts) {
         const account = opts.wallet;
         if (!isAptosAccount(account)) {
-            throw new Error(`${this.constructor.name}.sendMessage requires an Aptos account wallet, got=${util.inspect(opts.wallet)}`);
+            throw new CCIPAptosWalletInvalidError(this.constructor.name, util.inspect(opts.wallet));
         }
         const unsignedTx = await this.generateUnsignedSendMessage(account.accountAddress.toString(), router, destChainSelector, message, opts);
         const unsigned = SimpleTransaction.deserialize(new Deserializer(unsignedTx.transactions[0]));
@@ -413,7 +422,7 @@ export class AptosChain extends Chain {
     /** generate raw/unsigned `manually_execute` transaction data */
     async generateUnsignedExecuteReport(payer, offRamp, execReport, opts) {
         if (!('allowOutOfOrderExecution' in execReport.message && 'gasLimit' in execReport.message)) {
-            throw new Error('Aptos expects EVMExtraArgsV2 reports');
+            throw new CCIPAptosExtraArgsV2RequiredError();
         }
         const tx = await generateUnsignedExecuteReport(this.provider, payer, offRamp, execReport, opts);
         return {
@@ -425,7 +434,7 @@ export class AptosChain extends Chain {
     async executeReport(offRamp, execReport, opts) {
         const account = opts.wallet;
         if (!isAptosAccount(account)) {
-            throw new Error(`${this.constructor.name}.sendMessage requires an Aptos account wallet, got=${util.inspect(opts.wallet)}`);
+            throw new CCIPAptosWalletInvalidError(this.constructor.name, util.inspect(opts.wallet));
         }
         const unsignedTx = await this.generateUnsignedExecuteReport(account.accountAddress.toString(), offRamp, execReport, opts);
         const unsigned = SimpleTransaction.deserialize(new Deserializer(unsignedTx.transactions[0]));
@@ -478,7 +487,7 @@ export class AptosChain extends Chain {
             },
         });
         if (administrator.match(/^0x0*$/))
-            throw new Error(`Token=${token} not registered in registry=${registry}`);
+            throw new CCIPAptosTokenNotRegisteredError(token, registry);
         return {
             administrator,
             ...(!pendingAdministrator.match(/^0x0*$/) && { pendingAdministrator }),
@@ -518,7 +527,7 @@ export class AptosChain extends Chain {
                 firstErr ??= err;
             }
         }
-        throw firstErr ?? new Error(`Could not get tokenPool configs from ${tokenPool}`);
+        throw CCIPError.from(firstErr ?? `Could not get tokenPool configs from ${tokenPool}`, 'UNKNOWN');
     }
     /** {@inheritDoc Chain.getTokenPoolRemotes} */
     async getTokenPoolRemotes(tokenPool, remoteChainSelector) {
@@ -596,7 +605,7 @@ export class AptosChain extends Chain {
                 firstErr ??= err;
             }
         }
-        throw firstErr ?? new Error(`Could not view 'get_remote_token' in ${tokenPool}`);
+        throw CCIPError.from(firstErr ?? `Could not view 'get_remote_token' in ${tokenPool}`, 'UNKNOWN');
     }
     /** {@inheritDoc Chain.getFeeTokens} */
     async getFeeTokens(router) {