@rhinestone/service-sdk 0.2.12 → 0.2.14

package/dist/chains.d.ts

@@ -13,6 +13,27 @@ export type EstimateGasFeesOptions = {
      */
     mode?: 'legacy';
 };
+/**
+ * {@link estimateGasFees}' result: viem's EIP-1559 fee values plus the next
+ * block's base fee, when it could be read.
+ *
+ * `baseFeePerGas` is surfaced because `maxFeePerGas` is a submission CAP
+ * (`base * baseFeeMultiplierPct + tip`) — the price we are willing to bid up to,
+ * not the price a transaction pays (`base + tip`). Billing the cap is correct
+ * where a relayer must stay covered if the base fee climbs before inclusion; it
+ * is wrong to REPORT to a consumer that compares it against other relayers.
+ * Exposing the base fee lets a caller derive the expected price WITHOUT a second
+ * eth_feeHistory round trip — every path here already reads it and used to
+ * discard it (RHI-4992).
+ *
+ * `null` when the base fee was unavailable: a non-1559 chain, `mode: 'legacy'`,
+ * or a degraded read (already recorded via `recordDegradedEstimate`). Callers
+ * must treat null as "unknown" and fall back — never as zero, which would price
+ * a cap at the tip alone.
+ */
+export type EstimatedGasFees = FeeValuesEIP1559 & {
+    baseFeePerGas: bigint | null;
+};
 /**
  * Estimates gas fees for a chain and returns EIP-1559-shaped fee values.
  *
@@ -28,5 +49,5 @@ export type EstimateGasFeesOptions = {
  * zero. This changes fee estimation only; it does not select a transaction
  * type.
  */
-export declare function estimateGasFees(client: FeeEstimationClient, chainId: number, options?: EstimateGasFeesOptions): Promise<FeeValuesEIP1559>;
+export declare function estimateGasFees(client: FeeEstimationClient, chainId: number, options?: EstimateGasFeesOptions): Promise<EstimatedGasFees>;
 //# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,YAAY,EAAE,MAAM,MAAM,CAAA;AAmB3E,oDAAoD;AAMpD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,YAAY,EACZ,oBAAoB,GAAG,eAAe,CACvC,GACC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AAEtC,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB,CAAA;AAyTD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CA2C3B"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,YAAY,EAAE,MAAM,MAAM,CAAA;AAmB3E,oDAAoD;AAMpD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,YAAY,EACZ,oBAAoB,GAAG,eAAe,CACvC,GACC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AAEtC,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG;IAChD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B,CAAA;AAyUD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAiD3B"}

package/dist/chains.js

@@ -77,20 +77,36 @@ const FEE_CONFIG_OVERRIDES = {
     // gradient — probed live 2026-07-24 over 40 blocks:
     //   p1..p10 = 0        p15..p50 = 0.005 gwei
     // so every percentile from 15 up reports the same 0.005, while real fills
-    // clear at ~0.0015 (third-party solvers are included on-chain at that price,
-    // so it demonstrably clears). Sampling anywhere above p10 therefore prices at
-    // 0.005 and the floor never binds — the tip must be read at p10, where the
-    // window median is genuinely 0, so the measured floor below sets the price.
+    // clear near 0.0014 (third-party solvers are included on-chain at that price
+    // ~10.7k times a day, so it demonstrably clears). Sampling anywhere above p10
+    // therefore prices at 0.005 and the floor never binds — the tip must be read
+    // at p10, where the window median is genuinely 0, so the floor below sets the
+    // price.
     [chains_1.plasma.id]: {
         // Explicit, not inherited. Plasma's base fee is ~0 almost always, so this
         // multiplier is free — but "almost" matters: a 7d block replay puts 0.4% of
         // quotes under the base fee one block later at 1.05x, and 1.5% ten blocks
-        // later, against 0% at 2.0x. On 69k fills/wk that is real. Inheriting the
-        // shared default would silently re-introduce it.
+        // later, against 0% at 2.0x. On ~15k bundles/day priced through this chain
+        // that is real. Inheriting the shared default would silently re-introduce it.
         baseFeeMultiplierPct: 200n,
         tipPercentile: 10,
         congestedTipPercentile: 25,
-        tipFloorWei: 1700000n, // 0.0017 gwei — measured clearing price (2026-07-24)
+        // 0.0014 gwei — where fills on this chain ACTUALLY clear, re-measured from
+        // prod on 2026-07-27 once the previous 0.0017 had deployed and could be
+        // checked against reality (it billed 1.25x the clearing price).
+        //
+        // Measured from the solver that fills ~10.7k plasma bundles/day: it is
+        // included at 0.00103 (7d median 0.001364). Inclusion at ~0.001 is therefore
+        // demonstrated tens of thousands of times a day. NOTE the on-chain reward
+        // percentiles disagree and must not be used here — being gas-weighted they
+        // read p25..p90 = 0.005, which is what a minority of gas-heavy transactions
+        // pay, not the bar for inclusion.
+        //
+        // Lowering it cannot hurt includability: plasma's base is ~0, so the cap is
+        // `base * 2.0 + floor` and the floor never gates it — the 7d replay reports
+        // a 0.00% unincludable rate for every floor from 0.0017 down to 0.0008, at
+        // every lag from 1 to 50 blocks. The floor only sets what we CHARGE.
+        tipFloorWei: 1400000n,
     },
 };
 // Chains where viem's default base-fee estimate is fine but its tip oracle
@@ -295,7 +311,12 @@ async function estimateGasFees(client, chainId, options) {
         // Equal caps preserve gasPrice as the effective-price ceiling. If a
         // no-priority local fork reports baseFee == gasPrice, the max-fee cap means
         // the actual paid tip remains zero despite this priority-fee allowance.
-        return { maxFeePerGas: gasPrice, maxPriorityFeePerGas: gasPrice };
+        // Legacy has no base-fee component to report.
+        return {
+            maxFeePerGas: gasPrice,
+            maxPriorityFeePerGas: gasPrice,
+            baseFeePerGas: null,
+        };
     }
     if (HISTORICAL_FEE_CHAINS.has(chainId)) {
         const config = { ...DEFAULT_FEE_CONFIG, ...FEE_CONFIG_OVERRIDES[chainId] };
@@ -319,6 +340,7 @@ async function estimateGasFees(client, chainId, options) {
     return {
         maxFeePerGas: cappedMaxFeePerGas(client, fees, baseFee, chainId, tip, oracleTip),
         maxPriorityFeePerGas: tip,
+        baseFeePerGas: baseFee,
     };
 }
 // viem's oracle tip, lifted to an absolute floor — and, for windowed-tip chains,
@@ -359,6 +381,7 @@ async function estimateViemFeesWithTipFloor(client, chainId, tipFloorWei) {
     return {
         maxFeePerGas: cappedMaxFeePerGas(client, fees, history.baseFee, chainId, tip, oracleTip),
         maxPriorityFeePerGas: tip,
+        baseFeePerGas: history.baseFee,
     };
 }
 /**
@@ -533,17 +556,23 @@ async function estimateFeeHistoryGasFees(client, chainId, config) {
         //
         // Keeping `priorityFee` is the point. These chains are on the windowed path
         // precisely because their tip oracle is untrustworthy (Plasma's reports
-        // 0.005 gwei against a measured 0.0015), so falling back to viem wholesale
-        // would trade a hard failure for a silent ~3x overcharge on our
-        // highest-volume chain. The tip we already computed is the calibrated one.
+        // 0.005 gwei against a measured 0.0014), so falling back to viem wholesale
+        // would trade a hard failure for a silent ~3.5x overcharge on the chain
+        // carrying the most fills through our pricing. The tip we already computed
+        // is the calibrated one.
         recordDegradedEstimate(chainId, 'feehistory_missing_base');
         return {
             maxFeePerGas: await viemFallbackCap(client, config, priorityFee),
             maxPriorityFeePerGas: priorityFee,
+            baseFeePerGas: null,
         };
     }
     const maxFeePerGas = (baseFee * config.baseFeeMultiplierPct) / 100n + priorityFee;
-    return { maxFeePerGas, maxPriorityFeePerGas: priorityFee };
+    return {
+        maxFeePerGas,
+        maxPriorityFeePerGas: priorityFee,
+        baseFeePerGas: baseFee,
+    };
 }
 // Nearest-rank percentile over a bigint sample. Empty sample → 0n.
 function percentileBigInt(values, percentile) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhinestone/service-sdk",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "Shared SDK for Rhinestone services",
   "author": {
     "name": "Rhinestone",