@gvnrdao/dh-sdk 0.0.327 → 0.0.329

package/dist/deployments.js

@@ -521,6 +521,14 @@ var MAINNET_DEPLOYMENT = {
       reason: "2026-08 agent-stack release. The mainnet PositionManagerViews at 0x9225647a was deployed as a BARE implementation (EIP-1967 slot 0x00), so upgradeToAndCall reverts UUPSUnauthorizedCallContext \u2014 it could never be upgraded. PositionManager.setViews (added in the same Execute B batch) removed the repoint blocker, so Views was replaced behind a new proxy rather than upgraded. This makes the Pashov F3 renewal debt-ceiling check REACHABLE for the first time: ExceedsMaxLoan (0x499e7985) is present in 0xE68DC096 and absent from 0x9225647a. Views holds no protocol state (8 wiring slots + roles + pause), which is what made replacement safe. The old contract is ABANDONED, not decommissioned \u2014 it stays live and callable as the rollback target for setViews. NOTE: VERSION reads 1.1.1 on both sides; verify by address.",
       executeTx: "0xf1f8d5fc13f45d7a3f932bf1a2d6e29381fdd41cd31298ad785bf7688df07fe6",
       block: 25673200
+    },
+    AgentDelegationRegistry: {
+      newImplementation: "0xa9fF405Edd4329fc3159a64F56B37EBD253e4928",
+      upgradedAt: "2026-07-31T22:03:35.000Z",
+      upgradedBy: "AdminModule/Safe audit-batch upgradeToAndCall; executed by 0xEba7BfAeB35ee18408b424Ee0BB45AdDf776589f in tx 0x8fed0ab7eee3aaaa3792a35b40b0ef74bd09cfb1a175934afd846bee546048d4 (block 25655710)",
+      reason: "Reconciled from chain \u2014 mainnet audit rollout batch (cross-ref onchain-auth/.safe-batches/mainnet-audit-execute.json)",
+      executeTx: "0x8fed0ab7eee3aaaa3792a35b40b0ef74bd09cfb1a175934afd846bee546048d4",
+      block: 25655710
     }
   },
   latestEnv: {

package/dist/deployments.mjs

@@ -488,6 +488,14 @@ var MAINNET_DEPLOYMENT = {
       reason: "2026-08 agent-stack release. The mainnet PositionManagerViews at 0x9225647a was deployed as a BARE implementation (EIP-1967 slot 0x00), so upgradeToAndCall reverts UUPSUnauthorizedCallContext \u2014 it could never be upgraded. PositionManager.setViews (added in the same Execute B batch) removed the repoint blocker, so Views was replaced behind a new proxy rather than upgraded. This makes the Pashov F3 renewal debt-ceiling check REACHABLE for the first time: ExceedsMaxLoan (0x499e7985) is present in 0xE68DC096 and absent from 0x9225647a. Views holds no protocol state (8 wiring slots + roles + pause), which is what made replacement safe. The old contract is ABANDONED, not decommissioned \u2014 it stays live and callable as the rollback target for setViews. NOTE: VERSION reads 1.1.1 on both sides; verify by address.",
       executeTx: "0xf1f8d5fc13f45d7a3f932bf1a2d6e29381fdd41cd31298ad785bf7688df07fe6",
       block: 25673200
+    },
+    AgentDelegationRegistry: {
+      newImplementation: "0xa9fF405Edd4329fc3159a64F56B37EBD253e4928",
+      upgradedAt: "2026-07-31T22:03:35.000Z",
+      upgradedBy: "AdminModule/Safe audit-batch upgradeToAndCall; executed by 0xEba7BfAeB35ee18408b424Ee0BB45AdDf776589f in tx 0x8fed0ab7eee3aaaa3792a35b40b0ef74bd09cfb1a175934afd846bee546048d4 (block 25655710)",
+      reason: "Reconciled from chain \u2014 mainnet audit rollout batch (cross-ref onchain-auth/.safe-batches/mainnet-audit-execute.json)",
+      executeTx: "0x8fed0ab7eee3aaaa3792a35b40b0ef74bd09cfb1a175934afd846bee546048d4",
+      block: 25655710
     }
   },
   latestEnv: {

package/dist/graphs/diamond-hands.d.ts

@@ -86,6 +86,174 @@ export interface UserRateLimitData {
     nextResetBlock: string;
     lastUpdated: string;
 }
+export interface LoanEventsQueryResponse {
+    position: {
+        id: string;
+        payments?: Array<{
+            id: string;
+            payer: {
+                id: string;
+            };
+            amount: string;
+            type: string;
+            transactionHash: string;
+            timestamp: string;
+            blockNumber: string;
+            logIndex: string;
+            newDebt: string;
+            newCollateralRatio: string;
+        }>;
+        statusUpdates?: Array<{
+            id: string;
+            oldStatus: string;
+            newStatus: string;
+            reason?: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+        }>;
+        liquidation?: {
+            id: string;
+            liquidator: string;
+            liquidatedAmount: string;
+            collateralSeized: string;
+            transactionHash: string;
+            timestamp: string;
+            blockNumber: string;
+            commitHash?: string;
+            commitTimestamp?: string;
+            revealDelay?: string;
+        };
+        withdrawals?: Array<{
+            id: string;
+            withdrawalAmount: string;
+            withdrawalAddress: string;
+            networkFee?: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+            logIndex: string;
+        }>;
+        renewals?: Array<{
+            id: string;
+            extensionTerm: string;
+            extensionFee: string;
+            newExpiryDate: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+            logIndex: string;
+        }>;
+        operationFailures?: Array<{
+            id: string;
+            operationType: string;
+            reason: string;
+            errorCode?: string;
+            amount?: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+            logIndex: string;
+        }>;
+        mintRequests?: Array<{
+            id: string;
+            pkpId: string;
+            borrower: {
+                id: string;
+            };
+            mintAmount: string;
+            originationFee: string;
+            newDebt: string;
+            newCollateralRatio: string;
+            btcPrice: string;
+            quantumTimestamp: string;
+            opId: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+            logIndex: string;
+        }>;
+        burnRequests?: Array<{
+            id: string;
+            pkpId: string;
+            borrower: {
+                id: string;
+            };
+            burnAmount: string;
+            remainingDebt: string;
+            newCollateralRatio: string;
+            opId: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+            logIndex: string;
+        }>;
+        mintingFees?: Array<{
+            id: string;
+            borrower: {
+                id: string;
+            };
+            feeAmount: string;
+            mintAmount: string;
+            newDebt: string;
+            btcPrice: string;
+            quantumTimestamp: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+            logIndex: string;
+        }>;
+        renewalFees?: Array<{
+            id: string;
+            borrower: {
+                id: string;
+            };
+            feeAmount: string;
+            extensionTerm: string;
+            newExpiryDate: string;
+            timestamp: string;
+            blockNumber: string;
+            transactionHash: string;
+            logIndex: string;
+        }>;
+    };
+    positionCreatedEvents?: Array<{
+        id: string;
+        pkpId: string;
+        borrower: {
+            id: string;
+        };
+        requestedCollateralRatio: string;
+        selectedTerm: string;
+        expiryAt: string;
+        timestamp: string;
+        blockNumber: string;
+        transactionHash: string;
+    }>;
+    ucdmintEvents?: Array<{
+        id: string;
+        amount: string;
+        proof: string;
+        minter: {
+            id: string;
+        };
+        isCommunityMint: boolean;
+        timestamp: string;
+        blockNumber: string;
+        transactionHash: string;
+    }>;
+    collateralEvents?: Array<{
+        id: string;
+        eventType: string;
+        networkFee?: string;
+        remainingCollateral?: string;
+        collateralRatio?: string;
+        timestamp: string;
+        blockNumber: string;
+        transactionHash: string;
+        logIndex: string;
+    }>;
+}
 export declare class DiamondHandsGraph {
     private client;
     private defaultPageSize;
@@ -115,6 +283,15 @@ export declare class DiamondHandsGraph {
     /**
      * Get user positions from subgraph
      */
+    private getUserPositionsOnly;
+    /**
+     * Get user positions, plus an accurate total count.
+     *
+     * The count is a SECOND round trip (`getTotalCountPaginated`, which pages to handle
+     * >1000 items). Callers that only need the rows should use `getUserPositionsOnly` and
+     * skip it — the event paths did not, and paid for a count they immediately discarded on
+     * every activity refresh.
+     */
     getUserPositions(userAddress: string, first?: number, skip?: number, orderBy?: string, orderDirection?: string): Promise<{
         positions: LoanData[];
         total: number;
@@ -262,6 +439,14 @@ export declare class DiamondHandsGraph {
      * @returns Complete event history for the position
      */
     getLoanEvents(positionId: string, filter?: LoanEventsFilter): Promise<LoanEvents>;
+    /**
+     * Map one position's raw event payload into `LoanEvents`.
+     *
+     * Extracted verbatim from getLoanEvents so the wallet-collapsed path produces
+     * byte-identical objects by construction rather than by a second implementation
+     * that has to be kept in step by hand.
+     */
+    private assembleLoanEvents;
     /**
      * Get the full loan-event history for every position owned by a wallet.
      *
@@ -280,6 +465,31 @@ export declare class DiamondHandsGraph {
      * @returns One LoanEvents object per position; empty array if the wallet has none.
      */
     getWalletLoanEvents(userAddress: string, filter?: LoanEventsFilter): Promise<LoanEvents[]>;
+    /**
+     * The per-position path: enumerate the wallet's positions, then one `GetLoanEvents` each.
+     *
+     * Used for filtered calls, and as the completeness fallback when the collapsed document
+     * hits a page limit. Costs `1 + N` requests, which is exactly why it is not the default.
+     */
+    private getWalletLoanEventsFanout;
+    /**
+     * The whole wallet's event history in ONE request.
+     *
+     * Replaces `1 + N` round trips (one position enumeration plus one per position) with a
+     * single document. Measured on Sepolia: a wallet holding 44 positions cost 46 requests
+     * per activity refresh against a per-wallet budget of 30/min — this makes it 1.
+     *
+     * Three subgraph facts make it possible, all verified against the deployed schema rather
+     * than assumed:
+     *   - ten event collections are `@derivedFrom` on Position, so they nest under a
+     *     borrower-filtered `positions(...)`;
+     *   - `positionCreatedEvents` is ALSO derived on Position — `getLoanEvents` queries it
+     *     top-level, which it never needed to;
+     *   - `ucdmintEvents` / `collateralEvents` are not derived and carry no `borrower`
+     *     field, but graph-node's nested `position_: { borrower }` filter reaches them.
+     *     Without that last one this would be two requests, not one.
+     */
+    private getWalletLoanEventsCollapsed;
     /**
      * Retrieve events across the full protocol, optionally narrowed to a position.
      * Returns a merged, sorted discriminated-union timeline suitable for explorers.