@gvnrdao/dh-lit-actions 0.0.60 → 0.0.63

package/pkg-dist/src/interfaces/chunks/circuit-breaker.i.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Circuit Breaker Interface
+ *
+ * Defines types for circuit breaker status and related information.
+ */
+export interface CircuitBreakerStatus {
+    isTriggered: boolean;
+    triggerReason?: string;
+    triggeredAt?: number;
+}
+export interface SystemHealthStatus {
+    ucdControllerPaused: boolean;
+    circuitBreakerTriggered: boolean;
+    oracleEmergencyMode: boolean;
+    transfersPaused: boolean;
+    timestamp: number;
+}
+//# sourceMappingURL=circuit-breaker.i.d.ts.map

package/pkg-dist/src/interfaces/chunks/circuit-breaker.i.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/circuit-breaker.i.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,OAAO,CAAC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/pkg-dist/src/interfaces/chunks/circuit-breaker.i.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Circuit Breaker Interface
+ *
+ * Defines types for circuit breaker status and related information.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=circuit-breaker.i.js.map

package/pkg-dist/src/interfaces/chunks/circuit-breaker.i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.i.js","sourceRoot":"","sources":["../../../../src/interfaces/chunks/circuit-breaker.i.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/pkg-dist/src/interfaces/chunks/mint-authorization.i.d.ts

@@ -0,0 +1,24 @@
+export interface MintAuthorizationParams {
+    positionId: string;
+    requestedAmount: string;
+    btcAddress: string;
+    positionManagerAddress: string;
+    loanOpsManagerAddress: string;
+}
+export interface MintAuthorizationData {
+    positionId: string;
+    btcAddress: string;
+    totalBTCBalance: number;
+    authorizedBTCBalance: number;
+    availableBTCBalance: number;
+    btcPriceUSD: number;
+    requestedAmount: string;
+    timestamp: number;
+    collateralRatio: number;
+}
+export interface ValidationResult {
+    approved: boolean;
+    reason?: string;
+    authData?: MintAuthorizationData;
+}
+//# sourceMappingURL=mint-authorization.i.d.ts.map

package/pkg-dist/src/interfaces/chunks/mint-authorization.i.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint-authorization.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/mint-authorization.i.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC"}

package/pkg-dist/src/interfaces/chunks/mint-authorization.i.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// AuthorizedSpend is imported from vault-balance.i.ts
+// No need to redefine it here
+//# sourceMappingURL=mint-authorization.i.js.map

package/pkg-dist/src/interfaces/chunks/mint-authorization.i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint-authorization.i.js","sourceRoot":"","sources":["../../../../src/interfaces/chunks/mint-authorization.i.ts"],"names":[],"mappings":";;AA0BA,sDAAsD;AACtD,8BAA8B"}

package/pkg-dist/src/interfaces/chunks/owner-authorization.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Owner Authorization Interface
+ *
+ * Parameters required to authorize owner-only LIT Action operations
+ */
+interface Authorization {
+    timestamp: number;
+    chainId: number;
+    signature: string;
+    mode: "dev" | "prod";
+}
+interface OwnerAuthorization extends Authorization {
+    positionId: string;
+}
+interface ActionAuthorization extends Authorization {
+    action: string;
+}
+interface AmountAuthorization extends Authorization {
+    amount: string | bigint;
+}
+interface ToAuthorization extends Authorization {
+    destinationAddress: string;
+}
+/**
+ * Authorization parameters for owner-only actions
+ *
+ * Used to verify that a caller is authorized to perform operations on a position.
+ *
+ * Security model:
+ * - signature: EIP-191 signature from position owner proving authorization
+ * - positionId: Identifies which position the operation affects
+ * - timestamp: Prevents replay attacks with old signatures
+ * - chainId: Prevents cross-chain replay attacks
+ * - amount: Amount of UCD to mint (part of signed message)
+ * - action: Type of operation (e.g., "mint-ucd") (part of signed message)
+ * - mode: Execution environment mode
+ *
+ * The LIT Action recovers the signer address from the signature and validates
+ * it matches the position owner queried from the PositionManager contract.
+ */
+export interface OwnerAmountActionAuthorization extends OwnerAuthorization, AmountAuthorization, ActionAuthorization {
+}
+/**
+ * Authorization parameters for withdrawal operations
+ *
+ * Extends OwnerAmountActionAuthorization with destination address.
+ *
+ * Security model:
+ * - All base authorization checks (signature, owner, timestamp, chainId)
+ * - destinationAddress: Bitcoin address where funds will be withdrawn (signed)
+ * - amount: Amount in satoshis to withdraw (signed)
+ * - action: "withdraw-btc" (signed)
+ *
+ * The destination address is part of the signed authorization to prevent
+ * unauthorized redirection of withdrawal funds.
+ */
+export interface OwnerAmountToActionAuthorization extends OwnerAuthorization, AmountAuthorization, ToAuthorization, ActionAuthorization {
+}
+export {};
+//# sourceMappingURL=owner-authorization.d.ts.map

package/pkg-dist/src/interfaces/chunks/owner-authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-authorization.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/owner-authorization.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,aAAa;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;CACtB;AAED,UAAU,kBAAmB,SAAQ,aAAa;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,mBAAoB,SAAQ,aAAa;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,mBAAoB,SAAQ,aAAa;IACjD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,UAAU,eAAgB,SAAQ,aAAa;IAC7C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,8BACf,SAAQ,kBAAkB,EACxB,mBAAmB,EACnB,mBAAmB;CAAG;AAE1B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gCACf,SAAQ,kBAAkB,EACxB,mBAAmB,EACnB,eAAe,EACf,mBAAmB;CAAG"}

package/pkg-dist/src/interfaces/chunks/owner-authorization.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Owner Authorization Interface
+ *
+ * Parameters required to authorize owner-only LIT Action operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=owner-authorization.js.map

package/pkg-dist/src/interfaces/chunks/owner-authorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-authorization.js","sourceRoot":"","sources":["../../../../src/interfaces/chunks/owner-authorization.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/pkg-dist/src/interfaces/chunks/price-oracle.i.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Price Source Configuration
+ */
+export interface PriceSourceConfig {
+    name: string;
+    fetchPrice: () => Promise<number>;
+    priority: number;
+}
+/**
+ * Price Oracle Module Interface
+ *
+ * Defines the contract for price oracle implementations.
+ */
+export interface IPriceOracle {
+    /**
+     * Get BTC price in USD with 8 decimals
+     * @returns BTC price (e.g., 10000000000000n = $100,000)
+     */
+    getBTCPrice(): Promise<bigint>;
+    /**
+     * Get BTC price with consensus validation across multiple sources
+     * @returns BTC price with outlier filtering
+     */
+    getBTCPriceConsensus(): Promise<bigint>;
+}
+//# sourceMappingURL=price-oracle.i.d.ts.map

package/pkg-dist/src/interfaces/chunks/price-oracle.i.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-oracle.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/price-oracle.i.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/B;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC"}

package/pkg-dist/src/interfaces/chunks/price-oracle.i.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=price-oracle.i.js.map

package/pkg-dist/src/interfaces/chunks/price-oracle.i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-oracle.i.js","sourceRoot":"","sources":["../../../../src/interfaces/chunks/price-oracle.i.ts"],"names":[],"mappings":""}

package/pkg-dist/src/interfaces/chunks/vault-balance-module.i.d.ts

@@ -0,0 +1,23 @@
+import { VaultBalanceResult } from "./vault-balance.i";
+/**
+ * Vault Balance Module Interface
+ *
+ * Defines the contract for vault balance calculation implementations.
+ */
+export interface IVaultBalance {
+    /**
+     * Calculate trusted balance for a position
+     * @param positionId - Position identifier
+     * @param vaultAddress - Bitcoin vault address
+     * @returns Complete balance breakdown
+     */
+    calculateTrustedBalance(positionId: string, vaultAddress: string): Promise<VaultBalanceResult>;
+    /**
+     * Get available balance in satoshis
+     * @param positionId - Position identifier
+     * @param vaultAddress - Bitcoin vault address
+     * @returns Available balance
+     */
+    getTrustedBalance(positionId: string, vaultAddress: string): Promise<bigint>;
+}
+//# sourceMappingURL=vault-balance-module.i.d.ts.map

package/pkg-dist/src/interfaces/chunks/vault-balance-module.i.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-balance-module.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-balance-module.i.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,uBAAuB,CACrB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9E"}

package/pkg-dist/src/interfaces/chunks/vault-balance-module.i.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vault-balance-module.i.js.map

package/pkg-dist/src/interfaces/chunks/vault-balance-module.i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-balance-module.i.js","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-balance-module.i.ts"],"names":[],"mappings":""}

package/pkg-dist/src/interfaces/chunks/vault-balance.i.d.ts

@@ -0,0 +1,63 @@
+export interface UTXO {
+    txid: string;
+    vout: number;
+    satoshis: bigint;
+    confirmations: number;
+}
+export interface UTXOSet {
+    utxos: UTXO[];
+    totalBalance: bigint;
+    totalUTXOs: number;
+    confirmedBalance: bigint;
+    unconfirmedBalance: bigint;
+}
+export interface BitcoinDataSource {
+    name: string;
+    url: string;
+    priority: number;
+}
+/**
+ * Bitcoin RPC Helper Interface
+ * Minimal interface for Bitcoin Core RPC operations
+ */
+export interface IBitcoinRPCHelper {
+    listUnspent(wallet: string, address: string): Promise<any[]>;
+    getTransaction(wallet: string, txid: string): Promise<any>;
+}
+export interface BitcoinDataProviderConfig {
+    providerUrl: string;
+    fallbackProviders?: BitcoinDataSource[];
+    timeout?: number;
+    rpcHelper?: IBitcoinRPCHelper;
+    rpcWallet?: string;
+}
+export interface AuthorizedSpend {
+    txid: string;
+    vout: number;
+    satoshis: bigint;
+    positionId: string;
+    targetAddress: string;
+    targetAmount: bigint;
+    changeAddress: string;
+    timestamp: number;
+}
+export interface VaultBalanceResult {
+    totalUTXOs: UTXO[];
+    totalBalance: bigint;
+    authorizedUTXOs: AuthorizedSpend[];
+    authorizedBalance: bigint;
+    availableUTXOs: UTXO[];
+    availableBalance: bigint;
+    vaultAddress: string;
+    positionId: string;
+    timestamp: number;
+}
+export interface VaultBalanceConfig {
+    contractAddress: string;
+    chain: string;
+    chainId: number;
+    rpcUrl?: string;
+    bitcoinProvider: import("./bitcoin-data-provider.i").IBitcoinDataProvider;
+    minConfirmations?: number;
+}
+//# sourceMappingURL=vault-balance.i.d.ts.map

package/pkg-dist/src/interfaces/chunks/vault-balance.i.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-balance.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-balance.i.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,IAAI,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,2BAA2B,EAAE,oBAAoB,CAAC;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/pkg-dist/src/interfaces/chunks/vault-balance.i.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vault-balance.i.js.map

package/pkg-dist/src/interfaces/chunks/vault-balance.i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-balance.i.js","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-balance.i.ts"],"names":[],"mappings":""}

package/pkg-dist/src/interfaces/chunks/vault-snapshot.i.d.ts

@@ -0,0 +1,51 @@
+import { UTXO } from "./vault-balance.i";
+import { IVaultBalance } from "./vault-balance-module.i";
+import { IPriceOracle } from "./price-oracle.i";
+/**
+ * Complete vault snapshot with all calculated metrics
+ */
+export interface VaultSnapshot {
+    positionId: string;
+    pkpId: string;
+    borrower: string;
+    vaultAddress: string;
+    ucdDebt: bigint;
+    termStartTimestamp: number;
+    selectedTerm: number;
+    status: number;
+    totalBTCSats: bigint;
+    totalUTXOs: UTXO[];
+    authorizedSpendsSats: bigint;
+    availableBTCSats: bigint;
+    availableUTXOs: UTXO[];
+    btcPriceUsd: bigint;
+    collateralValueUsd: bigint;
+    collateralRatioBps: number;
+    termDurationDays: number;
+    termLengthDays: number;
+    isExpired: boolean;
+    daysUntilExpiry: number;
+    daysIntoGracePeriod: number;
+    currentLiquidationThreshold: number;
+    isLiquidatable: boolean;
+    marginToLiquidationBps: number;
+    liquidationThresholdBps: number;
+    originationFeeBps: number;
+    extensionFeeBps: number;
+    timestamp: number;
+    blockHeight?: number;
+}
+/**
+ * Configuration for vault snapshot module
+ */
+export interface VaultSnapshotConfig {
+    contractAddress: string;
+    chain: string;
+    chainId?: number;
+    rpcUrl?: string;
+    vaultBalance: IVaultBalance;
+    priceOracle: IPriceOracle;
+    termManagerAddress: string;
+    loanOpsManagerAddress: string;
+}
+//# sourceMappingURL=vault-snapshot.i.d.ts.map

package/pkg-dist/src/interfaces/chunks/vault-snapshot.i.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-snapshot.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-snapshot.i.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAE5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IAGf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,IAAI,EAAE,CAAC;IAGvB,WAAW,EAAE,MAAM,CAAC;IAGpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAG3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,2BAA2B,EAAE,MAAM,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAG/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IAGxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,aAAa,CAAC;IAC5B,WAAW,EAAE,YAAY,CAAC;IAG1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;CAC/B"}

package/pkg-dist/src/interfaces/chunks/vault-snapshot.i.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vault-snapshot.i.js.map

package/pkg-dist/src/interfaces/chunks/vault-snapshot.i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-snapshot.i.js","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-snapshot.i.ts"],"names":[],"mappings":""}

package/pkg-dist/src/interfaces/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Interface exports
+ *
+ * Centralized export point for all interface definitions.
+ * Interfaces are organized in chunks/*.i.ts files.
+ */
+export * from "./chunks/authorization.i";
+export * from "./chunks/mint-authorization.i";
+export * from "./chunks/bitcoin-data-provider.i";
+export { UTXO, VaultBalanceResult, VaultBalanceConfig, } from "./chunks/vault-balance.i";
+export * from "./chunks/vault-balance-module.i";
+export * from "./chunks/price-oracle.i";
+export * from "./chunks/vault-snapshot.i";
+export * from "./chunks/owner-authorization";
+//# sourceMappingURL=index.d.ts.map

package/pkg-dist/src/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,IAAI,EACJ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC"}

package/pkg-dist/src/interfaces/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Interface exports
+ *
+ * Centralized export point for all interface definitions.
+ * Interfaces are organized in chunks/*.i.ts files.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./chunks/authorization.i"), exports);
+__exportStar(require("./chunks/mint-authorization.i"), exports);
+__exportStar(require("./chunks/bitcoin-data-provider.i"), exports);
+__exportStar(require("./chunks/vault-balance-module.i"), exports);
+__exportStar(require("./chunks/price-oracle.i"), exports);
+__exportStar(require("./chunks/vault-snapshot.i"), exports);
+__exportStar(require("./chunks/owner-authorization"), exports);
+//# sourceMappingURL=index.js.map

package/pkg-dist/src/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,2DAAyC;AACzC,gEAA8C;AAC9C,mEAAiD;AAMjD,kEAAgD;AAChD,0DAAwC;AACxC,4DAA0C;AAC1C,+DAA6C"}

package/pkg-dist/src/modules/authorization.module.d.ts

@@ -0,0 +1,160 @@
+import { OwnerAmountActionAuthorization } from "../interfaces";
+/**
+ * Authorization Module
+ *
+ * Validates that LIT Action callers are authorized to perform operations.
+ *
+ * RESTORED PRODUCTION-GRADE DESIGN (from b2794c9):
+ * - Quantum timestamp prevents replay across different quantums
+ * - Waits for safe quantum moment before validation
+ * - Validates timestamp is within current quantum window
+ * - Signature proves caller identity
+ * - Contract verification proves ownership
+ *
+ * Authorization Flow:
+ * 1. Wait for safe quantum moment (if in dead zone)
+ * 2. Verify timestamp is within valid quantum window
+ * 3. Build message hash from parameters (positionId, timestamp, chainId, amount, action)
+ * 4. Recover signer address from signature (EIP-191 standard)
+ * 5. Verify recovered signer === position owner (from contract)
+ *
+ * Security Properties:
+ * - Quantum timing enforces 100-second windows with dead zone protection
+ * - Smart contract only accepts one operation per quantum per position
+ * - Signature proves caller owns the signing address
+ * - Contract verification proves signer is position owner
+ * - chainId prevents cross-chain replay attacks
+ * - Mode controls whether dev environments (hardhat/regtest) are allowed
+ *
+ * Example: mintUCD
+ * - Message: keccak256(positionId, timestamp, chainId, amount, actionHash)
+ * - User signs with wallet (EIP-191)
+ * - LIT Action WAITS for safe quantum moment
+ * - LIT Action VALIDATES quantum timestamp
+ * - LIT Action recovers signer address
+ * - LIT Action verifies signer is position owner (via contract)
+ */
+/**
+ * Authorization Module
+ *
+ * Provides methods to verify caller authorization for LIT Actions
+ */
+export declare class AuthorizationModule {
+    /**
+     * Verify auth structure for amount/position/action operations
+     *
+     * Validates that all required fields are present and have correct types:
+     * - positionId (string, required)
+     * - chainId (number, required)
+     * - timestamp (number, required)
+     * - amount (required, any type that can convert to bigint)
+     * - action (string, required)
+     * - signature (string, required)
+     * - mode ("dev" or "prod", required)
+     *
+     * @param auth - Authorization object to validate (untyped)
+     * @returns Typed OwnerAmountActionAuthorization object after validation
+     * @throws Error if any validation fails
+     */
+    static verifyAmountPositionActionAuthorizationStructure(auth: any): OwnerAmountActionAuthorization;
+    /**
+     * Recover signer address from signature
+     *
+     * Uses EIP-191 standard (Ethereum Signed Message)
+     *
+     * @param messageHash - Keccak256 hash of the message
+     * @param signature - Signature to verify
+     * @returns Recovered signer address
+     */
+    static recoverSigner(messageHash: string, signature: string): Promise<string>;
+    /**
+     * Agnostic authorization verification
+     *
+     * Verifies authorization for any action by:
+     * 1. Waiting for safe quantum moment
+     * 2. Validating quantum timestamp
+     * 3. Building message hash using provided buildMessage function
+     * 4. Recovering signer from signature
+     * 5. Checking authorization using provided isAuthorized function
+     *
+     * @param auth - Authorization parameters (timestamp, signature, mode)
+     * @param buildMessage - Function to build message hash (caller has context/closure)
+     * @param isAuthorized - Function to check if recovered address is authorized (caller has context/closure)
+     * @returns True if authorized
+     */
+    static verifyActionAuthorization(auth: {
+        timestamp: number;
+        signature: string;
+        mode: "dev" | "prod";
+    }, buildMessage: () => string, isAuthorized: (recovered: string) => boolean): Promise<boolean>;
+    /**
+     * Verify position owner authorization for any amount-based position action
+     *
+     * AGNOSTIC BASE FUNCTION - verifies authorization without checking action string
+     * Specific action verification functions should validate action string before calling this.
+     *
+     * RESTORED PRODUCTION-GRADE QUANTUM VALIDATION:
+     * - STEP 1: Waits for safe quantum moment (avoids dead zone)
+     * - STEP 2: Validates timestamp is within current quantum window
+     * - STEP 3: Builds message hash from parameters
+     * - STEP 4: Recovers signer from signature
+     * - STEP 5: Verifies signer matches position owner
+     *
+     * Message contains: positionId, timestamp, chainId, amount, action
+     * NO callerAddress in message (recovered from signature via ecrecover)
+     *
+     * @param auth - Authorization parameters (positionId, timestamp, chainId, amount, action, signature, mode)
+     * @param positionOwner - Position owner address from contract
+     * @returns True if authorized
+     */
+    static verifyAmountPositionActionAuthorization(auth: {
+        positionId: string;
+        timestamp: number;
+        chainId: number;
+        amount: string | bigint;
+        action: string;
+        signature: string;
+        mode: "dev" | "prod";
+    }, positionOwner: string): Promise<boolean>;
+    /**
+     * Verify position owner authorization for mintUCD action
+     *
+     * Validates action string is "mint-ucd" then delegates to base function.
+     *
+     * @param auth - Authorization parameters (positionId, timestamp, chainId, amount, action, signature, mode)
+     * @param positionOwner - Position owner address from contract
+     * @returns True if authorized
+     */
+    static verifyMintAuthorization(auth: {
+        positionId: string;
+        timestamp: number;
+        chainId: number;
+        amount: string | bigint;
+        action: string;
+        signature: string;
+        mode: "dev" | "prod";
+    }, positionOwner: string): Promise<boolean>;
+    /**
+     * Verify position owner authorization for withdrawBTC action
+     *
+     * Validates action string is "withdraw-btc" and includes destinationAddress in message.
+     * Unlike mint/repay, withdrawal requires destination address to prevent unauthorized redirection.
+     *
+     * Message contains: positionId, timestamp, chainId, amount, destinationAddress, action
+     *
+     * @param auth - Authorization parameters (positionId, timestamp, chainId, amount, destinationAddress, action, signature, mode)
+     * @param positionOwner - Position owner address from contract
+     * @returns True if authorized
+     */
+    static verifyWithdrawAuthorization(auth: {
+        positionId: string;
+        timestamp: number;
+        chainId: number;
+        amount: string | bigint;
+        destinationAddress: string;
+        action: string;
+        signature: string;
+        mode: "dev" | "prod";
+    }, positionOwner: string): Promise<boolean>;
+}
+//# sourceMappingURL=authorization.module.d.ts.map

package/pkg-dist/src/modules/authorization.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.module.d.ts","sourceRoot":"","sources":["../../../src/modules/authorization.module.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAM/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,gDAAgD,CACrD,IAAI,EAAE,GAAG,GACR,8BAA8B;IA4CjC;;;;;;;;OAQG;WACU,aAAa,CACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAyBlB;;;;;;;;;;;;;;OAcG;WACU,yBAAyB,CACpC,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;KACtB,EACD,YAAY,EAAE,MAAM,MAAM,EAC1B,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAC3C,OAAO,CAAC,OAAO,CAAC;IAuEnB;;;;;;;;;;;;;;;;;;;OAmBG;WACU,uCAAuC,CAClD,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;KACtB,EACD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;IAoDnB;;;;;;;;OAQG;WACU,uBAAuB,CAClC,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;KACtB,EACD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;IAanB;;;;;;;;;;;OAWG;WACU,2BAA2B,CACtC,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;KACtB,EACD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;CA4DpB"}