@chainlink/ccip-sdk 0.0.0 → 0.90.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SmartContract Chainlink Limited SEZC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# @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.
+
+> [!IMPORTANT]
+> This tool is provided under an MIT license and is for convenience and illustration purposes only.
+
+## Installation
+
+To install it from latest NpmJS release, do:
+
+```sh
+npm install @smartcontractkit/ccip-sdk
+```
+
+> [!NOTE]
+> NodeJS version v20+ is required, with v23+ recommended.
+
+## Chain
+
+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.
+
+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)
+
+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.
+
+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.
+
+```ts
+import { SolanaChain, supportedChains, ChainFamily } from '@chainlink/ccip-sdk'
+class MySolanaChain extends SolanaChain {
+  // ...custom implementation
+}
+supportedChains[ChainFamily.Solana] = MySolanaChain
+```
+
+## Async constructors
+
+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)`)
+
+## Wallet
+
+Most chain families classes have a *cached* `getWallet` method, which handles creating a signer or
+wallet from raw private keys. They receive a generic `{ wallet?: unknown }` object, which may be
+passed from other methods, or CLI's `argv` options, to aid in wallet creation.
+
+If they can't, users may override the *static* `getWallet` function (with parameters depending on
+chain family implementation), which is called to try to construct a wallet or signer instead.
+This can be used to extend the library to create signers according to each environment, without
+requiring a full class inheritance.
+
+Example:
+```ts
+import { EVMChain } from '@chainlink/ccip-sdk'
+
+EVMChain.getWallet = async function(opts?: { provider?: Provider, wallet?: unknown }): Promise<Signer> {
+  // instantiate Signer
+}
+```
+
+> [!TIP]
+> For EVMChain on Browsers, there's no need to override like the above, since providing a `{ wallet: number | address }` option object will make it create a signer from `provider.getSigner(number)`, which should load the account from the browser's wallet extension.
+
+## Recipes
+
+### Fetching details of a custom message, per transaction
+```ts
+import { AptosChain, fetchCCIPMessagesInTx } from '@chainlink/ccip-sdk'
+const source = await AptosChain.fromUrl('mainnet')
+const tx = await source.getTransaction('0xTransactionHash')
+const messages = await fetchCCIPMessagesInTx(tx)
+console.log(messages[0])
+```
+
+### Sending a message
+```ts
+import { SolanaChain, AnyMessage, fetchCCIPRequestsInTx, 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')
+const message: AnyMessage = {
+  receiver: '0xReceiverAddress',
+  data: '0xbeef',
+  extraArgs: { gasLimit: 250000, allowOutOfOrderExecution: true },
+}
+const fee = await source.getFee(router, dest.chainSelector, message)
+const tx = await source.sendMessage(
+  router,
+  dest.chainSelector,
+  { ...message, fee },
+  { wallet: process.env['SOLANA_PRIVATE_KEY'] },
+)
+const messageId = (await fetchCCIPRequestsInTx(tx))[0].message.header.messageId
+```

package/dist/aptos/exec.d.ts

@@ -0,0 +1,18 @@
+import type { Aptos } from '@aptos-labs/ts-sdk';
+import type { ExecutionReport } from '../types.ts';
+import { type AptosAsyncAccount } from './types.ts';
+import type { CCIPMessage_V1_6_EVM } from '../evm/messages.ts';
+/**
+ * Executes as single message report in offramp
+ *
+ * @param provider - Aptos provider instance
+ * @param account - async Account
+ * @param offRamp - Offramp contract address (with or without `::offramp` suffix)
+ * @param execReport - Aptos uses EVMExtraArgsV2, so same message as EVM v1.6
+ * @param opts - options like gasLimit override
+ * @returns exec txHash
+ */
+export declare function executeReport(provider: Aptos, account: AptosAsyncAccount, offRamp: string, execReport: ExecutionReport<CCIPMessage_V1_6_EVM>, opts?: {
+    gasLimit?: number;
+}): Promise<string>;
+//# sourceMappingURL=exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/aptos/exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,KAAK,iBAAiB,EAA4B,MAAM,YAAY,CAAA;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,KAAK,EACf,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,CAAC,oBAAoB,CAAC,EACjD,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,mBA+C7B"}

package/dist/aptos/exec.js

@@ -0,0 +1,55 @@
+import { serializeExecutionReport } from "./types.js";
+/**
+ * Executes as single message report in offramp
+ *
+ * @param provider - Aptos provider instance
+ * @param account - async Account
+ * @param offRamp - Offramp contract address (with or without `::offramp` suffix)
+ * @param execReport - Aptos uses EVMExtraArgsV2, so same message as EVM v1.6
+ * @param opts - options like gasLimit override
+ * @returns exec txHash
+ */
+export async function executeReport(provider, account, offRamp, execReport, opts) {
+    // Prepare proofs as byte arrays
+    const serialized = serializeExecutionReport(execReport);
+    // Build the transaction to call manually_execute
+    // The function signature should be something like:
+    // public entry fun manually_execute(
+    //     caller: &signer,
+    //     merkle_root: vector<u8>,
+    //     proofs: vector<vector<u8>>,
+    //     proof_flag_bits: u256,
+    //     message_id: vector<u8>,
+    //     source_chain_selector: u64,
+    //     dest_chain_selector: u64,
+    //     sequence_number: u64,
+    //     nonce: u64,
+    //     sender: vector<u8>,
+    //     receiver: vector<u8>,
+    //     data: vector<u8>,
+    //     token_addresses: vector<address>,
+    //     token_amounts: vector<u256>,
+    //     offchain_token_data: vector<vector<u8>>,
+    //     gas_limit: u256
+    // )
+    const transaction = await provider.transaction.build.simple({
+        sender: account.accountAddress,
+        data: {
+            function: `${offRamp.includes('::') ? offRamp : offRamp + '::offramp'}::manually_execute`,
+            functionArguments: [serialized],
+        },
+        options: { maxGasAmount: opts?.gasLimit },
+    });
+    // Sign and submit the transaction
+    const signed = await account.signTransactionWithAuthenticator(transaction);
+    const pendingTxn = await provider.transaction.submit.simple({
+        transaction,
+        senderAuthenticator: signed,
+    });
+    // Wait for the transaction to be confirmed
+    const { hash } = await provider.waitForTransaction({
+        transactionHash: pendingTxn.hash,
+    });
+    return hash;
+}
+//# sourceMappingURL=exec.js.map

package/dist/aptos/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/aptos/exec.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAG7E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAe,EACf,OAA0B,EAC1B,OAAe,EACf,UAAiD,EACjD,IAA4B;IAE5B,gCAAgC;IAChC,MAAM,UAAU,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAA;IAEvD,iDAAiD;IACjD,mDAAmD;IACnD,qCAAqC;IACrC,uBAAuB;IACvB,+BAA+B;IAC/B,kCAAkC;IAClC,6BAA6B;IAC7B,8BAA8B;IAC9B,kCAAkC;IAClC,gCAAgC;IAChC,4BAA4B;IAC5B,kBAAkB;IAClB,0BAA0B;IAC1B,4BAA4B;IAC5B,wBAAwB;IACxB,wCAAwC;IACxC,mCAAmC;IACnC,+CAA+C;IAC/C,sBAAsB;IACtB,IAAI;IACJ,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;QAC1D,MAAM,EAAE,OAAO,CAAC,cAAc;QAC9B,IAAI,EAAE;YACJ,QAAQ,EACN,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,WAAW,oBAAyD;YACtH,iBAAiB,EAAE,CAAC,UAAU,CAAC;SAChC;QACD,OAAO,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1C,CAAC,CAAA;IAEF,kCAAkC;IAClC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAA;IAC1E,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1D,WAAW;QACX,mBAAmB,EAAE,MAAM;KAC5B,CAAC,CAAA;IAEF,2CAA2C;IAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC;QACjD,eAAe,EAAE,UAAU,CAAC,IAAI;KACjC,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/aptos/hasher.d.ts

@@ -0,0 +1,11 @@
+import { type LeafHasher } from '../hasher/common.ts';
+import { type CCIPMessage, type CCIPMessage_V1_6, CCIPVersion } from '../types.ts';
+export declare function getAptosLeafHasher<V extends CCIPVersion = CCIPVersion>({ sourceChainSelector, destChainSelector, onRamp, version, }: {
+    sourceChainSelector: bigint;
+    destChainSelector: bigint;
+    onRamp: string;
+    version: V;
+}): LeafHasher<V>;
+export declare function hashV16AptosMessage(message: CCIPMessage_V1_6 | CCIPMessage<typeof CCIPVersion.V1_6>, metadataHash: string): string;
+export declare const hashAptosMetadata: (sourceChainSelector: bigint, destChainSelector: bigint, onRamp: string) => string;
+//# sourceMappingURL=hasher.d.ts.map

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

@@ -0,0 +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,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,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,EAChE,YAAY,EAAE,MAAM,GACnB,MAAM,CA6CR;AAED,eAAO,MAAM,iBAAiB,GAC5B,qBAAqB,MAAM,EAC3B,mBAAmB,MAAM,EACzB,QAAQ,MAAM,KACb,MAOF,CAAA"}

package/dist/aptos/hasher.js

@@ -0,0 +1,62 @@
+import { concat, id, keccak256, zeroPadValue } from 'ethers';
+import { decodeExtraArgs } from "../extra-args.js";
+import { LEAF_DOMAIN_SEPARATOR } from "../hasher/common.js";
+import { CCIPVersion } from "../types.js";
+import { getAddressBytes, networkInfo } from "../utils.js";
+import { encodeNumber, encodeRawBytes } from "./utils.js";
+export function getAptosLeafHasher({ sourceChainSelector, destChainSelector, onRamp, version, }) {
+    let metadataHash;
+    switch (version) {
+        case CCIPVersion.V1_6:
+            metadataHash = hashAptosMetadata(sourceChainSelector, destChainSelector, onRamp);
+            return ((message) => hashV16AptosMessage(message, metadataHash));
+        default:
+            throw new Error(`Unsupported hasher version for Aptos: ${version}`);
+    }
+}
+export function hashV16AptosMessage(message, metadataHash) {
+    let gasLimit;
+    if (!('gasLimit' in message)) {
+        const parsedArgs = decodeExtraArgs(message.extraArgs, networkInfo(message.header.sourceChainSelector).family);
+        if (!parsedArgs || !('gasLimit' in parsedArgs))
+            throw new Error('Invalid extraArgs, not EVMExtraArgsV1|2');
+        gasLimit = parsedArgs.gasLimit;
+    }
+    else {
+        gasLimit = message.gasLimit;
+    }
+    const innerHash = concat([
+        message.header.messageId,
+        zeroPadValue(message.receiver, 32),
+        encodeNumber(message.header.sequenceNumber),
+        encodeNumber(gasLimit), // Aptos as dest uses EVMExtraArgs
+        encodeNumber(message.header.nonce),
+    ]);
+    const tokenHash = concat([
+        encodeNumber(message.tokenAmounts.length),
+        ...message.tokenAmounts.map((token) => concat([
+            encodeRawBytes(getAddressBytes(token.sourcePoolAddress)),
+            zeroPadValue(token.destTokenAddress, 32),
+            encodeNumber(token.destGasAmount),
+            encodeRawBytes(token.extraData),
+            encodeNumber(token.amount),
+        ])),
+    ]);
+    const outerHash = concat([
+        zeroPadValue(LEAF_DOMAIN_SEPARATOR, 32),
+        metadataHash,
+        keccak256(innerHash),
+        keccak256(getAddressBytes(message.sender)),
+        keccak256(message.data),
+        keccak256(tokenHash),
+    ]);
+    return keccak256(outerHash);
+}
+export const hashAptosMetadata = (sourceChainSelector, destChainSelector, onRamp) => {
+    const versionHash = id('Any2AptosMessageHashV1');
+    const encodedSource = encodeNumber(sourceChainSelector);
+    const encodedDest = encodeNumber(destChainSelector);
+    const onrampHash = keccak256(onRamp);
+    return keccak256(concat([versionHash, encodedSource, encodedDest, onrampHash]));
+};
+//# sourceMappingURL=hasher.js.map

package/dist/aptos/hasher.js.map

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

package/dist/aptos/index.d.ts

@@ -0,0 +1,92 @@
+import { Aptos, AptosConfig, Network } from '@aptos-labs/ts-sdk';
+import { type BytesLike } from 'ethers';
+import { type ChainTransaction, type LogFilter, type TokenInfo, type TokenPoolRemote, Chain, ChainFamily } from '../chain.ts';
+import { type EVMExtraArgsV2, type ExtraArgs, type SVMExtraArgsV1 } from '../extra-args.ts';
+import type { LeafHasher } from '../hasher/common.ts';
+import type { AnyMessage, CCIPMessage, CCIPRequest, CommitReport, ExecutionReceipt, ExecutionReport, Lane, Log_, NetworkInfo, OffchainTokenData } from '../types.ts';
+import { type AptosAsyncAccount } from './types.ts';
+export declare class AptosChain extends Chain<typeof ChainFamily.Aptos> {
+    static readonly family: "aptos";
+    static readonly decimals = 8;
+    readonly network: NetworkInfo<typeof ChainFamily.Aptos>;
+    readonly provider: Aptos;
+    getTokenInfo: (token: string) => Promise<TokenInfo>;
+    _getAccountModulesNames: (address: string) => Promise<string[]>;
+    constructor(provider: Aptos, network: NetworkInfo);
+    static fromProvider(provider: Aptos): Promise<AptosChain>;
+    static fromAptosConfig(config: AptosConfig): Promise<AptosChain>;
+    static fromUrl(url: string | Network, network?: Network): Promise<AptosChain>;
+    destroy(): Promise<void>;
+    getBlockTimestamp(version: number | 'finalized'): Promise<number>;
+    getTransaction(hashOrVersion: string | number): Promise<ChainTransaction>;
+    getLogs(opts: LogFilter & {
+        versionAsHash?: boolean;
+    }): AsyncIterableIterator<Log_>;
+    typeAndVersion(address: string): Promise<[type_: string, version: string, typeAndVersion: string] | [type_: string, version: string, typeAndVersion: string, suffix: string]>;
+    getRouterForOnRamp(onRamp: string, _destChainSelector: bigint): Promise<string>;
+    getRouterForOffRamp(offRamp: string, _sourceChainSelector: bigint): Promise<string>;
+    getNativeTokenForRouter(_router: string): Promise<string>;
+    getOffRampsForRouter(router: string, _sourceChainSelector: bigint): Promise<string[]>;
+    getOnRampForRouter(router: string, _destChainSelector: bigint): Promise<string>;
+    getOnRampForOffRamp(offRamp: string, sourceChainSelector: bigint): Promise<string>;
+    getCommitStoreForOffRamp(offRamp: string): Promise<string>;
+    getTokenForTokenPool(tokenPool: string): Promise<string>;
+    getTokenAdminRegistryFor(address: string): Promise<string>;
+    static getWallet(_opts?: {
+        wallet?: unknown;
+    }): Promise<AptosAsyncAccount>;
+    getWallet(opts?: {
+        wallet?: unknown;
+    }): Promise<AptosAsyncAccount>;
+    getWalletAddress(opts?: {
+        wallet?: unknown;
+    }): Promise<string>;
+    static decodeMessage(log: {
+        data: BytesLike | Record<string, unknown>;
+    }): CCIPMessage | undefined;
+    static decodeExtraArgs(extraArgs: BytesLike): (EVMExtraArgsV2 & {
+        _tag: 'EVMExtraArgsV2';
+    }) | (SVMExtraArgsV1 & {
+        _tag: 'SVMExtraArgsV1';
+    }) | undefined;
+    static encodeExtraArgs(extraArgs: ExtraArgs): string;
+    static decodeCommits({ data }: Pick<Log_, 'data'>, lane?: Lane): CommitReport[] | undefined;
+    static decodeReceipt({ data }: Pick<Log_, 'data'>): ExecutionReceipt | undefined;
+    static getAddress(bytes: BytesLike): string;
+    static getDestLeafHasher(lane: Lane): LeafHasher;
+    getFee(router: string, destChainSelector: bigint, message: AnyMessage): Promise<bigint>;
+    sendMessage(router: string, destChainSelector: bigint, message: AnyMessage & {
+        fee: bigint;
+    }, opts?: {
+        wallet?: unknown;
+        approveMax?: boolean;
+    }): Promise<ChainTransaction>;
+    fetchOffchainTokenData(request: CCIPRequest): Promise<OffchainTokenData[]>;
+    executeReport(offRamp: string, execReport: ExecutionReport, opts?: {
+        wallet?: unknown;
+        gasLimit?: number;
+    }): Promise<ChainTransaction>;
+    static parse(data: unknown): (import("../extra-args.ts").EVMExtraArgsV1 & {
+        allowOutOfOrderExecution: boolean;
+    } & {
+        _tag: "EVMExtraArgsV2";
+    }) | (SVMExtraArgsV1 & {
+        _tag: "SVMExtraArgsV1";
+    }) | undefined;
+    getSupportedTokens(address: string, opts?: {
+        page?: number;
+    }): Promise<string[]>;
+    getRegistryTokenConfig(registry: string, token: string): Promise<{
+        administrator: string;
+        pendingAdministrator?: string;
+        tokenPool?: string;
+    }>;
+    getTokenPoolConfigs(tokenPool: string): Promise<{
+        token: string;
+        router: string;
+        typeAndVersion?: string;
+    }>;
+    getTokenPoolRemotes(tokenPool: string, remoteChainSelector?: bigint): Promise<Record<string, TokenPoolRemote>>;
+    listFeeTokens(router: string): Promise<Record<string, TokenInfo>>;
+}
+//# sourceMappingURL=index.d.ts.map

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

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