@pushchain/core 5.1.3 → 5.1.4-alpha.1

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

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Pure utility functions extracted from Orchestrator.
+ *
+ * These have minimal dependencies and are used across multiple submodules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_GATEWAY_CHAINS = void 0;
+exports.isPushChain = isPushChain;
+exports.getPushChainForNetwork = getPushChainForNetwork;
+exports.getChainNamespace = getChainNamespace;
+exports.chainFromNamespace = chainFromNamespace;
+exports.getNativePRC20ForChain = getNativePRC20ForChain;
+exports.getUniversalGatewayPCAddress = getUniversalGatewayPCAddress;
+exports.validateFeeLockTxHash = validateFeeLockTxHash;
+exports.validateMainnetConnection = validateMainnetConnection;
+exports.bigintReplacer = bigintReplacer;
+exports.toExecuteParams = toExecuteParams;
+exports.fetchOriginChainTransactionForProgress = fetchOriginChainTransactionForProgress;
+const tslib_1 = require("tslib");
+const web3_js_1 = require("@solana/web3.js");
+const chain_1 = require("../../constants/chain");
+const context_1 = require("./context");
+const enums_1 = require("../../constants/enums");
+/** Chains that support gateway operations (multicall, funds bridging, etc.) */
+exports.SUPPORTED_GATEWAY_CHAINS = [
+    enums_1.CHAIN.ETHEREUM_SEPOLIA,
+    enums_1.CHAIN.ARBITRUM_SEPOLIA,
+    enums_1.CHAIN.BASE_SEPOLIA,
+    enums_1.CHAIN.BNB_TESTNET,
+    enums_1.CHAIN.SOLANA_DEVNET,
+];
+// ============================================================================
+// Chain Helpers
+// ============================================================================
+function isPushChain(chain) {
+    return (chain === enums_1.CHAIN.PUSH_MAINNET ||
+        chain === enums_1.CHAIN.PUSH_TESTNET_DONUT ||
+        chain === enums_1.CHAIN.PUSH_LOCALNET);
+}
+function getPushChainForNetwork(pushNetwork) {
+    if (pushNetwork === enums_1.PUSH_NETWORK.MAINNET) {
+        return enums_1.CHAIN.PUSH_MAINNET;
+    }
+    else if (pushNetwork === enums_1.PUSH_NETWORK.TESTNET_DONUT ||
+        pushNetwork === enums_1.PUSH_NETWORK.TESTNET) {
+        return enums_1.CHAIN.PUSH_TESTNET_DONUT;
+    }
+    else {
+        return enums_1.CHAIN.PUSH_LOCALNET;
+    }
+}
+function getChainNamespace(chain) {
+    const { vm, chainId } = chain_1.CHAIN_INFO[chain];
+    const namespace = chain_1.VM_NAMESPACE[vm];
+    return `${namespace}:${chainId}`;
+}
+function chainFromNamespace(namespace) {
+    for (const [chainKey, info] of Object.entries(chain_1.CHAIN_INFO)) {
+        const expected = `${chain_1.VM_NAMESPACE[info.vm]}:${info.chainId}`;
+        if (expected === namespace) {
+            return chainKey;
+        }
+    }
+    return null;
+}
+function getNativePRC20ForChain(targetChain, pushNetwork) {
+    const synthetics = chain_1.SYNTHETIC_PUSH_ERC20[pushNetwork];
+    switch (targetChain) {
+        case enums_1.CHAIN.ETHEREUM_SEPOLIA:
+        case enums_1.CHAIN.ETHEREUM_MAINNET:
+            return synthetics.pETH;
+        case enums_1.CHAIN.ARBITRUM_SEPOLIA:
+            return synthetics.pETH_ARB;
+        case enums_1.CHAIN.BASE_SEPOLIA:
+            return synthetics.pETH_BASE;
+        case enums_1.CHAIN.BNB_TESTNET:
+            return synthetics.pETH_BNB;
+        case enums_1.CHAIN.SOLANA_DEVNET:
+        case enums_1.CHAIN.SOLANA_TESTNET:
+        case enums_1.CHAIN.SOLANA_MAINNET:
+            return synthetics.pSOL;
+        default:
+            throw new Error(`No native PRC-20 token mapping for chain ${targetChain}. ` +
+                `Use 'funds' parameter to specify the token explicitly.`);
+    }
+}
+// ============================================================================
+// Address / Contract Helpers
+// ============================================================================
+function getUniversalGatewayPCAddress() {
+    // UniversalGatewayPC is a precompile at a fixed address on Push Chain
+    return '0x00000000000000000000000000000000000000C1';
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Validates that a feeLockTxHash is a well-formed transaction hash.
+ * EVM: must be 0x-prefixed 64-hex-char string (66 chars total).
+ * SVM (Base58): must be at least 32 chars.
+ */
+function validateFeeLockTxHash(feeLockTxHash) {
+    if (feeLockTxHash.startsWith('0x')) {
+        if (!/^0x[0-9a-fA-F]{64}$/.test(feeLockTxHash)) {
+            throw new Error(`Invalid feeLockTxHash: expected 0x-prefixed 64-character hex string, got "${feeLockTxHash}"`);
+        }
+    }
+    else {
+        if (feeLockTxHash.length < 32) {
+            throw new Error(`Invalid feeLockTxHash: expected Base58 transaction hash (>=32 chars), got "${feeLockTxHash}"`);
+        }
+    }
+}
+function validateMainnetConnection(chain, pushChainId) {
+    const isMainnet = [enums_1.CHAIN.ETHEREUM_MAINNET, enums_1.CHAIN.SOLANA_MAINNET].includes(chain);
+    if (isMainnet &&
+        pushChainId !== chain_1.CHAIN_INFO[enums_1.CHAIN.PUSH_MAINNET].chainId) {
+        throw new Error('Mainnet chains can only interact with Push Mainnet');
+    }
+}
+// ============================================================================
+// Serialization
+// ============================================================================
+function bigintReplacer(_key, value) {
+    return typeof value === 'bigint' ? value.toString() : value;
+}
+// ============================================================================
+// Params Conversion
+// ============================================================================
+function toExecuteParams(params) {
+    const to = typeof params.to === 'string'
+        ? params.to
+        : params.to.address;
+    return {
+        to,
+        value: params.value,
+        data: params.data,
+        funds: params.funds,
+        gasLimit: params.gasLimit,
+        maxFeePerGas: params.maxFeePerGas,
+        maxPriorityFeePerGas: params.maxPriorityFeePerGas,
+        deadline: params.deadline,
+        payGasWith: params.payGasWith,
+        feeLockTxHash: params.feeLockTxHash,
+    };
+}
+// ============================================================================
+// Origin Chain Transaction for Progress
+// ============================================================================
+function fetchOriginChainTransactionForProgress(ctx, chain, txHashHex, txHashDisplay) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const { vm, defaultRPC } = chain_1.CHAIN_INFO[chain];
+        const rpcUrls = ctx.rpcUrls[chain] || defaultRPC;
+        try {
+            if (vm === enums_1.VM.EVM) {
+                if (!txHashHex.startsWith('0x')) {
+                    throw new Error('EVM transaction hash must be 0x-prefixed');
+                }
+                const evmClient = (0, context_1.getOriginEvmClient)(ctx);
+                const tx = yield evmClient.publicClient.getTransaction({
+                    hash: txHashHex,
+                });
+                return tx !== null && tx !== void 0 ? tx : undefined;
+            }
+            if (vm === enums_1.VM.SVM) {
+                const connection = new web3_js_1.Connection(rpcUrls[0], 'confirmed');
+                const tx = yield connection.getTransaction(txHashDisplay, {
+                    maxSupportedTransactionVersion: 0,
+                    commitment: 'confirmed',
+                });
+                return tx !== null && tx !== void 0 ? tx : undefined;
+            }
+            return undefined;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    });
+}
+//# sourceMappingURL=helpers.js.map

package/src/lib/orchestrator/internals/index.d.ts

@@ -0,0 +1,24 @@
+export type { OrchestratorContext } from './context';
+export { printLog, fireProgressHook } from './context';
+export { isPushChain, getPushChainForNetwork, getChainNamespace, chainFromNamespace, getNativePRC20ForChain, getUniversalGatewayPCAddress, validateMainnetConnection, bigintReplacer, toExecuteParams, fetchOriginChainTransactionForProgress, SUPPORTED_GATEWAY_CHAINS, } from './helpers';
+export { buildUniversalTxRequest, buildMulticallPayloadData, buildGatewayPayloadAndGas, } from './payload-builder';
+export { computeExecutionHash, computeMigrationHash, signUniversalPayload, signMigrationPayload, encodeUniversalPayload, encodeUniversalPayloadSvm, } from './signing';
+export { waitForEvmConfirmationsWithCountdown, waitForSvmConfirmationsWithCountdown, waitForLockerFeeConfirmation, } from './confirmation';
+export { buildSvmUniversalTxRequest, buildSvmUniversalTxRequestFromReq, getSvmProtocolFee, getSvmGatewayLogIndexFromTx, } from './svm-helpers';
+export { computeUniversalTxId, extractUniversalSubTxIdFromTx, extractAllUniversalSubTxIds, } from './outbound-tracker';
+export { waitForOutboundTx, waitForAllOutboundTxsV2, OUTBOUND_INITIAL_WAIT_MS, OUTBOUND_POLL_INTERVAL_MS, OUTBOUND_MAX_TIMEOUT_MS, } from './outbound-sync';
+export { transformToUniversalTxReceipt, reconstructProgressEvents, detectRouteFromUniversalTxData, } from './tx-transformer';
+export { ensureErc20Allowance, queryOutboundGasFee, queryRescueGasFee, calculateNativeAmountForDeposit, calculateGasAmountFromAmountOutMinETH, } from './gas-calculator';
+export { quoteExactOutput } from './quote';
+export { computeUEAOffchain, computeUEA, getUEANonce, getUeaNonceForExecution, getUeaStatusAndNonce, fetchUEAVersion, } from './uea-manager';
+export { getAccountStatus, upgradeAccount, fetchLatestUEAVersion, migrateCEA, } from './account-manager';
+export { toGatewayRequestV1, toGatewayTokenRequestV1, sendGatewayTxWithFallback, sendGatewayTokenTxWithFallback, lockFee, getOriginGatewayContext, } from './gateway-client';
+export { queryUniversalTxStatusFromGatewayTx, trackTransaction, transformToUniversalTxResponse, type ResponseBuilderCallbacks, } from './response-builder';
+export { sendPushTx, sendUniversalTx, extractPcTxAndTransform } from './push-chain-tx';
+export { executeMultiChain, executeUoaToCea, executeUoaToCeaSvm, executeCeaToPush, executeCeaToPushSvm, executeCeaToCea, buildPayloadForRoute, } from './route-handlers';
+export { prepareTransaction, buildHopDescriptor, classifyIntoSegments, getSegmentType, composeCascade, createCascadedBuilder, type CascadeCallbacks, } from './cascade';
+export { sendSVMTxWithFunds } from './svm-bridge';
+export { rescueFunds } from './rescue';
+export { executeFundsOnly } from './execute-funds-only';
+export { executeFundsWithPayload } from './execute-funds-payload';
+export { executeStandardPayload } from './execute-standard';

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

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUeaNonceForExecution = exports.getUEANonce = exports.computeUEA = exports.computeUEAOffchain = exports.quoteExactOutput = exports.calculateGasAmountFromAmountOutMinETH = exports.calculateNativeAmountForDeposit = exports.queryRescueGasFee = exports.queryOutboundGasFee = exports.ensureErc20Allowance = exports.detectRouteFromUniversalTxData = exports.reconstructProgressEvents = exports.transformToUniversalTxReceipt = exports.OUTBOUND_MAX_TIMEOUT_MS = exports.OUTBOUND_POLL_INTERVAL_MS = exports.OUTBOUND_INITIAL_WAIT_MS = exports.waitForAllOutboundTxsV2 = exports.waitForOutboundTx = exports.extractAllUniversalSubTxIds = exports.extractUniversalSubTxIdFromTx = exports.computeUniversalTxId = exports.getSvmGatewayLogIndexFromTx = exports.getSvmProtocolFee = exports.buildSvmUniversalTxRequestFromReq = exports.buildSvmUniversalTxRequest = exports.waitForLockerFeeConfirmation = exports.waitForSvmConfirmationsWithCountdown = exports.waitForEvmConfirmationsWithCountdown = exports.encodeUniversalPayloadSvm = exports.encodeUniversalPayload = exports.signMigrationPayload = exports.signUniversalPayload = exports.computeMigrationHash = exports.computeExecutionHash = exports.buildGatewayPayloadAndGas = exports.buildMulticallPayloadData = exports.buildUniversalTxRequest = exports.SUPPORTED_GATEWAY_CHAINS = exports.fetchOriginChainTransactionForProgress = exports.toExecuteParams = exports.bigintReplacer = exports.validateMainnetConnection = exports.getUniversalGatewayPCAddress = exports.getNativePRC20ForChain = exports.chainFromNamespace = exports.getChainNamespace = exports.getPushChainForNetwork = exports.isPushChain = exports.fireProgressHook = exports.printLog = void 0;
+exports.executeStandardPayload = exports.executeFundsWithPayload = exports.executeFundsOnly = exports.rescueFunds = exports.sendSVMTxWithFunds = exports.createCascadedBuilder = exports.composeCascade = exports.getSegmentType = exports.classifyIntoSegments = exports.buildHopDescriptor = exports.prepareTransaction = exports.buildPayloadForRoute = exports.executeCeaToCea = exports.executeCeaToPushSvm = exports.executeCeaToPush = exports.executeUoaToCeaSvm = exports.executeUoaToCea = exports.executeMultiChain = exports.extractPcTxAndTransform = exports.sendUniversalTx = exports.sendPushTx = exports.transformToUniversalTxResponse = exports.trackTransaction = exports.queryUniversalTxStatusFromGatewayTx = exports.getOriginGatewayContext = exports.lockFee = exports.sendGatewayTokenTxWithFallback = exports.sendGatewayTxWithFallback = exports.toGatewayTokenRequestV1 = exports.toGatewayRequestV1 = exports.migrateCEA = exports.fetchLatestUEAVersion = exports.upgradeAccount = exports.getAccountStatus = exports.fetchUEAVersion = exports.getUeaStatusAndNonce = void 0;
+var context_1 = require("./context");
+Object.defineProperty(exports, "printLog", { enumerable: true, get: function () { return context_1.printLog; } });
+Object.defineProperty(exports, "fireProgressHook", { enumerable: true, get: function () { return context_1.fireProgressHook; } });
+// === Chain Utilities & Misc ===
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "isPushChain", { enumerable: true, get: function () { return helpers_1.isPushChain; } });
+Object.defineProperty(exports, "getPushChainForNetwork", { enumerable: true, get: function () { return helpers_1.getPushChainForNetwork; } });
+Object.defineProperty(exports, "getChainNamespace", { enumerable: true, get: function () { return helpers_1.getChainNamespace; } });
+Object.defineProperty(exports, "chainFromNamespace", { enumerable: true, get: function () { return helpers_1.chainFromNamespace; } });
+Object.defineProperty(exports, "getNativePRC20ForChain", { enumerable: true, get: function () { return helpers_1.getNativePRC20ForChain; } });
+Object.defineProperty(exports, "getUniversalGatewayPCAddress", { enumerable: true, get: function () { return helpers_1.getUniversalGatewayPCAddress; } });
+Object.defineProperty(exports, "validateMainnetConnection", { enumerable: true, get: function () { return helpers_1.validateMainnetConnection; } });
+Object.defineProperty(exports, "bigintReplacer", { enumerable: true, get: function () { return helpers_1.bigintReplacer; } });
+Object.defineProperty(exports, "toExecuteParams", { enumerable: true, get: function () { return helpers_1.toExecuteParams; } });
+Object.defineProperty(exports, "fetchOriginChainTransactionForProgress", { enumerable: true, get: function () { return helpers_1.fetchOriginChainTransactionForProgress; } });
+Object.defineProperty(exports, "SUPPORTED_GATEWAY_CHAINS", { enumerable: true, get: function () { return helpers_1.SUPPORTED_GATEWAY_CHAINS; } });
+// === Payload Construction ===
+var payload_builder_1 = require("./payload-builder");
+Object.defineProperty(exports, "buildUniversalTxRequest", { enumerable: true, get: function () { return payload_builder_1.buildUniversalTxRequest; } });
+Object.defineProperty(exports, "buildMulticallPayloadData", { enumerable: true, get: function () { return payload_builder_1.buildMulticallPayloadData; } });
+Object.defineProperty(exports, "buildGatewayPayloadAndGas", { enumerable: true, get: function () { return payload_builder_1.buildGatewayPayloadAndGas; } });
+// === Signing & Encoding ===
+var signing_1 = require("./signing");
+Object.defineProperty(exports, "computeExecutionHash", { enumerable: true, get: function () { return signing_1.computeExecutionHash; } });
+Object.defineProperty(exports, "computeMigrationHash", { enumerable: true, get: function () { return signing_1.computeMigrationHash; } });
+Object.defineProperty(exports, "signUniversalPayload", { enumerable: true, get: function () { return signing_1.signUniversalPayload; } });
+Object.defineProperty(exports, "signMigrationPayload", { enumerable: true, get: function () { return signing_1.signMigrationPayload; } });
+Object.defineProperty(exports, "encodeUniversalPayload", { enumerable: true, get: function () { return signing_1.encodeUniversalPayload; } });
+Object.defineProperty(exports, "encodeUniversalPayloadSvm", { enumerable: true, get: function () { return signing_1.encodeUniversalPayloadSvm; } });
+// === Confirmation ===
+var confirmation_1 = require("./confirmation");
+Object.defineProperty(exports, "waitForEvmConfirmationsWithCountdown", { enumerable: true, get: function () { return confirmation_1.waitForEvmConfirmationsWithCountdown; } });
+Object.defineProperty(exports, "waitForSvmConfirmationsWithCountdown", { enumerable: true, get: function () { return confirmation_1.waitForSvmConfirmationsWithCountdown; } });
+Object.defineProperty(exports, "waitForLockerFeeConfirmation", { enumerable: true, get: function () { return confirmation_1.waitForLockerFeeConfirmation; } });
+// === SVM Helpers ===
+var svm_helpers_1 = require("./svm-helpers");
+Object.defineProperty(exports, "buildSvmUniversalTxRequest", { enumerable: true, get: function () { return svm_helpers_1.buildSvmUniversalTxRequest; } });
+Object.defineProperty(exports, "buildSvmUniversalTxRequestFromReq", { enumerable: true, get: function () { return svm_helpers_1.buildSvmUniversalTxRequestFromReq; } });
+Object.defineProperty(exports, "getSvmProtocolFee", { enumerable: true, get: function () { return svm_helpers_1.getSvmProtocolFee; } });
+Object.defineProperty(exports, "getSvmGatewayLogIndexFromTx", { enumerable: true, get: function () { return svm_helpers_1.getSvmGatewayLogIndexFromTx; } });
+// === Outbound Tracking ===
+var outbound_tracker_1 = require("./outbound-tracker");
+Object.defineProperty(exports, "computeUniversalTxId", { enumerable: true, get: function () { return outbound_tracker_1.computeUniversalTxId; } });
+Object.defineProperty(exports, "extractUniversalSubTxIdFromTx", { enumerable: true, get: function () { return outbound_tracker_1.extractUniversalSubTxIdFromTx; } });
+Object.defineProperty(exports, "extractAllUniversalSubTxIds", { enumerable: true, get: function () { return outbound_tracker_1.extractAllUniversalSubTxIds; } });
+var outbound_sync_1 = require("./outbound-sync");
+Object.defineProperty(exports, "waitForOutboundTx", { enumerable: true, get: function () { return outbound_sync_1.waitForOutboundTx; } });
+Object.defineProperty(exports, "waitForAllOutboundTxsV2", { enumerable: true, get: function () { return outbound_sync_1.waitForAllOutboundTxsV2; } });
+Object.defineProperty(exports, "OUTBOUND_INITIAL_WAIT_MS", { enumerable: true, get: function () { return outbound_sync_1.OUTBOUND_INITIAL_WAIT_MS; } });
+Object.defineProperty(exports, "OUTBOUND_POLL_INTERVAL_MS", { enumerable: true, get: function () { return outbound_sync_1.OUTBOUND_POLL_INTERVAL_MS; } });
+Object.defineProperty(exports, "OUTBOUND_MAX_TIMEOUT_MS", { enumerable: true, get: function () { return outbound_sync_1.OUTBOUND_MAX_TIMEOUT_MS; } });
+// === Transaction Transformation ===
+var tx_transformer_1 = require("./tx-transformer");
+Object.defineProperty(exports, "transformToUniversalTxReceipt", { enumerable: true, get: function () { return tx_transformer_1.transformToUniversalTxReceipt; } });
+Object.defineProperty(exports, "reconstructProgressEvents", { enumerable: true, get: function () { return tx_transformer_1.reconstructProgressEvents; } });
+Object.defineProperty(exports, "detectRouteFromUniversalTxData", { enumerable: true, get: function () { return tx_transformer_1.detectRouteFromUniversalTxData; } });
+// === Gas & Fees ===
+var gas_calculator_1 = require("./gas-calculator");
+Object.defineProperty(exports, "ensureErc20Allowance", { enumerable: true, get: function () { return gas_calculator_1.ensureErc20Allowance; } });
+Object.defineProperty(exports, "queryOutboundGasFee", { enumerable: true, get: function () { return gas_calculator_1.queryOutboundGasFee; } });
+Object.defineProperty(exports, "queryRescueGasFee", { enumerable: true, get: function () { return gas_calculator_1.queryRescueGasFee; } });
+Object.defineProperty(exports, "calculateNativeAmountForDeposit", { enumerable: true, get: function () { return gas_calculator_1.calculateNativeAmountForDeposit; } });
+Object.defineProperty(exports, "calculateGasAmountFromAmountOutMinETH", { enumerable: true, get: function () { return gas_calculator_1.calculateGasAmountFromAmountOutMinETH; } });
+var quote_1 = require("./quote");
+Object.defineProperty(exports, "quoteExactOutput", { enumerable: true, get: function () { return quote_1.quoteExactOutput; } });
+// === UEA Management ===
+var uea_manager_1 = require("./uea-manager");
+Object.defineProperty(exports, "computeUEAOffchain", { enumerable: true, get: function () { return uea_manager_1.computeUEAOffchain; } });
+Object.defineProperty(exports, "computeUEA", { enumerable: true, get: function () { return uea_manager_1.computeUEA; } });
+Object.defineProperty(exports, "getUEANonce", { enumerable: true, get: function () { return uea_manager_1.getUEANonce; } });
+Object.defineProperty(exports, "getUeaNonceForExecution", { enumerable: true, get: function () { return uea_manager_1.getUeaNonceForExecution; } });
+Object.defineProperty(exports, "getUeaStatusAndNonce", { enumerable: true, get: function () { return uea_manager_1.getUeaStatusAndNonce; } });
+Object.defineProperty(exports, "fetchUEAVersion", { enumerable: true, get: function () { return uea_manager_1.fetchUEAVersion; } });
+// === Account Management ===
+var account_manager_1 = require("./account-manager");
+Object.defineProperty(exports, "getAccountStatus", { enumerable: true, get: function () { return account_manager_1.getAccountStatus; } });
+Object.defineProperty(exports, "upgradeAccount", { enumerable: true, get: function () { return account_manager_1.upgradeAccount; } });
+Object.defineProperty(exports, "fetchLatestUEAVersion", { enumerable: true, get: function () { return account_manager_1.fetchLatestUEAVersion; } });
+Object.defineProperty(exports, "migrateCEA", { enumerable: true, get: function () { return account_manager_1.migrateCEA; } });
+// === Gateway Client ===
+var gateway_client_1 = require("./gateway-client");
+Object.defineProperty(exports, "toGatewayRequestV1", { enumerable: true, get: function () { return gateway_client_1.toGatewayRequestV1; } });
+Object.defineProperty(exports, "toGatewayTokenRequestV1", { enumerable: true, get: function () { return gateway_client_1.toGatewayTokenRequestV1; } });
+Object.defineProperty(exports, "sendGatewayTxWithFallback", { enumerable: true, get: function () { return gateway_client_1.sendGatewayTxWithFallback; } });
+Object.defineProperty(exports, "sendGatewayTokenTxWithFallback", { enumerable: true, get: function () { return gateway_client_1.sendGatewayTokenTxWithFallback; } });
+Object.defineProperty(exports, "lockFee", { enumerable: true, get: function () { return gateway_client_1.lockFee; } });
+Object.defineProperty(exports, "getOriginGatewayContext", { enumerable: true, get: function () { return gateway_client_1.getOriginGatewayContext; } });
+// === Response Building ===
+var response_builder_1 = require("./response-builder");
+Object.defineProperty(exports, "queryUniversalTxStatusFromGatewayTx", { enumerable: true, get: function () { return response_builder_1.queryUniversalTxStatusFromGatewayTx; } });
+Object.defineProperty(exports, "trackTransaction", { enumerable: true, get: function () { return response_builder_1.trackTransaction; } });
+Object.defineProperty(exports, "transformToUniversalTxResponse", { enumerable: true, get: function () { return response_builder_1.transformToUniversalTxResponse; } });
+// === Push Chain Transactions ===
+var push_chain_tx_1 = require("./push-chain-tx");
+Object.defineProperty(exports, "sendPushTx", { enumerable: true, get: function () { return push_chain_tx_1.sendPushTx; } });
+Object.defineProperty(exports, "sendUniversalTx", { enumerable: true, get: function () { return push_chain_tx_1.sendUniversalTx; } });
+Object.defineProperty(exports, "extractPcTxAndTransform", { enumerable: true, get: function () { return push_chain_tx_1.extractPcTxAndTransform; } });
+// === Route Handlers ===
+var route_handlers_1 = require("./route-handlers");
+Object.defineProperty(exports, "executeMultiChain", { enumerable: true, get: function () { return route_handlers_1.executeMultiChain; } });
+Object.defineProperty(exports, "executeUoaToCea", { enumerable: true, get: function () { return route_handlers_1.executeUoaToCea; } });
+Object.defineProperty(exports, "executeUoaToCeaSvm", { enumerable: true, get: function () { return route_handlers_1.executeUoaToCeaSvm; } });
+Object.defineProperty(exports, "executeCeaToPush", { enumerable: true, get: function () { return route_handlers_1.executeCeaToPush; } });
+Object.defineProperty(exports, "executeCeaToPushSvm", { enumerable: true, get: function () { return route_handlers_1.executeCeaToPushSvm; } });
+Object.defineProperty(exports, "executeCeaToCea", { enumerable: true, get: function () { return route_handlers_1.executeCeaToCea; } });
+Object.defineProperty(exports, "buildPayloadForRoute", { enumerable: true, get: function () { return route_handlers_1.buildPayloadForRoute; } });
+// === Cascade Composition ===
+var cascade_1 = require("./cascade");
+Object.defineProperty(exports, "prepareTransaction", { enumerable: true, get: function () { return cascade_1.prepareTransaction; } });
+Object.defineProperty(exports, "buildHopDescriptor", { enumerable: true, get: function () { return cascade_1.buildHopDescriptor; } });
+Object.defineProperty(exports, "classifyIntoSegments", { enumerable: true, get: function () { return cascade_1.classifyIntoSegments; } });
+Object.defineProperty(exports, "getSegmentType", { enumerable: true, get: function () { return cascade_1.getSegmentType; } });
+Object.defineProperty(exports, "composeCascade", { enumerable: true, get: function () { return cascade_1.composeCascade; } });
+Object.defineProperty(exports, "createCascadedBuilder", { enumerable: true, get: function () { return cascade_1.createCascadedBuilder; } });
+// === SVM Bridge ===
+var svm_bridge_1 = require("./svm-bridge");
+Object.defineProperty(exports, "sendSVMTxWithFunds", { enumerable: true, get: function () { return svm_bridge_1.sendSVMTxWithFunds; } });
+// === Rescue ===
+var rescue_1 = require("./rescue");
+Object.defineProperty(exports, "rescueFunds", { enumerable: true, get: function () { return rescue_1.rescueFunds; } });
+// === Execute Sub-flows ===
+var execute_funds_only_1 = require("./execute-funds-only");
+Object.defineProperty(exports, "executeFundsOnly", { enumerable: true, get: function () { return execute_funds_only_1.executeFundsOnly; } });
+var execute_funds_payload_1 = require("./execute-funds-payload");
+Object.defineProperty(exports, "executeFundsWithPayload", { enumerable: true, get: function () { return execute_funds_payload_1.executeFundsWithPayload; } });
+var execute_standard_1 = require("./execute-standard");
+Object.defineProperty(exports, "executeStandardPayload", { enumerable: true, get: function () { return execute_standard_1.executeStandardPayload; } });
+//# sourceMappingURL=index.js.map

package/src/lib/orchestrator/internals/outbound-sync.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Outbound transaction sync: polling helpers that wait for outbound
+ * transactions to complete on external chains.
+ *
+ * Extracted from Orchestrator.waitForOutboundTx / waitForAllOutboundTxsV2.
+ */
+import { CHAIN } from '../../constants/enums';
+import type { CascadeHopInfo, WaitForOutboundOptions, OutboundTxDetails, TransactionRouteType } from '../orchestrator.types';
+import type { OrchestratorContext } from './context';
+/** Initial wait before the first poll (ms). */
+export declare const OUTBOUND_INITIAL_WAIT_MS = 20000;
+/** Interval between consecutive polls (ms). */
+export declare const OUTBOUND_POLL_INTERVAL_MS = 5000;
+/** Maximum total timeout for the polling loop (ms). */
+export declare const OUTBOUND_MAX_TIMEOUT_MS = 180000;
+/**
+ * Wait for outbound transaction to complete and return external chain details.
+ * @internal Used by .wait() for outbound routes - not part of public API.
+ * Uses polling with configurable initial wait, interval, and timeout.
+ *
+ * Default strategy: 30s initial wait, then poll every 5s, 120s total timeout.
+ *
+ * @param ctx - Orchestrator context
+ * @param pushChainTxHash - The Push Chain transaction hash
+ * @param options - Polling configuration options
+ * @returns External chain tx details
+ * @throws Error on timeout
+ */
+export declare function waitForOutboundTx(ctx: OrchestratorContext, pushChainTxHash: string, options?: WaitForOutboundOptions): Promise<OutboundTxDetails>;
+/**
+ * Tracks ALL outbound transactions for a cascade with multiple outbound hops
+ * (e.g., BNB + Solana). Uses V2 API which returns outboundTx[] with per-outbound
+ * status tracking, matching each outbound to the correct hop by destination chain.
+ */
+export declare function waitForAllOutboundTxsV2(ctx: OrchestratorContext, pushChainTxHash: string, outboundHops: CascadeHopInfo[], options: {
+    initialWaitMs: number;
+    pollingIntervalMs: number;
+    timeout: number;
+    progressHook?: (event: {
+        hopIndex: number;
+        route: TransactionRouteType;
+        chain: CHAIN;
+        status: string;
+        txHash?: string;
+    }) => void;
+}): Promise<{
+    success: boolean;
+    failedAt?: number;
+}>;