@gvnrdao/dh-sdk 0.0.287 → 0.0.288

package/dist/interfaces/chunks/contract-interactions.i.d.ts

@@ -1,64 +0,0 @@
-/**
- * Smart Contract Interaction Interfaces
- */
-import type { TransactionReceipt } from "ethers";
-/**
- * Contract Call Options Interface
- */
-export interface ContractCallOptions {
-    gasLimit?: number;
-    gasPrice?: string;
-    value?: string;
-    timeout?: number;
-}
-/**
- * Contract Transaction Result Interface
- */
-export interface ContractTransactionResult {
-    success: boolean;
-    error?: string;
-    transactionHash?: string;
-    receipt?: TransactionReceipt;
-    gasUsed?: string;
-    events?: any[];
-}
-/**
- * Position Details Interface
- */
-export interface PositionDetails {
-    positionId: string;
-    pkpId: string;
-    borrower: string;
-    ucdDebt: string;
-    createdAt: number;
-    lastUpdated: number;
-    collateralRatio: string;
-}
-/**
- * Contract Query Options Interface
- */
-export interface ContractQueryOptions {
-    blockTag?: number | "latest" | "pending";
-    contractAddress?: string;
-    abi?: string[];
-}
-/**
- * Event Filter Interface
- */
-export interface EventFilter {
-    address?: string;
-    topics?: (string | string[])[];
-    fromBlock?: number | "latest";
-    toBlock?: number | "latest";
-}
-/**
- * Event Log Interface
- */
-export interface EventLog {
-    address: string;
-    topics: string[];
-    data: string;
-    blockNumber: number;
-    transactionHash: string;
-    logIndex: number;
-}

package/dist/interfaces/chunks/contract-types.i.d.ts

@@ -1,171 +0,0 @@
-/**
- * Smart Contract Type Interfaces
- *
- * These interfaces define the TypeScript types for smart contracts used in the SDK.
- * They are independent definitions - NOT imported from the contracts package.
- * Based on Solidity interfaces from contracts/src/interfaces/
- */
-import type { BaseContract, ContractTransactionResponse } from "ethers";
-/**
- * Position Manager Contract Interface
- * Based on contracts/src/interfaces/IPositionManager.sol
- */
-export interface PositionManager extends BaseContract {
-    createPosition(pkpId: string, validatorSignature: string, mainnetVaultAddress: string, regtestVaultAddress: string, selectedTermMonths: number | bigint, validatorVersion: number | bigint, pkpPublicKey: string): Promise<ContractTransactionResponse>;
-    mintUCD(positionId: string, mintAmount: bigint, mintFee: bigint, newDebt: bigint, newCollateral: bigint, btcPrice: bigint, authorizedSpendsHash: string, ucdDebtHash: string, contractHash: string, quantumTimestamp: bigint, mintValidatorSignature: string): Promise<ContractTransactionResponse>;
-    liquidatePosition(positionId: string, btcPrice: bigint, quantumTimestamp: bigint, liquidationValidatorSignature: string): Promise<ContractTransactionResponse>;
-    getPosition(positionId: string): Promise<{
-        positionId: string;
-        pkpId: string;
-        ucdDebt: bigint;
-        borrower: string;
-        createdAt: number;
-        lastUpdated: number;
-        selectedTerm: number;
-        expiryAt: number;
-        status: number;
-    }>;
-    extendPosition(positionId: string, selectedTerm: bigint, quantumTimestamp: bigint, btcPrice: bigint, availableBTCBalance: bigint, proRataRenewalFee: bigint, extensionValidatorSignature: string): Promise<ContractTransactionResponse>;
-    commitLiquidation(positionId: string, quantumTimestamp: bigint, btcPrice: bigint, btcVaultBalance: bigint, liquidationValidatorSignature: string, overrides?: object): Promise<ContractTransactionResponse>;
-    revealAndLiquidate(positionId: string, quantumTimestamp: bigint, btcPrice: bigint, btcVaultBalance: bigint, liquidationValidatorSignature: string, deadline: bigint, overrides?: object): Promise<ContractTransactionResponse>;
-    makePayment(positionId: string, paymentAmount: bigint | string, quantumTimestamp: bigint | string, btcPrice: bigint | string, paymentValidatorSignature: string): Promise<ContractTransactionResponse>;
-    pkpValidationRegistry(): Promise<string>;
-    updateBalance(positionId: string, newBtcBalance: string | number | bigint, btcPrice: string | number | bigint, quantumTimestamp: string | number | bigint, signature: string): Promise<ContractTransactionResponse>;
-}
-/**
- * Loan Operations Manager Contract Interface
- * Based on contracts/src/interfaces/ILoanOperationsManager.sol
- */
-export interface ILoanOperationsManager extends BaseContract {
-    mintUCD(positionId: string, mintAmount: bigint, mintFee: bigint, newDebt: bigint, newCollateral: bigint, btcPrice: bigint, authorizedSpendsHash: string, ucdDebtHash: string, quantumTimestamp: bigint): Promise<ContractTransactionResponse>;
-    processPayment(positionId: string, paymentAmount: bigint, quantumTimestamp: bigint, btcPrice: bigint): Promise<ContractTransactionResponse>;
-    updatePosition(positionId: string, newDebt: bigint, quantumTimestamp: bigint, btcPrice: bigint, updateValidatorSignature: string): Promise<ContractTransactionResponse>;
-    transferFee(recipient: string, amount: bigint): Promise<ContractTransactionResponse>;
-    mintExtensionFee(amount: bigint): Promise<ContractTransactionResponse>;
-    feeBalance(): Promise<bigint>;
-    setFeeRecipientRegistry(registry: string): Promise<ContractTransactionResponse>;
-    feeRecipientRegistry(): Promise<string>;
-    authorizeBTCSpend(positionId: string, txid: string, vout: number, satoshis: bigint, targetAddress: string, targetAmount: bigint, litSignature: string): Promise<ContractTransactionResponse>;
-    liquidationThreshold(): Promise<bigint>;
-    minimumLoanValueWei(): Promise<bigint>;
-    ucdToken(): Promise<string>;
-    getUcdController(): Promise<string>;
-    getPKPActualCollateral(pkpId: string): Promise<bigint>;
-    isPriceFeedStale(): Promise<boolean>;
-    calculateCollateralRatio(positionId: string, btcPrice: bigint): Promise<bigint>;
-    getTotalAuthorizedSats(positionId: string): Promise<bigint>;
-    extendPosition(positionId: string, newTermMonths: bigint, extensionFee: bigint, quantumTimestamp: bigint, btcPrice: bigint, extendValidatorSignature: string): Promise<ContractTransactionResponse>;
-    withdrawBTC(positionId: string, btcTxid: string, btcVout: number, satoshis: bigint, destinationAddress: string, quantumTimestamp: bigint, btcPrice: bigint, btcWithdrawalSignature: string): Promise<ContractTransactionResponse>;
-}
-/**
- * UCD Controller Contract Interface
- * Based on contracts/src/interfaces/IUCDController.sol
- */
-export interface IUCDController extends BaseContract {
-    mintFromLoanOps(to: string, amount: bigint, positionId: string, debtAfterMint: bigint): Promise<ContractTransactionResponse>;
-    mintFromPsm(to: string, amount: bigint, stablecoin: string, amountIn: bigint): Promise<ContractTransactionResponse>;
-    burnTokens(from: string, amount: bigint): Promise<ContractTransactionResponse>;
-    setAdminModule(_adminModule: string): Promise<ContractTransactionResponse>;
-    setAuthorizedMinter(minter: string, authorized: boolean): Promise<ContractTransactionResponse>;
-    setAuthorizedBurner(burner: string, authorized: boolean): Promise<ContractTransactionResponse>;
-    setMaxSupply(newMaxSupply: bigint): Promise<ContractTransactionResponse>;
-    setDailyMintLimit(newLimit: bigint): Promise<ContractTransactionResponse>;
-    setDailyBurnLimit(newLimit: bigint): Promise<ContractTransactionResponse>;
-    setUCDToken(newToken: string): Promise<ContractTransactionResponse>;
-    getCurrentSupply(): Promise<bigint>;
-    getRemainingMintCapacity(): Promise<bigint>;
-    getRemainingBurnCapacity(): Promise<bigint>;
-    getRemainingPsmMintCapacity(): Promise<bigint>;
-    isAuthorizedMinter(account: string): Promise<boolean>;
-    isAuthorizedBurner(account: string): Promise<boolean>;
-    authorizedMinters(account: string): Promise<boolean>;
-    authorizedBurners(account: string): Promise<boolean>;
-    burnedPerAddress(account: string): Promise<bigint>;
-    totalMinted(): Promise<bigint>;
-    totalBurned(): Promise<bigint>;
-    maxSupply(): Promise<bigint>;
-    dailyMintLimit(): Promise<bigint>;
-    dailyBurnLimit(): Promise<bigint>;
-    lastMintReset(): Promise<bigint>;
-    lastBurnReset(): Promise<bigint>;
-    dailyMinted(): Promise<bigint>;
-    dailyBurned(): Promise<bigint>;
-    dailyPsmMinted(): Promise<bigint>;
-    psmDailyMintLimit(): Promise<bigint>;
-    circuitBreaker(): Promise<string>;
-    ucdToken(): Promise<string>;
-    adminModule(): Promise<string>;
-}
-/**
- * Price Feed Consumer Contract Interface
- */
-export interface IPriceFeedConsumer extends BaseContract {
-    updatePrice(): Promise<ContractTransactionResponse>;
-    getCurrentPrice(): Promise<bigint>;
-    getPriceAge(): Promise<bigint>;
-    isPriceStale(): Promise<boolean>;
-    validatePriceFeed(): Promise<boolean>;
-    getLatestBTCPrice(): Promise<bigint>;
-    decimals(): Promise<number>;
-}
-/**
- * Term Manager Contract Interface
- * Based on contracts/src/interfaces/ITermManager.sol
- */
-export interface ITermManager extends BaseContract {
-    addTerm(termMonths: bigint, originationFee: bigint, extensionFee: bigint): Promise<ContractTransactionResponse>;
-    removeTerm(termMonths: bigint): Promise<ContractTransactionResponse>;
-    updateTermFees(termMonths: bigint, originationFee: bigint, extensionFee: bigint): Promise<ContractTransactionResponse>;
-    getTermFees(termMonths: bigint): Promise<{
-        originationFee: bigint;
-        extensionFee: bigint;
-    }>;
-    isValidTerm(termMonths: bigint): Promise<boolean>;
-    getValidTermsWithFees(): Promise<{
-        terms: bigint[];
-        originationFees: bigint[];
-        extensionFees: bigint[];
-    }>;
-    getTermDataById(termId: bigint): Promise<{
-        termMonths: bigint;
-        originationFee: bigint;
-        extensionFee: bigint;
-        isActive: boolean;
-    }>;
-    getAllTerms(): Promise<bigint[]>;
-    updateDependencies(newCore: string, newUcdController: string): Promise<ContractTransactionResponse>;
-    supportsInterface(interfaceId: string): Promise<boolean>;
-}
-/**
- * Circuit Breaker Module Contract Interface
- * Based on contracts/src/interfaces/ICircuitBreakerModule.sol
- */
-export interface CircuitBreakerModule extends BaseContract {
-    circuitBreakerCheck(ucdAmount: bigint, btcAmount: bigint): Promise<ContractTransactionResponse>;
-    proposeLimitUpdate(newMaxLoanValue: bigint, newMaxBtcPerPosition: bigint, newDailyLimit: bigint): Promise<ContractTransactionResponse>;
-    signLimitUpdate(proposalHash: string): Promise<ContractTransactionResponse>;
-    executeLimitUpdate(proposalHash: string, newMaxLoanValue: bigint, newMaxBtcPerPosition: bigint, newDailyLimit: bigint): Promise<ContractTransactionResponse>;
-    activateCircuitBreaker(): Promise<ContractTransactionResponse>;
-    deactivateCircuitBreaker(): Promise<ContractTransactionResponse>;
-    signCircuitBreakerDeactivation(): Promise<ContractTransactionResponse>;
-    maxSingleLoanValue(): Promise<bigint>;
-    maxBtcPerPosition(): Promise<bigint>;
-    dailyVolumeLimit(): Promise<bigint>;
-    circuitBreakerActive(): Promise<boolean>;
-    circuitBreakerActivatedAt(): Promise<bigint>;
-    dailyUcdVolume(day: bigint): Promise<bigint>;
-    dailyBtcVolume(day: bigint): Promise<bigint>;
-    supportsInterface(interfaceId: string): Promise<boolean>;
-}
-/**
- * Liquidation Manager Contract Interface
- * Based on contracts/src/interfaces/ILiquidationManager.sol
- */
-export interface ILiquidationManager extends BaseContract {
-    liquidatePosition(positionId: string, btcPrice: bigint, quantumTimestamp: bigint): Promise<ContractTransactionResponse>;
-    commitLiquidation(positionId: string, quantumTimestamp: bigint, btcPrice: bigint): Promise<ContractTransactionResponse>;
-    revealAndLiquidate(positionId: string, quantumTimestamp: bigint, btcPrice: bigint, liquidationValidatorSignature: string, deadline: bigint): Promise<ContractTransactionResponse>;
-    isLiquidatable(positionId: string, btcPrice: bigint, quantumTimestamp: bigint, liquidationValidatorSignature: string): Promise<boolean>;
-    vrfSeeds(positionId: string): Promise<bigint>;
-    supportsInterface(interfaceId: string): Promise<boolean>;
-}

package/dist/interfaces/chunks/lit-actions-results.i.d.ts

@@ -1,165 +0,0 @@
-/**
- * Typed responses for critical Diamond Hands LIT Actions.
- *
- * These mirror the JSON payloads passed to `Lit.Actions.setResponse(...)`
- * in the lit-actions package and are intended to be used as the `TData`
- * parameter on `LitActionResult<TData>`.
- */
-import type { PositionId } from "../../types/branded/ids";
-/**
- * Base shape for approval-style validator responses.
- */
-export interface BaseValidatorResponse {
-    approved: boolean;
-    positionId?: PositionId | string;
-    reason?: string;
-    failedStep?: string;
-    timestamp: number | string;
-    /**
-     * Optional low-level execution error from lit-ops / LIT runtime.
-     */
-    error?: string;
-    /**
-     * Some flows attach the raw signature JSON here (service wrappers).
-     */
-    signature?: string;
-}
-/**
- * UCD Mint Validator response (ucdMintValidator).
- * Source: lit-actions/src/ucd-mint-validator.ts
- */
-export interface UcdMintValidatorResponse extends BaseValidatorResponse {
-    approved: true;
-    mintAmount: string;
-    mintFee: string;
-    newDebt: string;
-    newCollateral: string;
-    newCollateralRatioBps: number;
-    btcPrice: string;
-    authorizedSpendsHash: string;
-    ucdDebtHash: string;
-    contractBundleHash: string;
-    signature: string;
-    validatorPkp: string;
-    /**
-     * Optional: Exact parameter values used for signing.
-     * If present, SDK should use these values instead of response values
-     * to ensure contract receives identical parameters that were signed.
-     */
-    signingParams?: {
-        positionId: string;
-        actionHash: string;
-        authorizedSpendsHash: string;
-        ucdDebtHash: string;
-        contractBundleHash: string;
-        btcPrice: string;
-        mintAmount: string;
-        mintFee: string;
-        newCollateral: string;
-        newDebt: string;
-        timestamp: string;
-    };
-}
-export interface UcdMintValidatorErrorResponse extends BaseValidatorResponse {
-    approved: false;
-}
-export type UcdMintValidatorResult = UcdMintValidatorResponse | UcdMintValidatorErrorResponse;
-/**
- * BTC Withdrawal Validator response (btcWithdrawal).
- * Source: lit-actions/src/btc-withdrawal.ts
- */
-export interface BtcWithdrawalValidatorResponse extends BaseValidatorResponse {
-    approved: true;
-    actionHash: string;
-    authorizedSpendsHash: string;
-    ucdDebtHash: string;
-    totalDeduction: string;
-    remainingCollateral: string;
-    newCollateralRatioBps?: number;
-    destinationAddress: string;
-    signature: string;
-    btcPrice: string;
-    /**
-     * Optional UTXO fields used by enhanced BTC withdrawal flow.
-     * These are populated by the LIT Action when BIP-143 validation is enabled.
-     */
-    utxoTxid?: string;
-    utxoVout?: number;
-}
-export interface BtcWithdrawalValidatorErrorResponse extends BaseValidatorResponse {
-    approved: false;
-}
-export type BtcWithdrawalValidatorResult = BtcWithdrawalValidatorResponse | BtcWithdrawalValidatorErrorResponse;
-/**
- * Liquidation Validator response (liquidationValidator).
- * Source: lit-actions/src/liquidation-validator.ts
- */
-export interface LiquidationValidatorResponse extends BaseValidatorResponse {
-    approved: true;
-    btcPrice: string;
-    btcAmountSats: string;
-    signature: string;
-    signatureBonus: string;
-    validatorPkp: string;
-}
-export interface LiquidationValidatorErrorResponse extends BaseValidatorResponse {
-    approved: false;
-}
-export type LiquidationValidatorResult = LiquidationValidatorResponse | LiquidationValidatorErrorResponse;
-/**
- * Extend Position Validator response (extendPositionValidator).
- * Source: lit-actions/src/extend-position-validator.ts
- */
-export interface ExtendPositionValidatorResponse extends BaseValidatorResponse {
-    approved: true;
-    selectedTerm: number;
-    btcPrice: string;
-    availableBTCBalance: string;
-    extensionFee: string;
-    newTotalDebt: string;
-    newCollateralRatioBps: string;
-    signature: string;
-    timestamp: number;
-    quantumTimestamp: number;
-    validatorPkp: string;
-}
-export interface ExtendPositionValidatorErrorResponse extends BaseValidatorResponse {
-    approved: false;
-}
-export type ExtendPositionValidatorResult = ExtendPositionValidatorResponse | ExtendPositionValidatorErrorResponse;
-/**
- * Process Payment Validator response (processPaymentValidator).
- * Source: lit-actions/src/process-payment-validator.ts
- */
-export interface ProcessPaymentValidatorResponse extends BaseValidatorResponse {
-    approved: true;
-    paymentAmount: string;
-    btcPrice: string;
-    btcAmountSats: string;
-    signature: string;
-    timestamp: number;
-    validatorPkp: string;
-}
-export interface ProcessPaymentValidatorErrorResponse extends BaseValidatorResponse {
-    approved: false;
-}
-export type ProcessPaymentValidatorResult = ProcessPaymentValidatorResponse | ProcessPaymentValidatorErrorResponse;
-/**
- * Loan vault BTC balance / deposit validator response (loanVaultBtcBalance).
- * Source: lit-actions/src/loan-vault-btc-balance.ts
- */
-export interface LoanVaultBtcBalanceValidatorResponse {
-    vaultAddress: string;
-    vaultBalance: string;
-    positionId: PositionId | string;
-    btcPrice: string;
-    signature: string;
-    timestamp: number;
-    validatorPkp: string;
-}
-export interface LoanVaultBtcBalanceValidatorErrorResponse {
-    error: string;
-    positionId: PositionId | string | null;
-    timestamp: number;
-}
-export type LoanVaultBtcBalanceValidatorResult = LoanVaultBtcBalanceValidatorResponse | LoanVaultBtcBalanceValidatorErrorResponse;

package/dist/interfaces/chunks/lit-actions.i.d.ts

@@ -1,98 +0,0 @@
-/**
- * LIT Action Types and Interfaces (SDK boundary)
- *
- * This file provides the strongly-typed SDK view of LIT Actions and
- * re-exports the action registry interfaces from the @gvnrdao/dh-lit-actions
- * package so that action names and configs stay in sync across packages.
- */
-import type { DiamondHandsLitActions, LitActionName } from "@gvnrdao/dh-lit-actions";
-import type { UcdMintValidatorResult, BtcWithdrawalValidatorResult, LiquidationValidatorResult, ExtendPositionValidatorResult, ProcessPaymentValidatorResult, LoanVaultBtcBalanceValidatorResult } from "./lit-actions-results.i";
-/**
- * Re-export registry types so SDK consumers can use the same action name space.
- */
-export type { DiamondHandsLitActions, LitActionName };
-/**
- * Core LIT Action execution description.
- *
- * TParams describes the jsParams structure, TAuth describes the authSig shape.
- * Both default to safe, unknown-based records instead of `any`.
- */
-export interface ILitAction<TParams extends Record<string, unknown> = Record<string, unknown>, TAuth = LitActionAuth> {
-    code: string;
-    ipfsId?: string;
-    jsParams: TParams;
-    authSig: TAuth;
-}
-/**
- * Parameters passed to lit-node-client.executeJs.
- *
- * This mirrors ILitAction but is named for historic reasons.
- */
-export interface LitActionParams<TParams extends Record<string, unknown> = Record<string, unknown>, TAuth = LitActionAuth> {
-    code: string;
-    jsParams: TParams;
-    authSig: TAuth;
-    debug?: boolean;
-    pkpId?: string;
-    userAddress?: string;
-    /**
-     * Collateral amount used by some actions (e.g. mint flows).
-     * Replaces legacy btcAmount naming.
-     */
-    collateralAmount?: string;
-}
-/**
- * Raw result returned from LIT Action execution.
- *
- * Callers are encouraged to wrap this in action-specific result
- * types instead of accessing the generic `data` bag directly.
- */
-export interface LitActionResult<TData = unknown> {
-    success: boolean;
-    signedData?: unknown;
-    decryptedData?: unknown;
-    claimedKeyId?: string;
-    signatures?: unknown;
-    /**
-     * Alias for signatures used by some helpers.
-     */
-    signature?: string;
-    decryptions?: unknown;
-    claims?: unknown;
-    response?: string;
-    logs?: string;
-    /**
-     * Action-specific payload. Prefer narrowing this via generics.
-     */
-    data?: TData;
-    /**
-     * Human-readable error (if any).
-     */
-    error?: string;
-}
-/**
- * Discriminated union of typed results for the core Diamond Hands actions.
- *
- * This can be used by higher-level SDK helpers to express that a given
- * execution is expected to return a particular validator payload.
- */
-export type DiamondHandsLitActionResult = LitActionResult<UcdMintValidatorResult> | LitActionResult<BtcWithdrawalValidatorResult> | LitActionResult<LiquidationValidatorResult> | LitActionResult<ExtendPositionValidatorResult> | LitActionResult<ProcessPaymentValidatorResult> | LitActionResult<LoanVaultBtcBalanceValidatorResult>;
-/**
- * Standard EIP-191 style authorization signature used by LIT.
- */
-export interface LitActionAuth {
-    sig: string;
-    derivedVia: string;
-    signedMessage: string;
-    address: string;
-}
-/**
- * Generic validation result used by some helper actions.
- *
- * Callers should prefer action-specific result types where available.
- */
-export interface LitActionValidationResult<TDetails = unknown> {
-    valid: boolean;
-    error?: string;
-    details?: TDetails;
-}