@rhinestone/service-sdk 0.2.3 → 0.2.5

package/dist/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAG1D,KAAK,mBAAmB,GAAG,IAAI,CAC7B,YAAY,EACZ,oBAAoB,GAAG,eAAe,CACvC,CAAA;AAKD,wBAAsB,eAAe,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAK3B"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAG1D,KAAK,mBAAmB,GAAG,IAAI,CAC7B,YAAY,EACZ,oBAAoB,GAAG,eAAe,CACvC,CAAA;AA+CD,wBAAsB,eAAe,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}

package/dist/chains.js

@@ -2,22 +2,52 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.estimateGasFees = estimateGasFees;
 const chains_1 = require("viem/chains");
-const SEPOLIA_FEE_HISTORY_BLOCKS = 3;
-const SEPOLIA_REWARD_PERCENTILE = 75;
+// Chains that price fees from eth_feeHistory instead of viem's default
+// estimator (which sources the tip from the unspecified eth_maxPriorityFeePerGas
+// oracle). L2s are intentionally absent — their sequencers include ~zero-tip
+// txs, so the default is fine and a floor would just overpay.
+const HISTORICAL_FEE_CHAINS = new Set([chains_1.sepolia.id, chains_1.mainnet.id]);
+const DEFAULT_FEE_CONFIG = {
+    historyBlocks: 1,
+    baseFeeMultiplier: 2n,
+    // p50, not p75. The mainnet stalls we saw were caused by a *zero* tip, not by
+    // tipping below p75 — once the tip is non-zero a fill is reliably included, so
+    // a higher percentile buys no extra speed, only cost.
+    //
+    // Example — bundle 4225…447075 (2026-06-04): the fill broadcast with tip 0 and
+    // sat ~3 min. It was mineable (maxFee >= baseFee) for ~12 of its 16 stuck
+    // blocks yet still skipped, because a zero-tip tx earns the builder nothing
+    // (base fee is burned). The market was tipping p50 ~0.07-0.98 gwei the whole
+    // time — any non-zero tip would have gotten it in.
+    //
+    // At ~$1,800/ETH and ~383k gas/fill the tip runs ~$0.14 at p50 vs ~$0.68 at
+    // p75 (~5x), on *every* mainnet fill — not just the rare stuck one.
+    rewardPercentile: 50,
+    tipFloorWei: 100000000n, // 0.1 gwei (~$0.07/fill); see rewardPercentile
+};
+// Per-chain overrides; any omitted field falls back to DEFAULT_FEE_CONFIG.
+const FEE_CONFIG_OVERRIDES = {
+    // Testnet — leave as-is: aggressive percentile, no floor (not real money).
+    [chains_1.sepolia.id]: { rewardPercentile: 75, tipFloorWei: 0n },
+};
 async function estimateGasFees(client, chainId) {
-    if (chainId === chains_1.sepolia.id) {
-        return estimateSepoliaGasFees(client);
+    if (!HISTORICAL_FEE_CHAINS.has(chainId)) {
+        return client.estimateFeesPerGas();
     }
-    return client.estimateFeesPerGas();
+    const config = { ...DEFAULT_FEE_CONFIG, ...FEE_CONFIG_OVERRIDES[chainId] };
+    return estimateFeeHistoryGasFees(client, config);
 }
-async function estimateSepoliaGasFees(client) {
+// Priority fee = the latest block's reward at `rewardPercentile`, floored at
+// `tipFloorWei`; maxFeePerGas = baseFee * baseFeeMultiplier + priorityFee.
+async function estimateFeeHistoryGasFees(client, config) {
     const feeHistory = await client.getFeeHistory({
-        blockCount: SEPOLIA_FEE_HISTORY_BLOCKS,
-        rewardPercentiles: [SEPOLIA_REWARD_PERCENTILE],
+        blockCount: config.historyBlocks,
+        rewardPercentiles: [config.rewardPercentile],
     });
-    const priorityFee = feeHistory.reward?.at(-1)?.[0] ?? 0n;
+    const reward = feeHistory.reward?.at(-1)?.[0] ?? 0n;
+    const priorityFee = reward > config.tipFloorWei ? reward : config.tipFloorWei;
     const baseFee = feeHistory.baseFeePerGas.at(-1) ?? 0n;
-    const maxFeePerGas = baseFee * 2n + priorityFee;
+    const maxFeePerGas = baseFee * config.baseFeeMultiplier + priorityFee;
     return {
         maxFeePerGas,
         maxPriorityFeePerGas: priorityFee,

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export {};
+export * from './serialization';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./serialization"), exports);

package/dist/serialization.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULT_BIGINT_CONVERSION_MAX_DEPTH = 100;
+export interface ConvertBigIntFieldsOptions {
+    /** Maximum object/array nesting depth before conversion throws. */
+    maxDepth?: number;
+    /** Convert finite numbers to strings too. Defaults to false. */
+    convertFiniteNumbers?: boolean;
+}
+/** JSON.stringify replacer that converts bigint values to strings. */
+export declare const bigintReplacer: (_: string, value: unknown) => unknown;
+/**
+ * Recursively converts bigint values to decimal strings.
+ *
+ * Intended for JSON-like plain objects/arrays. Pass `convertFiniteNumbers: true`
+ * for canonical-signing payloads that need number-like fields encoded as strings.
+ *
+ * Throws on circular references or excessive nesting instead of silently
+ * producing lossy placeholder values.
+ */
+export declare function convertBigIntFields(value: unknown, options?: ConvertBigIntFieldsOptions): unknown;
+/**
+ * JSON.stringify with guarded bigint conversion.
+ *
+ * Preserves JSON.stringify semantics for `toJSON` (for example, Date -> ISO
+ * string) while adding bigint conversion plus circular/depth guards.
+ */
+export declare function stringifyBigIntFields(value: unknown, options?: ConvertBigIntFieldsOptions & {
+    space?: string | number;
+}): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mCAAmC,MAAM,CAAA;AAEtD,MAAM,WAAW,0BAA0B;IACzC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,OAAO,OAAO,YACF,CAAA;AAEtD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAWT;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,0BAA0B,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAO,GACrE,MAAM,CAMR"}

package/dist/serialization.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bigintReplacer = exports.DEFAULT_BIGINT_CONVERSION_MAX_DEPTH = void 0;
+exports.convertBigIntFields = convertBigIntFields;
+exports.stringifyBigIntFields = stringifyBigIntFields;
+exports.DEFAULT_BIGINT_CONVERSION_MAX_DEPTH = 100;
+/** JSON.stringify replacer that converts bigint values to strings. */
+const bigintReplacer = (_, value) => typeof value === 'bigint' ? value.toString() : value;
+exports.bigintReplacer = bigintReplacer;
+/**
+ * Recursively converts bigint values to decimal strings.
+ *
+ * Intended for JSON-like plain objects/arrays. Pass `convertFiniteNumbers: true`
+ * for canonical-signing payloads that need number-like fields encoded as strings.
+ *
+ * Throws on circular references or excessive nesting instead of silently
+ * producing lossy placeholder values.
+ */
+function convertBigIntFields(value, options = {}) {
+    const maxDepth = normalizeMaxDepth(options.maxDepth);
+    const convertFiniteNumbers = options.convertFiniteNumbers ?? false;
+    return convertBigIntFieldsInner(value, new WeakSet(), 0, maxDepth, convertFiniteNumbers);
+}
+/**
+ * JSON.stringify with guarded bigint conversion.
+ *
+ * Preserves JSON.stringify semantics for `toJSON` (for example, Date -> ISO
+ * string) while adding bigint conversion plus circular/depth guards.
+ */
+function stringifyBigIntFields(value, options = {}) {
+    return JSON.stringify(value, createGuardedBigIntReplacer(options), options.space);
+}
+function createGuardedBigIntReplacer(options) {
+    const maxDepth = normalizeMaxDepth(options.maxDepth);
+    const convertFiniteNumbers = options.convertFiniteNumbers ?? false;
+    const ancestors = [];
+    return function guardedBigIntReplacer(_key, value) {
+        if (typeof value === 'bigint') {
+            return value.toString();
+        }
+        if (typeof value === 'number') {
+            return convertFiniteNumbers && Number.isFinite(value)
+                ? value.toString()
+                : value;
+        }
+        if (value === null || typeof value !== 'object') {
+            return value;
+        }
+        while (ancestors.length > 0 && ancestors[ancestors.length - 1] !== this) {
+            ancestors.pop();
+        }
+        if (ancestors.includes(value)) {
+            throw new Error('convertBigIntFields: circular reference detected');
+        }
+        if (ancestors.length >= maxDepth) {
+            throw new Error(`convertBigIntFields: max depth exceeded (${maxDepth})`);
+        }
+        ancestors.push(value);
+        return value;
+    };
+}
+function convertBigIntFieldsInner(value, seen, depth, maxDepth, convertFiniteNumbers) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (typeof value === 'number') {
+        return convertFiniteNumbers && Number.isFinite(value)
+            ? value.toString()
+            : value;
+    }
+    if (typeof value !== 'object') {
+        return value;
+    }
+    if (seen.has(value)) {
+        throw new Error('convertBigIntFields: circular reference detected');
+    }
+    if (depth >= maxDepth) {
+        throw new Error(`convertBigIntFields: max depth exceeded (${maxDepth})`);
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((item) => convertBigIntFieldsInner(item, seen, depth + 1, maxDepth, convertFiniteNumbers));
+        }
+        const result = {};
+        for (const key in value) {
+            if (Object.hasOwn(value, key)) {
+                result[key] = convertBigIntFieldsInner(value[key], seen, depth + 1, maxDepth, convertFiniteNumbers);
+            }
+        }
+        return result;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function normalizeMaxDepth(maxDepth) {
+    const resolved = maxDepth ?? exports.DEFAULT_BIGINT_CONVERSION_MAX_DEPTH;
+    if (!Number.isInteger(resolved) || resolved < 0) {
+        throw new TypeError('convertBigIntFields: maxDepth must be a non-negative integer');
+    }
+    return resolved;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhinestone/service-sdk",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Shared SDK for Rhinestone services",
   "author": {
     "name": "Rhinestone",
@@ -14,7 +14,8 @@
   "exports": {
     ".": "./dist/index.js",
     "./chains": "./dist/chains.js",
-    "./opentelemetry": "./dist/opentelemetry/index.js"
+    "./opentelemetry": "./dist/opentelemetry/index.js",
+    "./serialization": "./dist/serialization.js"
   },
   "typesVersions": {
     "*": {
@@ -23,6 +24,9 @@
       ],
       "opentelemetry": [
         "dist/opentelemetry/index.d.ts"
+      ],
+      "serialization": [
+        "dist/serialization.d.ts"
       ]
     }
   },