@gvnrdao/dh-sdk 0.0.288 → 0.0.289

package/browser/dist/browser.js.LICENSE.txt

@@ -5,19 +5,14 @@
  * @license  MIT
  */
 
-/*! Axios v1.15.2 Copyright (c) 2026 Matt Zabriskie and contributors */
+/*! Axios v1.18.1 Copyright (c) 2026 Matt Zabriskie and contributors */
+
+/*! MIT License. Copyright 2015-2022 Richard Moore <me@ricmoo.com>. See LICENSE.txt. */
 
 /*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
 
+/*! noble-curves - MIT License (c) 2022 Paul Miller (paulmillr.com) */
+
 /*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) */
 
 /*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */
-
-/**
- * [js-sha3]{@link https://github.com/emn178/js-sha3}
- *
- * @version 0.8.0
- * @author Chen, Yi-Cyuan [emn178@gmail.com]
- * @copyright Chen, Yi-Cyuan 2015-2018
- * @license MIT
- */

package/dist/constants/chunks/contract-abis.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Smart Contract ABIs (public SDK surface)
+ *
+ * Only ABIs that remain HAND-WRITTEN live here. Anything that drifts with
+ * frequent contract changes (PositionManager, SimplePSMV2, LiquidationManager,
+ * etc.) MUST be consumed via the typechain factories instead:
+ *
+ *   import { PositionManager__factory } from "@gvnrdao/dh-sdk";
+ *
+ * H-A / H-B (2026-05-17 post-audit review):
+ *   Removed `POSITION_MANAGER_ABI` and `PSM_ABI`. Both had drifted from the
+ *   deployed contracts (`extendPosition` 6-vs-7 params; `setRenewalRestriction`
+ *   2-vs-1 args; stale `liquidatePosition`; etc.) and external consumers using
+ *   these hand-written exports produced reverting calldata. Force typechain-only
+ *   for these public surfaces. A CI drift check in `.github/workflows/
+ *   contracts-pr-checks.yml` keeps `sdk/src/contracts/typechain-contracts/` in
+ *   lockstep with `contracts/typechain-types/`.
+ */
+export declare const UCD_TOKEN_ABI: readonly ["function balanceOf(address account) external view returns (uint256)", "function transfer(address to, uint256 amount) external returns (bool)", "function approve(address spender, uint256 amount) external returns (bool)", "function allowance(address owner, address spender) external view returns (uint256)", "function mint(address to, uint256 amount) external", "function burn(uint256 amount) external", "function burnFrom(address account, uint256 amount) external", "event Transfer(address indexed from, address indexed to, uint256 value)", "event Approval(address indexed owner, address indexed spender, uint256 value)"];
+export declare const PRICE_FEED_CONSUMER_ABI: readonly ["function getCurrentPrice() external view returns (uint256)", "function isPriceStale() external view returns (bool)", "function updatePrice() external", "event PriceUpdated(uint256 indexed price, uint256 timestamp)"];

package/dist/constants/chunks/deployment-addresses.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Auto-generated deployment addresses
+ * Generated by scripts/sync-deployments.js
+ * Do not edit manually - this file is overwritten during build
+ */
+export interface DeploymentLatestEnv {
+    [key: string]: string | number | undefined;
+}
+export interface DeploymentContracts {
+    PositionManagerProxy?: string;
+    PositionManager?: string;
+    PositionManagerCoreModule?: string;
+    PositionManagerViews?: string;
+    SimplePSMV2?: string;
+    LoanOperationsManagerModule?: string;
+    BTCSpendAuthorizer?: string;
+    TermManagerModule?: string;
+    CircuitBreakerModule?: string;
+    LiquidationManagerModule?: string;
+    CollateralManagerModule?: string;
+    AdminModule?: string;
+    UCDToken?: string;
+    UCDController?: string;
+    UCDMintingRewards?: string;
+    UpgradeValidator?: string;
+    BTCProofValidator?: string;
+    LITActionValidator?: string;
+    BitcoinProviderRegistry?: string;
+    ContractVersionRegistry?: string;
+    /** FeeRecipientRegistry — M-8 fix: allowlist of addresses authorised to receive protocol fee transfers from LoanOperationsManager.transferFee and SimplePSMV2.transferFee. */
+    FeeRecipientRegistry?: string;
+    /** PositionDelegateRegistry — stores per-position off-chain auth delegates (Safe-as-borrower flows). */
+    PositionDelegateRegistry?: string;
+    /** BitcoinWithdrawalAddressRegistry — per-wallet allowlist of approved BTC withdrawal destinations (24h time-lock). */
+    BitcoinWithdrawalAddressRegistry?: string;
+    PriceFeedConsumer?: string;
+    OperationAuthorizationRegistry?: string;
+    PKPValidation?: string;
+    EmergencyStorageUpdate?: string;
+    mockUsdcToken?: string;
+    mockUsdcOwner?: string;
+    mockUsdtToken?: string;
+    mockUsdtOwner?: string;
+    [key: string]: string | undefined;
+}
+export interface DeploymentData {
+    network: string;
+    chainId?: number;
+    timestamp: string;
+    deployer: string;
+    contracts: DeploymentContracts;
+    /** Flat assignments from contracts/deployments/full-{network}-latest.env (proxies, impls, validators, etc.) */
+    latestEnv?: DeploymentLatestEnv;
+    [key: string]: any;
+}
+export declare const SEPOLIA_DEPLOYMENT: DeploymentData;
+export declare const SEPOLIA_CONTRACTS: DeploymentContracts;
+export declare const MAINNET_DEPLOYMENT: DeploymentData;
+export declare const MAINNET_CONTRACTS: DeploymentContracts;
+export declare const LOCALHOST_DEPLOYMENT: DeploymentData;
+export declare const LOCALHOST_CONTRACTS: DeploymentContracts;
+export declare const ALL_DEPLOYMENTS: {
+    readonly sepolia: DeploymentData;
+    readonly mainnet: DeploymentData;
+    readonly localhost: DeploymentData;
+};
+export declare const ALL_CONTRACTS: {
+    readonly sepolia: DeploymentContracts;
+    readonly mainnet: DeploymentContracts;
+    readonly localhost: DeploymentContracts;
+};
+/**
+ * Get deployment data by network name
+ */
+export declare function getDeploymentByNetwork(network: string): DeploymentData | null;
+/**
+ * Get contract addresses by network name
+ */
+export declare function getContractsByNetwork(network: string): DeploymentContracts | null;

package/dist/constants/chunks/encrypted-provider-params.d.ts

@@ -0,0 +1,21 @@
+export type EncryptedPriceProvider = {
+    name: string;
+    pkpId: string;
+    apiKey: string;
+    apiSecret?: string;
+};
+type RegistryProvider = {
+    name: string;
+    pkpId: string;
+    apiKeyEncrypted: string;
+    apiSecretEncrypted?: string;
+    version: number;
+    updatedAt: string;
+};
+type EncryptedParamsRegistry = {
+    network: string;
+    providers: RegistryProvider[];
+};
+export declare function loadEncryptedProviderRegistry(registryPath?: string): EncryptedParamsRegistry;
+export declare function getEncryptedPriceProviders(providerNames?: string[], registryPath?: string): EncryptedPriceProvider[];
+export {};

package/dist/constants/chunks/environment.browser.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Environment Configuration for Diamond Hands SDK - Browser Version
+ * Browser-compatible environment handling without Node.js dependencies
+ */
+import { LitNetwork } from "@gvnrdao/dh-lit-ops";
+/** SDK environment label — mirrors `LIT_NETWORK` for supported networks. */
+export type EnvironmentName = "chipotle";
+export interface SDKConfig {
+    environment: EnvironmentName;
+    litNetwork: LitNetwork;
+    realLitTesting: boolean;
+    debugMode: boolean;
+    runRealIntegrationTests: boolean;
+    litRelayUrl?: string;
+    ethRpcUrl: string;
+    polygonRpcUrl: string;
+}
+/**
+ * Resolved Lit network from `LIT_NETWORK` / `VITE_LIT_NETWORK` (default: production **chipotle**).
+ */
+export declare function resolveLitNetworkFromEnv(): LitNetwork;
+/**
+ * SDK environment label derived from `LIT_NETWORK` (default **chipotle**).
+ */
+export declare function getCurrentEnvironment(): EnvironmentName;
+/**
+ * Load and validate SDK configuration from environment
+ */
+export declare function loadSDKConfig(): SDKConfig;
+/**
+ * Get LIT Network configuration
+ */
+export declare function getLitNetworkConfig(networkName: LitNetwork): LitNetwork;
+/**
+ * Environment-aware console logging
+ */
+export declare function envLog(message: string, ...args: any[]): void;
+/**
+ * Validate SDK environment requirements
+ */
+export declare function validateSDKEnvironment(requirements: {
+    requiresRealLitTesting?: boolean;
+    requiresPrivateKey?: boolean;
+}): SDKConfig;

package/dist/constants/chunks/environment.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Environment Configuration for Diamond Hands SDK (Node only)
+ *
+ * Loads and validates environment variables with multi-path `.env` discovery.
+ * Used for server-side flows that may read `PKP_MINT_PRIVATE_KEY`.
+ *
+ * **Do not import this file from browser-oriented modules.** Import via
+ * `@gvnrdao/dh-sdk/server` only. Shared / client code should use `environment.browser`.
+ *
+ * **Observability:** With `DEBUG_SDK=true`, logs once which `.env` paths were attempted
+ * and which existing files were merged (later overrides earlier).
+ *
+ * **Strict merge checks:** Detecting conflicting definitions of the same variable across
+ * multiple `.env` files is not implemented; reserved for a future CI-gated workflow once
+ * the repo has automated SDK checks in CI.
+ */
+import { LitNetwork } from "@gvnrdao/dh-lit-ops";
+/** SDK environment label — mirrors `LIT_NETWORK` for supported networks. */
+export type EnvironmentName = "chipotle";
+export interface SDKConfig {
+    environment: EnvironmentName;
+    litNetwork: LitNetwork;
+    realLitTesting: boolean;
+    debugMode: boolean;
+    runRealIntegrationTests: boolean;
+    litRelayUrl?: string;
+    ethRpcUrl: string;
+    polygonRpcUrl: string;
+    pkpMintPrivateKey?: string;
+}
+/**
+ * Resolved Lit network from `LIT_NETWORK` (default: production **chipotle**).
+ */
+export declare function resolveLitNetworkFromEnv(): LitNetwork;
+/**
+ * SDK environment label derived from `LIT_NETWORK` (default **chipotle**).
+ */
+export declare function getCurrentEnvironment(): EnvironmentName;
+/**
+ * Load and validate SDK configuration from environment
+ */
+export declare function loadSDKConfig(): SDKConfig;
+/**
+ * Get LIT Network configuration
+ */
+export declare function getLitNetworkConfig(networkName: LitNetwork): LitNetwork;
+/**
+ * Environment-aware console logging
+ */
+export declare function envLog(message: string, ...args: any[]): void;
+/**
+ * Validate SDK environment requirements
+ */
+export declare function validateSDKEnvironment(requirements: {
+    requiresRealLitTesting?: boolean;
+    requiresPrivateKey?: boolean;
+}): SDKConfig;

package/dist/constants/chunks/network-configs.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Network Configuration Constants
+ * Automatically loads contract addresses from deployment files
+ * Browser-friendly implementation with silent fallbacks
+ */
+/**
+ * Network Configuration Interface
+ */
+export interface NetworkConfig {
+    mode: "service" | "standalone";
+    serviceEndpoint: string;
+    chainId: number;
+    name: string;
+    rpcUrls: string[];
+    contractAddresses: {
+        positionManager: string;
+        positionManagerCore?: string;
+        positionManagerViews?: string;
+        simplePsmV2?: string;
+        loanOperationsManager?: string;
+        termManager?: string;
+        circuitBreaker?: string;
+        liquidationManager?: string;
+        ucdToken: string;
+        ucdController?: string;
+        priceFeedConsumer: string;
+        operationAuthorizationRegistry?: string;
+        btcSpendAuthorizer?: string;
+        bitcoinProviderRegistry?: string;
+        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 gating borrower-initiated BTC withdrawal destinations (24h time-lock). */
+        bitcoinWithdrawalAddressRegistry?: string;
+        mockUsdcToken?: string;
+        mockUsdtToken?: string;
+        mockUsdcOwner?: string;
+    };
+    subgraphs: {
+        diamondHandsUrl?: string;
+        tokenGvnrUrl?: string;
+    };
+    litNetwork: string;
+    validatorVersion?: number;
+    debug: boolean;
+}
+/**
+ * Network Configuration Registry
+ */
+export declare const NETWORK_CONFIGS: Record<number, NetworkConfig>;
+/**
+ * Get network configuration by chain ID
+ */
+export declare function getNetworkConfig(chainId: number): NetworkConfig | null;
+/**
+ * Get network configuration by human-readable name (e.g., "sepolia")
+ */
+export declare function getNetworkConfigByName(name: string): NetworkConfig | null;
+/**
+ * Get all supported network configurations
+ */
+export declare function getAllNetworkConfigs(): NetworkConfig[];
+/**
+ * Check if a network is supported
+ */
+export declare function isNetworkSupported(chainId: number): boolean;
+/**
+ * Default network fallbacks
+ */
+export declare const DEFAULT_NETWORK_CONFIG: Partial<NetworkConfig>;

package/dist/constants/chunks/sdk-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SDK Configuration Constants
+ */
+import type { LitNetwork } from "@gvnrdao/dh-lit-ops";
+export declare const DEFAULT_NETWORKS: {
+    readonly ETHEREUM_MAINNET: "https://eth-mainnet.g.alchemy.com/v2/";
+    readonly ETHEREUM_SEPOLIA: "https://eth-sepolia.g.alchemy.com/v2/";
+    readonly POLYGON_MAINNET: "https://polygon-mainnet.g.alchemy.com/v2/";
+    readonly LOCAL_HARDHAT: "http://localhost:8545";
+};
+export declare const DEFAULT_LIT_NETWORKS: {
+    readonly CHIPOTLE: "chipotle";
+};
+/**
+ * Default Lit network when `LIT_NETWORK` is unset or config omits `litNetwork`.
+ */
+export declare const DEFAULT_LIT_NETWORK: "chipotle";
+/** Supported Lit Protocol networks for this SDK (Chipotle). */
+export declare const VALID_LIT_NETWORKS: readonly LitNetwork[];
+export declare const SDK_DEFAULTS: {
+    readonly SESSION_EXPIRATION_MINUTES: 60;
+    readonly TRANSACTION_TIMEOUT_MS: 30000;
+    readonly RETRY_ATTEMPTS: 3;
+    readonly DEBUG: false;
+};
+export declare const SDK_ERROR_MESSAGES: {
+    readonly NOT_INITIALIZED: "SDK not initialized. Call initialize() first.";
+    readonly INVALID_CONFIG: "Invalid SDK configuration provided.";
+    readonly NETWORK_ERROR: "Network connection error occurred.";
+    readonly TRANSACTION_FAILED: "Transaction failed to execute.";
+    readonly PKP_CREATION_FAILED: "PKP creation failed.";
+    readonly SIGNATURE_INVALID: "Invalid signature provided.";
+};

package/dist/constants/chunks/sdk-limits.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SDK Limits and Configuration Constants
+ * Centralized constants for magic numbers used throughout the SDK
+ */
+/**
+ * Maximum batch size for The Graph queries
+ * The Graph has a hard limit of 1000 items per query
+ */
+export declare const THE_GRAPH_MAX_BATCH_SIZE = 1000;
+/**
+ * Maximum rows per page for pagination
+ * Prevents excessive memory usage and query timeouts
+ */
+export declare const MAX_PAGINATION_ROWS = 1000;
+/**
+ * Default rows per page for pagination
+ */
+export declare const DEFAULT_PAGINATION_ROWS = 10;
+/**
+ * Default maximum number of retries for failed operations
+ */
+export declare const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Default operation timeout in milliseconds
+ */
+export declare const DEFAULT_OPERATION_TIMEOUT_MS = 30000;
+/**
+ * Default PKP address cache size
+ */
+export declare const DEFAULT_PKP_CACHE_SIZE = 500;
+/**
+ * Default PKP address cache TTL in milliseconds
+ */
+export declare const DEFAULT_PKP_CACHE_TTL_MS = 300000;
+/**
+ * Default balance cache size
+ */
+export declare const DEFAULT_BALANCE_CACHE_SIZE = 1000;
+/**
+ * Default balance cache TTL in milliseconds
+ */
+export declare const DEFAULT_BALANCE_CACHE_TTL_MS = 60000;
+/**
+ * Default cache cleanup interval in milliseconds
+ */
+export declare const DEFAULT_CACHE_CLEANUP_INTERVAL_MS = 300000;
+/**
+ * Default number of blocks for PSM rate limit reset period
+ */
+export declare const PSM_RATE_LIMIT_RESET_BLOCKS = 100;
+/**
+ * Maximum operations per PSM rate limit window
+ */
+export declare const PSM_MAX_OPERATIONS_PER_WINDOW = 10;
+/**
+ * Default maximum concurrent operations
+ */
+export declare const DEFAULT_CONCURRENCY_LIMIT = 10;
+/**
+ * Default Bitcoin provider consensus mode
+ */
+export declare const DEFAULT_BITCOIN_CONSENSUS_MODE: "majority";
+/**
+ * Minimum number of Bitcoin providers for consensus
+ */
+export declare const MIN_BITCOIN_PROVIDERS_FOR_CONSENSUS = 2;

package/dist/constants/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Diamond Hands SDK Constants
+ * All constants used in the SDK package
+ *
+ * Following the golden source pattern with organized chunks
+ *
+ * **Environment:** This barrel exports **browser-safe** `environment.browser` only.
+ * For Node-only config including `PKP_MINT_PRIVATE_KEY` / dotenv paths, use
+ * `@gvnrdao/dh-sdk/server` (see `src/server.ts`).
+ */
+export * from "./chunks/sdk-config";
+export * from "./chunks/network-configs";
+export * from "./chunks/environment.browser";
+export * from "./chunks/contract-abis";
+export * from "./chunks/sdk-limits";

package/dist/contracts/typechain-contracts/common.d.ts

@@ -0,0 +1,50 @@
+import type { FunctionFragment, Typed, EventFragment, ContractTransaction, ContractTransactionResponse, DeferredTopicFilter, EventLog, TransactionRequest, LogDescription } from "ethers";
+export interface TypedDeferredTopicFilter<_TCEvent extends TypedContractEvent> extends DeferredTopicFilter {
+}
+export interface TypedContractEvent<InputTuple extends Array<any> = any, OutputTuple extends Array<any> = any, OutputObject = any> {
+    (...args: Partial<InputTuple>): TypedDeferredTopicFilter<TypedContractEvent<InputTuple, OutputTuple, OutputObject>>;
+    name: string;
+    fragment: EventFragment;
+    getFragment(...args: Partial<InputTuple>): EventFragment;
+}
+type __TypechainAOutputTuple<T> = T extends TypedContractEvent<infer _U, infer W> ? W : never;
+type __TypechainOutputObject<T> = T extends TypedContractEvent<infer _U, infer _W, infer V> ? V : never;
+export interface TypedEventLog<TCEvent extends TypedContractEvent> extends Omit<EventLog, "args"> {
+    args: __TypechainAOutputTuple<TCEvent> & __TypechainOutputObject<TCEvent>;
+}
+export interface TypedLogDescription<TCEvent extends TypedContractEvent> extends Omit<LogDescription, "args"> {
+    args: __TypechainAOutputTuple<TCEvent> & __TypechainOutputObject<TCEvent>;
+}
+export type TypedListener<TCEvent extends TypedContractEvent> = (...listenerArg: [
+    ...__TypechainAOutputTuple<TCEvent>,
+    TypedEventLog<TCEvent>,
+    ...undefined[]
+]) => void;
+export type MinEthersFactory<C, ARGS> = {
+    deploy(...a: ARGS[]): Promise<C>;
+};
+export type GetContractTypeFromFactory<F> = F extends MinEthersFactory<infer C, any> ? C : never;
+export type GetARGsTypeFromFactory<F> = F extends MinEthersFactory<any, any> ? Parameters<F["deploy"]> : never;
+export type StateMutability = "nonpayable" | "payable" | "view";
+export type BaseOverrides = Omit<TransactionRequest, "to" | "data">;
+export type NonPayableOverrides = Omit<BaseOverrides, "value" | "blockTag" | "enableCcipRead">;
+export type PayableOverrides = Omit<BaseOverrides, "blockTag" | "enableCcipRead">;
+export type ViewOverrides = Omit<TransactionRequest, "to" | "data">;
+export type Overrides<S extends StateMutability> = S extends "nonpayable" ? NonPayableOverrides : S extends "payable" ? PayableOverrides : ViewOverrides;
+export type PostfixOverrides<A extends Array<any>, S extends StateMutability> = A | [...A, Overrides<S>];
+export type ContractMethodArgs<A extends Array<any>, S extends StateMutability> = PostfixOverrides<{
+    [I in keyof A]-?: A[I] | Typed;
+}, S>;
+export type DefaultReturnType<R> = R extends Array<any> ? R[0] : R;
+export interface TypedContractMethod<A extends Array<any> = Array<any>, R = any, S extends StateMutability = "payable"> {
+    (...args: ContractMethodArgs<A, S>): S extends "view" ? Promise<DefaultReturnType<R>> : Promise<ContractTransactionResponse>;
+    name: string;
+    fragment: FunctionFragment;
+    getFragment(...args: ContractMethodArgs<A, S>): FunctionFragment;
+    populateTransaction(...args: ContractMethodArgs<A, S>): Promise<ContractTransaction>;
+    staticCall(...args: ContractMethodArgs<A, "view">): Promise<DefaultReturnType<R>>;
+    send(...args: ContractMethodArgs<A, S>): Promise<ContractTransactionResponse>;
+    estimateGas(...args: ContractMethodArgs<A, S>): Promise<bigint>;
+    staticCallResult(...args: ContractMethodArgs<A, "view">): Promise<R>;
+}
+export {};