@gvnrdao/dh-sdk 0.0.333 → 0.0.334

package/dist/index.js

@@ -4264,11 +4264,11 @@ ${auth.clientId}`;
         );
         const prices = await Promise.race([fetchAll, timeoutPromise]);
         const sorted = [...prices].sort((a, b) => a - b);
-        let median;
+        let median2;
         if (this.devSingleProvider) {
-          median = sorted[0];
+          median2 = sorted[0];
         } else {
-          median = sorted[1];
+          median2 = sorted[1];
           const spread = (sorted[2] - sorted[0]) / sorted[0];
           if (spread > PRICE_ORACLE_TOLERANCE) {
             const names = this.sources.map((s) => s.name).join(", ");
@@ -4278,10 +4278,10 @@ ${auth.clientId}`;
             );
           }
         }
-        const priceCents = Math.round(median * 100);
+        const priceCents = Math.round(median2 * 100);
         const priceWith8Decimals = BigInt(priceCents) * 1000000n;
         const totalElapsed = Date.now() - startTime;
-        console.log(`[Price Oracle] Median price: $${median.toLocaleString()} \u2014 total time: ${totalElapsed}ms`);
+        console.log(`[Price Oracle] Median price: $${median2.toLocaleString()} \u2014 total time: ${totalElapsed}ms`);
         console.log(`[Price Oracle] Price with 8 decimals: ${priceWith8Decimals}`);
         return priceWith8Decimals;
       }
@@ -6233,26 +6233,83 @@ var MAKE_PAYMENT_GAS_CEILING = BigInt(1e6);
 var EXTEND_POSITION_GAS_CEILING = BigInt(1e6);
 var LIQUIDATION_COMMIT_GAS_CEILING = BigInt(1e6);
 var LIQUIDATION_REVEAL_GAS_CEILING = BigInt(2e6);
-async function resolveEip1559FeeFields(provider) {
-  const feeData = await provider.getFeeData();
-  let maxFeePerGas = feeData.maxFeePerGas ?? void 0;
-  let maxPriorityFeePerGas = feeData.maxPriorityFeePerGas ?? void 0;
-  if (!maxFeePerGas || !maxPriorityFeePerGas) {
-    const gasPrice = (await provider.getFeeData()).gasPrice ?? (0, import_ethers.parseUnits)("1", "gwei");
-    maxFeePerGas = maxFeePerGas || gasPrice * 2n;
-    maxPriorityFeePerGas = maxPriorityFeePerGas || (0, import_ethers.parseUnits)("1.5", "gwei");
-  }
-  if (maxFeePerGas < maxPriorityFeePerGas) {
-    maxFeePerGas = maxPriorityFeePerGas;
+var PRIORITY_FEE_FLOOR_WEI = (0, import_ethers.parseUnits)("0.1", "gwei");
+var PRIORITY_FEE_CAP_WEI = (0, import_ethers.parseUnits)("3", "gwei");
+var FEE_HISTORY_BLOCK_COUNT = 20;
+var FEE_HISTORY_REWARD_PERCENTILE = 75;
+function isJsonRpcSendable(provider) {
+  return typeof provider.send === "function";
+}
+function parseFeeHistory(raw) {
+  if (typeof raw !== "object" || raw === null) {
+    throw new Error(`eth_feeHistory returned a non-object result: ${JSON.stringify(raw)}`);
+  }
+  const { baseFeePerGas, reward } = raw;
+  if (!Array.isArray(baseFeePerGas) || baseFeePerGas.length === 0) {
+    throw new Error(
+      `eth_feeHistory returned no baseFeePerGas \u2014 the RPC does not support EIP-1559 fee history: ${JSON.stringify(raw)}`
+    );
+  }
+  if (!Array.isArray(reward) || reward.length === 0) {
+    throw new Error(
+      `eth_feeHistory returned no reward percentiles \u2014 the RPC ignored the rewardPercentiles argument: ${JSON.stringify(raw)}`
+    );
+  }
+  const nextBaseFee = (0, import_ethers.getBigInt)(baseFeePerGas[baseFeePerGas.length - 1], "baseFeePerGas");
+  const tips = reward.map((perBlock, i) => {
+    if (!Array.isArray(perBlock) || perBlock.length === 0) {
+      throw new Error(`eth_feeHistory reward row ${i} is empty: ${JSON.stringify(raw)}`);
+    }
+    return (0, import_ethers.getBigInt)(perBlock[0], `reward[${i}]`);
+  });
+  return { nextBaseFee, tips };
+}
+function median(values) {
+  const sorted = [...values].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+  const mid = sorted.length >> 1;
+  const hi = sorted[mid];
+  if (hi === void 0) {
+    throw new Error("median: no values");
+  }
+  if (sorted.length % 2 === 1)
+    return hi;
+  const lo = sorted[mid - 1];
+  if (lo === void 0) {
+    throw new Error("median: no values");
+  }
+  return (lo + hi) / 2n;
+}
+function clamp(value, floor, cap) {
+  if (value < floor)
+    return floor;
+  if (value > cap)
+    return cap;
+  return value;
+}
+async function resolveEip1559FeeFields(feeProvider) {
+  if (!isJsonRpcSendable(feeProvider)) {
+    throw new Error(
+      "resolveEip1559FeeFields: feeProvider must be a JSON-RPC provider exposing send() (the SDK read provider), not a wallet BrowserProvider \u2014 eth_feeHistory is required"
+    );
   }
+  const history = parseFeeHistory(
+    await feeProvider.send("eth_feeHistory", [
+      (0, import_ethers.toQuantity)(FEE_HISTORY_BLOCK_COUNT),
+      "latest",
+      [FEE_HISTORY_REWARD_PERCENTILE]
+    ])
+  );
+  const marketTip = median(history.tips);
+  const maxPriorityFeePerGas = clamp(marketTip, PRIORITY_FEE_FLOOR_WEI, PRIORITY_FEE_CAP_WEI);
+  const maxFeePerGas = history.nextBaseFee * 2n + maxPriorityFeePerGas;
   return { maxFeePerGas, maxPriorityFeePerGas };
 }
 async function sendEip1559Transaction(params) {
-  const { signer, to, data, gasLimit } = params;
+  const { signer, feeProvider, to, data, gasLimit } = params;
   if (!signer.provider) {
     throw new Error("Signer must have a provider attached");
   }
-  const fees = await resolveEip1559FeeFields(signer.provider);
+  const fees = await resolveEip1559FeeFields(feeProvider);
   return signer.sendTransaction({
     to,
     data,
@@ -21209,6 +21266,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
       }
       const tx = await sendEip1559Transaction({
         signer,
+        feeProvider: this.getProviderOrThrow(),
         to: positionManagerAddress,
         data: mintCalldata,
         gasLimit: MINT_UCD_GAS_CEILING
@@ -22430,6 +22488,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
     }
     const tx = await sendEip1559Transaction({
       signer: extendSigner,
+      feeProvider: this.getProviderOrThrow(),
       to: extendTo,
       data: extendCalldata,
       gasLimit: EXTEND_POSITION_GAS_CEILING
@@ -23358,6 +23417,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
       }
       const tx = await sendEip1559Transaction({
         signer: paymentSigner,
+        feeProvider: this.getProviderOrThrow(),
         to: paymentContractAddress,
         data: paymentCalldata,
         gasLimit: MAKE_PAYMENT_GAS_CEILING
@@ -24123,6 +24183,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
         });
         tx = await sendEip1559Transaction({
           signer: withdrawSigner,
+          feeProvider: this.getProviderOrThrow(),
           to: positionManagerAddress,
           data: withdrawCalldata,
           gasLimit: WITHDRAW_BTC_GAS_CEILING

package/dist/index.mjs

@@ -4270,11 +4270,11 @@ ${auth.clientId}`;
         );
         const prices = await Promise.race([fetchAll, timeoutPromise]);
         const sorted = [...prices].sort((a, b) => a - b);
-        let median;
+        let median2;
         if (this.devSingleProvider) {
-          median = sorted[0];
+          median2 = sorted[0];
         } else {
-          median = sorted[1];
+          median2 = sorted[1];
           const spread = (sorted[2] - sorted[0]) / sorted[0];
           if (spread > PRICE_ORACLE_TOLERANCE) {
             const names = this.sources.map((s) => s.name).join(", ");
@@ -4284,10 +4284,10 @@ ${auth.clientId}`;
             );
           }
         }
-        const priceCents = Math.round(median * 100);
+        const priceCents = Math.round(median2 * 100);
         const priceWith8Decimals = BigInt(priceCents) * 1000000n;
         const totalElapsed = Date.now() - startTime;
-        console.log(`[Price Oracle] Median price: $${median.toLocaleString()} \u2014 total time: ${totalElapsed}ms`);
+        console.log(`[Price Oracle] Median price: $${median2.toLocaleString()} \u2014 total time: ${totalElapsed}ms`);
         console.log(`[Price Oracle] Price with 8 decimals: ${priceWith8Decimals}`);
         return priceWith8Decimals;
       }
@@ -6137,33 +6137,94 @@ var SDKError = class _SDKError extends Error {
 };
 
 // src/utils/chunks/eip1559-broadcast.utils.ts
-import { parseUnits } from "ethers";
+import {
+  getBigInt,
+  parseUnits,
+  toQuantity
+} from "ethers";
 var MINT_UCD_GAS_CEILING = BigInt(13e5);
 var WITHDRAW_BTC_GAS_CEILING = BigInt(3e6);
 var MAKE_PAYMENT_GAS_CEILING = BigInt(1e6);
 var EXTEND_POSITION_GAS_CEILING = BigInt(1e6);
 var LIQUIDATION_COMMIT_GAS_CEILING = BigInt(1e6);
 var LIQUIDATION_REVEAL_GAS_CEILING = BigInt(2e6);
-async function resolveEip1559FeeFields(provider) {
-  const feeData = await provider.getFeeData();
-  let maxFeePerGas = feeData.maxFeePerGas ?? void 0;
-  let maxPriorityFeePerGas = feeData.maxPriorityFeePerGas ?? void 0;
-  if (!maxFeePerGas || !maxPriorityFeePerGas) {
-    const gasPrice = (await provider.getFeeData()).gasPrice ?? parseUnits("1", "gwei");
-    maxFeePerGas = maxFeePerGas || gasPrice * 2n;
-    maxPriorityFeePerGas = maxPriorityFeePerGas || parseUnits("1.5", "gwei");
-  }
-  if (maxFeePerGas < maxPriorityFeePerGas) {
-    maxFeePerGas = maxPriorityFeePerGas;
+var PRIORITY_FEE_FLOOR_WEI = parseUnits("0.1", "gwei");
+var PRIORITY_FEE_CAP_WEI = parseUnits("3", "gwei");
+var FEE_HISTORY_BLOCK_COUNT = 20;
+var FEE_HISTORY_REWARD_PERCENTILE = 75;
+function isJsonRpcSendable(provider) {
+  return typeof provider.send === "function";
+}
+function parseFeeHistory(raw) {
+  if (typeof raw !== "object" || raw === null) {
+    throw new Error(`eth_feeHistory returned a non-object result: ${JSON.stringify(raw)}`);
+  }
+  const { baseFeePerGas, reward } = raw;
+  if (!Array.isArray(baseFeePerGas) || baseFeePerGas.length === 0) {
+    throw new Error(
+      `eth_feeHistory returned no baseFeePerGas \u2014 the RPC does not support EIP-1559 fee history: ${JSON.stringify(raw)}`
+    );
+  }
+  if (!Array.isArray(reward) || reward.length === 0) {
+    throw new Error(
+      `eth_feeHistory returned no reward percentiles \u2014 the RPC ignored the rewardPercentiles argument: ${JSON.stringify(raw)}`
+    );
   }
+  const nextBaseFee = getBigInt(baseFeePerGas[baseFeePerGas.length - 1], "baseFeePerGas");
+  const tips = reward.map((perBlock, i) => {
+    if (!Array.isArray(perBlock) || perBlock.length === 0) {
+      throw new Error(`eth_feeHistory reward row ${i} is empty: ${JSON.stringify(raw)}`);
+    }
+    return getBigInt(perBlock[0], `reward[${i}]`);
+  });
+  return { nextBaseFee, tips };
+}
+function median(values) {
+  const sorted = [...values].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+  const mid = sorted.length >> 1;
+  const hi = sorted[mid];
+  if (hi === void 0) {
+    throw new Error("median: no values");
+  }
+  if (sorted.length % 2 === 1)
+    return hi;
+  const lo = sorted[mid - 1];
+  if (lo === void 0) {
+    throw new Error("median: no values");
+  }
+  return (lo + hi) / 2n;
+}
+function clamp(value, floor, cap) {
+  if (value < floor)
+    return floor;
+  if (value > cap)
+    return cap;
+  return value;
+}
+async function resolveEip1559FeeFields(feeProvider) {
+  if (!isJsonRpcSendable(feeProvider)) {
+    throw new Error(
+      "resolveEip1559FeeFields: feeProvider must be a JSON-RPC provider exposing send() (the SDK read provider), not a wallet BrowserProvider \u2014 eth_feeHistory is required"
+    );
+  }
+  const history = parseFeeHistory(
+    await feeProvider.send("eth_feeHistory", [
+      toQuantity(FEE_HISTORY_BLOCK_COUNT),
+      "latest",
+      [FEE_HISTORY_REWARD_PERCENTILE]
+    ])
+  );
+  const marketTip = median(history.tips);
+  const maxPriorityFeePerGas = clamp(marketTip, PRIORITY_FEE_FLOOR_WEI, PRIORITY_FEE_CAP_WEI);
+  const maxFeePerGas = history.nextBaseFee * 2n + maxPriorityFeePerGas;
   return { maxFeePerGas, maxPriorityFeePerGas };
 }
 async function sendEip1559Transaction(params) {
-  const { signer, to, data, gasLimit } = params;
+  const { signer, feeProvider, to, data, gasLimit } = params;
   if (!signer.provider) {
     throw new Error("Signer must have a provider attached");
   }
-  const fees = await resolveEip1559FeeFields(signer.provider);
+  const fees = await resolveEip1559FeeFields(feeProvider);
   return signer.sendTransaction({
     to,
     data,
@@ -21134,6 +21195,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
       }
       const tx = await sendEip1559Transaction({
         signer,
+        feeProvider: this.getProviderOrThrow(),
         to: positionManagerAddress,
         data: mintCalldata,
         gasLimit: MINT_UCD_GAS_CEILING
@@ -22355,6 +22417,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
     }
     const tx = await sendEip1559Transaction({
       signer: extendSigner,
+      feeProvider: this.getProviderOrThrow(),
       to: extendTo,
       data: extendCalldata,
       gasLimit: EXTEND_POSITION_GAS_CEILING
@@ -23283,6 +23346,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
       }
       const tx = await sendEip1559Transaction({
         signer: paymentSigner,
+        feeProvider: this.getProviderOrThrow(),
         to: paymentContractAddress,
         data: paymentCalldata,
         gasLimit: MAKE_PAYMENT_GAS_CEILING
@@ -24048,6 +24112,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
         });
         tx = await sendEip1559Transaction({
           signer: withdrawSigner,
+          feeProvider: this.getProviderOrThrow(),
           to: positionManagerAddress,
           data: withdrawCalldata,
           gasLimit: WITHDRAW_BTC_GAS_CEILING

package/dist/utils/chunks/eip1559-broadcast.utils.d.ts

@@ -24,9 +24,14 @@ export declare const MINT_UCD_GAS_CEILING: bigint;
  * gasLimit — no estimateGas runs on this path). The on-chain flow now spans PositionManager →
  * CollateralManager → LoanOperationsManager → BTCSpendAuthorizer plus the audit
  * #3 Chainlink feed-staleness gate and the BitcoinWithdrawalAddressRegistry
- * allowlist STATICCALL; observed end-to-end cost is ~1.0–1.3M gas, so the prior
- * hardcoded 1,000,000 limit caused a nested out-of-gas. 3M gives ~2x headroom
- * while staying well under the block gas limit.
+ * allowlist STATICCALL; observed end-to-end cost was ~1.0–1.3M gas when this
+ * was sized, so the prior hardcoded 1,000,000 limit caused a nested out-of-gas.
+ * A mainnet withdrawBTC measured 750,919 gas on 2026-09-04 (2 vault inputs,
+ * 1 prior reservation; tx 0xa244a184…) — recorded as a data point, NOT a new
+ * ceiling basis: cost grows with the number of open reservations
+ * (`_computeAuthorizedSpendsHash` is O(N)), so the ceiling stays sized to the
+ * observed MAX. 3M gives ~2x headroom over it while staying well under the
+ * block gas limit.
  */
 export declare const WITHDRAW_BTC_GAS_CEILING: bigint;
 /**
@@ -86,12 +91,60 @@ export declare const LIQUIDATION_COMMIT_GAS_CEILING: bigint;
  * provisional until re-measured against a real liquidation.
  */
 export declare const LIQUIDATION_REVEAL_GAS_CEILING: bigint;
-export declare function resolveEip1559FeeFields(provider: Provider): Promise<{
+/**
+ * Priority-fee (tip) policy for every timing-sensitive broadcast in this file.
+ *
+ * History that sizes these numbers (docs/withdraw-btc-gas-cost-recommendations-2026-09-05.md):
+ * - 2026-07-02: a 0 gwei tip (the read RPC reported a real 0n
+ *   eth_maxPriorityFeePerGas) sat unmined 119–143 s → QuantumOutsideWindow.
+ * - 2026-08-07: a 0.0007 gwei tip was skipped by one NEAR-EMPTY block, mined
+ *   24 s later → DeadZoneViolation (see quantum-timing.ts).
+ * - 2026-09-04: a mainnet withdrawBTC went out with ethers' hardcoded 1 gwei
+ *   fallback tip (the wallet provider did not answer eth_maxPriorityFeePerGas)
+ *   while the market p50 tip was ~0.03 gwei — 93% of a $1.99 tx was tip.
+ *
+ * So the tip is read from the market (eth_feeHistory on the app's READ RPC,
+ * never the wallet provider) at a percentile that buys next-block inclusion,
+ * then clamped: the floor keeps builders from skipping us (a quantum miss
+ * wastes the Lit signatures, the Chipotle spend and the reverted tx's base
+ * fee — far more than the tip), the cap stops a spiking feeHistory from
+ * overpaying. At ~751k gas the floor costs ≈ $0.18 (ETH $2,458).
+ */
+export declare const PRIORITY_FEE_FLOOR_WEI: bigint;
+export declare const PRIORITY_FEE_CAP_WEI: bigint;
+/** Blocks of eth_feeHistory sampled; the median across them absorbs a single spike block. */
+export declare const FEE_HISTORY_BLOCK_COUNT = 20;
+/**
+ * Reward percentile per block. p75 (not p50) because these sends are
+ * quantum-bounded: paying above the median tip buys inclusion in the next
+ * slot or two, which is what the 60 s window actually needs.
+ */
+export declare const FEE_HISTORY_REWARD_PERCENTILE = 75;
+/** The subset of ethers' JsonRpcApiProvider these helpers need — raw JSON-RPC access. */
+export interface JsonRpcSendable {
+    send(method: string, params: unknown[]): Promise<unknown>;
+}
+/**
+ * Resolve EIP-1559 fee fields from the app's READ RPC.
+ *
+ * `feeProvider` must be a JSON-RPC provider (ethers `JsonRpcProvider` or any
+ * object exposing `send`), NOT the wallet's `BrowserProvider`: wallet
+ * providers routinely fail `eth_maxPriorityFeePerGas`, and ethers'
+ * `getFeeData()` then silently substitutes a 1 gwei tip — the 2026-09-04
+ * overpayment. This helper never calls `getFeeData()`.
+ *
+ * One `eth_feeHistory` round-trip replaces the three RPC calls `getFeeData()`
+ * made (block, gasPrice, priorityFee), so it is also faster on the
+ * quantum-gated path that runs right before the send.
+ */
+export declare function resolveEip1559FeeFields(feeProvider: Provider): Promise<{
     maxFeePerGas: bigint;
     maxPriorityFeePerGas: bigint;
 }>;
 export declare function sendEip1559Transaction(params: {
     signer: Signer;
+    /** The SDK READ provider (JSON-RPC). Fee fields come from here, never from `signer.provider`. */
+    feeProvider: Provider;
     to: string;
     data: string;
     gasLimit: bigint;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gvnrdao/dh-sdk",
-  "version": "0.0.333",
+  "version": "0.0.334",
   "description": "TypeScript SDK for Diamond Hands Protocol - Bitcoin-backed lending with LIT Protocol PKPs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",