@gvnrdao/dh-sdk 0.0.316 → 0.0.317

package/browser/dist/browser.js.LICENSE.txt

@@ -5,7 +5,7 @@
  * @license  MIT
  */
 
-/*! Axios v1.18.1 Copyright (c) 2026 Matt Zabriskie and contributors */
+/*! Axios v1.19.0 Copyright (c) 2026 Matt Zabriskie and contributors */
 
 /*! MIT License. Copyright 2015-2022 Richard Moore <me@ricmoo.com>. See LICENSE.txt. */
 

package/dist/deployments.js

@@ -321,7 +321,7 @@ var SEPOLIA_DEPLOYMENT = {
     MOCK_USDC_TOKEN: "0x96409A98e0D322d6566b7F44a0fAbD1BD4ce2AEc",
     MOCK_USDT_TOKEN: "0xF8b7fB38b17a310960E47805Be9adba0b0e0394D",
     POSITION_DELEGATE_REGISTRY: "0x482369De283622E7b05731875ec137d4E3D208F9",
-    POSITION_DELEGATE_REGISTRY_IMPL: "0x301fa9AA527016D033e151b982C64cD8670a39E3",
+    POSITION_DELEGATE_REGISTRY_IMPL: "0xc681c48688cdAA966119E265e4a378ef8Fe0eBcA",
     AGENT_MODULE: "0xefb8C29C1e7e92ed7d81a52dbedaed74e37fe380",
     FEE_RECIPIENT_REGISTRY: "0x95795F8403DDb629E8527B2934C4e71f5fC0C374",
     FEE_RECIPIENT_REGISTRY_IMPL: "0xd08513a7cB2dd354B26cDDf549616F12054c34c9",

package/dist/deployments.mjs

@@ -288,7 +288,7 @@ var SEPOLIA_DEPLOYMENT = {
     MOCK_USDC_TOKEN: "0x96409A98e0D322d6566b7F44a0fAbD1BD4ce2AEc",
     MOCK_USDT_TOKEN: "0xF8b7fB38b17a310960E47805Be9adba0b0e0394D",
     POSITION_DELEGATE_REGISTRY: "0x482369De283622E7b05731875ec137d4E3D208F9",
-    POSITION_DELEGATE_REGISTRY_IMPL: "0x301fa9AA527016D033e151b982C64cD8670a39E3",
+    POSITION_DELEGATE_REGISTRY_IMPL: "0xc681c48688cdAA966119E265e4a378ef8Fe0eBcA",
     AGENT_MODULE: "0xefb8C29C1e7e92ed7d81a52dbedaed74e37fe380",
     FEE_RECIPIENT_REGISTRY: "0x95795F8403DDb629E8527B2934C4e71f5fC0C374",
     FEE_RECIPIENT_REGISTRY_IMPL: "0xd08513a7cB2dd354B26cDDf549616F12054c34c9",

package/dist/index.d.ts

@@ -51,7 +51,7 @@ export type { ProtocolEvent, ProtocolEventsFilter, ProtocolEventsResult, } from
 export { fetchProtocolPauseStatus, assertProtocolNotPaused, } from './protocol/protocol-pause';
 export type { ProtocolPauseStatus, ProtocolPauseKey, } from './protocol/protocol-pause';
 export { SDKError, ErrorCategory, ErrorSeverity } from './utils/error-handler';
-export { setPositionDelegate, getPositionDelegate } from './utils/position-delegate.utils';
+export { setPositionDelegate, getPositionDelegate, isPositionDelegate, getDelegateStatus, DelegateDenyReason, } from './utils/position-delegate.utils';
 export { buildBtcExecuteEnvelope, } from './utils/btc-withdrawal-message';
 export type { BtcExecuteSignParams, BtcExecuteSignedEnvelope, } from './utils/btc-withdrawal-message';
 export { reconcileAuthorizedSpend, defaultHttpGetJson, } from './utils/withdrawal-reconciliation.utils';

package/dist/index.js

@@ -346,7 +346,7 @@ var init_deployment_addresses = __esm({
         MOCK_USDC_TOKEN: "0x96409A98e0D322d6566b7F44a0fAbD1BD4ce2AEc",
         MOCK_USDT_TOKEN: "0xF8b7fB38b17a310960E47805Be9adba0b0e0394D",
         POSITION_DELEGATE_REGISTRY: "0x482369De283622E7b05731875ec137d4E3D208F9",
-        POSITION_DELEGATE_REGISTRY_IMPL: "0x301fa9AA527016D033e151b982C64cD8670a39E3",
+        POSITION_DELEGATE_REGISTRY_IMPL: "0xc681c48688cdAA966119E265e4a378ef8Fe0eBcA",
         AGENT_MODULE: "0xefb8C29C1e7e92ed7d81a52dbedaed74e37fe380",
         FEE_RECIPIENT_REGISTRY: "0x95795F8403DDb629E8527B2934C4e71f5fC0C374",
         FEE_RECIPIENT_REGISTRY_IMPL: "0xd08513a7cB2dd354B26cDDf549616F12054c34c9",
@@ -5583,6 +5583,7 @@ __export(src_exports, {
   CacheManager: () => CacheManager,
   ContractManager: () => ContractManager,
   DEFAULT_LIT_NETWORK: () => DEFAULT_LIT_NETWORK,
+  DelegateDenyReason: () => DelegateDenyReason,
   DiamondHandsSDK: () => DiamondHandsSDK,
   ErrorCategory: () => ErrorCategory,
   ErrorSeverity: () => ErrorSeverity,
@@ -5631,6 +5632,7 @@ __export(src_exports, {
   firstSuccess: () => firstSuccess,
   fromPromise: () => fromPromise,
   getContractsByNetwork: () => getContractsByNetwork,
+  getDelegateStatus: () => getDelegateStatus,
   getDeploymentByNetwork: () => getDeploymentByNetwork,
   getPositionDelegate: () => getPositionDelegate,
   isClosePositionAuth: () => isClosePositionAuth,
@@ -5638,6 +5640,7 @@ __export(src_exports, {
   isExtendTermAuth: () => isExtendTermAuth,
   isFailure: () => isFailure,
   isMintUCDAuth: () => isMintUCDAuth,
+  isPositionDelegate: () => isPositionDelegate,
   isRepayDebtAuth: () => isRepayDebtAuth,
   isServiceModeConfig: () => isServiceModeConfig,
   isStandaloneModeConfig: () => isStandaloneModeConfig,
@@ -17922,9 +17925,20 @@ var AgentDelegationRegistry__factory = class extends import_ethers15.ContractFac
 var import_ethers16 = require("ethers");
 var POSITION_DELEGATE_REGISTRY_ABI = [
   "function positionDelegate(bytes32 positionId) view returns (address)",
+  "function isDelegate(bytes32 positionId, address delegate) view returns (bool)",
   "function setPositionDelegate(bytes32 positionId, address newDelegate) external",
   "event PositionDelegateUpdated(bytes32 indexed positionId, address indexed oldDelegate, address indexed newDelegate)"
 ];
+var DelegateDenyReason = /* @__PURE__ */ ((DelegateDenyReason2) => {
+  DelegateDenyReason2[DelegateDenyReason2["NONE"] = 0] = "NONE";
+  DelegateDenyReason2[DelegateDenyReason2["PAUSED"] = 1] = "PAUSED";
+  DelegateDenyReason2[DelegateDenyReason2["NO_DELEGATE"] = 2] = "NO_DELEGATE";
+  DelegateDenyReason2[DelegateDenyReason2["NOT_DELEGATE"] = 3] = "NOT_DELEGATE";
+  return DelegateDenyReason2;
+})(DelegateDenyReason || {});
+var DELEGATE_STATUS_ABI = [
+  "function delegateStatus(bytes32 positionId, address delegate) view returns (bool ok, uint8 reason)"
+];
 async function setPositionDelegate(positionId, delegate, signer, registryAddress) {
   const registry = new import_ethers16.Contract(
     registryAddress,
@@ -17941,6 +17955,28 @@ async function getPositionDelegate(positionId, provider, registryAddress) {
   );
   return registry["positionDelegate"](positionId);
 }
+async function isPositionDelegate(positionId, delegate, provider, registryAddress) {
+  const registry = new import_ethers16.Contract(
+    registryAddress,
+    POSITION_DELEGATE_REGISTRY_ABI,
+    provider
+  );
+  return registry["isDelegate"](positionId, delegate);
+}
+async function getDelegateStatus(positionId, delegate, provider, registryAddress) {
+  const registry = new import_ethers16.Contract(
+    registryAddress,
+    DELEGATE_STATUS_ABI,
+    provider
+  );
+  try {
+    const [ok, reason] = await registry["delegateStatus"](positionId, delegate);
+    return { ok: Boolean(ok), reason: Number(reason) };
+  } catch {
+    const ok = await isPositionDelegate(positionId, delegate, provider, registryAddress);
+    return { ok, reason: ok ? 0 /* NONE */ : 3 /* NOT_DELEGATE */ };
+  }
+}
 
 // src/utils/agent-delegation.utils.ts
 async function mintAgentPkp(params) {
@@ -25917,6 +25953,7 @@ var EventHelpers = {
   CacheManager,
   ContractManager,
   DEFAULT_LIT_NETWORK,
+  DelegateDenyReason,
   DiamondHandsSDK,
   ErrorCategory,
   ErrorSeverity,
@@ -25964,6 +26001,7 @@ var EventHelpers = {
   firstSuccess,
   fromPromise,
   getContractsByNetwork,
+  getDelegateStatus,
   getDeploymentByNetwork,
   getPositionDelegate,
   isClosePositionAuth,
@@ -25971,6 +26009,7 @@ var EventHelpers = {
   isExtendTermAuth,
   isFailure,
   isMintUCDAuth,
+  isPositionDelegate,
   isRepayDebtAuth,
   isServiceModeConfig,
   isStandaloneModeConfig,

package/dist/index.mjs

@@ -352,7 +352,7 @@ var init_deployment_addresses = __esm({
         MOCK_USDC_TOKEN: "0x96409A98e0D322d6566b7F44a0fAbD1BD4ce2AEc",
         MOCK_USDT_TOKEN: "0xF8b7fB38b17a310960E47805Be9adba0b0e0394D",
         POSITION_DELEGATE_REGISTRY: "0x482369De283622E7b05731875ec137d4E3D208F9",
-        POSITION_DELEGATE_REGISTRY_IMPL: "0x301fa9AA527016D033e151b982C64cD8670a39E3",
+        POSITION_DELEGATE_REGISTRY_IMPL: "0xc681c48688cdAA966119E265e4a378ef8Fe0eBcA",
         AGENT_MODULE: "0xefb8C29C1e7e92ed7d81a52dbedaed74e37fe380",
         FEE_RECIPIENT_REGISTRY: "0x95795F8403DDb629E8527B2934C4e71f5fC0C374",
         FEE_RECIPIENT_REGISTRY_IMPL: "0xd08513a7cB2dd354B26cDDf549616F12054c34c9",
@@ -17851,9 +17851,20 @@ var AgentDelegationRegistry__factory = class extends ContractFactory2 {
 import { Contract as Contract8 } from "ethers";
 var POSITION_DELEGATE_REGISTRY_ABI = [
   "function positionDelegate(bytes32 positionId) view returns (address)",
+  "function isDelegate(bytes32 positionId, address delegate) view returns (bool)",
   "function setPositionDelegate(bytes32 positionId, address newDelegate) external",
   "event PositionDelegateUpdated(bytes32 indexed positionId, address indexed oldDelegate, address indexed newDelegate)"
 ];
+var DelegateDenyReason = /* @__PURE__ */ ((DelegateDenyReason2) => {
+  DelegateDenyReason2[DelegateDenyReason2["NONE"] = 0] = "NONE";
+  DelegateDenyReason2[DelegateDenyReason2["PAUSED"] = 1] = "PAUSED";
+  DelegateDenyReason2[DelegateDenyReason2["NO_DELEGATE"] = 2] = "NO_DELEGATE";
+  DelegateDenyReason2[DelegateDenyReason2["NOT_DELEGATE"] = 3] = "NOT_DELEGATE";
+  return DelegateDenyReason2;
+})(DelegateDenyReason || {});
+var DELEGATE_STATUS_ABI = [
+  "function delegateStatus(bytes32 positionId, address delegate) view returns (bool ok, uint8 reason)"
+];
 async function setPositionDelegate(positionId, delegate, signer, registryAddress) {
   const registry = new Contract8(
     registryAddress,
@@ -17870,6 +17881,28 @@ async function getPositionDelegate(positionId, provider, registryAddress) {
   );
   return registry["positionDelegate"](positionId);
 }
+async function isPositionDelegate(positionId, delegate, provider, registryAddress) {
+  const registry = new Contract8(
+    registryAddress,
+    POSITION_DELEGATE_REGISTRY_ABI,
+    provider
+  );
+  return registry["isDelegate"](positionId, delegate);
+}
+async function getDelegateStatus(positionId, delegate, provider, registryAddress) {
+  const registry = new Contract8(
+    registryAddress,
+    DELEGATE_STATUS_ABI,
+    provider
+  );
+  try {
+    const [ok, reason] = await registry["delegateStatus"](positionId, delegate);
+    return { ok: Boolean(ok), reason: Number(reason) };
+  } catch {
+    const ok = await isPositionDelegate(positionId, delegate, provider, registryAddress);
+    return { ok, reason: ok ? 0 /* NONE */ : 3 /* NOT_DELEGATE */ };
+  }
+}
 
 // src/utils/agent-delegation.utils.ts
 async function mintAgentPkp(params) {
@@ -25845,6 +25878,7 @@ export {
   CacheManager,
   ContractManager,
   DEFAULT_LIT_NETWORK,
+  DelegateDenyReason,
   DiamondHandsSDK,
   ErrorCategory,
   ErrorSeverity,
@@ -25893,6 +25927,7 @@ export {
   firstSuccess,
   fromPromise,
   getContractsByNetwork,
+  getDelegateStatus,
   getDeploymentByNetwork,
   getPositionDelegate,
   isClosePositionAuth,
@@ -25900,6 +25935,7 @@ export {
   isExtendTermAuth,
   isFailure,
   isMintUCDAuth,
+  isPositionDelegate,
   isRepayDebtAuth,
   isServiceModeConfig,
   isStandaloneModeConfig,

package/dist/utils/position-delegate.utils.d.ts

@@ -12,6 +12,13 @@
  * and cannot carry the additional storage + setter without going over.
  */
 import { type Signer, type Provider, type TransactionResponse } from "ethers";
+/** Registry v2.0.0 `delegateStatus` deny reasons. */
+export declare enum DelegateDenyReason {
+    NONE = 0,
+    PAUSED = 1,
+    NO_DELEGATE = 2,
+    NOT_DELEGATE = 3
+}
 /**
  * Register (or revoke) the off-chain authorization delegate for a position.
  *
@@ -30,6 +37,15 @@ export declare function setPositionDelegate(positionId: string, delegate: string
 /**
  * Read the currently registered delegate for a position.
  *
+ * PROVENANCE ONLY — do NOT use this to make an authorization decision. This reads the raw
+ * `positionDelegate` mapping, which is a public getter and therefore CANNOT reflect the
+ * registry's pause kill-switch or its revoked-address burn set: it will happily return a
+ * delegate the registry itself denies. Use {@link isPositionDelegate} for any
+ * "may this address act?" question.
+ *
+ * Legitimate uses: displaying who is configured, and the idempotence check before
+ * `setPositionDelegate` (both care about what is stored, not whether it is currently usable).
+ *
  * Returns the zero address when no delegate has been registered. Pure view;
  * any provider works (signer not required).
  *
@@ -39,3 +55,33 @@ export declare function setPositionDelegate(positionId: string, delegate: string
  * @returns The delegate EOA, or zero address if none.
  */
 export declare function getPositionDelegate(positionId: string, provider: Provider | Signer, registryAddress: string): Promise<string>;
+/**
+ * THE authorization read: may `delegate` act for `positionId` right now?
+ *
+ * Calls the registry's `isDelegate` gate, which folds in the pause kill-switch and the
+ * permanent burn set — unlike {@link getPositionDelegate}, which reads the ungated mapping.
+ *
+ * Version-agnostic by construction: `isDelegate` has existed since registry v1.1.0 with this
+ * exact `(bytes32,address) returns (bool)` signature, so the selector is identical across
+ * versions. v2.0.0 only makes it strictly MORE restrictive (additionally denying when paused
+ * or burned), never more permissive — so this is safe against an un-upgraded registry too.
+ *
+ * @param positionId Position identifier (bytes32).
+ * @param delegate Candidate delegate address.
+ * @param provider Ethers provider or signer.
+ * @param registryAddress Deployed `PositionDelegateRegistry` address.
+ */
+export declare function isPositionDelegate(positionId: string, delegate: string, provider: Provider | Signer, registryAddress: string): Promise<boolean>;
+/**
+ * Same gate as {@link isPositionDelegate} but returns WHY it was denied, so a UI can say
+ * "delegation is paused" instead of the misleading "no delegate configured".
+ *
+ * `delegateStatus` is a v2.0.0-only selector. On an older registry the call reverts, and this
+ * falls back to `isDelegate` — a clean feature-detect, which is exactly why the reason was added
+ * as a NEW function rather than by changing `isDelegate`'s return type (that would have been a
+ * silent decode hazard across versions, since the selector would not have changed).
+ */
+export declare function getDelegateStatus(positionId: string, delegate: string, provider: Provider | Signer, registryAddress: string): Promise<{
+    ok: boolean;
+    reason: DelegateDenyReason;
+}>;

package/package.json

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