@pushchain/core 5.1.2 → 5.1.4-alpha.0

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

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Account management functions extracted from Orchestrator.
+ * Covers: getAccountStatus, upgradeAccount, fetchLatestUEAVersion, migrateCEA.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchLatestUEAVersion = fetchLatestUEAVersion;
+exports.getAccountStatus = getAccountStatus;
+exports.upgradeAccount = upgradeAccount;
+exports.migrateCEA = migrateCEA;
+const tslib_1 = require("tslib");
+const bs58_1 = require("../../internal/bs58");
+const viem_1 = require("viem");
+const uea_factory_1 = require("../../constants/abi/uea-factory");
+const chain_1 = require("../../constants/chain");
+const enums_1 = require("../../constants/enums");
+const progress_hook_1 = tslib_1.__importDefault(require("../../progress-hook/progress-hook"));
+const progress_hook_types_1 = require("../../progress-hook/progress-hook.types");
+const orchestrator_types_1 = require("../orchestrator.types");
+const cea_utils_1 = require("../cea-utils");
+const uea_manager_1 = require("./uea-manager");
+const signing_1 = require("./signing");
+const helpers_1 = require("./helpers");
+// ============================================================================
+// Fetch Latest UEA Version from Factory
+// ============================================================================
+function fetchLatestUEAVersion(ctx, vm) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const factoryAddress = chain_1.UEA_FACTORY[ctx.pushNetwork];
+        if (!factoryAddress || factoryAddress === '0xTBD') {
+            return '';
+        }
+        try {
+            const vmHash = vm === enums_1.VM.EVM
+                ? (0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)([{ type: 'string' }], ['EVM']))
+                : (0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)([{ type: 'string' }], ['SVM']));
+            return yield ctx.pushClient.readContract({
+                address: factoryAddress,
+                abi: uea_factory_1.UEA_FACTORY_ABI,
+                functionName: 'UEA_VERSION',
+                args: [vmHash],
+            });
+        }
+        catch (_a) {
+            return '';
+        }
+    });
+}
+// ============================================================================
+// Account Status
+// ============================================================================
+function getAccountStatus(ctx, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        if (ctx.accountStatusCache && !(options === null || options === void 0 ? void 0 : options.forceRefresh)) {
+            return ctx.accountStatusCache;
+        }
+        const chain = ctx.universalSigner.account.chain;
+        const { vm } = chain_1.CHAIN_INFO[chain];
+        const { deployed } = yield (0, uea_manager_1.getUeaStatusAndNonce)(ctx);
+        if (!deployed) {
+            const status = {
+                mode: 'signer',
+                uea: {
+                    loaded: true,
+                    deployed: false,
+                    version: '',
+                    minRequiredVersion: '',
+                    requiresUpgrade: false,
+                },
+            };
+            ctx.accountStatusCache = status;
+            return status;
+        }
+        const [currentVersion, minRequiredVersion] = yield Promise.all([
+            (0, uea_manager_1.fetchUEAVersion)(ctx),
+            fetchLatestUEAVersion(ctx, vm),
+        ]);
+        const requiresUpgrade = (0, orchestrator_types_1.parseUEAVersion)(currentVersion) < (0, orchestrator_types_1.parseUEAVersion)(minRequiredVersion);
+        const status = {
+            mode: 'signer',
+            uea: {
+                loaded: true,
+                deployed: true,
+                version: currentVersion,
+                minRequiredVersion,
+                requiresUpgrade,
+            },
+        };
+        ctx.accountStatusCache = status;
+        return status;
+    });
+}
+// ============================================================================
+// UEA Upgrade
+// ============================================================================
+function upgradeAccount(ctx, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const hook = (options === null || options === void 0 ? void 0 : options.progressHook) || ctx.progressHook;
+        const fireHook = (hookId, ...args) => {
+            const hookEntry = progress_hook_1.default[hookId];
+            if (hookEntry && hook) {
+                hook(hookEntry(...args));
+            }
+        };
+        fireHook(progress_hook_types_1.PROGRESS_HOOK.UEA_MIG_01);
+        const status = yield getAccountStatus(ctx, { forceRefresh: true });
+        if (!status.uea.requiresUpgrade) {
+            fireHook(progress_hook_types_1.PROGRESS_HOOK.UEA_MIG_9903);
+            return;
+        }
+        fireHook(progress_hook_types_1.PROGRESS_HOOK.UEA_MIG_02);
+        try {
+            const { chain, address } = ctx.universalSigner.account;
+            const { vm, chainId } = chain_1.CHAIN_INFO[chain];
+            const ueaAddress = (0, uea_manager_1.computeUEAOffchain)(ctx);
+            const migrationContractAddress = chain_1.UEA_MIGRATION[ctx.pushNetwork];
+            if (!migrationContractAddress || migrationContractAddress === '0xTBD') {
+                throw new Error('UEA migration contract address not configured');
+            }
+            const { nonce } = yield (0, uea_manager_1.getUeaStatusAndNonce)(ctx);
+            const deadline = BigInt(9999999999);
+            const ueaVersion = status.uea.version || '0.1.0';
+            const signatureBytes = yield (0, signing_1.signMigrationPayload)(ctx, {
+                migrationContractAddress,
+                nonce,
+                deadline,
+                ueaVersion,
+                ueaAddress,
+            });
+            const signature = (0, viem_1.bytesToHex)(signatureBytes);
+            fireHook(progress_hook_types_1.PROGRESS_HOOK.UEA_MIG_03);
+            const universalAccountId = {
+                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 { cosmosAddress: signer } = ctx.pushClient.getSignerAddress();
+            const msg = ctx.pushClient.createMsgMigrateUEA({
+                signer,
+                universalAccountId,
+                migrationPayload: {
+                    migration: migrationContractAddress,
+                    nonce: nonce.toString(),
+                    deadline: deadline.toString(),
+                },
+                signature,
+            });
+            const txBody = yield ctx.pushClient.createCosmosTxBody([msg]);
+            const txRaw = yield ctx.pushClient.signCosmosTx(txBody);
+            const tx = yield ctx.pushClient.broadcastCosmosTx(txRaw);
+            if (tx.code !== 0) {
+                throw new Error(tx.rawLog || 'UEA migration transaction failed');
+            }
+            ctx.ueaVersionCache = undefined;
+            const updated = yield getAccountStatus(ctx, { forceRefresh: true });
+            fireHook(progress_hook_types_1.PROGRESS_HOOK.UEA_MIG_9901, updated.uea.version);
+        }
+        catch (err) {
+            fireHook(progress_hook_types_1.PROGRESS_HOOK.UEA_MIG_9902);
+            throw err;
+        }
+    });
+}
+// ============================================================================
+// CEA Migration
+// ============================================================================
+function migrateCEA(ctx, chain, executeFn) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if ((0, helpers_1.isPushChain)(chain)) {
+            throw new Error('Cannot migrate CEA on Push Chain');
+        }
+        if (!(0, cea_utils_1.chainSupportsCEA)(chain)) {
+            throw new Error(`Chain ${chain} does not support CEA`);
+        }
+        const ueaAddress = (0, uea_manager_1.computeUEAOffchain)(ctx);
+        const { cea, isDeployed } = yield (0, cea_utils_1.getCEAAddress)(ueaAddress, chain, (_a = ctx.rpcUrls[chain]) === null || _a === void 0 ? void 0 : _a[0]);
+        if (!isDeployed) {
+            throw new Error(`CEA not deployed on chain ${chain}. Deploy CEA first.`);
+        }
+        return executeFn({
+            to: { address: cea, chain },
+            migration: true,
+        });
+    });
+}
+//# sourceMappingURL=account-manager.js.map

package/src/lib/orchestrator/internals/account-manager.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * Cascade composition functions extracted from Orchestrator.
+ *
+ * Covers: prepareTransaction, buildHopDescriptor, classifyIntoSegments,
+ * getSegmentType, composeCascade, createCascadedBuilder, createChainedBuilder.
+ */
+import { TransactionRoute } from '../route-detector';
+import type { HopDescriptor, CascadeSegment, CascadeSegmentType, PreparedUniversalTx, CascadedTransactionBuilder, CascadeHopInfo, UniversalTxResponse, UniversalExecuteParams, MultiCall, WaitForOutboundOptions, OutboundTxDetails } from '../orchestrator.types';
+import type { OrchestratorContext } from './context';
+export interface CascadeCallbacks {
+    executeFn: (params: any) => Promise<UniversalTxResponse>;
+    waitForOutboundTxFn: (hash: string, opts?: WaitForOutboundOptions) => Promise<OutboundTxDetails>;
+    waitForAllOutboundTxsFn: (hash: string, hops: CascadeHopInfo[], opts: any) => Promise<{
+        success: boolean;
+        failedAt?: number;
+    }>;
+}
+export declare function prepareTransaction(ctx: OrchestratorContext, params: UniversalExecuteParams, callbacks: CascadeCallbacks): Promise<PreparedUniversalTx>;
+export declare function buildHopDescriptor(ctx: OrchestratorContext, params: UniversalExecuteParams, route: TransactionRoute, ueaAddress: `0x${string}`): Promise<HopDescriptor>;
+export declare function classifyIntoSegments(hops: HopDescriptor[]): CascadeSegment[];
+export declare function getSegmentType(route: string): CascadeSegmentType;
+export declare function composeCascade(ctx: OrchestratorContext, segments: CascadeSegment[], ueaAddress: `0x${string}`, ueaBalance?: bigint, ueaNonce?: bigint): MultiCall[];
+export declare function createCascadedBuilder(ctx: OrchestratorContext, preparedTxs: PreparedUniversalTx[], callbacks: CascadeCallbacks): CascadedTransactionBuilder;