@pushchain/core 5.1.3 → 5.1.4-alpha.1

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

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Funds+payload execution flow — extracted from Orchestrator.execute().
+ *
+ * Handles bridging funds AND executing a payload on Push Chain
+ * for both EVM and SVM origin chains.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeFundsWithPayload = executeFundsWithPayload;
+const tslib_1 = require("tslib");
+const bs58_1 = require("../../internal/bs58");
+const web3_js_1 = require("@solana/web3.js");
+const viem_1 = require("viem");
+const universalGatewayV0_json_1 = tslib_1.__importDefault(require("../../constants/abi/universalGatewayV0.json"));
+const chain_1 = require("../../constants/chain");
+const enums_1 = require("../../constants/enums");
+const tokens_1 = require("../../constants/tokens");
+const progress_hook_types_1 = require("../../progress-hook/progress-hook.types");
+const price_fetch_1 = require("../../price-fetch/price-fetch");
+const push_chain_1 = require("../../push-chain/push-chain");
+const utils_1 = require("../../utils");
+const svm_client_1 = require("../../vm-client/svm-client");
+const context_1 = require("./context");
+const gas_calculator_1 = require("./gas-calculator");
+const gateway_client_1 = require("./gateway-client");
+const payload_builder_1 = require("./payload-builder");
+const uea_manager_1 = require("./uea-manager");
+const confirmation_1 = require("./confirmation");
+const response_builder_1 = require("./response-builder");
+const push_chain_tx_1 = require("./push-chain-tx");
+const svm_bridge_1 = require("./svm-bridge");
+const signing_1 = require("./signing");
+const quote_1 = require("./quote");
+function executeFundsWithPayload(ctx, execute, eventBuffer, getResponseCallbacks) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        const transformFn = (tx, buf = []) => (0, response_builder_1.transformToUniversalTxResponse)(ctx, tx, buf, getResponseCallbacks());
+        const { chain, evmClient, gatewayAddress } = (0, gateway_client_1.getOriginGatewayContext)(ctx);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_01, chain, ctx.universalSigner.account.address);
+        // Default token to native ETH if none provided
+        if (!execute.funds.token) {
+            const available = tokens_1.MOVEABLE_TOKENS[chain] || [];
+            const vm = chain_1.CHAIN_INFO[chain].vm;
+            const preferredSymbol = vm === enums_1.VM.EVM ? 'ETH' : vm === enums_1.VM.SVM ? 'SOL' : undefined;
+            const nativeToken = preferredSymbol
+                ? available.find((t) => t.symbol === preferredSymbol)
+                : undefined;
+            if (!nativeToken) {
+                throw new Error('Native token not configured for this chain');
+            }
+            execute.funds.token = nativeToken;
+        }
+        const mechanism = execute.funds.token.mechanism;
+        let nonce;
+        let deployed;
+        const deployedHint = (_b = (_a = ctx.accountStatusCache) === null || _a === void 0 ? void 0 : _a.uea) === null || _b === void 0 ? void 0 : _b.deployed;
+        if (deployedHint) {
+            deployed = true;
+            nonce = yield (0, uea_manager_1.getUEANonce)(ctx, (0, uea_manager_1.computeUEAOffchain)(ctx));
+        }
+        else {
+            const status = yield (0, uea_manager_1.getUeaStatusAndNonce)(ctx);
+            nonce = status.nonce;
+            deployed = status.deployed;
+        }
+        const { payload: universalPayload, req } = yield (0, payload_builder_1.buildGatewayPayloadAndGas)(ctx, execute, nonce, 'sendTxWithFunds', execute.funds.amount);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_02_01);
+        // Compute required gas funding on Push Chain and current UEA balance
+        const gasEstimate = execute.gasLimit || BigInt(1e7);
+        const gasPrice = yield ctx.pushClient.getGasPrice();
+        const requiredGasFee = gasEstimate * gasPrice;
+        const payloadValue = (_c = execute.value) !== null && _c !== void 0 ? _c : BigInt(0);
+        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_03_02, ueaAddress, deployed);
+        // Determine USD to deposit via gateway (8 decimals) with caps: min=$1, max=$10
+        const oneUsd = utils_1.Utils.helpers.parseUnits('1', 8);
+        const tenUsd = utils_1.Utils.helpers.parseUnits('10', 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');
+        (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) {
+            const svmClient = new svm_client_1.SvmClient({
+                rpcUrls: ctx.rpcUrls[enums_1.CHAIN.SOLANA_DEVNET] || chain_1.CHAIN_INFO[enums_1.CHAIN.SOLANA_DEVNET].defaultRPC,
+            });
+            const programId = new web3_js_1.PublicKey(universalGatewayV0_json_1.default.address);
+            const [configPda] = web3_js_1.PublicKey.findProgramAddressSync([(0, viem_1.stringToBytes)('config')], programId);
+            try {
+                const cfg = yield svmClient.readContract({
+                    abi: universalGatewayV0_json_1.default, address: universalGatewayV0_json_1.default.address,
+                    functionName: 'config', args: [configPda.toBase58()],
+                });
+                const minCapUsd = BigInt(((_d = cfg.minCapUniversalTxUsd) !== null && _d !== void 0 ? _d : cfg.min_cap_universal_tx_usd).toString());
+                const maxCapUsd = BigInt(((_e = cfg.maxCapUniversalTxUsd) !== null && _e !== void 0 ? _e : cfg.max_cap_universal_tx_usd).toString());
+                if (depositUsd < minCapUsd)
+                    depositUsd = minCapUsd;
+                const withMargin = (minCapUsd * BigInt(12)) / BigInt(10);
+                if (depositUsd < withMargin)
+                    depositUsd = withMargin;
+                if (depositUsd > maxCapUsd)
+                    depositUsd = maxCapUsd;
+            }
+            catch (_m) {
+                // 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);
+        const bridgeAmount = execute.funds.amount;
+        const symbol = execute.funds.token.symbol;
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_01, bridgeAmount, execute.funds.token.decimals, symbol);
+        if (chain_1.CHAIN_INFO[ctx.universalSigner.account.chain].vm === enums_1.VM.EVM) {
+            const tokenAddr = execute.funds.token.address;
+            if (mechanism === 'approve') {
+                const evmClientEvm = evmClient;
+                const gatewayAddressEvm = gatewayAddress;
+                yield (0, gas_calculator_1.ensureErc20Allowance)(ctx, evmClientEvm, tokenAddr, gatewayAddressEvm, bridgeAmount);
+            }
+            else if (mechanism === 'permit2') {
+                throw new Error('Permit2 is not supported yet');
+            }
+        }
+        let txHash;
+        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_03_01);
+                (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_03_02, ueaAddress, deployed);
+                (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_01);
+                (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_02);
+                (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_03);
+                const evmClientEvm = evmClient;
+                const gatewayAddressEvm = gatewayAddress;
+                const payloadBytes = (0, signing_1.encodeUniversalPayload)(universalPayload);
+                const payWith = execute.payGasWith;
+                const gasTokenAddress = (_f = payWith === null || payWith === void 0 ? void 0 : payWith.token) === null || _f === void 0 ? void 0 : _f.address;
+                if (gasTokenAddress) {
+                    if (chain !== enums_1.CHAIN.ETHEREUM_SEPOLIA) {
+                        throw new Error(`Only ${push_chain_1.PushChain.utils.chains.getChainName(enums_1.CHAIN.ETHEREUM_SEPOLIA)} is supported for paying gas fees with ERC-20 tokens`);
+                    }
+                    let amountOutMinETH = (payWith === null || payWith === void 0 ? void 0 : payWith.minAmountOut) !== undefined ? BigInt(payWith.minAmountOut) : nativeAmount;
+                    const slippageBps = (_g = payWith === null || payWith === void 0 ? void 0 : payWith.slippageBps) !== null && _g !== void 0 ? _g : 100;
+                    amountOutMinETH = BigInt(push_chain_1.PushChain.utils.conversion.slippageToMinAmount(amountOutMinETH.toString(), { slippageBps }));
+                    const quoteExactOutputFn = (amountOut, opts) => (0, quote_1.quoteExactOutput)(ctx, amountOut, opts);
+                    const { gasAmount } = yield (0, gas_calculator_1.calculateGasAmountFromAmountOutMinETH)(ctx, gasTokenAddress, amountOutMinETH, quoteExactOutputFn);
+                    const deadline = BigInt(0);
+                    const ownerAddress = ctx.universalSigner.account.address;
+                    const gasTokenBalance = yield evmClientEvm.getErc20Balance({
+                        tokenAddress: gasTokenAddress, ownerAddress,
+                    });
+                    if (gasTokenBalance < gasAmount) {
+                        const sym = (_j = (_h = payWith === null || payWith === void 0 ? void 0 : payWith.token) === null || _h === void 0 ? void 0 : _h.symbol) !== null && _j !== void 0 ? _j : 'gas token';
+                        const decimals = (_l = (_k = payWith === null || payWith === void 0 ? void 0 : payWith.token) === null || _k === void 0 ? void 0 : _k.decimals) !== null && _l !== void 0 ? _l : 18;
+                        throw new Error(`Insufficient ${sym} balance to cover gas fees: need ${utils_1.Utils.helpers.formatUnits(gasAmount, decimals)}, have ${utils_1.Utils.helpers.formatUnits(gasTokenBalance, decimals)}`);
+                    }
+                    yield (0, gas_calculator_1.ensureErc20Allowance)(ctx, evmClientEvm, gasTokenAddress, gatewayAddressEvm, gasAmount);
+                    const reqToken = Object.assign(Object.assign({}, req), { gasToken: gasTokenAddress, gasAmount, amountOutMinETH, deadline });
+                    txHash = yield (0, gateway_client_1.sendGatewayTokenTxWithFallback)(ctx, evmClientEvm, gatewayAddressEvm, reqToken, ctx.universalSigner);
+                }
+                else {
+                    const isNativeToken = mechanism === 'native';
+                    const totalValue = isNativeToken ? nativeAmount + bridgeAmount : nativeAmount;
+                    txHash = yield (0, gateway_client_1.sendGatewayTxWithFallback)(ctx, evmClientEvm, gatewayAddressEvm, req, ctx.universalSigner, totalValue);
+                }
+            }
+            else {
+                txHash = yield (0, svm_bridge_1.sendSVMTxWithFunds)(ctx, {
+                    execute, mechanism, universalPayload, bridgeAmount, nativeAmount, req,
+                });
+            }
+        }
+        catch (err) {
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_04);
+            throw err;
+        }
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_03);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_02, txHash, bridgeAmount, execute.funds.token.decimals, symbol);
+        // Awaiting confirmations
+        const signerChain = ctx.universalSigner.account.chain;
+        if (chain_1.CHAIN_INFO[signerChain].vm === enums_1.VM.EVM) {
+            yield (0, confirmation_1.waitForEvmConfirmationsWithCountdown)(ctx, evmClient, txHash, chain_1.CHAIN_INFO[signerChain].confirmations, chain_1.CHAIN_INFO[signerChain].timeout);
+        }
+        else {
+            const svmClient = new svm_client_1.SvmClient({
+                rpcUrls: ctx.rpcUrls[enums_1.CHAIN.SOLANA_DEVNET] || chain_1.CHAIN_INFO[enums_1.CHAIN.SOLANA_DEVNET].defaultRPC,
+            });
+            yield (0, confirmation_1.waitForSvmConfirmationsWithCountdown)(ctx, svmClient, txHash, chain_1.CHAIN_INFO[signerChain].confirmations, chain_1.CHAIN_INFO[signerChain].timeout);
+        }
+        // Funds Flow: Confirmed on origin
+        let feeLockTxHash = txHash;
+        if (chain_1.CHAIN_INFO[ctx.universalSigner.account.chain].vm === enums_1.VM.SVM) {
+            if (feeLockTxHash && !feeLockTxHash.startsWith('0x')) {
+                const decoded = bs58_1.bs58.decode(feeLockTxHash);
+                feeLockTxHash = (0, viem_1.bytesToHex)(new Uint8Array(decoded));
+            }
+        }
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_04);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_05);
+        let pushChainUniversalTx;
+        if (chain_1.CHAIN_INFO[ctx.universalSigner.account.chain].vm === enums_1.VM.EVM) {
+            pushChainUniversalTx = yield (0, response_builder_1.queryUniversalTxStatusFromGatewayTx)(ctx, evmClient, gatewayAddress, txHash, 'sendTxWithFunds');
+        }
+        else {
+            pushChainUniversalTx = yield (0, response_builder_1.queryUniversalTxStatusFromGatewayTx)(ctx, undefined, undefined, txHash, 'sendTxWithFunds');
+        }
+        const response = yield (0, push_chain_tx_1.extractPcTxAndTransform)(ctx, pushChainUniversalTx, txHash, eventBuffer, 'sendTxWithFunds', transformFn);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_06, bridgeAmount, execute.funds.token.decimals, symbol);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_01, [response]);
+        return response;
+    });
+}
+//# sourceMappingURL=execute-funds-payload.js.map

package/src/lib/orchestrator/internals/execute-standard.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Standard payload execution flow (no funds) — extracted from Orchestrator.execute().
+ *
+ * Handles payload-only execution on Push Chain:
+ * - Push-to-Push direct transactions
+ * - Fee-locking path for undeployed/underfunded UEA
+ * - Signed verification path for deployed UEA with funds
+ */
+import { ProgressEvent } from '../../progress-hook/progress-hook.types';
+import type { ExecuteParams, UniversalTxResponse } from '../orchestrator.types';
+import type { OrchestratorContext } from './context';
+import { type ResponseBuilderCallbacks } from './response-builder';
+export declare function executeStandardPayload(ctx: OrchestratorContext, execute: ExecuteParams, eventBuffer: ProgressEvent[], getResponseCallbacks: () => ResponseBuilderCallbacks): Promise<UniversalTxResponse>;

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

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Standard payload execution flow (no funds) — extracted from Orchestrator.execute().
+ *
+ * Handles payload-only execution on Push Chain:
+ * - Push-to-Push direct transactions
+ * - Fee-locking path for undeployed/underfunded UEA
+ * - Signed verification path for deployed UEA with funds
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeStandardPayload = executeStandardPayload;
+const tslib_1 = require("tslib");
+const bs58_1 = require("../../internal/bs58");
+const viem_1 = require("viem");
+const chain_1 = require("../../constants/chain");
+const enums_1 = require("../../constants/enums");
+const tx_1 = require("../../generated/v1/tx");
+const progress_hook_types_1 = require("../../progress-hook/progress-hook.types");
+const utils_1 = require("../../utils");
+const evm_client_1 = require("../../vm-client/evm-client");
+const payload_builders_1 = require("../payload-builders");
+const context_1 = require("./context");
+const helpers_1 = require("./helpers");
+const payload_builder_1 = require("./payload-builder");
+const signing_1 = require("./signing");
+const uea_manager_1 = require("./uea-manager");
+const confirmation_1 = require("./confirmation");
+const gateway_client_1 = require("./gateway-client");
+const response_builder_1 = require("./response-builder");
+const push_chain_tx_1 = require("./push-chain-tx");
+function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const transformFn = (tx, buf = []) => (0, response_builder_1.transformToUniversalTxResponse)(ctx, tx, buf, getResponseCallbacks());
+        // Set default value for value if undefined
+        if (execute.value === undefined) {
+            execute.value = BigInt(0);
+        }
+        const chain = ctx.universalSigner.account.chain;
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_01, chain, ctx.universalSigner.account.address);
+        (0, helpers_1.validateMainnetConnection)(chain, ctx.pushClient.pushChainInfo.chainId);
+        // Push to Push Tx
+        if ((0, helpers_1.isPushChain)(chain)) {
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_07);
+            const tx = yield (0, push_chain_tx_1.sendPushTx)(ctx, execute, eventBuffer, transformFn);
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_01, [tx]);
+            return tx;
+        }
+        // Fetch Gas details and estimate cost of execution
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_02_01);
+        const gasEstimate = execute.gasLimit || BigInt(1e7);
+        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_02_02, requiredFunds);
+        // Fetch UEA Details (or use pre-fetched status if available)
+        const UEA = (0, uea_manager_1.computeUEAOffchain)(ctx);
+        let isUEADeployed;
+        let nonce;
+        let funds;
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_03_01);
+        if (execute._ueaStatus) {
+            isUEADeployed = execute._ueaStatus.isDeployed;
+            nonce = execute._ueaStatus.nonce;
+            funds = execute._ueaStatus.balance;
+        }
+        else {
+            // Skip getCode if accountStatusCache already confirmed deployment
+            const deployedHint = (_b = (_a = ctx.accountStatusCache) === null || _a === void 0 ? void 0 : _a.uea) === null || _b === void 0 ? void 0 : _b.deployed;
+            if (deployedHint) {
+                const [balance, ueaNonce] = yield Promise.all([
+                    ctx.pushClient.getBalance(UEA),
+                    (0, uea_manager_1.getUEANonce)(ctx, UEA),
+                ]);
+                isUEADeployed = true;
+                nonce = ueaNonce;
+                funds = balance;
+            }
+            else {
+                const [code, balance] = yield Promise.all([
+                    ctx.pushClient.publicClient.getCode({ address: UEA }),
+                    ctx.pushClient.getBalance(UEA),
+                ]);
+                isUEADeployed = code !== undefined;
+                nonce = isUEADeployed ? yield (0, uea_manager_1.getUEANonce)(ctx, UEA) : BigInt(0);
+                funds = balance;
+            }
+        }
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_03_02, UEA, isUEADeployed);
+        // Validate and decode feeLockTxHash
+        let feeLockTxHash = execute.feeLockTxHash;
+        if (feeLockTxHash) {
+            (0, helpers_1.validateFeeLockTxHash)(feeLockTxHash);
+            if (!feeLockTxHash.startsWith('0x')) {
+                const decoded = bs58_1.bs58.decode(feeLockTxHash);
+                feeLockTxHash = (0, viem_1.bytesToHex)(new Uint8Array(decoded));
+            }
+        }
+        const feeLockingRequired = !execute._skipFeeLocking &&
+            (!isUEADeployed || funds < requiredFunds) && !feeLockTxHash;
+        // Support multicall payload encoding when execute.data is an array
+        let payloadData;
+        let payloadTo;
+        let req;
+        if (Array.isArray(execute.data)) {
+            payloadTo = viem_1.zeroAddress;
+            payloadData = (0, payload_builder_1.buildMulticallPayloadData)(ctx, execute.to, (0, payload_builders_1.buildExecuteMulticall)({ execute, ueaAddress: UEA }));
+            // Wrap in full UniversalPayload encoding for gateway req (matches non-array paths)
+            const universalPayloadForReq = JSON.parse(JSON.stringify({
+                to: viem_1.zeroAddress, value: execute.value,
+                data: payloadData,
+                gasLimit: execute.gasLimit || BigInt(5e7),
+                maxFeePerGas: execute.maxFeePerGas || BigInt(1e10),
+                maxPriorityFeePerGas: execute.maxPriorityFeePerGas || BigInt(0),
+                nonce, deadline: execute.deadline || BigInt(9999999999),
+                vType: feeLockingRequired
+                    ? tx_1.VerificationType.universalTxVerification
+                    : tx_1.VerificationType.signedVerification,
+            }, helpers_1.bigintReplacer));
+            req = (0, payload_builder_1.buildUniversalTxRequest)(ctx.universalSigner.account.address, {
+                recipient: viem_1.zeroAddress, token: viem_1.zeroAddress, amount: BigInt(0),
+                payload: (0, signing_1.encodeUniversalPayload)(universalPayloadForReq),
+            });
+        }
+        else {
+            if (execute.to.toLowerCase() !== UEA.toLowerCase()) {
+                if (execute.funds) {
+                    payloadTo = viem_1.zeroAddress;
+                    payloadData = (0, payload_builder_1.buildMulticallPayloadData)(ctx, execute.to, (0, payload_builders_1.buildExecuteMulticall)({ execute, ueaAddress: UEA }));
+                    req = (0, payload_builder_1.buildUniversalTxRequest)(ctx.universalSigner.account.address, {
+                        recipient: viem_1.zeroAddress, token: viem_1.zeroAddress, amount: BigInt(0), payload: payloadData,
+                    });
+                }
+                else {
+                    payloadTo = execute.to;
+                    payloadData = execute.data || '0x';
+                    const reqData = (0, payload_builder_1.buildMulticallPayloadData)(ctx, execute.to, (0, payload_builders_1.buildExecuteMulticall)({ execute, ueaAddress: UEA }));
+                    const universalPayloadOther = JSON.parse(JSON.stringify({
+                        to: viem_1.zeroAddress, value: execute.value,
+                        data: reqData,
+                        gasLimit: execute.gasLimit || BigInt(5e7),
+                        maxFeePerGas: execute.maxFeePerGas || BigInt(1e10),
+                        maxPriorityFeePerGas: execute.maxPriorityFeePerGas || BigInt(0),
+                        nonce, deadline: execute.deadline || BigInt(9999999999),
+                        vType: feeLockingRequired
+                            ? tx_1.VerificationType.universalTxVerification
+                            : tx_1.VerificationType.signedVerification,
+                    }, helpers_1.bigintReplacer));
+                    req = (0, payload_builder_1.buildUniversalTxRequest)(ctx.universalSigner.account.address, {
+                        recipient: viem_1.zeroAddress, token: viem_1.zeroAddress, amount: BigInt(0),
+                        payload: (0, signing_1.encodeUniversalPayload)(universalPayloadOther),
+                    });
+                }
+            }
+            else {
+                payloadTo = execute.to;
+                payloadData = execute.data || '0x';
+                const reqData = (0, payload_builder_1.buildMulticallPayloadData)(ctx, execute.to, (0, payload_builders_1.buildExecuteMulticall)({ execute, ueaAddress: UEA }));
+                const universalPayloadSelf = JSON.parse(JSON.stringify({
+                    to: viem_1.zeroAddress, value: execute.value,
+                    data: reqData,
+                    gasLimit: execute.gasLimit || BigInt(5e7),
+                    maxFeePerGas: execute.maxFeePerGas || BigInt(1e10),
+                    maxPriorityFeePerGas: execute.maxPriorityFeePerGas || BigInt(0),
+                    nonce, deadline: execute.deadline || BigInt(9999999999),
+                    vType: feeLockingRequired
+                        ? tx_1.VerificationType.universalTxVerification
+                        : tx_1.VerificationType.signedVerification,
+                }, helpers_1.bigintReplacer));
+                req = (0, payload_builder_1.buildUniversalTxRequest)(ctx.universalSigner.account.address, {
+                    recipient: viem_1.zeroAddress, token: viem_1.zeroAddress, amount: BigInt(0),
+                    payload: (0, signing_1.encodeUniversalPayload)(universalPayloadSelf),
+                });
+            }
+        }
+        const universalPayload = JSON.parse(JSON.stringify({
+            to: payloadTo, value: execute.value, data: payloadData,
+            gasLimit: execute.gasLimit || BigInt(5e7),
+            maxFeePerGas: execute.maxFeePerGas || BigInt(1e10),
+            maxPriorityFeePerGas: execute.maxPriorityFeePerGas || BigInt(0),
+            nonce, deadline: execute.deadline || BigInt(9999999999),
+            vType: feeLockingRequired
+                ? tx_1.VerificationType.universalTxVerification
+                : tx_1.VerificationType.signedVerification,
+        }, helpers_1.bigintReplacer));
+        // Prepare verification data by either signature or fund locking
+        let verificationData;
+        if (!feeLockingRequired) {
+            const ueaVersion = yield (0, uea_manager_1.fetchUEAVersion)(ctx);
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_02);
+            const signature = yield (0, signing_1.signUniversalPayload)(ctx, universalPayload, UEA, ueaVersion);
+            verificationData = (0, viem_1.bytesToHex)(signature);
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_03);
+        }
+        else {
+            // Fee Locking
+            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);
+            const feeLockTxHashBytes = yield (0, gateway_client_1.lockFee)(ctx, lockAmountInUSD, universalPayload, req);
+            feeLockTxHash = (0, viem_1.bytesToHex)(feeLockTxHashBytes);
+            verificationData = (0, viem_1.bytesToHex)(feeLockTxHashBytes);
+            const { vm } = chain_1.CHAIN_INFO[chain];
+            const feeLockTxHashDisplay = vm === enums_1.VM.SVM
+                ? bs58_1.bs58.encode(Buffer.from(feeLockTxHashBytes))
+                : feeLockTxHash;
+            const originTx = yield (0, helpers_1.fetchOriginChainTransactionForProgress)(ctx, chain, feeLockTxHash, feeLockTxHashDisplay);
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_05_01, feeLockTxHashDisplay, originTx);
+            yield (0, confirmation_1.waitForLockerFeeConfirmation)(ctx, feeLockTxHashBytes);
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_05_02);
+            const { defaultRPC, lockerContract } = chain_1.CHAIN_INFO[chain];
+            const pushChainUniversalTx = yield (0, response_builder_1.queryUniversalTxStatusFromGatewayTx)(ctx, new evm_client_1.EvmClient({ rpcUrls: ctx.rpcUrls[chain] || defaultRPC }), lockerContract, feeLockTxHash, 'sendTxWithGas');
+            const response = yield (0, push_chain_tx_1.extractPcTxAndTransform)(ctx, pushChainUniversalTx, feeLockTxHash, eventBuffer, 'sendTxWithGas', transformFn);
+            (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_01, [response]);
+            return response;
+        }
+        // Non-fee-locking path: Broadcasting Tx to PC via sendUniversalTx
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_07);
+        const transactions = yield (0, push_chain_tx_1.sendUniversalTx)(ctx, isUEADeployed, feeLockTxHash, universalPayload, verificationData, eventBuffer, transformFn);
+        (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_01, transactions);
+        return transactions[transactions.length - 1];
+    });
+}
+//# sourceMappingURL=execute-standard.js.map

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

@@ -0,0 +1,38 @@
+/**
+ * Gas fee queries, native amount calculations, ERC-20 allowance,
+ * and Uniswap V3 quoting — extracted from Orchestrator.
+ */
+import { CHAIN } from '../../constants/enums';
+import { ConversionQuote, MoveableToken, PayableToken } from '../../constants/tokens';
+import { EvmClient } from '../../vm-client/evm-client';
+import type { OrchestratorContext } from './context';
+export declare function ensureErc20Allowance(ctx: OrchestratorContext, evmClient: EvmClient, tokenAddress: `0x${string}`, spender: `0x${string}`, requiredAmount: bigint): Promise<void>;
+export declare function queryOutboundGasFee(ctx: OrchestratorContext, prc20Token: `0x${string}`, gasLimit: bigint): Promise<{
+    gasToken: `0x${string}`;
+    gasFee: bigint;
+    protocolFee: bigint;
+    nativeValueForGas: bigint;
+    gasPrice: bigint;
+    universalCoreAddress: `0x${string}`;
+}>;
+/**
+ * Estimate the native WPC amount needed to swap for `gasFee` of `gasToken`
+ * by reading the Uniswap V3 pool price on Push Chain.
+ * Returns the estimated amount with a 2x safety buffer (excess is refunded by the contract).
+ * Falls back to a percentage of accountBalance if any on-chain query fails.
+ */
+export declare function estimateNativeValueForSwap(ctx: OrchestratorContext, universalCoreAddress: `0x${string}`, gasToken: `0x${string}`, gasFee: bigint, accountBalance: bigint): Promise<bigint>;
+export declare function queryRescueGasFee(ctx: OrchestratorContext, prc20Token: `0x${string}`): Promise<{
+    gasToken: `0x${string}`;
+    gasFee: bigint;
+    rescueGasLimit: bigint;
+    gasPrice: bigint;
+    nativeValueForGas: bigint;
+}>;
+export declare function calculateNativeAmountForDeposit(ctx: OrchestratorContext, chain: CHAIN, requiredFunds: bigint, ueaBalance: bigint): Promise<bigint>;
+export declare function calculateGasAmountFromAmountOutMinETH(ctx: OrchestratorContext, gasTokenAddress: `0x${string}`, amountOutMinETH: bigint | string, quoteExactOutputFn: (amountOut: bigint, opts: {
+    from: PayableToken | undefined;
+    to: MoveableToken | undefined;
+}) => Promise<ConversionQuote>): Promise<{
+    gasAmount: bigint;
+}>;