@gvnrdao/dh-sdk 0.0.340 → 0.0.341

package/dist/sign-guard.js

@@ -32,6 +32,8 @@ __export(sign_guard_exports, {
   OP_ENVELOPE_FIELD_ORDER: () => OP_ENVELOPE_FIELD_ORDER,
   OP_ENVELOPE_LAYOUT: () => OP_ENVELOPE_LAYOUT,
   OP_ENVELOPE_TYPES: () => OP_ENVELOPE_TYPES,
+  PRIORITY_FEE_CAP_WEI: () => PRIORITY_FEE_CAP_WEI,
+  PRIORITY_FEE_FLOOR_WEI: () => PRIORITY_FEE_FLOOR_WEI,
   QUANTUM_SECONDS: () => QUANTUM_SECONDS,
   REQUEST_TIMEOUT_MS: () => REQUEST_TIMEOUT_MS,
   SIGNABLE_FUNCTIONS: () => SIGNABLE_FUNCTIONS,
@@ -160,6 +162,8 @@ var import_ethers2 = require("ethers");
 var MAX_GAS_LIMIT = 5000000n;
 var MAX_FEE_PER_GAS_WEI = 2000000000000n;
 var DEFAULT_MAX_TX_FEE_WEI = 250000000000000000n;
+var PRIORITY_FEE_FLOOR_WEI = 100000000n;
+var PRIORITY_FEE_CAP_WEI = 3000000000n;
 var DEFAULT_FEE_CEILING = {
   maxGasLimit: MAX_GAS_LIMIT,
   maxFeePerGasWei: MAX_FEE_PER_GAS_WEI,
@@ -1109,6 +1113,8 @@ async function executePsmPlan(plan, signer, vctx) {
   OP_ENVELOPE_FIELD_ORDER,
   OP_ENVELOPE_LAYOUT,
   OP_ENVELOPE_TYPES,
+  PRIORITY_FEE_CAP_WEI,
+  PRIORITY_FEE_FLOOR_WEI,
   QUANTUM_SECONDS,
   REQUEST_TIMEOUT_MS,
   SIGNABLE_FUNCTIONS,

package/dist/sign-guard.mjs

@@ -88,6 +88,8 @@ import { ethers as ethers2 } from "ethers";
 var MAX_GAS_LIMIT = 5000000n;
 var MAX_FEE_PER_GAS_WEI = 2000000000000n;
 var DEFAULT_MAX_TX_FEE_WEI = 250000000000000000n;
+var PRIORITY_FEE_FLOOR_WEI = 100000000n;
+var PRIORITY_FEE_CAP_WEI = 3000000000n;
 var DEFAULT_FEE_CEILING = {
   maxGasLimit: MAX_GAS_LIMIT,
   maxFeePerGasWei: MAX_FEE_PER_GAS_WEI,
@@ -1036,6 +1038,8 @@ export {
   OP_ENVELOPE_FIELD_ORDER,
   OP_ENVELOPE_LAYOUT,
   OP_ENVELOPE_TYPES,
+  PRIORITY_FEE_CAP_WEI,
+  PRIORITY_FEE_FLOOR_WEI,
   QUANTUM_SECONDS,
   REQUEST_TIMEOUT_MS,
   SIGNABLE_FUNCTIONS,

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

@@ -110,8 +110,8 @@ export declare const LIQUIDATION_REVEAL_GAS_CEILING: bigint;
  * 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;
+import { PRIORITY_FEE_FLOOR_WEI, PRIORITY_FEE_CAP_WEI } from "../sign-guard/fee-ceiling";
+export { PRIORITY_FEE_FLOOR_WEI, PRIORITY_FEE_CAP_WEI };
 /** Blocks of eth_feeHistory sampled; the median across them absorbs a single spike block. */
 export declare const FEE_HISTORY_BLOCK_COUNT = 20;
 /**

package/dist/utils/contract-error-decoder.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Contract error decoder — a revert's bytes turned into the error the CONTRACT declares.
+ *
+ * Every name and selector here comes from the committed typechain ABIs, never from a
+ * hand-written table. Two hand-written tables used to live in this file and they had
+ * drifted: `0x137f3b70 -> InDeadZone` is a selector no contract can ever emit (the real
+ * error is `DeadZoneViolation()`, `0xbe4b82c1`; `isInDeadZone` is a view function), so a
+ * borrower hitting the dead zone would have been told about an error that does not exist.
+ * An ABI-derived table cannot drift: a renamed or deleted error disappears with it.
+ *
+ * Selector collisions across contracts are possible in principle (4 bytes). The table
+ * records EVERY contract a selector belongs to and `contract` names them all, rather than
+ * silently picking one.
+ */
+import { type ErrorFragment } from "ethers";
+/** Decoded error information. */
+export interface DecodedError {
+    name: string;
+    selector: string;
+    args?: any[];
+    /** The contract(s) declaring this error, or `"Unknown"`. */
+    contract: string;
+    message: string;
+}
+export interface ContractErrorEntry {
+    /** `Name(type,type)` exactly as declared. */
+    signature: string;
+    fragment: ErrorFragment;
+    /** Every contract in the set declaring this selector. */
+    contracts: string[];
+}
+/** Selector -> declared error, built once from the generated fragments. */
+export declare function contractErrorTable(): Map<string, ContractErrorEntry>;
+/** The declared error for a selector, or null when no contract in the set declares it. */
+export declare function lookupContractError(selector: string): ContractErrorEntry | null;
+/**
+ * Decode a contract revert.
+ *
+ * Returns the declared error with its ARGUMENTS wherever the payload carries them — the
+ * figures are the point (`SlippageExceeded(got, minimum)`, `InsufficientReserves(available,
+ * required)`). Selector-only payloads still resolve to the right name with empty args.
+ * Standard `Error(string)` and `Panic(uint256)` reverts decode too. Returns null only when
+ * there is nothing to decode at all.
+ */
+export declare function decodeContractError(error: any): DecodedError | null;
+/** Format a decoded error for logging and user-facing messages. */
+export declare function formatDecodedError(decoded: DecodedError): string;

package/dist/utils/quantum-revert.utils.d.ts

@@ -15,8 +15,20 @@ export declare const ERROR_STRING_SELECTOR = "0x08c379a0";
 /** Solidity `Panic(uint256)` (assert failures, overflow, div-by-zero, …). */
 export declare const PANIC_SELECTOR = "0x4e487b71";
 /**
- * Union of the custom-error selectors the mint/payment/quantum paths decode. Keep in
- * sync with OperationAuthorizationRegistry / PositionManager / LoanOperationsManager.
+ * The custom-error selectors the mint/payment/quantum paths decode.
+ *
+ * EVERY row is an error some contract declares, and
+ * `tests/shared/unit/contract-error-decoder.test.ts` proves it against the committed ABIs —
+ * because six rows here were fiction, and fiction on this path is read by a borrower:
+ *
+ *  - `InDeadZone()`, `QuantumExpired()`, `UnauthorizedSigner()` and a no-argument
+ *    `InvalidSignature()` are declared by NO contract (the real ones are
+ *    `DeadZoneViolation()`, and `InvalidSignature(string reason)`);
+ *  - `0x48f5c3ed` was labelled `Unauthorized()`, which is really `0x82b42900`;
+ *  - `0x3ee5aeb5` was labelled `OperationNotAuthorized()` — it is
+ *    `ReentrancyGuardReentrantCall()`, and `0xd92e233d`, labelled `ValidationFailed()`, is
+ *    really `ZeroAddress()` (`ValidationFailed()` is `0x0a0b0d79`). Both are reachable
+ *    reverts that were being reported to users under another error's name.
  */
 export declare const QUANTUM_REVERT_NAMES: Record<string, string>;
 export interface DecodedRevert {

package/dist/utils/sign-guard/fee-ceiling.d.ts

@@ -16,6 +16,22 @@
 export declare const MAX_GAS_LIMIT = 5000000n;
 export declare const MAX_FEE_PER_GAS_WEI = 2000000000000n;
 export declare const DEFAULT_MAX_TX_FEE_WEI = 250000000000000000n;
+/**
+ * The priority-fee (tip) band for a quantum-bounded send, in wei.
+ *
+ * These live HERE, beside the ceilings, because they are the same kind of fact — what a
+ * client may pay — and every client needs them: the SDK's EIP-1559 broadcaster clamps the
+ * market tip into this band, and the CLI and MCP price their own sends. They were
+ * previously reachable only from a deep SDK path (`utils/chunks/eip1559-broadcast.utils`),
+ * which a consumer taking only `./sign-guard` cannot import, so each client wrote its own
+ * numbers instead.
+ *
+ * Floor: builders skip a tip that is too low, and a missed quantum wastes the Lit
+ * signatures, the Chipotle spend and the reverted transaction's base fee — all far more
+ * than the tip. Cap: a spiking `eth_feeHistory` must not turn into an overpaid send.
+ */
+export declare const PRIORITY_FEE_FLOOR_WEI = 100000000n;
+export declare const PRIORITY_FEE_CAP_WEI = 3000000000n;
 export interface FeeCeiling {
     maxGasLimit: bigint;
     maxFeePerGasWei: bigint;

package/dist/utils/sign-guard/index.d.ts

@@ -1,6 +1,6 @@
 export { TxValidationError } from "./errors";
 export { SIGNABLE_FUNCTIONS, encodeSignable, decodeSignable, signableFunctionName, signableSelectors, } from "./signable-functions";
-export { MAX_GAS_LIMIT, MAX_FEE_PER_GAS_WEI, DEFAULT_MAX_TX_FEE_WEI, DEFAULT_FEE_CEILING, worstCaseFeeWei, assertFeeCeiling, type FeeCeiling, } from "./fee-ceiling";
+export { MAX_GAS_LIMIT, MAX_FEE_PER_GAS_WEI, DEFAULT_MAX_TX_FEE_WEI, PRIORITY_FEE_FLOOR_WEI, PRIORITY_FEE_CAP_WEI, DEFAULT_FEE_CEILING, worstCaseFeeWei, assertFeeCeiling, type FeeCeiling, } from "./fee-ceiling";
 export { validateUnsignedTx, buildValidationContext, describeUnsignedTx, readTxFeeFields, type ExpectedAction, type ContractRegistry, type ValidationContext, } from "./tx-validator";
 export { QUANTUM_SECONDS, AUTH_VALIDITY_WINDOWS, authValiditySec, nextQuantumTimestamp, isAuthFresh, isStrictCurrentQuantum, modeForChainId, randomNonceHex, OP_ENVELOPE_LAYOUT, OP_ENVELOPE_TYPES, OP_ENVELOPE_FIELD_ORDER, stampOpEnvelope, buildAuthEnvelope, type OpEnvelopeInput, type StampedOpEnvelope, type AuthEnvelope, } from "./op-envelope";
 export { DELEGATED_OPS, BROADCAST_PATH, type DelegatedOp, type DelegatedOpSpec } from "./op-specs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gvnrdao/dh-sdk",
-  "version": "0.0.340",
+  "version": "0.0.341",
   "description": "TypeScript SDK for Diamond Hands Protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -39,6 +39,11 @@
       "types": "./dist/sign-guard.d.ts",
       "import": "./dist/sign-guard.mjs",
       "require": "./dist/sign-guard.js"
+    },
+    "./contract-errors": {
+      "types": "./dist/contract-errors.d.ts",
+      "import": "./dist/contract-errors.mjs",
+      "require": "./dist/contract-errors.js"
     }
   },
   "files": [
@@ -50,8 +55,9 @@
   "scripts": {
     "build": "npm run sync:deployments && npm run validate:contracts && npm run build:node",
     "build:all": "npm run sync:deployments && npm run validate:contracts && npm run build:node && npm run build:browser",
-    "build:node": "npm run sync:deployments && tsup && npm run build:types",
+    "build:node": "npm run sync:deployments && tsup && npm run build:types && npm run check:bundle-externals",
     "build:types": "tsc -p tsconfig.build.json",
+    "check:bundle-externals": "node scripts/check-bundle-externals.mjs",
     "build:browser": "cd browser && npm install && npm run build",
     "sync:deployments": "node scripts/sync-deployments.js",
     "sync:typechain": "cd ../contracts && npm run compile",
@@ -74,7 +80,8 @@
     "lint": "eslint src --ext .ts && npm run lint:server-boundary && npm run lint:sign-guard",
     "lint:server-boundary": "node scripts/check-pkp-mint-server-imports.mjs",
     "lint:sign-guard": "node scripts/check-sign-guard-imports.mjs",
-    "clean": "rm -rf dist && rm -rf browser/dist"
+    "clean": "rm -rf dist && rm -rf browser/dist",
+    "gen:contract-errors": "node scripts/gen-contract-errors.mjs"
   },
   "keywords": [
     "bitcoin",
@@ -93,17 +100,22 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@gvnrdao/dh-lit-actions": "^0.0.322",
-    "@gvnrdao/dh-lit-ops": "^0.0.316",
     "@noble/hashes": "^1.5.0",
     "axios": "^1.17.0",
     "bech32": "^2.0.0",
     "bip66": "^2.0.0",
     "bitcoinjs-lib": "^6.1.0",
+    "bn.js": "^5.2.3",
     "bs58check": "^3.0.1",
     "crypto-js": "^4.2.0",
     "dotenv": "^17.4.2",
-    "ethers": "6.16.0"
+    "elliptic": "^6.6.1",
+    "ethers": "6.16.0",
+    "uuid": "^9.0.1"
+  },
+  "optionalDependencies": {
+    "@gvnrdao/dh-lit-actions": "^0.0.322",
+    "@gvnrdao/dh-lit-ops": "^0.0.316"
   },
   "devDependencies": {
     "@babel/preset-env": "7.29.7",
@@ -150,6 +162,9 @@
       ],
       "sign-guard": [
         "./dist/sign-guard.d.ts"
+      ],
+      "contract-errors": [
+        "./dist/contract-errors.d.ts"
       ]
     }
   }