@pushchain/core 5.1.3 → 5.1.4-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "5.1.3",
+  "version": "5.1.4-alpha.1",
   "homepage": "https://push.org",
   "keywords": [
     "pushchain",
@@ -21,20 +21,33 @@
   "license": "MIT",
   "dependencies": {
     "@bufbuild/protobuf": "^2.0.0",
-    "@coral-xyz/anchor": "^0.31.0",
     "@cosmjs/crypto": "0.33.1",
     "@cosmjs/encoding": "0.33.1",
     "@cosmjs/proto-signing": "^0.33.1",
     "@cosmjs/stargate": "^0.33.1",
     "@cosmjs/tendermint-rpc": "0.33.1",
     "@solana/web3.js": "^1.68.0",
+    "bs58": "^4.0.0",
     "buffer": "^6.0.3",
     "cosmjs-types": "0.9.0",
-    "ethers": "^6.14.3",
-    "protobufjs": "7.4.0",
     "tslib": "^2.3.0",
-    "tweetnacl": "^1.0.3",
-    "viem": "2.27.2"
+    "viem": "^2.27.2"
+  },
+  "peerDependencies": {
+    "@coral-xyz/anchor": "^0.31.0",
+    "ethers": "^6.0.0",
+    "tweetnacl": "^1.0.3"
+  },
+  "peerDependenciesMeta": {
+    "@coral-xyz/anchor": {
+      "optional": true
+    },
+    "ethers": {
+      "optional": true
+    },
+    "tweetnacl": {
+      "optional": true
+    }
   },
   "scripts": {
     "build:proto": "scripts/protoc-generate.sh"
@@ -42,6 +55,16 @@
   "type": "commonjs",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
+  "sideEffects": [
+    "./src/lib/internal/global-buffer-polyfill.*"
+  ],
+  "files": [
+    "src/**/*.js",
+    "src/**/*.d.ts",
+    "src/**/*.json",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "devDependencies": {
     "secp256k1": "^5.0.1",
     "ts-proto": "^2.0.3"

package/src/lib/constants/abi/prc20.evm.d.ts

@@ -144,11 +144,31 @@ export declare const UNIVERSAL_CORE_EVM: readonly [{
 }, {
     readonly type: "function";
     readonly name: "getRescueFundsGasLimit";
-    readonly inputs: readonly [];
+    readonly inputs: readonly [{
+        readonly name: "_prc20";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
     readonly outputs: readonly [{
-        readonly name: "";
+        readonly name: "gasToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "gasFee";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "rescueGasLimit";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "gasPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "chainNamespace";
+        readonly type: "string";
+        readonly internalType: "string";
     }];
     readonly stateMutability: "view";
 }, {

package/src/lib/constants/abi/prc20.evm.js

@@ -96,12 +96,20 @@ exports.UNIVERSAL_CORE_EVM = [
         outputs: [{ name: '', type: 'address', internalType: 'address' }],
         stateMutability: 'view',
     },
-    // Rescue funds gas limit
+    // Rescue funds gas limit (returns gas details for a given PRC-20 token)
     {
         type: 'function',
         name: 'getRescueFundsGasLimit',
-        inputs: [],
-        outputs: [{ name: '', type: 'uint256', internalType: 'uint256' }],
+        inputs: [
+            { name: '_prc20', type: 'address', internalType: 'address' },
+        ],
+        outputs: [
+            { name: 'gasToken', type: 'address', internalType: 'address' },
+            { name: 'gasFee', type: 'uint256', internalType: 'uint256' },
+            { name: 'rescueGasLimit', type: 'uint256', internalType: 'uint256' },
+            { name: 'gasPrice', type: 'uint256', internalType: 'uint256' },
+            { name: 'chainNamespace', type: 'string', internalType: 'string' },
+        ],
         stateMutability: 'view',
     },
     // Swap and burn gas (gateway-only)

package/src/lib/constants/abi/universalGatewayPC.evm.d.ts

@@ -137,4 +137,63 @@ export declare const UNIVERSAL_GATEWAY_PC: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "address";
+        readonly name: "prc20";
+        readonly type: "address";
+    }];
+    readonly name: "rescueFundsOnSourceChain";
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+    readonly type: "function";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "prc20";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "string";
+        readonly name: "chainNamespace";
+        readonly type: "string";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint8";
+        readonly name: "txType";
+        readonly type: "uint8";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasFee";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasPrice";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasLimit";
+        readonly type: "uint256";
+    }];
+    readonly name: "RescueFundsOnSourceChain";
+    readonly type: "event";
 }];

package/src/lib/constants/abi/universalGatewayPC.evm.js

@@ -66,5 +66,31 @@ exports.UNIVERSAL_GATEWAY_PC = [
         stateMutability: 'view',
         type: 'function',
     },
+    // Rescue funds on source chain
+    {
+        inputs: [
+            { internalType: 'bytes32', name: 'universalTxId', type: 'bytes32' },
+            { internalType: 'address', name: 'prc20', type: 'address' },
+        ],
+        name: 'rescueFundsOnSourceChain',
+        outputs: [],
+        stateMutability: 'payable',
+        type: 'function',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            { indexed: true, internalType: 'bytes32', name: 'universalTxId', type: 'bytes32' },
+            { indexed: true, internalType: 'address', name: 'prc20', type: 'address' },
+            { indexed: false, internalType: 'string', name: 'chainNamespace', type: 'string' },
+            { indexed: true, internalType: 'address', name: 'sender', type: 'address' },
+            { indexed: false, internalType: 'uint8', name: 'txType', type: 'uint8' },
+            { indexed: false, internalType: 'uint256', name: 'gasFee', type: 'uint256' },
+            { indexed: false, internalType: 'uint256', name: 'gasPrice', type: 'uint256' },
+            { indexed: false, internalType: 'uint256', name: 'gasLimit', type: 'uint256' },
+        ],
+        name: 'RescueFundsOnSourceChain',
+        type: 'event',
+    },
 ];
 //# sourceMappingURL=universalGatewayPC.evm.js.map

package/src/lib/constants/chain.d.ts

@@ -80,6 +80,10 @@ export declare const PUSH_CHAIN_INFO: Record<CHAIN.PUSH_MAINNET | CHAIN.PUSH_TES
  * These are the contracts that handle inbound/outbound universal transactions
  */
 export declare const UNIVERSAL_GATEWAY_ADDRESSES: Partial<Record<CHAIN, `0x${string}`>>;
+/**
+ * Pyth price feed account for SVM gateway gas estimation
+ */
+export declare const SVM_PYTH_PRICE_FEED = "7UVimffxr9ow1uXYxsr4LHAcV58mLzhmwaeKvJ1pjLiE";
 /**
  * Vault contract addresses on external chains
  * Vaults hold locked assets for cross-chain operations

package/src/lib/constants/chain.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHAIN_EXPLORERS = exports.CEA_FACTORY_ADDRESSES = exports.VAULT_ADDRESSES = exports.UNIVERSAL_GATEWAY_ADDRESSES = exports.PUSH_CHAIN_INFO = exports.CHAIN_INFO = exports.SYNTHETIC_PUSH_ERC20 = exports.UEA_MIGRATION = exports.UEA_FACTORY = exports.UEA_PROXY = exports.VM_NAMESPACE = void 0;
+exports.CHAIN_EXPLORERS = exports.CEA_FACTORY_ADDRESSES = exports.VAULT_ADDRESSES = exports.SVM_PYTH_PRICE_FEED = exports.UNIVERSAL_GATEWAY_ADDRESSES = exports.PUSH_CHAIN_INFO = exports.CHAIN_INFO = exports.SYNTHETIC_PUSH_ERC20 = exports.UEA_MIGRATION = exports.UEA_FACTORY = exports.UEA_PROXY = exports.VM_NAMESPACE = void 0;
 exports.getExplorerTxUrl = getExplorerTxUrl;
 exports.getExplorerAddressUrl = getExplorerAddressUrl;
 const enums_1 = require("./enums");
@@ -292,12 +292,16 @@ exports.PUSH_CHAIN_INFO = {
  * These are the contracts that handle inbound/outbound universal transactions
  */
 exports.UNIVERSAL_GATEWAY_ADDRESSES = {
-    [enums_1.CHAIN.ETHEREUM_SEPOLIA]: '0x4DCab975cDe839632db6695e2e936A29ce3e325E',
+    [enums_1.CHAIN.ETHEREUM_SEPOLIA]: '0x05bD7a3D18324c1F7e216f7fBF2b15985aE5281A',
     [enums_1.CHAIN.BNB_TESTNET]: '0x44aFFC61983F4348DdddB886349eb992C061EaC0',
     // Arbitrum Sepolia and Base Sepolia use same as locker for now
     [enums_1.CHAIN.ARBITRUM_SEPOLIA]: '0x2cd870e0166Ba458dEC615168Fd659AacD795f34',
     [enums_1.CHAIN.BASE_SEPOLIA]: '0xFD4fef1F43aFEc8b5bcdEEc47f35a1431479aC16',
 };
+/**
+ * Pyth price feed account for SVM gateway gas estimation
+ */
+exports.SVM_PYTH_PRICE_FEED = '7UVimffxr9ow1uXYxsr4LHAcV58mLzhmwaeKvJ1pjLiE';
 /**
  * Vault contract addresses on external chains
  * Vaults hold locked assets for cross-chain operations

package/src/lib/index.d.ts

@@ -1,7 +1,7 @@
 import { PushChain } from './push-chain/push-chain';
 export type { ConversionQuote } from './constants/tokens';
-export type { UniversalSigner, UniversalAccount, UniversalSignerSkeleton, } from './universal/universal.types';
-export type { ChainTarget, ChainSource, UniversalTo, TransactionRouteType, UniversalExecuteParams, UniversalOutboundTxRequest, PreparedUniversalTx, CascadedTransactionBuilder, CascadedTxResponse, CascadeHopInfo, CascadeTrackOptions, CascadeProgressEvent, CascadeCompletionResult, ChainedTransactionBuilder, MultiChainTxResponse, OutboundTxDetails, WaitForOutboundOptions, SvmGatewayAccountMeta, SvmExecutePayloadFields, SvmExecuteParams, AccountStatus, UEAStatus, } from './orchestrator/orchestrator.types';
+export type { UniversalSigner, UniversalAccount, UniversalSignerSkeleton, DerivedExecutorAccount, ResolvedAccount, ResolvedControllerAccounts, AccountType, AccountRole, } from './universal/universal.types';
+export type { ChainTarget, ChainSource, UniversalTo, TransactionRouteType, UniversalExecuteParams, UniversalOutboundTxRequest, PreparedUniversalTx, CascadedTransactionBuilder, CascadedTxResponse, CascadeHopInfo, CascadeTrackOptions, CascadeProgressEvent, CascadeCompletionResult, MultiChainTxResponse, OutboundTxDetails, WaitForOutboundOptions, SvmGatewayAccountMeta, SvmExecutePayloadFields, SvmExecuteParams, AccountStatus, UEAStatus, RescueFundsParams, } from './orchestrator/orchestrator.types';
 export { parseUEAVersion } from './orchestrator/orchestrator.types';
 export { TransactionRoute, detectRoute, isChainTarget } from './orchestrator/route-detector';
 export { getCEAAddress, getPushAccountForCEA, isCEA, chainSupportsCEA, chainSupportsOutbound, getCEAFactoryAddress, getAllCEAAddresses, } from './orchestrator/cea-utils';

package/src/lib/internal/bs58.d.ts

@@ -0,0 +1,2 @@
+import bs58 from 'bs58';
+export { bs58 };

package/src/lib/internal/bs58.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bs58 = void 0;
+const tslib_1 = require("tslib");
+const bs58_1 = tslib_1.__importDefault(require("bs58"));
+exports.bs58 = bs58_1.default;
+//# sourceMappingURL=bs58.js.map

package/src/lib/orchestrator/cea-utils.d.ts

@@ -13,15 +13,6 @@ export interface CEAAddressResult {
     /** Whether the CEA has been deployed */
     isDeployed: boolean;
 }
-/**
- * Get CEA address for a UEA on a specific chain
- *
- * @param ueaAddress - UEA address on Push Chain
- * @param chain - Target external chain
- * @param rpcUrl - Optional custom RPC URL
- * @returns CEA address and deployment status
- * @throws Error if chain doesn't have CEAFactory
- */
 export declare function getCEAAddress(ueaAddress: `0x${string}`, chain: CHAIN, rpcUrl?: string): Promise<CEAAddressResult>;
 /**
  * Get Push Account (UEA) address for a CEA on a specific chain

package/src/lib/orchestrator/cea-utils.js

@@ -17,7 +17,7 @@ const viem_1 = require("viem");
 const chains_1 = require("viem/chains");
 const enums_1 = require("../constants/enums");
 const chain_1 = require("../constants/chain");
-const abi_1 = require("../constants/abi");
+const ceaFactory_evm_1 = require("../constants/abi/ceaFactory.evm");
 /**
  * Map CHAIN enum to viem chain object
  */
@@ -46,8 +46,13 @@ function getViemChain(chain) {
  * @returns CEA address and deployment status
  * @throws Error if chain doesn't have CEAFactory
  */
+// Cache CEA address per UEA+chain — address is deterministic (CREATE2), but
+// isDeployed can change during execution so we always re-fetch it.
+const ceaAddressCache = new Map();
 function getCEAAddress(ueaAddress, chain, rpcUrl) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const cacheKey = `${ueaAddress.toLowerCase()}:${chain}`;
+        const cachedAddress = ceaAddressCache.get(cacheKey);
         const factoryAddress = chain_1.CEA_FACTORY_ADDRESSES[chain];
         if (!factoryAddress) {
             throw new Error(`CEAFactory not available on chain ${chain}`);
@@ -57,12 +62,18 @@ function getCEAAddress(ueaAddress, chain, rpcUrl) {
             chain: viemChain,
             transport: (0, viem_1.http)(rpcUrl),
         });
+        if (cachedAddress) {
+            // Address is cached — only re-check deployment status
+            const code = yield client.getCode({ address: cachedAddress });
+            return { cea: cachedAddress, isDeployed: code !== undefined && code !== '0x' };
+        }
         const [cea, isDeployed] = yield client.readContract({
-            abi: abi_1.CEA_FACTORY_EVM,
+            abi: ceaFactory_evm_1.CEA_FACTORY_EVM,
             address: factoryAddress,
             functionName: 'getCEAForPushAccount',
             args: [ueaAddress],
         });
+        ceaAddressCache.set(cacheKey, cea);
         return { cea, isDeployed };
     });
 }
@@ -87,7 +98,7 @@ function getPushAccountForCEA(ceaAddress, chain, rpcUrl) {
             transport: (0, viem_1.http)(rpcUrl),
         });
         const uea = yield client.readContract({
-            abi: abi_1.CEA_FACTORY_EVM,
+            abi: ceaFactory_evm_1.CEA_FACTORY_EVM,
             address: factoryAddress,
             functionName: 'getPushAccountForCEA',
             args: [ceaAddress],
@@ -116,7 +127,7 @@ function isCEA(address, chain, rpcUrl) {
             transport: (0, viem_1.http)(rpcUrl),
         });
         return client.readContract({
-            abi: abi_1.CEA_FACTORY_EVM,
+            abi: ceaFactory_evm_1.CEA_FACTORY_EVM,
             address: factoryAddress,
             functionName: 'isCEA',
             args: [address],

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

@@ -0,0 +1,16 @@
+/**
+ * Account management functions extracted from Orchestrator.
+ * Covers: getAccountStatus, upgradeAccount, fetchLatestUEAVersion, migrateCEA.
+ */
+import { CHAIN, VM } from '../../constants/enums';
+import { ProgressEvent } from '../../progress-hook/progress-hook.types';
+import { AccountStatus, UniversalTxResponse } from '../orchestrator.types';
+import type { OrchestratorContext } from './context';
+export declare function fetchLatestUEAVersion(ctx: OrchestratorContext, vm: VM): Promise<string>;
+export declare function getAccountStatus(ctx: OrchestratorContext, options?: {
+    forceRefresh?: boolean;
+}): Promise<AccountStatus>;
+export declare function upgradeAccount(ctx: OrchestratorContext, options?: {
+    progressHook?: (progress: ProgressEvent) => void;
+}): Promise<void>;
+export declare function migrateCEA(ctx: OrchestratorContext, chain: CHAIN, executeFn: (params: any) => Promise<UniversalTxResponse>): Promise<UniversalTxResponse>;

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/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;