@pushchain/core 5.1.5 → 5.1.7

package/CHANGELOG.md

@@ -4,8 +4,10 @@
   Push-chain gas cost. Case A pads deposits to the $1 floor; Case B passes
   through; Case C is informational (deposits proceed up to the origin
   gateway's contract-enforced `MAX_CAP_UNIVERSAL_TX_USD`). The SDK's previous
-  $1000 ceiling has been removed. New progress hooks `SEND_TX_106_07_01/02/03`
-  fire with the sizer's decision.
+  $1000 ceiling has been removed. New progress hooks `SEND_TX_103_03_01/02/03`
+  fire with the sizer's decision, under the new `SEND_TX_103_03` "Calculating
+  Prepaid Deposit" parent and `SEND_TX_103_03_04` "Prepaid Deposit Estimated"
+  terminal (which replaces the prior `SEND_TX_102_02` "Gas Estimated").
 
 - Gas abstraction scope narrowed to R1 (fee-lock USD caps) and R3 (outbound
   msg.value sizing). R2 (UOA → CEA) and cascade outbound segments no longer

package/package.json

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

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

@@ -55,9 +55,13 @@ function printLog(ctx, msg) {
 const R1_SUPPRESSED_IN_NON_R1 = new Set([
     progress_hook_types_1.PROGRESS_HOOK.SEND_TX_101,
     progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_01,
-    progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02,
     progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_01,
     progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_02,
+    progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03,
+    progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_01,
+    progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_02,
+    progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_03,
+    progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04,
     progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_01,
     progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_02,
     progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_03,

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

@@ -74,6 +74,7 @@ function executeFundsWithPayload(ctx, execute, eventBuffer, getResponseCallbacks
         const requiredFunds = requiredGasFee + payloadValue;
         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_103_01);
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_02, ueaAddress, deployed);
         // SDK 5.2 Case A/B/C sizing on the Push-chain gas portion.
         // Floor pad comes from the sizer ($1 for Case A); upper bound now lives in
@@ -82,18 +83,33 @@ function executeFundsWithPayload(ctx, execute, eventBuffer, getResponseCallbacks
             pushGasFeeWei: requiredGasFee,
             originChain: chain,
         });
+        // Convert the sizer's USD result into planned PC native deposit so the
+        // sizer progress hook can surface the user-facing `extraDepositPC` =
+        // totalPCDeposit - gasRequired. The same conversion is reused below for
+        // the final nativeAmount calc (after SVM clamp).
+        const nativeTokenUsdPrice = yield new price_fetch_1.PriceFetch(ctx.rpcUrls).getPrice(chain);
+        const nativeDecimals = chain_1.CHAIN_INFO[chain].vm === enums_1.VM.SVM ? 9 : 18;
+        const oneNativeUnit = utils_1.Utils.helpers.parseUnits('1', nativeDecimals);
+        const usdToNative = (usd) => {
+            if (nativeTokenUsdPrice === BigInt(0))
+                return BigInt(0);
+            const out = (usd * oneNativeUnit + (nativeTokenUsdPrice - BigInt(1))) / nativeTokenUsdPrice;
+            return out + BigInt(1);
+        };
+        const plannedPCDeposit = usdToNative(r1Sizing.paddedDepositUsd);
+        const extraDepositPC = plannedPCDeposit > requiredGasFee ? plannedPCDeposit - requiredGasFee : BigInt(0);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03, chain, r1Sizing.paddedDepositUsd);
         const r1SizingHookId = {
-            A: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_01,
-            B: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_02,
-            C: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_03,
+            A: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_01,
+            B: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_02,
+            C: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_03,
         }[r1Sizing.category];
-        (0, context_1.fireProgressHook)(ctx, r1SizingHookId, chain, r1Sizing.pushGasUsd, r1Sizing.paddedDepositUsd);
+        (0, context_1.fireProgressHook)(ctx, r1SizingHookId, chain, requiredGasFee, extraDepositPC, r1Sizing.paddedDepositUsd);
         const deficit = requiredFunds > ueaBalance ? requiredFunds - ueaBalance : BigInt(0);
         let depositUsd = deficit > BigInt(0) ? ctx.pushClient.pushToUSDC(deficit) : BigInt(0);
         // Apply sizer floor: Case A pads to $1, Cases B/C pass-through.
         if (depositUsd < r1Sizing.paddedDepositUsd)
             depositUsd = r1Sizing.paddedDepositUsd;
-        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02, depositUsd);
         // If SVM, clamp depositUsd to on-chain Config caps
         if (chain_1.CHAIN_INFO[chain].vm === enums_1.VM.SVM) {
             const svmClient = new svm_client_1.SvmClient({
@@ -120,12 +136,9 @@ function executeFundsWithPayload(ctx, execute, eventBuffer, getResponseCallbacks
                 // best-effort
             }
         }
-        // Convert USD(8) -> native units
-        const nativeTokenUsdPrice = yield new price_fetch_1.PriceFetch(ctx.rpcUrls).getPrice(chain);
-        const nativeDecimals = chain_1.CHAIN_INFO[chain].vm === enums_1.VM.SVM ? 9 : 18;
-        const oneNativeUnit = utils_1.Utils.helpers.parseUnits('1', nativeDecimals);
-        let nativeAmount = (depositUsd * oneNativeUnit + (nativeTokenUsdPrice - BigInt(1))) / nativeTokenUsdPrice;
-        nativeAmount = nativeAmount + BigInt(1);
+        // Final USD(8) -> native conversion reusing the cached price fetched above.
+        let nativeAmount = usdToNative(depositUsd);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04, nativeAmount, depositUsd, chain);
         const bridgeAmount = execute.funds.amount;
         const symbol = execute.funds.token.symbol;
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_01, bridgeAmount, execute.funds.token.decimals, symbol);
@@ -144,8 +157,6 @@ function executeFundsWithPayload(ctx, execute, eventBuffer, getResponseCallbacks
         try {
             if (chain_1.CHAIN_INFO[ctx.universalSigner.account.chain].vm === enums_1.VM.EVM) {
                 const tokenAddr = execute.funds.token.address;
-                (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_01);
-                (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_02, ueaAddress, deployed);
                 (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_01);
                 (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_02);
                 (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_03);

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

@@ -72,7 +72,7 @@ function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks)
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_01);
         // Push to Push Tx
         if ((0, helpers_1.isPushChain)(chain)) {
-            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02, (_a = execute.gasLimit) !== null && _a !== void 0 ? _a : BigInt(21000));
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04, (_a = execute.gasLimit) !== null && _a !== void 0 ? _a : BigInt(21000), BigInt(0), chain);
             (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_107);
             let tx;
             try {
@@ -100,7 +100,6 @@ function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks)
         const gasPrice = yield ctx.pushClient.getGasPrice();
         const requiredGasFee = gasEstimate * gasPrice;
         const requiredFunds = requiredGasFee + execute.value;
-        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02, requiredFunds);
         // Fetch UEA Details (or use pre-fetched status if available)
         const UEA = (0, uea_manager_1.computeUEAOffchain)(ctx);
         let isUEADeployed;
@@ -135,6 +134,7 @@ function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks)
             }
         }
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_02, UEA, isUEADeployed);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04, requiredFunds, BigInt(0), chain);
         // Validate and decode feeLockTxHash
         let feeLockTxHash = execute.feeLockTxHash;
         if (feeLockTxHash) {

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

@@ -428,7 +428,7 @@ function calculateNativeAmountForDeposit(ctx, chain, requiredFunds, ueaBalance)
         let nativeAmount = (depositUsd * oneNativeUnit + (nativeTokenUsdPrice - BigInt(1))) /
             nativeTokenUsdPrice;
         nativeAmount = nativeAmount + BigInt(1);
-        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02, nativeAmount);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04, nativeAmount, depositUsd, chain);
         return nativeAmount;
     });
 }

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

@@ -168,24 +168,24 @@ function buildR2CeaPayloadEvm(params, ceaAddress, targetAddress) {
 }
 const SIZER_HOOK_BY_ROUTE = {
     R3: {
-        A: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_01,
-        B: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_02,
-        C: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_03,
+        A: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_01,
+        B: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_02,
+        C: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_03,
     },
 };
 /**
  * Fire the route-scoped sizing progress hook based on the sizer's decision.
- * Case C carries the overflow amount as an extra arg so UIs can render the
- * bridge leg separately.
+ * Emits the consumer-facing shape { gasRequired, extraDepositPC, totalDepositUSD, chain }.
+ * - gasRequired   = sizer's gas leg in native PC wei
+ * - extraDepositPC = overflow in native PC wei (> 0 only for Case C)
+ * - totalDepositUSD = sized total in USD (8-dec): $1 for Case A (padded),
+ *   raw gasUsd for Case B/C (which for Case C equals gasLegUsd + overflowUsd).
  */
 function fireSizingHook(ctx, route, chain, sizing) {
     const hook = SIZER_HOOK_BY_ROUTE[route][sizing.category];
-    if (sizing.category === 'C') {
-        (0, context_1.fireProgressHook)(ctx, hook, chain, sizing.gasUsd, sizing.gasLegNativePc, sizing.overflowNativePc);
-    }
-    else {
-        (0, context_1.fireProgressHook)(ctx, hook, chain, sizing.gasUsd, sizing.gasLegNativePc);
-    }
+    const ONE_USD_8D = BigInt(100000000);
+    const totalDepositUSD = sizing.category === 'A' ? ONE_USD_8D : sizing.gasUsd;
+    (0, context_1.fireProgressHook)(ctx, hook, chain, sizing.gasLegNativePc, sizing.overflowNativePc, totalDepositUSD);
 }
 // ---------------------------------------------------------------------------
 // executeMultiChain
@@ -913,19 +913,19 @@ function executeCeaToPush(ctx, params, executeFn) {
                 sizingDecisionR3 = result.sizing;
                 (0, context_1.printLog)(ctx, `executeCeaToPush — queried gas fee: ${gasFee.toString()}, gasToken: ${gasToken}, nativeValueForGas: ${nativeValueForGas.toString()}, sizing=${(_h = (_g = result.sizing) === null || _g === void 0 ? void 0 : _g.category) !== null && _h !== void 0 ? _h : 'legacy'}`);
                 (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_02, sourceChain, protocolFeeR3, gasFee);
-                if (result.sizing) {
-                    fireSizingHook(ctx, 'R3', sourceChain, result.sizing);
-                }
             }
             catch (err) {
                 throw new Error(`Failed to query outbound gas fee for Route 3: ${err}`);
             }
         }
-        // Emit account-resolution checkpoint post-gas to match numeric-spec order
-        // (301 → 302-xx → 303-xx). UEA + CEA were resolved earlier so we can feed
-        // both into 303-02.
+        // Account-resolution checkpoint fires before the gas-sizing sub-hook so
+        // consumers see the full account-resolution phase (303-xx) complete before
+        // the sizing decision is surfaced.
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_01, sourceChain);
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_02, ueaAddress, ceaAddress, sourceChain);
+        if (sizingDecisionR3) {
+            fireSizingHook(ctx, 'R3', sourceChain, sizingDecisionR3);
+        }
         // R3 Case C: unlike R2, R3 has no destination funds-delivery semantic
         // (CEA self-executes and bridges funds BACK to Push Chain). When the
         // sizer returns Case C, we simply top up msg.value with the overflow so
@@ -1135,19 +1135,19 @@ function executeCeaToPushSvm(ctx, params, sourceChain, executeFn) {
                 sizingDecisionR3Svm = result.sizing;
                 (0, context_1.printLog)(ctx, `executeCeaToPushSvm — gasFee: ${gasFee.toString()}, gasToken: ${gasToken}, nativeValueForGas: ${nativeValueForGas.toString()}, sizing=${(_d = (_c = result.sizing) === null || _c === void 0 ? void 0 : _c.category) !== null && _d !== void 0 ? _d : 'legacy'}`);
                 (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_02, sourceChain, protocolFeeR3Svm, gasFee);
-                if (result.sizing) {
-                    fireSizingHook(ctx, 'R3', sourceChain, result.sizing);
-                }
             }
             catch (err) {
                 throw new Error(`Failed to query outbound gas fee for SVM Route 3: ${err}`);
             }
         }
-        // Emit account-resolution checkpoint post-gas to match numeric-spec order
-        // (301 → 302-xx → 303-xx). UEA + gateway were resolved earlier so we can
-        // feed both into 303-02.
+        // Account-resolution checkpoint fires before the gas-sizing sub-hook so
+        // consumers see the full account-resolution phase (303-xx) complete before
+        // the sizing decision is surfaced.
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_01, sourceChain);
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_02, ueaAddress, lockerContract, sourceChain);
+        if (sizingDecisionR3Svm) {
+            fireSizingHook(ctx, 'R3', sourceChain, sizingDecisionR3Svm);
+        }
         // R3 SVM Case C: same minimal interpretation as R3 EVM — bump msg.value
         // by the overflow so swapAndBurnGas can afford the full gas cost. No
         // bridge-swap entries (R3 has no destination funds-delivery semantic).

package/src/lib/orchestrator/internals/tx-transformer.js

@@ -105,7 +105,6 @@ function reconstructProgressEvents(universalTxResponse, universalTxData) {
     const originAddress = originParts.length >= 3 ? originParts[2] : universalTxResponse.from;
     events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_101](chainNamespace, originAddress));
     events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_01]());
-    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02](universalTxResponse.gasLimit));
     const pushChainIds = [
         chain_1.CHAIN_INFO[enums_1.CHAIN.PUSH_MAINNET].chainId,
         chain_1.CHAIN_INFO[enums_1.CHAIN.PUSH_TESTNET_DONUT].chainId,
@@ -116,6 +115,7 @@ function reconstructProgressEvents(universalTxResponse, universalTxData) {
         events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_01]());
         events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_02](universalTxResponse.from, true));
     }
+    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04](universalTxResponse.gasLimit, BigInt(0)));
     events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_107]());
     if (isFailed) {
         events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_199_02](errorMsg));

package/src/lib/progress-hook/progress-hook.js

@@ -61,13 +61,6 @@ const RAW_HOOKS_R1 = {
         response: { stage: 'estimating-gas' },
         level: 'INFO',
     }),
-    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02]: (executionCost) => ({
-        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_102_02,
-        title: 'Gas Estimated',
-        message: `Total execution cost: ${executionCost} UPC`,
-        response: { totalCost: executionCost, currency: 'UPC' },
-        level: 'SUCCESS',
-    }),
     [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_01]: () => ({
         id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_01,
         title: 'Resolving Universal Execution Account',
@@ -82,6 +75,45 @@ const RAW_HOOKS_R1 = {
         response: { uea: ueaAddress, deployed },
         level: 'SUCCESS',
     }),
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03]: (originChain, requiredDepositUsd) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03,
+        title: 'Calculating Prepaid Deposit',
+        message: `Computing required Push-chain deposit based on UEA balance and gas needs`,
+        response: {
+            stage: 'calculating-prepaid-deposit',
+            chain: originChain,
+            requiredDepositUsd,
+        },
+        level: 'INFO',
+    }),
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_01]: (originChain, gasRequired, extraDepositPC, totalDepositUSD) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_01,
+        title: 'Adjusting Prepaid Deposit to be >$1',
+        message: `Required deposit below $1 minimum — padding to $1 floor (gasRequired=${gasRequired} UPC, extraDepositPC=${extraDepositPC} UPC, totalDepositUSD=$${totalDepositUSD})`,
+        response: { gasRequired, extraDepositPC, totalDepositUSD, chain: originChain },
+        level: 'INFO',
+    }),
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_02]: (originChain, gasRequired, extraDepositPC, totalDepositUSD) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_02,
+        title: 'Prepaid Deposit in range (>=$1 and <$10)',
+        message: `Required deposit $${totalDepositUSD} within $1–$10 range — depositing as required`,
+        response: { gasRequired, extraDepositPC, totalDepositUSD, chain: originChain },
+        level: 'INFO',
+    }),
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_03]: (originChain, gasRequired, extraDepositPC, totalDepositUSD) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_03,
+        title: 'Prepaid Deposit Exceeds $10 Cap, splitting Gas and Funds',
+        message: `Required deposit exceeds $10 cap — splitting: $10 gas leg + ${extraDepositPC} UPC overflow bridged as funds`,
+        response: { gasRequired, extraDepositPC, totalDepositUSD, chain: originChain },
+        level: 'INFO',
+    }),
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04]: (totalPCDeposit, totalDepositUSD, originChain) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_103_03_04,
+        title: 'Prepaid Deposit Estimated',
+        message: `Estimated prepaid deposit: $${totalDepositUSD} (${totalPCDeposit} UPC)`,
+        response: { totalPCDeposit, totalDepositUSD, chain: originChain !== null && originChain !== void 0 ? originChain : null },
+        level: 'SUCCESS',
+    }),
     [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_01]: () => ({
         id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_104_01,
         title: 'Awaiting Transaction',
@@ -192,27 +224,6 @@ const RAW_HOOKS_R1 = {
         response: { amount, symbol },
         level: 'SUCCESS',
     }),
-    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_01]: (originChain, pushGasUsd, paddedDepositUsd) => ({
-        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_01,
-        title: `${friendlyChain(originChain)} Push Gas Sizing: Case A`,
-        message: `Push-chain gas < $1; padding deposit to $1 floor (pushGasUsd=${pushGasUsd}, paddedDepositUsd=${paddedDepositUsd})`,
-        response: { category: 'A', pushGasUsd, paddedDepositUsd, chain: originChain },
-        level: 'INFO',
-    }),
-    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_02]: (originChain, pushGasUsd, paddedDepositUsd) => ({
-        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_02,
-        title: `${friendlyChain(originChain)} Push Gas Sizing: Case B`,
-        message: `Push-chain gas within $1–$10; happy path (pushGasUsd=${pushGasUsd}, paddedDepositUsd=${paddedDepositUsd})`,
-        response: { category: 'B', pushGasUsd, paddedDepositUsd, chain: originChain },
-        level: 'INFO',
-    }),
-    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_03]: (originChain, pushGasUsd, paddedDepositUsd) => ({
-        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_106_07_03,
-        title: `${friendlyChain(originChain)} Push Gas Sizing: Case C`,
-        message: `Push-chain gas > $10; deposit passes through to origin gateway MAX_CAP_UNIVERSAL_TX_USD (pushGasUsd=${pushGasUsd}, paddedDepositUsd=${paddedDepositUsd})`,
-        response: { category: 'C', pushGasUsd, paddedDepositUsd, chain: originChain },
-        level: 'INFO',
-    }),
     [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_107]: () => ({
         id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_107,
         title: 'Broadcasting to Push Chain',
@@ -375,7 +386,7 @@ const RAW_HOOKS_R2 = {
 const RAW_HOOKS_R3 = {
     [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_199_99_99]: (txHash) => ({
         id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_199_99_99,
-        title: 'Push Chain TX Completed',
+        title: 'Push Chain Tx Completed',
         message: `Intermediate Push Chain tx confirmed: ${txHash}, progressing to next phase`,
         response: { txHash },
         level: 'INFO',
@@ -406,31 +417,25 @@ const RAW_HOOKS_R3 = {
         },
         level: 'SUCCESS',
     }),
-    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_01]: (sourceChain, gasUsd, gasLegNativePc) => ({
-        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_01,
-        title: `${friendlyChain(sourceChain)} Gas Sizing: Case A`,
-        message: `Gas cost < $1; padding to $1 minimum (gasUsd=${gasUsd}, gasLeg=${gasLegNativePc} UPC)`,
-        response: { category: 'A', gasUsd, gasLegNativePc, chain: sourceChain },
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_01]: (sourceChain, gasRequired, extraDepositPC, totalDepositUSD) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_01,
+        title: 'Adjusting Prepaid Deposit to be >$1',
+        message: `Required deposit below $1 minimum — padding to $1 floor (gasRequired=${gasRequired} UPC, extraDepositPC=${extraDepositPC} UPC, totalDepositUSD=$${totalDepositUSD})`,
+        response: { gasRequired, extraDepositPC, totalDepositUSD, chain: sourceChain },
         level: 'INFO',
     }),
-    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_02]: (sourceChain, gasUsd, gasLegNativePc) => ({
-        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_02,
-        title: `${friendlyChain(sourceChain)} Gas Sizing: Case B`,
-        message: `Gas cost within $1–$10 window; happy path (gasUsd=${gasUsd}, gasLeg=${gasLegNativePc} UPC)`,
-        response: { category: 'B', gasUsd, gasLegNativePc, chain: sourceChain },
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_02]: (sourceChain, gasRequired, extraDepositPC, totalDepositUSD) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_02,
+        title: 'Prepaid Deposit in range (>=$1 and <$10)',
+        message: `Required deposit $${totalDepositUSD} within $1–$10 range — depositing as required`,
+        response: { gasRequired, extraDepositPC, totalDepositUSD, chain: sourceChain },
         level: 'INFO',
     }),
-    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_03]: (sourceChain, gasUsd, gasLegNativePc, overflowNativePc) => ({
-        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_302_03_03,
-        title: `${friendlyChain(sourceChain)} Gas Sizing: Case C`,
-        message: `Gas cost > $10; splitting into $10 gas leg + ${overflowNativePc} UPC overflow bridged as funds`,
-        response: {
-            category: 'C',
-            gasUsd,
-            gasLegNativePc,
-            overflowNativePc,
-            chain: sourceChain,
-        },
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_03]: (sourceChain, gasRequired, extraDepositPC, totalDepositUSD) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_03_03,
+        title: 'Prepaid Deposit Exceeds $10 Cap, splitting Gas and Funds',
+        message: `Required deposit exceeds $10 cap — splitting: $10 gas leg + ${extraDepositPC} UPC overflow bridged as funds`,
+        response: { gasRequired, extraDepositPC, totalDepositUSD, chain: sourceChain },
         level: 'INFO',
     }),
     [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_01]: (sourceChain) => ({

package/src/lib/progress-hook/progress-hook.types.d.ts

@@ -16,9 +16,13 @@ export type ProgressEventFunctionWithoutTimestamp = (...args: any[]) => Omit<Pro
 export declare enum PROGRESS_HOOK {
     SEND_TX_101 = "SEND-TX-101",
     SEND_TX_102_01 = "SEND-TX-102-01",
-    SEND_TX_102_02 = "SEND-TX-102-02",
     SEND_TX_103_01 = "SEND-TX-103-01",
     SEND_TX_103_02 = "SEND-TX-103-02",
+    SEND_TX_103_03 = "SEND-TX-103-03",// Calculating Prepaid Deposit (parent)
+    SEND_TX_103_03_01 = "SEND-TX-103-03-01",// Prepaid deposit Case A (< $1, padded to $1 floor)
+    SEND_TX_103_03_02 = "SEND-TX-103-03-02",// Prepaid deposit Case B ($1–$10, pass-through)
+    SEND_TX_103_03_03 = "SEND-TX-103-03-03",// Prepaid deposit Case C (> $10, split + overflow bridge)
+    SEND_TX_103_03_04 = "SEND-TX-103-03-04",// Prepaid Deposit Estimated (terminal for 103-03)
     SEND_TX_104_01 = "SEND-TX-104-01",// fee-lock path only
     SEND_TX_104_02 = "SEND-TX-104-02",// signature path only
     SEND_TX_104_03 = "SEND-TX-104-03",
@@ -33,9 +37,6 @@ export declare enum PROGRESS_HOOK {
     SEND_TX_106_04 = "SEND-TX-106-04",
     SEND_TX_106_05 = "SEND-TX-106-05",
     SEND_TX_106_06 = "SEND-TX-106-06",
-    SEND_TX_106_07_01 = "SEND-TX-106-07-01",// R1 Sizer: Case A (push-gas < $1, padded to $1 floor)
-    SEND_TX_106_07_02 = "SEND-TX-106-07-02",// R1 Sizer: Case B (push-gas $1–$10, pass-through)
-    SEND_TX_106_07_03 = "SEND-TX-106-07-03",// R1 Sizer: Case C (push-gas > $10, pass-through to contract cap)
     SEND_TX_107 = "SEND-TX-107",
     SEND_TX_199_01 = "SEND-TX-199-01",// R1 terminal Push success
     SEND_TX_199_02 = "SEND-TX-199-02",// R1 terminal Push failure
@@ -59,11 +60,11 @@ export declare enum PROGRESS_HOOK {
     SEND_TX_301 = "SEND-TX-301",
     SEND_TX_302_01 = "SEND-TX-302-01",
     SEND_TX_302_02 = "SEND-TX-302-02",
-    SEND_TX_302_03_01 = "SEND-TX-302-03-01",// Sizer: Case A (< $1, padded)
-    SEND_TX_302_03_02 = "SEND-TX-302-03-02",// Sizer: Case B ($1–$10, happy path)
-    SEND_TX_302_03_03 = "SEND-TX-302-03-03",// Sizer: Case C (> $10, split + overflow bridge)
     SEND_TX_303_01 = "SEND-TX-303-01",
     SEND_TX_303_02 = "SEND-TX-303-02",
+    SEND_TX_303_03_01 = "SEND-TX-303-03-01",// Sizer: Case A (< $1, padded)
+    SEND_TX_303_03_02 = "SEND-TX-303-03-02",// Sizer: Case B ($1–$10, happy path)
+    SEND_TX_303_03_03 = "SEND-TX-303-03-03",// Sizer: Case C (> $10, split + overflow bridge)
     SEND_TX_304_01 = "SEND-TX-304-01",
     SEND_TX_304_02 = "SEND-TX-304-02",
     SEND_TX_304_03 = "SEND-TX-304-03",
@@ -90,9 +91,9 @@ export declare enum PROGRESS_HOOK {
     UEA_MIG_9902 = "UEA-MIG-9902",
     UEA_MIG_9903 = "UEA-MIG-9903"
 }
-export type PROGRESS_HOOK_R1 = PROGRESS_HOOK.SEND_TX_101 | PROGRESS_HOOK.SEND_TX_102_01 | PROGRESS_HOOK.SEND_TX_102_02 | PROGRESS_HOOK.SEND_TX_103_01 | PROGRESS_HOOK.SEND_TX_103_02 | PROGRESS_HOOK.SEND_TX_104_01 | PROGRESS_HOOK.SEND_TX_104_02 | PROGRESS_HOOK.SEND_TX_104_03 | PROGRESS_HOOK.SEND_TX_104_04 | PROGRESS_HOOK.SEND_TX_105_01 | PROGRESS_HOOK.SEND_TX_105_02 | PROGRESS_HOOK.SEND_TX_106_01 | PROGRESS_HOOK.SEND_TX_106_02 | PROGRESS_HOOK.SEND_TX_106_03 | PROGRESS_HOOK.SEND_TX_106_03_01 | PROGRESS_HOOK.SEND_TX_106_03_02 | PROGRESS_HOOK.SEND_TX_106_04 | PROGRESS_HOOK.SEND_TX_106_05 | PROGRESS_HOOK.SEND_TX_106_06 | PROGRESS_HOOK.SEND_TX_106_07_01 | PROGRESS_HOOK.SEND_TX_106_07_02 | PROGRESS_HOOK.SEND_TX_106_07_03 | PROGRESS_HOOK.SEND_TX_107 | PROGRESS_HOOK.SEND_TX_199_01 | PROGRESS_HOOK.SEND_TX_199_02;
+export type PROGRESS_HOOK_R1 = PROGRESS_HOOK.SEND_TX_101 | PROGRESS_HOOK.SEND_TX_102_01 | PROGRESS_HOOK.SEND_TX_103_01 | PROGRESS_HOOK.SEND_TX_103_02 | PROGRESS_HOOK.SEND_TX_103_03 | PROGRESS_HOOK.SEND_TX_103_03_01 | PROGRESS_HOOK.SEND_TX_103_03_02 | PROGRESS_HOOK.SEND_TX_103_03_03 | PROGRESS_HOOK.SEND_TX_103_03_04 | PROGRESS_HOOK.SEND_TX_104_01 | PROGRESS_HOOK.SEND_TX_104_02 | PROGRESS_HOOK.SEND_TX_104_03 | PROGRESS_HOOK.SEND_TX_104_04 | PROGRESS_HOOK.SEND_TX_105_01 | PROGRESS_HOOK.SEND_TX_105_02 | PROGRESS_HOOK.SEND_TX_106_01 | PROGRESS_HOOK.SEND_TX_106_02 | PROGRESS_HOOK.SEND_TX_106_03 | PROGRESS_HOOK.SEND_TX_106_03_01 | PROGRESS_HOOK.SEND_TX_106_03_02 | PROGRESS_HOOK.SEND_TX_106_04 | PROGRESS_HOOK.SEND_TX_106_05 | PROGRESS_HOOK.SEND_TX_106_06 | PROGRESS_HOOK.SEND_TX_107 | PROGRESS_HOOK.SEND_TX_199_01 | PROGRESS_HOOK.SEND_TX_199_02;
 export type PROGRESS_HOOK_R2 = PROGRESS_HOOK.SEND_TX_201 | PROGRESS_HOOK.SEND_TX_202_01 | PROGRESS_HOOK.SEND_TX_202_02 | PROGRESS_HOOK.SEND_TX_203_01 | PROGRESS_HOOK.SEND_TX_203_02 | PROGRESS_HOOK.SEND_TX_204_01 | PROGRESS_HOOK.SEND_TX_204_02 | PROGRESS_HOOK.SEND_TX_204_03 | PROGRESS_HOOK.SEND_TX_204_04 | PROGRESS_HOOK.SEND_TX_207 | PROGRESS_HOOK.SEND_TX_209_01 | PROGRESS_HOOK.SEND_TX_209_02 | PROGRESS_HOOK.SEND_TX_299_01 | PROGRESS_HOOK.SEND_TX_299_02 | PROGRESS_HOOK.SEND_TX_299_03 | PROGRESS_HOOK.SEND_TX_299_99;
-export type PROGRESS_HOOK_R3 = PROGRESS_HOOK.SEND_TX_199_99_99 | PROGRESS_HOOK.SEND_TX_301 | PROGRESS_HOOK.SEND_TX_302_01 | PROGRESS_HOOK.SEND_TX_302_02 | PROGRESS_HOOK.SEND_TX_302_03_01 | PROGRESS_HOOK.SEND_TX_302_03_02 | PROGRESS_HOOK.SEND_TX_302_03_03 | PROGRESS_HOOK.SEND_TX_303_01 | PROGRESS_HOOK.SEND_TX_303_02 | PROGRESS_HOOK.SEND_TX_304_01 | PROGRESS_HOOK.SEND_TX_304_02 | PROGRESS_HOOK.SEND_TX_304_03 | PROGRESS_HOOK.SEND_TX_304_04 | PROGRESS_HOOK.SEND_TX_307 | PROGRESS_HOOK.SEND_TX_309_01 | PROGRESS_HOOK.SEND_TX_309_02 | PROGRESS_HOOK.SEND_TX_309_03 | PROGRESS_HOOK.SEND_TX_310_01 | PROGRESS_HOOK.SEND_TX_310_02 | PROGRESS_HOOK.SEND_TX_399_01 | PROGRESS_HOOK.SEND_TX_399_02 | PROGRESS_HOOK.SEND_TX_399_03;
+export type PROGRESS_HOOK_R3 = PROGRESS_HOOK.SEND_TX_199_99_99 | PROGRESS_HOOK.SEND_TX_301 | PROGRESS_HOOK.SEND_TX_302_01 | PROGRESS_HOOK.SEND_TX_302_02 | PROGRESS_HOOK.SEND_TX_303_01 | PROGRESS_HOOK.SEND_TX_303_02 | PROGRESS_HOOK.SEND_TX_303_03_01 | PROGRESS_HOOK.SEND_TX_303_03_02 | PROGRESS_HOOK.SEND_TX_303_03_03 | PROGRESS_HOOK.SEND_TX_304_01 | PROGRESS_HOOK.SEND_TX_304_02 | PROGRESS_HOOK.SEND_TX_304_03 | PROGRESS_HOOK.SEND_TX_304_04 | PROGRESS_HOOK.SEND_TX_307 | PROGRESS_HOOK.SEND_TX_309_01 | PROGRESS_HOOK.SEND_TX_309_02 | PROGRESS_HOOK.SEND_TX_309_03 | PROGRESS_HOOK.SEND_TX_310_01 | PROGRESS_HOOK.SEND_TX_310_02 | PROGRESS_HOOK.SEND_TX_399_01 | PROGRESS_HOOK.SEND_TX_399_02 | PROGRESS_HOOK.SEND_TX_399_03;
 export type PROGRESS_HOOK_MULTICHAIN = PROGRESS_HOOK.SEND_TX_001 | PROGRESS_HOOK.SEND_TX_002_01 | PROGRESS_HOOK.SEND_TX_002_99_99 | PROGRESS_HOOK.SEND_TX_999_01 | PROGRESS_HOOK.SEND_TX_999_02 | PROGRESS_HOOK.SEND_TX_999_03;
 export type PROGRESS_HOOK_MIG = PROGRESS_HOOK.UEA_MIG_01 | PROGRESS_HOOK.UEA_MIG_02 | PROGRESS_HOOK.UEA_MIG_03 | PROGRESS_HOOK.UEA_MIG_9901 | PROGRESS_HOOK.UEA_MIG_9902 | PROGRESS_HOOK.UEA_MIG_9903;
 export {};

package/src/lib/progress-hook/progress-hook.types.js

@@ -6,9 +6,13 @@ var PROGRESS_HOOK;
     // Route 1: UOA → Push Chain (101–199)
     PROGRESS_HOOK["SEND_TX_101"] = "SEND-TX-101";
     PROGRESS_HOOK["SEND_TX_102_01"] = "SEND-TX-102-01";
-    PROGRESS_HOOK["SEND_TX_102_02"] = "SEND-TX-102-02";
     PROGRESS_HOOK["SEND_TX_103_01"] = "SEND-TX-103-01";
     PROGRESS_HOOK["SEND_TX_103_02"] = "SEND-TX-103-02";
+    PROGRESS_HOOK["SEND_TX_103_03"] = "SEND-TX-103-03";
+    PROGRESS_HOOK["SEND_TX_103_03_01"] = "SEND-TX-103-03-01";
+    PROGRESS_HOOK["SEND_TX_103_03_02"] = "SEND-TX-103-03-02";
+    PROGRESS_HOOK["SEND_TX_103_03_03"] = "SEND-TX-103-03-03";
+    PROGRESS_HOOK["SEND_TX_103_03_04"] = "SEND-TX-103-03-04";
     PROGRESS_HOOK["SEND_TX_104_01"] = "SEND-TX-104-01";
     PROGRESS_HOOK["SEND_TX_104_02"] = "SEND-TX-104-02";
     PROGRESS_HOOK["SEND_TX_104_03"] = "SEND-TX-104-03";
@@ -23,9 +27,6 @@ var PROGRESS_HOOK;
     PROGRESS_HOOK["SEND_TX_106_04"] = "SEND-TX-106-04";
     PROGRESS_HOOK["SEND_TX_106_05"] = "SEND-TX-106-05";
     PROGRESS_HOOK["SEND_TX_106_06"] = "SEND-TX-106-06";
-    PROGRESS_HOOK["SEND_TX_106_07_01"] = "SEND-TX-106-07-01";
-    PROGRESS_HOOK["SEND_TX_106_07_02"] = "SEND-TX-106-07-02";
-    PROGRESS_HOOK["SEND_TX_106_07_03"] = "SEND-TX-106-07-03";
     PROGRESS_HOOK["SEND_TX_107"] = "SEND-TX-107";
     PROGRESS_HOOK["SEND_TX_199_01"] = "SEND-TX-199-01";
     PROGRESS_HOOK["SEND_TX_199_02"] = "SEND-TX-199-02";
@@ -51,11 +52,11 @@ var PROGRESS_HOOK;
     PROGRESS_HOOK["SEND_TX_301"] = "SEND-TX-301";
     PROGRESS_HOOK["SEND_TX_302_01"] = "SEND-TX-302-01";
     PROGRESS_HOOK["SEND_TX_302_02"] = "SEND-TX-302-02";
-    PROGRESS_HOOK["SEND_TX_302_03_01"] = "SEND-TX-302-03-01";
-    PROGRESS_HOOK["SEND_TX_302_03_02"] = "SEND-TX-302-03-02";
-    PROGRESS_HOOK["SEND_TX_302_03_03"] = "SEND-TX-302-03-03";
     PROGRESS_HOOK["SEND_TX_303_01"] = "SEND-TX-303-01";
     PROGRESS_HOOK["SEND_TX_303_02"] = "SEND-TX-303-02";
+    PROGRESS_HOOK["SEND_TX_303_03_01"] = "SEND-TX-303-03-01";
+    PROGRESS_HOOK["SEND_TX_303_03_02"] = "SEND-TX-303-03-02";
+    PROGRESS_HOOK["SEND_TX_303_03_03"] = "SEND-TX-303-03-03";
     PROGRESS_HOOK["SEND_TX_304_01"] = "SEND-TX-304-01";
     PROGRESS_HOOK["SEND_TX_304_02"] = "SEND-TX-304-02";
     PROGRESS_HOOK["SEND_TX_304_03"] = "SEND-TX-304-03";