@vultisig/rujira 1.0.0

package/dist/errors.js

@@ -0,0 +1,184 @@
+/**
+ * Error types for Rujira SDK
+ * @module errors
+ */
+/**
+ * Error codes for Rujira operations
+ */
+export var RujiraErrorCode;
+(function (RujiraErrorCode) {
+    // Network errors
+    RujiraErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    RujiraErrorCode["RPC_ERROR"] = "RPC_ERROR";
+    RujiraErrorCode["TIMEOUT"] = "TIMEOUT";
+    RujiraErrorCode["NOT_CONNECTED"] = "NOT_CONNECTED";
+    // Validation errors
+    RujiraErrorCode["INVALID_ASSET"] = "INVALID_ASSET";
+    RujiraErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
+    RujiraErrorCode["INVALID_ADDRESS"] = "INVALID_ADDRESS";
+    RujiraErrorCode["INVALID_PAIR"] = "INVALID_PAIR";
+    RujiraErrorCode["INVALID_SLIPPAGE"] = "INVALID_SLIPPAGE";
+    // Balance errors
+    RujiraErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    RujiraErrorCode["INSUFFICIENT_GAS"] = "INSUFFICIENT_GAS";
+    // Swap errors
+    RujiraErrorCode["NO_ROUTE"] = "NO_ROUTE";
+    RujiraErrorCode["SLIPPAGE_EXCEEDED"] = "SLIPPAGE_EXCEEDED";
+    RujiraErrorCode["QUOTE_EXPIRED"] = "QUOTE_EXPIRED";
+    RujiraErrorCode["PRICE_IMPACT_TOO_HIGH"] = "PRICE_IMPACT_TOO_HIGH";
+    // Order errors
+    RujiraErrorCode["ORDER_NOT_FOUND"] = "ORDER_NOT_FOUND";
+    RujiraErrorCode["INVALID_PRICE"] = "INVALID_PRICE";
+    RujiraErrorCode["MIN_ORDER_SIZE"] = "MIN_ORDER_SIZE";
+    RujiraErrorCode["ORDER_ALREADY_FILLED"] = "ORDER_ALREADY_FILLED";
+    // Transaction errors
+    RujiraErrorCode["SIGNING_FAILED"] = "SIGNING_FAILED";
+    RujiraErrorCode["BROADCAST_FAILED"] = "BROADCAST_FAILED";
+    RujiraErrorCode["TX_FAILED"] = "TX_FAILED";
+    RujiraErrorCode["TX_NOT_FOUND"] = "TX_NOT_FOUND";
+    // Contract errors
+    RujiraErrorCode["CONTRACT_NOT_FOUND"] = "CONTRACT_NOT_FOUND";
+    RujiraErrorCode["CONTRACT_ERROR"] = "CONTRACT_ERROR";
+    // Configuration errors
+    RujiraErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    RujiraErrorCode["MISSING_SIGNER"] = "MISSING_SIGNER";
+})(RujiraErrorCode || (RujiraErrorCode = {}));
+/**
+ * Base error class for Rujira SDK
+ */
+export class RujiraError extends Error {
+    constructor(code, message, details, retryable = false) {
+        super(message);
+        this.name = 'RujiraError';
+        this.code = code;
+        this.details = details;
+        this.retryable = retryable;
+        // Maintain proper stack trace (Node.js specific)
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(this, RujiraError);
+        }
+    }
+    /**
+     * Create a user-friendly error message
+     */
+    toUserMessage() {
+        return USER_FRIENDLY_MESSAGES[this.code] || this.message;
+    }
+    /**
+     * Convert to JSON for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+            retryable: this.retryable,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * User-friendly error messages
+ */
+const USER_FRIENDLY_MESSAGES = {
+    [RujiraErrorCode.NETWORK_ERROR]: 'Network connection failed. Please check your internet connection.',
+    [RujiraErrorCode.RPC_ERROR]: 'Failed to communicate with the blockchain. Please try again.',
+    [RujiraErrorCode.TIMEOUT]: 'Request timed out. Please try again.',
+    [RujiraErrorCode.NOT_CONNECTED]: 'Not connected to the network. Please connect first.',
+    [RujiraErrorCode.INVALID_ASSET]: 'Invalid asset. Please check the asset identifier.',
+    [RujiraErrorCode.INVALID_AMOUNT]: 'Invalid amount. Please enter a valid number.',
+    [RujiraErrorCode.INVALID_ADDRESS]: 'Invalid address format.',
+    [RujiraErrorCode.INVALID_PAIR]: 'Trading pair not found or not supported.',
+    [RujiraErrorCode.INVALID_SLIPPAGE]: 'Invalid slippage tolerance. Must be between 0.01% and 50%.',
+    [RujiraErrorCode.INSUFFICIENT_BALANCE]: 'Insufficient balance for this transaction.',
+    [RujiraErrorCode.INSUFFICIENT_GAS]: 'Insufficient RUNE for gas fees.',
+    [RujiraErrorCode.NO_ROUTE]: 'No swap route available for this pair.',
+    [RujiraErrorCode.SLIPPAGE_EXCEEDED]: 'Price moved too much. Try increasing slippage tolerance.',
+    [RujiraErrorCode.QUOTE_EXPIRED]: 'Quote expired. Please get a new quote.',
+    [RujiraErrorCode.PRICE_IMPACT_TOO_HIGH]: 'Price impact is too high. Consider reducing the amount.',
+    [RujiraErrorCode.ORDER_NOT_FOUND]: 'Order not found.',
+    [RujiraErrorCode.INVALID_PRICE]: 'Invalid order price.',
+    [RujiraErrorCode.MIN_ORDER_SIZE]: 'Order size is below the minimum.',
+    [RujiraErrorCode.ORDER_ALREADY_FILLED]: 'Order has already been filled.',
+    [RujiraErrorCode.SIGNING_FAILED]: 'Failed to sign the transaction.',
+    [RujiraErrorCode.BROADCAST_FAILED]: 'Failed to broadcast the transaction.',
+    [RujiraErrorCode.TX_FAILED]: 'Transaction failed on chain.',
+    [RujiraErrorCode.TX_NOT_FOUND]: 'Transaction not found.',
+    [RujiraErrorCode.CONTRACT_NOT_FOUND]: 'Contract not found at the specified address.',
+    [RujiraErrorCode.CONTRACT_ERROR]: 'Contract execution failed.',
+    [RujiraErrorCode.INVALID_CONFIG]: 'Invalid configuration.',
+    [RujiraErrorCode.MISSING_SIGNER]: 'No signer provided. Connect a wallet first.',
+};
+/**
+ * Retryable error codes
+ */
+const RETRYABLE_ERRORS = new Set([
+    RujiraErrorCode.NETWORK_ERROR,
+    RujiraErrorCode.RPC_ERROR,
+    RujiraErrorCode.TIMEOUT,
+]);
+/**
+ * Check if an error is retryable
+ */
+export function isRetryableError(error) {
+    if (error instanceof RujiraError) {
+        return error.retryable || RETRYABLE_ERRORS.has(error.code);
+    }
+    return false;
+}
+/**
+ * Wrap an error in RujiraError
+ */
+export function wrapError(error, defaultCode = RujiraErrorCode.NETWORK_ERROR) {
+    if (error instanceof RujiraError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        // 1. Check typed error classes (CosmJS TimeoutError, etc.)
+        if (error.name === 'TimeoutError' || error.constructor.name === 'TimeoutError') {
+            return new RujiraError(RujiraErrorCode.TIMEOUT, error.message, error, true);
+        }
+        // 2. Check error.code property (gRPC codes, Node.js error codes)
+        const errCode = error.code;
+        if (errCode !== undefined) {
+            if (errCode === 'ECONNREFUSED' || errCode === 'ENOTFOUND' || errCode === 'ECONNRESET') {
+                return new RujiraError(RujiraErrorCode.NETWORK_ERROR, error.message, error, true);
+            }
+            if (errCode === 'ETIMEDOUT' || errCode === 'ESOCKETTIMEDOUT') {
+                return new RujiraError(RujiraErrorCode.TIMEOUT, error.message, error, true);
+            }
+            // gRPC DEADLINE_EXCEEDED = 4
+            if (errCode === 4 || errCode === 'DEADLINE_EXCEEDED') {
+                return new RujiraError(RujiraErrorCode.TIMEOUT, error.message, error, true);
+            }
+            // gRPC NOT_FOUND = 5
+            if (errCode === 5 || errCode === 'NOT_FOUND') {
+                return new RujiraError(RujiraErrorCode.CONTRACT_NOT_FOUND, error.message, error);
+            }
+            // gRPC UNAVAILABLE = 14
+            if (errCode === 14 || errCode === 'UNAVAILABLE') {
+                return new RujiraError(RujiraErrorCode.RPC_ERROR, error.message, error, true);
+            }
+        }
+        // 3. String matching as last resort
+        const message = error.message.toLowerCase();
+        if (message.includes('insufficient funds') || message.includes('insufficient balance')) {
+            return new RujiraError(RujiraErrorCode.INSUFFICIENT_BALANCE, error.message, error);
+        }
+        if (message.includes('timeout') || message.includes('timed out')) {
+            return new RujiraError(RujiraErrorCode.TIMEOUT, error.message, error, true);
+        }
+        if (message.includes('slippage') || message.includes('min_return')) {
+            return new RujiraError(RujiraErrorCode.SLIPPAGE_EXCEEDED, error.message, error);
+        }
+        if (message.includes('out of gas')) {
+            return new RujiraError(RujiraErrorCode.INSUFFICIENT_GAS, error.message, error);
+        }
+        if (message.includes('not found') && message.includes('contract')) {
+            return new RujiraError(RujiraErrorCode.CONTRACT_NOT_FOUND, error.message, error);
+        }
+        return new RujiraError(defaultCode, error.message, error);
+    }
+    return new RujiraError(defaultCode, String(error), error);
+}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @vultisig/rujira - Rujira DEX Integration for Vultisig SDK
+ *
+ * A modular TypeScript SDK for interacting with Rujira DEX on THORChain.
+ * Designed for wallets, trading bots, and AI agents.
+ *
+ * @example
+ * ```typescript
+ * import { RujiraClient, RujiraSwap } from '@vultisig/rujira';
+ *
+ * // Initialize client
+ * const client = new RujiraClient({ network: 'mainnet' });
+ * await client.connect();
+ *
+ * // Get a quote
+ * const quote = await client.swap.getQuote({
+ *   fromAsset: 'THOR.RUNE',
+ *   toAsset: 'BTC.BTC',
+ *   amount: '100000000'
+ * });
+ *
+ * // Execute swap (with Vultisig signer)
+ * const result = await client.swap.execute(quote, { slippageBps: 100 });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { AssetName, EasyAsset, EasyQuoteResponse, EasyRoute, EasyRouteName, EasySwapRequest, } from './easy-routes.js';
+export { ASSETS, EASY_ROUTES, findRoute, getRoute, getRoutesSummary, listEasyRoutes, routesForAsset, routesFrom, routesTo, } from './easy-routes.js';
+export * from './config.js';
+export * from './errors.js';
+export * from './types.js';
+export type { RujiraClientOptions } from './client.js';
+export { RujiraClient } from './client.js';
+export { RujiraAssets } from './modules/assets.js';
+export { RujiraOrderbook } from './modules/orderbook.js';
+export { RujiraSwap } from './modules/swap.js';
+export type { RujiraSigner, VultisigVault } from './signer/types.js';
+export { VultisigRujiraProvider } from './signer/vultisig-provider.js';
+export * from './assets/index.js';
+export * from './utils/format.js';
+export * from './utils/memo.js';
+export { RujiraDiscovery } from './discovery/discovery.js';
+export { GraphQLClient } from './discovery/graphql-client.js';
+export type { DiscoveredContracts, Market } from './discovery/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,YAAY,EACV,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,UAAU,EACV,QAAQ,GACT,MAAM,kBAAkB,CAAA;AAGzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAG1B,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAGtE,cAAc,mBAAmB,CAAA;AAGjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,46 @@
+/**
+ * @vultisig/rujira - Rujira DEX Integration for Vultisig SDK
+ *
+ * A modular TypeScript SDK for interacting with Rujira DEX on THORChain.
+ * Designed for wallets, trading bots, and AI agents.
+ *
+ * @example
+ * ```typescript
+ * import { RujiraClient, RujiraSwap } from '@vultisig/rujira';
+ *
+ * // Initialize client
+ * const client = new RujiraClient({ network: 'mainnet' });
+ * await client.connect();
+ *
+ * // Get a quote
+ * const quote = await client.swap.getQuote({
+ *   fromAsset: 'THOR.RUNE',
+ *   toAsset: 'BTC.BTC',
+ *   amount: '100000000'
+ * });
+ *
+ * // Execute swap (with Vultisig signer)
+ * const result = await client.swap.execute(quote, { slippageBps: 100 });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ASSETS, EASY_ROUTES, findRoute, getRoute, getRoutesSummary, listEasyRoutes, routesForAsset, routesFrom, routesTo, } from './easy-routes.js';
+// CORE SDK
+export * from './config.js';
+export * from './errors.js';
+export * from './types.js';
+export { RujiraClient } from './client.js';
+// Module exports
+export { RujiraAssets } from './modules/assets.js';
+export { RujiraOrderbook } from './modules/orderbook.js';
+export { RujiraSwap } from './modules/swap.js';
+export { VultisigRujiraProvider } from './signer/vultisig-provider.js';
+// Asset registry (formerly @vultisig/assets)
+export * from './assets/index.js';
+// Utility exports
+export * from './utils/format.js';
+export * from './utils/memo.js';
+// Discovery exports
+export { RujiraDiscovery } from './discovery/discovery.js';
+export { GraphQLClient } from './discovery/graphql-client.js';

package/dist/modules/assets.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Assets module for managing Rujira assets
+ * @module modules/assets
+ */
+import type { RujiraClient } from '../client.js';
+import type { RujiraAsset, TradingPair } from '../types.js';
+/**
+ * Assets module for querying asset information
+ *
+ * @example
+ * ```typescript
+ * const client = new RujiraClient({ network: 'mainnet' });
+ * await client.connect();
+ *
+ * // Get all supported assets
+ * const assets = await client.assets.getAssets();
+ *
+ * // Get specific asset info
+ * const btc = await client.assets.getAsset('BTC.BTC');
+ * console.log(`BTC decimals: ${btc.decimals}`);
+ * ```
+ */
+export declare class RujiraAssets {
+    private readonly client;
+    constructor(client: RujiraClient);
+    /**
+     * Get all supported assets
+     */
+    getAssets(): Promise<RujiraAsset[]>;
+    /**
+     * Get information about a specific asset
+     */
+    getAsset(assetFormat: string): Promise<RujiraAsset | null>;
+    /**
+     * Get available trading pairs
+     */
+    getTradingPairs(): Promise<TradingPair[]>;
+    /**
+     * Check if an asset is supported
+     */
+    isSupported(asset: string): boolean;
+    /**
+     * Get the denom for an asset
+     */
+    getDenom(asset: string): string | undefined;
+    /**
+     * Get decimals for an asset
+     */
+    getDecimals(asset: string): number | undefined;
+    /**
+     * Parse asset string to components
+     */
+    parseAsset(asset: string): {
+        chain: string;
+        symbol: string;
+        ticker: string;
+        contractAddress?: string;
+    };
+    /**
+     * Format asset string from components
+     */
+    formatAsset(chain: string, symbol: string): string;
+    /**
+     * Determine asset type
+     */
+    private getAssetType;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/modules/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/modules/assets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAI3D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAEjD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYzC;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAkBhE;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAoB/C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKnC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK9C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;QACzB,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,eAAe,CAAC,EAAE,MAAM,CAAA;KACzB;IAID;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAMlD;;OAEG;IACH,OAAO,CAAC,YAAY;CASrB"}

package/dist/modules/assets.js

@@ -0,0 +1,127 @@
+/**
+ * Assets module for managing Rujira assets
+ * @module modules/assets
+ */
+import { findAssetByFormat, KNOWN_ASSETS } from '../assets/index.js';
+import { DEFAULT_MAKER_FEE, DEFAULT_TAKER_FEE } from '../config/constants.js';
+import { parseAsset as sharedParseAsset } from '../utils/denom-conversion.js';
+import { isFinAsset } from '../utils/type-guards.js';
+/**
+ * Assets module for querying asset information
+ *
+ * @example
+ * ```typescript
+ * const client = new RujiraClient({ network: 'mainnet' });
+ * await client.connect();
+ *
+ * // Get all supported assets
+ * const assets = await client.assets.getAssets();
+ *
+ * // Get specific asset info
+ * const btc = await client.assets.getAsset('BTC.BTC');
+ * console.log(`BTC decimals: ${btc.decimals}`);
+ * ```
+ */
+export class RujiraAssets {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get all supported assets
+     */
+    async getAssets() {
+        return Object.values(KNOWN_ASSETS).filter(isFinAsset).map(asset => ({
+            asset: asset.formats.thorchain,
+            chain: asset.chain,
+            symbol: asset.formats.l1,
+            ticker: asset.id.toUpperCase(),
+            decimals: asset.decimals.fin,
+            type: this.getAssetType(asset.formats.thorchain),
+            denom: asset.formats.fin,
+        }));
+    }
+    /**
+     * Get information about a specific asset
+     */
+    async getAsset(assetFormat) {
+        const asset = findAssetByFormat(assetFormat);
+        if (!isFinAsset(asset)) {
+            return null;
+        }
+        return {
+            asset: asset.formats.thorchain,
+            chain: asset.chain,
+            symbol: asset.formats.l1,
+            ticker: asset.id.toUpperCase(),
+            decimals: asset.decimals.fin,
+            type: this.getAssetType(asset.formats.thorchain),
+            denom: asset.formats.fin,
+        };
+    }
+    /**
+     * Get available trading pairs
+     */
+    async getTradingPairs() {
+        // Return known pairs from config
+        const pairs = [];
+        const finContracts = this.client.config.contracts.finContracts;
+        for (const [pairKey, address] of Object.entries(finContracts)) {
+            const [base, quote] = pairKey.split('/');
+            pairs.push({
+                base,
+                quote,
+                contractAddress: address,
+                tick: '0.0001', // Would come from contract config
+                takerFee: DEFAULT_TAKER_FEE,
+                makerFee: DEFAULT_MAKER_FEE,
+            });
+        }
+        return pairs;
+    }
+    /**
+     * Check if an asset is supported
+     */
+    isSupported(asset) {
+        const found = findAssetByFormat(asset);
+        return isFinAsset(found);
+    }
+    /**
+     * Get the denom for an asset
+     */
+    getDenom(asset) {
+        const found = findAssetByFormat(asset);
+        return isFinAsset(found) ? found.formats.fin : undefined;
+    }
+    /**
+     * Get decimals for an asset
+     */
+    getDecimals(asset) {
+        const found = findAssetByFormat(asset);
+        return isFinAsset(found) ? found.decimals.fin : undefined;
+    }
+    /**
+     * Parse asset string to components
+     */
+    parseAsset(asset) {
+        return sharedParseAsset(asset);
+    }
+    /**
+     * Format asset string from components
+     */
+    formatAsset(chain, symbol) {
+        return `${chain}.${symbol}`;
+    }
+    // INTERNAL
+    /**
+     * Determine asset type
+     */
+    getAssetType(asset) {
+        if (asset === 'THOR.RUNE') {
+            return 'native';
+        }
+        if (asset.includes('/')) {
+            return 'synthetic';
+        }
+        return 'secured';
+    }
+}

package/dist/modules/deposit.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Deposit module for securing L1 assets on THORChain
+ * @module modules/deposit
+ */
+import type { RujiraClient } from '../client.js';
+/**
+ * THORChain inbound address response
+ */
+export type InboundAddress = {
+    chain: string;
+    pub_key: string;
+    address: string;
+    halted: boolean;
+    global_trading_paused: boolean;
+    chain_trading_paused: boolean;
+    chain_lp_actions_paused: boolean;
+    gas_rate: string;
+    gas_rate_units: string;
+    outbound_tx_size: string;
+    outbound_fee: string;
+    dust_threshold: string;
+};
+/**
+ * Prepared deposit transaction details
+ */
+export type PreparedDeposit = {
+    /** L1 chain to send from */
+    chain: string;
+    /** Inbound vault address to send to */
+    inboundAddress: string;
+    /** Memo to include in the L1 transaction */
+    memo: string;
+    /** Amount to send (in L1 base units) */
+    amount: string;
+    /** Asset being deposited */
+    asset: string;
+    /** Resulting secured denom on THORChain */
+    resultingDenom: string;
+    /** Estimated confirmation time in minutes */
+    estimatedTimeMinutes: number;
+    /** Minimum amount (dust threshold) */
+    minimumAmount: string;
+    /** Recommended gas rate for the L1 transaction */
+    gasRate: string;
+    /** Gas rate units */
+    gasRateUnits: string;
+    /** Warning if chain is halted or paused */
+    warning?: string;
+};
+/**
+ * Deposit preparation parameters
+ */
+export type DepositParams = {
+    /** L1 asset to deposit (e.g., 'BTC.BTC', 'ETH.ETH') */
+    fromAsset: string;
+    /** Amount in L1 base units */
+    amount: string;
+    /** THORChain address to receive secured assets */
+    thorAddress: string;
+    /** Optional: affiliate address for fee sharing */
+    affiliate?: string;
+    /** Optional: affiliate fee in basis points */
+    affiliateBps?: number;
+};
+/**
+ * Secured balance on THORChain
+ */
+export type SecuredBalance = {
+    /** Secured denom (e.g., 'btc-btc') */
+    denom: string;
+    /** L1 asset (e.g., 'BTC.BTC') */
+    asset: string;
+    /** Amount in base units (raw) */
+    amount: string;
+    /** Human-readable amount (formatted with decimals) */
+    formatted: string;
+    /** Decimal places (always 8 for THORChain secured assets) */
+    decimals: number;
+    /** Symbol for display (e.g., 'BTC', 'ETH', 'USDC') */
+    symbol: string;
+};
+/**
+ * Deposit module for securing L1 assets on THORChain
+ *
+ * @example
+ * ```typescript
+ * const client = new RujiraClient({ network: 'mainnet' });
+ *
+ * // Prepare a BTC deposit
+ * const deposit = await client.deposit.prepare({
+ *   fromAsset: 'BTC.BTC',
+ *   amount: '1000000',  // 0.01 BTC in sats
+ *   thorAddress: 'thor1...'
+ * });
+ *
+ * // Use the returned details to send an L1 transaction
+ * console.log(`Send ${deposit.amount} to ${deposit.inboundAddress}`);
+ * console.log(`With memo: ${deposit.memo}`);
+ * ```
+ */
+export declare class RujiraDeposit {
+    private readonly client;
+    private thornodeUrl;
+    private inboundCache;
+    private readonly CACHE_TTL_MS;
+    constructor(client: RujiraClient);
+    /**
+     * Prepare a deposit transaction
+     * Returns all details needed to send an L1 transaction
+     */
+    prepare(params: DepositParams): Promise<PreparedDeposit>;
+    /**
+     * Get secured balances for a THORChain address
+     */
+    getBalances(thorAddress: string): Promise<SecuredBalance[]>;
+    /**
+     * Get balance for a specific asset
+     */
+    getBalance(thorAddress: string, asset: string): Promise<SecuredBalance | null>;
+    /**
+     * Get inbound address for a specific chain
+     */
+    getInboundAddress(chain: string): Promise<InboundAddress | null>;
+    /**
+     * Get all inbound addresses
+     * @param forceRefresh Bypass cache and fetch fresh data (use before executing deposits)
+     */
+    getInboundAddresses(forceRefresh?: boolean): Promise<InboundAddress[]>;
+    /**
+     * Build deposit memo for L1 transaction
+     */
+    buildDepositMemo(thorAddress: string, affiliate?: string, affiliateBps?: number): string;
+    /**
+     * Estimate deposit confirmation time in minutes
+     */
+    estimateDepositTime(chain: string): number;
+    /**
+     * Get supported chains for deposits
+     */
+    getSupportedChains(): string[];
+    /**
+     * Check if a chain is supported
+     */
+    isChainSupported(chain: string): boolean;
+    /**
+     * Check if an asset can be deposited
+     */
+    canDeposit(asset: string): boolean;
+    private validateDepositParams;
+    private validateThorAddress;
+}
+//# sourceMappingURL=deposit.d.ts.map

package/dist/modules/deposit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit.d.ts","sourceRoot":"","sources":["../../src/modules/deposit.ts"],"names":[],"mappings":"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"}