@gvnrdao/dh-sdk 0.0.286 → 0.0.288

package/dist/graphs/client.d.ts

@@ -1,22 +0,0 @@
-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

@@ -1,259 +0,0 @@
-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

@@ -1,56 +0,0 @@
-/**
- * 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';

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

@@ -1,36 +0,0 @@
-/**
- * Bitcoin-related Types and Interfaces
- */
-export interface IBTCProof {
-    transactionId: string;
-    blockHeight: number;
-    confirmations: number;
-    merkleProof: string[];
-    blockHeader: string;
-}
-export interface BTCTransaction {
-    txid: string;
-    txHash: string;
-    blockHeight: number;
-    confirmations: number;
-    value: string;
-    from: string;
-    to: string;
-    timestamp: number;
-}
-export interface BTCProof {
-    transaction: BTCTransaction;
-    proof: IBTCProof;
-    valid: boolean;
-    verified?: boolean;
-    merkleProof?: string[];
-}
-export interface MonitoringOptions {
-    confirmations: number;
-    minConfirmations?: number;
-    timeoutMs: number;
-    timeout?: number;
-    retryAttempts: number;
-    retryDelayMs: number;
-    onConfirmation?: (confirmations: number) => void;
-}

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

@@ -1,270 +0,0 @@
-/**
- * SDK Configuration Interfaces
- */
-import type { Wallet, Signer, Provider } from "ethers";
-import { LitNetwork } from "@gvnrdao/dh-lit-ops";
-export type SDKMode = "standalone" | "service";
-/**
- * Contract Addresses Configuration
- */
-export interface ContractAddresses {
-    positionManager: string;
-    positionManagerCore?: string;
-    positionManagerViews?: string;
-    simplePsmV2?: string;
-    loanOperationsManager?: string;
-    termManager?: string;
-    collateralManager?: string;
-    ucdController?: string;
-    circuitBreaker?: string;
-    liquidationManager?: string;
-    ucdToken: string;
-    /** Optional when priceProviders is used (LIT actions fetch prices) */
-    priceFeedConsumer?: string;
-    operationAuthorizationRegistry?: string;
-    btcProofValidator?: string;
-    litActionValidator?: string;
-    /** BTCSpendAuthorizer proxy; required in dev for lit-actions `BtcSpendAuth` when passed via `contractAddresses`. */
-    btcSpendAuthorizer?: string;
-    /** BitcoinProviderRegistry proxy; required on non-hardhat chains when chain policy disallows arbitrary providers. */
-    bitcoinProviderRegistry?: string;
-    /** ContractVersionRegistry proxy; used for cross-contract version pinning. */
-    contractVersionRegistry?: string;
-    /** FeeRecipientRegistry proxy; M-8 fix — allowlist consulted by LoanOperationsManager.transferFee and SimplePSMV2.transferFee. */
-    feeRecipientRegistry?: string;
-    /** PositionDelegateRegistry proxy; consumed by LIT Action authorization verifier as the third recovery arm for Safe-as-borrower flows. */
-    positionDelegateRegistry?: string;
-    /** BitcoinWithdrawalAddressRegistry proxy; per-wallet allowlist that gates borrower-initiated BTC withdrawal destinations (24h time-lock). */
-    bitcoinWithdrawalAddressRegistry?: string;
-    mockUsdcToken?: string;
-    mockUsdcOwner?: string;
-    mockUsdtToken?: string;
-    mockUsdtOwner?: string;
-}
-/**
- * Base configuration shared by all SDK modes
- */
-interface BaseSDKConfig {
-    litNetwork?: LitNetwork;
-    contractSigner?: Wallet | Signer;
-    /**
-     * Optional signer used exclusively for EIP-712 server-session login.
-     * When provided, `ServerSession` uses this instead of `contractSigner` so
-     * the two concerns (auth identity vs on-chain msg.sender) can differ. In
-     * Safe mode the CLI passes the raw agent EOA here while `contractSigner`
-     * is a SafeModuleSignerAdapter that routes transactions through the module.
-     */
-    authSigner?: Wallet | Signer;
-    ethRpcUrl?: string;
-    chainId?: number;
-    networkOverride?: {
-        chainId: number;
-        name: string;
-    };
-    provider?: Provider;
-    chain?: string;
-    bitcoinNetwork?: "mainnet" | "testnet" | "regtest";
-    litActionCid?: string;
-    litNodeConnectTimeoutMs?: number;
-    subgraphUrl?: string;
-    priceProviders?: PriceProviderConfig[];
-    /** PKP Ethereum address for signed price oracle (Lit jsParams pkpId); optional */
-    priceOraclePkpId?: string;
-    bitcoinFaucetUrl?: string;
-    contractAddresses?: ContractAddresses;
-    subgraphs?: {
-        tokenGvnrUrl?: string;
-        diamondHandsUrl?: string;
-    };
-    graphApiKey?: string;
-    graphOptions?: {
-        requestTimeoutMs?: number;
-        maxRetries?: number;
-        pageSize?: number;
-    };
-    mockUsdcTokenAddress?: string;
-    mockUsdcOwnerAddress?: string;
-    mockUsdcDecimals?: number;
-    mockUsdtTokenAddress?: string;
-    mockUsdtOwnerAddress?: string;
-    mockUsdtDecimals?: number;
-    ucdTokenAddress?: string;
-    sessionExpirationMinutes?: number;
-    transactionTimeoutMs?: number;
-    retryAttempts?: number;
-    debug?: boolean;
-    /** Notification label for server Telegram notifications. Default: "DH SDK". Set "DH APP" in the web app. */
-    callerLabel?: string;
-    /**
-     * Optional: Override quantum timing buffer (in seconds)
-     * Default: Auto-detected based on network (10s for local, 50s for Sepolia, 35s for mainnet)
-     *
-     * Network-specific defaults:
-     * - Local networks (1337, 31337): 10s
-     * - Testnets (Sepolia 11155111, Goerli 5): 45-50s
-     * - Mainnet (1): 35s
-     *
-     * Only override if you have specific latency requirements.
-     * Recommended: Leave undefined to use automatic network detection.
-     */
-    quantumBufferSeconds?: number;
-    /**
-     * @deprecated No longer read. On Sepolia (11155111), when `eth_estimateGas` fails for
-     * `mintUCD` but a static `eth_call` succeeds, the SDK always broadcasts with a fixed
-     * gas ceiling (EIP-1559). Retained for backward-compatible configs.
-     */
-    skipGasEstimation?: boolean;
-    pkpServiceTimeoutMs?: number;
-    pkpServiceRetryCount?: number;
-    pkpServiceRetryDelayMs?: number;
-    balanceCacheOptions?: {
-        enabled?: boolean;
-        ttlMs?: number;
-        maxSize?: number;
-    };
-    addressCacheOptions?: {
-        enabled?: boolean;
-        ttlMs?: number;
-        maxSize?: number;
-        debug?: boolean;
-    };
-    concurrencyOptions?: {
-        enabled?: boolean;
-        concurrency?: number;
-        timeout?: number;
-        debug?: boolean;
-    };
-    loggingOptions?: {
-        enabled?: boolean;
-        level?: "debug" | "info" | "warn" | "error";
-        includeTimestamp?: boolean;
-        includeContext?: boolean;
-        maxContextKeys?: number;
-        verboseInProduction?: boolean;
-    };
-    validators?: {
-        /** Validator version for position creation (createPosition) - usually v1 for PKP security validation */
-        loanCreation: number;
-        /** Validator version for UCD minting (mintUCD) - usually v4 for business rules validation */
-        minting: number;
-        /** Validator version for partial payments (makePayment) - usually v1 for payment validation */
-        payment: number;
-        /** Validator version for loan extension/renewal (extendPosition) - usually v4 for extension validation */
-        extension: number;
-    };
-    defaultSelectedTermMonths?: number;
-    temperSignaturesTest?: boolean;
-    /**
-     * Optional in-process notification sink invoked alongside the existing service-mode
-     * HTTP relay. Fires in BOTH `standalone` and `service` mode so consumers can observe
-     * lifecycle events (e.g. loan renewal, mint, payment, withdrawal) without depending
-     * on `lit-ops-server`. The SDK already emits messages via `formatLoan*Message` helpers
-     * — this hook just exposes them locally. Errors thrown by the handler are swallowed
-     * so notification failures cannot break business operations.
-     *
-     * @example
-     *   const notifications: string[] = [];
-     *   sdkConfig.notificationHandler = (msg) => { notifications.push(msg); };
-     */
-    notificationHandler?: (message: string) => void | Promise<void>;
-}
-/**
- * Service Mode Configuration
- * Uses lit-ops-server for PKP operations
- */
-export interface ServiceModeConfig extends BaseSDKConfig {
-    mode: "service";
-    serviceEndpoint: string;
-    litOpsSigner?: never;
-}
-/**
- * Standalone Mode Configuration
- * User provides signer for direct LIT operations
- */
-export interface StandaloneModeConfig extends BaseSDKConfig {
-    mode: "standalone";
-    litOpsSigner: Wallet;
-    serviceEndpoint?: never;
-}
-/**
- * Main SDK Configuration - Discriminated Union
- *
- * Use ServiceModeConfig for production deployments with lit-ops-server
- * Use StandaloneModeConfig for development/testing with direct LIT access
- *
- * @example Service Mode
- * ```typescript
- * const config: DiamondHandsSDKConfig = {
- *   mode: 'service',
- *   serviceEndpoint: 'https://lit-ops.example.com',
- *   contractSigner: wallet
- * };
- * ```
- *
- * @example Standalone Mode
- * ```typescript
- * const config: DiamondHandsSDKConfig = {
- *   mode: 'standalone',
- *   litOpsSigner: wallet,
- *   contractSigner: wallet
- * };
- * ```
- */
-export type DiamondHandsSDKConfig = ServiceModeConfig | StandaloneModeConfig;
-/**
- * Type guard to check if config is ServiceModeConfig
- */
-export declare function isServiceModeConfig(config: DiamondHandsSDKConfig): config is ServiceModeConfig;
-/**
- * Type guard to check if config is StandaloneModeConfig
- */
-export declare function isStandaloneModeConfig(config: DiamondHandsSDKConfig): config is StandaloneModeConfig;
-export declare function validateServiceModeConfig(config: ServiceModeConfig): string | null;
-/**
- * Validates that StandaloneModeConfig has required fields
- */
-export declare function validateStandaloneModeConfig(config: StandaloneModeConfig): string | null;
-/**
- * Validates SDK configuration based on mode
- */
-export declare function validateSDKConfig(config: DiamondHandsSDKConfig): string | null;
-/**
- * SDK Initialization Options
- */
-export interface SDKInitOptions {
-    overrideDefaults?: boolean;
-    customProvider?: Provider;
-    skipNetworkCheck?: boolean;
-}
-/**
- * Network Configuration (basic)
- */
-export interface BasicNetworkConfig {
-    name: string;
-    chainId: number;
-    rpcUrl: string;
-    blockExplorerUrl?: string;
-}
-/**
- * Bitcoin Provider Configuration
- */
-export interface BitcoinProviderConfig {
-    url: string;
-    network: "mainnet" | "regtest";
-    auth?: {
-        username: string;
-        password: string;
-    };
-    name?: string;
-    priority?: number;
-}
-/**
- * Price Provider Configuration
- */
-export interface PriceProviderConfig {
-    name: string;
-    pkpId?: string;
-    apiKey?: string;
-    apiSecret?: string;
-}
-export {};