@pushchain/core 4.0.14-alpha.0 → 5.1.0

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

@@ -1,9 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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;
+exports.encodeSvmExecutePayload = encodeSvmExecutePayload;
+exports.encodeSvmCeaToUeaPayload = encodeSvmCeaToUeaPayload;
 const viem_1 = require("viem");
 const push_chain_1 = require("../push-chain/push-chain");
 const abi_1 = require("../constants/abi");
+const selectors_1 = require("../constants/selectors");
+const chain_1 = require("../constants/chain");
+const enums_1 = require("../constants/enums");
 function buildExecuteMulticall({ execute, ueaAddress, logger, }) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
     const log = (msg) => logger === null || logger === void 0 ? void 0 : logger(msg);
@@ -95,4 +115,465 @@ function buildExecuteMulticall({ execute, ueaAddress, logger, }) {
         JSON.stringify(multicallData, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2));
     return multicallData;
 }
+// ============================================================================
+// Multi-Chain Payload Builders
+// ============================================================================
+/**
+ * Multicall tuple type definition for ABI encoding
+ */
+const MULTICALL_TUPLE_TYPE = {
+    type: 'tuple[]',
+    components: [
+        { name: 'to', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'data', type: 'bytes' },
+    ],
+};
+/**
+ * Build CEA multicall payload for outbound transactions
+ * Format: UEA_MULTICALL_SELECTOR + abi.encode(Multicall[])
+ *
+ * The CEA contract checks for UEA_MULTICALL_SELECTOR (0x2cc2842d) at the
+ * start of the payload to route to _handleMulticall. Without this prefix,
+ * the CEA treats it as a single call and fails with InvalidRecipient.
+ *
+ * @param multicalls - Array of multicall operations to execute on external chain
+ * @returns UEA_MULTICALL_SELECTOR + ABI-encoded Multicall[] array
+ */
+function buildCeaMulticallPayload(multicalls) {
+    if (multicalls.length === 0) {
+        return '0x';
+    }
+    // Encode the multicall array
+    const encoded = (0, viem_1.encodeAbiParameters)([MULTICALL_TUPLE_TYPE], [multicalls.map((m) => ({
+            to: m.to,
+            value: m.value,
+            data: m.data,
+        }))]);
+    // Prefix with UEA_MULTICALL_SELECTOR (0x2cc2842d) so CEA recognizes it as multicall
+    return `${selectors_1.UEA_MULTICALL_SELECTOR}${encoded.slice(2)}`;
+}
+/**
+ * Build an ABI-encoded UniversalPayload struct for inbound relay (Route 3 CEA→Push).
+ *
+ * The relay and Push Chain gateway expect the payload parameter of sendUniversalTxToUEA
+ * to be a full UniversalPayload struct: (address to, uint256 value, bytes data, uint256 gasLimit,
+ * uint256 maxFeePerGas, uint256 maxPriorityFeePerGas, uint256 nonce, uint256 deadline, uint8 vType).
+ *
+ * The `data` field inside the struct contains the multicall payload (with UEA_MULTICALL_SELECTOR prefix)
+ * which the UEA uses to execute calls on Push Chain.
+ *
+ * @param multicallData - The multicall payload (selector + abi.encode(Multicall[]))
+ * @param opts - Optional overrides for gasLimit, nonce, deadline
+ * @returns ABI-encoded UniversalPayload struct
+ */
+function buildInboundUniversalPayload(multicallData, opts) {
+    var _a, _b, _c;
+    return (0, viem_1.encodeAbiParameters)([
+        {
+            type: 'tuple',
+            components: [
+                { name: 'to', type: 'address' },
+                { name: 'value', type: 'uint256' },
+                { name: 'data', type: 'bytes' },
+                { name: 'gasLimit', type: 'uint256' },
+                { name: 'maxFeePerGas', type: 'uint256' },
+                { name: 'maxPriorityFeePerGas', type: 'uint256' },
+                { name: 'nonce', type: 'uint256' },
+                { name: 'deadline', type: 'uint256' },
+                { name: 'vType', type: 'uint8' },
+            ],
+        },
+    ], [
+        {
+            to: selectors_1.ZERO_ADDRESS,
+            value: BigInt(0),
+            data: multicallData,
+            gasLimit: (_a = opts === null || opts === void 0 ? void 0 : opts.gasLimit) !== null && _a !== void 0 ? _a : BigInt(10e7),
+            maxFeePerGas: BigInt(1e10),
+            maxPriorityFeePerGas: BigInt(0),
+            nonce: (_b = opts === null || opts === void 0 ? void 0 : opts.nonce) !== null && _b !== void 0 ? _b : BigInt(0),
+            deadline: (_c = opts === null || opts === void 0 ? void 0 : opts.deadline) !== null && _c !== void 0 ? _c : BigInt(9999999999),
+            vType: 1, // universalTxVerification
+        },
+    ]);
+}
+/**
+ * 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) {
+    const approveData = (0, viem_1.encodeFunctionData)({
+        abi: abi_1.ERC20_EVM,
+        functionName: 'approve',
+        args: [spender, amount],
+    });
+    return [
+        {
+            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: abi_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)
+ *
+ * The CEA contract has a `sendUniversalTxToUEA(token, amount, payload, revertRecipient)` function
+ * that is only callable via self-call (multicall with to=CEA, value=0).
+ * It internally calls `gateway.sendUniversalTxFromCEA(...)`.
+ *
+ * @param ceaAddress - CEA contract address (multicall target = self)
+ * @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 (on source chain)
+ * @returns MultiCall for sendUniversalTxToUEA (to=CEA, value=0)
+ */
+function buildSendUniversalTxToUEA(ceaAddress, token, amount, payload, revertRecipient) {
+    const calldata = (0, viem_1.encodeFunctionData)({
+        abi: abi_1.CEA_EVM,
+        functionName: 'sendUniversalTxToUEA',
+        args: [token, amount, payload, revertRecipient],
+    });
+    return {
+        to: ceaAddress,
+        value: BigInt(0),
+        data: calldata,
+    };
+}
+/**
+ * Build UniversalOutboundTxRequest for Push Chain outbound
+ *
+ * @param target - LEGACY/DUMMY: Any non-zero address for contract compatibility.
+ *                 This value is NOT used by the relay to determine the actual destination.
+ *                 The relay determines the destination from the PRC-20 token's SOURCE_CHAIN_NAMESPACE.
+ *                 Will be removed in future contract upgrades.
+ * @param prc20Token - PRC20 token address to burn (or address(0) for native)
+ * @param amount - Amount to burn
+ * @param gasLimit - Gas limit for fee calculation
+ * @param payload - CEA multicall payload
+ * @param revertRecipient - Address to receive funds on revert
+ * @returns UniversalOutboundTxRequest object
+ */
+function buildOutboundRequest(target, prc20Token, amount, gasLimit, payload, revertRecipient) {
+    return {
+        target,
+        token: prc20Token,
+        amount,
+        gasLimit,
+        payload,
+        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
+ *
+ * @param tokenAddress - ERC20 token address
+ * @param to - Recipient address
+ * @param amount - Amount to transfer
+ * @returns MultiCall for ERC20 transfer
+ */
+function buildErc20Transfer(tokenAddress, to, amount) {
+    const transferData = (0, viem_1.encodeFunctionData)({
+        abi: abi_1.ERC20_EVM,
+        functionName: 'transfer',
+        args: [to, amount],
+    });
+    return {
+        to: tokenAddress,
+        value: BigInt(0),
+        data: transferData,
+    };
+}
+/**
+ * Build a single-element MultiCall[] for an ERC20 withdrawal (Flow 2.2).
+ * Wraps buildErc20Transfer so callers of Route 2 (executeUoaToCea) don't
+ * need to manually construct the transfer() multicall step.
+ *
+ * @param tokenAddress - ERC20 token contract on the external chain
+ * @param recipientAddress - Withdrawal recipient on the external chain
+ * @param amount - Amount of tokens to transfer
+ * @returns MultiCall[] with a single ERC20 transfer call
+ */
+function buildErc20WithdrawalMulticall(tokenAddress, recipientAddress, amount) {
+    return [buildErc20Transfer(tokenAddress, recipientAddress, amount)];
+}
+/**
+ * Build the 4-byte migration payload for CEA upgrade (Migration flow).
+ * Returns exactly MIGRATION_SELECTOR — no Multicall wrapping.
+ *
+ * @returns 4-byte hex string `0xcac656d6`
+ */
+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
+// ============================================================================
+/**
+ * Build approval multicalls + sendUniversalTxOutbound call for Push Chain.
+ *
+ * Extracted from executeUoaToCea to be reusable in cascade composition.
+ * Handles two cases:
+ * - gasToken === prc20Token: single approval for burnAmount + gasFee
+ * - gasToken !== prc20Token: two separate approvals
+ *
+ * @param opts.prc20Token - PRC-20 token to burn
+ * @param opts.gasToken - Gas token for fee payment
+ * @param opts.burnAmount - Amount to burn
+ * @param opts.gasFee - Gas fee amount
+ * @param opts.gatewayPcAddress - UniversalGatewayPC precompile address
+ * @param opts.outboundRequest - The outbound request struct
+ * @returns Array of MultiCall operations (approvals + outbound call)
+ */
+function buildOutboundApprovalAndCall(opts) {
+    var _a;
+    const { prc20Token, burnAmount, gasFee, gatewayPcAddress, outboundRequest } = opts;
+    const multicalls = [];
+    // ERC20 approve for burn amount (contract calls transferFrom for PRC20 burn)
+    if (burnAmount > BigInt(0) &&
+        prc20Token.toLowerCase() !== selectors_1.ZERO_ADDRESS.toLowerCase()) {
+        const approveData = (0, viem_1.encodeFunctionData)({
+            abi: abi_1.ERC20_EVM,
+            functionName: 'approve',
+            args: [gatewayPcAddress, burnAmount],
+        });
+        multicalls.push({
+            to: prc20Token,
+            value: BigInt(0),
+            data: approveData,
+        });
+    }
+    // Gas fee + protocol fee paid as native msg.value (no ERC20 approve for gas)
+    const outboundCallData = (0, viem_1.encodeFunctionData)({
+        abi: abi_1.UNIVERSAL_GATEWAY_PC,
+        functionName: 'sendUniversalTxOutbound',
+        args: [outboundRequest],
+    });
+    // Use pre-computed nativeValueForGas (from Uniswap quoter) or fallback to 5x gasFee
+    const nativeValue = (_a = opts.nativeValueForGas) !== null && _a !== void 0 ? _a : (gasFee * BigInt(5));
+    multicalls.push({
+        to: gatewayPcAddress,
+        value: nativeValue,
+        data: outboundCallData,
+    });
+    return multicalls;
+}
+// ============================================================================
+// SVM (Solana) Payload Builders
+// ============================================================================
+/**
+ * Check if a chain targets the SVM (Solana) virtual machine
+ */
+function isSvmChain(chain) {
+    var _a;
+    return ((_a = chain_1.CHAIN_INFO[chain]) === null || _a === void 0 ? void 0 : _a.vm) === enums_1.VM.SVM;
+}
+/**
+ * Validate a Solana address in 0x-prefixed hex format.
+ * Must be exactly 32 bytes (0x + 64 hex chars = 66 characters total).
+ */
+function isValidSolanaHexAddress(address) {
+    return /^0x[a-fA-F0-9]{64}$/.test(address);
+}
+/** Convert 0x-prefixed hex string to Uint8Array */
+function hexToBytes(hex) {
+    const h = hex.startsWith('0x') ? hex.slice(2) : hex;
+    const bytes = new Uint8Array(h.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(h.substr(i * 2, 2), 16);
+    }
+    return bytes;
+}
+/** Convert Uint8Array to hex string (no 0x prefix) */
+function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+/**
+ * Encode SVM execute payload for CPI execution on Solana.
+ *
+ * Binary format (matching the Solana gateway contract expectation):
+ * ```
+ * [accounts_count: 4 bytes (u32 BE)]
+ * [account[i].pubkey: 32 bytes][account[i].is_writable: 1 byte] × N
+ * [ix_data_length: 4 bytes (u32 BE)]
+ * [ix_data: variable bytes]
+ * [instruction_id: 1 byte (u8)]
+ * [target_program: 32 bytes]
+ * ```
+ *
+ * @param fields - SVM execute payload fields
+ * @returns 0x-prefixed hex string of the encoded payload
+ */
+function encodeSvmExecutePayload(fields) {
+    const { targetProgram, accounts, ixData, instructionId = 2, } = fields;
+    // Total size:
+    // 4 (accounts_count) + 33*N (accounts) + 4 (ix_data_length) + M (ix_data) + 1 (instruction_id) + 32 (target_program)
+    const totalSize = 4 + 33 * accounts.length + 4 + ixData.length + 1 + 32;
+    const buffer = new Uint8Array(totalSize);
+    const view = new DataView(buffer.buffer);
+    let offset = 0;
+    // accounts_count (u32 BE)
+    view.setUint32(offset, accounts.length, false);
+    offset += 4;
+    // Each account: pubkey (32 bytes) + is_writable (1 byte)
+    for (const account of accounts) {
+        const pubkeyBytes = hexToBytes(account.pubkey);
+        buffer.set(pubkeyBytes, offset);
+        offset += 32;
+        buffer[offset] = account.isWritable ? 1 : 0;
+        offset += 1;
+    }
+    // ix_data_length (u32 BE)
+    view.setUint32(offset, ixData.length, false);
+    offset += 4;
+    // ix_data
+    buffer.set(ixData, offset);
+    offset += ixData.length;
+    // instruction_id (u8)
+    buffer[offset] = instructionId;
+    offset += 1;
+    // target_program (32 bytes)
+    const targetProgramBytes = hexToBytes(targetProgram);
+    buffer.set(targetProgramBytes, offset);
+    return `0x${bytesToHex(buffer)}`;
+}
+/**
+ * Encode the SVM CEA-to-UEA payload for Route 3 on Solana.
+ *
+ * This builds a `send_universal_tx_to_uea` instruction wrapped in
+ * `encodeSvmExecutePayload`, targeting the gateway program as a self-call.
+ *
+ * Borsh ixData layout:
+ * ```
+ * [discriminator: 8 bytes (SHA-256("global:send_universal_tx_to_uea")[0..8])]
+ * [token: 32 bytes (PublicKey::default for SOL, mint pubkey for SPL)]
+ * [amount: 8 bytes (u64 LE)]
+ * [payload_len: 4 bytes (u32 LE)]
+ * [payload_bytes: variable]
+ * [revert_recipient: 32 bytes (PublicKey)]
+ * ```
+ */
+function encodeSvmCeaToUeaPayload({ gatewayProgramHex, drainAmount, tokenMintHex, extraPayload, revertRecipientHex, }) {
+    // Anchor discriminator: first 8 bytes of SHA-256("global:send_universal_tx_to_uea")
+    const discrimHash = (0, viem_1.sha256)((0, viem_1.toBytes)('global:send_universal_tx_to_uea'));
+    const discrimBytes = hexToBytes(discrimHash.slice(0, 18)); // 0x + 16 hex chars = 8 bytes
+    // Token: 32 zero bytes for native SOL, or the SPL mint bytes
+    const tokenBytes = new Uint8Array(32);
+    if (tokenMintHex && tokenMintHex !== '0x' + '00'.repeat(32)) {
+        const mintBytes = hexToBytes(tokenMintHex);
+        tokenBytes.set(mintBytes, 0);
+    }
+    // Amount: u64 little-endian
+    const amountBuf = new Uint8Array(8);
+    const amountView = new DataView(amountBuf.buffer);
+    amountView.setBigUint64(0, drainAmount, true); // LE
+    // Extra payload (Vec<u8>: u32 LE length + bytes)
+    const payloadData = extraPayload !== null && extraPayload !== void 0 ? extraPayload : new Uint8Array(0);
+    const payloadLenBuf = new Uint8Array(4);
+    const payloadLenView = new DataView(payloadLenBuf.buffer);
+    payloadLenView.setUint32(0, payloadData.length, true); // LE
+    // revertRecipient: 32 bytes (PublicKey)
+    const revertRecipientBytes = hexToBytes(revertRecipientHex);
+    // Combine into Borsh ixData
+    const ixDataLen = discrimBytes.length + tokenBytes.length + amountBuf.length +
+        payloadLenBuf.length + payloadData.length + revertRecipientBytes.length;
+    const ixData = new Uint8Array(ixDataLen);
+    let offset = 0;
+    ixData.set(discrimBytes, offset);
+    offset += discrimBytes.length;
+    ixData.set(tokenBytes, offset);
+    offset += tokenBytes.length;
+    ixData.set(amountBuf, offset);
+    offset += amountBuf.length;
+    ixData.set(payloadLenBuf, offset);
+    offset += payloadLenBuf.length;
+    ixData.set(payloadData, offset);
+    offset += payloadData.length;
+    ixData.set(revertRecipientBytes, offset);
+    // Wrap in encodeSvmExecutePayload (self-call to gateway, no extra accounts)
+    return encodeSvmExecutePayload({
+        targetProgram: gatewayProgramHex,
+        accounts: [],
+        ixData,
+        instructionId: 2,
+    });
+}
 //# sourceMappingURL=payload-builders.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"payload-builders.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/orchestrator/payload-builders.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"payload-builders.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/orchestrator/payload-builders.ts"],"names":[],"mappings":"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"}

package/src/lib/orchestrator/route-detector.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Route Detection and Validation for Multi-Chain Transactions
+ *
+ * Detects which route a transaction should take based on `from` and `to` parameters:
+ * - Route 1 (UOA_TO_PUSH): UOA → Push Chain
+ * - Route 2 (UOA_TO_CEA): UOA → CEA on external chain
+ * - Route 3 (CEA_TO_PUSH): CEA → Push Chain
+ * - Route 4 (CEA_TO_CEA): CEA → CEA (external to external via Push)
+ */
+import { CHAIN } from '../constants/enums';
+import { type MoveableToken } from '../constants/tokens';
+import type { UniversalExecuteParams, ChainTarget } from './orchestrator.types';
+/**
+ * Enum for transaction routes
+ */
+export declare enum TransactionRoute {
+    /** Route 1: UOA → Push Chain (existing flow) */
+    UOA_TO_PUSH = "UOA_TO_PUSH",
+    /** Route 2: UOA → CEA on external chain */
+    UOA_TO_CEA = "UOA_TO_CEA",
+    /** Route 3: CEA → Push Chain */
+    CEA_TO_PUSH = "CEA_TO_PUSH",
+    /** Route 4: CEA → CEA (external to external via Push) */
+    CEA_TO_CEA = "CEA_TO_CEA"
+}
+/**
+ * Error thrown when route parameters are invalid
+ */
+export declare class RouteValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when a chain is not supported for CEA operations
+ */
+export declare class ChainNotSupportedError extends Error {
+    chain: CHAIN | string;
+    constructor(chain: CHAIN | string);
+}
+/**
+ * Error thrown when transaction type is invalid
+ */
+export declare class InvalidTransactionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Check if a chain is a Push Chain
+ */
+export declare function isPushChain(chain: CHAIN): boolean;
+/**
+ * Check if a chain is supported for CEA operations
+ */
+export declare function isSupportedExternalChain(chain: CHAIN): boolean;
+/**
+ * Reverse-map a CHAIN enum value to its friendly name (e.g. CHAIN.ETHEREUM_SEPOLIA → 'ETHEREUM_SEPOLIA').
+ */
+export declare function chainEnumToName(chain: CHAIN): string;
+/**
+ * Find which chain(s) a moveable token is registered for, by matching address.
+ * Returns the first matching chain, or undefined if not found.
+ */
+export declare function findTokenChain(token: MoveableToken): CHAIN | undefined;
+/**
+ * Check if 'to' parameter is a ChainTarget object
+ */
+export declare function isChainTarget(to: unknown): to is ChainTarget;
+/**
+ * Detect the transaction route based on params
+ *
+ * Route detection logic:
+ * | from.chain | to format     | to.chain    | Route         |
+ * |------------|---------------|-------------|---------------|
+ * | undefined  | string        | N/A         | UOA_TO_PUSH   |
+ * | undefined  | ChainTarget   | external    | UOA_TO_CEA    |
+ * | undefined  | ChainTarget   | push        | UOA_TO_PUSH   |
+ * | defined    | string        | N/A         | CEA_TO_PUSH   |
+ * | defined    | ChainTarget   | push        | CEA_TO_PUSH   |
+ * | defined    | ChainTarget   | external    | CEA_TO_CEA    |
+ *
+ * @param params - Universal execute parameters
+ * @returns The detected transaction route
+ * @throws RouteValidationError if parameters are invalid
+ */
+export declare function detectRoute(params: UniversalExecuteParams): TransactionRoute;
+/**
+ * Validate route parameters are valid for the detected route
+ *
+ * @param params - Universal execute parameters
+ * @throws RouteValidationError if validation fails
+ * @throws ChainNotSupportedError if chain is not supported
+ */
+export declare function validateRouteParams(params: UniversalExecuteParams, context?: {
+    clientChain?: CHAIN;
+}): void;
+/**
+ * Get route information for display/logging
+ */
+export declare function getRouteInfo(route: TransactionRoute): {
+    name: string;
+    description: string;
+    isOutbound: boolean;
+    requiresCEA: boolean;
+};