@pushchain/core 5.1.4 → 5.1.5-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "5.1.4",
+  "version": "5.1.5-alpha.0",
   "homepage": "https://push.org",
   "keywords": [
     "pushchain",

package/src/lib/index.d.ts

@@ -1,7 +1,7 @@
 import { PushChain } from './push-chain/push-chain';
 export type { ConversionQuote } from './constants/tokens';
 export type { UniversalSigner, UniversalAccount, UniversalSignerSkeleton, DerivedExecutorAccount, ResolvedAccount, ResolvedControllerAccounts, AccountType, AccountRole, } from './universal/universal.types';
-export type { ChainTarget, ChainSource, UniversalTo, TransactionRouteType, UniversalExecuteParams, UniversalOutboundTxRequest, PreparedUniversalTx, CascadedTxResponse, CascadeHopInfo, CascadeTrackOptions, CascadeProgressEvent, CascadeCompletionResult, MultiChainTxResponse, OutboundTxDetails, WaitForOutboundOptions, SvmGatewayAccountMeta, SvmExecutePayloadFields, SvmExecuteParams, AccountStatus, UEAStatus, RescueFundsParams, } from './orchestrator/orchestrator.types';
+export type { ChainTarget, ChainSource, UniversalTo, TransactionRouteType, UniversalExecuteParams, UniversalOutboundTxRequest, PreparedUniversalTx, CascadedTxResponse, CascadeHopInfo, CascadeTrackOptions, CascadeProgressEvent, CascadeCompletionResult, MultiChainTxResponse, OutboundTxDetails, WaitForOutboundOptions, SvmGatewayAccountMeta, SvmExecutePayloadFields, AccountStatus, UEAStatus, RescueFundsParams, } from './orchestrator/orchestrator.types';
 export { parseUEAVersion } from './orchestrator/orchestrator.types';
 export { TransactionRoute, detectRoute, isChainTarget } from './orchestrator/route-detector';
 export { getCEAAddress, getPushAccountForCEA, isCEA, chainSupportsCEA, chainSupportsOutbound, getCEAFactoryAddress, getAllCEAAddresses, } from './orchestrator/cea-utils';

package/src/lib/orchestrator/internals/cascade.js

@@ -27,6 +27,7 @@ const payload_builder_1 = require("./payload-builder");
 const uea_manager_1 = require("./uea-manager");
 const gas_calculator_1 = require("./gas-calculator");
 const route_handlers_1 = require("./route-handlers");
+const build_payload_1 = require("../svm-idl/build-payload");
 // ============================================================================
 // prepareTransaction
 // ============================================================================
@@ -110,18 +111,12 @@ function buildHopDescriptor(ctx, params, route, ueaAddress) {
                 const targetChain = target.chain;
                 // Branch: SVM vs EVM
                 if ((0, payload_builders_1.isSvmChain)(targetChain)) {
-                    // SVM path: no CEA lookup, build SVM payload
-                    const hasSvmExecute = !!params.svmExecute;
-                    let svmPayload = '0x';
-                    if (hasSvmExecute) {
-                        const exec = params.svmExecute;
-                        svmPayload = (0, payload_builders_1.encodeSvmExecutePayload)({
-                            targetProgram: exec.targetProgram,
-                            accounts: exec.accounts,
-                            ixData: exec.ixData,
-                            instructionId: 2,
-                        });
-                    }
+                    // SVM path: no CEA lookup, build SVM payload via IDL resolver
+                    const { svmPayload, hasExecute: hasSvmExecute } = (0, build_payload_1.buildSvmPayloadFromParams)({
+                        data: params.data,
+                        to: target,
+                        senderUea: ueaAddress,
+                    });
                     let prc20Token = selectors_1.ZERO_ADDRESS;
                     let burnAmount = BigInt(0);
                     if ((_b = params.funds) === null || _b === void 0 ? void 0 : _b.amount) {
@@ -432,7 +427,7 @@ function getSegmentType(route) {
 // composeCascade
 // ============================================================================
 function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var _a, _b, _c, _d, _e, _f, _g;
     let accumulatedPushMulticalls = [];
     const gatewayPcAddress = (0, helpers_1.getUniversalGatewayPCAddress)();
     // Compute per-outbound nativeValueForGas from UEA balance
@@ -465,10 +460,9 @@ function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
                 if (isSvmSegment) {
                     // SVM: use the pre-built SVM payload from the hop descriptor
                     outboundPayload = (_a = firstHop.svmPayload) !== null && _a !== void 0 ? _a : '0x';
-                    // For SVM, target is the recipient/program from the hop params
+                    // For SVM, to.address IS the target (program for execute, recipient for withdraw)
                     const svmTarget = firstHop.params.to;
-                    targetForOutbound =
-                        (_c = (_b = firstHop.params.svmExecute) === null || _b === void 0 ? void 0 : _b.targetProgram) !== null && _c !== void 0 ? _c : svmTarget.address;
+                    targetForOutbound = svmTarget.address;
                 }
                 else if (isMigration) {
                     // Migration: use raw 4-byte MIGRATION_SELECTOR, no multicall wrapping
@@ -482,7 +476,7 @@ function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
                     targetForOutbound = (firstHop === null || firstHop === void 0 ? void 0 : firstHop.ceaAddress) || ueaAddress;
                 }
                 // Build outbound request
-                const outboundReq = (0, payload_builders_1.buildOutboundRequest)(targetForOutbound, segment.prc20Token || selectors_1.ZERO_ADDRESS, segment.totalBurnAmount || BigInt(0), (_d = segment.gasLimit) !== null && _d !== void 0 ? _d : BigInt(0), outboundPayload, ueaAddress);
+                const outboundReq = (0, payload_builders_1.buildOutboundRequest)(targetForOutbound, segment.prc20Token || selectors_1.ZERO_ADDRESS, segment.totalBurnAmount || BigInt(0), (_b = segment.gasLimit) !== null && _b !== void 0 ? _b : BigInt(0), outboundPayload, ueaAddress);
                 // Build approval + outbound multicalls
                 const segGasFee = segment.gasFee || BigInt(0);
                 const outboundMulticalls = (0, payload_builders_1.buildOutboundApprovalAndCall)({
@@ -507,7 +501,7 @@ function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
                 // Build push multicalls from this hop's own data (e.g., counter.increment())
                 // This is the Route 3 hop's payload that executes on Push Chain after inbound.
                 const hop0 = segment.hops[0];
-                if ((_e = hop0 === null || hop0 === void 0 ? void 0 : hop0.params) === null || _e === void 0 ? void 0 : _e.data) {
+                if ((_c = hop0 === null || hop0 === void 0 ? void 0 : hop0.params) === null || _c === void 0 ? void 0 : _c.data) {
                     const hopPushMulticalls = (0, payload_builders_1.buildExecuteMulticall)({
                         execute: {
                             to: hop0.params.to,
@@ -543,7 +537,7 @@ function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
                     let drainAmount = BigInt(0);
                     let tokenMintHex;
                     const params = hop.params;
-                    if (((_f = params.funds) === null || _f === void 0 ? void 0 : _f.amount) && params.funds.amount > BigInt(0)) {
+                    if (((_d = params.funds) === null || _d === void 0 ? void 0 : _d.amount) && params.funds.amount > BigInt(0)) {
                         drainAmount = params.funds.amount;
                         const token = params.funds.token;
                         if (token && token.address) {
@@ -572,7 +566,7 @@ function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
                     });
                     const svmBurnAmount = segment.totalBurnAmount || BigInt(0);
                     const outboundReq = (0, payload_builders_1.buildOutboundRequest)(gatewayProgramHex, segment.prc20Token ||
-                        (0, helpers_1.getNativePRC20ForChain)(sourceChain, ctx.pushNetwork), svmBurnAmount, (_g = segment.gasLimit) !== null && _g !== void 0 ? _g : BigInt(0), svmPayload, ueaAddress);
+                        (0, helpers_1.getNativePRC20ForChain)(sourceChain, ctx.pushNetwork), svmBurnAmount, (_e = segment.gasLimit) !== null && _e !== void 0 ? _e : BigInt(0), svmPayload, ueaAddress);
                     const inboundGasFee = segment.gasFee || BigInt(0);
                     const outboundMulticalls = (0, payload_builders_1.buildOutboundApprovalAndCall)({
                         prc20Token: segment.prc20Token ||
@@ -598,7 +592,7 @@ function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
                 let tokenAddress = selectors_1.ZERO_ADDRESS;
                 let amount = BigInt(0);
                 const params = hop.params;
-                if ((_h = params.funds) === null || _h === void 0 ? void 0 : _h.amount) {
+                if ((_f = params.funds) === null || _f === void 0 ? void 0 : _f.amount) {
                     const token = params.funds.token;
                     if (token) {
                         if (token.mechanism === 'native') {
@@ -645,7 +639,7 @@ function composeCascade(ctx, segments, ueaAddress, ueaBalance, ueaNonce) {
                 // Wrap CEA multicall in outbound from Push Chain
                 const ceaPayload = (0, payload_builders_1.buildCeaMulticallPayload)(ceaMulticalls);
                 const outboundReq = (0, payload_builders_1.buildOutboundRequest)(ceaAddress, segment.prc20Token ||
-                    (0, helpers_1.getNativePRC20ForChain)(sourceChain, ctx.pushNetwork), segment.totalBurnAmount || BigInt(0), (_j = segment.gasLimit) !== null && _j !== void 0 ? _j : BigInt(0), ceaPayload, ueaAddress);
+                    (0, helpers_1.getNativePRC20ForChain)(sourceChain, ctx.pushNetwork), segment.totalBurnAmount || BigInt(0), (_g = segment.gasLimit) !== null && _g !== void 0 ? _g : BigInt(0), ceaPayload, ueaAddress);
                 const inboundGasFee = segment.gasFee || BigInt(0);
                 const outboundMulticalls = (0, payload_builders_1.buildOutboundApprovalAndCall)({
                     prc20Token: segment.prc20Token ||

package/src/lib/orchestrator/internals/execute-funds-payload.js

@@ -74,15 +74,15 @@ function executeFundsWithPayload(ctx, execute, eventBuffer, getResponseCallbacks
         const ueaAddress = (0, uea_manager_1.computeUEAOffchain)(ctx);
         const ueaBalance = yield ctx.pushClient.getBalance(ueaAddress);
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_03_02, ueaAddress, deployed);
-        // Determine USD to deposit via gateway (8 decimals) with caps: min=$1, max=$10
+        // Determine USD to deposit via gateway (8 decimals) with caps: min=$1, max=$1000
         const oneUsd = utils_1.Utils.helpers.parseUnits('1', 8);
-        const tenUsd = utils_1.Utils.helpers.parseUnits('10', 8);
+        const maxUsd = utils_1.Utils.helpers.parseUnits('1000', 8);
         const deficit = requiredFunds > ueaBalance ? requiredFunds - ueaBalance : BigInt(0);
         let depositUsd = deficit > BigInt(0) ? ctx.pushClient.pushToUSDC(deficit) : oneUsd;
         if (depositUsd < oneUsd)
             depositUsd = oneUsd;
-        if (depositUsd > tenUsd)
-            throw new Error('Deposit value exceeds max $10 worth of native token');
+        if (depositUsd > maxUsd)
+            throw new Error('Deposit value exceeds max $1000 worth of native token');
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_02_02, depositUsd);
         // If SVM, clamp depositUsd to on-chain Config caps
         if (chain_1.CHAIN_INFO[chain].vm === enums_1.VM.SVM) {

package/src/lib/orchestrator/internals/execute-standard.js

@@ -200,7 +200,34 @@ function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks)
             const fundDifference = requiredFunds - funds;
             const fixedPushAmount = utils_1.Utils.helpers.parseUnits('0.001', 18);
             const lockAmount = funds < requiredFunds ? fundDifference : fixedPushAmount;
-            const lockAmountInUSD = ctx.pushClient.pushToUSDC(lockAmount);
+            // Size the USD deposit against the REAL Uniswap pool rate (not the fixed
+            // $0.10/PC SDK rate) for EVM origins. The pool typically prices PC much
+            // higher than $0.10, so pushToUSDC under-provisions and the resulting
+            // deposit gets clamped up to the $1 minimum, producing near-zero WPC.
+            // When the quoted USD exceeds the $1000 cap the later clamp kicks in
+            // (pool limit surfaces via the pre-flight capacity message).
+            // Falls back to pushToUSDC if the quoter is unavailable.
+            const { vm: sizingOriginVm } = chain_1.CHAIN_INFO[chain];
+            let lockAmountInUSD = ctx.pushClient.pushToUSDC(lockAmount);
+            if (sizingOriginVm === enums_1.VM.EVM && lockAmount > BigInt(0)) {
+                // Target lockAmount × 1.2 so that the 10% slippage margin applied by
+                // the pre-flight check (safeUPC = predictedUPC × 0.9) leaves enough
+                // headroom even when Uniswap V3 exactOutput↔exactInput quotes aren't
+                // perfectly symmetric (tick-math rounding).
+                const targetWPC = (lockAmount * BigInt(12)) / BigInt(10);
+                const originPrc20ForSizing = (0, helpers_2.getNativePRC20ForChain)(chain, ctx.pushNetwork);
+                const requiredNative = yield (0, gas_calculator_1.estimateNativeForDesiredDeposit)(ctx, targetWPC, originPrc20ForSizing);
+                if (requiredNative > BigInt(0)) {
+                    const ethPriceForSizing = yield new price_fetch_1.PriceFetch(ctx.rpcUrls).getPrice(chain);
+                    if (ethPriceForSizing > BigInt(0)) {
+                        // requiredNative (18-dec wei) × ethPrice (8-dec USD/ETH) / 1e18 = USD in 8-dec
+                        const poolBasedUsd = (requiredNative * ethPriceForSizing) / BigInt(1e18);
+                        (0, context_1.printLog)(ctx, `Fee-lock sizing: pushToUSDC=${lockAmountInUSD.toString()} (fixed $0.10/PC), ` +
+                            `poolBased=${poolBasedUsd.toString()} (pool quote for ${targetWPC.toString()} WPC) — using poolBased`);
+                        lockAmountInUSD = poolBasedUsd;
+                    }
+                }
+            }
             // Apply minimum deposit override (e.g., Route 2 needs enough UPC for outbound swap)
             const effectiveLockAmountInUSD = execute._minimumDepositUsd && execute._minimumDepositUsd > lockAmountInUSD
                 ? execute._minimumDepositUsd
@@ -212,12 +239,12 @@ function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks)
             const { vm: originVm } = chain_1.CHAIN_INFO[chain];
             if (originVm === enums_1.VM.EVM) {
                 try {
-                    // Replicate lockFee's USD → native conversion (with its $1–$10 clamp)
+                    // Replicate lockFee's USD → native conversion (with its $1–$1000 clamp)
                     const oneUsd = utils_1.Utils.helpers.parseUnits('1', 8);
-                    const tenUsd = utils_1.Utils.helpers.parseUnits('10', 8);
+                    const maxUsd = utils_1.Utils.helpers.parseUnits('1000', 8);
                     let depositUsd = effectiveLockAmountInUSD < oneUsd ? oneUsd : effectiveLockAmountInUSD;
-                    if (depositUsd > tenUsd)
-                        depositUsd = tenUsd;
+                    if (depositUsd > maxUsd)
+                        depositUsd = maxUsd;
                     const ethPrice = yield new price_fetch_1.PriceFetch(ctx.rpcUrls).getPrice(chain);
                     if (ethPrice > BigInt(0)) {
                         const nativeAmountETH = (depositUsd * BigInt(1e18) + (ethPrice - BigInt(1))) / ethPrice + BigInt(1);
@@ -233,11 +260,32 @@ function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks)
                                 `total: ${totalAvailable.toString()}, required: ${requiredFunds.toString()}`);
                             if (totalAvailable < requiredFunds) {
                                 const shortfall = requiredFunds - totalAvailable;
+                                // On failure only: probe pool capacity at the max cap so the
+                                // caller gets a readable "max transferable right now" number.
+                                // One extra quoter call — not run on the success path.
+                                let maxTransferableNote = '';
+                                if (depositUsd < maxUsd) {
+                                    const maxNativeAmountETH = (maxUsd * BigInt(1e18) + (ethPrice - BigInt(1))) / ethPrice + BigInt(1);
+                                    const maxPredictedUPC = yield (0, gas_calculator_1.estimateDepositFromLockedNative)(ctx, maxNativeAmountETH, originPrc20);
+                                    if (maxPredictedUPC > BigInt(0)) {
+                                        const maxSafeUPC = (maxPredictedUPC * BigInt(90)) / BigInt(100);
+                                        const gasReserve = utils_1.Utils.helpers.parseUnits('0.01', 18);
+                                        const maxFromDeposit = maxSafeUPC > gasReserve ? maxSafeUPC - gasReserve : BigInt(0);
+                                        const maxTransferable = funds + maxFromDeposit;
+                                        maxTransferableNote =
+                                            `Max transferable right now (at $1000 cap, pool-limited): ` +
+                                                `~${(Number(maxTransferable) / 1e18).toFixed(4)} $PC ` +
+                                                `(UEA balance ${(Number(funds) / 1e18).toFixed(4)} + ` +
+                                                `pool-safe deposit ${(Number(maxFromDeposit) / 1e18).toFixed(4)} − gas).`;
+                                        (0, context_1.printLog)(ctx, `Fee-lock capacity: ${maxTransferableNote}`);
+                                    }
+                                }
                                 throw new Error(`Insufficient deposit: the fee-lock will deposit ~${(Number(safeUPC) / 1e18).toFixed(4)} $PC ` +
                                     `but the transaction requires ~${(Number(requiredFunds) / 1e18).toFixed(4)} $PC ` +
                                     `(shortfall: ~${(Number(shortfall) / 1e18).toFixed(4)} $PC). ` +
-                                    `The fee-lock deposit is capped at $10 USD. Reduce the transfer value or ` +
-                                    `pre-fund the UEA (${UEA}) on Push Chain.`);
+                                    `The fee-lock deposit is capped at $1000 USD. ` +
+                                    (maxTransferableNote ? maxTransferableNote + ' ' : '') +
+                                    `Reduce the transfer value or pre-fund the UEA (${UEA}) on Push Chain.`);
                             }
                         }
                     }

package/src/lib/orchestrator/internals/gas-calculator.d.ts

@@ -45,3 +45,13 @@ export declare function calculateGasAmountFromAmountOutMinETH(ctx: OrchestratorC
  * Returns 0 on any failure (caller should fall back to other logic).
  */
 export declare function estimateDepositFromLockedNative(ctx: OrchestratorContext, nativeAmountForLocker: bigint, prc20Token: `0x${string}`): Promise<bigint>;
+/**
+ * Inverse of estimateDepositFromLockedNative: given a desired WPC output,
+ * asks the Push Chain Uniswap V3 pool how much native PRC-20 (pETH) input is
+ * required to produce exactly that output via QuoterV2.quoteExactOutputSingle.
+ *
+ * Used to size fee-lock deposits against the real on-chain pool rate instead
+ * of the fixed $0.10/PC SDK rate. Returns 0 on any failure (caller should
+ * fall back to the fixed-rate sizing).
+ */
+export declare function estimateNativeForDesiredDeposit(ctx: OrchestratorContext, desiredWpc: bigint, prc20Token: `0x${string}`): Promise<bigint>;

package/src/lib/orchestrator/internals/gas-calculator.js

@@ -11,6 +11,7 @@ exports.queryRescueGasFee = queryRescueGasFee;
 exports.calculateNativeAmountForDeposit = calculateNativeAmountForDeposit;
 exports.calculateGasAmountFromAmountOutMinETH = calculateGasAmountFromAmountOutMinETH;
 exports.estimateDepositFromLockedNative = estimateDepositFromLockedNative;
+exports.estimateNativeForDesiredDeposit = estimateNativeForDesiredDeposit;
 const tslib_1 = require("tslib");
 const web3_js_1 = require("@solana/web3.js");
 const viem_1 = require("viem");
@@ -336,13 +337,13 @@ function calculateNativeAmountForDeposit(ctx, chain, requiredFunds, ueaBalance)
         var _a, _b;
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_02_01);
         const oneUsd = utils_1.Utils.helpers.parseUnits('1', 8);
-        const tenUsd = utils_1.Utils.helpers.parseUnits('10', 8);
+        const maxUsd = utils_1.Utils.helpers.parseUnits('1000', 8);
         const deficit = requiredFunds > ueaBalance ? requiredFunds - ueaBalance : BigInt(0);
         let depositUsd = deficit > BigInt(0) ? ctx.pushClient.pushToUSDC(deficit) : oneUsd;
         if (depositUsd < oneUsd)
             depositUsd = oneUsd;
-        if (depositUsd > tenUsd)
-            throw new Error('Deposit value exceeds max $10 worth of native token');
+        if (depositUsd > maxUsd)
+            throw new Error('Deposit value exceeds max $1000 worth of native token');
         if (chain_1.CHAIN_INFO[chain].vm === enums_1.VM.SVM) {
             const svmClient = new svm_client_1.SvmClient({
                 rpcUrls: ctx.rpcUrls[enums_1.CHAIN.SOLANA_DEVNET] ||
@@ -515,4 +516,95 @@ function estimateDepositFromLockedNative(ctx, nativeAmountForLocker, prc20Token)
         }
     });
 }
+/**
+ * Inverse of estimateDepositFromLockedNative: given a desired WPC output,
+ * asks the Push Chain Uniswap V3 pool how much native PRC-20 (pETH) input is
+ * required to produce exactly that output via QuoterV2.quoteExactOutputSingle.
+ *
+ * Used to size fee-lock deposits against the real on-chain pool rate instead
+ * of the fixed $0.10/PC SDK rate. Returns 0 on any failure (caller should
+ * fall back to the fixed-rate sizing).
+ */
+function estimateNativeForDesiredDeposit(ctx, desiredWpc, prc20Token) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        try {
+            if (desiredWpc <= BigInt(0))
+                return BigInt(0);
+            const pushChain = (0, helpers_1.getPushChainForNetwork)(ctx.pushNetwork);
+            const quoterAddress = (_b = (_a = chain_1.CHAIN_INFO[pushChain]) === null || _a === void 0 ? void 0 : _a.dex) === null || _b === void 0 ? void 0 : _b.uniV3QuoterV2;
+            if (!quoterAddress || quoterAddress.startsWith('0xTBD'))
+                return BigInt(0);
+            const gatewayPcAddress = (0, helpers_1.getUniversalGatewayPCAddress)();
+            const universalCoreAddress = yield ctx.pushClient.readContract({
+                address: gatewayPcAddress,
+                abi: abi_1.UNIVERSAL_GATEWAY_PC,
+                functionName: 'UNIVERSAL_CORE',
+                args: [],
+            });
+            const [wpcAddress, feeTier] = yield Promise.all([
+                ctx.pushClient.readContract({
+                    address: universalCoreAddress,
+                    abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                    functionName: 'WPC',
+                    args: [],
+                }),
+                ctx.pushClient.readContract({
+                    address: universalCoreAddress,
+                    abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                    functionName: 'defaultFeeTier',
+                    args: [prc20Token],
+                }),
+            ]);
+            if (!feeTier || !wpcAddress)
+                return BigInt(0);
+            const QUOTER_ABI = [
+                {
+                    type: 'function',
+                    name: 'quoteExactOutputSingle',
+                    inputs: [
+                        {
+                            type: 'tuple',
+                            components: [
+                                { name: 'tokenIn', type: 'address' },
+                                { name: 'tokenOut', type: 'address' },
+                                { name: 'amount', type: 'uint256' },
+                                { name: 'fee', type: 'uint24' },
+                                { name: 'sqrtPriceLimitX96', type: 'uint160' },
+                            ],
+                        },
+                    ],
+                    outputs: [
+                        { name: 'amountIn', type: 'uint256' },
+                        { name: 'sqrtPriceX96After', type: 'uint160' },
+                        { name: 'initializedTicksCrossed', type: 'uint32' },
+                        { name: 'gasEstimate', type: 'uint256' },
+                    ],
+                    stateMutability: 'view',
+                },
+            ];
+            const result = yield ctx.pushClient.readContract({
+                address: quoterAddress,
+                abi: QUOTER_ABI,
+                functionName: 'quoteExactOutputSingle',
+                args: [
+                    {
+                        tokenIn: prc20Token,
+                        tokenOut: wpcAddress,
+                        amount: desiredWpc,
+                        fee: feeTier,
+                        sqrtPriceLimitX96: BigInt(0),
+                    },
+                ],
+            });
+            const amountIn = result[0];
+            (0, context_1.printLog)(ctx, `estimateNativeForDesiredDeposit — quote: ${desiredWpc.toString()} WPC ← ${amountIn.toString()} pETH (fee tier: ${feeTier})`);
+            return amountIn;
+        }
+        catch (err) {
+            (0, context_1.printLog)(ctx, `estimateNativeForDesiredDeposit — failed: ${err instanceof Error ? err.message : String(err)}`);
+            return BigInt(0);
+        }
+    });
+}
 //# sourceMappingURL=gas-calculator.js.map

package/src/lib/orchestrator/internals/gateway-client.js

@@ -96,10 +96,10 @@ req) {
                 const nativeTokenUsdPrice = yield new price_fetch_1.PriceFetch(ctx.rpcUrls).getPrice(chain);
                 const nativeDecimals = 18;
                 const oneUsd = utils_1.Utils.helpers.parseUnits('1', 8);
-                const tenUsd = utils_1.Utils.helpers.parseUnits('10', 8);
+                const maxUsd = utils_1.Utils.helpers.parseUnits('1000', 8);
                 let depositUsd = amount < oneUsd ? oneUsd : amount;
-                if (depositUsd > tenUsd)
-                    depositUsd = tenUsd;
+                if (depositUsd > maxUsd)
+                    depositUsd = maxUsd;
                 let nativeAmount = (depositUsd * BigInt(Math.pow(10, nativeDecimals)) +
                     (nativeTokenUsdPrice - BigInt(1))) /
                     nativeTokenUsdPrice;
@@ -114,10 +114,10 @@ req) {
                 ]);
                 const nativeDecimals = 9;
                 const oneUsd = utils_1.Utils.helpers.parseUnits('1', 8);
-                const tenUsd = utils_1.Utils.helpers.parseUnits('10', 8);
+                const maxUsd = utils_1.Utils.helpers.parseUnits('1000', 8);
                 let depositUsd = amount < oneUsd ? oneUsd : amount;
-                if (depositUsd > tenUsd)
-                    depositUsd = tenUsd;
+                if (depositUsd > maxUsd)
+                    depositUsd = maxUsd;
                 let nativeAmount = (depositUsd * BigInt(Math.pow(10, nativeDecimals)) +
                     (nativeTokenUsdPrice - BigInt(1))) /
                     nativeTokenUsdPrice;

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

@@ -35,6 +35,7 @@ const utils_1 = require("../../utils");
 const price_fetch_1 = require("../../price-fetch/price-fetch");
 const route_detector_1 = require("../route-detector");
 const cea_utils_1 = require("../cea-utils");
+const build_payload_1 = require("../svm-idl/build-payload");
 const payload_builders_1 = require("../payload-builders");
 const selectors_1 = require("../../constants/selectors");
 const erc20_evm_1 = require("../../constants/abi/erc20.evm");
@@ -393,22 +394,15 @@ function executeUoaToCeaSvm(ctx, params, target, executeFn) {
         const targetChain = target.chain;
         const targetAddress = target.address; // 0x-prefixed, 32 bytes
         const ueaAddress = (0, uea_manager_1.computeUEAOffchain)(ctx);
-        const hasSvmExecute = !!params.svmExecute;
+        const { svmPayload, targetBytes, hasExecute: hasSvmExecute, } = (0, build_payload_1.buildSvmPayloadFromParams)({
+            data: params.data,
+            to: target,
+            senderUea: ueaAddress,
+        });
         (0, context_1.printLog)(ctx, `executeUoaToCeaSvm — target: ${targetAddress}, chain: ${targetChain}, ` +
             `hasSvmExecute: ${hasSvmExecute}, value: ${(_b = (_a = params.value) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : '0'}`);
-        // --- Build SVM payload ---
-        let svmPayload = '0x'; // empty for withdraw (SOL/SPL)
         if (hasSvmExecute) {
-            // Execute case: encode the CPI payload
-            const exec = params.svmExecute;
-            svmPayload = (0, payload_builders_1.encodeSvmExecutePayload)({
-                targetProgram: exec.targetProgram,
-                accounts: exec.accounts,
-                ixData: exec.ixData,
-                instructionId: 2,
-            });
-            (0, context_1.printLog)(ctx, `executeUoaToCeaSvm — encoded execute payload: ${(svmPayload.length - 2) / 2} bytes, ` +
-                `${exec.accounts.length} accounts`);
+            (0, context_1.printLog)(ctx, `executeUoaToCeaSvm — encoded execute payload: ${(svmPayload.length - 2) / 2} bytes`);
         }
         // --- Determine PRC-20 token and burn amount ---
         let prc20Token = selectors_1.ZERO_ADDRESS;
@@ -439,13 +433,8 @@ function executeUoaToCeaSvm(ctx, params, target, executeFn) {
             burnAmount = BigInt(0);
             (0, context_1.printLog)(ctx, `executeUoaToCeaSvm — EXECUTE-only: using PRC-20 ${prc20Token} with zero burn amount`);
         }
-        // --- Determine target bytes ---
-        // For withdraw: target is the Solana recipient pubkey
-        // For execute: target is the target Solana program
-        const targetBytes = hasSvmExecute
-            ? params.svmExecute.targetProgram
-            : targetAddress;
         // --- Build outbound request ---
+        // targetBytes: for execute = program id (resolver output); for withdraw = to.address
         const outboundReq = (0, payload_builders_1.buildOutboundRequest)(targetBytes, prc20Token, burnAmount, (_d = params.gasLimit) !== null && _d !== void 0 ? _d : BigInt(0), svmPayload, ueaAddress // revert recipient is the UEA
         );
         (0, context_1.printLog)(ctx, `executeUoaToCeaSvm — outbound request: ${JSON.stringify({
@@ -972,7 +961,7 @@ function executeCeaToCea(ctx, params, executeFn) {
  */
 function buildPayloadForRoute(ctx, params, route, nonce) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         const ueaAddress = (0, uea_manager_1.computeUEAOffchain)(ctx);
         switch (route) {
             case route_detector_1.TransactionRoute.UOA_TO_PUSH: {
@@ -995,20 +984,15 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                 const target = params.to;
                 // Branch: SVM vs EVM
                 if ((0, payload_builders_1.isSvmChain)(target.chain)) {
-                    // SVM: build SVM payload (binary or empty for withdraw)
-                    let payload = '0x';
-                    if (params.svmExecute) {
-                        payload = (0, payload_builders_1.encodeSvmExecutePayload)({
-                            targetProgram: params.svmExecute.targetProgram,
-                            accounts: params.svmExecute.accounts,
-                            ixData: params.svmExecute.ixData,
-                            instructionId: 2,
-                        });
-                    }
-                    const targetBytes = (_b = (_a = params.svmExecute) === null || _a === void 0 ? void 0 : _a.targetProgram) !== null && _b !== void 0 ? _b : target.address;
+                    // SVM: build SVM payload (binary or empty for withdraw) via IDL resolver
+                    const { svmPayload: payload, targetBytes, hasExecute, } = (0, build_payload_1.buildSvmPayloadFromParams)({
+                        data: params.data,
+                        to: target,
+                        senderUea: ueaAddress,
+                    });
                     let prc20Token = selectors_1.ZERO_ADDRESS;
                     let burnAmount = BigInt(0);
-                    if ((_c = params.funds) === null || _c === void 0 ? void 0 : _c.amount) {
+                    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);
@@ -1019,15 +1003,15 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                         prc20Token = (0, helpers_1.getNativePRC20ForChain)(target.chain, ctx.pushNetwork);
                         burnAmount = params.value;
                     }
-                    else if (params.svmExecute) {
+                    else if (hasExecute) {
                         prc20Token = (0, helpers_1.getNativePRC20ForChain)(target.chain, ctx.pushNetwork);
                         burnAmount = BigInt(1);
                     }
-                    const outboundReq = (0, payload_builders_1.buildOutboundRequest)(targetBytes, prc20Token, burnAmount, (_d = params.gasLimit) !== null && _d !== void 0 ? _d : BigInt(0), payload, ueaAddress);
+                    const outboundReq = (0, payload_builders_1.buildOutboundRequest)(targetBytes, prc20Token, burnAmount, (_b = params.gasLimit) !== null && _b !== void 0 ? _b : BigInt(0), payload, ueaAddress);
                     return { payload, gatewayRequest: outboundReq };
                 }
                 // EVM path: Resolve CEA address first (needed for self-transfer check)
-                const { cea: ceaAddress } = yield (0, cea_utils_1.getCEAAddress)(ueaAddress, target.chain, (_e = ctx.rpcUrls[target.chain]) === null || _e === void 0 ? void 0 : _e[0]);
+                const { cea: ceaAddress } = yield (0, cea_utils_1.getCEAAddress)(ueaAddress, target.chain, (_c = ctx.rpcUrls[target.chain]) === null || _c === void 0 ? void 0 : _c[0]);
                 // Build CEA outbound payload
                 const multicalls = [];
                 if (params.data) {
@@ -1060,7 +1044,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                 const payload = (0, payload_builders_1.buildCeaMulticallPayload)(multicalls);
                 let prc20Token = selectors_1.ZERO_ADDRESS;
                 let burnAmount = BigInt(0);
-                if ((_f = params.funds) === null || _f === void 0 ? void 0 : _f.amount) {
+                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);
@@ -1068,13 +1052,13 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                     }
                 }
                 const targetBytes = ceaAddress;
-                const outboundReq = (0, payload_builders_1.buildOutboundRequest)(targetBytes, prc20Token, burnAmount, (_g = params.gasLimit) !== null && _g !== void 0 ? _g : BigInt(0), payload, ueaAddress);
+                const outboundReq = (0, payload_builders_1.buildOutboundRequest)(targetBytes, prc20Token, burnAmount, (_e = params.gasLimit) !== null && _e !== void 0 ? _e : BigInt(0), payload, ueaAddress);
                 return { payload, gatewayRequest: outboundReq };
             }
             case route_detector_1.TransactionRoute.CEA_TO_PUSH: {
                 // Route 3: CEA -> Push Chain
                 // Build CEA multicall (approve + sendUniversalTxFromCEA) and wrap in outbound
-                if (!((_h = params.from) === null || _h === void 0 ? void 0 : _h.chain)) {
+                if (!((_f = params.from) === null || _f === void 0 ? void 0 : _f.chain)) {
                     throw new Error('Route 3 (CEA -> Push) requires from.chain');
                 }
                 const sourceChain = params.from.chain;
@@ -1089,7 +1073,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                     const gatewayProgramHex = ('0x' + Buffer.from(programPk.toBytes()).toString('hex'));
                     let drainAmount = BigInt(0);
                     let tokenMintHex;
-                    if (((_j = params.funds) === null || _j === void 0 ? void 0 : _j.amount) && params.funds.amount > BigInt(0)) {
+                    if (((_g = params.funds) === null || _g === void 0 ? void 0 : _g.amount) && params.funds.amount > BigInt(0)) {
                         drainAmount = params.funds.amount;
                         const token = params.funds.token;
                         if (token && token.address) {
@@ -1114,10 +1098,10 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                     });
                     // burnAmount = 1 (minimum for precompile; drain amount lives inside the ixData)
                     const burnAmount = BigInt(1);
-                    const outboundReq = (0, payload_builders_1.buildOutboundRequest)(gatewayProgramHex, prc20Token, burnAmount, (_k = params.gasLimit) !== null && _k !== void 0 ? _k : BigInt(0), svmPayload, ueaAddress);
+                    const outboundReq = (0, payload_builders_1.buildOutboundRequest)(gatewayProgramHex, prc20Token, burnAmount, (_h = params.gasLimit) !== null && _h !== void 0 ? _h : BigInt(0), svmPayload, ueaAddress);
                     return { payload: svmPayload, gatewayRequest: outboundReq };
                 }
-                const { cea: ceaAddress } = yield (0, cea_utils_1.getCEAAddress)(ueaAddress, sourceChain, (_l = ctx.rpcUrls[sourceChain]) === null || _l === void 0 ? void 0 : _l[0]);
+                const { cea: ceaAddress } = yield (0, cea_utils_1.getCEAAddress)(ueaAddress, sourceChain, (_j = ctx.rpcUrls[sourceChain]) === null || _j === void 0 ? void 0 : _j[0]);
                 // CEA auto-deploys on-chain: Vault.finalizeUniversalTx calls CEAFactory.deployCEA()
                 // if CEA doesn't exist yet. No SDK-side blocking needed.
                 const gatewayAddr = chain_1.UNIVERSAL_GATEWAY_ADDRESSES[sourceChain];
@@ -1128,7 +1112,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                 const ceaMulticalls = [];
                 let tokenAddress = selectors_1.ZERO_ADDRESS;
                 let amount = BigInt(0);
-                if ((_m = params.funds) === null || _m === void 0 ? void 0 : _m.amount) {
+                if ((_k = params.funds) === null || _k === void 0 ? void 0 : _k.amount) {
                     const token = params.funds.token;
                     if (token) {
                         if (token.mechanism === 'native') {
@@ -1192,7 +1176,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                 // Route 3: CEA uses its own pre-existing balance — no PRC-20 burn needed.
                 // burnAmount = 0 makes this a payload-only outbound relay.
                 const burnAmount = BigInt(0);
-                const outboundReq = (0, payload_builders_1.buildOutboundRequest)(ceaAddress, prc20Token, burnAmount, (_o = params.gasLimit) !== null && _o !== void 0 ? _o : BigInt(0), ceaPayload, ueaAddress);
+                const outboundReq = (0, payload_builders_1.buildOutboundRequest)(ceaAddress, prc20Token, burnAmount, (_l = params.gasLimit) !== null && _l !== void 0 ? _l : BigInt(0), ceaPayload, ueaAddress);
                 return { payload: ceaPayload, gatewayRequest: outboundReq };
             }
             default:

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

@@ -110,7 +110,7 @@ export type ExecuteParams = {
      * Internal: Minimum fee-locking deposit in USD (8 decimals).
      * Overrides the default $1 floor when the caller needs a larger deposit
      * (e.g., Route 2 needs enough UPC for the outbound swap).
-     * Still capped at $10 by lockFee.
+     * Still capped at $1000 by lockFee.
      * @internal
      */
     _minimumDepositUsd?: bigint;
@@ -291,16 +291,9 @@ export type UniversalExecuteParams = Omit<ExecuteParams, 'to'> & {
      * - ChainTarget: External chain target (Routes 2, 3, 4)
      */
     to: UniversalTo;
-    /**
-     * SVM-specific: CPI execution parameters for Solana targets (Route 2).
-     * When present, the outbound transaction will execute a Cross-Program Invocation
-     * on the specified Solana program with the given accounts and instruction data.
-     * Only applicable when `to.chain` is a Solana chain.
-     */
-    svmExecute?: SvmExecuteParams;
     /**
      * When true, sends MIGRATION_SELECTOR as raw CEA payload (no multicall wrapping).
-     * Used for CEA contract upgrades. Incompatible with value/funds/data/svmExecute.
+     * Used for CEA contract upgrades. Incompatible with value/funds/data.
      * Only applicable for Route 2 (UOA_TO_CEA) on EVM chains.
      */
     migration?: boolean;
@@ -329,18 +322,6 @@ export interface SvmExecutePayloadFields {
     /** Instruction ID: 2 = execute (default) */
     instructionId?: number;
 }
-/**
- * User-facing parameters for CPI execution on a Solana program via Route 2.
- * Passed as `svmExecute` in UniversalExecuteParams when targeting SVM chains.
- */
-export interface SvmExecuteParams {
-    /** Target Solana program to CPI into (32 bytes, 0x-prefixed hex) */
-    targetProgram: `0x${string}`;
-    /** Accounts required for the CPI call */
-    accounts: SvmGatewayAccountMeta[];
-    /** Raw instruction data for the target program */
-    ixData: Uint8Array;
-}
 /**
  * Request structure for sendUniversalTxOutbound on Push Chain
  * Used for Routes 2, 3, 4 (outbound from Push)

package/src/lib/orchestrator/route-detector.js

@@ -249,9 +249,6 @@ function validateRouteParams(params, context) {
         if (params.data) {
             throw new RouteValidationError('migration is incompatible with data');
         }
-        if (params.svmExecute) {
-            throw new RouteValidationError('migration is incompatible with svmExecute');
-        }
         if (isChainTarget(params.to) && (0, payload_builders_1.isSvmChain)(params.to.chain)) {
             throw new RouteValidationError('migration is not supported on SVM chains');
         }

package/src/lib/orchestrator/svm-idl/build-payload.d.ts

@@ -0,0 +1,11 @@
+import type { ChainTarget } from '../orchestrator.types';
+export interface SvmPayloadBundle {
+    svmPayload: `0x${string}`;
+    targetBytes: `0x${string}`;
+    hasExecute: boolean;
+}
+export declare function buildSvmPayloadFromParams(params: {
+    data?: `0x${string}` | unknown;
+    to: ChainTarget;
+    senderUea: `0x${string}`;
+}): SvmPayloadBundle;

package/src/lib/orchestrator/svm-idl/build-payload.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSvmPayloadFromParams = buildSvmPayloadFromParams;
+const viem_1 = require("viem");
+const payload_builders_1 = require("../payload-builders");
+const resolve_1 = require("./resolve");
+function buildSvmPayloadFromParams(params) {
+    const hasExecute = typeof params.data === 'string' &&
+        params.data.startsWith('0x') &&
+        params.data.length > 2;
+    if (!hasExecute) {
+        return {
+            svmPayload: '0x',
+            targetBytes: params.to.address,
+            hasExecute: false,
+        };
+    }
+    const resolved = (0, resolve_1.resolveSvmCall)({
+        programAddress: params.to.address,
+        data: (0, viem_1.hexToBytes)(params.data),
+        senderUea: params.senderUea,
+        targetChain: params.to.chain,
+    });
+    const svmPayload = (0, payload_builders_1.encodeSvmExecutePayload)({
+        targetProgram: resolved.targetProgram,
+        accounts: resolved.accounts,
+        ixData: resolved.ixData,
+        instructionId: 2,
+    });
+    return {
+        svmPayload,
+        targetBytes: resolved.targetProgram,
+        hasExecute: true,
+    };
+}
+//# sourceMappingURL=build-payload.js.map

package/src/lib/orchestrator/svm-idl/ix-encoder.d.ts

@@ -0,0 +1,3 @@
+import { type Idl } from '@coral-xyz/anchor';
+export declare function encodeAnchorIxData(idl: Idl, functionName: string, positionalArgs?: unknown[]): Uint8Array;
+export declare function isAnchorIdl(value: unknown): value is Idl;

package/src/lib/orchestrator/svm-idl/ix-encoder.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeAnchorIxData = encodeAnchorIxData;
+exports.isAnchorIdl = isAnchorIdl;
+const anchor_1 = require("@coral-xyz/anchor");
+const web3_js_1 = require("@solana/web3.js");
+const buffer_1 = require("buffer");
+function encodeAnchorIxData(idl, functionName, positionalArgs = []) {
+    var _a, _b;
+    const ix = findInstruction(idl, functionName);
+    if (!ix) {
+        throw new Error(`Instruction '${functionName}' not found in IDL '${(_b = (_a = idl.metadata) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : 'unknown'}'`);
+    }
+    if (positionalArgs.length !== ix.args.length) {
+        throw new Error(`Arg count mismatch for '${ix.name}': IDL expects ${ix.args.length}, got ${positionalArgs.length}`);
+    }
+    const named = {};
+    for (let i = 0; i < ix.args.length; i++) {
+        named[ix.args[i].name] = normalizeArg(positionalArgs[i], ix.args[i]);
+    }
+    const coder = new anchor_1.BorshInstructionCoder(idl);
+    return new Uint8Array(coder.encode(ix.name, named));
+}
+function findInstruction(idl, name) {
+    const snake = name.replace(/([A-Z])/g, (_, c) => '_' + c.toLowerCase());
+    const camel = name.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+    return idl.instructions.find((i) => i.name === name || i.name === snake || i.name === camel);
+}
+function normalizeArg(value, field) {
+    if (typeof value === 'bigint') {
+        return new anchor_1.BN(value.toString());
+    }
+    if (field.type === 'pubkey' &&
+        typeof value === 'string' &&
+        value.startsWith('0x') &&
+        value.length === 66) {
+        return new web3_js_1.PublicKey(buffer_1.Buffer.from(value.slice(2), 'hex'));
+    }
+    return value;
+}
+function isAnchorIdl(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const maybe = value;
+    return Array.isArray(maybe['instructions']) && typeof maybe['address'] === 'string';
+}
+//# sourceMappingURL=ix-encoder.js.map

package/src/lib/orchestrator/svm-idl/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Idl } from '@coral-xyz/anchor';
+type AddressKey = `0x${string}`;
+export declare function registerIdl(programAddress: string, idl: unknown): void;
+export declare function getIdl(programAddress: string): Idl | undefined;
+export declare function getRegisteredIdls(): Array<{
+    address: AddressKey;
+    idl: Idl;
+}>;
+export declare function clearRegistry(): void;
+export {};

package/src/lib/orchestrator/svm-idl/registry.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerIdl = registerIdl;
+exports.getIdl = getIdl;
+exports.getRegisteredIdls = getRegisteredIdls;
+exports.clearRegistry = clearRegistry;
+const ix_encoder_1 = require("./ix-encoder");
+const store = new Map();
+function normalizeKey(address) {
+    if (typeof address !== 'string' || !address.startsWith('0x')) {
+        throw new Error(`registerIdl: programAddress must be 0x-prefixed 32-byte hex, got '${address}'`);
+    }
+    const body = address.slice(2);
+    if (body.length !== 64 || !/^[0-9a-fA-F]+$/.test(body)) {
+        throw new Error(`registerIdl: programAddress must be 32 bytes (66 chars incl. 0x), got length ${address.length}`);
+    }
+    return ('0x' + body.toLowerCase());
+}
+function registerIdl(programAddress, idl) {
+    const key = normalizeKey(programAddress);
+    if (!(0, ix_encoder_1.isAnchorIdl)(idl)) {
+        throw new Error(`registerIdl: idl for ${programAddress} is not a recognized Anchor IDL (missing 'instructions' or 'address')`);
+    }
+    store.set(key, idl);
+}
+function getIdl(programAddress) {
+    const key = normalizeKey(programAddress);
+    return store.get(key);
+}
+function getRegisteredIdls() {
+    return Array.from(store.entries()).map(([address, idl]) => ({ address, idl }));
+}
+function clearRegistry() {
+    store.clear();
+}
+//# sourceMappingURL=registry.js.map

package/src/lib/orchestrator/svm-idl/resolve.d.ts

@@ -0,0 +1,14 @@
+import { CHAIN } from '../../constants/enums';
+import type { SvmGatewayAccountMeta } from '../orchestrator.types';
+export interface ResolveInput {
+    programAddress: `0x${string}`;
+    data: Uint8Array;
+    senderUea: `0x${string}`;
+    targetChain: CHAIN;
+}
+export interface ResolvedSvmCall {
+    targetProgram: `0x${string}`;
+    accounts: SvmGatewayAccountMeta[];
+    ixData: Uint8Array;
+}
+export declare function resolveSvmCall(input: ResolveInput): ResolvedSvmCall;

package/src/lib/orchestrator/svm-idl/resolve.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSvmCall = resolveSvmCall;
+const web3_js_1 = require("@solana/web3.js");
+const buffer_1 = require("buffer");
+const account_1 = require("../../universal/account/account");
+const registry_1 = require("./registry");
+const CEA_AUTHORITY_NAMES = new Set([
+    'cea_authority',
+    'ceaAuthority',
+    'cea',
+    'cea_signer',
+    'ceaSigner',
+]);
+function resolveSvmCall(input) {
+    var _a, _b;
+    const idl = (0, registry_1.getIdl)(input.programAddress);
+    if (!idl) {
+        throw new Error(`resolveSvmCall: no IDL registered for ${input.programAddress}. ` +
+            `Call PushChain.utils.svm.registerIdl(${input.programAddress}, idl) first.`);
+    }
+    if (input.data.length < 8) {
+        throw new Error('resolveSvmCall: data must be at least 8 bytes (Anchor discriminator)');
+    }
+    const disc = input.data.slice(0, 8);
+    const ix = idl.instructions.find((i) => buffer_1.Buffer.from(i.discriminator).equals(buffer_1.Buffer.from(disc)));
+    if (!ix) {
+        throw new Error(`resolveSvmCall: no instruction in IDL '${(_b = (_a = idl.metadata) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : idl.address}' matches discriminator [${Array.from(disc).join(',')}]`);
+    }
+    const programPk = new web3_js_1.PublicKey(buffer_1.Buffer.from(input.programAddress.slice(2), 'hex'));
+    const { address: ceaPdaHex } = (0, account_1.deriveSvmCeaPda)(input.senderUea, input.targetChain, true);
+    const accounts = [];
+    for (const item of ix.accounts) {
+        if ('accounts' in item) {
+            throw new Error(`resolveSvmCall: nested account group '${item.name}' in '${ix.name}' not supported`);
+        }
+        const flat = item;
+        const pubkey = resolveAccountPubkey(flat, programPk, ceaPdaHex, ix.name);
+        accounts.push({ pubkey, isWritable: Boolean(flat.writable) });
+    }
+    return {
+        targetProgram: input.programAddress,
+        accounts,
+        ixData: input.data,
+    };
+}
+function resolveAccountPubkey(spec, programPk, ceaPdaHex, ixName) {
+    if (spec.address) {
+        return pkToHex(new web3_js_1.PublicKey(spec.address));
+    }
+    if (spec.pda) {
+        const seeds = resolveConstSeeds(spec.pda.seeds, spec.name, ixName);
+        const programForPda = spec.pda.program
+            ? new web3_js_1.PublicKey(resolveConstSeedValue(spec.pda.program, spec.name, ixName))
+            : programPk;
+        const [pda] = web3_js_1.PublicKey.findProgramAddressSync(seeds, programForPda);
+        return pkToHex(pda);
+    }
+    if (CEA_AUTHORITY_NAMES.has(spec.name)) {
+        return ceaPdaHex;
+    }
+    throw new Error(`resolveSvmCall: cannot resolve account '${spec.name}' in '${ixName}'. ` +
+        `Add 'address' or 'pda.seeds' to the IDL, or rename to a CEA convention (cea_authority).`);
+}
+function resolveConstSeeds(seeds, accountName, ixName) {
+    return seeds.map((seed, idx) => {
+        if (seed.kind !== 'const') {
+            throw new Error(`resolveSvmCall: non-const PDA seed (kind='${seed.kind}') on account '${accountName}' in '${ixName}' not supported yet`);
+        }
+        if (!Array.isArray(seed.value)) {
+            throw new Error(`resolveSvmCall: const seed at index ${idx} on '${accountName}' is malformed`);
+        }
+        return buffer_1.Buffer.from(seed.value);
+    });
+}
+function resolveConstSeedValue(seed, accountName, ixName) {
+    if (seed.kind !== 'const' || !Array.isArray(seed.value)) {
+        throw new Error(`resolveSvmCall: only const program-seed supported on '${accountName}' in '${ixName}'`);
+    }
+    return buffer_1.Buffer.from(seed.value);
+}
+function pkToHex(pk) {
+    return ('0x' + buffer_1.Buffer.from(pk.toBytes()).toString('hex'));
+}
+//# sourceMappingURL=resolve.js.map

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

@@ -396,15 +396,25 @@ class PushChain {
              */
             validatedUniversalSigner, (_c = options === null || options === void 0 ? void 0 : options.network) !== null && _c !== void 0 ? _c : enums_1.PUSH_NETWORK.TESTNET_DONUT, (_d = options === null || options === void 0 ? void 0 : options.rpcUrls) !== null && _d !== void 0 ? _d : {}, (_e = options === null || options === void 0 ? void 0 : options.printTraces) !== null && _e !== void 0 ? _e : false, options === null || options === void 0 ? void 0 : options.progressHook);
             const instance = new _a(orchestrator, validatedUniversalSigner, blockExplorers, isReadOnly);
-            // Background fetch account status (non-blocking, 30s timeout)
-            // Stored on instance so consumers can await it if needed: await client.accountStatusReady
+            // Background fetch account status (non-blocking, 30s timeout).
+            // The timer must be cleared once the race settles — otherwise the
+            // unref'd setTimeout keeps the Node event loop alive for the full
+            // 30s after the caller's work is done, making scripts appear "stuck".
             const ACCOUNT_STATUS_TIMEOUT = 30000;
+            let accountStatusTimer;
             instance.accountStatusReady = Promise.race([
                 // eslint-disable-next-line @typescript-eslint/no-empty-function
                 instance.getAccountStatus().then(() => { }),
-                new Promise((_, reject) => setTimeout(() => reject(new Error('Account status fetch timed out')), ACCOUNT_STATUS_TIMEOUT)),
-            ]).catch(() => {
+                new Promise((_, reject) => {
+                    accountStatusTimer = setTimeout(() => reject(new Error('Account status fetch timed out')), ACCOUNT_STATUS_TIMEOUT);
+                }),
+            ])
+                .catch(() => {
                 // Silently ignore — lazy check in execute() will retry if needed
+            })
+                .finally(() => {
+                if (accountStatusTimer)
+                    clearTimeout(accountStatusTimer);
             });
             // Let execute() await the background fetch instead of re-fetching
             orchestrator.accountStatusReadyPromise = instance.accountStatusReady;

package/src/lib/universal/account/account.d.ts

@@ -68,6 +68,19 @@ export declare function convertExecutorToOrigin(executorAddress: string, options
     /** @internal Skip deprecation warning for SDK-internal calls */
     _internal?: boolean;
 }): Promise<OriginAccountInfo>;
+/**
+ * Derive the SVM CEA (PDA) for a UEA address on a Solana-based chain.
+ *
+ * Solana doesn't use a CEAFactory contract — instead, the CEA is a
+ * Program Derived Address (PDA) with seeds: ["push_identity", ueaBytes]
+ * and the SVM gateway program as the program ID.
+ *
+ * @param ueaAddress - The UEA (or Push EOA) hex address (20 bytes).
+ * @param targetChain - The SVM target chain.
+ * @param skipNetworkCheck - Whether to skip deployment status check.
+ * @returns The derived 32-byte Solana PDA address (as 0x-prefixed hex) and deployment status.
+ */
+export declare function deriveSvmCeaPda(ueaAddress: `0x${string}`, targetChain: CHAIN, skipNetworkCheck: boolean): DerivedExecutorAccount;
 /**
  * Derive the executor account (UEA or CEA) for a given account.
  *

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

@@ -6,6 +6,7 @@ exports.fromChainAgnostic = fromChainAgnostic;
 exports.convertOriginToExecutor = convertOriginToExecutor;
 exports.convertExecutorToOriginAccount = convertExecutorToOriginAccount;
 exports.convertExecutorToOrigin = convertExecutorToOrigin;
+exports.deriveSvmCeaPda = deriveSvmCeaPda;
 exports.deriveExecutorAccount = deriveExecutorAccount;
 exports.resolveControllerAccount = resolveControllerAccount;
 const tslib_1 = require("tslib");

package/src/lib/utils.d.ts

@@ -3,6 +3,7 @@ import { construct, toUniversal as toUniversalSigner, toUniversalFromKeypair } f
 import { CHAIN, PUSH_NETWORK } from './constants/enums';
 import { type MoveableToken } from './constants/tokens';
 import type { PushChain } from './push-chain/push-chain';
+import { registerIdl as registerSvmIdl, getRegisteredIdls as getRegisteredSvmIdls, getIdl as getSvmIdl } from './orchestrator/svm-idl/registry';
 /**
  * @dev - THESE UTILS ARE EXPORTED TO SDK CONSUMER
  * @dev - Make sure each exported fn has good comments to help out sdk consumer
@@ -32,6 +33,24 @@ export declare class Utils {
         deriveExecutorAccount: typeof deriveExecutorAccount;
         resolveControllerAccount: typeof resolveControllerAccount;
     };
+    /**
+     * SVM (Solana) utilities for registering program Anchor IDLs.
+     *
+     * Register your program's Anchor IDL once per process; `prepareTransaction`
+     * then resolves accounts, PDAs, and signers from the IDL so you only need
+     * to pass `data` (discriminator + Borsh args), the same shape used for EVM.
+     *
+     * @example
+     * PushChain.utils.svm.registerIdl(
+     *   PROGRAM_ADDRESS_HEX,
+     *   testCounterIdl
+     * );
+     */
+    static svm: {
+        registerIdl: typeof registerSvmIdl;
+        getRegisteredIdls: typeof getRegisteredSvmIdls;
+        getIdl: typeof getSvmIdl;
+    };
     static signer: {
         /**
          * Converts various signer types (viem, ethers v6, Solana) into a UniversalSigner.
@@ -98,7 +117,7 @@ export declare class Utils {
          */
         getChainName: (chainName: string) => string | undefined;
         encodeTxData({ abi, functionName, args, }: {
-            abi: any[];
+            abi: any;
             functionName: string;
             args?: any[];
         }): `0x${string}`;

package/src/lib/utils.js

@@ -7,6 +7,9 @@ const enums_1 = require("./constants/enums");
 const tokens_1 = require("./constants/tokens");
 const chain_1 = require("./constants/chain");
 const viem_1 = require("viem");
+const buffer_1 = require("buffer");
+const ix_encoder_1 = require("./orchestrator/svm-idl/ix-encoder");
+const registry_1 = require("./orchestrator/svm-idl/registry");
 /**
  * @dev - THESE UTILS ARE EXPORTED TO SDK CONSUMER
  * @dev - Make sure each exported fn has good comments to help out sdk consumer
@@ -74,6 +77,24 @@ Utils.account = {
     deriveExecutorAccount: account_1.deriveExecutorAccount,
     resolveControllerAccount: account_1.resolveControllerAccount,
 };
+/**
+ * SVM (Solana) utilities for registering program Anchor IDLs.
+ *
+ * Register your program's Anchor IDL once per process; `prepareTransaction`
+ * then resolves accounts, PDAs, and signers from the IDL so you only need
+ * to pass `data` (discriminator + Borsh args), the same shape used for EVM.
+ *
+ * @example
+ * PushChain.utils.svm.registerIdl(
+ *   PROGRAM_ADDRESS_HEX,
+ *   testCounterIdl
+ * );
+ */
+Utils.svm = {
+    registerIdl: registry_1.registerIdl,
+    getRegisteredIdls: registry_1.getRegisteredIdls,
+    getIdl: registry_1.getIdl,
+};
 Utils.signer = {
     /**
      * Converts various signer types (viem, ethers v6, Solana) into a UniversalSigner.
@@ -207,6 +228,13 @@ Utils.helpers = {
         };
     })(),
     encodeTxData({ abi, functionName, args = [], }) {
+        if ((0, ix_encoder_1.isAnchorIdl)(abi)) {
+            if (!Array.isArray(args)) {
+                throw new Error('Arguments must be an array');
+            }
+            const bytes = (0, ix_encoder_1.encodeAnchorIxData)(abi, functionName, args);
+            return `0x${buffer_1.Buffer.from(bytes).toString('hex')}`;
+        }
         // Validate inputs
         if (!Array.isArray(abi)) {
             throw new Error('ABI must be an array');