@rhinestone/service-sdk 0.2.13 → 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;AAyUD;;;;;;;;;;;;;;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

@@ -311,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] };
@@ -335,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,
@@ -375,6 +381,7 @@ async function estimateViemFeesWithTipFloor(client, chainId, tipFloorWei) {
     return {
         maxFeePerGas: cappedMaxFeePerGas(client, fees, history.baseFee, chainId, tip, oracleTip),
         maxPriorityFeePerGas: tip,
+        baseFeePerGas: history.baseFee,
     };
 }
 /**
@@ -557,10 +564,15 @@ async function estimateFeeHistoryGasFees(client, chainId, config) {
         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.13",
+  "version": "0.2.14",
   "description": "Shared SDK for Rhinestone services",
   "author": {
     "name": "Rhinestone",