@pushchain/core 5.1.16 → 5.1.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "5.1.16",
+  "version": "5.1.17",
   "homepage": "https://push.org",
   "keywords": [
     "pushchain",

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

@@ -64,17 +64,17 @@ export type PreflightResult = {
 export declare function runPreflight(opts: RunPreflightOpts): PreflightResult;
 /**
  * SVM-only telemetry threshold. Buffered pool quotes above this value
- * fire `SEND-TX-203-05` (single-route) or `SEND-TX-003-05` (cascade).
- * The threshold is for visibility, not truncation — pre-flight handles
- * drain protection. v2 may add a hard cap once telemetry justifies a
- * number.
+ * fire `SEND-TX-203-05` (R2 single-route), `SEND-TX-303-06` (R3
+ * single-route), or `SEND-TX-003-05` (cascade). The threshold is for
+ * visibility, not truncation — pre-flight handles drain protection.
+ * v2 may add a hard cap once telemetry justifies a number.
  */
 export declare const SVM_NATIVE_VALUE_WARN_THRESHOLD: bigint;
 /**
  * Fire the SVM warn-threshold hook + log line if the buffered quote
  * exceeds the threshold. Non-blocking; `nativeValueForGas` is not
- * truncated by the caller. The hook ID switches to the cascade 0xx
- * bucket (`003-05`) when `pathTag === 'CASCADE'` so cascade streams
- * stay self-consistent.
+ * truncated by the caller. The hook ID switches between buckets so
+ * each stream stays self-consistent within its convention (R2 → 203,
+ * R3 → 303, cascade → 003).
  */
 export declare function maybeFireSvmWarnThreshold(ctx: OrchestratorContext, bufferedQuote: bigint, gasToken: `0x${string}`, pathTag: PreflightPathTag): void;

package/src/lib/orchestrator/internals/preflight.js

@@ -51,16 +51,22 @@ function legacyClamp(ueaBalance, requiredValue, gasReserve) {
  */
 function runPreflight(opts) {
     const { ctx, ueaAddress, ueaBalance, requiredValue, gasReserve, pathTag, burnToken, burnAmount, prc20Balance, segmentIndex, allowUnderfundedSwap, } = opts;
-    // Cascade context emits 003-xx (cascade 0xx bucket); single routes (R2/R3)
-    // emit 203-xx (R2 bucket). The two ID sets share an identical formatter
+    // Each route bucket gets its own preflight IDs so hook streams stay
+    // self-consistent within their convention (R2 → 203-xx, R3 → 303-xx,
+    // cascade → 003-xx). The three hook formatters share an identical
     // signature, so the runtime branching is just an ID swap at each fire site.
     const isCascade = pathTag === 'CASCADE';
+    const isR3 = pathTag === 'R3_EVM' || pathTag === 'R3_SVM';
     const HOOK_PRE_INFO = isCascade
         ? progress_hook_types_1.PROGRESS_HOOK.SEND_TX_003_03
-        : progress_hook_types_1.PROGRESS_HOOK.SEND_TX_203_03;
+        : isR3
+            ? progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_04
+            : progress_hook_types_1.PROGRESS_HOOK.SEND_TX_203_03;
     const HOOK_PRE_FAIL = isCascade
         ? progress_hook_types_1.PROGRESS_HOOK.SEND_TX_003_04
-        : progress_hook_types_1.PROGRESS_HOOK.SEND_TX_203_04;
+        : isR3
+            ? progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_05
+            : progress_hook_types_1.PROGRESS_HOOK.SEND_TX_203_04;
     // 1. PRC-20 burn-balance check (skipped when burnAmount = 0 — R3 paths
     //    structurally hold zero of the source-chain native PRC-20; see plan §9 #4).
     if (burnAmount && burnAmount > BigInt(0) && burnToken) {
@@ -119,25 +125,27 @@ function runPreflight(opts) {
 }
 /**
  * SVM-only telemetry threshold. Buffered pool quotes above this value
- * fire `SEND-TX-203-05` (single-route) or `SEND-TX-003-05` (cascade).
- * The threshold is for visibility, not truncation — pre-flight handles
- * drain protection. v2 may add a hard cap once telemetry justifies a
- * number.
+ * fire `SEND-TX-203-05` (R2 single-route), `SEND-TX-303-06` (R3
+ * single-route), or `SEND-TX-003-05` (cascade). The threshold is for
+ * visibility, not truncation — pre-flight handles drain protection.
+ * v2 may add a hard cap once telemetry justifies a number.
  */
 exports.SVM_NATIVE_VALUE_WARN_THRESHOLD = BigInt(5000) * BigInt(1e18);
 /**
  * Fire the SVM warn-threshold hook + log line if the buffered quote
  * exceeds the threshold. Non-blocking; `nativeValueForGas` is not
- * truncated by the caller. The hook ID switches to the cascade 0xx
- * bucket (`003-05`) when `pathTag === 'CASCADE'` so cascade streams
- * stay self-consistent.
+ * truncated by the caller. The hook ID switches between buckets so
+ * each stream stays self-consistent within its convention (R2 → 203,
+ * R3 → 303, cascade → 003).
  */
 function maybeFireSvmWarnThreshold(ctx, bufferedQuote, gasToken, pathTag) {
     if (bufferedQuote <= exports.SVM_NATIVE_VALUE_WARN_THRESHOLD)
         return;
     const HOOK_WARN = pathTag === 'CASCADE'
         ? progress_hook_types_1.PROGRESS_HOOK.SEND_TX_003_05
-        : progress_hook_types_1.PROGRESS_HOOK.SEND_TX_203_05;
+        : pathTag === 'R3_EVM' || pathTag === 'R3_SVM'
+            ? progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_06
+            : progress_hook_types_1.PROGRESS_HOOK.SEND_TX_203_05;
     (0, context_1.fireProgressHook)(ctx, HOOK_WARN, bufferedQuote, exports.SVM_NATIVE_VALUE_WARN_THRESHOLD, gasToken, pathTag);
     (0, context_1.printLog)(ctx, `[preflight ${pathTag}] SVM warn-threshold tripped: bufferedQuote=${bufferedQuote} > ` +
         `${exports.SVM_NATIVE_VALUE_WARN_THRESHOLD} for gasToken=${gasToken} — pool may be skewed`);

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

@@ -176,7 +176,8 @@ function reconstructR3(universalTxResponse, universalTxData, isFailed, errorMsg)
     events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_02](universalTxResponse.from, ceaAddress, sourceChain));
     // R3 pre-flight reconstruction — R3 EVM burnAmount=0, R3 SVM burnAmount=0
     // (post-fix). Only the NATIVE pre-flight check fires; no PRC-20 second hook.
-    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_203_03](BigInt(0), BigInt(0), true, universalTxResponse.from, 'R3_EVM', { kind: 'NATIVE' }));
+    // R3 single-route uses 303-04 (R3 bucket); see runPreflight in preflight.ts.
+    events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_04](BigInt(0), BigInt(0), true, universalTxResponse.from, 'R3_EVM', { kind: 'NATIVE' }));
     events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_304_01]());
     events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_304_02]());
     events.push(progress_hook_1.default[progress_hook_types_1.PROGRESS_HOOK.SEND_TX_304_03]());

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

@@ -523,6 +523,63 @@ const RAW_HOOKS_R3 = {
         response: { uea: ueaAddr, cea: ceaAddr, chain: sourceChain, deployed: true },
         level: 'SUCCESS',
     }),
+    // R3 single-route pre-flight balance check. Same payload shape as 203-03/04/05.
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_04]: (required, available, sufficient, ueaAddress, pathTag, extra) => {
+        var _a, _b, _c;
+        const kind = (_a = extra === null || extra === void 0 ? void 0 : extra.kind) !== null && _a !== void 0 ? _a : 'NATIVE';
+        const availableStr = kind === 'PRC20' ? `${available} units` : formatPC(available);
+        const requiredStr = kind === 'PRC20' ? `${required} units` : formatPC(required);
+        return {
+            id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_04,
+            title: 'Pre-flight Balance Check',
+            message: `UEA balance: ${availableStr}; required: ${requiredStr}; ` +
+                `${sufficient ? 'sufficient' : 'INSUFFICIENT'} (${pathTag})`,
+            response: {
+                required,
+                available,
+                sufficient,
+                ueaAddress,
+                pathTag,
+                kind,
+                burnToken: (_b = extra === null || extra === void 0 ? void 0 : extra.burnToken) !== null && _b !== void 0 ? _b : null,
+                segmentIndex: (_c = extra === null || extra === void 0 ? void 0 : extra.segmentIndex) !== null && _c !== void 0 ? _c : null,
+            },
+            level: sufficient ? 'INFO' : 'ERROR',
+        };
+    },
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_05]: (required, available, shortfall, ueaAddress, pathTag, extra) => {
+        var _a, _b, _c, _d;
+        const kind = (_a = extra === null || extra === void 0 ? void 0 : extra.kind) !== null && _a !== void 0 ? _a : 'NATIVE';
+        const shortfallStr = kind === 'PRC20' ? `${shortfall} units` : formatPC(shortfall);
+        const remediation = kind === 'PRC20'
+            ? `Bridge the burn token (${(_b = extra === null || extra === void 0 ? void 0 : extra.burnToken) !== null && _b !== void 0 ? _b : 'PRC-20'}) to UEA ${ueaAddress} before retrying.`
+            : `Bridge >=${shortfallStr} to UEA ${ueaAddress} before retrying.`;
+        return {
+            id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_05,
+            title: 'Insufficient UEA Balance',
+            message: `Shortfall ${shortfallStr} on ${pathTag}. ${remediation}`,
+            response: {
+                required,
+                available,
+                shortfall,
+                ueaAddress,
+                pathTag,
+                kind,
+                burnToken: (_c = extra === null || extra === void 0 ? void 0 : extra.burnToken) !== null && _c !== void 0 ? _c : null,
+                segmentIndex: (_d = extra === null || extra === void 0 ? void 0 : extra.segmentIndex) !== null && _d !== void 0 ? _d : null,
+            },
+            level: 'ERROR',
+        };
+    },
+    [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_06]: (quoted, threshold, gasToken, pathTag) => ({
+        id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_303_06,
+        title: 'SVM Native-Value Warn Threshold',
+        message: `Buffered pool quote ${formatPC(quoted)} exceeds warn threshold ${formatPC(threshold)} ` +
+            `for ${gasToken} (${pathTag}). Pool may be skewed or quote is unusually large. ` +
+            `No action taken — pre-flight will determine if balance covers it.`,
+        response: { quoted, threshold, gasToken, pathTag },
+        level: 'INFO',
+    }),
     [progress_hook_types_1.PROGRESS_HOOK.SEND_TX_304_01]: () => ({
         id: progress_hook_types_1.PROGRESS_HOOK.SEND_TX_304_01,
         title: 'Awaiting Signature',

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

@@ -68,6 +68,9 @@ export declare enum PROGRESS_HOOK {
     SEND_TX_303_03_01 = "SEND-TX-303-03-01",// Sizer: Case A (< $1, padded)
     SEND_TX_303_03_02 = "SEND-TX-303-03-02",// Sizer: Case B ($1–$10, happy path)
     SEND_TX_303_03_03 = "SEND-TX-303-03-03",// Sizer: Case C (> $10, split + overflow bridge)
+    SEND_TX_303_04 = "SEND-TX-303-04",// R3 pre-flight balance check (INFO when sufficient, ERROR when insufficient)
+    SEND_TX_303_05 = "SEND-TX-303-05",// R3 pre-flight FAILED (ERROR, terminal precursor before 399-02)
+    SEND_TX_303_06 = "SEND-TX-303-06",// R3 SVM warn-threshold tripped (INFO, no action)
     SEND_TX_304_01 = "SEND-TX-304-01",
     SEND_TX_304_02 = "SEND-TX-304-02",
     SEND_TX_304_03 = "SEND-TX-304-03",
@@ -99,7 +102,7 @@ export declare enum PROGRESS_HOOK {
 }
 export type PROGRESS_HOOK_R1 = PROGRESS_HOOK.SEND_TX_101 | PROGRESS_HOOK.SEND_TX_102_01 | PROGRESS_HOOK.SEND_TX_103_01 | PROGRESS_HOOK.SEND_TX_103_02 | PROGRESS_HOOK.SEND_TX_103_03 | PROGRESS_HOOK.SEND_TX_103_03_01 | PROGRESS_HOOK.SEND_TX_103_03_02 | PROGRESS_HOOK.SEND_TX_103_03_03 | PROGRESS_HOOK.SEND_TX_103_03_04 | 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_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_203_03 | PROGRESS_HOOK.SEND_TX_203_04 | PROGRESS_HOOK.SEND_TX_203_05 | 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_303_01 | PROGRESS_HOOK.SEND_TX_303_02 | PROGRESS_HOOK.SEND_TX_303_03_01 | PROGRESS_HOOK.SEND_TX_303_03_02 | PROGRESS_HOOK.SEND_TX_303_03_03 | 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_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_303_01 | PROGRESS_HOOK.SEND_TX_303_02 | PROGRESS_HOOK.SEND_TX_303_03_01 | PROGRESS_HOOK.SEND_TX_303_03_02 | PROGRESS_HOOK.SEND_TX_303_03_03 | PROGRESS_HOOK.SEND_TX_303_04 | PROGRESS_HOOK.SEND_TX_303_05 | PROGRESS_HOOK.SEND_TX_303_06 | 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_003_03 | PROGRESS_HOOK.SEND_TX_003_04 | PROGRESS_HOOK.SEND_TX_003_05 | 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

@@ -64,6 +64,14 @@ var PROGRESS_HOOK;
     PROGRESS_HOOK["SEND_TX_303_03_01"] = "SEND-TX-303-03-01";
     PROGRESS_HOOK["SEND_TX_303_03_02"] = "SEND-TX-303-03-02";
     PROGRESS_HOOK["SEND_TX_303_03_03"] = "SEND-TX-303-03-03";
+    // R3 single-route pre-flight balance check. Mirror of R2's 203-03/04/05
+    // semantics scoped to the R3 (3xx) bucket. Slots 303-03/-03-* are already
+    // owned by the sizer cluster so preflight uses the next free slots
+    // (304-01..04 are sign/verify), inserted between sizer and signature
+    // burst because that is the temporal point where UEA balance is checked.
+    PROGRESS_HOOK["SEND_TX_303_04"] = "SEND-TX-303-04";
+    PROGRESS_HOOK["SEND_TX_303_05"] = "SEND-TX-303-05";
+    PROGRESS_HOOK["SEND_TX_303_06"] = "SEND-TX-303-06";
     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";