@gvnrdao/dh-sdk 0.0.333 → 0.0.335

package/dist/constants/chunks/protocol-license.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Protocol license data for Diamond Hands.
+ *
+ * Single source of truth: the repository `LICENSE` file (byte-identical in
+ * `sdk/LICENSE` and `contracts/LICENSE`). `ContractVersionRegistry` publishes
+ * the SPDX identifier and a CIDv1 (raw/sha2-256) URI of that same file:
+ *
+ *   LICENSE     = "UNLICENSED"
+ *   LICENSE_URI = "ipfs://bafkreigunb4phugonefe66by524nhnrgrpol4233ytg7e7eg7qomhy3s3a"
+ *
+ * `getLicense()` returns the bundled text so callers do not depend on an IPFS
+ * gateway. Fetching the CID at runtime would be a second copy of these bytes
+ * plus a network failure mode. A unit test locks the file, the CID, and the
+ * on-chain constants together.
+ */
+export declare const PROTOCOL_LICENSE_IDENTIFIER: "UNLICENSED";
+export declare const PROTOCOL_LICENSE_URI: "ipfs://bafkreigunb4phugonefe66by524nhnrgrpol4233ytg7e7eg7qomhy3s3a";
+export type ProtocolLicense = {
+    /** SPDX identifier published on-chain as `ContractVersionRegistry.LICENSE`. */
+    identifier: typeof PROTOCOL_LICENSE_IDENTIFIER;
+    /**
+     * Content-addressed IPFS URI published on-chain as
+     * `ContractVersionRegistry.LICENSE_URI`. The CID is CIDv1 / raw / sha2-256
+     * of `text`.
+     */
+    uri: typeof PROTOCOL_LICENSE_URI;
+    /** Full proprietary license text (byte-identical to the CID payload). */
+    text: string;
+};
+/**
+ * Return the Diamond Hands protocol license.
+ *
+ * This is the package `LICENSE` file — the same bytes pinned at
+ * {@link PROTOCOL_LICENSE_URI} and advertised by `ContractVersionRegistry`.
+ *
+ * @returns Identifier (`UNLICENSED`), IPFS URI, and full license text.
+ *
+ * @example
+ * ```ts
+ * import { getLicense } from "@gvnrdao/dh-sdk";
+ *
+ * const license = getLicense();
+ * console.log(license.identifier); // "UNLICENSED"
+ * console.log(license.uri);        // "ipfs://bafkrei…"
+ * console.log(license.text);       // full GVNR DAO LLC reservation
+ * ```
+ */
+export declare function getLicense(): ProtocolLicense;

package/dist/constants/index.d.ts

@@ -13,3 +13,4 @@ export * from "./chunks/network-configs";
 export * from "./chunks/environment.browser";
 export * from "./chunks/contract-abis";
 export * from "./chunks/sdk-limits";
+export * from "./chunks/protocol-license";

package/dist/index.d.ts

@@ -49,6 +49,8 @@ export { LoanStatus } from './types/loanStatus';
 export type { LoanEvents, LoanEventsFilter, PositionCreatedEvent, PaymentEvent, StatusUpdateEvent, LiquidationEvent, UCDMintEvent, WithdrawalEvent, RenewalEvent, OperationFailureEvent, MintRequestEvent, BurnRequestEvent, CollateralContractEvent, } from './types/event-types';
 export { PaymentType, PositionStatus, isValidPositionStatus, isValidPaymentType, numericToPositionStatus, EventHelpers, } from './types/event-types';
 export type { ProtocolEvent, ProtocolEventsFilter, ProtocolEventsResult, } from './types/protocol-event-types';
+export { getLicense, PROTOCOL_LICENSE_IDENTIFIER, PROTOCOL_LICENSE_URI, } from './constants/chunks/protocol-license';
+export type { ProtocolLicense } from './constants/chunks/protocol-license';
 export { fetchProtocolPauseStatus, assertProtocolNotPaused, } from './protocol/protocol-pause';
 export type { ProtocolPauseStatus, ProtocolPauseKey, } from './protocol/protocol-pause';
 export { SDKError, ErrorCategory, ErrorSeverity } from './utils/error-handler';

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;
       }
@@ -5771,6 +5771,8 @@ __export(src_exports, {
   LoanQuery: () => LoanQuery,
   LoanStatus: () => LoanStatus,
   PKPManager: () => PKPManager,
+  PROTOCOL_LICENSE_IDENTIFIER: () => PROTOCOL_LICENSE_IDENTIFIER,
+  PROTOCOL_LICENSE_URI: () => PROTOCOL_LICENSE_URI,
   PaymentType: () => PaymentType,
   PositionStatus: () => PositionStatus,
   RECOVERY_INVALIDATE_ACTION: () => RECOVERY_INVALIDATE_ACTION,
@@ -5809,6 +5811,7 @@ __export(src_exports, {
   getContractsByNetwork: () => getContractsByNetwork,
   getDelegateStatus: () => getDelegateStatus,
   getDeploymentByNetwork: () => getDeploymentByNetwork,
+  getLicense: () => getLicense,
   getPositionDelegate: () => getPositionDelegate,
   getSafeAgentDelegation: () => getSafeAgentDelegation,
   isClosePositionAuth: () => isClosePositionAuth,
@@ -6233,26 +6236,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,
@@ -6278,6 +6338,19 @@ var SDK_DEFAULTS = {
   DEBUG: false
 };
 
+// src/constants/chunks/protocol-license.ts
+var PROTOCOL_LICENSE_IDENTIFIER = "UNLICENSED";
+var PROTOCOL_LICENSE_URI = "ipfs://bafkreigunb4phugonefe66by524nhnrgrpol4233ytg7e7eg7qomhy3s3a";
+var PROTOCOL_LICENSE_TEXT = '(c) GVNR DAO LLC, 2026\n\nExcept as otherwise provided in the header of a specific source code\nfile in this repository: (a) all intellectual property (including all\nsource code, designs and protocols) contained in this repository has been\npublished for informational purposes only; (b) no license, right of\nreproduction or distribution or other right with respect thereto is\ngranted or implied; and (c) all moral, intellectual property and other\nrights are hereby reserved by the copyright holder.\n\nTHE SOFTWARE AND INTELLECTUAL PROPERTY INCLUDED IN THIS REPOSITORY\nIS PROVIDED BY THE COPYRIGHT HOLDERS "AS IS," AND ANY EXPRESS\nOR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE OR\nINTELLECTUAL PROPERTY (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT\nOF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR\nBUSINESS INTERRUPTION), HOWEVER CAUSED OR CLAIMED (WHETHER IN CONTRACT,\nSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)), EVEN IF\nSUCH DAMAGES WERE REASONABLY FORESEEABLE  OR THE COPYRIGHT HOLDERS WERE\nADVISED OF THE POSSIBILITY OF SUCH DAMAGE.';
+var PROTOCOL_LICENSE = Object.freeze({
+  identifier: PROTOCOL_LICENSE_IDENTIFIER,
+  uri: PROTOCOL_LICENSE_URI,
+  text: PROTOCOL_LICENSE_TEXT
+});
+function getLicense() {
+  return PROTOCOL_LICENSE;
+}
+
 // src/utils/service-endpoint-policy.ts
 function assertSafeServiceEndpoint(endpoint) {
   let url;
@@ -21209,6 +21282,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
       }
       const tx = await sendEip1559Transaction({
         signer,
+        feeProvider: this.getProviderOrThrow(),
         to: positionManagerAddress,
         data: mintCalldata,
         gasLimit: MINT_UCD_GAS_CEILING
@@ -22430,6 +22504,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 +23433,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 +24199,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
         });
         tx = await sendEip1559Transaction({
           signer: withdrawSigner,
+          feeProvider: this.getProviderOrThrow(),
           to: positionManagerAddress,
           data: withdrawCalldata,
           gasLimit: WITHDRAW_BTC_GAS_CEILING
@@ -26594,6 +26671,25 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
   getConfig() {
     return this.config;
   }
+  /**
+   * Return the Diamond Hands protocol license.
+   *
+   * Same data as the standalone `getLicense()` export: the package `LICENSE`
+   * file, which is the CIDv1 payload of `ContractVersionRegistry.LICENSE_URI`.
+   * Does not fetch IPFS.
+   *
+   * @returns Identifier (`UNLICENSED`), IPFS URI, and full license text.
+   *
+   * @example
+   * ```ts
+   * const license = sdk.getLicense();
+   * console.log(license.identifier); // "UNLICENSED"
+   * console.log(license.uri);        // "ipfs://bafkrei…"
+   * ```
+   */
+  getLicense() {
+    return getLicense();
+  }
   /**
    * Clear all caches
    */
@@ -27560,6 +27656,8 @@ async function getSafeAgentDelegation(params) {
   LoanQuery,
   LoanStatus,
   PKPManager,
+  PROTOCOL_LICENSE_IDENTIFIER,
+  PROTOCOL_LICENSE_URI,
   PaymentType,
   PositionStatus,
   RECOVERY_INVALIDATE_ACTION,
@@ -27597,6 +27695,7 @@ async function getSafeAgentDelegation(params) {
   getContractsByNetwork,
   getDelegateStatus,
   getDeploymentByNetwork,
+  getLicense,
   getPositionDelegate,
   getSafeAgentDelegation,
   isClosePositionAuth,

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,
@@ -6189,6 +6250,19 @@ var SDK_DEFAULTS = {
   DEBUG: false
 };
 
+// src/constants/chunks/protocol-license.ts
+var PROTOCOL_LICENSE_IDENTIFIER = "UNLICENSED";
+var PROTOCOL_LICENSE_URI = "ipfs://bafkreigunb4phugonefe66by524nhnrgrpol4233ytg7e7eg7qomhy3s3a";
+var PROTOCOL_LICENSE_TEXT = '(c) GVNR DAO LLC, 2026\n\nExcept as otherwise provided in the header of a specific source code\nfile in this repository: (a) all intellectual property (including all\nsource code, designs and protocols) contained in this repository has been\npublished for informational purposes only; (b) no license, right of\nreproduction or distribution or other right with respect thereto is\ngranted or implied; and (c) all moral, intellectual property and other\nrights are hereby reserved by the copyright holder.\n\nTHE SOFTWARE AND INTELLECTUAL PROPERTY INCLUDED IN THIS REPOSITORY\nIS PROVIDED BY THE COPYRIGHT HOLDERS "AS IS," AND ANY EXPRESS\nOR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE OR\nINTELLECTUAL PROPERTY (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT\nOF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR\nBUSINESS INTERRUPTION), HOWEVER CAUSED OR CLAIMED (WHETHER IN CONTRACT,\nSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)), EVEN IF\nSUCH DAMAGES WERE REASONABLY FORESEEABLE  OR THE COPYRIGHT HOLDERS WERE\nADVISED OF THE POSSIBILITY OF SUCH DAMAGE.';
+var PROTOCOL_LICENSE = Object.freeze({
+  identifier: PROTOCOL_LICENSE_IDENTIFIER,
+  uri: PROTOCOL_LICENSE_URI,
+  text: PROTOCOL_LICENSE_TEXT
+});
+function getLicense() {
+  return PROTOCOL_LICENSE;
+}
+
 // src/utils/service-endpoint-policy.ts
 function assertSafeServiceEndpoint(endpoint) {
   let url;
@@ -21134,6 +21208,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
       }
       const tx = await sendEip1559Transaction({
         signer,
+        feeProvider: this.getProviderOrThrow(),
         to: positionManagerAddress,
         data: mintCalldata,
         gasLimit: MINT_UCD_GAS_CEILING
@@ -22355,6 +22430,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 +23359,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 +24125,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
         });
         tx = await sendEip1559Transaction({
           signer: withdrawSigner,
+          feeProvider: this.getProviderOrThrow(),
           to: positionManagerAddress,
           data: withdrawCalldata,
           gasLimit: WITHDRAW_BTC_GAS_CEILING
@@ -26519,6 +26597,25 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
   getConfig() {
     return this.config;
   }
+  /**
+   * Return the Diamond Hands protocol license.
+   *
+   * Same data as the standalone `getLicense()` export: the package `LICENSE`
+   * file, which is the CIDv1 payload of `ContractVersionRegistry.LICENSE_URI`.
+   * Does not fetch IPFS.
+   *
+   * @returns Identifier (`UNLICENSED`), IPFS URI, and full license text.
+   *
+   * @example
+   * ```ts
+   * const license = sdk.getLicense();
+   * console.log(license.identifier); // "UNLICENSED"
+   * console.log(license.uri);        // "ipfs://bafkrei…"
+   * ```
+   */
+  getLicense() {
+    return getLicense();
+  }
   /**
    * Clear all caches
    */
@@ -27484,6 +27581,8 @@ export {
   LoanQuery,
   LoanStatus,
   PKPManager,
+  PROTOCOL_LICENSE_IDENTIFIER,
+  PROTOCOL_LICENSE_URI,
   PaymentType,
   PositionStatus,
   RECOVERY_INVALIDATE_ACTION,
@@ -27522,6 +27621,7 @@ export {
   getContractsByNetwork,
   getDelegateStatus,
   getDeploymentByNetwork,
+  getLicense,
   getPositionDelegate,
   getSafeAgentDelegation,
   isClosePositionAuth,

package/dist/modules/diamond-hands-sdk.d.ts

@@ -17,6 +17,7 @@ import { Satoshis } from "../types/branded/domain-values";
 import { SDKError } from "../utils/error-handler";
 import type { CreateLoanRequest, CreateLoanResult, LoanDataDetail, UCDMintRequest, UCDMintResult, PartialPaymentRequest, PartialPaymentResult, BTCWithdrawalResult, RenewPositionRequest, RenewPositionResult, LiquidationRequest, LiquidationResult, ConfirmBalanceRequest, ConfirmBalanceResult, TermsWithFeesResult } from "../interfaces/chunks/loan-operations.i";
 import type { DiamondHandsSDKConfig } from "../interfaces/chunks/config.i";
+import { type ProtocolLicense } from "../constants/chunks/protocol-license";
 import type { PKPData } from "../interfaces/chunks/pkp-integration.i";
 import { type AuthorizationProvider } from "../utils/authorization-provider.utils";
 import type { DhServerLoginPayload } from "../utils/eip712-login";
@@ -1375,6 +1376,23 @@ export declare class DiamondHandsSDK {
      * Get SDK configuration
      */
     getConfig(): DiamondHandsSDKConfig;
+    /**
+     * Return the Diamond Hands protocol license.
+     *
+     * Same data as the standalone `getLicense()` export: the package `LICENSE`
+     * file, which is the CIDv1 payload of `ContractVersionRegistry.LICENSE_URI`.
+     * Does not fetch IPFS.
+     *
+     * @returns Identifier (`UNLICENSED`), IPFS URI, and full license text.
+     *
+     * @example
+     * ```ts
+     * const license = sdk.getLicense();
+     * console.log(license.identifier); // "UNLICENSED"
+     * console.log(license.uri);        // "ipfs://bafkrei…"
+     * ```
+     */
+    getLicense(): ProtocolLicense;
     /**
      * Clear all caches
      */

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.335",
   "description": "TypeScript SDK for Diamond Hands Protocol - Bitcoin-backed lending with LIT Protocol PKPs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",