@chainlink/ccip-cli 0.0.0 → 0.90.2

package/dist/commands/send.js

@@ -0,0 +1,258 @@
+import { ChainFamily, bigIntReplacer, estimateExecGasForRequest, fetchCCIPRequestsInTx, getDataBytes, networkInfo, sourceToDestTokenAmounts, } from '@chainlink/ccip-sdk';
+import { dataLength, formatUnits, toUtf8Bytes } from 'ethers';
+import { Format } from "./types.js";
+import { logParsedError, parseTokenAmounts, prettyRequest, withDateTimestamp } from "./utils.js";
+import { fetchChainsFromRpcs } from "../providers/index.js";
+export const command = 'send <source> <router> <dest>';
+export const describe = 'Send a CCIP message from router on source to dest';
+export const builder = (yargs) => yargs
+    .positional('source', {
+    type: 'string',
+    demandOption: true,
+    describe: 'source network, chainId or name',
+    example: 'ethereum-testnet-sepolia',
+})
+    .positional('router', {
+    type: 'string',
+    demandOption: true,
+    describe: 'router contract address on source',
+})
+    .positional('dest', {
+    type: 'string',
+    demandOption: true,
+    describe: 'destination network, chainId or name',
+    example: 'ethereum-testnet-sepolia-arbitrum-1',
+})
+    .options({
+    receiver: {
+        alias: 'R',
+        type: 'string',
+        describe: 'Receiver of the message; defaults to the sender wallet address if same network family',
+    },
+    data: {
+        alias: 'd',
+        type: 'string',
+        describe: 'Data to send in the message (non-hex will be utf-8 encoded)',
+        example: '0x1234',
+    },
+    'gas-limit': {
+        alias: ['L', 'compute-units'],
+        type: 'number',
+        describe: 'Gas limit for receiver callback execution; defaults to default configured on ramps',
+        default: 0,
+    },
+    'estimate-gas-limit': {
+        type: 'number',
+        describe: 'Estimate gas limit for receiver callback execution; argument is a % margin to add to the estimate',
+        example: '10',
+        conflicts: 'gas-limit',
+    },
+    'allow-out-of-order-exec': {
+        alias: 'ooo',
+        type: 'boolean',
+        describe: 'Allow execution of messages out of order (i.e. sender nonce not enforced, only v1.5+ lanes, mandatory for some dests)',
+    },
+    'fee-token': {
+        type: 'string',
+        describe: 'Address or symbol of the fee token (e.g. LINK address on source); if not provided, will pay in native',
+    },
+    'transfer-tokens': {
+        alias: 't',
+        type: 'array',
+        string: true,
+        describe: 'List of token amounts (on source) to transfer to the receiver',
+        example: '0xtoken=0.1',
+    },
+    wallet: {
+        alias: 'w',
+        type: 'string',
+        describe: 'Wallet to send transactions with; pass `ledger[:index_or_derivation]` to use Ledger USB hardware wallet, or private key in `USER_KEY` environment variable',
+    },
+    'token-receiver': {
+        type: 'string',
+        describe: "Address of the Solana tokenReceiver (if different than program's receiver)",
+    },
+    account: {
+        type: 'array',
+        string: true,
+        describe: 'List of accounts needed by Solana receiver program; append `=rw` to specify account as writable; can be specified multiple times',
+        example: 'requiredPdaAddress=rw',
+    },
+    'only-get-fee': {
+        type: 'boolean',
+        describe: 'Fetch and print the fee for the transaction, then exit',
+    },
+    'only-estimate': {
+        type: 'boolean',
+        describe: 'Only estimate dest exec gasLimit',
+    },
+    'approve-max': {
+        type: 'boolean',
+        describe: "Approve the maximum amount of tokens to transfer; default=false approves only what's needed",
+    },
+})
+    .check(({ 'transfer-tokens': transferTokens }) => !transferTokens || transferTokens.every((t) => /^[^=]+=\d+(\.\d+)?$/.test(t)));
+export async function handler(argv) {
+    let destroy;
+    const destroy$ = new Promise((resolve) => {
+        destroy = resolve;
+    });
+    return sendMessage(argv, destroy$)
+        .catch((err) => {
+        process.exitCode = 1;
+        if (!logParsedError(err))
+            console.error(err);
+    })
+        .finally(destroy);
+}
+async function sendMessage(argv, destroy) {
+    const sourceNetwork = networkInfo(argv.source);
+    const destNetwork = networkInfo(argv.dest);
+    const getChain = fetchChainsFromRpcs(argv, undefined, destroy);
+    const source = await getChain(sourceNetwork.name);
+    let data;
+    if (argv.data) {
+        try {
+            data = getDataBytes(argv.data);
+        }
+        catch (_) {
+            data = toUtf8Bytes(argv.data);
+        }
+    }
+    else {
+        data = '0x';
+    }
+    const tokenAmounts = argv.transferTokens?.length
+        ? await parseTokenAmounts(source, argv.transferTokens)
+        : [];
+    let receiver = argv.receiver;
+    let tokenReceiver;
+    let accounts, accountIsWritableBitmap = 0n;
+    if (destNetwork.family === ChainFamily.Solana) {
+        if (argv.tokenReceiver)
+            tokenReceiver = argv.tokenReceiver;
+        else if (!tokenAmounts.length) {
+            tokenReceiver = '11111111111111111111111111111111';
+        }
+        else if (!dataLength(data)) {
+            // sending tokens without data, i.e. not for a receiver contract
+            tokenReceiver = receiver;
+            receiver = '11111111111111111111111111111111';
+        }
+        else {
+            throw new Error('--token-receiver is required when sending tokens with data');
+        }
+        if (argv.account) {
+            accounts = argv.account.map((account, i) => {
+                if (account.endsWith('=rw')) {
+                    accountIsWritableBitmap |= 1n << BigInt(i);
+                    account = account.substring(0, account.length - 3);
+                }
+                return account;
+            });
+        }
+        else
+            accounts = [];
+    }
+    else if (argv.tokenReceiver || argv.account?.length) {
+        throw new Error('--token-receiver and --account intended only for Solana dest');
+    }
+    if (!receiver) {
+        if (sourceNetwork.family !== destNetwork.family)
+            throw new Error('--receiver is required when sending to a different chain family');
+        receiver = await source.getWalletAddress(argv); // send to self if same family
+    }
+    if (argv.estimateGasLimit != null || argv.onlyEstimate) {
+        // TODO: implement for all chain families
+        if (destNetwork.family !== ChainFamily.EVM)
+            throw new Error(`Estimating gasLimit supported only on EVM, got=${destNetwork.family}`);
+        const dest = (await getChain(destNetwork.chainSelector));
+        const onRamp = await source.getOnRampForRouter(argv.router, destNetwork.chainSelector);
+        const lane = {
+            sourceChainSelector: source.network.chainSelector,
+            destChainSelector: destNetwork.chainSelector,
+            onRamp,
+            version: (await source.typeAndVersion(onRamp))[1],
+        };
+        const destTokenAmounts = await sourceToDestTokenAmounts(source, destNetwork.chainSelector, onRamp, tokenAmounts);
+        const estimated = await estimateExecGasForRequest(source, dest, {
+            lane,
+            message: {
+                sender: await source.getWalletAddress(argv),
+                receiver,
+                data,
+                tokenAmounts: destTokenAmounts,
+            },
+        });
+        console.log('Estimated gasLimit:', estimated);
+        argv.gasLimit = Math.ceil(estimated * (1 + (argv.estimateGasLimit ?? 0) / 100));
+        if (argv.onlyEstimate)
+            return;
+    }
+    // `--allow-out-of-order-exec` forces EVMExtraArgsV2, which shouldn't work on v1.2 lanes;
+    // otherwise, fallsback to EVMExtraArgsV1 (compatible with v1.2 & v1.5)
+    const extraArgs = {
+        ...(argv.allowOutOfOrderExec != null || destNetwork.family !== ChainFamily.EVM
+            ? { allowOutOfOrderExecution: !!argv.allowOutOfOrderExec }
+            : {}),
+        ...(destNetwork.family === ChainFamily.Solana
+            ? { computeUnits: BigInt(argv.gasLimit) }
+            : { gasLimit: BigInt(argv.gasLimit) }),
+        ...(tokenReceiver ? { tokenReceiver } : {}),
+        ...(accounts ? { accounts, accountIsWritableBitmap } : {}),
+    };
+    let feeToken, feeTokenInfo;
+    if (argv.feeToken) {
+        try {
+            feeToken = source.constructor.getAddress(argv.feeToken);
+            feeTokenInfo = await source.getTokenInfo(feeToken);
+        }
+        catch (_) {
+            const feeTokens = await source.listFeeTokens(argv.router);
+            console.debug('supported feeTokens:', feeTokens);
+            for (const [token, info] of Object.entries(feeTokens)) {
+                if (info.symbol === 'UNKNOWN' || info.symbol !== argv.feeToken)
+                    continue;
+                feeToken = token;
+                feeTokenInfo = info;
+                break;
+            }
+            if (!feeTokenInfo)
+                throw new Error(`Fee token "${argv.feeToken}" not found`);
+        }
+    }
+    else {
+        const nativeToken = await source.getNativeTokenForRouter(argv.router);
+        feeTokenInfo = await source.getTokenInfo(nativeToken);
+    }
+    const message = {
+        receiver,
+        data,
+        extraArgs: extraArgs,
+        feeToken, // feeToken==ZeroAddress means native
+        tokenAmounts,
+    };
+    // calculate fee
+    const fee = await source.getFee(argv.router, destNetwork.chainSelector, message);
+    console.info('Fee:', fee, '=', formatUnits(fee, feeTokenInfo.decimals), !argv.feeToken && feeTokenInfo.symbol.startsWith('W')
+        ? feeTokenInfo.symbol.substring(1)
+        : feeTokenInfo.symbol);
+    if (argv.onlyGetFee)
+        return;
+    const tx = await source.sendMessage(argv.router, destNetwork.chainSelector, { ...message, fee }, argv);
+    console.log('🚀 Sending message to', tokenReceiver || receiver, '@', destNetwork.name, ', tx =>', tx.hash);
+    // print CCIPRequest from tx receipt
+    const request = (await fetchCCIPRequestsInTx(tx))[0];
+    switch (argv.format) {
+        case Format.log:
+            console.log(`message ${request.log.index} =`, withDateTimestamp(request));
+            break;
+        case Format.pretty:
+            await prettyRequest(source, request);
+            break;
+        case Format.json:
+            console.info(JSON.stringify(request, bigIntReplacer, 2));
+            break;
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/commands/send.js.map

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

package/dist/commands/show.d.ts

@@ -0,0 +1,18 @@
+import type { Argv } from 'yargs';
+import type { GlobalOpts } from '../index.ts';
+export declare const command: string[];
+export declare const describe = "Show details of a CCIP request";
+export declare const builder: (yargs: Argv) => Argv<import("yargs").Omit<{
+    "tx-hash": string;
+}, "log-index" | "id-from-source"> & import("yargs").InferredOptionTypes<{
+    'log-index': {
+        type: "number";
+        describe: string;
+    };
+    'id-from-source': {
+        type: "string";
+        describe: string;
+    };
+}>>;
+export declare function handler(argv: Awaited<ReturnType<typeof builder>['argv']> & GlobalOpts): Promise<void>;
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAY7C,eAAO,MAAM,OAAO,UAAoC,CAAA;AACxD,eAAO,MAAM,QAAQ,mCAAmC,CAAA;AAExD,eAAO,MAAM,OAAO,GAAI,OAAO,IAAI;;;;;;;;;;;GAiB7B,CAAA;AAEN,wBAAsB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,iBAW3F"}

package/dist/commands/show.js

@@ -0,0 +1,112 @@
+import util from 'util';
+import { ChainFamily, bigIntReplacer, discoverOffRamp, fetchCCIPMessageById, fetchCCIPRequestsInTx, networkInfo, } from '@chainlink/ccip-sdk';
+import { Format } from "./types.js";
+import { logParsedError, prettyCommit, prettyReceipt, prettyRequest, selectRequest, withDateTimestamp, } from "./utils.js";
+import { fetchChainsFromRpcs } from "../providers/index.js";
+export const command = ['show <tx-hash>', '* <tx-hash>'];
+export const describe = 'Show details of a CCIP request';
+export const builder = (yargs) => yargs
+    .positional('tx-hash', {
+    type: 'string',
+    demandOption: true,
+    describe: 'transaction hash of the request (source) message',
+})
+    .options({
+    'log-index': {
+        type: 'number',
+        describe: 'Pre-select a message request by logIndex, if more than one in tx; by default, a selection menu is shown',
+    },
+    'id-from-source': {
+        type: 'string',
+        describe: 'Search by messageId instead of txHash; requires specifying source network',
+    },
+});
+export async function handler(argv) {
+    let destroy;
+    const destroy$ = new Promise((resolve) => {
+        destroy = resolve;
+    });
+    return showRequests(argv, destroy$)
+        .catch((err) => {
+        process.exitCode = 1;
+        if (!logParsedError(err))
+            console.error(err);
+    })
+        .finally(destroy);
+}
+async function showRequests(argv, destroy) {
+    let source, getChain, tx, request;
+    // messageId not yet implemented for Solana
+    if (argv.idFromSource) {
+        getChain = fetchChainsFromRpcs(argv, undefined, destroy);
+        const sourceNetwork = networkInfo(argv.idFromSource);
+        if (sourceNetwork.family === ChainFamily.Solana) {
+            throw new Error(`Message ID search is not yet supported for Solana networks.\n` +
+                `Please use show with Solana transaction signature instead`);
+        }
+        source = await getChain(sourceNetwork.chainId);
+        request = await fetchCCIPMessageById(source, argv.txHash, argv);
+    }
+    else {
+        const [getChain_, tx$] = fetchChainsFromRpcs(argv, argv.txHash, destroy);
+        getChain = getChain_;
+        tx = await tx$;
+        source = tx.chain;
+        request = await selectRequest(await fetchCCIPRequestsInTx(tx), 'to know more', argv);
+    }
+    const offchainTokenData = await source.fetchOffchainTokenData(request);
+    switch (argv.format) {
+        case Format.log: {
+            console.log(`message ${request.log.index} =`, withDateTimestamp(request), '\nattestations =', offchainTokenData);
+            break;
+        }
+        case Format.pretty:
+            await prettyRequest(source, request, offchainTokenData);
+            break;
+        case Format.json:
+            console.info(JSON.stringify({ ...request, offchainTokenData }, bigIntReplacer, 2));
+            break;
+    }
+    if (request.tx.error)
+        throw new Error(`Request tx reverted: ${util.inspect(request.tx.error)}`);
+    const dest = await getChain(request.lane.destChainSelector);
+    const offRamp = await discoverOffRamp(source, dest, request.lane.onRamp);
+    const commitStore = await dest.getCommitStoreForOffRamp(offRamp);
+    const commit = await dest.fetchCommitReport(commitStore, request, argv);
+    switch (argv.format) {
+        case Format.log:
+            console.log('commit =', commit);
+            break;
+        case Format.pretty:
+            await prettyCommit(dest, commit, request);
+            break;
+        case Format.json:
+            console.info(JSON.stringify(commit, bigIntReplacer, 2));
+            break;
+    }
+    let found = false;
+    for await (const receipt of dest.fetchExecutionReceipts(offRamp, new Set([request.message.header.messageId]), {
+        startBlock: commit.log.blockNumber,
+        page: argv.page,
+        commit: commit.report,
+    })) {
+        switch (argv.format) {
+            case Format.log:
+                console.log('receipt =', withDateTimestamp(receipt));
+                break;
+            case Format.pretty:
+                if (!found)
+                    console.info('Receipts (dest):');
+                prettyReceipt(receipt, request, receipt.log.tx?.from ??
+                    (await dest.getTransaction(receipt.log.transactionHash).catch(() => null))?.from);
+                break;
+            case Format.json:
+                console.info(JSON.stringify(receipt, bigIntReplacer, 2));
+                break;
+        }
+        found = true;
+    }
+    if (!found)
+        console.warn(`No execution receipt found for request`);
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

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

package/dist/commands/supported-tokens.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CCIP Token Discovery Service
+ *
+ * Discovers and validates tokens that can be transferred between chains using Chainlink's CCIP.
+ * The service handles pagination, parallel processing, and comprehensive error collection.
+ *
+ * Architecture:
+ * 1. Chain & Contract Setup: Validates cross-chain paths and initializes core contracts
+ * 2. Token Discovery: Fetches all registered tokens with pagination
+ * 3. Support Validation: Checks token support for destination chain
+ * 4. Detail Collection: Gathers token and pool information in parallel
+ *
+ * Performance Considerations:
+ * - Uses batching to prevent RPC timeouts (configurable batch sizes)
+ * - Implements parallel processing with rate limiting
+ * - Memory-efficient token processing through pagination
+ *
+ * Error Handling:
+ * - Individual token failures don't halt the process
+ * - Errors are collected and reported comprehensively
+ * - Detailed error reporting for debugging
+ *
+ * @module supported-tokens
+ */
+import type { Argv } from 'yargs';
+import type { GlobalOpts } from '../index.ts';
+export declare const command: string[];
+export declare const describe = "List supported tokens in a given Router/OnRamp/TokenAdminRegistry, and/or show info about token/pool";
+export declare const builder: (yargs: Argv) => Argv<{
+    source: string;
+} & {
+    address: string;
+} & {
+    token: string | undefined;
+}>;
+export declare function handler(argv: Awaited<ReturnType<typeof builder>['argv']> & GlobalOpts): Promise<void>;
+//# sourceMappingURL=supported-tokens.d.ts.map

package/dist/commands/supported-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supported-tokens.d.ts","sourceRoot":"","sources":["../../src/commands/supported-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAUH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAIjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,eAAO,MAAM,OAAO,UAAoD,CAAA;AACxE,eAAO,MAAM,QAAQ,yGACmF,CAAA;AAExG,eAAO,MAAM,OAAO,GAAI,OAAO,IAAI;;;;;;EAkB7B,CAAA;AAEN,wBAAsB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,iBAW3F"}