@gvnrdao/dh-lit-actions 0.0.60 → 0.0.63

package/pkg-dist/src/constants/chunks/bitcoin-network-config.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Bitcoin Network Configuration
+ *
+ * Defines approved Bitcoin RPC providers and network mappings for the protocol.
+ * This ensures LIT actions only use vetted, reliable Bitcoin data sources.
+ *
+ * CRITICAL: Only approved providers should be added to this configuration.
+ */
+/**
+ * Supported EVM chains
+ */
+export declare enum EVMChain {
+    /** Ethereum Sepolia testnet */
+    SEPOLIA = "sepolia",
+    /** Ethereum mainnet */
+    ETHEREUM = "ethereum",
+    /** Hardhat local testnet */
+    HARDHAT = "hardhat"
+}
+/**
+ * Bitcoin network types
+ */
+export declare enum BitcoinNetwork {
+    /** Bitcoin testnet */
+    TESTNET = "testnet",
+    /** Bitcoin mainnet */
+    MAINNET = "mainnet",
+    /** Bitcoin regtest (local/testing) */
+    REGTEST = "regtest"
+}
+/**
+ * Bitcoin provider configuration
+ */
+export interface BitcoinProviderConfig {
+    /** Provider API URL */
+    url: string;
+    /** Bitcoin network (testnet or mainnet) */
+    network: BitcoinNetwork;
+    /** Minimum confirmations required for this provider/network */
+    minConfirmations: number;
+    /** Human-readable provider name */
+    name: string;
+}
+/**
+ * Mapping from EVM chain to Bitcoin network
+ *
+ * - Sepolia (testnet) → Bitcoin Testnet
+ * - Ethereum (mainnet) → Bitcoin Mainnet
+ */
+export declare const CHAIN_TO_BITCOIN_NETWORK: Record<EVMChain, BitcoinNetwork>;
+/**
+ * Mapping from EVM chain to chain ID
+ *
+ * - Ethereum mainnet: 1
+ * - Sepolia testnet: 11155111
+ * - Hardhat local: 31337
+ */
+export declare const CHAIN_TO_CHAIN_ID: Record<EVMChain, number>;
+/**
+ * Approved Bitcoin RPC providers per network
+ *
+ * Only providers in this whitelist can be used by LIT actions.
+ * Each provider has specific min confirmation requirements.
+ *
+ * TESTNET: Lower confirmation requirements (1 block)
+ * REGTEST: Lower confirmation requirements (1 block)
+ * MAINNET: Higher confirmation requirements (6 blocks - industry standard)
+ */
+export declare const APPROVED_BITCOIN_PROVIDERS: Record<BitcoinNetwork, BitcoinProviderConfig[]>;
+/**
+ * Validate and normalize EVM chain input
+ *
+ * @param chain Chain identifier (case-insensitive)
+ * @returns Validated EVMChain enum value
+ * @throws Error if chain is not supported
+ */
+export declare function validateChain(chain: string): EVMChain;
+/**
+ * Get Bitcoin network for EVM chain
+ *
+ * @param chain EVM chain
+ * @returns Corresponding Bitcoin network
+ */
+export declare function getBitcoinNetworkForChain(chain: EVMChain): BitcoinNetwork;
+/**
+ * Get chain ID for EVM chain
+ *
+ * @param chain EVM chain
+ * @returns Corresponding chain ID
+ */
+export declare function getChainIdForChain(chain: EVMChain): number;
+/**
+ * Validate Bitcoin provider is approved for network
+ *
+ * @param providerUrl Bitcoin provider URL
+ * @param bitcoinNetwork Bitcoin network (testnet or mainnet)
+ * @returns Provider configuration if approved
+ * @throws Error if provider is not approved for network
+ */
+export declare function validateBitcoinProvider(providerUrl: string, bitcoinNetwork: BitcoinNetwork): BitcoinProviderConfig;
+/**
+ * Validate Bitcoin provider is approved (DEV MODE)
+ *
+ * In development mode, we don't enforce chain → Bitcoin network mapping.
+ * The caller decides which Bitcoin network to use for any EVM chain.
+ * We only validate that the provider URL is in our approved list.
+ *
+ * @param providerUrl Bitcoin provider URL
+ * @returns Provider configuration with network auto-detected
+ * @throws Error if provider is not approved for any network
+ */
+export declare function getBitcoinProviderConfig(providerUrl: string): BitcoinProviderConfig;
+/**
+ * Get list of approved provider URLs for a chain
+ *
+ * Useful for displaying options to users or validating inputs.
+ *
+ * @param chain EVM chain
+ * @returns Array of approved provider URLs for that chain's Bitcoin network
+ */
+export declare function getApprovedProvidersForChain(chain: EVMChain): string[];
+/**
+ * Get human-readable provider name from URL
+ *
+ * @param providerUrl Provider URL
+ * @param bitcoinNetwork Bitcoin network
+ * @returns Provider name or URL if not found
+ */
+export declare function getProviderName(providerUrl: string, bitcoinNetwork: BitcoinNetwork): string;
+//# sourceMappingURL=bitcoin-network-config.d.ts.map

package/pkg-dist/src/constants/chunks/bitcoin-network-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-network-config.d.ts","sourceRoot":"","sources":["../../../../src/constants/chunks/bitcoin-network-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,+BAA+B;IAC/B,OAAO,YAAY;IAEnB,uBAAuB;IACvB,QAAQ,aAAa;IAErB,4BAA4B;IAC5B,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,sBAAsB;IACtB,OAAO,YAAY;IAEnB,sBAAsB;IACtB,OAAO,YAAY;IAEnB,sCAAsC;IACtC,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IAEZ,2CAA2C;IAC3C,OAAO,EAAE,cAAc,CAAC;IAExB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IAEzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAIrE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAItD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,cAAc,EACd,qBAAqB,EAAE,CAwDxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAmBrD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B,qBAAqB,CAgBvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAwBvB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B,MAAM,CAKR"}

package/pkg-dist/src/constants/chunks/bitcoin-network-config.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Bitcoin Network Configuration
+ *
+ * Defines approved Bitcoin RPC providers and network mappings for the protocol.
+ * This ensures LIT actions only use vetted, reliable Bitcoin data sources.
+ *
+ * CRITICAL: Only approved providers should be added to this configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPROVED_BITCOIN_PROVIDERS = exports.CHAIN_TO_CHAIN_ID = exports.CHAIN_TO_BITCOIN_NETWORK = exports.BitcoinNetwork = exports.EVMChain = void 0;
+exports.validateChain = validateChain;
+exports.getBitcoinNetworkForChain = getBitcoinNetworkForChain;
+exports.getChainIdForChain = getChainIdForChain;
+exports.validateBitcoinProvider = validateBitcoinProvider;
+exports.getBitcoinProviderConfig = getBitcoinProviderConfig;
+exports.getApprovedProvidersForChain = getApprovedProvidersForChain;
+exports.getProviderName = getProviderName;
+/**
+ * Supported EVM chains
+ */
+var EVMChain;
+(function (EVMChain) {
+    /** Ethereum Sepolia testnet */
+    EVMChain["SEPOLIA"] = "sepolia";
+    /** Ethereum mainnet */
+    EVMChain["ETHEREUM"] = "ethereum";
+    /** Hardhat local testnet */
+    EVMChain["HARDHAT"] = "hardhat";
+})(EVMChain || (exports.EVMChain = EVMChain = {}));
+/**
+ * Bitcoin network types
+ */
+var BitcoinNetwork;
+(function (BitcoinNetwork) {
+    /** Bitcoin testnet */
+    BitcoinNetwork["TESTNET"] = "testnet";
+    /** Bitcoin mainnet */
+    BitcoinNetwork["MAINNET"] = "mainnet";
+    /** Bitcoin regtest (local/testing) */
+    BitcoinNetwork["REGTEST"] = "regtest";
+})(BitcoinNetwork || (exports.BitcoinNetwork = BitcoinNetwork = {}));
+/**
+ * Mapping from EVM chain to Bitcoin network
+ *
+ * - Sepolia (testnet) → Bitcoin Testnet
+ * - Ethereum (mainnet) → Bitcoin Mainnet
+ */
+exports.CHAIN_TO_BITCOIN_NETWORK = {
+    [EVMChain.SEPOLIA]: BitcoinNetwork.TESTNET,
+    [EVMChain.ETHEREUM]: BitcoinNetwork.MAINNET,
+    [EVMChain.HARDHAT]: BitcoinNetwork.REGTEST, // Local development
+};
+/**
+ * Mapping from EVM chain to chain ID
+ *
+ * - Ethereum mainnet: 1
+ * - Sepolia testnet: 11155111
+ * - Hardhat local: 31337
+ */
+exports.CHAIN_TO_CHAIN_ID = {
+    [EVMChain.ETHEREUM]: 1,
+    [EVMChain.SEPOLIA]: 11155111,
+    [EVMChain.HARDHAT]: 31337,
+};
+/**
+ * Approved Bitcoin RPC providers per network
+ *
+ * Only providers in this whitelist can be used by LIT actions.
+ * Each provider has specific min confirmation requirements.
+ *
+ * TESTNET: Lower confirmation requirements (1 block)
+ * REGTEST: Lower confirmation requirements (1 block)
+ * MAINNET: Higher confirmation requirements (6 blocks - industry standard)
+ */
+exports.APPROVED_BITCOIN_PROVIDERS = {
+    [BitcoinNetwork.REGTEST]: [
+        {
+            url: "https://diamond-hands-btc-faucet-6b39a1072059.herokuapp.com/api",
+            network: BitcoinNetwork.REGTEST,
+            minConfirmations: 1,
+            name: "Diamond Hands",
+        },
+        {
+            url: "http://diamond-hands-btc-faucet-6b39a1072059.herokuapp.com/api",
+            network: BitcoinNetwork.REGTEST,
+            minConfirmations: 1,
+            name: "Diamond Hands",
+        },
+        {
+            url: "http://127.0.0.1:18443",
+            network: BitcoinNetwork.REGTEST,
+            minConfirmations: 1,
+            name: "Local Regtest",
+        },
+        {
+            url: "https://313561dc30c5.ngrok-free.app",
+            network: BitcoinNetwork.REGTEST,
+            minConfirmations: 1,
+            name: "Ngrok Bitcoin Tunnel",
+        },
+    ],
+    [BitcoinNetwork.TESTNET]: [
+        {
+            url: "https://diamond-hands-btc-faucet-6b39a1072059.herokuapp.com/api",
+            network: BitcoinNetwork.TESTNET,
+            minConfirmations: 1,
+            name: "Diamond Hands",
+        },
+        {
+            url: "http://diamond-hands-btc-faucet-6b39a1072059.herokuapp.com/api",
+            network: BitcoinNetwork.TESTNET,
+            minConfirmations: 1,
+            name: "Diamond Hands",
+        },
+    ],
+    [BitcoinNetwork.MAINNET]: [
+        {
+            url: "https://blockstream.info/api",
+            network: BitcoinNetwork.MAINNET,
+            minConfirmations: 6,
+            name: "Blockstream Mainnet",
+        },
+        {
+            url: "https://mempool.space/api",
+            network: BitcoinNetwork.MAINNET,
+            minConfirmations: 6,
+            name: "Mempool.space Mainnet",
+        },
+    ],
+};
+/**
+ * Validate and normalize EVM chain input
+ *
+ * @param chain Chain identifier (case-insensitive)
+ * @returns Validated EVMChain enum value
+ * @throws Error if chain is not supported
+ */
+function validateChain(chain) {
+    const normalized = chain.toLowerCase().trim();
+    if (normalized === "sepolia") {
+        return EVMChain.SEPOLIA;
+    }
+    if (normalized === "ethereum" || normalized === "mainnet") {
+        return EVMChain.ETHEREUM;
+    }
+    if (normalized === "hardhat") {
+        return EVMChain.HARDHAT;
+    }
+    throw new Error(`Unsupported EVM chain: "${chain}". ` +
+        `Supported chains: ${Object.values(EVMChain).join(", ")}`);
+}
+/**
+ * Get Bitcoin network for EVM chain
+ *
+ * @param chain EVM chain
+ * @returns Corresponding Bitcoin network
+ */
+function getBitcoinNetworkForChain(chain) {
+    return exports.CHAIN_TO_BITCOIN_NETWORK[chain];
+}
+/**
+ * Get chain ID for EVM chain
+ *
+ * @param chain EVM chain
+ * @returns Corresponding chain ID
+ */
+function getChainIdForChain(chain) {
+    return exports.CHAIN_TO_CHAIN_ID[chain];
+}
+/**
+ * Validate Bitcoin provider is approved for network
+ *
+ * @param providerUrl Bitcoin provider URL
+ * @param bitcoinNetwork Bitcoin network (testnet or mainnet)
+ * @returns Provider configuration if approved
+ * @throws Error if provider is not approved for network
+ */
+function validateBitcoinProvider(providerUrl, bitcoinNetwork) {
+    const providers = exports.APPROVED_BITCOIN_PROVIDERS[bitcoinNetwork];
+    const config = providers.find((p) => p.url === providerUrl);
+    if (!config) {
+        const approvedUrls = providers
+            .map((p) => `${p.name} (${p.url})`)
+            .join(", ");
+        throw new Error(`Bitcoin provider not approved for ${bitcoinNetwork}. ` +
+            `Provided URL: ${providerUrl}. ` +
+            `Approved providers: ${approvedUrls}`);
+    }
+    return config;
+}
+/**
+ * Validate Bitcoin provider is approved (DEV MODE)
+ *
+ * In development mode, we don't enforce chain → Bitcoin network mapping.
+ * The caller decides which Bitcoin network to use for any EVM chain.
+ * We only validate that the provider URL is in our approved list.
+ *
+ * @param providerUrl Bitcoin provider URL
+ * @returns Provider configuration with network auto-detected
+ * @throws Error if provider is not approved for any network
+ */
+function getBitcoinProviderConfig(providerUrl) {
+    // Search across ALL networks to find this provider
+    for (const network of Object.values(BitcoinNetwork)) {
+        const providers = exports.APPROVED_BITCOIN_PROVIDERS[network];
+        const config = providers.find((p) => p.url === providerUrl);
+        if (config) {
+            // Found it - return with network detected
+            return config;
+        }
+    }
+    // Provider not found in any network
+    const allProviders = Object.entries(exports.APPROVED_BITCOIN_PROVIDERS)
+        .flatMap(([network, providers]) => providers.map((p) => `${network}: ${p.name} (${p.url})`))
+        .join(", ");
+    throw new Error(`Bitcoin provider not approved. ` +
+        `Provided URL: ${providerUrl}. ` +
+        `Approved providers: ${allProviders}`);
+}
+/**
+ * Get list of approved provider URLs for a chain
+ *
+ * Useful for displaying options to users or validating inputs.
+ *
+ * @param chain EVM chain
+ * @returns Array of approved provider URLs for that chain's Bitcoin network
+ */
+function getApprovedProvidersForChain(chain) {
+    const bitcoinNetwork = getBitcoinNetworkForChain(chain);
+    return exports.APPROVED_BITCOIN_PROVIDERS[bitcoinNetwork].map((p) => p.url);
+}
+/**
+ * Get human-readable provider name from URL
+ *
+ * @param providerUrl Provider URL
+ * @param bitcoinNetwork Bitcoin network
+ * @returns Provider name or URL if not found
+ */
+function getProviderName(providerUrl, bitcoinNetwork) {
+    const config = exports.APPROVED_BITCOIN_PROVIDERS[bitcoinNetwork].find((p) => p.url === providerUrl);
+    return config ? config.name : providerUrl;
+}
+//# sourceMappingURL=bitcoin-network-config.js.map

package/pkg-dist/src/constants/chunks/bitcoin-network-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-network-config.js","sourceRoot":"","sources":["../../../../src/constants/chunks/bitcoin-network-config.ts"],"names":[],"mappings":"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"}

package/pkg-dist/src/constants/chunks/bitcoin.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Bitcoin Network Protocol Constants
+ *
+ * These constants define Bitcoin network parameters used by the protocol
+ * for UTXO validation and security.
+ *
+ * CRITICAL: Changes to these values affect Bitcoin security guarantees.
+ */
+/**
+ * Default Minimum Confirmations for UTXO Validity
+ *
+ * Number of block confirmations required before considering a UTXO as "confirmed".
+ * Value: 6 confirmations (~60 minutes on Bitcoin mainnet)
+ *
+ * Bitcoin security standard:
+ * - 1 confirmation: ~10 minutes, low security
+ * - 3 confirmations: ~30 minutes, medium security
+ * - 6 confirmations: ~60 minutes, high security (industry standard)
+ *
+ * This can be overridden for specific use cases (e.g., higher value requires more confirmations).
+ *
+ * Governance-adjustable: YES
+ */
+export declare const BITCOIN_DEFAULT_MIN_CONFIRMATIONS = 6;
+/**
+ * Maximum BTC Amount Validation
+ *
+ * Maximum reasonable BTC amount in satoshis.
+ * Value: 25,000,000 BTC * 1e8 satoshis = 2.5e15 satoshis
+ *
+ * Bitcoin total supply is 21M BTC. Setting to 25M provides safety margin
+ * to account for future protocol needs while preventing overflow attacks.
+ *
+ * This validation prevents:
+ * - Malicious/corrupted data from oracle manipulation
+ * - Integer overflow attacks
+ * - Unrealistic balance claims
+ *
+ * Governance-adjustable: YES (requires contract upgrade)
+ */
+export declare const MAX_BTC_AMOUNT: number;
+//# sourceMappingURL=bitcoin.d.ts.map

package/pkg-dist/src/constants/chunks/bitcoin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.d.ts","sourceRoot":"","sources":["../../../../src/constants/chunks/bitcoin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,QAAmB,CAAC"}

package/pkg-dist/src/constants/chunks/bitcoin.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Bitcoin Network Protocol Constants
+ *
+ * These constants define Bitcoin network parameters used by the protocol
+ * for UTXO validation and security.
+ *
+ * CRITICAL: Changes to these values affect Bitcoin security guarantees.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_BTC_AMOUNT = exports.BITCOIN_DEFAULT_MIN_CONFIRMATIONS = void 0;
+/**
+ * Default Minimum Confirmations for UTXO Validity
+ *
+ * Number of block confirmations required before considering a UTXO as "confirmed".
+ * Value: 6 confirmations (~60 minutes on Bitcoin mainnet)
+ *
+ * Bitcoin security standard:
+ * - 1 confirmation: ~10 minutes, low security
+ * - 3 confirmations: ~30 minutes, medium security
+ * - 6 confirmations: ~60 minutes, high security (industry standard)
+ *
+ * This can be overridden for specific use cases (e.g., higher value requires more confirmations).
+ *
+ * Governance-adjustable: YES
+ */
+exports.BITCOIN_DEFAULT_MIN_CONFIRMATIONS = 6;
+/**
+ * Maximum BTC Amount Validation
+ *
+ * Maximum reasonable BTC amount in satoshis.
+ * Value: 25,000,000 BTC * 1e8 satoshis = 2.5e15 satoshis
+ *
+ * Bitcoin total supply is 21M BTC. Setting to 25M provides safety margin
+ * to account for future protocol needs while preventing overflow attacks.
+ *
+ * This validation prevents:
+ * - Malicious/corrupted data from oracle manipulation
+ * - Integer overflow attacks
+ * - Unrealistic balance claims
+ *
+ * Governance-adjustable: YES (requires contract upgrade)
+ */
+exports.MAX_BTC_AMOUNT = 25000000 * 1e8; // 2.5e15 satoshis
+//# sourceMappingURL=bitcoin.js.map

package/pkg-dist/src/constants/chunks/bitcoin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.js","sourceRoot":"","sources":["../../../../src/constants/chunks/bitcoin.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH;;;;;;;;;;;;;;GAcG;AACU,QAAA,iCAAiC,GAAG,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACU,QAAA,cAAc,GAAG,QAAU,GAAG,GAAG,CAAC,CAAC,kBAAkB"}

package/pkg-dist/src/constants/chunks/decimals.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Decimal Precision Constants
+ *
+ * These constants define the decimal precision for various assets and calculations
+ * in the Diamond Hands Protocol. They ensure consistent precision across all modules.
+ *
+ * CRITICAL: These values MUST match contract implementations.
+ */
+/**
+ * Satoshis per Bitcoin
+ *
+ * Bitcoin's smallest unit is a satoshi (sat).
+ * 1 BTC = 100,000,000 satoshis
+ *
+ * This constant is used for BTC <-> satoshi conversions.
+ *
+ * Governance-adjustable: NO (Bitcoin protocol constant)
+ */
+export declare const SATOSHIS_PER_BITCOIN = 100000000n;
+/**
+ * Price Oracle Decimal Precision
+ *
+ * BTC/USD price is stored with 8 decimal places.
+ * Example: $100,000.00 = 10000000000000n (100000 * 10^8)
+ *
+ * This matches Bitcoin's satoshi precision and allows for sub-cent pricing.
+ *
+ * Governance-adjustable: NO (System design constant)
+ */
+export declare const PRICE_ORACLE_DECIMALS = 100000000n;
+/**
+ * UCD Token Decimal Precision
+ *
+ * UCD is an ERC20 token with 18 decimals (standard for stablecoins).
+ * 1 UCD = 10^18 wei
+ *
+ * This constant is used for all UCD amount calculations.
+ *
+ * CRITICAL: Must match UCD token contract decimals.
+ *
+ * Governance-adjustable: NO (Contract constant)
+ */
+export declare const UCD_TOKEN_DECIMALS = 1000000000000000000n;
+//# sourceMappingURL=decimals.d.ts.map

package/pkg-dist/src/constants/chunks/decimals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimals.d.ts","sourceRoot":"","sources":["../../../../src/constants/chunks/decimals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,aAAe,CAAC;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,aAAe,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,uBAA6B,CAAC"}

package/pkg-dist/src/constants/chunks/decimals.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Decimal Precision Constants
+ *
+ * These constants define the decimal precision for various assets and calculations
+ * in the Diamond Hands Protocol. They ensure consistent precision across all modules.
+ *
+ * CRITICAL: These values MUST match contract implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UCD_TOKEN_DECIMALS = exports.PRICE_ORACLE_DECIMALS = exports.SATOSHIS_PER_BITCOIN = void 0;
+/**
+ * Satoshis per Bitcoin
+ *
+ * Bitcoin's smallest unit is a satoshi (sat).
+ * 1 BTC = 100,000,000 satoshis
+ *
+ * This constant is used for BTC <-> satoshi conversions.
+ *
+ * Governance-adjustable: NO (Bitcoin protocol constant)
+ */
+exports.SATOSHIS_PER_BITCOIN = 100000000n;
+/**
+ * Price Oracle Decimal Precision
+ *
+ * BTC/USD price is stored with 8 decimal places.
+ * Example: $100,000.00 = 10000000000000n (100000 * 10^8)
+ *
+ * This matches Bitcoin's satoshi precision and allows for sub-cent pricing.
+ *
+ * Governance-adjustable: NO (System design constant)
+ */
+exports.PRICE_ORACLE_DECIMALS = 100000000n;
+/**
+ * UCD Token Decimal Precision
+ *
+ * UCD is an ERC20 token with 18 decimals (standard for stablecoins).
+ * 1 UCD = 10^18 wei
+ *
+ * This constant is used for all UCD amount calculations.
+ *
+ * CRITICAL: Must match UCD token contract decimals.
+ *
+ * Governance-adjustable: NO (Contract constant)
+ */
+exports.UCD_TOKEN_DECIMALS = 1000000000000000000n;
+//# sourceMappingURL=decimals.js.map

package/pkg-dist/src/constants/chunks/decimals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimals.js","sourceRoot":"","sources":["../../../../src/constants/chunks/decimals.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH;;;;;;;;;GASG;AACU,QAAA,oBAAoB,GAAG,UAAY,CAAC;AAEjD;;;;;;;;;GASG;AACU,QAAA,qBAAqB,GAAG,UAAY,CAAC;AAElD;;;;;;;;;;;GAWG;AACU,QAAA,kBAAkB,GAAG,oBAA0B,CAAC"}

package/pkg-dist/src/constants/chunks/liquidation.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Liquidation Protocol Constants
+ *
+ * These constants define the liquidation thresholds and grace period escalation
+ * for the Diamond Hands Protocol. They are governance-adjustable parameters.
+ *
+ * CRITICAL: Changes to these values affect protocol security and user positions.
+ */
+/**
+ * Active Loan Liquidation Threshold
+ *
+ * Minimum collateral ratio required for active (non-expired) loans.
+ * Value: 130% (13000 basis points)
+ *
+ * Governance-adjustable: YES
+ */
+export declare const ACTIVE_LOAN_LIQUIDATION_THRESHOLD_BPS = 13000;
+/**
+ * Expired Loan Minimum Liquidation Threshold
+ *
+ * Starting liquidation threshold when loan expires (day 0 of grace period).
+ * Value: 110% (11000 basis points)
+ *
+ * The threshold escalates from this value to MAX over the grace period.
+ *
+ * Governance-adjustable: YES
+ */
+export declare const EXPIRED_LOAN_MIN_LIQUIDATION_THRESHOLD_BPS = 11000;
+/**
+ * Expired Loan Maximum Liquidation Threshold
+ *
+ * Maximum liquidation threshold reached at end of grace period (day 30).
+ * Value: 200% (20000 basis points)
+ *
+ * The threshold escalates from MIN to this value over the grace period.
+ *
+ * Governance-adjustable: YES
+ */
+export declare const EXPIRED_LOAN_MAX_LIQUIDATION_THRESHOLD_BPS = 20000;
+/**
+ * Grace Period Duration
+ *
+ * Number of days after loan expiry before maximum liquidation threshold is reached.
+ * Value: 30 days
+ *
+ * During this period, liquidation threshold escalates quadratically from MIN to MAX.
+ *
+ * Governance-adjustable: YES
+ */
+export declare const GRACE_PERIOD_DAYS = 30;
+//# sourceMappingURL=liquidation.d.ts.map

package/pkg-dist/src/constants/chunks/liquidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidation.d.ts","sourceRoot":"","sources":["../../../../src/constants/chunks/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,QAAQ,CAAC;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,0CAA0C,QAAQ,CAAC;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,0CAA0C,QAAQ,CAAC;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC"}