@gvnrdao/dh-sdk 0.0.248 → 0.0.251

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

@@ -19,6 +19,7 @@ import type { DiamondHandsSDKConfig } from "../interfaces/chunks/config.i";
 import type { PKPData } from "../interfaces/chunks/pkp-integration.i";
 import { ContractManager } from "./contract/contract-manager.module";
 import { BitcoinOperations } from "./bitcoin/bitcoin-operations.module";
+import type { SupportedStablecoinData } from "../graphs/diamond-hands";
 type PositionDetailsView = {
     positionId: string;
     pkpId: string;
@@ -572,6 +573,26 @@ export declare class DiamondHandsSDK {
      * Get all events for a loan position from the subgraph
      */
     getLoanEvents(positionId: string, filter?: import("../types/event-types").LoanEventsFilter): Promise<Result<import("../types/event-types").LoanEvents, SDKError>>;
+    /**
+     * Get protocol-wide events across all indexed entity types.
+     * Returns a merged, sorted discriminated-union timeline.
+     * Narrow to a position with filter.positionId, or restrict event kinds with filter.kinds.
+     */
+    getAllEvents(filter?: import("../types/protocol-event-types").ProtocolEventsFilter): Promise<import("../types/protocol-event-types").ProtocolEventsResult>;
+    /**
+     * Return PSM-supported stablecoins from the subgraph, including indexed reserves,
+     * fees, exchange rate, and volume stats.
+     *
+     * @param onlySupported - When true (default) filters to currently-supported coins only.
+     */
+    getPSMStablecoins(onlySupported?: boolean): Promise<SupportedStablecoinData[]>;
+    /**
+     * Return the live on-chain available reserve balance for a single stablecoin in the PSM.
+     * Prefer this over the subgraph `reserves` field when freshness matters (e.g. pre-swap validation).
+     *
+     * @param stablecoinAddress - EVM address of the stablecoin to query.
+     */
+    getPSMAvailableReserves(stablecoinAddress: string): Promise<bigint>;
     /**
      * Wait for the subgraph to index up to (and including) the given block number.
      * Call after on-chain actions (createLoan, mintUCD, etc.) before querying the subgraph.

package/dist/types/event-types.d.ts

@@ -4,172 +4,102 @@
  * Type definitions for all loan-related events tracked by the Diamond Hands Protocol.
  * These events are indexed by The Graph subgraph and can be queried via the SDK.
  */
-/**
- * Payment event type enum
- */
 export declare enum PaymentType {
     FULL_REPAYMENT = "FULL_REPAYMENT",
     PARTIAL_PAYMENT = "PARTIAL_PAYMENT",
     EXTENSION_FEE = "EXTENSION_FEE"
 }
-/**
- * Position status enum
- */
 export declare enum PositionStatus {
     PENDING_DEPOSIT = "PENDING_DEPOSIT",
+    PENDING_MINT = "PENDING_MINT",
     ACTIVE = "ACTIVE",
     EXPIRED = "EXPIRED",
+    LIQUIDATABLE = "LIQUIDATABLE",
     LIQUIDATED = "LIQUIDATED",
     REPAID = "REPAID",
     CLOSED = "CLOSED"
 }
-/**
- * Payment event - tracks all payment activities for a position
- */
+export interface PositionCreatedEvent {
+    id: string;
+    positionId: string;
+    pkpId: string;
+    borrower: string;
+    requestedCollateralRatio: string;
+    selectedTerm: string;
+    expiryAt: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+}
 export interface PaymentEvent {
-    /** Unique event ID (transaction hash + log index) */
     id: string;
-    /** Position ID this payment belongs to */
     positionId: string;
-    /** Address of the payer */
     payer: string;
-    /** Payment amount in UCD (wei) */
     amount: string;
-    /** Type of payment */
     type: PaymentType;
-    /** Transaction hash */
     transactionHash: string;
-    /** Block timestamp */
     timestamp: string;
-    /** Block number */
     blockNumber: string;
-    /** Log index in the transaction */
     logIndex: string;
-    /** Position debt after payment */
     newDebt: string;
-    /** Position collateral ratio after payment (basis points) */
     newCollateralRatio: string;
 }
-/**
- * Status update event - tracks position status changes
- */
 export interface StatusUpdateEvent {
-    /** Unique event ID (transaction hash + log index) */
     id: string;
-    /** Position ID */
     positionId: string;
-    /** Previous status */
     oldStatus: PositionStatus;
-    /** New status */
     newStatus: PositionStatus;
-    /** Reason for status change (optional) */
     reason?: string;
-    /** Block timestamp */
     timestamp: string;
-    /** Block number */
     blockNumber: string;
-    /** Transaction hash */
     transactionHash: string;
 }
-/**
- * Liquidation event - tracks position liquidations
- */
 export interface LiquidationEvent {
-    /** Unique event ID (transaction hash) */
     id: string;
-    /** Position ID that was liquidated */
     positionId: string;
-    /** Address of the liquidator */
     liquidator: string;
-    /** Amount of debt liquidated (UCD wei) */
     liquidatedAmount: string;
-    /** Amount of collateral seized (satoshis) */
     collateralSeized: string;
-    /** Transaction hash */
     transactionHash: string;
-    /** Block timestamp */
     timestamp: string;
-    /** Block number */
     blockNumber: string;
-    /** MEV protection: commit hash (if used) */
     commitHash?: string;
-    /** MEV protection: commit timestamp (if used) */
     commitTimestamp?: string;
-    /** MEV protection: reveal delay in seconds (if used) */
     revealDelay?: string;
 }
-/**
- * UCD mint event - tracks UCD minting for positions
- */
 export interface UCDMintEvent {
-    /** Unique event ID (transaction hash + log index) */
     id: string;
-    /** Position ID */
     positionId: string;
-    /** Amount of UCD minted (wei) */
     amount: string;
-    /** Proof bytes (for verification) */
     proof: string;
-    /** Address that performed the mint */
     minter: string;
-    /** Whether this was a community mint */
     isCommunityMint: boolean;
-    /** Block timestamp */
     timestamp: string;
-    /** Block number */
     blockNumber: string;
-    /** Transaction hash */
     transactionHash: string;
 }
-/**
- * BTC withdrawal event - tracks collateral withdrawals
- */
 export interface WithdrawalEvent {
-    /** Unique event ID (transaction hash + log index) */
     id: string;
-    /** Position ID */
     positionId: string;
-    /** Amount withdrawn in satoshis */
     withdrawalAmount: string;
-    /** Bitcoin destination address */
     withdrawalAddress: string;
-    /** Network fee deducted (satoshis, optional) */
     networkFee?: string;
-    /** Block timestamp */
     timestamp: string;
-    /** Block number */
     blockNumber: string;
-    /** Transaction hash */
     transactionHash: string;
-    /** Log index in the transaction */
     logIndex: string;
 }
-/**
- * Position renewal/extension event
- */
 export interface RenewalEvent {
-    /** Unique event ID (transaction hash + log index) */
     id: string;
-    /** Position ID */
     positionId: string;
-    /** Additional term in months */
     extensionTerm: string;
-    /** Extension fee paid (UCD wei) */
     extensionFee: string;
-    /** New expiry timestamp after extension */
     newExpiryDate: string;
-    /** Block timestamp */
     timestamp: string;
-    /** Block number */
     blockNumber: string;
-    /** Transaction hash */
     transactionHash: string;
-    /** Log index in the transaction */
     logIndex: string;
 }
-/**
- * Failed operation event - tracks mint/burn/repay/renew/withdraw failures
- */
 export interface OperationFailureEvent {
     id: string;
     positionId: string;
@@ -182,9 +112,6 @@ export interface OperationFailureEvent {
     transactionHash: string;
     logIndex: string;
 }
-/**
- * UCD mint request - records a successful mintUCD call with all parameters
- */
 export interface MintRequestEvent {
     id: string;
     positionId: string;
@@ -202,9 +129,6 @@ export interface MintRequestEvent {
     transactionHash: string;
     logIndex: string;
 }
-/**
- * Burn request - records a successful makePayment/repay call
- */
 export interface BurnRequestEvent {
     id: string;
     positionId: string;
@@ -219,10 +143,7 @@ export interface BurnRequestEvent {
     transactionHash: string;
     logIndex: string;
 }
-/**
- * Collateral contract event - position-level collateral manager outcomes
- * (POSITION_CLOSED, NETWORK_FEE_DEDUCTED, VALIDATION_FAILED, EXCESSIVE_FEE_REJECTED)
- */
+/** Position-level collateral manager outcomes (POSITION_CLOSED, NETWORK_FEE_DEDUCTED) */
 export interface CollateralContractEvent {
     id: string;
     positionId: string;
@@ -236,208 +157,51 @@ export interface CollateralContractEvent {
     logIndex: string;
 }
 /**
- * Protocol param update — emitted by updateProtocolParameters() on LoanOperationsManager
- */
-export interface LoanProtocolParamUpdateEvent {
-    id: string;
-    oldLiquidationThreshold: string;
-    newLiquidationThreshold: string;
-    oldMinimumLoanValueUcd: string;
-    newMinimumLoanValueUcd: string;
-    caller: string;
-    timestamp: string;
-    blockNumber: string;
-    transactionHash: string;
-}
-/**
- * Maximum loan value update — emitted alongside updateProtocolParameters() when max changes
- */
-export interface MaxLoanValueUpdateEvent {
-    id: string;
-    oldValueUcd: string;
-    newValueUcd: string;
-    caller: string;
-    timestamp: string;
-    blockNumber: string;
-    transactionHash: string;
-}
-/**
- * BTC price bounds update — emitted by updateBtcPriceBounds()
- */
-export interface BtcPriceBoundsUpdateEvent {
-    id: string;
-    oldMinBound: string;
-    newMinBound: string;
-    oldMaxBound: string;
-    newMaxBound: string;
-    caller: string;
-    timestamp: string;
-    blockNumber: string;
-    transactionHash: string;
-}
-/**
- * Per-user daily mint limit update — emitted by setPerUserDailyMintLimit()
- */
-export interface PerUserDailyMintLimitUpdateEvent {
-    id: string;
-    oldLimit: string;
-    newLimit: string;
-    updatedBy: string;
-    timestamp: string;
-    blockNumber: string;
-    transactionHash: string;
-}
-/**
- * Protocol-level circuit breaker event (activation, deactivation, limit updates)
- */
-export interface CircuitBreakerProtocolEvent {
-    id: string;
-    isActivated: boolean;
-    admin: string;
-    reason?: string;
-    timestamp: string;
-    blockNumber: string;
-    transactionHash: string;
-}
-/**
- * Protocol-level term fee update event
- */
-export interface TermFeeUpdateEvent {
-    id: string;
-    termMonths: string;
-    oldOriginationFee: string;
-    newOriginationFee: string;
-    oldExtensionFee: string;
-    newExtensionFee: string;
-    timestamp: string;
-    blockNumber: string;
-    transactionHash: string;
-}
-/**
- * Community fee distribution event
- */
-export interface FeeDistributionEvent {
-    /** Unique event ID (transaction hash + log index) */
-    id: string;
-    /** Position ID */
-    positionId: string;
-    /** Recipient address */
-    recipient: string;
-    /** Fee amount (UCD wei) */
-    amount: string;
-    /** Type of fee (e.g., "community", "extension") */
-    feeType: string;
-    /** Block timestamp */
-    timestamp: string;
-    /** Block number */
-    blockNumber: string;
-    /** Transaction hash */
-    transactionHash: string;
-}
-/**
- * Aggregate container for all loan events
+ * Aggregate container for all position-scoped loan events.
+ * Protocol-global admin events (circuit breaker, term fees, price bounds, etc.)
+ * are available via sdk.getAllEvents({ kinds: ['admin'] }).
  */
 export interface LoanEvents {
-    /** Position ID these events belong to */
     positionId: string;
-    /** All payment events */
+    positionCreated?: PositionCreatedEvent;
     payments: PaymentEvent[];
-    /** All status update events */
     statusUpdates: StatusUpdateEvent[];
-    /** Liquidation event (if position was liquidated) */
     liquidation?: LiquidationEvent;
-    /** All UCD mint events */
     mints: UCDMintEvent[];
-    /** All BTC withdrawal events */
     withdrawals: WithdrawalEvent[];
-    /** All position renewal/extension events */
     renewals: RenewalEvent[];
-    /** All failed operation events */
     operationFailures: OperationFailureEvent[];
-    /** All mint request events (successful mintUCD calls) */
     mintRequests: MintRequestEvent[];
-    /** All burn request events (successful repay/payment calls) */
     burnRequests: BurnRequestEvent[];
-    /** All collateral contract events (close, fee deduction, validation failures) */
     collateralEvents: CollateralContractEvent[];
-    /** Protocol-level circuit breaker events */
-    circuitBreakerEvents: CircuitBreakerProtocolEvent[];
-    /** Protocol-level term fee update events */
-    termFeeUpdates: TermFeeUpdateEvent[];
-    /** LoanOps protocol param updates (liquidationThreshold + minimumLoanValueUcd) */
-    loanProtocolParamUpdates: LoanProtocolParamUpdateEvent[];
-    /** LoanOps maximum loan value updates */
-    maxLoanValueUpdates: MaxLoanValueUpdateEvent[];
-    /** BTC price bounds updates */
-    btcPriceBoundsUpdates: BtcPriceBoundsUpdateEvent[];
-    /** Per-user daily mint limit updates */
-    perUserMintLimitUpdates: PerUserDailyMintLimitUpdateEvent[];
-    /** All community fee distribution events */
-    feeDistributions: FeeDistributionEvent[];
-    /** Total number of events */
     totalEvents: number;
 }
-/**
- * Options for filtering loan events
- */
 export interface LoanEventsFilter {
-    /** Filter by event types */
-    eventTypes?: Array<'payment' | 'status' | 'liquidation' | 'mint' | 'withdrawal' | 'renewal' | 'operationFailure' | 'mintRequest' | 'burnRequest' | 'collateralEvent' | 'circuitBreaker' | 'termFeeUpdate' | 'loanProtocolParamUpdate' | 'maxLoanValueUpdate' | 'btcPriceBoundsUpdate' | 'perUserMintLimitUpdate'>;
-    /** Filter by minimum timestamp */
+    eventTypes?: Array<'positionCreated' | 'payment' | 'status' | 'liquidation' | 'mint' | 'withdrawal' | 'renewal' | 'operationFailure' | 'mintRequest' | 'burnRequest' | 'collateralEvent'>;
     fromTimestamp?: string;
-    /** Filter by maximum timestamp */
     toTimestamp?: string;
-    /** Filter by minimum block number */
     fromBlock?: string;
-    /** Filter by maximum block number */
     toBlock?: string;
-    /** Limit number of events per type */
     limit?: number;
-    /** Order direction */
     orderDirection?: 'asc' | 'desc';
 }
-/**
- * Type guard to check if status is valid
- */
 export declare function isValidPositionStatus(status: string): status is PositionStatus;
-/**
- * Type guard to check if payment type is valid
- */
 export declare function isValidPaymentType(type: string): type is PaymentType;
-/**
- * Convert numeric status to enum
- */
 export declare function numericToPositionStatus(status: number): PositionStatus;
-/**
- * Event helper functions
- */
 export declare const EventHelpers: {
-    /**
-     * Sort events by timestamp (descending by default)
-     */
     sortByTimestamp<T extends {
         timestamp: string;
     }>(events: T[], direction?: "asc" | "desc"): T[];
-    /**
-     * Filter events by timestamp range
-     */
     filterByTimestamp<T extends {
         timestamp: string;
     }>(events: T[], fromTimestamp?: string, toTimestamp?: string): T[];
-    /**
-     * Filter events by block range
-     */
     filterByBlock<T extends {
         blockNumber: string;
     }>(events: T[], fromBlock?: string, toBlock?: string): T[];
-    /**
-     * Get total count of all events
-     */
     getTotalCount(events: LoanEvents): number;
-    /**
-     * Merge and sort all events by timestamp
-     */
-    getAllEventsSorted(events: LoanEvents, direction?: "asc" | "desc"): Array<(PaymentEvent & {
+    getAllEventsSorted(events: LoanEvents, direction?: "asc" | "desc"): Array<(PositionCreatedEvent & {
+        eventType: "positionCreated";
+    }) | (PaymentEvent & {
         eventType: "payment";
     }) | (StatusUpdateEvent & {
         eventType: "status";
@@ -457,17 +221,5 @@ export declare const EventHelpers: {
         eventType: "burnRequest";
     }) | (CollateralContractEvent & {
         eventType: "collateralEvent";
-    }) | (CircuitBreakerProtocolEvent & {
-        eventType: "circuitBreaker";
-    }) | (TermFeeUpdateEvent & {
-        eventType: "termFeeUpdate";
-    }) | (LoanProtocolParamUpdateEvent & {
-        eventType: "loanProtocolParamUpdate";
-    }) | (MaxLoanValueUpdateEvent & {
-        eventType: "maxLoanValueUpdate";
-    }) | (BtcPriceBoundsUpdateEvent & {
-        eventType: "btcPriceBoundsUpdate";
-    }) | (PerUserDailyMintLimitUpdateEvent & {
-        eventType: "perUserMintLimitUpdate";
     })>;
 };

package/dist/types/protocol-event-types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Protocol-wide event types for getAllEvents.
+ * Position-scoped events are also available via getLoanEvents.
+ */
+export type ProtocolEvent = {
+    kind: 'position';
+    subkind: 'created' | 'status' | 'renewed' | 'closed';
+    positionId: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+} | {
+    kind: 'payment';
+    positionId: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+} | {
+    kind: 'liquidation';
+    positionId: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+} | {
+    kind: 'collateral';
+    positionId: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+} | {
+    kind: 'mint';
+    positionId: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+} | {
+    kind: 'withdrawal';
+    positionId: string;
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+} | {
+    kind: 'psm';
+    subkind: 'swap' | 'redeem';
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+} | {
+    kind: 'admin';
+    subkind: 'circuitBreaker' | 'termFee' | 'loanParams' | 'maxLoanValue' | 'btcBounds' | 'mintLimit';
+    timestamp: string;
+    blockNumber: string;
+    transactionHash: string;
+    [k: string]: unknown;
+};
+export interface ProtocolEventsFilter {
+    /** Narrow all position-linked events to a single position */
+    positionId?: string;
+    /** Include only these event kinds (omit to include all) */
+    kinds?: ProtocolEvent['kind'][];
+    fromTimestamp?: string;
+    toTimestamp?: string;
+    fromBlock?: string;
+    toBlock?: string;
+    /** Per-entity query limit (default 1000) */
+    limit?: number;
+    orderDirection?: 'asc' | 'desc';
+}
+export interface ProtocolEventsResult {
+    events: ProtocolEvent[];
+    totalEvents: number;
+    /** Count of events per kind for UI filter badges */
+    byKind: Record<string, number>;
+}

package/package.json

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