@pushchain/core 5.1.4 → 5.1.5-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "5.1.4",
+  "version": "5.1.5-alpha.1",
   "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,9 @@ 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");
+const progress_hook_types_1 = require("../../progress-hook/progress-hook.types");
+const progress_hook_1 = tslib_1.__importDefault(require("../../progress-hook/progress-hook"));
 // ============================================================================
 // prepareTransaction
 // ============================================================================
@@ -110,18 +113,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 +429,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 +462,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 +478,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 +503,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 +539,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 +568,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 +594,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 +641,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 ||
@@ -781,8 +777,8 @@ function createCascadedBuilder(ctx, preparedTxs, callbacks) {
                 hops: hopInfos,
                 hopCount: hops.length,
                 waitForAll: (opts) => tslib_1.__awaiter(this, void 0, void 0, function* () {
-                    var _a;
-                    const { pollingIntervalMs = 10000, timeout = 300000, progressHook: cascadeProgressHook, } = opts || {};
+                    var _a, _b;
+                    const { pollingIntervalMs = 10000, timeout = 300000, progressHook: cascadeProgressHook, eventHook, } = opts || {};
                     const startTime = Date.now();
                     try {
                         // 1. Wait for initial Push Chain tx confirmation
@@ -847,12 +843,14 @@ function createCascadedBuilder(ctx, preparedTxs, callbacks) {
                                         status: 'timeout',
                                         elapsed: Date.now() - startTime,
                                     });
+                                    eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_04](Date.now() - startTime));
                                     return {
                                         success: false,
                                         hops: hopInfos,
                                         failedAt: hop.hopIndex,
                                     };
                                 }
+                                eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_08_01](hop.executionChain));
                                 cascadeProgressHook === null || cascadeProgressHook === void 0 ? void 0 : cascadeProgressHook({
                                     hopIndex: hop.hopIndex,
                                     route: hop.route,
@@ -860,6 +858,7 @@ function createCascadedBuilder(ctx, preparedTxs, callbacks) {
                                     status: 'polling',
                                     elapsed: Date.now() - startTime,
                                 });
+                                let lastEmittedStatus;
                                 try {
                                     const outboundDetails = yield callbacks.waitForOutboundTxFn(response.hash, {
                                         initialWaitMs: Math.min(60000, remainingTimeout),
@@ -873,11 +872,17 @@ function createCascadedBuilder(ctx, preparedTxs, callbacks) {
                                                 status: event.status,
                                                 elapsed: Date.now() - startTime,
                                             });
+                                            if (event.status === 'polling' &&
+                                                lastEmittedStatus !== 'polling') {
+                                                lastEmittedStatus = 'polling';
+                                                eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_08_02](event.elapsed));
+                                            }
                                         },
                                     });
                                     hop.status = 'confirmed';
                                     hop.txHash = outboundDetails.externalTxHash;
                                     hop.outboundDetails = outboundDetails;
+                                    eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_03](outboundDetails));
                                     cascadeProgressHook === null || cascadeProgressHook === void 0 ? void 0 : cascadeProgressHook({
                                         hopIndex: hop.hopIndex,
                                         route: hop.route,
@@ -888,6 +893,11 @@ function createCascadedBuilder(ctx, preparedTxs, callbacks) {
                                     });
                                 }
                                 catch (err) {
+                                    const errMsg = err instanceof Error ? err.message : String(err);
+                                    const isTimeout = errMsg.startsWith('Timeout waiting for outbound transaction');
+                                    eventHook === null || eventHook === void 0 ? void 0 : eventHook(isTimeout
+                                        ? progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_04](remainingTimeout)
+                                        : progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_05](errMsg));
                                     hop.status = 'failed';
                                     cascadeProgressHook === null || cascadeProgressHook === void 0 ? void 0 : cascadeProgressHook({
                                         hopIndex: hop.hopIndex,
@@ -905,6 +915,13 @@ function createCascadedBuilder(ctx, preparedTxs, callbacks) {
                             }
                             else {
                                 // Multiple outbound hops: use V2 API which returns outboundTx[]
+                                // Emit "Awaiting External Chain" once per outbound hop before
+                                // polling begins.
+                                for (const outHop of outboundHops) {
+                                    eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_08_01](outHop.executionChain));
+                                }
+                                const perHopLastStatus = new Map();
+                                const confirmedHops = new Set();
                                 const allOutboundDetails = yield callbacks.waitForAllOutboundTxsFn(response.hash, outboundHops, {
                                     initialWaitMs: Math.min(60000, timeout - (Date.now() - startTime)),
                                     pollingIntervalMs,
@@ -918,13 +935,39 @@ function createCascadedBuilder(ctx, preparedTxs, callbacks) {
                                             txHash: event.txHash,
                                             elapsed: Date.now() - startTime,
                                         });
+                                        const prev = perHopLastStatus.get(event.hopIndex);
+                                        if (event.status === 'polling' &&
+                                            prev !== 'polling') {
+                                            perHopLastStatus.set(event.hopIndex, 'polling');
+                                            eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_08_02](Date.now() - startTime));
+                                        }
+                                        if (event.status === 'confirmed' &&
+                                            event.txHash &&
+                                            !confirmedHops.has(event.hopIndex)) {
+                                            // waitForAllOutboundTxsV2 populates hop.outboundDetails
+                                            // on the matched hop before emitting 'confirmed' (see
+                                            // outbound-sync.ts:348-355). Auto-promotion paths
+                                            // without a txHash are skipped by the `event.txHash`
+                                            // guard above, so we only reach here with full details.
+                                            const matchedHop = outboundHops.find((h) => h.hopIndex === event.hopIndex);
+                                            if (matchedHop === null || matchedHop === void 0 ? void 0 : matchedHop.outboundDetails) {
+                                                confirmedHops.add(event.hopIndex);
+                                                eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_03](matchedHop.outboundDetails));
+                                            }
+                                        }
                                     },
                                 });
                                 if (!allOutboundDetails.success) {
+                                    const failedIdx = (_b = allOutboundDetails.failedAt) !== null && _b !== void 0 ? _b : 0;
+                                    const failedHop = outboundHops.find((h) => h.hopIndex === failedIdx);
+                                    const failMsg = failedHop
+                                        ? `Outbound failed for hop ${failedIdx} on ${failedHop.executionChain}`
+                                        : `Outbound cascade failed at hop ${failedIdx}`;
+                                    eventHook === null || eventHook === void 0 ? void 0 : eventHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_05](failMsg));
                                     return {
                                         success: false,
                                         hops: hopInfos,
-                                        failedAt: allOutboundDetails.failedAt,
+                                        failedAt: failedIdx,
                                     };
                                 }
                             }

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/response-builder.js

@@ -16,6 +16,8 @@ const viem_1 = require("viem");
 const uea_evm_1 = require("../../constants/abi/uea.evm");
 const chain_1 = require("../../constants/chain");
 const enums_1 = require("../../constants/enums");
+const progress_hook_types_1 = require("../../progress-hook/progress-hook.types");
+const progress_hook_1 = tslib_1.__importDefault(require("../../progress-hook/progress-hook"));
 const account_1 = require("../../universal/account/account");
 const push_client_1 = require("../../push-client/push-client");
 const route_detector_1 = require("../route-detector");
@@ -472,19 +474,40 @@ function transformToUniversalTxResponse(ctx_1, tx_1) {
                     ? (0, route_detector_1.getRouteInfo)(universalTxResponse.route)
                     : undefined;
                 if (routeInfo === null || routeInfo === void 0 ? void 0 : routeInfo.isOutbound) {
+                    // Response-level only — NOT routed through ctx.progressHook because
+                    // the default ui-kit toast lacks icon/hide-timer handling for these
+                    // events. A follow-up ui-kit PR will add handling and can route
+                    // through both hooks.
+                    registeredProgressHook === null || registeredProgressHook === void 0 ? void 0 : registeredProgressHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_08_01]());
+                    let lastEmittedStatus;
+                    const outboundTranslator = (event) => {
+                        if (!registeredProgressHook)
+                            return;
+                        if (event.status === 'polling' && lastEmittedStatus !== 'polling') {
+                            lastEmittedStatus = 'polling';
+                            registeredProgressHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_08_02](event.elapsed));
+                        }
+                    };
                     try {
                         const outboundDetails = yield callbacks.waitForOutboundTx(tx.hash, {
                             initialWaitMs: callbacks.outboundConstants.initialWaitMs,
                             pollingIntervalMs: callbacks.outboundConstants.pollingIntervalMs,
                             timeout: callbacks.outboundConstants.maxTimeoutMs,
+                            progressHook: outboundTranslator,
                         });
+                        registeredProgressHook === null || registeredProgressHook === void 0 ? void 0 : registeredProgressHook(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_03](outboundDetails));
                         // Merge external chain details into receipt
                         baseReceipt = Object.assign(Object.assign({}, baseReceipt), { externalTxHash: outboundDetails.externalTxHash, externalChain: outboundDetails.destinationChain, externalExplorerUrl: outboundDetails.explorerUrl, externalRecipient: outboundDetails.recipient, externalAmount: outboundDetails.amount, externalAssetAddr: outboundDetails.assetAddr });
                     }
                     catch (error) {
+                        const errMsg = error instanceof Error ? error.message : String(error);
+                        const isTimeout = errMsg.startsWith('Timeout waiting for outbound transaction');
+                        registeredProgressHook === null || registeredProgressHook === void 0 ? void 0 : registeredProgressHook(isTimeout
+                            ? progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_04](callbacks.outboundConstants.maxTimeoutMs)
+                            : progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_05](errMsg));
                         // Outbound polling timed out - return partial receipt (don't throw)
                         // Push Chain tx succeeded, external tracking can be retried later
-                        callbacks.printLog(`[wait] External chain tracking failed: ${error instanceof Error ? error.message : String(error)}`);
+                        callbacks.printLog(`[wait] External chain tracking failed: ${errMsg}`);
                     }
                 }
                 return baseReceipt;