@pushchain/core 5.1.3 → 5.1.4-alpha.0

package/src/lib/orchestrator/internals/payload-builder.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Payload construction functions for the orchestrator.
+ *
+ * buildUniversalTxRequest:     Creates gateway request with revert instruction
+ * buildMulticallPayloadData:   Encodes UEA_MULTICALL selector + abi-encoded calls
+ * buildGatewayPayloadAndGas:   Constructs UniversalPayload + gateway request for fund flows
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUniversalTxRequest = buildUniversalTxRequest;
+exports.buildMulticallPayloadData = buildMulticallPayloadData;
+exports.buildGatewayPayloadAndGas = buildGatewayPayloadAndGas;
+const tslib_1 = require("tslib");
+const viem_1 = require("viem");
+const tx_1 = require("../../generated/v1/tx");
+const payload_builders_1 = require("../payload-builders");
+const context_1 = require("./context");
+const helpers_1 = require("./helpers");
+const signing_1 = require("./signing");
+const uea_manager_1 = require("./uea-manager");
+// ============================================================================
+// Universal Tx Request Builder
+// ============================================================================
+function buildUniversalTxRequest(signerAddress, { recipient, token, amount, payload, }) {
+    const revertInstruction = {
+        fundRecipient: signerAddress,
+        revertMsg: '0x',
+    };
+    return {
+        recipient,
+        token,
+        amount,
+        payload,
+        revertInstruction,
+        signatureData: '0x',
+    };
+}
+// ============================================================================
+// Multicall Encoding
+// ============================================================================
+function buildMulticallPayloadData(ctx, to, data) {
+    (0, context_1.printLog)(ctx, '_buildMulticallPayloadData — input: ' +
+        data.length +
+        ' calls: ' +
+        JSON.stringify(data, (_, v) => (typeof v === 'bigint' ? v.toString() : v), 2));
+    if (!helpers_1.SUPPORTED_GATEWAY_CHAINS.includes(ctx.universalSigner.account.chain)) {
+        throw new Error('Multicall is only enabled for Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, BNB Testnet and Solana Devnet');
+    }
+    // Normalize and validate calls
+    const normalizedCalls = data.map((c) => ({
+        to: (0, viem_1.getAddress)(c.to),
+        value: c.value,
+        data: c.data,
+    }));
+    // bytes4(keccak256("UEA_MULTICALL")) selector
+    const selector = (0, viem_1.keccak256)((0, viem_1.toBytes)('UEA_MULTICALL')).slice(0, 10);
+    // abi.encode(Call[]), where Call = { address to; uint256 value; bytes data; }
+    const encodedCalls = (0, viem_1.encodeAbiParameters)([
+        {
+            type: 'tuple[]',
+            components: [
+                { name: 'to', type: 'address' },
+                { name: 'value', type: 'uint256' },
+                { name: 'data', type: 'bytes' },
+            ],
+        },
+    ], [normalizedCalls]);
+    return (selector + encodedCalls.slice(2));
+}
+// ============================================================================
+// Gateway Payload + Gas Builder
+// ============================================================================
+/**
+ * Builds the universal payload and gateway request for sendFunds / sendTxWithFunds flows.
+ */
+function buildGatewayPayloadAndGas(ctx, execute, nonce, type, fundsValue) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6;
+        const gasEstimate = execute.gasLimit || BigInt(1e7);
+        const gasAmount = (_a = execute.value) !== null && _a !== void 0 ? _a : BigInt(0);
+        const ueaAddress = (0, uea_manager_1.computeUEAOffchain)(ctx);
+        if (type === 'sendTxWithFunds') {
+            if (!((_b = execute.funds) === null || _b === void 0 ? void 0 : _b.token))
+                throw new Error(`Invalid ${(_c = execute.funds) === null || _c === void 0 ? void 0 : _c.token}`);
+            const multicallData = (0, payload_builders_1.buildExecuteMulticall)({
+                execute,
+                ueaAddress,
+            });
+            const universalPayload = {
+                to: viem_1.zeroAddress,
+                value: (_d = execute.value) !== null && _d !== void 0 ? _d : BigInt(0),
+                data: buildMulticallPayloadData(ctx, execute.to, multicallData),
+                gasLimit: gasEstimate,
+                maxFeePerGas: execute.maxFeePerGas || BigInt(1e10),
+                maxPriorityFeePerGas: execute.maxPriorityFeePerGas || BigInt(0),
+                nonce,
+                deadline: execute.deadline || BigInt(9999999999),
+                vType: tx_1.VerificationType.universalTxVerification,
+            };
+            (0, context_1.printLog)(ctx, '(universalPayload) ' + universalPayload);
+            let tokenAddress = (_f = (_e = execute.funds) === null || _e === void 0 ? void 0 : _e.token) === null || _f === void 0 ? void 0 : _f.address;
+            if (((_h = (_g = execute.funds) === null || _g === void 0 ? void 0 : _g.token) === null || _h === void 0 ? void 0 : _h.address) ===
+                '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee') {
+                tokenAddress = viem_1.zeroAddress;
+            }
+            const req = buildUniversalTxRequest(ctx.universalSigner.account.address, {
+                recipient: viem_1.zeroAddress,
+                token: tokenAddress,
+                amount: (_j = execute.funds) === null || _j === void 0 ? void 0 : _j.amount,
+                payload: (0, signing_1.encodeUniversalPayload)(universalPayload),
+            });
+            return { payload: universalPayload, gasAmount, req };
+        }
+        else {
+            if (!fundsValue)
+                throw new Error('fundsValue property must not be empty');
+            const multicallData = (0, payload_builders_1.buildExecuteMulticall)({
+                execute,
+                ueaAddress,
+            });
+            (0, context_1.printLog)(ctx, 'sendFunds — execute params: ' + JSON.stringify({
+                to: execute.to,
+                value: (_l = (_k = execute.value) === null || _k === void 0 ? void 0 : _k.toString()) !== null && _l !== void 0 ? _l : 'undefined',
+                data: (_m = execute.data) !== null && _m !== void 0 ? _m : 'undefined',
+                fundsAmount: (_p = (_o = execute.funds) === null || _o === void 0 ? void 0 : _o.amount) === null || _p === void 0 ? void 0 : _p.toString(),
+                fundsToken: (_r = (_q = execute.funds) === null || _q === void 0 ? void 0 : _q.token) === null || _r === void 0 ? void 0 : _r.symbol,
+                tokenMechanism: (_t = (_s = execute.funds) === null || _s === void 0 ? void 0 : _s.token) === null || _t === void 0 ? void 0 : _t.mechanism,
+                tokenAddress: (_v = (_u = execute.funds) === null || _u === void 0 ? void 0 : _u.token) === null || _v === void 0 ? void 0 : _v.address,
+                gasLimit: (_x = (_w = execute.gasLimit) === null || _w === void 0 ? void 0 : _w.toString()) !== null && _x !== void 0 ? _x : 'undefined',
+            }, null, 2));
+            (0, context_1.printLog)(ctx, 'sendFunds — multicallData: ' + JSON.stringify(multicallData, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) + ' (length: ' + multicallData.length + ')');
+            const multicallPayloadData = buildMulticallPayloadData(ctx, execute.to, multicallData);
+            (0, context_1.printLog)(ctx, 'sendFunds — multicallPayloadData (first 66 chars): ' + multicallPayloadData.slice(0, 66) + ' (full length: ' + multicallPayloadData.length + ')');
+            const universalPayload = {
+                to: viem_1.zeroAddress,
+                value: (_y = execute.value) !== null && _y !== void 0 ? _y : BigInt(0),
+                data: multicallPayloadData,
+                gasLimit: gasEstimate,
+                maxFeePerGas: execute.maxFeePerGas || BigInt(1e10),
+                maxPriorityFeePerGas: execute.maxPriorityFeePerGas || BigInt(0),
+                nonce,
+                deadline: execute.deadline || BigInt(9999999999),
+                vType: tx_1.VerificationType.universalTxVerification,
+            };
+            (0, context_1.printLog)(ctx, 'sendFunds — universalPayload (pre-encode): ' + JSON.stringify({
+                to: viem_1.zeroAddress,
+                value: ((_z = execute.value) !== null && _z !== void 0 ? _z : BigInt(0)).toString(),
+                data: multicallPayloadData,
+                gasLimit: gasEstimate.toString(),
+                maxFeePerGas: (execute.maxFeePerGas || BigInt(1e10)).toString(),
+                maxPriorityFeePerGas: (execute.maxPriorityFeePerGas || BigInt(0)).toString(),
+                nonce: nonce.toString(),
+                deadline: (execute.deadline || BigInt(9999999999)).toString(),
+            }, null, 2));
+            let tokenAddress = (_1 = (_0 = execute.funds) === null || _0 === void 0 ? void 0 : _0.token) === null || _1 === void 0 ? void 0 : _1.address;
+            if (((_3 = (_2 = execute.funds) === null || _2 === void 0 ? void 0 : _2.token) === null || _3 === void 0 ? void 0 : _3.address) ===
+                '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee') {
+                tokenAddress = viem_1.zeroAddress;
+            }
+            const encodedPayload = (0, signing_1.encodeUniversalPayload)(universalPayload);
+            (0, context_1.printLog)(ctx, 'sendFunds — encodedPayload (first 66 chars): ' + encodedPayload.slice(0, 66) + ' (full length: ' + encodedPayload.length + ')');
+            const req = buildUniversalTxRequest(ctx.universalSigner.account.address, {
+                recipient: viem_1.zeroAddress,
+                token: tokenAddress,
+                amount: (_4 = execute.funds) === null || _4 === void 0 ? void 0 : _4.amount,
+                payload: encodedPayload,
+            });
+            (0, context_1.printLog)(ctx, 'sendFunds — final req: ' + JSON.stringify({
+                recipient: viem_1.zeroAddress,
+                token: tokenAddress,
+                amount: (_6 = (_5 = execute.funds) === null || _5 === void 0 ? void 0 : _5.amount) === null || _6 === void 0 ? void 0 : _6.toString(),
+                payloadLength: encodedPayload.length,
+            }, null, 2));
+            return { payload: universalPayload, gasAmount, req };
+        }
+    });
+}
+//# sourceMappingURL=payload-builder.js.map

package/src/lib/orchestrator/internals/payload-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-builder.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/orchestrator/internals/payload-builder.ts"],"names":[],"mappings":"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"}

package/src/lib/orchestrator/internals/push-chain-tx.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Push Chain transaction broadcasting — extracted from Orchestrator.
+ *
+ * sendPushTx:       Direct EVM tx on Push Chain (single or multicall batch)
+ * sendUniversalTx:  Cosmos-wrapped EVM tx via PushClient (gasless path)
+ */
+import type { UniversalTx } from '../../generated/uexecutor/v1/types';
+import { ProgressEvent } from '../../progress-hook/progress-hook.types';
+import { UniversalPayload } from '../../generated/v1/tx';
+import type { TxResponse } from '../../vm-client/vm-client.types';
+import type { ExecuteParams, UniversalTxResponse } from '../orchestrator.types';
+import type { OrchestratorContext } from './context';
+type TransformToResponseFn = (tx: TxResponse, eventBuffer: ProgressEvent[]) => Promise<UniversalTxResponse>;
+/**
+ * Sends an EVM transaction directly on Push Chain.
+ * Only used when universal signer is on Push Chain.
+ *
+ * For multicall arrays: executes each call as a separate transaction with
+ * local nonce management and per-tx receipt confirmation.
+ */
+export declare function sendPushTx(ctx: OrchestratorContext, execute: ExecuteParams, eventBuffer: ProgressEvent[], transformFn: TransformToResponseFn): Promise<UniversalTxResponse>;
+/**
+ * Sends a Cosmos tx to Push Chain (gasless) to execute user intent.
+ * Wraps the EVM payload in a MsgExecutePayload Cosmos message.
+ */
+export declare function sendUniversalTx(ctx: OrchestratorContext, isUEADeployed: boolean, feeLockTxHash: string | undefined, universalPayload: UniversalPayload | undefined, verificationData: `0x${string}` | undefined, eventBuffer: ProgressEvent[], transformFn: TransformToResponseFn): Promise<UniversalTxResponse[]>;
+/**
+ * Validates Push Chain tx response, extracts last pcTx, fetches EVM tx,
+ * and transforms to UniversalTxResponse.
+ */
+export declare function extractPcTxAndTransform(ctx: OrchestratorContext, pushChainUniversalTx: UniversalTx | undefined, gatewayTxHash: string, eventBuffer: ProgressEvent[], label: string, transformFn: TransformToResponseFn): Promise<UniversalTxResponse>;
+export {};

package/src/lib/orchestrator/internals/push-chain-tx.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Push Chain transaction broadcasting — extracted from Orchestrator.
+ *
+ * sendPushTx:       Direct EVM tx on Push Chain (single or multicall batch)
+ * sendUniversalTx:  Cosmos-wrapped EVM tx via PushClient (gasless path)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendPushTx = sendPushTx;
+exports.sendUniversalTx = sendUniversalTx;
+exports.extractPcTxAndTransform = extractPcTxAndTransform;
+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 context_1 = require("./context");
+// ============================================================================
+// sendPushTx
+// ============================================================================
+/**
+ * Sends an EVM transaction directly on Push Chain.
+ * Only used when universal signer is on Push Chain.
+ *
+ * For multicall arrays: executes each call as a separate transaction with
+ * local nonce management and per-tx receipt confirmation.
+ */
+function sendPushTx(ctx, execute, eventBuffer, transformFn) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        if (Array.isArray(execute.data)) {
+            const PUSH_CHAIN_GAS_LIMIT = BigInt(500000);
+            const MAX_NONCE_RETRIES = 3;
+            let nonce = yield ctx.pushClient.publicClient.getTransactionCount({
+                address: ctx.universalSigner.account.address,
+                blockTag: 'pending',
+            });
+            let lastTxHash = '0x';
+            const calls = execute.data;
+            for (let i = 0; i < calls.length; i++) {
+                const call = calls[i];
+                let txSent = false;
+                for (let retry = 0; retry < MAX_NONCE_RETRIES && !txSent; retry++) {
+                    try {
+                        (0, context_1.printLog)(ctx, `sendPushTx — executing multicall operation ${i + 1}/${calls.length} to: ${call.to} (nonce: ${nonce})`);
+                        lastTxHash = yield ctx.pushClient.sendTransaction({
+                            to: call.to,
+                            data: (call.data || '0x'),
+                            value: call.value,
+                            signer: ctx.universalSigner,
+                            nonce,
+                            gas: PUSH_CHAIN_GAS_LIMIT,
+                        });
+                        txSent = true;
+                    }
+                    catch (err) {
+                        const msg = (err === null || err === void 0 ? void 0 : err.message) || (err === null || err === void 0 ? void 0 : err.details) || '';
+                        if (msg.includes('invalid nonce') || msg.includes('invalid sequence')) {
+                            (0, context_1.printLog)(ctx, `sendPushTx — nonce mismatch on operation ${i + 1}/${calls.length} (retry ${retry + 1}/${MAX_NONCE_RETRIES}), re-fetching nonce`);
+                            nonce = yield ctx.pushClient.publicClient.getTransactionCount({
+                                address: ctx.universalSigner.account.address,
+                                blockTag: 'pending',
+                            });
+                        }
+                        else {
+                            throw err;
+                        }
+                    }
+                }
+                if (!txSent) {
+                    throw new Error(`sendPushTx — multicall operation ${i + 1}/${calls.length} failed after ${MAX_NONCE_RETRIES} nonce retries`);
+                }
+                const receipt = yield ctx.pushClient.publicClient.waitForTransactionReceipt({
+                    hash: lastTxHash,
+                });
+                if (receipt.status === 'reverted') {
+                    throw new Error(`sendPushTx — multicall operation ${i + 1}/${calls.length} reverted (to: ${call.to}, txHash: ${lastTxHash})`);
+                }
+                (0, context_1.printLog)(ctx, `sendPushTx — operation ${i + 1}/${calls.length} confirmed in block ${receipt.blockNumber}`);
+                nonce++;
+            }
+            const txResponse = yield ctx.pushClient.getTransaction(lastTxHash);
+            return yield transformFn(txResponse, eventBuffer);
+        }
+        const txHash = yield ctx.pushClient.sendTransaction({
+            to: execute.to,
+            data: (execute.data || '0x'),
+            value: execute.value,
+            signer: ctx.universalSigner,
+        });
+        const txResponse = yield ctx.pushClient.getTransaction(txHash);
+        return yield transformFn(txResponse, eventBuffer);
+    });
+}
+// ============================================================================
+// sendUniversalTx
+// ============================================================================
+/**
+ * Sends a Cosmos tx to Push Chain (gasless) to execute user intent.
+ * Wraps the EVM payload in a MsgExecutePayload Cosmos message.
+ */
+function sendUniversalTx(ctx, isUEADeployed, feeLockTxHash, universalPayload, verificationData, eventBuffer, transformFn) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const { chain, address } = ctx.universalSigner.account;
+        const { vm, chainId } = chain_1.CHAIN_INFO[chain];
+        const universalAccountId = {
+            chainNamespace: chain_1.VM_NAMESPACE[vm],
+            chainId: chainId,
+            owner: vm === enums_1.VM.EVM
+                ? address
+                : vm === enums_1.VM.SVM
+                    ? (0, viem_1.bytesToHex)(new Uint8Array(bs58_1.bs58.decode(address)))
+                    : address,
+        };
+        const { cosmosAddress: signer } = ctx.pushClient.getSignerAddress();
+        const msgs = [];
+        if (universalPayload && verificationData) {
+            msgs.push(ctx.pushClient.createMsgExecutePayload({
+                signer,
+                universalAccountId,
+                universalPayload,
+                verificationData,
+            }));
+        }
+        const txBody = yield ctx.pushClient.createCosmosTxBody(msgs);
+        const txRaw = yield ctx.pushClient.signCosmosTx(txBody);
+        const tx = yield ctx.pushClient.broadcastCosmosTx(txRaw);
+        if (tx.code !== 0) {
+            const failedEthTxHashes = (_b = (_a = tx.events) === null || _a === void 0 ? void 0 : _a.filter((e) => e.type === 'ethereum_tx').flatMap((e) => {
+                var _a;
+                return (_a = e.attributes) === null || _a === void 0 ? void 0 : _a.filter((attr) => attr.key === 'ethereumTxHash').map((attr) => attr.value);
+            })) !== null && _b !== void 0 ? _b : [];
+            const failureSummary = [
+                `PUSH CHAIN TRANSACTION FAILED`,
+                `Cosmos TX Hash: ${tx.transactionHash}`,
+                `Block Height: ${tx.height}, TX Code: ${tx.code} (error)`,
+                `Gas Used: ${tx.gasUsed}, Gas Wanted: ${tx.gasWanted}`,
+                ...(failedEthTxHashes.length > 0 ? [`Ethereum TX Hash(es): ${failedEthTxHashes.join(', ')}`] : []),
+                `Error: ${tx.rawLog}`,
+            ].join(' | ');
+            (0, context_1.printLog)(ctx, failureSummary);
+            throw new Error(tx.rawLog);
+        }
+        const ethTxHashes = (_d = (_c = tx.events) === null || _c === void 0 ? void 0 : _c.filter((e) => e.type === 'ethereum_tx').flatMap((e) => {
+            var _a;
+            return (_a = e.attributes) === null || _a === void 0 ? void 0 : _a.filter((attr) => attr.key === 'ethereumTxHash').map((attr) => attr.value);
+        })) !== null && _d !== void 0 ? _d : [];
+        if (ethTxHashes.length === 0) {
+            throw new Error('No ethereumTxHash found in transaction events');
+        }
+        const evmTxs = yield Promise.all(ethTxHashes.map((hash) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return yield ctx.pushClient.getTransaction(hash);
+        })));
+        const responses = yield Promise.all(evmTxs.map((tx, index) => transformFn(tx, index === evmTxs.length - 1 ? eventBuffer : [])));
+        return responses;
+    });
+}
+// ============================================================================
+// extractPcTxAndTransform
+// ============================================================================
+/**
+ * Validates Push Chain tx response, extracts last pcTx, fetches EVM tx,
+ * and transforms to UniversalTxResponse.
+ */
+function extractPcTxAndTransform(ctx, pushChainUniversalTx, gatewayTxHash, eventBuffer, label, transformFn) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (!((_a = pushChainUniversalTx === null || pushChainUniversalTx === void 0 ? void 0 : pushChainUniversalTx.pcTx) === null || _a === void 0 ? void 0 : _a.length)) {
+            throw new Error(`Failed to retrieve Push Chain transaction status for gateway tx: ${gatewayTxHash}. ` +
+                `The transaction may have failed on Push Chain or not been indexed yet.`);
+        }
+        const lastPcTransaction = pushChainUniversalTx.pcTx.at(-1);
+        (0, context_1.printLog)(ctx, `${label} — pcTx: ` + JSON.stringify(pushChainUniversalTx.pcTx.map((p) => ({ txHash: p.txHash, status: p.status, errorMsg: p.errorMsg })), null, 2));
+        (0, context_1.printLog)(ctx, `${label} — using lastPcTransaction: ` + JSON.stringify(lastPcTransaction, null, 2));
+        if (!(lastPcTransaction === null || lastPcTransaction === void 0 ? void 0 : lastPcTransaction.txHash)) {
+            const failedPcTx = pushChainUniversalTx.pcTx.find((pcTx) => pcTx.status === 'FAILED' && pcTx.errorMsg);
+            const errorDetails = (failedPcTx === null || failedPcTx === void 0 ? void 0 : failedPcTx.errorMsg) ? `: ${failedPcTx.errorMsg}` : '';
+            throw new Error(`No transaction hash found in Push Chain response for gateway tx: ${gatewayTxHash}${errorDetails}`);
+        }
+        const tx = yield ctx.pushClient.getTransaction(lastPcTransaction.txHash);
+        return transformFn(tx, eventBuffer);
+    });
+}
+//# sourceMappingURL=push-chain-tx.js.map

package/src/lib/orchestrator/internals/push-chain-tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-chain-tx.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/orchestrator/internals/push-chain-tx.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA0CH,gCAiFC;AAUD,0CA2FC;AAUD,0DA+BC;;AAvQD,8CAA2C;AAE3C,+BAAkC;AAClC,iDAAiE;AACjE,iDAA2C;AAc3C,uCAAqC;AAWrC,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAsB,UAAU,CAC9B,GAAwB,EACxB,OAAsB,EACtB,WAA4B,EAC5B,WAAkC;;QAElC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,iBAAiB,GAAG,CAAC,CAAC;YAC5B,IAAI,KAAK,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,mBAAmB,CAAC;gBAChE,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,OAAwB;gBAC7D,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;YACH,IAAI,UAAU,GAAkB,IAAI,CAAC;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAmB,CAAC;YAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,MAAM,GAAG,KAAK,CAAC;gBACnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,iBAAiB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;oBAClE,IAAI,CAAC;wBACH,IAAA,kBAAQ,EACN,GAAG,EACH,8CAA8C,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,QAAQ,IAAI,CAAC,EAAE,YAAY,KAAK,GAAG,CACvG,CAAC;wBACF,UAAU,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;4BAChD,EAAE,EAAE,IAAI,CAAC,EAAmB;4BAC5B,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAkB;4BAC1C,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,MAAM,EAAE,GAAG,CAAC,eAAe;4BAC3B,KAAK;4BACL,GAAG,EAAE,oBAAoB;yBAC1B,CAAC,CAAC;wBACH,MAAM,GAAG,IAAI,CAAC;oBAChB,CAAC;oBAAC,OAAO,GAAQ,EAAE,CAAC;wBAClB,MAAM,GAAG,GAAG,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,MAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,CAAA,IAAI,EAAE,CAAC;wBAC/C,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;4BACtE,IAAA,kBAAQ,EACN,GAAG,EACH,4CAA4C,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,WAAW,KAAK,GAAG,CAAC,IAAI,iBAAiB,sBAAsB,CACjI,CAAC;4BACF,KAAK,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,mBAAmB,CAAC;gCAC5D,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,OAAwB;gCAC7D,QAAQ,EAAE,SAAS;6BACpB,CAAC,CAAC;wBACL,CAAC;6BAAM,CAAC;4BACN,MAAM,GAAG,CAAC;wBACZ,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CACb,oCAAoC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,iBAAiB,iBAAiB,gBAAgB,CAC5G,CAAC;gBACJ,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,yBAAyB,CAAC;oBAC1E,IAAI,EAAE,UAAU;iBACjB,CAAC,CAAC;gBACH,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBAClC,MAAM,IAAI,KAAK,CACb,oCAAoC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,kBAAkB,IAAI,CAAC,EAAE,aAAa,UAAU,GAAG,CAC7G,CAAC;gBACJ,CAAC;gBACD,IAAA,kBAAQ,EACN,GAAG,EACH,0BAA0B,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,uBAAuB,OAAO,CAAC,WAAW,EAAE,CAC5F,CAAC;gBACF,KAAK,EAAE,CAAC;YACV,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO,MAAM,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;YAClD,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAkB;YAC7C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,GAAG,CAAC,eAAe;SAC5B,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC/D,OAAO,MAAM,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;CAAA;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;GAGG;AACH,SAAsB,eAAe,CACnC,GAAwB,EACxB,aAAsB,EACtB,aAAiC,EACjC,gBAA8C,EAC9C,gBAA2C,EAC3C,WAA4B,EAC5B,WAAkC;;;QAElC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC;QACvD,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,kBAAU,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,kBAAkB,GAAuB;YAC7C,cAAc,EAAE,oBAAY,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO;YAChB,KAAK,EACH,EAAE,KAAK,UAAE,CAAC,GAAG;gBACX,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,EAAE,KAAK,UAAE,CAAC,GAAG;oBACf,CAAC,CAAC,IAAA,iBAAU,EAAC,IAAI,UAAU,CAAC,WAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;oBAClD,CAAC,CAAC,OAAO;SACd,CAAC;QAEF,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACpE,MAAM,IAAI,GAAU,EAAE,CAAC;QAEvB,IAAI,gBAAgB,IAAI,gBAAgB,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,CACP,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;gBACrC,MAAM;gBACN,kBAAkB;gBAClB,gBAAgB;gBAChB,gBAAgB;aACjB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEzD,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAClB,MAAM,iBAAiB,GAAG,MAAA,MAAA,EAAE,CAAC,MAAM,0CAC/B,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,EAC5C,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE;;gBAClB,OAAA,MAAA,CAAC,CAAC,UAAU,0CACR,MAAM,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,gBAAgB,EACpD,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAsB,CAAC,CAAA;aAAA,CACnD,mCAAI,EAAE,CAAC;YAEV,MAAM,cAAc,GAAG;gBACrB,+BAA+B;gBAC/B,mBAAmB,EAAE,CAAC,eAAe,EAAE;gBACvC,iBAAiB,EAAE,CAAC,MAAM,cAAc,EAAE,CAAC,IAAI,UAAU;gBACzD,aAAa,EAAE,CAAC,OAAO,iBAAiB,EAAE,CAAC,SAAS,EAAE;gBACtD,GAAG,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClG,UAAU,EAAE,CAAC,MAAM,EAAE;aACtB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,IAAA,kBAAQ,EAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAE9B,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,WAAW,GACf,MAAA,MAAA,EAAE,CAAC,MAAM,0CACL,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,EAC5C,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE;;YAClB,OAAA,MAAA,CAAC,CAAC,UAAU,0CACR,MAAM,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,gBAAgB,EACpD,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAsB,CAAC,CAAA;SAAA,CACnD,mCAAI,EAAE,CAAC;QAEZ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,WAAW,CAAC,GAAG,CAAC,CAAO,IAAI,EAAE,EAAE;YAC7B,OAAO,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAA,CAAC,CACH,CAAC;QAEF,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CACvB,WAAW,CACT,EAAE,EACF,KAAK,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAC/C,CACF,CACF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;CAAA;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;GAGG;AACH,SAAsB,uBAAuB,CAC3C,GAAwB,EACxB,oBAA6C,EAC7C,aAAqB,EACrB,WAA4B,EAC5B,KAAa,EACb,WAAkC;;;QAElC,IAAI,CAAC,CAAA,MAAA,oBAAoB,aAApB,oBAAoB,uBAApB,oBAAoB,CAAE,IAAI,0CAAE,MAAM,CAAA,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,oEAAoE,aAAa,IAAI;gBACnF,wEAAwE,CAC3E,CAAC;QACJ,CAAC;QACD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAA,kBAAQ,EAAC,GAAG,EAAE,GAAG,KAAK,WAAW,GAAG,IAAI,CAAC,SAAS,CAChD,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,EACzG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACZ,IAAA,kBAAQ,EAAC,GAAG,EAAE,GAAG,KAAK,8BAA8B,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnG,IAAI,CAAC,CAAA,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,MAAM,CAAA,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAC/C,CAAC,IAA4C,EAAE,EAAE,CAC/C,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAC5C,CAAC;YACF,MAAM,YAAY,GAAG,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,QAAQ,EAAC,CAAC,CAAC,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CACb,oEAAoE,aAAa,GAAG,YAAY,EAAE,CACnG,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,iBAAiB,CAAC,MAAuB,CAAC,CAAC;QAC1F,OAAO,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACtC,CAAC;CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Uniswap V3 exact-output quoting — extracted from Orchestrator.
+ */
+import { ConversionQuote, MoveableToken, PayableToken } from '../../constants/tokens';
+import type { OrchestratorContext } from './context';
+export declare function quoteExactOutput(ctx: OrchestratorContext, amountOut: bigint, { from, to, }: {
+    from: PayableToken | undefined;
+    to: MoveableToken | undefined;
+}): Promise<ConversionQuote>;

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

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Uniswap V3 exact-output quoting — extracted from Orchestrator.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quoteExactOutput = quoteExactOutput;
+const tslib_1 = require("tslib");
+const viem_1 = require("viem");
+const chain_1 = require("../../constants/chain");
+const enums_1 = require("../../constants/enums");
+const utils_1 = require("../../utils");
+const evm_client_1 = require("../../vm-client/evm-client");
+function quoteExactOutput(ctx_1, amountOut_1, _a) {
+    return tslib_1.__awaiter(this, arguments, void 0, function* (ctx, amountOut, { from, to, }) {
+        var _b, _c, _d;
+        const originChain = ctx.universalSigner.account.chain;
+        if (originChain !== enums_1.CHAIN.ETHEREUM_MAINNET &&
+            originChain !== enums_1.CHAIN.ETHEREUM_SEPOLIA) {
+            throw new Error('Exact-output quoting is only supported on Ethereum Mainnet and Sepolia for now');
+        }
+        if (!from)
+            throw new Error('from token is required');
+        if (!to)
+            throw new Error('to token is required');
+        const rpcUrls = ctx.rpcUrls[originChain] || chain_1.CHAIN_INFO[originChain].defaultRPC;
+        const evm = new evm_client_1.EvmClient({ rpcUrls });
+        const factoryFromConfig = (_b = chain_1.CHAIN_INFO[originChain].dex) === null || _b === void 0 ? void 0 : _b.uniV3Factory;
+        const quoterFromConfig = (_c = chain_1.CHAIN_INFO[originChain].dex) === null || _c === void 0 ? void 0 : _c.uniV3QuoterV2;
+        if (!factoryFromConfig || !quoterFromConfig) {
+            throw new Error('Uniswap V3 addresses not configured for this chain');
+        }
+        const UNISWAP_V3_FACTORY = factoryFromConfig;
+        const UNISWAP_V3_QUOTER_V2 = quoterFromConfig;
+        const factoryAbi = (0, viem_1.parseAbi)([
+            'function getPool(address tokenA, address tokenB, uint24 fee) view returns (address)',
+        ]);
+        const quoterAbi = (0, viem_1.parseAbi)([
+            'function quoteExactOutputSingle((address tokenIn, address tokenOut, uint256 amount, uint24 fee, uint160 sqrtPriceLimitX96) params) returns (uint256 amountIn, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)',
+        ]);
+        const poolAbi = (0, viem_1.parseAbi)([
+            'function liquidity() view returns (uint128)',
+        ]);
+        const feeTiers = [100, 500, 3000, 10000];
+        let bestAmountIn = null;
+        let bestFee = null;
+        for (const fee of feeTiers) {
+            const poolAddress = yield evm.readContract({
+                abi: factoryAbi,
+                address: UNISWAP_V3_FACTORY,
+                functionName: 'getPool',
+                args: [from.address, to.address, fee],
+            });
+            const isZero = !poolAddress ||
+                poolAddress.toLowerCase() ===
+                    '0x0000000000000000000000000000000000000000';
+            if (isZero)
+                continue;
+            try {
+                const liquidity = yield evm.readContract({
+                    abi: poolAbi,
+                    address: poolAddress,
+                    functionName: 'liquidity',
+                    args: [],
+                });
+                if (!liquidity || liquidity === BigInt(0))
+                    continue;
+            }
+            catch (_e) {
+                continue;
+            }
+            try {
+                const result = yield evm.readContract({
+                    abi: quoterAbi,
+                    address: UNISWAP_V3_QUOTER_V2,
+                    functionName: 'quoteExactOutputSingle',
+                    args: [
+                        {
+                            tokenIn: from.address,
+                            tokenOut: to.address,
+                            amount: amountOut,
+                            fee,
+                            sqrtPriceLimitX96: BigInt(0),
+                        },
+                    ],
+                });
+                const amountIn = (_d = result === null || result === void 0 ? void 0 : result[0]) !== null && _d !== void 0 ? _d : BigInt(0);
+                if (amountIn === BigInt(0))
+                    continue;
+                if (bestAmountIn === null || amountIn < bestAmountIn) {
+                    bestAmountIn = amountIn;
+                    bestFee = fee;
+                }
+            }
+            catch (_f) {
+                // try next fee
+            }
+        }
+        if (bestAmountIn === null || bestFee === null) {
+            throw new Error('No direct Uniswap V3 pool found for the given token pair on common fee tiers');
+        }
+        const amountInBig = BigInt(bestAmountIn);
+        const amountInHuman = parseFloat(utils_1.Utils.helpers.formatUnits(amountInBig, { decimals: from.decimals }));
+        const amountOutHuman = parseFloat(utils_1.Utils.helpers.formatUnits(amountOut, { decimals: to.decimals }));
+        const rate = amountInHuman > 0 ? amountOutHuman / amountInHuman : 0;
+        return {
+            amountIn: bestAmountIn.toString(),
+            amountOut: amountOut.toString(),
+            rate,
+            route: [from.symbol, to.symbol],
+            timestamp: Date.now(),
+        };
+    });
+}
+//# sourceMappingURL=quote.js.map

package/src/lib/orchestrator/internals/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/orchestrator/internals/quote.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+/**
+ * Rescue funds flow — extracted from Orchestrator.rescueFunds.
+ *
+ * Recovers stuck tokens from failed inbound transactions by building
+ * a rescue multicall and executing it through the standard execute() flow.
+ */
+import type { ExecuteParams, RescueFundsParams, UniversalTxResponse } from '../orchestrator.types';
+import type { OrchestratorContext } from './context';
+/**
+ * Rescue stuck funds on a source chain.
+ * When a CEA-to-Push inbound transaction fails, tokens get locked in the
+ * Vault on the source chain. This triggers a manual revert via TSS to
+ * release those funds back to the user.
+ *
+ * @param ctx - Orchestrator context
+ * @param params - RescueFundsParams with universalTxId and prc20 token
+ * @param executeFn - The Orchestrator.execute() method (avoids circular dep)
+ * @returns Transaction response
+ */
+export declare function rescueFunds(ctx: OrchestratorContext, params: RescueFundsParams, executeFn: (params: ExecuteParams) => Promise<UniversalTxResponse>): Promise<UniversalTxResponse>;