@pushchain/core 5.1.3 → 5.1.4-alpha.1

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

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Transaction response/receipt transformation and progress reconstruction,
+ * extracted from Orchestrator.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformToUniversalTxReceipt = transformToUniversalTxReceipt;
+exports.reconstructProgressEvents = reconstructProgressEvents;
+exports.detectRouteFromUniversalTxData = detectRouteFromUniversalTxData;
+const tslib_1 = require("tslib");
+const chain_1 = require("../../constants/chain");
+const enums_1 = require("../../constants/enums");
+const types_1 = require("../../generated/uexecutor/v1/types");
+const progress_hook_1 = tslib_1.__importDefault(require("../../progress-hook/progress-hook"));
+const progress_hook_types_1 = require("../../progress-hook/progress-hook.types");
+const route_detector_1 = require("../route-detector");
+// ============================================================================
+// Receipt Transform
+// ============================================================================
+function transformToUniversalTxReceipt(receipt, originalTxResponse) {
+    return {
+        hash: receipt.transactionHash,
+        blockNumber: receipt.blockNumber,
+        blockHash: receipt.blockHash,
+        transactionIndex: receipt.transactionIndex,
+        from: originalTxResponse.from,
+        to: originalTxResponse.to,
+        contractAddress: receipt.contractAddress || null,
+        gasPrice: originalTxResponse.gasPrice || BigInt(0),
+        gasUsed: receipt.gasUsed,
+        cumulativeGasUsed: receipt.cumulativeGasUsed,
+        logs: receipt.logs || [],
+        logsBloom: receipt.logsBloom || '0x',
+        status: receipt.status === 'success' ? 1 : 0,
+        raw: originalTxResponse.raw || {
+            from: originalTxResponse.from,
+            to: originalTxResponse.to,
+        },
+    };
+}
+// ============================================================================
+// Progress Event Reconstruction
+// ============================================================================
+function reconstructProgressEvents(universalTxResponse, universalTxData) {
+    var _a;
+    const events = [];
+    const originParts = universalTxResponse.origin.split(':');
+    const chainNamespace = originParts.length >= 2 ? `${originParts[0]}:${originParts[1]}` : originParts[0];
+    const originAddress = originParts.length >= 3 ? originParts[2] : universalTxResponse.from;
+    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_01](chainNamespace, originAddress));
+    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_02_01]());
+    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_02_02](universalTxResponse.gasLimit));
+    const pushChainIds = [
+        chain_1.CHAIN_INFO[enums_1.CHAIN.PUSH_MAINNET].chainId,
+        chain_1.CHAIN_INFO[enums_1.CHAIN.PUSH_TESTNET_DONUT].chainId,
+        chain_1.CHAIN_INFO[enums_1.CHAIN.PUSH_LOCALNET].chainId,
+    ];
+    const isPushOrigin = pushChainIds.some((id) => chainNamespace.includes(`eip155:${id}`));
+    if (!isPushOrigin) {
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_03_01]());
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_03_02](universalTxResponse.from, true));
+    }
+    const inboundTx = universalTxData === null || universalTxData === void 0 ? void 0 : universalTxData.inboundTx;
+    const hasFundsFlow = inboundTx && BigInt(inboundTx.amount || '0') > BigInt(0);
+    if (!isPushOrigin) {
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_02]());
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_04_03]());
+    }
+    if (hasFundsFlow && inboundTx) {
+        const amount = BigInt(inboundTx.amount);
+        const decimals = 18;
+        const symbol = 'TOKEN';
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_01](amount, decimals, symbol));
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_02](inboundTx.txHash, amount, decimals, symbol));
+        const confirmations = 1;
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_03](confirmations));
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_03_02](confirmations, confirmations));
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_04]());
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_05]());
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_06_06](amount, decimals, symbol));
+    }
+    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_07]());
+    const pcTx = (_a = universalTxData === null || universalTxData === void 0 ? void 0 : universalTxData.pcTx) === null || _a === void 0 ? void 0 : _a[0];
+    const isOutboundFailed = (universalTxData === null || universalTxData === void 0 ? void 0 : universalTxData.universalStatus) === types_1.UniversalTxStatus.OUTBOUND_FAILED;
+    const isPcFailed = (pcTx === null || pcTx === void 0 ? void 0 : pcTx.status) === 'FAILED';
+    const isFailed = isPcFailed || isOutboundFailed;
+    if (isFailed) {
+        const errorMsg = isOutboundFailed
+            ? 'Outbound transaction failed (status: OUTBOUND_FAILED)'
+            : ((pcTx === null || pcTx === void 0 ? void 0 : pcTx.errorMsg) || 'Unknown error');
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_02](errorMsg));
+    }
+    else {
+        events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_99_01]([universalTxResponse]));
+    }
+    return events;
+}
+// ============================================================================
+// Route Detection from V2 Data
+// ============================================================================
+function detectRouteFromUniversalTxData(universalTxData) {
+    if (!universalTxData)
+        return undefined;
+    const hasOutbound = universalTxData.outboundTx.length > 0;
+    const hasInbound = !!universalTxData.inboundTx;
+    const statusIndicatesOutbound = [
+        types_1.UniversalTxStatus.OUTBOUND_PENDING,
+        types_1.UniversalTxStatus.OUTBOUND_SUCCESS,
+        types_1.UniversalTxStatus.OUTBOUND_FAILED,
+    ].includes(universalTxData.universalStatus);
+    if (hasOutbound || statusIndicatesOutbound) {
+        return hasInbound
+            ? route_detector_1.TransactionRoute.CEA_TO_CEA
+            : route_detector_1.TransactionRoute.UOA_TO_CEA;
+    }
+    if (hasInbound)
+        return route_detector_1.TransactionRoute.CEA_TO_PUSH;
+    return route_detector_1.TransactionRoute.UOA_TO_PUSH;
+}
+//# sourceMappingURL=tx-transformer.js.map

package/src/lib/orchestrator/internals/uea-manager.d.ts

@@ -0,0 +1,17 @@
+/**
+ * UEA (Universal Executor Account) lifecycle functions extracted from Orchestrator.
+ * Covers: compute, nonce, version, deployment status.
+ */
+import type { OrchestratorContext } from './context';
+export declare function computeUEAOffchain(ctx: OrchestratorContext): `0x${string}`;
+export declare function computeUEA(ctx: OrchestratorContext): Promise<{
+    address: `0x${string}`;
+    deployed: boolean;
+}>;
+export declare function getUEANonce(ctx: OrchestratorContext, address: `0x${string}`): Promise<bigint>;
+export declare function getUeaNonceForExecution(ctx: OrchestratorContext): Promise<bigint>;
+export declare function getUeaStatusAndNonce(ctx: OrchestratorContext): Promise<{
+    deployed: boolean;
+    nonce: bigint;
+}>;
+export declare function fetchUEAVersion(ctx: OrchestratorContext): Promise<string>;

package/src/lib/orchestrator/internals/uea-manager.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * UEA (Universal Executor Account) lifecycle functions extracted from Orchestrator.
+ * Covers: compute, nonce, version, deployment status.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeUEAOffchain = computeUEAOffchain;
+exports.computeUEA = computeUEA;
+exports.getUEANonce = getUEANonce;
+exports.getUeaNonceForExecution = getUeaNonceForExecution;
+exports.getUeaStatusAndNonce = getUeaStatusAndNonce;
+exports.fetchUEAVersion = fetchUEAVersion;
+const tslib_1 = require("tslib");
+const bs58_1 = require("../../internal/bs58");
+const viem_1 = require("viem");
+const factoryV1_1 = require("../../constants/abi/factoryV1");
+const uea_svm_1 = require("../../constants/abi/uea.svm");
+const uea_evm_1 = require("../../constants/abi/uea.evm");
+const chain_1 = require("../../constants/chain");
+const enums_1 = require("../../constants/enums");
+const helpers_1 = require("./helpers");
+// ============================================================================
+// Offline UEA Address Computation (CREATE2)
+// ============================================================================
+function computeUEAOffchain(ctx) {
+    const { chain, address } = ctx.universalSigner.account;
+    const { vm, chainId } = chain_1.CHAIN_INFO[chain];
+    if ((0, helpers_1.isPushChain)(chain)) {
+        return address;
+    }
+    let ownerKey;
+    if (vm === enums_1.VM.EVM) {
+        ownerKey = address;
+    }
+    else if (vm === enums_1.VM.SVM) {
+        ownerKey = (0, viem_1.bytesToHex)(new Uint8Array(bs58_1.bs58.decode(address)));
+    }
+    else {
+        throw new Error(`Unsupported VM type: ${vm}`);
+    }
+    const encodedAccountId = (0, viem_1.encodeAbiParameters)([
+        {
+            type: 'tuple',
+            components: [
+                { name: 'chainNamespace', type: 'string' },
+                { name: 'chainId', type: 'string' },
+                { name: 'owner', type: 'bytes' },
+            ],
+        },
+    ], [{ chainNamespace: chain_1.VM_NAMESPACE[vm], chainId, owner: ownerKey }]);
+    const salt = (0, viem_1.keccak256)(encodedAccountId);
+    const minimalProxyRuntimeCode = ('0x3d602d80600a3d3981f3' +
+        '363d3d373d3d3d363d73' +
+        chain_1.UEA_PROXY[ctx.pushNetwork].toLowerCase().replace(/^0x/, '') +
+        '5af43d82803e903d91602b57fd5bf3');
+    const initCodeHash = (0, viem_1.keccak256)(minimalProxyRuntimeCode);
+    return (0, viem_1.getCreate2Address)({
+        from: ctx.pushClient.pushChainInfo.factoryAddress,
+        salt,
+        bytecodeHash: initCodeHash,
+    });
+}
+// ============================================================================
+// On-chain UEA Computation
+// ============================================================================
+function computeUEA(ctx) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const { chain, address } = ctx.universalSigner.account;
+        const { vm, chainId } = chain_1.CHAIN_INFO[chain];
+        if ((0, helpers_1.isPushChain)(chain)) {
+            throw new Error('UEA cannot be computed for a Push Chain Address');
+        }
+        const computedAddress = yield ctx.pushClient.readContract({
+            address: ctx.pushClient.pushChainInfo.factoryAddress,
+            abi: factoryV1_1.FACTORY_V1,
+            functionName: 'computeUEA',
+            args: [
+                {
+                    chainNamespace: chain_1.VM_NAMESPACE[vm],
+                    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 byteCode = yield ctx.pushClient.publicClient.getCode({
+            address: computedAddress,
+        });
+        return { address: computedAddress, deployed: byteCode !== undefined };
+    });
+}
+// ============================================================================
+// UEA Nonce
+// ============================================================================
+function getUEANonce(ctx, address) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const chain = ctx.universalSigner.account.chain;
+        const { vm } = chain_1.CHAIN_INFO[chain];
+        switch (vm) {
+            case enums_1.VM.EVM:
+                return ctx.pushClient.readContract({
+                    address,
+                    abi: uea_evm_1.UEA_EVM,
+                    functionName: 'nonce',
+                });
+            case enums_1.VM.SVM:
+                return ctx.pushClient.readContract({
+                    address,
+                    abi: uea_svm_1.UEA_SVM,
+                    functionName: 'nonce',
+                });
+            default:
+                throw new Error(`Unsupported VM type: ${vm}`);
+        }
+    });
+}
+function getUeaNonceForExecution(ctx) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const UEA = computeUEAOffchain(ctx);
+        const code = yield ctx.pushClient.publicClient.getCode({ address: UEA });
+        return code !== undefined ? yield getUEANonce(ctx, UEA) : BigInt(0);
+    });
+}
+function getUeaStatusAndNonce(ctx) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const UEA = computeUEAOffchain(ctx);
+        const code = yield ctx.pushClient.publicClient.getCode({ address: UEA });
+        const deployed = code !== undefined;
+        const nonce = deployed ? yield getUEANonce(ctx, UEA) : BigInt(0);
+        return { deployed, nonce };
+    });
+}
+// ============================================================================
+// UEA Version
+// ============================================================================
+function fetchUEAVersion(ctx) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        if (ctx.ueaVersionCache) {
+            return ctx.ueaVersionCache;
+        }
+        const chain = ctx.universalSigner.account.chain;
+        const { vm } = chain_1.CHAIN_INFO[chain];
+        const abi = vm === enums_1.VM.EVM ? uea_evm_1.UEA_EVM : uea_svm_1.UEA_SVM;
+        const predictedUEA = computeUEAOffchain(ctx);
+        const code = yield ctx.pushClient.publicClient.getCode({
+            address: predictedUEA,
+        });
+        if (code === undefined) {
+            ctx.ueaVersionCache = '0.1.0';
+            return '0.1.0';
+        }
+        const version = yield ctx.pushClient.readContract({
+            address: predictedUEA,
+            abi,
+            functionName: 'VERSION',
+        });
+        ctx.ueaVersionCache = version;
+        return version;
+    });
+}
+//# sourceMappingURL=uea-manager.js.map