@pushchain/core 5.1.4-alpha.2 → 5.1.4-alpha.3

package/src/lib/orchestrator/internals/route-handlers.js

@@ -255,11 +255,7 @@ function executeUoaToCea(ctx, params, executeFn) {
             ctx.pushClient.getBalance(ueaAddress),
         ]);
         const isUEADeployed = isNativePushEOA || ueaCode !== undefined;
-        if (!isUEADeployed) {
-            throw new Error('UEA is not deployed. Please send an inbound transaction to Push Chain first ' +
-                '(e.g. sendTransaction with value) to deploy your Universal Execution Account before using outbound transfers.');
-        }
-        const ueaNonce = isNativePushEOA ? BigInt(0) : yield (0, uea_manager_1.getUEANonce)(ctx, ueaAddress);
+        const ueaNonce = (!isUEADeployed || isNativePushEOA) ? BigInt(0) : yield (0, uea_manager_1.getUEANonce)(ctx, ueaAddress);
         // Build the multicall that will execute ON Push Chain from UEA context
         // This includes: 1) approve PRC-20 (if needed), 2) call sendUniversalTxOutbound
         const pushChainMulticalls = [];
@@ -288,7 +284,11 @@ function executeUoaToCea(ctx, params, executeFn) {
         // Reuse ueaBalance fetched earlier (line 383) — no tx sent between, balance is stable
         const currentBalance = ueaBalance;
         let adjustedValue;
-        if (currentBalance > EVM_NATIVE_VALUE_TARGET + EVM_GAS_RESERVE) {
+        if (!isUEADeployed) {
+            // UEA not yet deployed — fee-locking will deposit funds; use target value, excess is refunded
+            adjustedValue = nativeValueForGas > BigInt(0) ? EVM_NATIVE_VALUE_TARGET : nativeValueForGas;
+        }
+        else if (currentBalance > EVM_NATIVE_VALUE_TARGET + EVM_GAS_RESERVE) {
             // Enough balance: use 200 UPC target
             adjustedValue = EVM_NATIVE_VALUE_TARGET;
         }
@@ -354,7 +354,7 @@ function executeUoaToCea(ctx, params, executeFn) {
                 nonce: ueaNonce,
                 balance: ueaBalance,
             },
-            _skipFeeLocking: true, // outbound executes on Push Chain, no external fee locking
+            _skipFeeLocking: isUEADeployed, // skip fee-locking only if UEA is already deployed
         };
         const response = yield executeFn(executeParams);
         // Add chain info to response
@@ -463,11 +463,7 @@ function executeUoaToCeaSvm(ctx, params, target, executeFn) {
             isUEADeployed = ueaCode !== undefined;
             ueaBalance = balance;
         }
-        if (!isUEADeployed) {
-            throw new Error('UEA is not deployed. Please send an inbound transaction to Push Chain first ' +
-                '(e.g. sendTransaction with value) to deploy your Universal Execution Account before using outbound transfers.');
-        }
-        const ueaNonce = isNativePushEOASvm ? BigInt(0) : yield (0, uea_manager_1.getUEANonce)(ctx, ueaAddress);
+        const ueaNonce = (!isUEADeployed || isNativePushEOASvm) ? BigInt(0) : yield (0, uea_manager_1.getUEANonce)(ctx, ueaAddress);
         // --- Query gas fee (identical to EVM path) ---
         let gasFee = BigInt(0);
         let gasToken = selectors_1.ZERO_ADDRESS;
@@ -531,7 +527,7 @@ function executeUoaToCeaSvm(ctx, params, target, executeFn) {
                 nonce: ueaNonce,
                 balance: ueaBalance,
             },
-            _skipFeeLocking: true, // outbound executes on Push Chain, no external fee locking
+            _skipFeeLocking: isUEADeployed, // skip fee-locking only if UEA is already deployed
         };
         const response = yield executeFn(executeParams);
         // Add chain info to response
@@ -617,7 +613,7 @@ function executeCeaToPush(ctx, params, executeFn) {
         // external chain), but that approach is racy: the balance can change between the SDK
         // query and relay execution, causing sendUniversalTxToUEA to revert with
         // InsufficientBalance. Pre-existing CEA funds remain parked and can be swept separately.
-        let bridgeAmount = amount;
+        const bridgeAmount = amount;
         // Note: CEA contract may reject amount=0 in sendUniversalTxToUEA.
         // Keeping bridgeAmount as-is (0) for payload-only to test precompile behavior.
         // For ERC20 tokens, add approve call for the bridge amount

package/src/lib/push-chain/push-chain.js

@@ -400,6 +400,7 @@ class PushChain {
             // Stored on instance so consumers can await it if needed: await client.accountStatusReady
             const ACCOUNT_STATUS_TIMEOUT = 30000;
             instance.accountStatusReady = Promise.race([
+                // eslint-disable-next-line @typescript-eslint/no-empty-function
                 instance.getAccountStatus().then(() => { }),
                 new Promise((_, reject) => setTimeout(() => reject(new Error('Account status fetch timed out')), ACCOUNT_STATUS_TIMEOUT)),
             ]).catch(() => {

package/src/lib/universal/account/account.d.ts

@@ -69,14 +69,22 @@ export declare function convertExecutorToOrigin(executorAddress: string, options
     _internal?: boolean;
 }): Promise<OriginAccountInfo>;
 /**
- * Derive the executor account (UEA or CEA) for a given Push Chain account.
+ * Derive the executor account (UEA or CEA) for a given account.
  *
- * @param address - Plain address string (e.g., "0xABC...")
- * @param options.chain - Target external chain for CEA derivation. If omitted, treats address as Push Chain account.
+ * - If account is on an external chain (Ethereum, Solana, etc.):
+ *   Computes the UEA on Push Chain via the factory contract's computeUEA.
+ *   If options.chain is an external chain, further derives the CEA on that chain.
+ *
+ * - If account is on Push Chain:
+ *   Returns the address as-is (it's already a UEA or Push EOA).
+ *   If options.chain is an external chain, derives the CEA on that chain.
+ *
+ * @param account - UniversalAccount with chain and address.
+ * @param options.chain - Target external chain for CEA derivation. If omitted, returns UEA.
  * @param options.skipNetworkCheck - If true, skip deployment check and return deployed: false.
  * @returns The derived executor account address and deployment status.
  */
-export declare function deriveExecutorAccount(address: string, options?: {
+export declare function deriveExecutorAccount(account: UniversalAccount, options?: {
     chain?: CHAIN;
     skipNetworkCheck?: boolean;
 }): Promise<DerivedExecutorAccount>;

package/src/lib/universal/account/account.js

@@ -431,30 +431,97 @@ function getChainName(chain) {
     return entry ? entry[0] : chain;
 }
 /**
- * Derive the executor account (UEA or CEA) for a given Push Chain account.
+ * Derive the executor account (UEA or CEA) for a given account.
  *
- * @param address - Plain address string (e.g., "0xABC...")
- * @param options.chain - Target external chain for CEA derivation. If omitted, treats address as Push Chain account.
+ * - If account is on an external chain (Ethereum, Solana, etc.):
+ *   Computes the UEA on Push Chain via the factory contract's computeUEA.
+ *   If options.chain is an external chain, further derives the CEA on that chain.
+ *
+ * - If account is on Push Chain:
+ *   Returns the address as-is (it's already a UEA or Push EOA).
+ *   If options.chain is an external chain, derives the CEA on that chain.
+ *
+ * @param account - UniversalAccount with chain and address.
+ * @param options.chain - Target external chain for CEA derivation. If omitted, returns UEA.
  * @param options.skipNetworkCheck - If true, skip deployment check and return deployed: false.
  * @returns The derived executor account address and deployment status.
  */
-function deriveExecutorAccount(address, options) {
+function deriveExecutorAccount(account, options) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
         var _a;
         const skipNetworkCheck = (_a = options === null || options === void 0 ? void 0 : options.skipNetworkCheck) !== null && _a !== void 0 ? _a : false;
         const targetChain = options === null || options === void 0 ? void 0 : options.chain;
-        // If target chain is external, derive CEA on that chain
+        const { chain, address } = account;
+        // --- Case 1: Input is on an external chain ---
+        if (!isPushChain(chain)) {
+            const { vm, chainId } = chain_1.CHAIN_INFO[chain];
+            const pushNetwork = getPushNetworkFromChain(chain);
+            // Check cache for previously computed UEA
+            const cachedUea = accountCache.get(cache_1.CacheKeys.ueaAddressOnchain(chain, address, pushNetwork, vm));
+            let ueaAddress;
+            if (cachedUea) {
+                ueaAddress = cachedUea;
+            }
+            else {
+                // Compute UEA via factory contract
+                const pushChainKey = pushNetworkToChainKey(pushNetwork);
+                const pushClient = new push_client_1.PushClient({
+                    rpcUrls: chain_1.CHAIN_INFO[pushChainKey].defaultRPC,
+                    network: pushNetwork,
+                });
+                ueaAddress = yield pushClient.readContract({
+                    address: pushClient.pushChainInfo.factoryAddress,
+                    abi: factoryV1_1.FACTORY_V1,
+                    functionName: 'computeUEA',
+                    args: [
+                        {
+                            chainNamespace: chain_1.VM_NAMESPACE[vm],
+                            chainId: chainId,
+                            owner: vm === enums_1.VM.EVM
+                                ? address
+                                : vm === enums_1.VM.SVM
+                                    ? (0, viem_1.bytesToHex)(Uint8Array.from(bs58_1.bs58.decode(address)))
+                                    : address,
+                        },
+                    ],
+                });
+                // Cache the computed address
+                accountCache.set(cache_1.CacheKeys.ueaAddressOnchain(chain, address, pushNetwork, vm), ueaAddress);
+            }
+            // If target chain is external, derive CEA from the computed UEA
+            if (targetChain && !isPushChain(targetChain)) {
+                const { cea, isDeployed } = yield (0, cea_utils_1.getCEAAddress)(ueaAddress, targetChain);
+                return { address: cea, deployed: skipNetworkCheck ? false : isDeployed };
+            }
+            // Return UEA with deployment check
+            if (skipNetworkCheck) {
+                return { address: ueaAddress, deployed: false };
+            }
+            const pushChainKey = pushNetworkToChainKey(pushNetwork);
+            const pushClient = new push_client_1.PushClient({
+                rpcUrls: chain_1.CHAIN_INFO[pushChainKey].defaultRPC,
+                network: pushNetwork,
+            });
+            const byteCode = yield pushClient.publicClient.getCode({
+                address: ueaAddress,
+            });
+            const isDeployed = byteCode !== undefined;
+            accountCache.set(cache_1.CacheKeys.deploymentStatus(ueaAddress), isDeployed);
+            return { address: ueaAddress, deployed: isDeployed };
+        }
+        // --- Case 2: Input is on Push Chain ---
+        // If target chain is external, derive CEA
         if (targetChain && !isPushChain(targetChain)) {
             const { cea, isDeployed } = yield (0, cea_utils_1.getCEAAddress)(address, targetChain);
             return { address: cea, deployed: skipNetworkCheck ? false : isDeployed };
         }
-        // Address is on Push Chain — return with deployment check
+        // Push address, no external target — return with deployment check
         if (skipNetworkCheck) {
             return { address: address, deployed: false };
         }
         const pushNetwork = targetChain && isPushChain(targetChain)
             ? getPushNetworkFromChain(targetChain)
-            : enums_1.PUSH_NETWORK.TESTNET_DONUT;
+            : getPushNetworkFromChain(chain);
         const pushChainKey = pushNetworkToChainKey(pushNetwork);
         const pushClient = new push_client_1.PushClient({
             rpcUrls: chain_1.CHAIN_INFO[pushChainKey].defaultRPC,