@gvnrdao/dh-sdk 0.0.287 → 0.0.288

package/dist/types/graph-dtos.d.ts

@@ -1,228 +0,0 @@
-/**
- * Graph Data Transfer Objects (DTOs)
- * Strictly typed interfaces for GraphQL responses to replace any types
- */
-export type BigIntString = string;
-export type TimestampString = string;
-export type AddressString = string;
-export interface GraphPositionDTO {
-    id: string;
-    pkpId: string;
-    borrower: string;
-    createdAt: TimestampString;
-    lastUpdated: TimestampString;
-    vaultAddress: string;
-    ucdMinted?: BigIntString;
-    ucdPaid?: BigIntString;
-    ucdDebt: BigIntString;
-    selectedTerm: string;
-    status: string;
-    expiryAt: TimestampString;
-    createdAtBlock?: string;
-    lastUpdatedAt?: TimestampString;
-    loanTerm?: {
-        id: string;
-        months: string;
-        extensionFeeRate: string;
-        extensionFeeUCD: string;
-        totalExtensions: string;
-        createdAt: string;
-    };
-    extensionFeesPaid?: string;
-    totalExtensions?: string;
-    payments?: Array<{
-        id: string;
-        amount: number;
-        blockNumber: number;
-        newCollateralRatio: number;
-        newDebt: number;
-        payer: {
-            id: string;
-        };
-        createdAt: number;
-        transactionHash: string;
-        type: string;
-    }>;
-    totalPaid?: string;
-    liquidation?: {
-        id: string;
-        liquidatedAt: string;
-        liquidatedBy: string;
-        reason: string;
-        collateralRecovered: string;
-        debtRecovered: string;
-        liquidationFee: string;
-        blockNumber: number;
-        collateralSeized: string;
-        commitHash: string;
-        commitTimestamp: string;
-        liquidatedAmount: string;
-        liquidator: string;
-        revealDelay: string;
-        timestamp: string;
-        transactionHash: string;
-    };
-}
-export interface GraphBorrowerDTO {
-    id: string;
-    createdAt: TimestampString;
-}
-export interface GraphPositionWithBorrowerDTO extends Omit<GraphPositionDTO, 'borrower'> {
-    borrower: GraphBorrowerDTO;
-}
-export interface GraphUserDataDTO {
-    id: string;
-    positions: GraphPositionDTO[];
-    totalBorrowed: BigIntString;
-    totalRepaid: BigIntString;
-    activePositions: string;
-    firstInteractionTimestamp: TimestampString;
-    lastInteractionTimestamp: TimestampString;
-}
-export interface GraphLoanTermDTO {
-    id: string;
-    months: string;
-    mintFeeBps?: string;
-    extensionFeeBps?: string;
-    isValid?: boolean;
-    createdAt?: TimestampString;
-    createdAtBlock?: string;
-}
-export interface GraphPSMConfigurationDTO {
-    id: string;
-    version: string;
-    redeemEnabled: boolean;
-    totalSwapVolume: BigIntString;
-    totalRedeemVolume: BigIntString;
-    supportedStablecoinsCount: string;
-    lastUpdated: TimestampString;
-}
-export interface GraphSupportedStablecoinDTO {
-    id: string;
-    address: AddressString;
-    isSupported: boolean;
-    exchangeRate: BigIntString;
-    entryFee: BigIntString;
-    exitFee: BigIntString;
-    reserves: BigIntString;
-    totalSupply: BigIntString;
-    lastUpdated: TimestampString;
-}
-export interface GraphPSMDailyMetricsDTO {
-    id: string;
-    date: string;
-    totalSwapVolume: BigIntString;
-    totalRedeemVolume: BigIntString;
-    averageExchangeRate: BigIntString;
-    uniqueUsers: string;
-    transactionCount: string;
-}
-export interface GraphTokenDTO {
-    id: string;
-    address: AddressString;
-    name: string;
-    symbol: string;
-    decimals: string;
-    totalSupply: BigIntString;
-    createdAtTimestamp: TimestampString;
-    createdAtBlock: string;
-}
-export interface GraphAccountDTO {
-    id: string;
-    address: AddressString;
-    balance: BigIntString;
-    token: string;
-    createdAtTimestamp: TimestampString;
-    createdAtBlock: string;
-}
-export interface GraphMetaDTO {
-    block: {
-        number: string;
-        hash: string;
-        timestamp: string;
-    };
-    deployment: {
-        network: string;
-        chainId: string;
-        subgraphName: string;
-        version: string;
-    };
-}
-export interface GraphPaginationDTO {
-    first: number;
-    skip: number;
-    orderBy?: string;
-    orderDirection?: 'asc' | 'desc';
-}
-export interface GraphPaginatedResponseDTO<T> {
-    data: T[];
-    total: number;
-    page: number;
-    hasMore: boolean;
-}
-export interface GraphPositionsResponseDTO {
-    positions: GraphPositionWithBorrowerDTO[];
-    _meta: GraphMetaDTO;
-}
-export interface GraphUserPositionsResponseDTO {
-    positions: GraphPositionDTO[];
-    total: number;
-}
-export interface GraphPositionsByStatusResponseDTO {
-    positions: GraphPositionDTO[];
-    total: number;
-}
-export interface GraphPSMDailyMetricsResponseDTO {
-    psmDailyMetrics: GraphPSMDailyMetricsDTO[];
-}
-export interface GraphTokensResponseDTO {
-    tokens: GraphTokenDTO[];
-}
-export interface GraphTokenResponseDTO {
-    token: GraphTokenDTO;
-}
-export interface GraphAccountResponseDTO {
-    account: GraphAccountDTO;
-}
-export interface GraphAccountsResponseDTO {
-    accounts: GraphAccountDTO[];
-}
-export interface GraphPositionFilterDTO {
-    borrower?: string;
-    status?: string;
-    pkpId?: string;
-    createdAt_gte?: TimestampString;
-    createdAt_lte?: TimestampString;
-}
-export interface GraphAccountFilterDTO {
-    token?: string;
-    minBalance?: BigIntString;
-    address?: AddressString;
-}
-export interface GraphHealthCheckDTO {
-    _meta: GraphMetaDTO;
-    positionsCount: number;
-    lastIndexedBlock: string;
-    isHealthy: boolean;
-}
-export interface GraphErrorDTO {
-    message: string;
-    locations?: Array<{
-        line: number;
-        column: number;
-    }>;
-    path?: string[];
-    extensions?: {
-        code: string;
-        exception?: {
-            stacktrace: string[];
-        };
-    };
-}
-export interface GraphResponseDTO<T> {
-    data?: T;
-    errors?: GraphErrorDTO[];
-    extensions?: {
-        [key: string]: any;
-    };
-}

package/dist/types/loanStatus.d.ts

@@ -1,10 +0,0 @@
-export declare enum LoanStatus {
-    PENDING_DEPOSIT = 0,
-    PENDING_MINT = 1,
-    ACTIVE = 2,
-    EXPIRED = 3,
-    LIQUIDATABLE = 4,
-    LIQUIDATED = 5,
-    REPAID = 6,
-    CLOSED = 7
-}

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

@@ -1,99 +0,0 @@
-/**
- * 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;
-} | {
-    kind: 'mintingFee';
-    positionId: string;
-    feeAmount: string;
-    mintAmount: string;
-    timestamp: string;
-    blockNumber: string;
-    transactionHash: string;
-    [k: string]: unknown;
-} | {
-    kind: 'renewalFee';
-    positionId: string;
-    feeAmount: string;
-    extensionTerm: string;
-    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/dist/types/result.d.ts

@@ -1,120 +0,0 @@
-/**
- * Result type for standardized error handling across the SDK
- *
- * This is a discriminated union that provides type-safe error handling
- * without throwing exceptions. Inspired by Rust's Result<T, E> type.
- *
- * @example
- * ```typescript
- * async function createLoan(request: CreateLoanRequest): Promise<Result<LoanData, SDKError>> {
- *   try {
- *     const loan = await performCreation(request);
- *     return success(loan);
- *   } catch (error) {
- *     return failure(SDKError.from(error));
- *   }
- * }
- *
- * // Usage
- * const result = await createLoan(request);
- * if (result.success) {
- *   console.log('Loan created:', result.value);
- * } else {
- *   console.error('Failed:', result.error);
- * }
- * ```
- */
-/**
- * Success variant of Result<T, E>
- */
-export interface Success<T> {
-    success: true;
-    value: T;
-}
-/**
- * Failure variant of Result<T, E>
- */
-export interface Failure<E> {
-    success: false;
-    error: E;
-}
-/**
- * Result type - either Success<T> or Failure<E>
- */
-export type Result<T, E = Error> = Success<T> | Failure<E>;
-/**
- * Creates a successful Result
- */
-export declare function success<T>(value: T): Success<T>;
-/**
- * Creates a failed Result
- */
-export declare function failure<E>(error: E): Failure<E>;
-/**
- * Type guard to check if Result is successful
- */
-export declare function isSuccess<T, E>(result: Result<T, E>): result is Success<T>;
-/**
- * Type guard to check if Result is a failure
- */
-export declare function isFailure<T, E>(result: Result<T, E>): result is Failure<E>;
-/**
- * Unwraps a Result, returning the value or throwing the error
- */
-export declare function unwrap<T, E extends Error>(result: Result<T, E>): T;
-/**
- * Unwraps a Result, returning the value or a default
- */
-export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
-/**
- * Maps a Result<T, E> to Result<U, E> by applying a function to the success value
- */
-export declare function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
-/**
- * Maps a Result<T, E> to Result<T, F> by applying a function to the error value
- */
-export declare function mapError<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
-/**
- * Chains Result-returning operations together (flatMap)
- */
-export declare function andThen<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;
-/**
- * Returns the first successful Result, or the last error if all fail
- */
-export declare function firstSuccess<T, E>(results: Result<T, E>[]): Result<T, E>;
-/**
- * Collects all successful Results into an array
- */
-export declare function collectSuccesses<T, E>(results: Result<T, E>[]): T[];
-/**
- * Collects all failures into an array
- */
-export declare function collectFailures<T, E>(results: Result<T, E>[]): E[];
-/**
- * Combines multiple Results into a single Result containing an array
- * If any Result fails, returns the first failure
- */
-export declare function combine<T, E>(results: Result<T, E>[]): Result<T[], E>;
-/**
- * Wraps an async function that may throw into one that returns a Result
- */
-export declare function tryCatch<T, E = Error>(fn: () => T, errorHandler?: (error: unknown) => E): Result<T, E>;
-/**
- * Async version of tryCatch
- */
-export declare function tryCatchAsync<T, E = Error>(fn: () => Promise<T>, errorHandler?: (error: unknown) => E): Promise<Result<T, E>>;
-/**
- * Converts a Result to a Promise that rejects on failure
- */
-export declare function toPromise<T, E extends Error>(result: Result<T, E>): Promise<T>;
-/**
- * Converts a Promise to a Result (will never reject)
- */
-export declare function fromPromise<T, E = Error>(promise: Promise<T>, errorHandler?: (error: unknown) => E): Promise<Result<T, E>>;
-/**
- * Utility to match on a Result and handle both cases
- */
-export declare function match<T, E, U>(result: Result<T, E>, handlers: {
-    success: (value: T) => U;
-    failure: (error: E) => U;
-}): U;

package/dist/utils/address-conversion.utils.d.ts

@@ -1,51 +0,0 @@
-/**
- * Address Conversion Utilities
- * Provides safe address conversion and validation with clear error messages
- */
-/**
- * Safely convert a string to bytes32 with clear error handling
- * @param value String value to convert
- * @param fieldName Name of the field for error messages
- * @returns bytes32 string
- * @throws Clear error message if conversion fails
- */
-export declare function safeHexZeroPad(value: string, fieldName?: string): string;
-/**
- * Safely get Bitcoin addresses from PKP with retry and clear error handling
- * @param pkpId PKP ID to derive addresses from
- * @param maxRetries Maximum number of retries (default: 3)
- * @returns Bitcoin addresses for all networks
- * @throws Clear error message if derivation fails
- */
-export declare function safeGetBitcoinAddressesFromPkp(pkpId: string, maxRetries?: number): Promise<{
-    mainnet: string;
-    testnet: string;
-    regtest: string;
-}>;
-/**
- * Safely validate and format a Bitcoin address
- * @param address Bitcoin address to validate
- * @param network Network type for validation
- * @returns Validated address
- * @throws Clear error message if validation fails
- */
-export declare function safeValidateBitcoinAddress(address: string, network?: 'mainnet' | 'testnet' | 'regtest'): string;
-/**
- * Canonicalize a Bitcoin address so that the SAME string is used on both the
- * approve path (registry.addAddress) and the withdraw path. The on-chain
- * allowlist is keyed by keccak256(bytes(address)), so the two strings MUST
- * byte-match. Bech32 (bc1/tb1/bcrt1) is lower-case canonical, so we lower-case
- * it; Base58 (1.../3.../m.../n.../2...) is case-sensitive and is returned
- * unchanged.
- *
- * @param address Bitcoin address to canonicalize
- * @returns The canonical form to store/compare
- */
-export declare function normalizeBitcoinAddress(address: string): string;
-/**
- * Safely parse and validate a position ID
- * @param positionId Position ID to validate
- * @returns Validated position ID
- * @throws Clear error message if validation fails
- */
-export declare function safeValidatePositionId(positionId: string): string;

package/dist/utils/bitcoin-address-cache.utils.d.ts

@@ -1,87 +0,0 @@
-/**
- * Bitcoin Address Derivation Cache Utility
- * Implements LRU (Least Recently Used) caching for Bitcoin address derivation from PKP
- * Avoids repeated SHA256+RIPEMD160 operations for the same PKP ID
- */
-import type { BitcoinAddresses } from '../interfaces';
-/**
- * Cache statistics
- */
-export interface AddressCacheStats {
-    size: number;
-    hits: number;
-    misses: number;
-    evictions: number;
-    hitRate: number;
-}
-/**
- * Address cache configuration
- */
-export interface AddressCacheConfig {
-    maxSize?: number;
-    ttlMs?: number;
-    debug?: boolean;
-}
-/**
- * LRU Cache for Bitcoin address derivation
- *
- * Features:
- * - TTL-based expiration
- * - LRU eviction when max size reached
- * - Hit/miss statistics tracking
- * - Memory-efficient (stores only PKP ID and derived addresses)
- */
-export declare class BitcoinAddressCache {
-    private cache;
-    private maxSize;
-    private ttlMs;
-    private debug;
-    private stats;
-    constructor(config?: AddressCacheConfig);
-    /**
-     * Get addresses from cache
-     * Returns null if not found or expired
-     */
-    get(pkpId: string): BitcoinAddresses | null;
-    /**
-     * Set addresses in cache
-     * Evicts LRU entry if cache is full
-     */
-    set(pkpId: string, value: BitcoinAddresses): void;
-    /**
-     * Check if entry is expired
-     */
-    private isExpired;
-    /**
-     * Evict least recently used entry
-     */
-    private evictLRU;
-    /**
-     * Clear all entries
-     */
-    clear(): void;
-    /**
-     * Get cache statistics
-     */
-    getStats(): AddressCacheStats;
-    /**
-     * Get cache size
-     */
-    size(): number;
-    /**
-     * Check if cache has entry
-     */
-    has(pkpId: string): boolean;
-    /**
-     * Delete specific entry
-     */
-    delete(pkpId: string): boolean;
-    /**
-     * Get all cached PKP IDs (for debugging)
-     */
-    getKeys(): string[];
-    /**
-     * Clean expired entries
-     */
-    cleanExpired(): number;
-}

package/dist/utils/bitcoin-provider.utils.d.ts

@@ -1,84 +0,0 @@
-/**
- * Bitcoin Provider Utilities
- * Handles multi-provider consensus for Bitcoin blockchain queries
- */
-import type { BitcoinProviderConfig } from '../interfaces/chunks/config.i';
-import type { BitcoinBalanceResult } from '../interfaces/chunks/position-query.i';
-/**
- * Bitcoin Provider with consensus support
- */
-export declare class BitcoinProvider {
-    private providers;
-    private consensusMode;
-    private debug;
-    constructor(configs: BitcoinProviderConfig[], consensusMode?: 'single' | 'majority', debug?: boolean);
-    /**
-     * Get UTXOs for a Bitcoin address with consensus
-     */
-    getUnspentsFor(address: string): Promise<BitcoinBalanceResult>;
-    /**
-     * Get UTXOs from a single provider
-     */
-    private getUnspentsSingle;
-    /**
-     * Check if a provider error is retryable
-     */
-    private isRetryableProviderError;
-    /**
-     * Get UTXOs with 2-of-3 consensus
-     */
-    private getUnspentsWithConsensus;
-    /**
-     * Find consensus among multiple provider results
-     */
-    private findConsensus;
-    /**
-     * Create a signature for a UTXO set (for comparison)
-     */
-    private getUTXOSetSignature;
-    private fetchUtxosFromProvider;
-    /**
-     * Get balance for an address (sum of UTXOs)
-     */
-    getBalance(address: string): Promise<bigint>;
-    /**
-     * Check if an address has received at least a specific amount
-     */
-    hasReceivedAmount(address: string, expectedAmount: bigint): Promise<boolean>;
-    /**
-     * Fetch a Bitcoin transaction by txid.
-     *
-     * Audit CRIT-2: used to verify that a Phase-2 BTC withdrawal the server
-     * claimed broadcast actually exists and matches the user's authorization.
-     * Returns `null` if no provider has the tx yet — the caller may retry to
-     * allow for propagation/indexing delay.
-     *
-     * Esplora response shape: `{ txid, vin: [{txid, vout, ...}], vout: [{value, scriptpubkey_address, ...}], status: {confirmed, ...} }`
-     */
-    getTransaction(txid: string): Promise<BitcoinTransactionInfo | null>;
-    /**
-     * Try each candidate path on the provider. Returns `null` on 404 (tx not
-     * yet visible) but throws on other errors so the outer loop can move to
-     * the next provider.
-     */
-    private fetchTxFromProvider;
-}
-/**
- * Normalized Bitcoin transaction information returned by `getTransaction`.
- * Only the fields used by post-broadcast verification are populated; we
- * deliberately do NOT echo full witness / scriptpubkey data to keep the
- * surface small.
- */
-export interface BitcoinTransactionInfo {
-    txid: string;
-    vin: Array<{
-        txid: string;
-        vout: number;
-    }>;
-    vout: Array<{
-        value: number;
-        address?: string;
-    }>;
-    /** True if the tx is in a block, false if still in mempool, undefined unknown. */
-    confirmed?: boolean;
-}