@gvnrdao/dh-sdk 0.0.288 → 0.0.289

package/dist/deployments.js

@@ -428,68 +428,44 @@ var MAINNET_CONTRACTS = {
 var LOCALHOST_DEPLOYMENT = {
   network: "localhost",
   chainId: 31337,
-  timestamp: "2026-06-11T12:30:59.589Z",
+  timestamp: "2026-03-23T15:33:34.068Z",
   deployer: "",
   contracts: {
-    MessageHashBuilder: "0x1613beB3B2C4f22Ee086B2b38C1476A3cE7f78E8",
-    UpgradeValidator: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+    MessageHashBuilder: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+    UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
     UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
     UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-    PositionManagerCoreModule: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-    TermManagerModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-    LoanOperationsManagerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+    PositionManagerCoreModule: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+    TermManagerModule: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+    LoanOperationsManagerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
     BTCSpendAuthorizer: "0x59b670e9fA9D0A427751Af201D676719a970857b",
     CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
     LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-    CircuitBreakerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+    CircuitBreakerModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
     AdminModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-    PositionManagerViews: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-    PositionManager: "0xf5059a5D33d5853360D16C683c16e67980206f36",
-    OperationAuthorizationRegistry: "0xF8e31cb472bc70500f08Cd84917E5A1912Ec8397",
-    PKPValidation: "0xc0F115A19107322cFBf1cDBC7ea011C19EbDB4F8"
-  },
-  latestEnv: {
-    UCD_TOKEN: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
-    UCD_CONTROLLER: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-    POSITION_MANAGER: "0xf5059a5D33d5853360D16C683c16e67980206f36",
-    PKP_VALIDATION_REGISTRY: "0xc0F115A19107322cFBf1cDBC7ea011C19EbDB4F8",
-    PKP_VALIDATION_CID_V1: "0x122052091400dec1612605e0b92f973e7dd35c2d0c05e2d39c2168e158ceaa9beac7",
-    PKP_VALIDATION_CID_V3: "0x122052091400dec1612605e0b92f973e7dd35c2d0c05e2d39c2168e158ceaa9beac7",
-    PKP_ETH_ADDRESS: "0x9eE56687F7a984D5DF7aB79330271a619ef56DdD",
-    OPERATION_AUTHORIZATION_REGISTRY: "0xF8e31cb472bc70500f08Cd84917E5A1912Ec8397",
-    UCD_MINT_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    UCD_MINT_VALIDATOR_VERSION: 1,
-    BTC_WITHDRAWAL_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    BTC_WITHDRAWAL_VALIDATOR_VERSION: 1,
-    UPDATE_BALANCE_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    UPDATE_BALANCE_VALIDATOR_VERSION: 1,
-    PROCESS_PAYMENT_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    PROCESS_PAYMENT_VALIDATOR_VERSION: 1,
-    EXTEND_POSITION_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    EXTEND_POSITION_VALIDATOR_VERSION: 1,
-    POSITION_MANAGER_CORE_MODULE: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-    LOAN_OPERATIONS_MANAGER_MODULE: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
-    TERM_MANAGER_MODULE: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-    COMMUNITY_MANAGER_MODULE: ""
+    PositionManagerViews: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+    PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
+    OperationAuthorizationRegistry: "0x7969c5eD335650692Bc04293B07F5BF2e7A673C0",
+    PKPValidation: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc"
   }
 };
 var LOCALHOST_CONTRACTS = {
-  MessageHashBuilder: "0x1613beB3B2C4f22Ee086B2b38C1476A3cE7f78E8",
-  UpgradeValidator: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+  MessageHashBuilder: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+  UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
   UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
   UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-  PositionManagerCoreModule: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-  TermManagerModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-  LoanOperationsManagerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+  PositionManagerCoreModule: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+  TermManagerModule: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+  LoanOperationsManagerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
   BTCSpendAuthorizer: "0x59b670e9fA9D0A427751Af201D676719a970857b",
   CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
   LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-  CircuitBreakerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+  CircuitBreakerModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
   AdminModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-  PositionManagerViews: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-  PositionManager: "0xf5059a5D33d5853360D16C683c16e67980206f36",
-  OperationAuthorizationRegistry: "0xF8e31cb472bc70500f08Cd84917E5A1912Ec8397",
-  PKPValidation: "0xc0F115A19107322cFBf1cDBC7ea011C19EbDB4F8"
+  PositionManagerViews: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+  PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
+  OperationAuthorizationRegistry: "0x7969c5eD335650692Bc04293B07F5BF2e7A673C0",
+  PKPValidation: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc"
 };
 var ALL_DEPLOYMENTS = {
   sepolia: SEPOLIA_DEPLOYMENT,

package/dist/deployments.mjs

@@ -395,68 +395,44 @@ var MAINNET_CONTRACTS = {
 var LOCALHOST_DEPLOYMENT = {
   network: "localhost",
   chainId: 31337,
-  timestamp: "2026-06-11T12:30:59.589Z",
+  timestamp: "2026-03-23T15:33:34.068Z",
   deployer: "",
   contracts: {
-    MessageHashBuilder: "0x1613beB3B2C4f22Ee086B2b38C1476A3cE7f78E8",
-    UpgradeValidator: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+    MessageHashBuilder: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+    UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
     UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
     UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-    PositionManagerCoreModule: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-    TermManagerModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-    LoanOperationsManagerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+    PositionManagerCoreModule: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+    TermManagerModule: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+    LoanOperationsManagerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
     BTCSpendAuthorizer: "0x59b670e9fA9D0A427751Af201D676719a970857b",
     CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
     LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-    CircuitBreakerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+    CircuitBreakerModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
     AdminModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-    PositionManagerViews: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-    PositionManager: "0xf5059a5D33d5853360D16C683c16e67980206f36",
-    OperationAuthorizationRegistry: "0xF8e31cb472bc70500f08Cd84917E5A1912Ec8397",
-    PKPValidation: "0xc0F115A19107322cFBf1cDBC7ea011C19EbDB4F8"
-  },
-  latestEnv: {
-    UCD_TOKEN: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
-    UCD_CONTROLLER: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-    POSITION_MANAGER: "0xf5059a5D33d5853360D16C683c16e67980206f36",
-    PKP_VALIDATION_REGISTRY: "0xc0F115A19107322cFBf1cDBC7ea011C19EbDB4F8",
-    PKP_VALIDATION_CID_V1: "0x122052091400dec1612605e0b92f973e7dd35c2d0c05e2d39c2168e158ceaa9beac7",
-    PKP_VALIDATION_CID_V3: "0x122052091400dec1612605e0b92f973e7dd35c2d0c05e2d39c2168e158ceaa9beac7",
-    PKP_ETH_ADDRESS: "0x9eE56687F7a984D5DF7aB79330271a619ef56DdD",
-    OPERATION_AUTHORIZATION_REGISTRY: "0xF8e31cb472bc70500f08Cd84917E5A1912Ec8397",
-    UCD_MINT_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    UCD_MINT_VALIDATOR_VERSION: 1,
-    BTC_WITHDRAWAL_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    BTC_WITHDRAWAL_VALIDATOR_VERSION: 1,
-    UPDATE_BALANCE_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    UPDATE_BALANCE_VALIDATOR_VERSION: 1,
-    PROCESS_PAYMENT_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    PROCESS_PAYMENT_VALIDATOR_VERSION: 1,
-    EXTEND_POSITION_VALIDATOR_ADDRESS: "0x82db9f515957aa380b596c6ea2bd30cef181f236",
-    EXTEND_POSITION_VALIDATOR_VERSION: 1,
-    POSITION_MANAGER_CORE_MODULE: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-    LOAN_OPERATIONS_MANAGER_MODULE: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
-    TERM_MANAGER_MODULE: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-    COMMUNITY_MANAGER_MODULE: ""
+    PositionManagerViews: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+    PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
+    OperationAuthorizationRegistry: "0x7969c5eD335650692Bc04293B07F5BF2e7A673C0",
+    PKPValidation: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc"
   }
 };
 var LOCALHOST_CONTRACTS = {
-  MessageHashBuilder: "0x1613beB3B2C4f22Ee086B2b38C1476A3cE7f78E8",
-  UpgradeValidator: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+  MessageHashBuilder: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+  UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
   UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
   UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-  PositionManagerCoreModule: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-  TermManagerModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-  LoanOperationsManagerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+  PositionManagerCoreModule: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+  TermManagerModule: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+  LoanOperationsManagerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
   BTCSpendAuthorizer: "0x59b670e9fA9D0A427751Af201D676719a970857b",
   CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
   LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-  CircuitBreakerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+  CircuitBreakerModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
   AdminModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-  PositionManagerViews: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-  PositionManager: "0xf5059a5D33d5853360D16C683c16e67980206f36",
-  OperationAuthorizationRegistry: "0xF8e31cb472bc70500f08Cd84917E5A1912Ec8397",
-  PKPValidation: "0xc0F115A19107322cFBf1cDBC7ea011C19EbDB4F8"
+  PositionManagerViews: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+  PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
+  OperationAuthorizationRegistry: "0x7969c5eD335650692Bc04293B07F5BF2e7A673C0",
+  PKPValidation: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc"
 };
 var ALL_DEPLOYMENTS = {
   sepolia: SEPOLIA_DEPLOYMENT,

package/dist/graphs/client.d.ts

@@ -0,0 +1,22 @@
+export interface GraphClientConfig {
+    endpoint: string;
+    requestTimeoutMs?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+    /** Optional async supplier for per-request headers (e.g. session JWT). */
+    getHeaders?: () => Promise<Record<string, string>>;
+}
+export declare class GraphClient {
+    private endpoint;
+    private requestTimeoutMs;
+    private maxRetries;
+    private headers?;
+    private getHeadersFn?;
+    constructor(config: GraphClientConfig);
+    execute<T>(query: string, variables?: Record<string, any>): Promise<T>;
+    paginate<TItem>(query: string, variables: Record<string, any>, select: (page: any) => TItem[], options?: {
+        pageSize?: number;
+        maxPages?: number;
+    }): Promise<TItem[]>;
+    private backoff;
+}

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

@@ -0,0 +1,259 @@
+import type { ProtocolEventsFilter, ProtocolEventsResult } from "../types/protocol-event-types";
+import type { LoanData } from "../interfaces";
+import type { GraphPositionWithBorrowerDTO } from "../types/graph-dtos";
+import type { LoanEvents, LoanEventsFilter } from "../types/event-types";
+import type { BitcoinOperations, EnrichedBitcoinBalance } from "../modules/bitcoin/bitcoin-operations.module";
+export interface DiamondHandsGraphConfig {
+    endpoint: string;
+    requestTimeoutMs?: number;
+    maxRetries?: number;
+    defaultPageSize?: number;
+    headers?: Record<string, string>;
+    /** Optional async supplier for per-request headers (e.g. session JWT). */
+    getHeaders?: () => Promise<Record<string, string>>;
+}
+export interface UserData {
+    id: string;
+    positions: LoanData[];
+    totalBorrowed: string;
+    totalRepaid: string;
+    activePositions: string;
+    firstInteractionTimestamp: string;
+    lastInteractionTimestamp: string;
+}
+export interface LoanTermData {
+    id: string;
+    months: string;
+    mintFeeBps?: string;
+    extensionFeeBps?: string;
+    isValid?: boolean;
+    createdAt?: string;
+    createdAtBlock?: string;
+}
+export interface PSMConfigurationData {
+    id: string;
+    version: string;
+    redeemEnabled: boolean;
+    totalSwapVolume: string;
+    totalRedeemVolume: string;
+    supportedStablecoinsCount: string;
+    lastUpdated: string;
+}
+export interface SupportedStablecoinData {
+    id: string;
+    address: string;
+    isSupported: boolean;
+    exchangeRate: string;
+    entryFee: string;
+    exitFee: string;
+    reserves: string;
+    decimals: string;
+    totalSwapVolume: string;
+    totalRedeemVolume: string;
+    swapCount: string;
+    redeemCount: string;
+    addedAt: string;
+    lastUpdated: string;
+}
+export interface PSMTransactionData {
+    id: string;
+    type: string;
+    user: string;
+    stablecoin: SupportedStablecoinData;
+    stablecoinAmount: string;
+    ucdAmount: string;
+    fee: string;
+    effectiveRate: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+}
+export interface UserRateLimitData {
+    id: string;
+    user: string;
+    stablecoin: SupportedStablecoinData;
+    lastOperationBlock: string;
+    operationCount: string;
+    isCurrentlyLimited: boolean;
+    nextResetBlock: string;
+    lastUpdated: string;
+}
+export declare class DiamondHandsGraph {
+    private client;
+    private defaultPageSize;
+    private bitcoinOps?;
+    constructor(config: DiamondHandsGraphConfig, bitcoinOps?: BitcoinOperations);
+    /**
+     * Transform graph position data to LoanData interface
+     * Converts flat graph structure to nested LoanData structure
+     */
+    private transformGraphPositionToLoanData;
+    /**
+     * Helper: Get total count by paginating through all results
+     * The Graph has a hard limit of 1000 items per query, so we need to paginate
+     *
+     * NOTE: This implementation fetches minimal data (just IDs) for counting.
+     * The Graph protocol does not currently support count-only aggregation queries,
+     * so this batching approach is optimal for total count determination.
+     * Future optimization: If The Graph adds support for aggregate functions
+     * (e.g., `positions_aggregate { count }`), this should be updated.
+     *
+     * @param entityName The GraphQL entity name (e.g., "positions", "users")
+     * @param whereClause Optional GraphQL where clause (e.g., "{ borrower: $borrower }")
+     * @param variables Optional variables for the where clause
+     * @returns Total count of items
+     */
+    private getTotalCountPaginated;
+    /**
+     * Get user positions from subgraph
+     */
+    getUserPositions(userAddress: string, first?: number, skip?: number, orderBy?: string, orderDirection?: string): Promise<{
+        positions: LoanData[];
+        total: number;
+    }>;
+    /**
+     * Get user positions with enriched Bitcoin balance data
+     *
+     * Same as getUserPositions but queries actual BTC balance from Bitcoin network
+     * for each vault address in parallel.
+     *
+     * @param userAddress - User's Ethereum address
+     * @param first - Optional: max number of positions to return (default: 10)
+     * @param skip - Optional: number of positions to skip (default: 0)
+     * @param orderBy - Optional: field to order by (default: "createdAt")
+     * @param orderDirection - Optional: asc or desc (default: "desc" - most recent first)
+     * @returns Positions with actual BTC balances from Bitcoin network
+     */
+    getUserPositionsWithBtc(userAddress: string, first?: number, skip?: number, orderBy?: string, orderDirection?: "asc" | "desc"): Promise<{
+        positions: (LoanData & {
+            btcBalance?: EnrichedBitcoinBalance;
+        })[];
+        total: number;
+    }>;
+    /**
+     * Get position by PKP ID from subgraph
+     */
+    getPositionByPKP(pkpId: string): Promise<LoanData | null>;
+    /**
+     * Get detailed position data by PKP ID from subgraph
+     */
+    getDetailedPositionByPkpId(pkpId: string): Promise<any | null>;
+    /**
+     * Get detailed position data by position ID from subgraph
+     */
+    getDetailedPositionById(positionId: string): Promise<GraphPositionWithBorrowerDTO | null>;
+    /**
+     * Get all positions with pagination
+     */
+    getAllPositions(options?: {
+        pageSize?: number;
+        maxPages?: number;
+    }): Promise<LoanData[]>;
+    /**
+     * Get all positions directly (simple query with pagination support)
+     */
+    getPositions(first?: number, orderBy?: string, orderDirection?: "asc" | "desc", skip?: number, includeTotalCount?: boolean): Promise<{
+        positions: LoanData[];
+        total: number;
+    }>;
+    /**
+     * Get positions filtered by an array of statuses
+     */
+    getPositionsByStatus(statuses: string[], first?: number, orderBy?: string, orderDirection?: "asc" | "desc", skip?: number): Promise<{
+        positions: LoanData[];
+        total: number;
+    }>;
+    /**
+     * Get active positions only
+     */
+    getActivePositions(options?: {
+        pageSize?: number;
+        maxPages?: number;
+    }): Promise<LoanData[]>;
+    /**
+     * Get protocol statistics
+     */
+    getProtocolStats(): Promise<{
+        totalValueLocked: string;
+        totalBorrowed: string;
+        totalRepaid: string;
+        totalLiquidated: string;
+        totalPositions: string;
+        activePositions: string;
+        totalUsers: string;
+    } | null>;
+    /**
+     * Health check for subgraph
+     */
+    healthCheck(): Promise<{
+        isHealthy: boolean;
+        latestBlock?: string;
+    }>;
+    /**
+     * Get all configured loan terms (from subgraph)
+     * Note: If the subgraph does not seed default terms from the contract, this may return an empty array.
+     */
+    getLoanTerms(options?: {
+        first?: number;
+        skip?: number;
+    }): Promise<LoanTermData[]>;
+    /**
+     * Get a single loan term by months (from subgraph)
+     * Typical id is the months as string, e.g., "12".
+     */
+    getLoanTerm(months: number | string): Promise<LoanTermData | null>;
+    /**
+     * Get PSM configuration from subgraph
+     */
+    getPSMConfiguration(): Promise<PSMConfigurationData | null>;
+    /**
+     * Get all supported stablecoins from subgraph
+     */
+    getSupportedStablecoins(onlySupported?: boolean): Promise<SupportedStablecoinData[]>;
+    /**
+     * Get stablecoin details by address
+     */
+    getStablecoinDetails(address: string): Promise<SupportedStablecoinData | null>;
+    /**
+     * Get user rate limit status for a specific stablecoin
+     */
+    getUserRateLimit(userAddress: string, stablecoinAddress: string): Promise<UserRateLimitData | null>;
+    /**
+     * Get PSM transactions with filters
+     */
+    getPSMTransactions(filters?: {
+        user?: string;
+        stablecoin?: string;
+        type?: "SWAP" | "REDEEM";
+        first?: number;
+        skip?: number;
+    }): Promise<PSMTransactionData[]>;
+    /**
+     * Get PSM analytics for a date range
+     */
+    getPSMDailyMetrics(startDate?: string, endDate?: string, first?: number): Promise<any[]>;
+    /**
+     * Get all events for a specific loan position
+     *
+     * Returns a comprehensive event history including:
+     * - Payments (full repayments, partial payments, extension fees)
+     * - Status updates with reasons
+     * - Liquidation event (if liquidated)
+     * - UCD mint events
+     * - Community fee distributions
+     *
+     * @param positionId - The position ID to query events for
+     * @param filter - Optional filters to apply
+     * @returns Complete event history for the position
+     */
+    getLoanEvents(positionId: string, filter?: LoanEventsFilter): Promise<LoanEvents>;
+    /**
+     * Retrieve events across the full protocol, optionally narrowed to a position.
+     * Returns a merged, sorted discriminated-union timeline suitable for explorers.
+     *
+     * Protocol-global admin events (circuit breaker, term fees, etc.) are included
+     * by default; pass `kinds` to restrict.
+     */
+    getAllEvents(filter?: ProtocolEventsFilter): Promise<ProtocolEventsResult>;
+}
+export type DiamondHandsGraphClient = DiamondHandsGraph;

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Diamond Hands SDK Package
+ * Diamond Hands Protocol - SDK Operations
+ *
+ * Provides high-level interface for Diamond Hands Protocol operations supporting:
+ * - Loan creation with PKP integration
+ * - Smart contract interactions
+ * - LIT Protocol operations
+ * - Bitcoin custody and operations
+ *
+ * Version 2.0 - Complete rewrite with full type safety
+ */
+export { DiamondHandsSDK } from './modules/diamond-hands-sdk';
+export { DiamondHandsSDK as default } from './modules/diamond-hands-sdk';
+export type { UCD, Satoshis, Wei, BPS, UnixTimestamp, BlockNumber, } from './types/branded/domain-values';
+export { UCDConversions, SatoshisConversions, WeiConversions, BPSConversions, } from './types/branded/domain-values';
+export type { Result, Success, Failure, } from './types/result';
+export { success, failure, isSuccess, isFailure, unwrap, unwrapOr, map, mapError, andThen, firstSuccess, collectSuccesses, collectFailures, combine, tryCatch, tryCatchAsync, toPromise, fromPromise, match, } from './types/result';
+export type { AuthorizationParams, CreateLoanAuthParams, MintUCDAuthParams, WithdrawBTCAuthParams, RepayDebtAuthParams, ExtendTermAuthParams, ClosePositionAuthParams, } from './types/authorization-params';
+export { isCreateLoanAuth, isMintUCDAuth, isWithdrawBTCAuth, isRepayDebtAuth, isExtendTermAuth, isClosePositionAuth, AuthParamsValidation, } from './types/authorization-params';
+export { ContractManager, createContractManager, } from './modules/contract/contract-manager.module';
+export type { ContractManagerConfig, ManagedContracts, } from './modules/contract/contract-manager.module';
+export { LRUCache, CacheManager, createCacheManager, } from './modules/cache/cache-manager.module';
+export type { CacheConfig, CacheStats, } from './modules/cache/cache-manager.module';
+export { PKPManager, createPKPManager, } from './modules/pkp/pkp-manager.module';
+export type { PKPManagerConfig, } from './modules/pkp/pkp-manager.module';
+export { LoanCreator, createLoanCreator, } from './modules/loan/loan-creator.module';
+export type { LoanCreatorConfig, LoanCreationAudit, } from './modules/loan/loan-creator.module';
+export { LoanQuery, createLoanQuery, } from './modules/loan/loan-query.module';
+export type { LoanQueryConfig, LoanQueryFilters, PaginationParams, } from './modules/loan/loan-query.module';
+export { WithdrawalAddressModule, createWithdrawalAddressModule, } from './modules/withdrawal-address/withdrawal-address.module';
+export type { WithdrawalAddressModuleConfig, WithdrawalAddressEntry, } from './modules/withdrawal-address/withdrawal-address.module';
+export { BitcoinOperations, createBitcoinOperations, } from './modules/bitcoin/bitcoin-operations.module';
+export type { BitcoinOperationsConfig, BitcoinNetwork, EnrichedBitcoinBalance, } from './modules/bitcoin/bitcoin-operations.module';
+export { MockTokenManager, createMockTokenManager, } from './modules/mock/mock-token-manager.module';
+export type { SupportedStablecoinData } from './graphs/diamond-hands';
+export type { MockTokenManagerConfig, MockTokenTransactionResult, } from './modules/mock/mock-token-manager.module';
+export { validateSDKConfig, validateServiceModeConfig, validateStandaloneModeConfig, isServiceModeConfig, isStandaloneModeConfig, } from './interfaces/chunks/config.i';
+export { assertSafeServiceEndpoint } from './utils/service-endpoint-policy';
+export { DEFAULT_LIT_NETWORK, VALID_LIT_NETWORKS, SDK_DEFAULTS, } from './constants/chunks/sdk-config';
+export { ALL_CONTRACTS, ALL_DEPLOYMENTS, getContractsByNetwork, getDeploymentByNetwork, LOCALHOST_CONTRACTS, SEPOLIA_CONTRACTS, } from './constants/chunks/deployment-addresses';
+export type { DeploymentContracts, DeploymentData, DeploymentLatestEnv, } from './constants/chunks/deployment-addresses';
+export type { CreateLoanRequest, CreateLoanResult, LoanData, LoanDataDetail, PaginatedLoansResponse, PKPValidationData, BitcoinAddresses, } from './interfaces/chunks/loan-operations.i';
+export type { DiamondHandsSDKConfig, SDKMode, ContractAddresses, BitcoinProviderConfig, } from './interfaces/chunks/config.i';
+export type { PKPData, PKPCreationRequest, PKPCreationResult, PKPValidationResult, } from './interfaces/chunks/pkp-integration.i';
+export type { AuthorizationRequest, AuthorizationResult, BTCDepositRequest, BTCDepositResult, } from './interfaces/chunks/requests.i';
+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 { 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 { buildBtcExecuteEnvelope, } from './utils/btc-withdrawal-message';
+export type { BtcExecuteSignParams, BtcExecuteSignedEnvelope, } from './utils/btc-withdrawal-message';