@pushchain/core 5.1.7 → 5.1.9

package/src/lib/orchestrator/internals/route-handlers.js

@@ -62,7 +62,7 @@ function resolveR2Prc20TokenEvm(params, targetChain, pushNetwork) {
         // User explicitly specified funds with token
         const token = params.funds.token;
         if (token) {
-            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
             burnAmount = params.funds.amount;
         }
     }
@@ -90,7 +90,7 @@ function resolveR2Prc20TokenSvm(params, targetChain, pushNetwork, hasSvmExecute)
     if ((_a = params.funds) === null || _a === void 0 ? void 0 : _a.amount) {
         const token = params.funds.token;
         if (token) {
-            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
             burnAmount = params.funds.amount;
         }
     }
@@ -101,7 +101,7 @@ function resolveR2Prc20TokenSvm(params, targetChain, pushNetwork, hasSvmExecute)
     else if (hasSvmExecute) {
         const token = params.funds && params.funds.token;
         if (token) {
-            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
         }
         else {
             prc20Token = (0, helpers_1.getNativePRC20ForChain)(targetChain, pushNetwork);
@@ -1269,7 +1269,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                     if ((_a = params.funds) === null || _a === void 0 ? void 0 : _a.amount) {
                         const token = params.funds.token;
                         if (token) {
-                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
                             burnAmount = params.funds.amount;
                         }
                     }
@@ -1321,7 +1321,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                 if ((_d = params.funds) === null || _d === void 0 ? void 0 : _d.amount) {
                     const token = params.funds.token;
                     if (token) {
-                        prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+                        prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
                         burnAmount = params.funds.amount;
                     }
                 }

package/src/lib/orchestrator/orchestrator.types.d.ts

@@ -705,13 +705,6 @@ export interface OutboundTxDetails {
     /** Asset address on external chain (address(0) for native) */
     assetAddr: string;
 }
-/**
- * Progress event for outbound sync operations
- */
-export interface OutboundSyncProgress {
-    status: 'waiting' | 'polling' | 'success' | 'failed' | 'timeout';
-    elapsed: number;
-}
 /**
  * Options for waitForOutboundTx polling
  */

package/src/lib/orchestrator/payload-builders.d.ts

@@ -52,39 +52,6 @@ export declare function buildInboundUniversalPayload(multicallData: `0x${string}
     nonce?: bigint;
     deadline?: bigint;
 }): `0x${string}`;
-/**
- * Build a single call as CEA multicall payload
- *
- * @param target - Target contract address
- * @param value - Native value to send
- * @param data - Calldata to execute
- * @returns Encoded payload with selector prefix
- */
-export declare function buildSingleCeaCall(target: `0x${string}`, value: bigint, data: `0x${string}`): `0x${string}`;
-/**
- * Build approve + interact pattern for ERC20 operations on external chains
- *
- * @param tokenAddress - ERC20 token address
- * @param spender - Address to approve (e.g., DEX router)
- * @param amount - Amount to approve
- * @param interactCall - The interaction call (e.g., swap)
- * @returns Array of multicall operations
- */
-export declare function buildApproveAndInteract(tokenAddress: `0x${string}`, spender: `0x${string}`, amount: bigint, interactCall: MultiCall): MultiCall[];
-/**
- * Build sendUniversalTxFromCEA call for CEA → Push routing (Route 3)
- *
- * @param gatewayAddress - UniversalGateway address on external chain
- * @param recipient - Recipient on Push Chain (usually UEA)
- * @param token - Token address (address(0) for native)
- * @param amount - Amount to send
- * @param payload - Payload for Push Chain execution
- * @param revertRecipient - Address to receive funds on revert
- * @param signatureData - Signature data (usually empty for CEA calls)
- * @param nativeValue - Native value to send with the call
- * @returns MultiCall for sendUniversalTxFromCEA
- */
-export declare function buildSendUniversalTxFromCEA(gatewayAddress: `0x${string}`, recipient: `0x${string}`, token: `0x${string}`, amount: bigint, payload: `0x${string}`, revertRecipient: `0x${string}`, signatureData?: `0x${string}`, nativeValue?: bigint): MultiCall;
 /**
  * Build sendUniversalTxToUEA call for CEA self-call (Route 3)
  *
@@ -115,14 +82,6 @@ export declare function buildSendUniversalTxToUEA(ceaAddress: `0x${string}`, tok
  * @returns UniversalOutboundTxRequest object
  */
 export declare function buildOutboundRequest(target: `0x${string}`, prc20Token: `0x${string}`, amount: bigint, gasLimit: bigint, payload: `0x${string}`, revertRecipient: `0x${string}`): UniversalOutboundTxRequest;
-/**
- * Build native transfer multicall
- *
- * @param to - Recipient address
- * @param value - Native value to transfer
- * @returns MultiCall for native transfer
- */
-export declare function buildNativeTransfer(to: `0x${string}`, value: bigint): MultiCall;
 /**
  * Build ERC20 transfer multicall
  *
@@ -150,10 +109,6 @@ export declare function buildErc20WithdrawalMulticall(tokenAddress: `0x${string}
  * @returns 4-byte hex string `0xcac656d6`
  */
 export declare function buildMigrationPayload(): `0x${string}`;
-/**
- * Check if an address is the zero address
- */
-export declare function isZeroAddress(address: `0x${string}`): boolean;
 /**
  * Build approval multicalls + sendUniversalTxOutbound call for Push Chain.
  *

package/src/lib/orchestrator/payload-builders.js

@@ -4,16 +4,11 @@ exports.MULTICALL_TUPLE_TYPE = void 0;
 exports.buildExecuteMulticall = buildExecuteMulticall;
 exports.buildCeaMulticallPayload = buildCeaMulticallPayload;
 exports.buildInboundUniversalPayload = buildInboundUniversalPayload;
-exports.buildSingleCeaCall = buildSingleCeaCall;
-exports.buildApproveAndInteract = buildApproveAndInteract;
-exports.buildSendUniversalTxFromCEA = buildSendUniversalTxFromCEA;
 exports.buildSendUniversalTxToUEA = buildSendUniversalTxToUEA;
 exports.buildOutboundRequest = buildOutboundRequest;
-exports.buildNativeTransfer = buildNativeTransfer;
 exports.buildErc20Transfer = buildErc20Transfer;
 exports.buildErc20WithdrawalMulticall = buildErc20WithdrawalMulticall;
 exports.buildMigrationPayload = buildMigrationPayload;
-exports.isZeroAddress = isZeroAddress;
 exports.buildOutboundApprovalAndCall = buildOutboundApprovalAndCall;
 exports.isSvmChain = isSvmChain;
 exports.isValidSolanaHexAddress = isValidSolanaHexAddress;
@@ -23,7 +18,6 @@ const viem_1 = require("viem");
 const push_chain_1 = require("../push-chain/push-chain");
 const cea_evm_1 = require("../constants/abi/cea.evm");
 const erc20_evm_1 = require("../constants/abi/erc20.evm");
-const universalGatewayV0_evm_1 = require("../constants/abi/universalGatewayV0.evm");
 const universalGatewayPC_evm_1 = require("../constants/abi/universalGatewayPC.evm");
 const selectors_1 = require("../constants/selectors");
 const chain_1 = require("../constants/chain");
@@ -74,7 +68,7 @@ function buildExecuteMulticall({ execute, ueaAddress, logger, }) {
                 functionName: 'transfer',
                 args: [execute.to, (_q = execute.funds) === null || _q === void 0 ? void 0 : _q.amount],
             });
-            const pushChainTo = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            const { address: pushChainTo } = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
             multicallData.push({
                 to: pushChainTo,
                 value: BigInt(0),
@@ -202,90 +196,6 @@ function buildInboundUniversalPayload(multicallData, opts) {
         },
     ]);
 }
-/**
- * Build a single call as CEA multicall payload
- *
- * @param target - Target contract address
- * @param value - Native value to send
- * @param data - Calldata to execute
- * @returns Encoded payload with selector prefix
- */
-function buildSingleCeaCall(target, value, data) {
-    return buildCeaMulticallPayload([{ to: target, value, data }]);
-}
-/**
- * Build approve + interact pattern for ERC20 operations on external chains
- *
- * @param tokenAddress - ERC20 token address
- * @param spender - Address to approve (e.g., DEX router)
- * @param amount - Amount to approve
- * @param interactCall - The interaction call (e.g., swap)
- * @returns Array of multicall operations
- */
-function buildApproveAndInteract(tokenAddress, spender, amount, interactCall) {
-    // Reset allowance to 0 first to handle non-standard ERC-20 tokens (e.g. USDT)
-    // that revert if approve is called with non-zero value when current allowance is non-zero.
-    const approveZeroData = (0, viem_1.encodeFunctionData)({
-        abi: erc20_evm_1.ERC20_EVM,
-        functionName: 'approve',
-        args: [spender, BigInt(0)],
-    });
-    const approveData = (0, viem_1.encodeFunctionData)({
-        abi: erc20_evm_1.ERC20_EVM,
-        functionName: 'approve',
-        args: [spender, amount],
-    });
-    return [
-        {
-            to: tokenAddress,
-            value: BigInt(0),
-            data: approveZeroData,
-        },
-        {
-            to: tokenAddress,
-            value: BigInt(0),
-            data: approveData,
-        },
-        interactCall,
-    ];
-}
-/**
- * Build sendUniversalTxFromCEA call for CEA → Push routing (Route 3)
- *
- * @param gatewayAddress - UniversalGateway address on external chain
- * @param recipient - Recipient on Push Chain (usually UEA)
- * @param token - Token address (address(0) for native)
- * @param amount - Amount to send
- * @param payload - Payload for Push Chain execution
- * @param revertRecipient - Address to receive funds on revert
- * @param signatureData - Signature data (usually empty for CEA calls)
- * @param nativeValue - Native value to send with the call
- * @returns MultiCall for sendUniversalTxFromCEA
- */
-function buildSendUniversalTxFromCEA(gatewayAddress, recipient, token, amount, payload, revertRecipient, signatureData = '0x', nativeValue = BigInt(0)) {
-    const calldata = (0, viem_1.encodeFunctionData)({
-        abi: universalGatewayV0_evm_1.UNIVERSAL_GATEWAY_V0,
-        functionName: 'sendUniversalTxFromCEA',
-        args: [
-            {
-                recipient,
-                token,
-                amount,
-                payload,
-                revertInstruction: {
-                    fundRecipient: revertRecipient,
-                    revertMsg: '0x',
-                },
-                signatureData,
-            },
-        ],
-    });
-    return {
-        to: gatewayAddress,
-        value: nativeValue,
-        data: calldata,
-    };
-}
 /**
  * Build sendUniversalTxToUEA call for CEA self-call (Route 3)
  *
@@ -336,20 +246,6 @@ function buildOutboundRequest(target, prc20Token, amount, gasLimit, payload, rev
         revertRecipient,
     };
 }
-/**
- * Build native transfer multicall
- *
- * @param to - Recipient address
- * @param value - Native value to transfer
- * @returns MultiCall for native transfer
- */
-function buildNativeTransfer(to, value) {
-    return {
-        to,
-        value,
-        data: '0x',
-    };
-}
 /**
  * Build ERC20 transfer multicall
  *
@@ -392,12 +288,6 @@ function buildErc20WithdrawalMulticall(tokenAddress, recipientAddress, amount) {
 function buildMigrationPayload() {
     return selectors_1.MIGRATION_SELECTOR;
 }
-/**
- * Check if an address is the zero address
- */
-function isZeroAddress(address) {
-    return address.toLowerCase() === selectors_1.ZERO_ADDRESS.toLowerCase();
-}
 // ============================================================================
 // Cascade Composition Helpers
 // ============================================================================

package/src/lib/push-client/push-client.js

@@ -17,20 +17,21 @@ const encoding_1 = require("@cosmjs/encoding");
 const evm_client_1 = require("../vm-client/evm-client");
 const chain_1 = require("../constants/chain");
 const enums_1 = require("../constants/enums");
+function pushNetworkToChain(network) {
+    if (network === enums_1.PUSH_NETWORK.MAINNET)
+        return enums_1.CHAIN.PUSH_MAINNET;
+    if (network === enums_1.PUSH_NETWORK.TESTNET_DONUT ||
+        network === enums_1.PUSH_NETWORK.TESTNET)
+        return enums_1.CHAIN.PUSH_TESTNET_DONUT;
+    return enums_1.CHAIN.PUSH_LOCALNET;
+}
 class PushClient extends evm_client_1.EvmClient {
     constructor(clientOptions) {
-        super(clientOptions);
+        var _a;
+        const pushChainKey = pushNetworkToChain(clientOptions.network);
+        super(Object.assign(Object.assign({}, clientOptions), { chain: (_a = clientOptions.chain) !== null && _a !== void 0 ? _a : (0, chain_1.getPushViemChain)(pushChainKey) }));
         this.currentRpcIndex = 0;
-        if (clientOptions.network === enums_1.PUSH_NETWORK.MAINNET) {
-            this.pushChainInfo = chain_1.PUSH_CHAIN_INFO[enums_1.CHAIN.PUSH_MAINNET];
-        }
-        else if (clientOptions.network === enums_1.PUSH_NETWORK.TESTNET_DONUT ||
-            clientOptions.network === enums_1.PUSH_NETWORK.TESTNET) {
-            this.pushChainInfo = chain_1.PUSH_CHAIN_INFO[enums_1.CHAIN.PUSH_TESTNET_DONUT];
-        }
-        else {
-            this.pushChainInfo = chain_1.PUSH_CHAIN_INFO[enums_1.CHAIN.PUSH_LOCALNET];
-        }
+        this.pushChainInfo = chain_1.PUSH_CHAIN_INFO[pushChainKey];
         this.ephemeralKey = (0, accounts_1.generatePrivateKey)();
         this.ephemeralAccount = (0, accounts_1.privateKeyToAccount)(this.ephemeralKey);
     }

package/src/lib/universal/account/account.js

@@ -294,6 +294,7 @@ function convertExecutorToOriginAccount(ueaAddress, options) {
         const FACTORY_ADDRESS = chain_1.PUSH_CHAIN_INFO[pushChainKey].factoryAddress;
         // Create viem public client
         const client = (0, viem_1.createPublicClient)({
+            chain: (0, chain_1.getPushViemChain)(pushChainKey),
             transport: (0, viem_1.http)(RPC_URL),
         });
         const originResult = (yield client.readContract({
@@ -377,6 +378,7 @@ function convertExecutorToOrigin(executorAddress, options) {
         const RPC_URL = chain_1.PUSH_CHAIN_INFO[pushChainKey].defaultRPC[0];
         const FACTORY_ADDRESS = chain_1.PUSH_CHAIN_INFO[pushChainKey].factoryAddress;
         const client = (0, viem_1.createPublicClient)({
+            chain: (0, chain_1.getPushViemChain)(pushChainKey),
             transport: (0, viem_1.http)(RPC_URL),
         });
         const originResult = (yield client.readContract({
@@ -600,7 +602,10 @@ function resolveControllerAccount(address, options) {
             const pushChainId = pushChainKey;
             const RPC_URL = chain_1.PUSH_CHAIN_INFO[pushChainKey].defaultRPC[0];
             const FACTORY_ADDRESS = chain_1.PUSH_CHAIN_INFO[pushChainKey].factoryAddress;
-            const client = (0, viem_1.createPublicClient)({ transport: (0, viem_1.http)(RPC_URL) });
+            const client = (0, viem_1.createPublicClient)({
+                chain: (0, chain_1.getPushViemChain)(pushChainKey),
+                transport: (0, viem_1.http)(RPC_URL),
+            });
             const originResult = (yield client.readContract({
                 address: FACTORY_ADDRESS,
                 abi: factoryV1_1.FACTORY_V1,
@@ -648,7 +653,10 @@ function resolveControllerAccount(address, options) {
         const pushChainId = pushChainKey;
         const RPC_URL = chain_1.PUSH_CHAIN_INFO[pushChainKey].defaultRPC[0];
         const FACTORY_ADDRESS = chain_1.PUSH_CHAIN_INFO[pushChainKey].factoryAddress;
-        const client = (0, viem_1.createPublicClient)({ transport: (0, viem_1.http)(RPC_URL) });
+        const client = (0, viem_1.createPublicClient)({
+            chain: (0, chain_1.getPushViemChain)(pushChainKey),
+            transport: (0, viem_1.http)(RPC_URL),
+        });
         const originResult = (yield client.readContract({
             address: FACTORY_ADDRESS,
             abi: factoryV1_1.FACTORY_V1,

package/src/lib/utils.d.ts

@@ -256,21 +256,19 @@ export declare class Utils {
             }>;
         };
         /**
-         * Convert any supported origin-chain token into its mapped PRC20 token address on Push Chain.
+         * Convert any supported origin-chain token into its mapped PRC20 token on Push Chain.
          *
          * @param token - Either a MoveableToken from `pushChainClient.moveable.token.*`
          * or an object with the origin chain and token address.
-         * @returns {`0x${string}`} The synthetic asset address on Push Chain.
+         * @returns An object describing the synthetic PRC-20 on Push Chain.
          *
          * @example
          * ```jsx
-         * PushChain.utils.tokens.getPRC20Address(
-         *   token: MoveableToken | {
-         *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA;
-         *     address: `0x${string}`;
-         *   }
-         * );
-         * // → `0x...`
+         * const { address, chain, symbol, decimals, network } =
+         *   PushChain.utils.tokens.getPRC20Address({
+         *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA,
+         *     address: '0x...',
+         *   });
          * ```
          */
         getPRC20Address(token: MoveableToken | {
@@ -278,7 +276,13 @@ export declare class Utils {
             address: string;
         }, options?: {
             network?: PUSH_NETWORK;
-        }): `0x${string}`;
+        }): {
+            address: `0x${string}`;
+            chain: CHAIN;
+            symbol: string;
+            decimals: number;
+            network: PUSH_NETWORK;
+        };
     };
     /**
      * Internal: resolves a CHAIN enum from either a CHAIN value or a PushChain client instance.

package/src/lib/utils.js

@@ -601,42 +601,55 @@ Utils.tokens = {
         return { tokens };
     },
     /**
-     * Convert any supported origin-chain token into its mapped PRC20 token address on Push Chain.
+     * Convert any supported origin-chain token into its mapped PRC20 token on Push Chain.
      *
      * @param token - Either a MoveableToken from `pushChainClient.moveable.token.*`
      * or an object with the origin chain and token address.
-     * @returns {`0x${string}`} The synthetic asset address on Push Chain.
+     * @returns An object describing the synthetic PRC-20 on Push Chain.
      *
      * @example
      * ```jsx
-     * PushChain.utils.tokens.getPRC20Address(
-     *   token: MoveableToken | {
-     *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA;
-     *     address: `0x${string}`;
-     *   }
-     * );
-     * // → `0x...`
+     * const { address, chain, symbol, decimals, network } =
+     *   PushChain.utils.tokens.getPRC20Address({
+     *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA,
+     *     address: '0x...',
+     *   });
      * ```
      */
     getPRC20Address(token, options) {
-        var _a, _b;
+        var _a, _b, _c, _d;
+        const network = (_a = options === null || options === void 0 ? void 0 : options.network) !== null && _a !== void 0 ? _a : enums_1.PUSH_NETWORK.TESTNET_DONUT;
+        const assertDeployed = (addr, ctx) => {
+            if (!addr || addr === '0xTBD') {
+                throw new Error(`PRC20 address not available for ${ctx} on network ${network}`);
+            }
+            return addr;
+        };
         // PushChainMoveableToken (pETH, pSOL, pUSDT(BNB), …) carries its PRC-20 address
-        // directly. Return it as-is — no registry lookup needed.
-        const maybePrc20 = token.prc20Address;
-        if (maybePrc20) {
-            return maybePrc20;
+        // and origin `sourceChain` directly — no registry lookup needed.
+        const pcToken = token;
+        if (pcToken.prc20Address) {
+            return {
+                address: assertDeployed(pcToken.prc20Address, `${(_b = pcToken.symbol) !== null && _b !== void 0 ? _b : 'token'} (${(_c = pcToken.sourceChain) !== null && _c !== void 0 ? _c : 'unknown'})`),
+                chain: pcToken.sourceChain,
+                symbol: pcToken.symbol,
+                decimals: pcToken.decimals,
+                network,
+            };
         }
-        // Infer origin chain and symbol by matching against the MOVEABLE_TOKENS registry
+        // Infer origin chain, symbol, decimals by matching against MOVEABLE_TOKENS
         let originChain;
         let tokenSymbol;
+        let tokenDecimals;
         if ('symbol' in token) {
             // MoveableToken path: infer chain by symbol + address
             for (const [key, list] of Object.entries(tokens_1.MOVEABLE_TOKENS)) {
                 const k = key;
-                const found = (list !== null && list !== void 0 ? list : []).some((t) => t.symbol === token.symbol && t.address === token.address);
-                if (found) {
+                const match = (list !== null && list !== void 0 ? list : []).find((t) => t.symbol === token.symbol && t.address === token.address);
+                if (match) {
                     originChain = k;
-                    tokenSymbol = token.symbol;
+                    tokenSymbol = match.symbol;
+                    tokenDecimals = match.decimals;
                     break;
                 }
             }
@@ -644,17 +657,20 @@ Utils.tokens = {
         else {
             // { chain, address } path: trust the provided chain and resolve symbol via registry
             originChain = token.chain;
-            const list = (_a = tokens_1.MOVEABLE_TOKENS[originChain]) !== null && _a !== void 0 ? _a : [];
-            const match = (list !== null && list !== void 0 ? list : []).find((t) => t.address === token.address);
+            const list = (_d = tokens_1.MOVEABLE_TOKENS[originChain]) !== null && _d !== void 0 ? _d : [];
+            const match = list.find((t) => t.address === token.address);
             if (match) {
                 tokenSymbol = match.symbol;
+                tokenDecimals = match.decimals;
             }
         }
-        if (!originChain || !tokenSymbol) {
+        if (!originChain || !tokenSymbol || tokenDecimals === undefined) {
             throw new Error('Unable to infer origin chain or token symbol for token');
         }
-        const network = (_b = options === null || options === void 0 ? void 0 : options.network) !== null && _b !== void 0 ? _b : enums_1.PUSH_NETWORK.TESTNET_DONUT;
         const map = chain_1.SYNTHETIC_PUSH_ERC20[network];
+        if (!map) {
+            throw new Error(`No PRC20 address map configured for network: ${network}`);
+        }
         // Map token → synthetic key by origin chain family
         const isEthFamily = originChain === enums_1.CHAIN.ETHEREUM_MAINNET ||
             originChain === enums_1.CHAIN.ETHEREUM_SEPOLIA;
@@ -716,7 +732,13 @@ Utils.tokens = {
             default:
                 throw new Error(`Unsupported token symbol: ${tokenSymbol}`);
         }
-        return map[key];
+        return {
+            address: assertDeployed(map[key], `${tokenSymbol} on ${originChain}`),
+            chain: originChain,
+            symbol: tokenSymbol,
+            decimals: tokenDecimals,
+            network,
+        };
     },
 };
 //# sourceMappingURL=utils.js.map

package/src/lib/vm-client/evm-client.d.ts

@@ -12,7 +12,7 @@ import { PublicClient, Hex } from 'viem';
  */
 export declare class EvmClient {
     publicClient: PublicClient;
-    constructor({ rpcUrls }: ClientOptions);
+    constructor({ rpcUrls, chain }: ClientOptions);
     /**
      * Returns the balance (in wei) of an EVM address.
      *

package/src/lib/vm-client/evm-client.js

@@ -13,9 +13,10 @@ const viem_1 = require("viem");
  * });
  */
 class EvmClient {
-    constructor({ rpcUrls }) {
+    constructor({ rpcUrls, chain }) {
         const transports = rpcUrls.map((rpcUrl) => (0, viem_1.http)(rpcUrl));
         this.publicClient = (0, viem_1.createPublicClient)({
+            chain,
             transport: (0, viem_1.fallback)(transports),
         });
     }

package/src/lib/vm-client/vm-client.types.d.ts

@@ -1,11 +1,12 @@
 import { UniversalSigner } from '../universal/universal.types';
-import { Abi, Transaction, TransactionReceipt } from 'viem';
+import { Abi, Chain, Transaction, TransactionReceipt } from 'viem';
 import { Keypair, PublicKey } from '@solana/web3.js';
 /**
  * Common options used by all VM clients (EVM, SVM, etc.)
  */
 export interface ClientOptions {
     rpcUrls: string[];
+    chain?: Chain;
 }
 /**
  * Parameters for reading from a smart contract (read-only call).

package/src/lib/universal-tx-detector/__tests__/fixtures/builders.d.ts

@@ -1,32 +0,0 @@
-/**
- * Shared fixture builders for universal-tx-detector specs.
- *
- * These helpers encode viem-compatible logs and receipts so every spec
- * (classify, detector, cascade, scenarios) can build test data uniformly.
- *
- * Keep these pure — no jest mocks, no module-level state.
- */
-import { type TransactionReceipt } from 'viem';
-export type EventDef = {
-    name: string;
-    inputs: readonly {
-        indexed: boolean;
-        type: string;
-        name: string;
-        components?: readonly unknown[];
-    }[];
-};
-export type BuiltLog = {
-    address: `0x${string}`;
-    topics: ReadonlyArray<`0x${string}` | null>;
-    data: `0x${string}`;
-    blockNumber: bigint;
-    transactionHash: `0x${string}`;
-    transactionIndex: number;
-    blockHash: `0x${string}`;
-    logIndex: number;
-    removed: false;
-};
-export declare function indexedArgs(event: EventDef, argsObj: Record<string, unknown>): Record<string, unknown>;
-export declare function buildLog(event: EventDef, argsObj: Record<string, unknown>, address: `0x${string}`, logIndex: number, txHash?: `0x${string}`): BuiltLog;
-export declare function buildReceipt(logs: BuiltLog[], to: `0x${string}`, txHash?: `0x${string}`): TransactionReceipt;

package/src/lib/universal-tx-detector/__tests__/fixtures/builders.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.indexedArgs = indexedArgs;
-exports.buildLog = buildLog;
-exports.buildReceipt = buildReceipt;
-/**
- * Shared fixture builders for universal-tx-detector specs.
- *
- * These helpers encode viem-compatible logs and receipts so every spec
- * (classify, detector, cascade, scenarios) can build test data uniformly.
- *
- * Keep these pure — no jest mocks, no module-level state.
- */
-const viem_1 = require("viem");
-const ZERO_HASH = '0x0000000000000000000000000000000000000000000000000000000000000000';
-function indexedArgs(event, argsObj) {
-    const out = {};
-    for (const i of event.inputs)
-        if (i.indexed)
-            out[i.name] = argsObj[i.name];
-    return out;
-}
-function buildLog(event, argsObj, address, logIndex, txHash = ZERO_HASH) {
-    const topics = (0, viem_1.encodeEventTopics)({
-        abi: [
-            event,
-        ],
-        eventName: event.name,
-        args: indexedArgs(event, argsObj),
-    });
-    const nonIndexed = event.inputs.filter((i) => !i.indexed);
-    const data = nonIndexed.length === 0
-        ? '0x'
-        : (0, viem_1.encodeAbiParameters)(nonIndexed, nonIndexed.map((i) => argsObj[i.name]));
-    return {
-        address,
-        topics,
-        data,
-        blockNumber: BigInt(1),
-        transactionHash: txHash,
-        transactionIndex: 0,
-        blockHash: ZERO_HASH,
-        logIndex,
-        removed: false,
-    };
-}
-function buildReceipt(logs, to, txHash = ZERO_HASH) {
-    return {
-        status: 'success',
-        logs,
-        blockNumber: BigInt(1),
-        blockHash: ZERO_HASH,
-        contractAddress: null,
-        cumulativeGasUsed: BigInt(0),
-        effectiveGasPrice: BigInt(0),
-        from: to,
-        gasUsed: BigInt(0),
-        logsBloom: '0x',
-        to,
-        transactionHash: txHash,
-        transactionIndex: 0,
-        type: 'eip1559',
-    };
-}
-//# sourceMappingURL=builders.js.map