@pushchain/core 5.1.7 → 5.1.8

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");
@@ -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/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

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

@@ -1,72 +0,0 @@
-/**
- * Parametric scenario catalogue for universal-tx-detector specs.
- *
- * Each ScenarioFixture declares a deterministic tx (receipt + optional
- * mocked cosmos state) plus the assertions every consumer should check.
- *
- * Adding coverage for a new event shape or cascade topology = append one
- * row here. The driver spec (__tests__/scenarios.spec.ts) picks it up
- * automatically via describe.each.
- */
-import type { TransactionReceipt } from 'viem';
-import { CHAIN } from '../../../constants/enums';
-import type { DecodedIdentifiers, MatchingLog, UniversalTxKind } from '../../types';
-import { deriveChildUniversalTxId, derivePcUniversalTxId } from '../../child-inbounds';
-import { type EventDef } from './builders';
-export type LogSpec = {
-    event: EventDef;
-    args: Record<string, unknown>;
-    address: `0x${string}`;
-    logIndex: number;
-};
-export type ReceiptEntry = {
-    txHash: `0x${string}`;
-    chain: CHAIN;
-    to: `0x${string}`;
-    logs: LogSpec[];
-};
-export type UtxRecordFixture = {
-    /** 32-byte hex id (no 0x prefix) or prefix; matcher lowercases and strips. */
-    id: string;
-    record: Record<string, unknown> | null;
-};
-export type ExpectedCascade = {
-    outboundCount?: number;
-    refundCount?: number;
-    childInboundCount?: number;
-    totalFlatNodes?: number;
-    rootKind?: UniversalTxKind;
-    /** For each outbound edge, the destinationChain CAIP (order-insensitive). */
-    outboundDestinations?: string[];
-};
-export type ScenarioFixture = {
-    id: string;
-    name: string;
-    kind: UniversalTxKind;
-    chain: CHAIN;
-    txHash: `0x${string}`;
-    to: `0x${string}`;
-    logs: LogSpec[];
-    /** Additional receipts the cascade walker will fetch when recursing. */
-    extraReceipts?: ReceiptEntry[];
-    /** Cosmos utx records keyed by id (hex without 0x prefix). */
-    utxRecords?: UtxRecordFixture[];
-    expectedDecoded?: Partial<DecodedIdentifiers>;
-    expectedClassifyAll?: UniversalTxKind[];
-    expectedCascade?: ExpectedCascade;
-};
-export declare function matchingLogsForFixture(f: ScenarioFixture): MatchingLog[];
-export declare function receiptForFixture(f: ScenarioFixture): TransactionReceipt;
-export declare function receiptForExtra(r: ReceiptEntry): TransactionReceipt;
-/**
- * Flatten all utxRecord entries across a scenario and its linked fixtures
- * into a single Map keyed by the lowercased id (no 0x prefix).
- */
-export declare function utxRecordMap(fixtures: ScenarioFixture[]): Map<string, Record<string, unknown> | null>;
-/**
- * Build a Map<txHashLower, TransactionReceipt> covering the primary tx +
- * all extraReceipts across every fixture.
- */
-export declare function receiptMap(fixtures: ScenarioFixture[]): Map<string, TransactionReceipt>;
-export declare const SCENARIOS: ScenarioFixture[];
-export { deriveChildUniversalTxId, derivePcUniversalTxId };