@pushchain/core 5.1.5-alpha.1 → 5.1.5

package/src/lib/progress-hook/progress-hook.types.d.ts

@@ -7,40 +7,82 @@ export type ProgressEvent = {
     id: string;
     title: string;
     message: string;
-    level: 'INFO' | 'SUCCESS' | 'WARNING' | 'ERROR';
-    response: null | object | string;
+    level: 'INFO' | 'SUCCESS' | 'ERROR';
+    response: object | null;
     timestamp: string;
 };
 export type ProgressEventFunction = (...args: any[]) => ProgressEvent;
 export type ProgressEventFunctionWithoutTimestamp = (...args: any[]) => Omit<ProgressEvent, 'timestamp'>;
 export declare enum PROGRESS_HOOK {
-    SEND_TX_01 = "SEND-TX-01",
-    SEND_TX_02_01 = "SEND-TX-02-01",
-    SEND_TX_02_02 = "SEND-TX-02-02",
-    SEND_TX_03_01 = "SEND-TX-03-01",
-    SEND_TX_03_02 = "SEND-TX-03-02",
-    SEND_TX_04_01 = "SEND-TX-04-01",
-    SEND_TX_04_02 = "SEND-TX-04-02",
-    SEND_TX_04_03 = "SEND-TX-04-03",
-    SEND_TX_04_04 = "SEND-TX-04-04",
-    SEND_TX_05_01 = "SEND-TX-05-01",
-    SEND_TX_05_02 = "SEND-TX-05-02",
-    SEND_TX_06_01 = "SEND-TX-06-01",
-    SEND_TX_06_02 = "SEND-TX-06-02",
-    SEND_TX_06_03 = "SEND-TX-06-03",
-    SEND_TX_06_04 = "SEND-TX-06-04",
-    SEND_TX_06_03_01 = "SEND-TX-06-03-01",
-    SEND_TX_06_03_02 = "SEND-TX-06-03-02",
-    SEND_TX_06_05 = "SEND-TX-06-05",// Syncing with Push Chain
-    SEND_TX_06_06 = "SEND-TX-06-06",// Funds Credited on Push Chain (was 06_05)
-    SEND_TX_07 = "SEND-TX-07",// Broadcasting to Push Chain
-    SEND_TX_08_01 = "SEND-TX-08-01",// Awaiting External Chain
-    SEND_TX_08_02 = "SEND-TX-08-02",// Polling External Chain
-    SEND_TX_99_01 = "SEND-TX-99-01",
-    SEND_TX_99_02 = "SEND-TX-99-02",
-    SEND_TX_99_03 = "SEND-TX-99-03",// External Chain Tx Confirmed (SUCCESS)
-    SEND_TX_99_04 = "SEND-TX-99-04",// External Chain Tx Timeout (WARNING)
-    SEND_TX_99_05 = "SEND-TX-99-05",// External Chain Tx Failed (ERROR)
+    SEND_TX_101 = "SEND-TX-101",
+    SEND_TX_102_01 = "SEND-TX-102-01",
+    SEND_TX_102_02 = "SEND-TX-102-02",
+    SEND_TX_103_01 = "SEND-TX-103-01",
+    SEND_TX_103_02 = "SEND-TX-103-02",
+    SEND_TX_104_01 = "SEND-TX-104-01",// fee-lock path only
+    SEND_TX_104_02 = "SEND-TX-104-02",// signature path only
+    SEND_TX_104_03 = "SEND-TX-104-03",
+    SEND_TX_104_04 = "SEND-TX-104-04",
+    SEND_TX_105_01 = "SEND-TX-105-01",
+    SEND_TX_105_02 = "SEND-TX-105-02",
+    SEND_TX_106_01 = "SEND-TX-106-01",
+    SEND_TX_106_02 = "SEND-TX-106-02",
+    SEND_TX_106_03 = "SEND-TX-106-03",
+    SEND_TX_106_03_01 = "SEND-TX-106-03-01",
+    SEND_TX_106_03_02 = "SEND-TX-106-03-02",
+    SEND_TX_106_04 = "SEND-TX-106-04",
+    SEND_TX_106_05 = "SEND-TX-106-05",
+    SEND_TX_106_06 = "SEND-TX-106-06",
+    SEND_TX_106_07_01 = "SEND-TX-106-07-01",// R1 Sizer: Case A (push-gas < $1, padded to $1 floor)
+    SEND_TX_106_07_02 = "SEND-TX-106-07-02",// R1 Sizer: Case B (push-gas $1–$10, pass-through)
+    SEND_TX_106_07_03 = "SEND-TX-106-07-03",// R1 Sizer: Case C (push-gas > $10, pass-through to contract cap)
+    SEND_TX_107 = "SEND-TX-107",
+    SEND_TX_199_01 = "SEND-TX-199-01",// R1 terminal Push success
+    SEND_TX_199_02 = "SEND-TX-199-02",// R1 terminal Push failure
+    SEND_TX_199_99_99 = "SEND-TX-199-99-99",// R3 intermediate Push success
+    SEND_TX_201 = "SEND-TX-201",
+    SEND_TX_202_01 = "SEND-TX-202-01",
+    SEND_TX_202_02 = "SEND-TX-202-02",
+    SEND_TX_203_01 = "SEND-TX-203-01",
+    SEND_TX_203_02 = "SEND-TX-203-02",
+    SEND_TX_204_01 = "SEND-TX-204-01",
+    SEND_TX_204_02 = "SEND-TX-204-02",
+    SEND_TX_204_03 = "SEND-TX-204-03",
+    SEND_TX_204_04 = "SEND-TX-204-04",
+    SEND_TX_207 = "SEND-TX-207",
+    SEND_TX_209_01 = "SEND-TX-209-01",
+    SEND_TX_209_02 = "SEND-TX-209-02",
+    SEND_TX_299_01 = "SEND-TX-299-01",// R2 terminal external success
+    SEND_TX_299_02 = "SEND-TX-299-02",
+    SEND_TX_299_03 = "SEND-TX-299-03",
+    SEND_TX_299_99 = "SEND-TX-299-99",// R2 intermediate Push success
+    SEND_TX_301 = "SEND-TX-301",
+    SEND_TX_302_01 = "SEND-TX-302-01",
+    SEND_TX_302_02 = "SEND-TX-302-02",
+    SEND_TX_302_03_01 = "SEND-TX-302-03-01",// Sizer: Case A (< $1, padded)
+    SEND_TX_302_03_02 = "SEND-TX-302-03-02",// Sizer: Case B ($1–$10, happy path)
+    SEND_TX_302_03_03 = "SEND-TX-302-03-03",// Sizer: Case C (> $10, split + overflow bridge)
+    SEND_TX_303_01 = "SEND-TX-303-01",
+    SEND_TX_303_02 = "SEND-TX-303-02",
+    SEND_TX_304_01 = "SEND-TX-304-01",
+    SEND_TX_304_02 = "SEND-TX-304-02",
+    SEND_TX_304_03 = "SEND-TX-304-03",
+    SEND_TX_304_04 = "SEND-TX-304-04",
+    SEND_TX_307 = "SEND-TX-307",
+    SEND_TX_309_01 = "SEND-TX-309-01",
+    SEND_TX_309_02 = "SEND-TX-309-02",
+    SEND_TX_309_03 = "SEND-TX-309-03",
+    SEND_TX_310_01 = "SEND-TX-310-01",
+    SEND_TX_310_02 = "SEND-TX-310-02",
+    SEND_TX_399_01 = "SEND-TX-399-01",
+    SEND_TX_399_02 = "SEND-TX-399-02",
+    SEND_TX_399_03 = "SEND-TX-399-03",
+    SEND_TX_001 = "SEND-TX-001",
+    SEND_TX_002_01 = "SEND-TX-002-01",
+    SEND_TX_002_99_99 = "SEND-TX-002-99-99",
+    SEND_TX_999_01 = "SEND-TX-999-01",
+    SEND_TX_999_02 = "SEND-TX-999-02",
+    SEND_TX_999_03 = "SEND-TX-999-03",
     UEA_MIG_01 = "UEA-MIG-01",
     UEA_MIG_02 = "UEA-MIG-02",
     UEA_MIG_03 = "UEA-MIG-03",
@@ -48,4 +90,9 @@ export declare enum PROGRESS_HOOK {
     UEA_MIG_9902 = "UEA-MIG-9902",
     UEA_MIG_9903 = "UEA-MIG-9903"
 }
+export type PROGRESS_HOOK_R1 = PROGRESS_HOOK.SEND_TX_101 | PROGRESS_HOOK.SEND_TX_102_01 | PROGRESS_HOOK.SEND_TX_102_02 | PROGRESS_HOOK.SEND_TX_103_01 | PROGRESS_HOOK.SEND_TX_103_02 | PROGRESS_HOOK.SEND_TX_104_01 | PROGRESS_HOOK.SEND_TX_104_02 | PROGRESS_HOOK.SEND_TX_104_03 | PROGRESS_HOOK.SEND_TX_104_04 | PROGRESS_HOOK.SEND_TX_105_01 | PROGRESS_HOOK.SEND_TX_105_02 | PROGRESS_HOOK.SEND_TX_106_01 | PROGRESS_HOOK.SEND_TX_106_02 | PROGRESS_HOOK.SEND_TX_106_03 | PROGRESS_HOOK.SEND_TX_106_03_01 | PROGRESS_HOOK.SEND_TX_106_03_02 | PROGRESS_HOOK.SEND_TX_106_04 | PROGRESS_HOOK.SEND_TX_106_05 | PROGRESS_HOOK.SEND_TX_106_06 | PROGRESS_HOOK.SEND_TX_106_07_01 | PROGRESS_HOOK.SEND_TX_106_07_02 | PROGRESS_HOOK.SEND_TX_106_07_03 | PROGRESS_HOOK.SEND_TX_107 | PROGRESS_HOOK.SEND_TX_199_01 | PROGRESS_HOOK.SEND_TX_199_02;
+export type PROGRESS_HOOK_R2 = PROGRESS_HOOK.SEND_TX_201 | PROGRESS_HOOK.SEND_TX_202_01 | PROGRESS_HOOK.SEND_TX_202_02 | PROGRESS_HOOK.SEND_TX_203_01 | PROGRESS_HOOK.SEND_TX_203_02 | PROGRESS_HOOK.SEND_TX_204_01 | PROGRESS_HOOK.SEND_TX_204_02 | PROGRESS_HOOK.SEND_TX_204_03 | PROGRESS_HOOK.SEND_TX_204_04 | PROGRESS_HOOK.SEND_TX_207 | PROGRESS_HOOK.SEND_TX_209_01 | PROGRESS_HOOK.SEND_TX_209_02 | PROGRESS_HOOK.SEND_TX_299_01 | PROGRESS_HOOK.SEND_TX_299_02 | PROGRESS_HOOK.SEND_TX_299_03 | PROGRESS_HOOK.SEND_TX_299_99;
+export type PROGRESS_HOOK_R3 = PROGRESS_HOOK.SEND_TX_199_99_99 | PROGRESS_HOOK.SEND_TX_301 | PROGRESS_HOOK.SEND_TX_302_01 | PROGRESS_HOOK.SEND_TX_302_02 | PROGRESS_HOOK.SEND_TX_302_03_01 | PROGRESS_HOOK.SEND_TX_302_03_02 | PROGRESS_HOOK.SEND_TX_302_03_03 | PROGRESS_HOOK.SEND_TX_303_01 | PROGRESS_HOOK.SEND_TX_303_02 | PROGRESS_HOOK.SEND_TX_304_01 | PROGRESS_HOOK.SEND_TX_304_02 | PROGRESS_HOOK.SEND_TX_304_03 | PROGRESS_HOOK.SEND_TX_304_04 | PROGRESS_HOOK.SEND_TX_307 | PROGRESS_HOOK.SEND_TX_309_01 | PROGRESS_HOOK.SEND_TX_309_02 | PROGRESS_HOOK.SEND_TX_309_03 | PROGRESS_HOOK.SEND_TX_310_01 | PROGRESS_HOOK.SEND_TX_310_02 | PROGRESS_HOOK.SEND_TX_399_01 | PROGRESS_HOOK.SEND_TX_399_02 | PROGRESS_HOOK.SEND_TX_399_03;
+export type PROGRESS_HOOK_MULTICHAIN = PROGRESS_HOOK.SEND_TX_001 | PROGRESS_HOOK.SEND_TX_002_01 | PROGRESS_HOOK.SEND_TX_002_99_99 | PROGRESS_HOOK.SEND_TX_999_01 | PROGRESS_HOOK.SEND_TX_999_02 | PROGRESS_HOOK.SEND_TX_999_03;
+export type PROGRESS_HOOK_MIG = PROGRESS_HOOK.UEA_MIG_01 | PROGRESS_HOOK.UEA_MIG_02 | PROGRESS_HOOK.UEA_MIG_03 | PROGRESS_HOOK.UEA_MIG_9901 | PROGRESS_HOOK.UEA_MIG_9902 | PROGRESS_HOOK.UEA_MIG_9903;
 export {};

package/src/lib/progress-hook/progress-hook.types.js

@@ -3,41 +3,80 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROGRESS_HOOK = void 0;
 var PROGRESS_HOOK;
 (function (PROGRESS_HOOK) {
-    // 01–03: Common pre-execution flow
-    PROGRESS_HOOK["SEND_TX_01"] = "SEND-TX-01";
-    PROGRESS_HOOK["SEND_TX_02_01"] = "SEND-TX-02-01";
-    PROGRESS_HOOK["SEND_TX_02_02"] = "SEND-TX-02-02";
-    PROGRESS_HOOK["SEND_TX_03_01"] = "SEND-TX-03-01";
-    PROGRESS_HOOK["SEND_TX_03_02"] = "SEND-TX-03-02";
-    // 04-x: Payload / verification flow
-    PROGRESS_HOOK["SEND_TX_04_01"] = "SEND-TX-04-01";
-    PROGRESS_HOOK["SEND_TX_04_02"] = "SEND-TX-04-02";
-    PROGRESS_HOOK["SEND_TX_04_03"] = "SEND-TX-04-03";
-    PROGRESS_HOOK["SEND_TX_04_04"] = "SEND-TX-04-04";
-    // 05-x: Gas funding flow
-    PROGRESS_HOOK["SEND_TX_05_01"] = "SEND-TX-05-01";
-    PROGRESS_HOOK["SEND_TX_05_02"] = "SEND-TX-05-02";
-    // 06-x: Funds flow (origin chain + Push Chain credit)
-    PROGRESS_HOOK["SEND_TX_06_01"] = "SEND-TX-06-01";
-    PROGRESS_HOOK["SEND_TX_06_02"] = "SEND-TX-06-02";
-    PROGRESS_HOOK["SEND_TX_06_03"] = "SEND-TX-06-03";
-    PROGRESS_HOOK["SEND_TX_06_04"] = "SEND-TX-06-04";
-    PROGRESS_HOOK["SEND_TX_06_03_01"] = "SEND-TX-06-03-01";
-    PROGRESS_HOOK["SEND_TX_06_03_02"] = "SEND-TX-06-03-02";
-    PROGRESS_HOOK["SEND_TX_06_05"] = "SEND-TX-06-05";
-    PROGRESS_HOOK["SEND_TX_06_06"] = "SEND-TX-06-06";
-    // 07-x: Execution / broadcasting flow
-    PROGRESS_HOOK["SEND_TX_07"] = "SEND-TX-07";
-    // 08-x: External chain polling (after Push Chain tx success, outbound routes)
-    PROGRESS_HOOK["SEND_TX_08_01"] = "SEND-TX-08-01";
-    PROGRESS_HOOK["SEND_TX_08_02"] = "SEND-TX-08-02";
-    // 99-x: Final outcome
-    PROGRESS_HOOK["SEND_TX_99_01"] = "SEND-TX-99-01";
-    PROGRESS_HOOK["SEND_TX_99_02"] = "SEND-TX-99-02";
-    PROGRESS_HOOK["SEND_TX_99_03"] = "SEND-TX-99-03";
-    PROGRESS_HOOK["SEND_TX_99_04"] = "SEND-TX-99-04";
-    PROGRESS_HOOK["SEND_TX_99_05"] = "SEND-TX-99-05";
-    // UEA Migration hooks
+    // Route 1: UOA → Push Chain (101–199)
+    PROGRESS_HOOK["SEND_TX_101"] = "SEND-TX-101";
+    PROGRESS_HOOK["SEND_TX_102_01"] = "SEND-TX-102-01";
+    PROGRESS_HOOK["SEND_TX_102_02"] = "SEND-TX-102-02";
+    PROGRESS_HOOK["SEND_TX_103_01"] = "SEND-TX-103-01";
+    PROGRESS_HOOK["SEND_TX_103_02"] = "SEND-TX-103-02";
+    PROGRESS_HOOK["SEND_TX_104_01"] = "SEND-TX-104-01";
+    PROGRESS_HOOK["SEND_TX_104_02"] = "SEND-TX-104-02";
+    PROGRESS_HOOK["SEND_TX_104_03"] = "SEND-TX-104-03";
+    PROGRESS_HOOK["SEND_TX_104_04"] = "SEND-TX-104-04";
+    PROGRESS_HOOK["SEND_TX_105_01"] = "SEND-TX-105-01";
+    PROGRESS_HOOK["SEND_TX_105_02"] = "SEND-TX-105-02";
+    PROGRESS_HOOK["SEND_TX_106_01"] = "SEND-TX-106-01";
+    PROGRESS_HOOK["SEND_TX_106_02"] = "SEND-TX-106-02";
+    PROGRESS_HOOK["SEND_TX_106_03"] = "SEND-TX-106-03";
+    PROGRESS_HOOK["SEND_TX_106_03_01"] = "SEND-TX-106-03-01";
+    PROGRESS_HOOK["SEND_TX_106_03_02"] = "SEND-TX-106-03-02";
+    PROGRESS_HOOK["SEND_TX_106_04"] = "SEND-TX-106-04";
+    PROGRESS_HOOK["SEND_TX_106_05"] = "SEND-TX-106-05";
+    PROGRESS_HOOK["SEND_TX_106_06"] = "SEND-TX-106-06";
+    PROGRESS_HOOK["SEND_TX_106_07_01"] = "SEND-TX-106-07-01";
+    PROGRESS_HOOK["SEND_TX_106_07_02"] = "SEND-TX-106-07-02";
+    PROGRESS_HOOK["SEND_TX_106_07_03"] = "SEND-TX-106-07-03";
+    PROGRESS_HOOK["SEND_TX_107"] = "SEND-TX-107";
+    PROGRESS_HOOK["SEND_TX_199_01"] = "SEND-TX-199-01";
+    PROGRESS_HOOK["SEND_TX_199_02"] = "SEND-TX-199-02";
+    PROGRESS_HOOK["SEND_TX_199_99_99"] = "SEND-TX-199-99-99";
+    // Route 2: UEA → UGPC → CEA on target chain (201–299)
+    PROGRESS_HOOK["SEND_TX_201"] = "SEND-TX-201";
+    PROGRESS_HOOK["SEND_TX_202_01"] = "SEND-TX-202-01";
+    PROGRESS_HOOK["SEND_TX_202_02"] = "SEND-TX-202-02";
+    PROGRESS_HOOK["SEND_TX_203_01"] = "SEND-TX-203-01";
+    PROGRESS_HOOK["SEND_TX_203_02"] = "SEND-TX-203-02";
+    PROGRESS_HOOK["SEND_TX_204_01"] = "SEND-TX-204-01";
+    PROGRESS_HOOK["SEND_TX_204_02"] = "SEND-TX-204-02";
+    PROGRESS_HOOK["SEND_TX_204_03"] = "SEND-TX-204-03";
+    PROGRESS_HOOK["SEND_TX_204_04"] = "SEND-TX-204-04";
+    PROGRESS_HOOK["SEND_TX_207"] = "SEND-TX-207";
+    PROGRESS_HOOK["SEND_TX_209_01"] = "SEND-TX-209-01";
+    PROGRESS_HOOK["SEND_TX_209_02"] = "SEND-TX-209-02";
+    PROGRESS_HOOK["SEND_TX_299_01"] = "SEND-TX-299-01";
+    PROGRESS_HOOK["SEND_TX_299_02"] = "SEND-TX-299-02";
+    PROGRESS_HOOK["SEND_TX_299_03"] = "SEND-TX-299-03";
+    PROGRESS_HOOK["SEND_TX_299_99"] = "SEND-TX-299-99";
+    // Route 3: UEA → UGPC → CEA → sendUniversalTxToUEA → Push Chain (301–399)
+    PROGRESS_HOOK["SEND_TX_301"] = "SEND-TX-301";
+    PROGRESS_HOOK["SEND_TX_302_01"] = "SEND-TX-302-01";
+    PROGRESS_HOOK["SEND_TX_302_02"] = "SEND-TX-302-02";
+    PROGRESS_HOOK["SEND_TX_302_03_01"] = "SEND-TX-302-03-01";
+    PROGRESS_HOOK["SEND_TX_302_03_02"] = "SEND-TX-302-03-02";
+    PROGRESS_HOOK["SEND_TX_302_03_03"] = "SEND-TX-302-03-03";
+    PROGRESS_HOOK["SEND_TX_303_01"] = "SEND-TX-303-01";
+    PROGRESS_HOOK["SEND_TX_303_02"] = "SEND-TX-303-02";
+    PROGRESS_HOOK["SEND_TX_304_01"] = "SEND-TX-304-01";
+    PROGRESS_HOOK["SEND_TX_304_02"] = "SEND-TX-304-02";
+    PROGRESS_HOOK["SEND_TX_304_03"] = "SEND-TX-304-03";
+    PROGRESS_HOOK["SEND_TX_304_04"] = "SEND-TX-304-04";
+    PROGRESS_HOOK["SEND_TX_307"] = "SEND-TX-307";
+    PROGRESS_HOOK["SEND_TX_309_01"] = "SEND-TX-309-01";
+    PROGRESS_HOOK["SEND_TX_309_02"] = "SEND-TX-309-02";
+    PROGRESS_HOOK["SEND_TX_309_03"] = "SEND-TX-309-03";
+    PROGRESS_HOOK["SEND_TX_310_01"] = "SEND-TX-310-01";
+    PROGRESS_HOOK["SEND_TX_310_02"] = "SEND-TX-310-02";
+    PROGRESS_HOOK["SEND_TX_399_01"] = "SEND-TX-399-01";
+    PROGRESS_HOOK["SEND_TX_399_02"] = "SEND-TX-399-02";
+    PROGRESS_HOOK["SEND_TX_399_03"] = "SEND-TX-399-03";
+    // Multichain (multi-hop) cascade markers
+    PROGRESS_HOOK["SEND_TX_001"] = "SEND-TX-001";
+    PROGRESS_HOOK["SEND_TX_002_01"] = "SEND-TX-002-01";
+    PROGRESS_HOOK["SEND_TX_002_99_99"] = "SEND-TX-002-99-99";
+    PROGRESS_HOOK["SEND_TX_999_01"] = "SEND-TX-999-01";
+    PROGRESS_HOOK["SEND_TX_999_02"] = "SEND-TX-999-02";
+    PROGRESS_HOOK["SEND_TX_999_03"] = "SEND-TX-999-03";
+    // UEA Migration hooks (unchanged)
     PROGRESS_HOOK["UEA_MIG_01"] = "UEA-MIG-01";
     PROGRESS_HOOK["UEA_MIG_02"] = "UEA-MIG-02";
     PROGRESS_HOOK["UEA_MIG_03"] = "UEA-MIG-03";

package/src/lib/push-client/push-client.d.ts

@@ -22,6 +22,7 @@ export declare class PushClient extends EvmClient {
         dex?: {
             uniV3Factory?: `0x${string}`;
             uniV3QuoterV2?: `0x${string}`;
+            uniV3SwapRouter?: `0x${string}`;
             weth?: `0x${string}`;
         };
     } & {
@@ -75,6 +76,12 @@ export declare class PushClient extends EvmClient {
      * V2 returns expanded OutboundTx fields and repeated outbound_tx array.
      */
     getUniversalTxByIdV2(id: string): Promise<QueryGetUniversalTxResponseV2>;
+    /**
+     * Generic Cosmos searchTx — returns the raw indexed results so callers can
+     * walk events themselves. Used by the inbound-tracker to find a child UTX
+     * created from an external tx hash (`universal_tx_created.inbound_tx_hash`).
+     */
+    searchCosmosByQuery(query: string): Promise<DeliverTxResponse[]>;
     /**
      * Fetches a Cosmos transaction by its hash.
      * @param txHash The hex‐encoded transaction hash (without "0x" or with—both work).

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

@@ -134,7 +134,10 @@ class PushClient extends evm_client_1.EvmClient {
                 }
                 catch (err) {
                     // Account may not exist on-chain yet; default to sequence=0 / accountNumber=0
-                    console.warn(`[PushClient:signCosmosTx] Account lookup failed for ${sender}, defaulting to sequence=0:`, err);
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (!msg.includes('NotFound') && !msg.includes('not found')) {
+                        console.warn(`[PushClient:signCosmosTx] Account lookup failed for ${sender}:`, err);
+                    }
                 }
                 // 📦 Encode pubkey
                 const uncompressedPubKey = (0, viem_1.hexToBytes)(this.ephemeralAccount.publicKey);
@@ -206,6 +209,20 @@ class PushClient extends evm_client_1.EvmClient {
             }), 'getUniversalTxByIdV2');
         });
     }
+    /**
+     * Generic Cosmos searchTx — returns the raw indexed results so callers can
+     * walk events themselves. Used by the inbound-tracker to find a child UTX
+     * created from an external tx hash (`universal_tx_created.inbound_tx_hash`).
+     */
+    searchCosmosByQuery(query) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return this.executeWithRpcFallback((rpcUrl) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const client = yield stargate_1.StargateClient.connect(rpcUrl);
+                const results = yield client.searchTx(query);
+                return results.map((result) => JSON.parse(JSON.stringify(result, (_key, value) => typeof value === 'bigint' ? value.toString() : value)));
+            }), 'searchCosmosByQuery');
+        });
+    }
     /**
      * Fetches a Cosmos transaction by its hash.
      * @param txHash The hex‐encoded transaction hash (without "0x" or with—both work).

package/src/lib/universal-tx-detector/__tests__/fixtures/builders.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared fixture builders for universal-tx-detector specs.
+ *
+ * These helpers encode viem-compatible logs and receipts so every spec
+ * (classify, detector, cascade, scenarios) can build test data uniformly.
+ *
+ * Keep these pure — no jest mocks, no module-level state.
+ */
+import { type TransactionReceipt } from 'viem';
+export type EventDef = {
+    name: string;
+    inputs: readonly {
+        indexed: boolean;
+        type: string;
+        name: string;
+        components?: readonly unknown[];
+    }[];
+};
+export type BuiltLog = {
+    address: `0x${string}`;
+    topics: ReadonlyArray<`0x${string}` | null>;
+    data: `0x${string}`;
+    blockNumber: bigint;
+    transactionHash: `0x${string}`;
+    transactionIndex: number;
+    blockHash: `0x${string}`;
+    logIndex: number;
+    removed: false;
+};
+export declare function indexedArgs(event: EventDef, argsObj: Record<string, unknown>): Record<string, unknown>;
+export declare function buildLog(event: EventDef, argsObj: Record<string, unknown>, address: `0x${string}`, logIndex: number, txHash?: `0x${string}`): BuiltLog;
+export declare function buildReceipt(logs: BuiltLog[], to: `0x${string}`, txHash?: `0x${string}`): TransactionReceipt;

package/src/lib/universal-tx-detector/__tests__/fixtures/builders.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexedArgs = indexedArgs;
+exports.buildLog = buildLog;
+exports.buildReceipt = buildReceipt;
+/**
+ * Shared fixture builders for universal-tx-detector specs.
+ *
+ * These helpers encode viem-compatible logs and receipts so every spec
+ * (classify, detector, cascade, scenarios) can build test data uniformly.
+ *
+ * Keep these pure — no jest mocks, no module-level state.
+ */
+const viem_1 = require("viem");
+const ZERO_HASH = '0x0000000000000000000000000000000000000000000000000000000000000000';
+function indexedArgs(event, argsObj) {
+    const out = {};
+    for (const i of event.inputs)
+        if (i.indexed)
+            out[i.name] = argsObj[i.name];
+    return out;
+}
+function buildLog(event, argsObj, address, logIndex, txHash = ZERO_HASH) {
+    const topics = (0, viem_1.encodeEventTopics)({
+        abi: [
+            event,
+        ],
+        eventName: event.name,
+        args: indexedArgs(event, argsObj),
+    });
+    const nonIndexed = event.inputs.filter((i) => !i.indexed);
+    const data = nonIndexed.length === 0
+        ? '0x'
+        : (0, viem_1.encodeAbiParameters)(nonIndexed, nonIndexed.map((i) => argsObj[i.name]));
+    return {
+        address,
+        topics,
+        data,
+        blockNumber: BigInt(1),
+        transactionHash: txHash,
+        transactionIndex: 0,
+        blockHash: ZERO_HASH,
+        logIndex,
+        removed: false,
+    };
+}
+function buildReceipt(logs, to, txHash = ZERO_HASH) {
+    return {
+        status: 'success',
+        logs,
+        blockNumber: BigInt(1),
+        blockHash: ZERO_HASH,
+        contractAddress: null,
+        cumulativeGasUsed: BigInt(0),
+        effectiveGasPrice: BigInt(0),
+        from: to,
+        gasUsed: BigInt(0),
+        logsBloom: '0x',
+        to,
+        transactionHash: txHash,
+        transactionIndex: 0,
+        type: 'eip1559',
+    };
+}
+//# sourceMappingURL=builders.js.map

package/src/lib/universal-tx-detector/__tests__/fixtures/scenarios.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Parametric scenario catalogue for universal-tx-detector specs.
+ *
+ * Each ScenarioFixture declares a deterministic tx (receipt + optional
+ * mocked cosmos state) plus the assertions every consumer should check.
+ *
+ * Adding coverage for a new event shape or cascade topology = append one
+ * row here. The driver spec (__tests__/scenarios.spec.ts) picks it up
+ * automatically via describe.each.
+ */
+import type { TransactionReceipt } from 'viem';
+import { CHAIN } from '../../../constants/enums';
+import type { DecodedIdentifiers, MatchingLog, UniversalTxKind } from '../../types';
+import { deriveChildUniversalTxId, derivePcUniversalTxId } from '../../child-inbounds';
+import { type EventDef } from './builders';
+export type LogSpec = {
+    event: EventDef;
+    args: Record<string, unknown>;
+    address: `0x${string}`;
+    logIndex: number;
+};
+export type ReceiptEntry = {
+    txHash: `0x${string}`;
+    chain: CHAIN;
+    to: `0x${string}`;
+    logs: LogSpec[];
+};
+export type UtxRecordFixture = {
+    /** 32-byte hex id (no 0x prefix) or prefix; matcher lowercases and strips. */
+    id: string;
+    record: Record<string, unknown> | null;
+};
+export type ExpectedCascade = {
+    outboundCount?: number;
+    refundCount?: number;
+    childInboundCount?: number;
+    totalFlatNodes?: number;
+    rootKind?: UniversalTxKind;
+    /** For each outbound edge, the destinationChain CAIP (order-insensitive). */
+    outboundDestinations?: string[];
+};
+export type ScenarioFixture = {
+    id: string;
+    name: string;
+    kind: UniversalTxKind;
+    chain: CHAIN;
+    txHash: `0x${string}`;
+    to: `0x${string}`;
+    logs: LogSpec[];
+    /** Additional receipts the cascade walker will fetch when recursing. */
+    extraReceipts?: ReceiptEntry[];
+    /** Cosmos utx records keyed by id (hex without 0x prefix). */
+    utxRecords?: UtxRecordFixture[];
+    expectedDecoded?: Partial<DecodedIdentifiers>;
+    expectedClassifyAll?: UniversalTxKind[];
+    expectedCascade?: ExpectedCascade;
+};
+export declare function matchingLogsForFixture(f: ScenarioFixture): MatchingLog[];
+export declare function receiptForFixture(f: ScenarioFixture): TransactionReceipt;
+export declare function receiptForExtra(r: ReceiptEntry): TransactionReceipt;
+/**
+ * Flatten all utxRecord entries across a scenario and its linked fixtures
+ * into a single Map keyed by the lowercased id (no 0x prefix).
+ */
+export declare function utxRecordMap(fixtures: ScenarioFixture[]): Map<string, Record<string, unknown> | null>;
+/**
+ * Build a Map<txHashLower, TransactionReceipt> covering the primary tx +
+ * all extraReceipts across every fixture.
+ */
+export declare function receiptMap(fixtures: ScenarioFixture[]): Map<string, TransactionReceipt>;
+export declare const SCENARIOS: ScenarioFixture[];
+export { deriveChildUniversalTxId, derivePcUniversalTxId };