@gvnrdao/dh-sdk 0.0.312 → 0.0.313

package/dist/interfaces/chunks/config.i.d.ts

@@ -37,6 +37,10 @@ export interface ContractAddresses {
     positionDelegateRegistry?: string;
     /** BitcoinWithdrawalAddressRegistry proxy; per-wallet allowlist that gates borrower-initiated BTC withdrawal destinations (24h time-lock). */
     bitcoinWithdrawalAddressRegistry?: string;
+    /** AgentDelegationRegistry proxy; protocol agent-delegation policy layer (MVP: auto-renew). Sepolia only. */
+    agentDelegationRegistry?: string;
+    /** DHAgentDelegate; EIP-7702 execution adapter (Gate 2) the borrower EOA delegates to. Sepolia only. */
+    dhAgentDelegate?: string;
     mockUsdcToken?: string;
     mockUsdcOwner?: string;
     mockUsdtToken?: string;

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

@@ -887,6 +887,42 @@ export declare class DiamondHandsSDK {
      * @param options - Override timeout/interval for this call
      * @throws if timeout is reached before subgraph catches up
      */
+    /** Guard: the AgentDelegationRegistry MVP is deployed on Sepolia only. */
+    private assertAgentDelegationSepolia;
+    /**
+     * Read a position's auto-renew delegation state (used to drive the Enable/Disable toggle).
+     * Pure view — no signer required.
+     */
+    getAutoRenewStatus(positionId: string, user?: string): Promise<{
+        enabled: boolean;
+        borrower: string;
+        maxRenewals: number;
+        renewalsUsed: number;
+        agentActive: boolean | null;
+        canRenew: {
+            ok: boolean;
+            reason: number;
+        } | null;
+    }>;
+    /**
+     * Enable auto-renew delegation for a position. Orchestrates the first-time setup: if the
+     * borrower has no active agent, mints a fresh per-user agent PKP (via lit-ops-server) and
+     * registers it, then records the position's renew grant. Borrower-signed.
+     */
+    enableAutoRenew(positionId: string, options?: {
+        maxRenewals?: number;
+        maxEndTimestamp?: number;
+        agentValiditySeconds?: number;
+    }): Promise<{
+        hash: string;
+        blockNumber: number;
+        agentAddress?: string;
+    }>;
+    /** Disable auto-renew delegation for a position (clears the grant). Borrower-signed. */
+    disableAutoRenew(positionId: string): Promise<{
+        hash: string;
+        blockNumber: number;
+    }>;
     /**
      * Get Bitcoin balance for an address
      *

package/dist/modules/loan/loan-creator.module.d.ts

@@ -46,6 +46,15 @@ export interface LoanCreatorConfig {
     debug?: boolean;
     /** Transaction timeout (ms) */
     transactionTimeoutMs?: number;
+    /**
+     * Confirmations to wait for before trusting the `positionId` read from a
+     * createPosition receipt. Defaults to 1 on local chains and 3 elsewhere.
+     *
+     * `positionId` is derived on-chain from `block.timestamp` and a global counter, so a
+     * reorg re-executes the same transaction into a different id. Raise this on chains
+     * with deep reorgs; it trades loan-creation latency for id stability.
+     */
+    createPositionConfirmations?: number;
     /** Validator version for loan creation (createPosition) - REQUIRED */
     loanCreationValidatorVersion: number;
     /** EVM JSON-RPC URL for service-mode PKP flow (forwards to lit-ops-server) */
@@ -117,6 +126,23 @@ export declare class LoanCreator {
      * Step 3: Submit loan creation transaction
      */
     private submitLoanCreation;
+    /**
+     * Confirmation depth to wait for before trusting `positionId` from a receipt.
+     *
+     * Deeper is safer but slower, so local chains (instant mining, no reorgs) stay at 1.
+     * Override with `createPositionConfirmations` when a chain needs more.
+     */
+    private createPositionConfirmations;
+    /**
+     * Re-read the receipt after confirmations and re-derive `positionId`, so a reorg
+     * cannot leave the caller holding an id that never survived to the canonical chain.
+     *
+     * Returns the authoritative id. If the re-read disagrees with what was first
+     * extracted, the fresh value wins and the divergence is logged loudly — silently
+     * returning a phantom id is how this surfaced as a `PositionNotFound()` hundreds of
+     * lines downstream, long after the real cause.
+     */
+    private confirmPositionId;
     /**
      * Extract position ID from transaction receipt
      */

package/dist/utils/agent-delegation.utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agent-delegation service helpers (auto-renew MVP).
+ *
+ * Kept separate from the generic `PKPManager` so that module stays focused on PKP lifecycle —
+ * this file owns the feature-specific orchestration (the lit-ops-server mint-agent endpoint).
+ */
+/**
+ * Mint a fresh per-user AGENT PKP via lit-ops-server and return its Ethereum address, to be
+ * registered as the renewal agent in `AgentDelegationRegistry`. Each call yields a unique
+ * address (satisfies the registry's AR-1 non-reuse). Throws on failure.
+ *
+ * @param serviceEndpoint lit-ops-server base URL (the SDK's `serviceEndpoint`).
+ * @param authHeader      Optional async/sync provider of auth headers (the SDK's session token).
+ * @param timeoutMs       Request timeout (default 30s).
+ */
+export declare function mintAgentPkp(params: {
+    serviceEndpoint: string;
+    authHeader?: () => Promise<Record<string, string>> | Record<string, string>;
+    timeoutMs?: number;
+}): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gvnrdao/dh-sdk",
-  "version": "0.0.312",
+  "version": "0.0.313",
   "description": "TypeScript SDK for Diamond Hands Protocol - Bitcoin-backed lending with LIT Protocol PKPs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -82,8 +82,8 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@gvnrdao/dh-lit-actions": "^0.0.316",
-    "@gvnrdao/dh-lit-ops": "^0.0.307",
+    "@gvnrdao/dh-lit-actions": "^0.0.317",
+    "@gvnrdao/dh-lit-ops": "^0.0.308",
     "@noble/hashes": "^1.5.0",
     "axios": "^1.17.0",
     "bech32": "^2.0.0",