@pushchain/core 6.0.1 → 6.0.3

package/CHANGELOG.md

@@ -1,4 +1,70 @@
-@pushchain/core@5.2.0 (unreleased)
+@pushchain/core@6.0.2 (unreleased)
+
+- Token constants now expose the missing `USDT.bsc` chain-suffix accessor,
+  while keeping `USDT.bnb` as a deprecated alias for backward compatibility.
+
+- Updated Donut testnet stable token metadata to match the current source of
+  truth: external moveable token addresses are kept separate from Push Chain
+  PRC20 addresses, and the WPC/stable pool address audit table now reflects the
+  documented PRC20/pool pairs.
+
+---
+
+@pushchain/core@6.0.1 (2026-05-15)
+
+- Pre-flight UEA balance checks now default to warning-only behavior and
+  proceed when short. `sendTransaction` and `prepareTransaction` accept
+  `options.enforceGasCheck: true` to restore fail-fast behavior with
+  `InsufficientUEABalanceError`; pre-flight progress hooks now report
+  `WARNING` vs `ERROR` with shortfall metadata.
+
+- Token constants added the `USDC.bsc` BSC suffix accessor while retaining
+  `USDC.bnb` as a deprecated compatibility alias.
+
+- Consolidated tests, renamed transaction `target` fields to `recipient`, and
+  fixed SVM test cases around the release.
+
+---
+
+@pushchain/core@6.0.0 (2026-05-14)
+
+- Updated audit-driven contract and pool configuration, including BNB CEA
+  address changes and refreshed pool addresses.
+
+- Fixed cascade, SVM payload, and SVM execution flows, with additional test-case
+  coverage for the audited scenarios.
+
+- Improved PC amount formatting in transaction output and diagnostics.
+
+---
+
+@pushchain/core@5.1.18 (2026-05-12)
+
+- Added `executeTransactions` progress-hook coverage and fixed cascade
+  scenarios, including fresh-UEA and six-hop flows.
+
+- Removed the `allowUnderfundedSwap` parameter and tightened native PC
+  formatting.
+
+---
+
+@pushchain/core@5.1.17 (2026-05-07)
+
+- Fixed the R3 EVM path tag so progress hooks emit the `303` route family
+  instead of `203`.
+
+---
+
+@pushchain/core@5.1.16 (2026-05-07)
+
+- Added pre-flight balance-check progress hooks.
+
+- Fixed SVM rent checks, SVM upward ceiling behavior, cascade progress-hook
+  handling, and shared PC formatting.
+
+---
+
+@pushchain/core@5.1.5 (2026-04-20)
 
 - Route 1 (UOA → Push) now applies Case A/B/C USD-bucket sizing to the
   Push-chain gas cost. Case A pads deposits to the $1 floor; Case B passes

package/package.json

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

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

@@ -36,6 +36,8 @@ export declare const SYNTHETIC_PUSH_ERC20: Record<PUSH_NETWORK, {
     USDC_ARB: `0x${string}`;
     USDT_SOL: `0x${string}`;
     USDC_SOL: `0x${string}`;
+    USDT_BSC: `0x${string}`;
+    /** @deprecated Use USDT_BSC instead. */
     USDT_BNB: `0x${string}`;
     USDC_BSC: `0x${string}`;
     /** @deprecated Use USDC_BSC instead. */

package/src/lib/constants/chain.js

@@ -62,6 +62,7 @@ exports.SYNTHETIC_PUSH_ERC20 = {
         USDC_ARB: '0x1091cCBA2FF8d2A131AE4B35e34cf3308C48572C',
         USDT_SOL: '0x4f1A3D22d170a2F4Bddb37845a962322e24f4e34',
         USDC_SOL: '0x04B8F634ABC7C879763F623e0f0550a4b5c4426F',
+        USDT_BSC: '0x731aF1Da5365259d27528557EE4aFBA4baC90ef2',
         USDT_BNB: '0x731aF1Da5365259d27528557EE4aFBA4baC90ef2',
         USDC_BSC: '0x120EBf25Dad7D6a09Ad2316f23f9Be95DBb90639',
         USDC_BNB: '0x120EBf25Dad7D6a09Ad2316f23f9Be95DBb90639',
@@ -83,6 +84,7 @@ exports.SYNTHETIC_PUSH_ERC20 = {
         USDC_ARB: '0x1091cCBA2FF8d2A131AE4B35e34cf3308C48572C',
         USDT_SOL: '0x4f1A3D22d170a2F4Bddb37845a962322e24f4e34',
         USDC_SOL: '0x04B8F634ABC7C879763F623e0f0550a4b5c4426F',
+        USDT_BSC: '0x731aF1Da5365259d27528557EE4aFBA4baC90ef2',
         USDT_BNB: '0x731aF1Da5365259d27528557EE4aFBA4baC90ef2',
         USDC_BSC: '0x120EBf25Dad7D6a09Ad2316f23f9Be95DBb90639',
         USDC_BNB: '0x120EBf25Dad7D6a09Ad2316f23f9Be95DBb90639',
@@ -104,6 +106,7 @@ exports.SYNTHETIC_PUSH_ERC20 = {
         USDC_ARB: '0xTBD',
         USDT_SOL: '0xTBD',
         USDC_SOL: '0xTBD',
+        USDT_BSC: '0xTBD',
         USDT_BNB: '0xTBD',
         USDC_BSC: '0xTBD',
         USDC_BNB: '0xTBD',
@@ -125,6 +128,7 @@ exports.SYNTHETIC_PUSH_ERC20 = {
         USDC_ARB: '0xTBD',
         USDT_SOL: '0xTBD',
         USDC_SOL: '0xTBD',
+        USDT_BSC: '0xTBD',
         USDT_BNB: '0xTBD',
         USDC_BSC: '0xTBD',
         USDC_BNB: '0xTBD',

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

@@ -73,6 +73,8 @@ export interface ChainSuffixAccessor {
     readonly eth: PushChainMoveableToken;
     readonly arb: PushChainMoveableToken;
     readonly base: PushChainMoveableToken;
+    readonly bsc: PushChainMoveableToken;
+    /** @deprecated Use `bsc` instead. */
     readonly bnb: PushChainMoveableToken;
     readonly sol: PushChainMoveableToken;
 }

package/src/lib/constants/tokens.js

@@ -85,7 +85,7 @@ const TOKEN_META = {
         USDT: {
             symbol: 'USDT',
             decimals: 6,
-            address: '0x7169D38820dfd117C3FA1f22a697dBA58d90BA06',
+            address: '0xC4230aEaFcF6b8B49a7b4e53886420f00ff71876',
             mechanism: 'approve',
         },
         WETH: {
@@ -139,7 +139,7 @@ const TOKEN_META = {
         USDT: {
             symbol: 'USDT',
             decimals: 6,
-            address: '0x1419d7C74D234fA6B73E06A2ce7822C1d37922f0',
+            address: '0xE30928528f52CAEeB75fB07837e22d77D47e9c07',
             mechanism: 'approve',
         },
         USDC: {
@@ -166,7 +166,7 @@ const TOKEN_META = {
         USDT: {
             symbol: 'USDT',
             decimals: 6,
-            address: '0x9FF5a186f53F6E6964B00320Da1D2024DE11E0cB',
+            address: '0x4D7646B9eE3D68F4b0F135B5cbc66B00819F6b61',
             mechanism: 'approve',
         },
         USDC: {
@@ -193,13 +193,13 @@ const TOKEN_META = {
         USDT: {
             symbol: 'USDT',
             decimals: 6,
-            address: '0xBC14F348BC9667be46b35Edc9B68653d86013DC5',
+            address: '0xE935d9c9C24D02E61186c640cc01d713C876d40F',
             mechanism: 'approve',
         },
         USDC: {
             symbol: 'USDC',
             decimals: 6,
-            address: '0x64544969ed7EBf5f083679233325356EbE738930',
+            address: '0xA8802F96cAd0d45343d9bc660B6f7d80050A660b',
             mechanism: 'approve',
         },
     },
@@ -265,7 +265,7 @@ function buildPushChainMoveableTokenList() {
         mk('USDT', 6, s.USDT_ETH, enums_1.CHAIN.ETHEREUM_SEPOLIA),
         mk('USDT', 6, s.USDT_ARB, enums_1.CHAIN.ARBITRUM_SEPOLIA),
         mk('USDT', 6, s.USDT_BASE, enums_1.CHAIN.BASE_SEPOLIA),
-        mk('USDT', 6, s.USDT_BNB, enums_1.CHAIN.BNB_TESTNET),
+        mk('USDT', 6, s.USDT_BSC, enums_1.CHAIN.BNB_TESTNET),
         mk('USDT', 6, s.USDT_SOL, enums_1.CHAIN.SOLANA_DEVNET),
         mk('USDC', 6, s.USDC_ETH, enums_1.CHAIN.ETHEREUM_SEPOLIA),
         mk('USDC', 6, s.USDC_ARB, enums_1.CHAIN.ARBITRUM_SEPOLIA),
@@ -365,6 +365,7 @@ function buildPushChainMoveableTokenAccessor() {
         sourceChain,
         prc20Address: address,
     });
+    const usdtBsc = mk('USDT', 6, s.USDT_BSC, enums_1.CHAIN.BNB_TESTNET);
     const usdcBsc = mk('USDC', 6, s.USDC_BSC, enums_1.CHAIN.BNB_TESTNET);
     return {
         pEth: mk('pETH', 18, s.pETH, enums_1.CHAIN.ETHEREUM_SEPOLIA),
@@ -379,7 +380,8 @@ function buildPushChainMoveableTokenAccessor() {
             eth: mk('USDT', 6, s.USDT_ETH, enums_1.CHAIN.ETHEREUM_SEPOLIA),
             arb: mk('USDT', 6, s.USDT_ARB, enums_1.CHAIN.ARBITRUM_SEPOLIA),
             base: mk('USDT', 6, s.USDT_BASE, enums_1.CHAIN.BASE_SEPOLIA),
-            bnb: mk('USDT', 6, s.USDT_BNB, enums_1.CHAIN.BNB_TESTNET),
+            bsc: usdtBsc,
+            bnb: usdtBsc,
             sol: mk('USDT', 6, s.USDT_SOL, enums_1.CHAIN.SOLANA_DEVNET),
         },
         USDC: {

package/src/lib/orchestrator/internals/pc-usd-oracle.d.ts

@@ -1,6 +1,6 @@
 import { CHAIN } from '../../constants/enums';
 import type { OrchestratorContext } from './context';
-type StableKey = 'USDT_ETH' | 'USDT_ARB' | 'USDT_BASE' | 'USDT_BNB' | 'USDC_BSC' | 'USDT_SOL';
+type StableKey = 'USDT_ETH' | 'USDT_ARB' | 'USDT_BASE' | 'USDT_BSC' | 'USDC_BSC' | 'USDT_SOL';
 /**
  * Get $PC/USD price (8 decimals) for the given origin chain's route.
  * Returns 0 on any failure — caller is expected to fall back to

package/src/lib/orchestrator/internals/pc-usd-oracle.js

@@ -37,7 +37,7 @@ const ORIGIN_TO_STABLE = {
     [enums_1.CHAIN.ETHEREUM_SEPOLIA]: 'USDT_ETH',
     [enums_1.CHAIN.ARBITRUM_SEPOLIA]: 'USDT_ARB',
     [enums_1.CHAIN.BASE_SEPOLIA]: 'USDT_BASE',
-    [enums_1.CHAIN.BNB_TESTNET]: 'USDT_BNB',
+    [enums_1.CHAIN.BNB_TESTNET]: 'USDT_BSC',
     [enums_1.CHAIN.SOLANA_DEVNET]: 'USDT_SOL',
 };
 /** Default decimals for stable PRC-20s on Push Chain. */

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

@@ -98,10 +98,10 @@ function reconstructProgressEvents(universalTxResponse, universalTxData) {
     // omitted from reconstruction because R1 doesn't register a UniversalTx
     // on Push Chain, so `universalTxData` is usually undefined here and we
     // have no reliable signal to tell the three paths apart. Callers who want
-    // the full live sequence should either register `progressHook` at
-    // `initialize()` time (client-level) or call `tx.progressHook(cb)` after
-    // sendTransaction — both deliver the full stream from the execute-phase
-    // event buffer.
+    // the full live sequence should register a progress hook at initialize
+    // time, pass `sendTransaction(params, { progressHook })`, or call
+    // `tx.progressHook(cb)` after sendTransaction — all deliver the full stream
+    // from the execute-phase event buffer.
     const events = [];
     const originParts = universalTxResponse.origin.split(':');
     const chainNamespace = originParts.length >= 2 ? `${originParts[0]}:${originParts[1]}` : originParts[0];

package/src/lib/orchestrator/orchestrator.js

@@ -131,10 +131,33 @@ class Orchestrator {
      */
     execute(params, options) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e;
             if (options) {
                 params = Object.assign(Object.assign({}, params), { options: Object.assign(Object.assign({}, params.options), options) });
             }
+            const perCallHook = (_a = params.options) === null || _a === void 0 ? void 0 : _a.progressHook;
+            const originalExecuteHook = this.progressHook;
+            const currentHook = this.progressHook;
+            const shouldWrapPerCallHook = !!perCallHook &&
+                perCallHook !== currentHook &&
+                (currentHook === null || currentHook === void 0 ? void 0 : currentHook.__pushPerCallHook) !== perCallHook;
+            const attachPerCallHookForWait = (response) => {
+                if (perCallHook && response._setProgressHookNoReplay) {
+                    response._setProgressHookNoReplay(perCallHook);
+                }
+                return response;
+            };
+            if (shouldWrapPerCallHook) {
+                const baseHook = this.progressHook;
+                const wrappedHook = ((event) => {
+                    if (baseHook && baseHook !== perCallHook) {
+                        baseHook(event);
+                    }
+                    perCallHook(event);
+                });
+                wrappedHook.__pushPerCallHook = perCallHook;
+                this.progressHook = wrappedHook;
+            }
             // Snapshot the caller's active route — `executeMultiChain` recurses into
             // this same method for R2/R3's inner Push-side execution, and without
             // snapshot/restore the recursive `detectRoute(params)` would clobber the
@@ -146,7 +169,7 @@ class Orchestrator {
             try {
                 detectedRoute = (0, route_detector_1.detectRoute)(params);
             }
-            catch (_e) {
+            catch (_f) {
                 detectedRoute = route_detector_1.TransactionRoute.UOA_TO_PUSH;
             }
             // Don't downgrade an outer R2/R3/R4 route when the recursive inner call
@@ -164,14 +187,14 @@ class Orchestrator {
                 // Lazy UEA upgrade check
                 try {
                     if (!this.accountStatusCache || !this.accountStatusCache.uea.loaded) {
-                        yield ((_a = this.accountStatusReadyPromise) !== null && _a !== void 0 ? _a : this.getAccountStatus());
+                        yield ((_b = this.accountStatusReadyPromise) !== null && _b !== void 0 ? _b : this.getAccountStatus());
                     }
                     // If background resolved but cache still empty (timeout/error), fetch fresh
                     if (!this.accountStatusCache || !this.accountStatusCache.uea.loaded) {
                         yield this.getAccountStatus();
                     }
-                    if (((_b = this.accountStatusCache) === null || _b === void 0 ? void 0 : _b.uea.deployed) &&
-                        ((_c = this.accountStatusCache) === null || _c === void 0 ? void 0 : _c.uea.requiresUpgrade)) {
+                    if (((_c = this.accountStatusCache) === null || _c === void 0 ? void 0 : _c.uea.deployed) &&
+                        ((_d = this.accountStatusCache) === null || _d === void 0 ? void 0 : _d.uea.requiresUpgrade)) {
                         yield this.upgradeAccount({ progressHook: this.progressHook });
                     }
                 }
@@ -179,10 +202,10 @@ class Orchestrator {
                     (0, internals_1.printLog)(this.ctx, `Lazy UEA upgrade check failed: ${err instanceof Error ? err.message : String(err)}. Proceeding with transaction.`);
                 }
                 // Check if this is a multi-chain request (has ChainTarget or from.chain)
-                const isMultiChain = (0, route_detector_1.isChainTarget)(params.to) || ('from' in params && ((_d = params.from) === null || _d === void 0 ? void 0 : _d.chain));
+                const isMultiChain = (0, route_detector_1.isChainTarget)(params.to) || ('from' in params && ((_e = params.from) === null || _e === void 0 ? void 0 : _e.chain));
                 if (isMultiChain) {
                     try {
-                        return yield (0, internals_1.executeMultiChain)(this.ctx, params, this.execute.bind(this));
+                        return attachPerCallHookForWait(yield (0, internals_1.executeMultiChain)(this.ctx, params, this.execute.bind(this)));
                     }
                     catch (err) {
                         // R2/R3/R4 outer catch — fires the route-correct terminal failure
@@ -230,11 +253,11 @@ class Orchestrator {
                 try {
                     const rcb = () => this._getResponseCallbacks();
                     if (execute.funds) {
-                        return !hasData
+                        return attachPerCallHookForWait(!hasData
                             ? yield (0, internals_1.executeFundsOnly)(this.ctx, execute, eventBuffer, rcb)
-                            : yield (0, internals_1.executeFundsWithPayload)(this.ctx, execute, eventBuffer, rcb);
+                            : yield (0, internals_1.executeFundsWithPayload)(this.ctx, execute, eventBuffer, rcb));
                     }
-                    return yield (0, internals_1.executeStandardPayload)(this.ctx, execute, eventBuffer, rcb);
+                    return attachPerCallHookForWait(yield (0, internals_1.executeStandardPayload)(this.ctx, execute, eventBuffer, rcb));
                 }
                 catch (err) {
                     const errMessage = err instanceof Error
@@ -277,6 +300,9 @@ class Orchestrator {
                 }
             }
             finally {
+                if (shouldWrapPerCallHook) {
+                    this.progressHook = originalExecuteHook;
+                }
                 // Restore the caller's route so a recursive inner R1 execute doesn't
                 // leak its UOA_TO_PUSH route back to the outer R2/R3 frame.
                 this.currentRoute = previousRoute;

package/src/lib/orchestrator/orchestrator.types.d.ts

@@ -38,6 +38,15 @@ export interface TransactionExecutionOptions {
      * - true: emit the failure hook, throw InsufficientUEABalanceError, and stop
      */
     enforceGasCheck?: boolean;
+    /**
+     * Optional per-call progress callback for sendTransaction().
+     * Additive with the init-time `progressHook` passed to `PushChain.initialize`:
+     * both hooks receive every `ProgressEvent` emitted during this call. The
+     * callback is also registered on the returned response for wait-phase
+     * progress without replaying already-fired events. Dedups by reference if it
+     * matches the init-time hook.
+     */
+    progressHook?: (event: import('../progress-hook/progress-hook.types').ProgressEvent) => void;
 }
 export type ExecuteParams = {
     /**
@@ -184,10 +193,11 @@ export interface UniversalTxResponse {
     progressHook: (callback: (event: import('../progress-hook/progress-hook.types').ProgressEvent) => void) => void;
     /**
      * @internal Register a wait-phase progressHook without replaying buffered
-     * events. Used by `trackTransaction()` to auto-attach the caller's per-call
-     * progressHook so `tracked.wait()` can deliver wait-phase events (209-xx /
-     * 299-xx / 399-xx) to the same callback — without re-emitting the
-     * reconstructed execute-phase stream that trackTransaction already fired.
+     * events. Used by `sendTransaction(..., { progressHook })` and
+     * `trackTransaction()` to auto-attach the caller's per-call progressHook so
+     * `.wait()` can deliver wait-phase events (209-xx / 299-xx / 399-xx) to the
+     * same callback — without re-emitting the execute/reconstructed stream that
+     * already fired.
      */
     _setProgressHookNoReplay?: (callback: (event: import('../progress-hook/progress-hook.types').ProgressEvent) => void) => void;
     type: string;

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

@@ -71,6 +71,12 @@ export declare class PushChain {
          * @param options.enforceGasCheck - Defaults to false. When true, the
          *   SDK stops on pre-flight gas/balance shortfall instead of warning
          *   and proceeding.
+         * @param options.progressHook - Optional per-call progress callback.
+         *   Additive with the init-time `progressHook` passed to `initialize`:
+         *   both hooks receive every `ProgressEvent` emitted during this call.
+         *   The callback is also registered on the returned response for wait()
+         *   progress without replaying already-fired events. Dedups by reference
+         *   if it matches the init-time hook.
          */
         sendTransaction: Orchestrator['execute'];
         /**

package/src/lib/utils.js

@@ -696,7 +696,7 @@ Utils.tokens = {
                 else if (isBaseFamily)
                     key = 'USDT_BASE';
                 else if (isBnbFamily)
-                    key = 'USDT_BNB';
+                    key = 'USDT_BSC';
                 else if (isSolFamily)
                     key = 'USDT_SOL';
                 else