@pushchain/core 6.0.27-alpha.4 → 6.0.27-alpha.6

package/AGW.md

@@ -136,7 +136,7 @@ Creation and rule-preparation errors include a zero-based `details.ruleIndex` wh
 
 A DEX condition-limit failure reports `details.reason = 'RULE_CONSTRAINT_LIMIT'`, `actual`, `limit` and `callCount`. Conditions here are generated input checks (for example token, recipient and amount checks), rather than the number of visible function names. A stock two-token, single-router preset contains six allowed-call entries and twenty conditions. Appending the same call list again makes forty conditions. The SDK rejects this; it does not deduplicate, remove conditions or split authority automatically. Preserve per-chain rules and regenerate after edits rather than appending generated calls.
 
-For the review screen, show the actual network (including testnet name), selected token addresses and limits. Label maxGasPerCall as a maximum PC gas budget, not a guaranteed fee or execution gas-unit count. maxTotal meters cumulative Push outbounds; it is not a lifetime destination-spend limit.
+For the review screen, show the actual network (including testnet name), selected token addresses and limits. Label maxGasPerCall as a maximum PC gas budget, not a guaranteed fee or execution gas-unit count. maxTotal meters cumulative Push outbounds, including outbounds whose destination execution later fails; it is not a lifetime destination-spend limit. Destination pins and maxValue limit each call separately.
 
 ## Solana destinations
 
@@ -256,7 +256,7 @@ These are small, protocol-specific subsets chosen to fit the 32-call/32-pin ceil
 | Arbitrum Sepolia | WETH / Circle USDC | Aave USDC |
 | BSC testnet | WBNB / Venus USDT | Venus USDT, USDC |
 
-Staking defaults are ETH/stETH/wstETH on Ethereum and the reviewed EigenLayer strategy's WETH on Sepolia. Testnet tokens with similar names can have different addresses; the returned addresses are authoritative. Defaults do not guarantee active reserves, liquidity or a Push PRC20 route. An unmodified preset cannot be granted when its assets lack matching PRC20 routes. The SDK preserves the selected tokens and caps and reports unavailable routes; it never removes assets to bypass this check. No runtime metadata/price fetch is added to get.
+Staking defaults are ETH/stETH/wstETH on Ethereum and the reviewed EigenLayer strategy's WETH on Sepolia. Testnet tokens with similar names can have different addresses; the returned addresses are authoritative. Defaults do not guarantee active reserves, liquidity or a Push PRC20 route. An unmodified preset cannot be granted when its assets lack matching PRC20 routes. The SDK preserves the selected tokens and caps and reports unavailable routes; it never removes assets to bypass this check. On Donut, every default asset of DEXES Sepolia and LENDING Arbitrum Sepolia currently has a registered route; the other testnet combinations do not. No runtime metadata/price fetch is added to get.
 
 ### Funding and release-network checks
 
@@ -264,7 +264,7 @@ Missing PRC20 registry entries produce `BRIDGE_ASSET_UNAVAILABLE`, and readiness
 
 The public preset API has no `funding` option. Remove it from existing integrations; supplying it now produces `INVALID_RULE` rather than silently changing permissions. Internal prefunded CEA test fixtures explicitly clear bridge assets to isolate protocol constraints. Those fixtures do not demonstrate that an unsupported preset route is executable.
 
-Existing mappings distinguish token identity by chain and address, including address casing for EVM. WETH/stETH Sepolia mappings and string/address-word source metadata are supported; mainnet or other-chain WETH is never aliased to them. Protocol mock LINK, Moonwell/Venus mocks and Circle testnet USDC can differ from the supported source tokens; they remain unavailable for bridge funding until real matching routes exist.
+Existing mappings distinguish token identity by chain and address, including address casing for EVM. WETH/stETH Sepolia mappings and string/address-word source metadata are supported; mainnet or other-chain WETH is never aliased to them. Exact routes enabled in the Push node registry are also resolved by address: Circle testnet USDC on Sepolia, Base Sepolia and Arbitrum Sepolia maps to its own PRC20, separate from the routed mock USDC. Grant preparation still verifies each PRC20 source on chain. Protocol mock LINK, Moonwell/Venus tokens, Base/Arbitrum WETH, BNB testnet WBNB and the EigenLayer WETH remain unavailable for bridge funding until matching routes exist.
 
 ### Default permission policy
 
@@ -353,3 +353,25 @@ Uniswap uses destination WETH/Circle USDC; Aave uses its faucet LINK. Their gene
 The additional opt-in group `agw-presets-expanded` covers EigenLayer deposits on Sepolia; Uniswap swaps on Base/Arbitrum Sepolia; PancakeSwap plus Venus on BNB testnet; and Aave plus Moonwell on Base Sepolia. Use the same preflight/run commands with `--group agw-presets-expanded`. Each scenario funds a fresh wallet with at most 100 PC and checks any required destination-native PRC20 before transfer. Native-wrap cases use 10^12 raw native-token units. These are deposit/swap/redemption checks, not borrow/repay or every-market coverage.
 
 AGW token resolution uses the destination chain for ordinary token objects: an explicit Base or Arbitrum ETH token must not select Sepolia's PRC20 merely because its symbol/address is identical. An explicit Push PRC20 reference must name the same source chain as the destination; a mismatch fails before signing.
+
+### Creation UI: apps, tokens and preset availability
+
+A rule requires at least one allowed function, even when tokens and limits are selected. A tokens-only rule returns `INVALID_RULE`, with `details.reason = 'ALLOWED_FUNCTION_REQUIRED'` and actionable `userMessage`. App selection can only be hidden if the application explicitly supplies the intended function permissions; the SDK does not invent transfer recipients or permissions.
+
+`assets: []` remains valid for a universal rule with allowed calls. It grants no token transfers from Push; it never means all tokens. Allowed calls may still interact with destination-held assets under their configured constraints. There is no all-token wildcard. List each permitted token and cap explicitly (at most eight assets).
+
+For presets, check `readiness.ready` before enabling Create. Display the per-chain issues and the affected token address. Empty selections explain that transfers from Push are disabled. `BRIDGE_ASSET_UNAVAILABLE` identifies an unverified SDK route, not proof that no deployment exists anywhere. Do not substitute a routed token solely because its symbol matches: the protocol must support that exact address, and swaps need compatible liquidity. A transfer-only helper is not included. An ERC20 transfer can be authorized explicitly with a `transfer(address,uint256)` allowed call pinned to a recipient and a per-transfer maximum; it also applies to that token already held in the wallet's destination account.
+
+### Exact-preset acceptance and gas evidence
+
+The opt-in `agw-presets-acceptance` group exercises all nine shipped testnet category/network combinations. It passes the returned `rules` unchanged to `create`, reads back every asset/cap/function/pin, and performs first-use and subsequent agent operations. Missing routes, protocols or exact PRC20 balances fail before funding; they do not count as passing acceptance. The opt-in `agw-presets-routed` group runs only the cases whose default assets are all routed (DEXES Sepolia and LENDING Arbitrum Sepolia); preflight checks readiness for the selected cases only. The earlier `agw-presets` and `agw-presets-expanded` protocol fixtures use prefunded destination assets and remain separate coverage.
+
+Read-only compatibility checks are available with `node packages/core/scripts/check-agw-preset-compatibility.js /tmp/compatibility.json` after building core. The check verifies known routed source identities (registry and exact node routes), live Aave reserves, Moonwell/Venus underlyings, the reviewed EigenLayer strategy and pools at the preset routers' factories, including each DEX preset's own default pair. A matching symbol alone is insufficient. RPC and read errors are recorded as unknown checks, never as compatibility or as missing routes. No default assets were changed. `node packages/core/scripts/check-agw-route-registry.js /tmp/registry.json` compares the SDK's routes with the Push node's token registry (uregistry): it fails on a mismatched or SDK-only route and lists enabled node routes the SDK does not resolve.
+
+`maxGasPerCall` is an owner-authorized ceiling on the PC attached to each outbound. The send-time `gasLimit` is a different field: the multiplier for the destination gas price. Omitted or zero uses the network base (500,000 on the EVM testnets, 960 on Solana devnet). Agent EVM sends without an explicit gasLimit instead use 2,000,000 on first use (the destination account is deployed), and 1,000,000 when they export a non-native token or make more than one destination call. A Sepolia Circle USDC export with approve and a Uniswap swap ran out of gas at the 500,000 base. An explicit value below the base is refused before quoting with `INVALID_RULE` and `details.minimum`. When omitted on Solana, the SDK raises the limit to cover finalization rent instead of using an EVM-style million-unit fallback. If a gas-price change leaves that budget short even after one re-quote, the send is refused before signing (`INCONSISTENT_READ`).
+
+The attached budget is at least $1 of PC: 10 PC at the fixed $0.10 rate used for Push-native agents, and less or more for agents signing from another chain, which are priced through that origin's Donut stable pool. It is never less than the current Push pool cost of the destination gas plus 20%. BNB testnet gas is valued at that pool rate, because no BNB/USD feed exists (the BSC gateway feed is ETH/USD). The gateway refunds unused PC in the same transaction. After the destination executes, the node also refunds unused destination gas, `(gasLimit − gasUsed) × gasPrice`, to the wallet as PC in a later Push transaction; this was verified on Donut for EVM and Solana. On October 20 the gas swaps actually consumed 0.0008-2.37 PC per send. 0.1 PC can never cover the minimum budget. The 20 PC preset ceiling covered the Sepolia, Base Sepolia, Arbitrum Sepolia and Solana devnet runs; BNB testnet first sends exceed it while Donut's BNB gas price is high. There is no cumulative gas cap; the wallet's PC balance is the only total limit. `node packages/core/scripts/check-agw-gas-quotes.js /tmp/quotes.json` records current quotes for Push-native and Sepolia-origin agents without signing. Quotes change; they are not fixed fees or a validated default for custom rules.
+
+The separate `agw-svm-agent-spl` group verifies the known devnet test harness's `receive_spl` instruction: wallet ATA pins, an amount ceiling, exact recipient credit and first/subsequent sends with omitted gas. It uses the existing counter program and does not certify a third-party Solana protocol. The gas evidence records Push transaction fees, attached quote budgets and destination fees separately. Run both new groups with the normal `__e2e__/ci/preflight.ts --group ...` and `__e2e__/ci/run.ts --group ...` commands.
+
+The `agw-gas` group measures first-use and subsequent native-token agent sends on Sepolia, Base Sepolia, Arbitrum Sepolia and BNB testnet using the existing counter fixtures. Its route/gas coverage is separate from protocol preset acceptance.

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+@pushchain/core@6.0.27-alpha.6 (2026-10-21)
+
+- fix: route exact AGW tokens and size agent gas from the pool
+
+---
+
+@pushchain/core@6.0.27-alpha.5 (2026-10-20)
+
+- fix: clarify agentic creation permissions and route guidance
+
+---
+
 @pushchain/core@6.0.27-alpha.4 (2026-10-20)
 
 - fix: remove preset funding mode and preserve asset limits

package/package.json

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

package/src/lib/agentic/error-messages.js

@@ -43,6 +43,8 @@ function agenticUserMessage(code, diagnostic, details) {
     }
     if (code !== 'INVALID_RULE')
         return MESSAGES[code];
+    if (details?.['reason'] === 'ALLOWED_FUNCTION_REQUIRED')
+        return 'Add at least one allowed function. Selecting tokens and limits alone does not authorize transfers.';
     if (/validUntil|expiry|expired|future.*timestamp/i.test(diagnostic))
         return 'Choose an expiry date in the future.';
     if (/label.*(64|length|most)/i.test(diagnostic))

package/src/lib/agentic/errors.js

@@ -144,7 +144,7 @@ function tokenRouteUnavailable(cause, token, chainNamespace, assetIndex) {
     const message = `This token cannot be sent from Push to ${network}. Choose a token with a supported Push route.`;
     return new AgenticError(exports.AGENTIC_ERROR_CODE.TOKEN_ROUTE_UNAVAILABLE, message, {
         userMessage: message,
-        hint: 'Choose a supported token on this network, or wait for a verified PRC20 route for this exact token address. Token symbols alone do not identify a route.',
+        hint: 'Choose a supported token on this network, or wait for a verified PRC20 route for this exact token address. The selected app must also support that exact token address; matching symbols are not sufficient.',
         details: {
             token,
             chainNamespace,

package/src/lib/agentic/execution/gas-budget.d.ts

@@ -0,0 +1,19 @@
+import type { OrchestratorContext } from '../../orchestrator/internals/context';
+/**
+ * PC gas budget (maxPCForGas) for an AGW outbound, excluding protocolFee.
+ * The gateway buys exactly `gasFee` of the gas token from the Donut WPC pool
+ * and reverts when the budget cannot. The shared USD sizer can attach less:
+ * its over-$10 overflow has no funds leg on this path, and its USD price can
+ * differ from the pool. Keep the larger of the sized budget and the pool cost.
+ */
+export declare function agwGasBudget(quote: {
+    protocolFee: bigint;
+    nativeValueForGas: bigint;
+    sizing?: {
+        category: string;
+        overflowNativePc: bigint;
+    };
+}, poolPcIn?: bigint): bigint;
+/** Refuses an explicit gasLimit below the chain base before quoting, where core
+ * would otherwise revert. Omitted or zero gas uses the base. */
+export declare function assertGasLimitAtLeastBase(ctx: OrchestratorContext, chain: string, gasLimit: bigint): Promise<void>;

package/src/lib/agentic/execution/gas-budget.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agwGasBudget = agwGasBudget;
+exports.assertGasLimitAtLeastBase = assertGasLimitAtLeastBase;
+const prc20_evm_1 = require("../../constants/abi/prc20.evm");
+const prc20_metadata_1 = require("../contracts/prc20-metadata");
+const errors_1 = require("../errors");
+/** Headroom over the pool quote; the gateway refunds whatever the swap leaves. */
+const POOL_HEADROOM_NUM = BigInt(12);
+const POOL_HEADROOM_DEN = BigInt(10);
+/**
+ * PC gas budget (maxPCForGas) for an AGW outbound, excluding protocolFee.
+ * The gateway buys exactly `gasFee` of the gas token from the Donut WPC pool
+ * and reverts when the budget cannot. The shared USD sizer can attach less:
+ * its over-$10 overflow has no funds leg on this path, and its USD price can
+ * differ from the pool. Keep the larger of the sized budget and the pool cost.
+ */
+function agwGasBudget(quote, poolPcIn) {
+    const sized = (quote.nativeValueForGas > quote.protocolFee
+        ? quote.nativeValueForGas - quote.protocolFee
+        : BigInt(0)) +
+        (quote.sizing?.category === 'C'
+            ? quote.sizing.overflowNativePc
+            : BigInt(0));
+    const pool = poolPcIn === undefined
+        ? BigInt(0)
+        : (poolPcIn * POOL_HEADROOM_NUM + POOL_HEADROOM_DEN - BigInt(1)) /
+            POOL_HEADROOM_DEN;
+    return sized > pool ? sized : pool;
+}
+/** Refuses an explicit gasLimit below the chain base before quoting, where core
+ * would otherwise revert. Omitted or zero gas uses the base. */
+async function assertGasLimitAtLeastBase(ctx, chain, gasLimit) {
+    if (gasLimit <= BigInt(0))
+        return;
+    let base;
+    try {
+        base = await ctx.pushClient.readContract({
+            address: prc20_metadata_1.CORE_ADDRESS,
+            abi: prc20_evm_1.UNIVERSAL_CORE_EVM,
+            functionName: 'baseGasLimitByChainNamespace',
+            args: [chain],
+        });
+    }
+    catch {
+        return; // The quote itself reports any real failure.
+    }
+    if (gasLimit < base)
+        throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, `gasLimit ${gasLimit} is below the ${chain} minimum of ${base}; omit it or pass 0 to use the network default`, {
+            userMessage: 'The gas limit is below this network’s minimum. Leave it empty to use the network default.',
+            details: { field: 'gasLimit', minimum: base },
+        });
+}
+//# sourceMappingURL=gas-budget.js.map

package/src/lib/agentic/execution/outbound.js

@@ -14,6 +14,9 @@ const v6_1 = require("../contracts/v6");
 const errors_1 = require("../errors");
 /** Includes first-use CEA deployment; explicit caller gas always takes precedence. */
 const FIRST_USE_EVM_GAS_LIMIT = BigInt(2_000_000);
+/** Token exports and multi-call payloads can exceed the 500k network base: a
+ * Sepolia Circle USDC export with approve + Uniswap swap ran out of gas on it. */
+const MULTI_STEP_EVM_GAS_LIMIT = BigInt(1_000_000);
 /** URP MAX_ACTIONS_PER_REQUEST at v6. */
 exports.MAX_DESTINATION_CALLS = 10;
 const MULTICALL_TUPLE = [
@@ -146,8 +149,15 @@ async function composeOutbound(runtime, gen, wallet, params, opts) {
             });
         }
     }
+    const multiStep = calls.length > 1 ||
+        (amount > BigInt(0) &&
+            (0, viem_1.getAddress)(token) !== (0, viem_1.getAddress)(runtime.resolvePrc20(undefined, chain)));
     const quote = await runtime.quoteOutbound(token, params.gasLimit ??
-        (resolved.isDeployed ? BigInt(0) : FIRST_USE_EVM_GAS_LIMIT), chain);
+        (!resolved.isDeployed
+            ? FIRST_USE_EVM_GAS_LIMIT
+            : multiStep
+                ? MULTI_STEP_EVM_GAS_LIMIT
+                : BigInt(0)), chain);
     if (quote.nativeValueForGas <= BigInt(0)) {
         throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, 'outbound gas quote returned zero; URP rejects an uncapped gas swap');
     }

package/src/lib/agentic/execution/svm-public.js

@@ -50,7 +50,10 @@ async function sendPublicSvm(runtime, actx, p, options) {
     let rulesId, data, instruction, cea;
     let destinationTransfer;
     let transferValue = BigInt(0);
-    const gasLimit = p.gasLimit ?? BigInt(1_000_000);
+    // SVM gateway gasLimit is a lamport-budget conversion input, not EVM gas
+    // units. Let the live route quote and finalize-rent floor size an omitted
+    // limit; copying an EVM-style million-unit fallback can overquote 100 PC.
+    const gasLimit = p.gasLimit ?? BigInt(0);
     if (actx.door === 'agent') {
         const active = await (0, rules_1.selectRuleForSend)(snap, gen, wallet, actx.signerPushAccount, to.chain);
         const stored = await (0, svm_1.readSvmConfig)(snap, gen, wallet, active, runtime.pushChainNamespace);

package/src/lib/agentic/execution/svm-quote.d.ts

@@ -8,4 +8,6 @@ export declare function quoteSvmRequest(runtime: AgenticRuntime, snap: Snapshot,
     protocolFee: bigint;
     nativeValueForGas: bigint;
     gasLimitUsed: bigint;
+    gasFee?: bigint;
+    poolPcIn?: bigint;
 }>;

package/src/lib/agentic/execution/svm-send.d.ts

@@ -29,6 +29,8 @@ export declare function prepareSvmAgentExecution(runtime: AgenticRuntime, gen: A
         protocolFee: bigint;
         nativeValueForGas: bigint;
         gasLimitUsed: bigint;
+        gasFee?: bigint;
+        poolPcIn?: bigint;
     };
     data: `0x${string}`;
 }>;

package/src/lib/agentic/management/svm-public.js

@@ -52,6 +52,9 @@ async function preparePublicSvmRule(runtime, snap, wallet, rule) {
         throw (0, svm_terms_1.svmInvalid)('unknown Solana chain');
     if (!Array.isArray(rule.assets) || rule.assets.length > 8)
         throw (0, svm_terms_1.svmInvalid)('assets must contain at most eight entries');
+    // URP compares the attached PC to this ceiling, so zero refuses every send.
+    if (rule.maxGasPerCall === BigInt(0))
+        throw (0, svm_terms_1.svmInvalid)('maxGasPerCall must be positive');
     const raw = 'format' in rule && rule.format === 'decoded';
     const outputTokens = 'outputTokens' in rule ? rule.outputTokens : undefined;
     if (outputTokens !== undefined && !Array.isArray(outputTokens))

package/src/lib/agentic/presets/index.js

@@ -313,7 +313,7 @@ function buildPresetApi(catalog) {
                 if (!selectedAssets.length)
                     issues.push({
                         code: 'ASSETS_REQUIRED',
-                        message: 'Choose tokens and their limits, then regenerate this preset.',
+                        message: 'No tokens selected: transfers from Push are disabled, not unrestricted. Choose explicit tokens and limits, then regenerate this preset.',
                     });
                 if (chain.swapRouters?.length && selectedAssets.length < 2)
                     issues.push({

package/src/lib/agentic/presets/routes.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.presetRoutes = presetRoutes;
-const viem_1 = require("viem");
 const enums_1 = require("../../constants/enums");
 const helpers_1 = require("../../orchestrator/internals/helpers");
-const prc20_address_1 = require("../../universal/prc20-address");
+const token_routes_1 = require("../token-routes");
 const deployments_1 = require("../deployments");
 const operation_limits_1 = require("./operation-limits");
 /** Offline registry checks only. Grant preparation still verifies source metadata
@@ -29,10 +28,10 @@ function presetRoutes(chain, assets, network) {
         try {
             if (!supported)
                 throw new Error(`No supported gateway route to ${chain}`);
-            const prc20 = (0, prc20_address_1.getPRC20Address)({ chain, address: token }, { network });
+            const prc20 = (0, token_routes_1.resolveAgenticPrc20)({ chain, address: token }, network);
             return {
                 token,
-                prc20: (0, viem_1.getAddress)(prc20.address),
+                prc20: prc20.address,
                 status: 'registered',
             };
         }
@@ -40,7 +39,7 @@ function presetRoutes(chain, assets, network) {
             issues.push({
                 code: 'BRIDGE_ASSET_UNAVAILABLE',
                 token,
-                message: `No SDK PRC20 mapping for ${chain}:${token} on ${network}. Choose a supported asset. This exact token needs a verified Push PRC20 route before it can be used.`,
+                message: `No SDK PRC20 mapping for ${chain}:${token} on ${network}. This preset cannot be created with this token until its Push route is verified. Choose a routed token only if the selected app supports that exact token address.`,
             });
             return { token, status: 'unavailable' };
         }

package/src/lib/agentic/public-rule.js

@@ -117,6 +117,11 @@ async function normalizePublicRule(input, wallet, runtime) {
         r.validUntil <= runtime.nowSeconds() ||
         r.validUntil >= 2 ** 48)
         throw invalid('validUntil must be a future uint48 timestamp');
+    if (r.allowedCalls === undefined ||
+        (Array.isArray(r.allowedCalls) && !r.allowedCalls.length))
+        throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, 'Add at least one allowed function. Selecting tokens and limits alone does not authorize transfers.', {
+            details: { reason: 'ALLOWED_FUNCTION_REQUIRED', field: 'allowedCalls' },
+        });
     if (!Array.isArray(r.allowedCalls) ||
         r.allowedCalls.length < 1 ||
         r.allowedCalls.length > 32)

package/src/lib/agentic/runtime.d.ts

@@ -44,8 +44,12 @@ export interface AgenticRuntime {
         burnAmount: bigint;
     }): Promise<{
         protocolFee: bigint;
+        /** PC gas budget sent as maxPCForGas; protocolFee is attached separately. */
         nativeValueForGas: bigint;
         gasLimitUsed: bigint;
+        /** Diagnostics: gas-token fee and the pool's current PC cost for it. */
+        gasFee?: bigint;
+        poolPcIn?: bigint;
     }>;
     resolveCEA(account: Address, chain: CHAIN): Promise<{
         cea: Address;

package/src/lib/agentic/runtime.js

@@ -12,6 +12,9 @@ const gas_calculator_1 = require("../orchestrator/internals/gas-calculator");
 const helpers_1 = require("../orchestrator/internals/helpers");
 const chain_1 = require("./chain");
 const prc20_address_1 = require("../universal/prc20-address");
+const token_routes_1 = require("./token-routes");
+const gas_budget_1 = require("./execution/gas-budget");
+const gas_pool_quote_1 = require("../orchestrator/internals/gas-pool-quote");
 const reader_1 = require("./contracts/reader");
 const svm_metadata_1 = require("./management/svm-metadata");
 const chain_2 = require("../constants/chain");
@@ -63,23 +66,39 @@ function createAgenticRuntime(orchestrator, isReadOnly) {
         signerBalance: () => ctx.pushClient.getBalance((0, uea_manager_1.computeUEAOffchain)(ctx)),
         getGasPrice: () => ctx.pushClient.getGasPrice(),
         quoteOutbound: async (prc20, gasLimit, chain, svm) => {
+            await (0, gas_budget_1.assertGasLimitAtLeastBase)(ctx, chain, gasLimit);
             let q = await (0, gas_calculator_1.queryOutboundGasFee)(ctx, prc20, gasLimit, chain);
             if (svm) {
-                q = await (0, svm_rent_1.ensureSvmFinalizeGasBudgetQuote)({
+                let minimum = BigInt(0);
+                const finalize = (quote) => (0, svm_rent_1.ensureSvmFinalizeGasBudgetQuote)({
                     ctx,
                     ueaAddress: svm.wallet,
                     targetChain: chain,
                     prc20Token: prc20,
-                    quote: q,
+                    quote,
                     splMintBase58: svm.splMintBase58,
                     burnAmount: svm.burnAmount,
                     pathTag: 'AGW_SVM',
+                    onMinimum: (m) => {
+                        minimum = m;
+                    },
                 });
+                q = await finalize(q);
+                // A gas-price change between quote and re-quote can leave the bump short.
+                if (q.gasFee < minimum)
+                    q = await finalize(q);
+                if (q.gasFee < minimum)
+                    throw new errors_2.AgenticError(errors_2.AGENTIC_ERROR_CODE.INCONSISTENT_READ, `Solana finalize budget ${q.gasFee} is below the required ${minimum} lamports after re-quoting`, {
+                        userMessage: 'Network gas prices changed while preparing this transaction. Try again.',
+                    });
             }
+            const poolPcIn = await (0, gas_pool_quote_1.quoteGasPoolCost)(ctx, q.universalCoreAddress, q.gasToken, q.gasFee);
             return {
                 protocolFee: q.protocolFee,
-                nativeValueForGas: q.nativeValueForGas,
+                nativeValueForGas: (0, gas_budget_1.agwGasBudget)(q, poolPcIn),
                 gasLimitUsed: q.gasLimitUsed,
+                gasFee: q.gasFee,
+                poolPcIn,
             };
         },
         resolveCEA: async (account, chain) => {
@@ -96,7 +115,7 @@ function createAgenticRuntime(orchestrator, isReadOnly) {
                     throw new errors_2.AgenticError(errors_2.AGENTIC_ERROR_CODE.ASSET_CHAIN_MISMATCH, 'Push token source chain must match the destination chain');
                 return (0, viem_1.getAddress)((0, prc20_address_1.getPRC20Address)(token, { network }).address);
             }
-            return (0, viem_1.getAddress)((0, prc20_address_1.getPRC20Address)({ chain, address: typeof token === 'string' ? token : token.address }, { network }).address);
+            return (0, token_routes_1.resolveAgenticPrc20)({ chain, address: typeof token === 'string' ? token : token.address }, network).address;
         },
         nowSeconds: () => Math.floor(Date.now() / 1000),
     };

package/src/lib/agentic/token-routes.d.ts

@@ -0,0 +1,22 @@
+import { type Address } from 'viem';
+import { PUSH_NETWORK } from '../constants/enums';
+export interface AgenticTokenRoute {
+    /** Exact destination-chain token address. */
+    source: Address;
+    /** Push PRC20 the node registry maps that token to. */
+    prc20: Address;
+    symbol: string;
+    decimals: number;
+}
+export declare function exactAgenticRoutes(chain: string, network: PUSH_NETWORK): readonly AgenticTokenRoute[];
+/** Match by chain AND exact address; never by symbol. */
+export declare function exactAgenticRoute(chain: string, source: string, network: PUSH_NETWORK): AgenticTokenRoute | undefined;
+/** AGW source-token resolution: exact node routes first, then the shared registry. */
+export declare function resolveAgenticPrc20(token: {
+    chain: string;
+    address: string;
+}, network: PUSH_NETWORK): {
+    address: Address;
+    symbol: string;
+    decimals: number;
+};

package/src/lib/agentic/token-routes.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exactAgenticRoutes = exactAgenticRoutes;
+exports.exactAgenticRoute = exactAgenticRoute;
+exports.resolveAgenticPrc20 = resolveAgenticPrc20;
+const viem_1 = require("viem");
+const enums_1 = require("../constants/enums");
+const prc20_address_1 = require("../universal/prc20-address");
+/** Exact routes enabled in the node's uregistry that the shared symbol-keyed
+ * registry cannot hold (a second USDC on one chain). Snapshot: Donut uregistry
+ * height 24,457,377; SOURCE_* metadata, decimals and outbound quotes checked at
+ * block 24,457,398. Grant preparation still verifies the source on chain.
+ */
+const DONUT_EXACT_ROUTES = {
+    'eip155:11155111': [
+        {
+            source: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+            prc20: '0x387b9C8Db60E74999aAAC5A2b7825b400F12d68E',
+            symbol: 'USDC',
+            decimals: 6,
+        },
+    ],
+    'eip155:84532': [
+        {
+            source: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+            prc20: '0x84B62e44F667F692F7739Ca6040cD17DA02068A8',
+            symbol: 'USDC',
+            decimals: 6,
+        },
+    ],
+    'eip155:421614': [
+        {
+            source: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
+            prc20: '0xa261A10e94aE4bA88EE8c5845CbE7266bD679DD6',
+            symbol: 'USDC',
+            decimals: 6,
+        },
+    ],
+};
+const EXACT_ROUTES = {
+    [enums_1.PUSH_NETWORK.TESTNET_DONUT]: DONUT_EXACT_ROUTES,
+    [enums_1.PUSH_NETWORK.TESTNET]: DONUT_EXACT_ROUTES,
+};
+function exactAgenticRoutes(chain, network) {
+    return EXACT_ROUTES[network]?.[chain] ?? [];
+}
+/** Match by chain AND exact address; never by symbol. */
+function exactAgenticRoute(chain, source, network) {
+    if (!(0, viem_1.isAddress)(source, { strict: false }))
+        return undefined;
+    const wanted = (0, viem_1.getAddress)(source);
+    return exactAgenticRoutes(chain, network).find((route) => (0, viem_1.getAddress)(route.source) === wanted);
+}
+/** AGW source-token resolution: exact node routes first, then the shared registry. */
+function resolveAgenticPrc20(token, network) {
+    const exact = exactAgenticRoute(token.chain, token.address, network);
+    if (exact)
+        return {
+            address: (0, viem_1.getAddress)(exact.prc20),
+            symbol: exact.symbol,
+            decimals: exact.decimals,
+        };
+    const mapped = (0, prc20_address_1.getPRC20Address)(token, { network });
+    return {
+        address: (0, viem_1.getAddress)(mapped.address),
+        symbol: mapped.symbol,
+        decimals: mapped.decimals,
+    };
+}
+//# sourceMappingURL=token-routes.js.map

package/src/lib/constants/tokens.js

@@ -180,7 +180,7 @@ const TOKEN_META = {
         WETH: {
             symbol: 'WETH',
             decimals: 18,
-            address: '0xfff9976782d46cc05630d1f6ebab18b2324d6b14',
+            address: '0x4200000000000000000000000000000000000006',
             mechanism: 'approve',
         },
     },

package/src/lib/orchestrator/internals/gas-calculator.js

@@ -25,6 +25,7 @@ const utils_1 = require("../../utils");
 const svm_client_1 = require("../../vm-client/svm-client");
 const context_1 = require("./context");
 const helpers_1 = require("./helpers");
+const gas_pool_quote_1 = require("./gas-pool-quote");
 const gas_usd_sizer_1 = require("./gas-usd-sizer");
 /**
  * Legacy fallback buffer used ONLY when the caller does not supply a
@@ -64,36 +65,6 @@ const UNISWAP_V3_FACTORY_ABI = [
         stateMutability: 'view',
     },
 ];
-const UNISWAP_V3_QUOTER_EXACT_OUTPUT_ABI = [
-    {
-        type: 'function',
-        name: 'quoteExactOutputSingle',
-        inputs: [
-            {
-                type: 'tuple',
-                components: [
-                    { name: 'tokenIn', type: 'address' },
-                    { name: 'tokenOut', type: 'address' },
-                    { name: 'amount', type: 'uint256' },
-                    { name: 'fee', type: 'uint24' },
-                    { name: 'sqrtPriceLimitX96', type: 'uint160' },
-                ],
-            },
-        ],
-        outputs: [
-            { name: 'amountIn', type: 'uint256' },
-            { name: 'sqrtPriceX96After', type: 'uint160' },
-            { name: 'initializedTicksCrossed', type: 'uint32' },
-            { name: 'gasEstimate', type: 'uint256' },
-        ],
-        stateMutability: 'view',
-    },
-];
-const UNIVERSAL_CORE_SWAP_HELPERS_ABI = [
-    { type: 'function', name: 'WPC', inputs: [], outputs: [{ name: '', type: 'address', internalType: 'address' }], stateMutability: 'view' },
-    { type: 'function', name: 'uniswapV3Factory', inputs: [], outputs: [{ name: '', type: 'address', internalType: 'address' }], stateMutability: 'view' },
-    { type: 'function', name: 'defaultFeeTier', inputs: [{ name: '', type: 'address', internalType: 'address' }], outputs: [{ name: '', type: 'uint24', internalType: 'uint24' }], stateMutability: 'view' },
-];
 const ZERO_ADDR = '0x0000000000000000000000000000000000000000';
 // ============================================================================
 // ERC-20 Allowance
@@ -211,6 +182,7 @@ async function queryOutboundGasFee(ctx, prc20Token, gasLimit, destinationChain)
                 gasFee,
                 originChain: ctx.universalSigner.account.chain,
                 destinationChain,
+                pool: { universalCore: universalCoreAddress, gasToken },
             });
             // All categories — A, B, and C — return the sizer's calibrated gas leg.
             // R3 consumers additionally bump `nativeValueForGas` by `overflowNativePc`
@@ -259,19 +231,19 @@ async function estimateNativeValueForSwap(ctx, universalCoreAddress, gasToken, g
         const [wpcAddress, factoryAddress, feeTier] = await Promise.all([
             ctx.pushClient.readContract({
                 address: universalCoreAddress,
-                abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                abi: gas_pool_quote_1.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
                 functionName: 'WPC',
                 args: [],
             }),
             ctx.pushClient.readContract({
                 address: universalCoreAddress,
-                abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                abi: gas_pool_quote_1.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
                 functionName: 'uniswapV3Factory',
                 args: [],
             }),
             ctx.pushClient.readContract({
                 address: universalCoreAddress,
-                abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                abi: gas_pool_quote_1.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
                 functionName: 'defaultFeeTier',
                 args: [gasToken],
             }),
@@ -286,7 +258,7 @@ async function estimateNativeValueForSwap(ctx, universalCoreAddress, gasToken, g
             try {
                 const quote = await ctx.pushClient.readContract({
                     address: quoterAddress,
-                    abi: UNISWAP_V3_QUOTER_EXACT_OUTPUT_ABI,
+                    abi: gas_pool_quote_1.UNISWAP_V3_QUOTER_EXACT_OUTPUT_ABI,
                     functionName: 'quoteExactOutputSingle',
                     args: [
                         {
@@ -437,6 +409,7 @@ async function queryRescueGasFee(ctx, prc20Token, destinationChain) {
                 gasFee,
                 originChain: ctx.universalSigner.account.chain,
                 destinationChain,
+                pool: { universalCore: universalCoreAddress, gasToken },
             });
             nativeValueForGas = sizing.gasLegNativePc;
             (0, context_1.printLog)(ctx, `queryRescueGasFee — sizer: category=${sizing.category}, gasUsd=${sizing.gasUsd}, nativeValueForGas=${nativeValueForGas}`);
@@ -575,13 +548,13 @@ async function estimateDepositFromLockedNative(ctx, nativeAmountForLocker, prc20
         const [wpcAddress, feeTier] = await Promise.all([
             ctx.pushClient.readContract({
                 address: universalCoreAddress,
-                abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                abi: gas_pool_quote_1.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
                 functionName: 'WPC',
                 args: [],
             }),
             ctx.pushClient.readContract({
                 address: universalCoreAddress,
-                abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                abi: gas_pool_quote_1.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
                 functionName: 'defaultFeeTier',
                 args: [prc20Token],
             }),
@@ -664,13 +637,13 @@ async function estimateNativeForDesiredDeposit(ctx, desiredWpc, prc20Token) {
         const [wpcAddress, feeTier] = await Promise.all([
             ctx.pushClient.readContract({
                 address: universalCoreAddress,
-                abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                abi: gas_pool_quote_1.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
                 functionName: 'WPC',
                 args: [],
             }),
             ctx.pushClient.readContract({
                 address: universalCoreAddress,
-                abi: UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                abi: gas_pool_quote_1.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
                 functionName: 'defaultFeeTier',
                 args: [prc20Token],
             }),

package/src/lib/orchestrator/internals/gas-pool-quote.d.ts

@@ -0,0 +1,34 @@
+import type { OrchestratorContext } from './context';
+export declare const UNISWAP_V3_QUOTER_EXACT_OUTPUT_ABI: {
+    type: "function";
+    name: string;
+    inputs: {
+        type: string;
+        components: {
+            name: string;
+            type: string;
+        }[];
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+}[];
+export declare const UNIVERSAL_CORE_SWAP_HELPERS_ABI: {
+    type: "function";
+    name: string;
+    inputs: {
+        name: string;
+        type: string;
+        internalType: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+        internalType: string;
+    }[];
+    stateMutability: string;
+}[];
+/** Exact PC (WPC wei) the gas swap needs now; undefined when it cannot be quoted. */
+export declare function quoteGasPoolCost(ctx: OrchestratorContext, universalCore: `0x${string}`, gasToken: `0x${string}`, gasFee: bigint): Promise<bigint | undefined>;

package/src/lib/orchestrator/internals/gas-pool-quote.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNIVERSAL_CORE_SWAP_HELPERS_ABI = exports.UNISWAP_V3_QUOTER_EXACT_OUTPUT_ABI = void 0;
+exports.quoteGasPoolCost = quoteGasPoolCost;
+/**
+ * Live Push-pool cost of an outbound gas fee. The gateway's swapAndBurnGas
+ * buys exactly `gasFee` of the gas token from the WPC pool (exact output), so
+ * this quote is what the swap will actually need at the current pool state.
+ */
+const chain_1 = require("../../constants/chain");
+const context_1 = require("./context");
+const helpers_1 = require("./helpers");
+exports.UNISWAP_V3_QUOTER_EXACT_OUTPUT_ABI = [
+    {
+        type: 'function',
+        name: 'quoteExactOutputSingle',
+        inputs: [
+            {
+                type: 'tuple',
+                components: [
+                    { name: 'tokenIn', type: 'address' },
+                    { name: 'tokenOut', type: 'address' },
+                    { name: 'amount', type: 'uint256' },
+                    { name: 'fee', type: 'uint24' },
+                    { name: 'sqrtPriceLimitX96', type: 'uint160' },
+                ],
+            },
+        ],
+        outputs: [
+            { name: 'amountIn', type: 'uint256' },
+            { name: 'sqrtPriceX96After', type: 'uint160' },
+            { name: 'initializedTicksCrossed', type: 'uint32' },
+            { name: 'gasEstimate', type: 'uint256' },
+        ],
+        stateMutability: 'view',
+    },
+];
+exports.UNIVERSAL_CORE_SWAP_HELPERS_ABI = [
+    {
+        type: 'function',
+        name: 'WPC',
+        inputs: [],
+        outputs: [{ name: '', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'uniswapV3Factory',
+        inputs: [],
+        outputs: [{ name: '', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'defaultFeeTier',
+        inputs: [{ name: '', type: 'address', internalType: 'address' }],
+        outputs: [{ name: '', type: 'uint24', internalType: 'uint24' }],
+        stateMutability: 'view',
+    },
+];
+/** Exact PC (WPC wei) the gas swap needs now; undefined when it cannot be quoted. */
+async function quoteGasPoolCost(ctx, universalCore, gasToken, gasFee) {
+    if (gasFee <= BigInt(0))
+        return undefined;
+    const quoter = chain_1.CHAIN_INFO[(0, helpers_1.getPushChainForNetwork)(ctx.pushNetwork)]?.dex?.uniV3QuoterV2;
+    if (!quoter || quoter.startsWith('0xTBD'))
+        return undefined;
+    try {
+        const [wpc, fee] = await Promise.all([
+            ctx.pushClient.readContract({
+                address: universalCore,
+                abi: exports.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                functionName: 'WPC',
+                args: [],
+            }),
+            ctx.pushClient.readContract({
+                address: universalCore,
+                abi: exports.UNIVERSAL_CORE_SWAP_HELPERS_ABI,
+                functionName: 'defaultFeeTier',
+                args: [gasToken],
+            }),
+        ]);
+        if (!fee)
+            return undefined;
+        const quote = await ctx.pushClient.readContract({
+            address: quoter,
+            abi: exports.UNISWAP_V3_QUOTER_EXACT_OUTPUT_ABI,
+            functionName: 'quoteExactOutputSingle',
+            args: [
+                {
+                    tokenIn: wpc,
+                    tokenOut: gasToken,
+                    amount: gasFee,
+                    fee,
+                    sqrtPriceLimitX96: BigInt(0),
+                },
+            ],
+        });
+        return quote[0];
+    }
+    catch (err) {
+        (0, context_1.printLog)(ctx, `quoteGasPoolCost — unavailable (${err instanceof Error ? err.message : String(err)})`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=gas-pool-quote.js.map

package/src/lib/orchestrator/internals/gas-usd-sizer.d.ts

@@ -11,6 +11,11 @@ export interface GasSizingInput {
      * Used to price gasFee in USD via PriceFetch (Chainlink ETH/USD, Pyth SOL/USD).
      */
     destinationChain: CHAIN;
+    /** UniversalCore and gas token, for pool-valued destinations. */
+    pool?: {
+        universalCore: `0x${string}`;
+        gasToken: `0x${string}`;
+    };
 }
 export interface GasSizingDecision {
     category: GasSizingCategory;

package/src/lib/orchestrator/internals/gas-usd-sizer.js

@@ -22,16 +22,21 @@ const chain_1 = require("../../constants/chain");
 const price_fetch_1 = require("../../price-fetch/price-fetch");
 const context_1 = require("./context");
 const pc_usd_oracle_1 = require("./pc-usd-oracle");
+const gas_pool_quote_1 = require("./gas-pool-quote");
 // ============================================================================
 // Thresholds (USD, 8 decimals)
 // ============================================================================
 const ONE_USD_8D = (0, viem_1.parseUnits)('1', 8); // 100_000_000
 const TEN_USD_8D = (0, viem_1.parseUnits)('10', 8); // 1_000_000_000
+/** EVM destinations whose gas token is not ETH. No USD feed exists for them
+ * (the BSC gateway's feed is ETH/USD), so their gas is valued at the Push pool
+ * rate the gateway's swap actually pays. */
+const POOL_VALUED_GAS_CHAINS = new Set([enums_1.CHAIN.BNB_TESTNET]);
 // ============================================================================
 // Public API
 // ============================================================================
 async function sizeOutboundGas(ctx, input) {
-    const { gasFee, originChain, destinationChain } = input;
+    const { gasFee, originChain, destinationChain, pool } = input;
     // 1) Price gasFee in USD (8 decimals). gasFee is denominated in the
     //    destination native (pETH = ETH value, pSOL = SOL value). The price
     //    feed lives on the *origin* side (origin gateway's Chainlink/Pyth),
@@ -40,20 +45,31 @@ async function sizeOutboundGas(ctx, input) {
     const destVm = chain_1.CHAIN_INFO[destinationChain].vm;
     const priceSourceChain = destVm === enums_1.VM.SVM ? enums_1.CHAIN.SOLANA_DEVNET : enums_1.CHAIN.ETHEREUM_SEPOLIA;
     const destDecimals = destVm === enums_1.VM.SVM ? 9 : 18;
-    let destUsdPrice;
-    try {
-        destUsdPrice = await new price_fetch_1.PriceFetch(ctx.rpcUrls).getPrice(priceSourceChain);
+    const poolPcIn = pool && POOL_VALUED_GAS_CHAINS.has(destinationChain)
+        ? await (0, gas_pool_quote_1.quoteGasPoolCost)(ctx, pool.universalCore, pool.gasToken, gasFee)
+        : undefined;
+    let gasUsd;
+    if (poolPcIn !== undefined) {
+        gasUsd = await (0, pc_usd_oracle_1.pcToUsd)(ctx, poolPcIn, originChain);
+        (0, context_1.printLog)(ctx, `sizeOutboundGas — gasFee=${gasFee.toString()} valued at the Push pool: ` +
+            `pcIn=${poolPcIn.toString()}, gasUsd=${gasUsd.toString()} (1e8)`);
     }
-    catch (err) {
-        (0, context_1.printLog)(ctx, `sizeOutboundGas — PriceFetch.getPrice failed (${err instanceof Error ? err.message : String(err)}); treating as Case B passthrough`);
-        // Degrade gracefully: assume the raw gasFee is already a sane size and
-        // convert 1:1 to native PC. Callers keep their existing fallback logic.
-        return passthroughAsCaseB(ctx, gasFee, originChain);
+    else {
+        let destUsdPrice;
+        try {
+            destUsdPrice = await new price_fetch_1.PriceFetch(ctx.rpcUrls).getPrice(priceSourceChain);
+        }
+        catch (err) {
+            (0, context_1.printLog)(ctx, `sizeOutboundGas — PriceFetch.getPrice failed (${err instanceof Error ? err.message : String(err)}); treating as Case B passthrough`);
+            // Degrade gracefully: assume the raw gasFee is already a sane size and
+            // convert 1:1 to native PC. Callers keep their existing fallback logic.
+            return passthroughAsCaseB(ctx, gasFee, originChain);
+        }
+        const oneDestNativeUnit = (0, viem_1.parseUnits)('1', destDecimals);
+        gasUsd = (gasFee * destUsdPrice) / oneDestNativeUnit;
+        (0, context_1.printLog)(ctx, `sizeOutboundGas — gasFee=${gasFee.toString()} ${destVm === enums_1.VM.SVM ? 'pSOL' : 'gas token'} (${destDecimals}d), ` +
+            `destUsdPrice=${destUsdPrice.toString()} (1e8), gasUsd=${gasUsd.toString()} (1e8)`);
     }
-    const oneDestNativeUnit = (0, viem_1.parseUnits)('1', destDecimals);
-    const gasUsd = (gasFee * destUsdPrice) / oneDestNativeUnit;
-    (0, context_1.printLog)(ctx, `sizeOutboundGas — gasFee=${gasFee.toString()} ${destVm === enums_1.VM.SVM ? 'pSOL' : 'pETH'} (${destDecimals}d), ` +
-        `destUsdPrice=${destUsdPrice.toString()} (1e8), gasUsd=${gasUsd.toString()} (1e8)`);
     // 2) Categorize and compute target USD for each leg.
     let category;
     let gasLegUsd;

package/src/lib/orchestrator/internals/svm-rent.d.ts

@@ -61,7 +61,7 @@ export interface SvmFinalizeGasBudgetInput {
 }
 export declare function gasLimitForSvmGasFeeBudget(gasFeeBudget: bigint, gasPrice: bigint): bigint;
 type OutboundGasQuote = Awaited<ReturnType<typeof queryOutboundGasFee>>;
-export declare function ensureSvmFinalizeGasBudgetQuote({ ctx, ueaAddress, targetChain, prc20Token, quote, splMintBase58, burnAmount, pathTag, pc20, requoteFn, }: {
+export declare function ensureSvmFinalizeGasBudgetQuote({ ctx, ueaAddress, targetChain, prc20Token, quote, splMintBase58, burnAmount, pathTag, pc20, requoteFn, onMinimum, }: {
     ctx: OrchestratorContext;
     ueaAddress: `0x${string}`;
     targetChain: ChainType;
@@ -80,6 +80,8 @@ export declare function ensureSvmFinalizeGasBudgetQuote({ ctx, ueaAddress, targe
      * PC20 token, which has no PRC20 config.
      */
     requoteFn?: (gasLimit: bigint) => Promise<OutboundGasQuote>;
+    /** Receives the finalize minimum, so strict callers can refuse a short quote. */
+    onMinimum?: (minGasFee: bigint) => void;
 }): Promise<OutboundGasQuote>;
 /**
  * Returns the minimum SVM `gas_fee` budget in lamports for the gateway

package/src/lib/orchestrator/internals/svm-rent.js

@@ -108,7 +108,7 @@ function resolveSvmGasLimitUsed(quote) {
         gasLimitUsed: gasLimitForSvmGasFeeBudget(quote.gasFee, quote.gasPrice),
     };
 }
-async function ensureSvmFinalizeGasBudgetQuote({ ctx, ueaAddress, targetChain, prc20Token, quote, splMintBase58, burnAmount, pathTag, pc20, requoteFn, }) {
+async function ensureSvmFinalizeGasBudgetQuote({ ctx, ueaAddress, targetChain, prc20Token, quote, splMintBase58, burnAmount, pathTag, pc20, requoteFn, onMinimum, }) {
     const minGasFee = await getSvmFinalizeGasBudget({
         ctx,
         ueaAddress,
@@ -117,6 +117,7 @@ async function ensureSvmFinalizeGasBudgetQuote({ ctx, ueaAddress, targetChain, p
         burnAmount,
         pc20,
     });
+    onMinimum?.(minGasFee);
     if (quote.gasFee >= minGasFee) {
         const resolvedQuote = resolveSvmGasLimitUsed(quote);
         (0, context_1.printLog)(ctx, `${pathTag} — SVM finalize gas budget ok: gasFee=${resolvedQuote.gasFee.toString()}, ` +