@lombard.finance/sdk 3.7.3 → 4.0.0

package/dist/chains/btc/actions/shared/BaseBtcAction.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Base BTC Action Class
+ *
+ * Provides common functionality for all BTC actions:
+ * - State management (amount, recipient, depositAddress, referralCode)
+ * - Ensure methods for validation
+ * - Bitcoin network helpers
+ * - Deposit monitoring
+ * - Bitcoin send operations
+ * - Common validation and prepare patterns
+ *
+ * @module chains/btc/actions/shared/BaseBtcAction
+ */
+import { z } from 'zod';
+import { ChainId, SolanaChain, StarknetChainId, SuiChain } from '../../../../common/chains';
+import { Chain, StepStatus } from '../../../../core';
+import { BaseAction } from '../../../../shared/actions';
+import type { BtcCoreContext } from '../../../../shared/context';
+import type { MonitorProgress, NetworkMode } from '../../../../shared/monitoring';
+import type { EventHandler } from '../../../../shared/monitoring/createEventEmitter';
+/**
+ * Common authorization state for BTC actions
+ */
+export interface BtcAuthorizationState {
+    authorized: boolean;
+    signature?: string;
+    typedData?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Common params that all BTC actions share
+ */
+export interface BaseBtcParams {
+    sourceChain?: typeof Chain.BITCOIN_MAINNET | typeof Chain.BITCOIN_SIGNET;
+    destChain: Chain;
+}
+/**
+ * Common prepare params
+ */
+export interface BasePrepareParams {
+    amount: string;
+    recipient: string;
+    referralCode?: string;
+}
+/**
+ * Progress step definitions
+ */
+export type StepDefinition = Record<string, StepStatus>;
+/**
+ * Status configuration for template methods
+ */
+export interface StatusConfig<TStatus extends string> {
+    idle: TStatus;
+    ready: TStatus;
+    addressReady: TStatus;
+}
+/**
+ * Base class for BTC actions
+ *
+ * Provides template methods for common patterns:
+ * - prepare() with validation and resume
+ * - generateDepositAddress()
+ * - execute()
+ * - monitorDeposit()
+ *
+ * Subclasses implement abstract methods to customize behavior.
+ *
+ * @example
+ * ```typescript
+ * class BtcStake extends BaseBtcAction<StakeEventMap, BtcActionStatus, BtcStakeParams> {
+ *   protected getAddressSchema() { return evmAddressSchema; }
+ *   protected getStatusConfig() { return { idle: BtcActionStatus.IDLE, ... }; }
+ *   protected getInitialSteps() { return { created: StepStatus.IDLE, ... }; }
+ * }
+ * ```
+ */
+export declare abstract class BaseBtcAction<TEventMap extends Record<string, EventHandler<unknown[]>>, TStatus extends string, TParams extends BaseBtcParams> extends BaseAction<TEventMap, TStatus> {
+    protected readonly ctx: BtcCoreContext;
+    protected readonly params: TParams;
+    protected _amount?: string;
+    protected _recipient?: string;
+    protected _depositAddress?: string;
+    protected _referralCode?: string;
+    protected _chainId?: unknown;
+    constructor(ctx: BtcCoreContext, params: TParams, initialStatus: TStatus);
+    /** Get the address validation schema for this action */
+    protected abstract getAddressSchema(): z.ZodType<string>;
+    /** Get the status configuration for template methods */
+    protected abstract getStatusConfig(): StatusConfig<TStatus>;
+    /** Get the initial progress steps for this action */
+    protected abstract getInitialSteps(): StepDefinition;
+    /** Check if the action has been authorized */
+    protected abstract isAuthorized(): boolean;
+    /** Get the chain ID (after parsing in constructor) */
+    protected abstract getChainId(): ChainId | SuiChain | SolanaChain | StarknetChainId;
+    /**
+     * Get API params for generateDepositAddress
+     * Subclasses provide action-specific parameters
+     */
+    protected abstract getDepositAddressParams(): {
+        address: string;
+        chainId: ChainId | SuiChain | SolanaChain | StarknetChainId;
+        signature: string;
+        token: string;
+        eip712Data?: string;
+        signatureData?: string;
+        pubKey?: string;
+        partnerId?: string;
+        referrerCode?: string;
+    };
+    /**
+     * Get the expected destination token (LBTC, BTCb, etc.)
+     * Used for resuming from existing deposits before authorization is complete
+     */
+    protected abstract getExpectedToken(): string;
+    /** Amount of BTC to stake/deposit */
+    get amount(): string | undefined;
+    /** Recipient address on destination chain */
+    get recipient(): string | undefined;
+    /** Generated Bitcoin deposit address */
+    get depositAddress(): string | undefined;
+    /** Referral code (optional) */
+    get referralCode(): string | undefined;
+    /** Bitcoin network mode for monitoring */
+    protected get bitcoinNetwork(): NetworkMode;
+    /**
+     * Get the prepare schema (amount + recipient + referralCode)
+     * Uses abstract getAddressSchema() for chain-specific validation
+     */
+    protected get prepareSchema(): z.ZodObject<{
+        amount: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string> | z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+        recipient: z.ZodType<string, z.ZodTypeDef, string>;
+        referralCode: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        recipient: string;
+        referralCode?: string | undefined;
+    }, {
+        amount: string;
+        recipient: string;
+        referralCode?: string | undefined;
+    }>;
+    /**
+     * Validate prepare params using Zod
+     * Subclasses can override if they need custom validation
+     */
+    protected validatePrepareParams(params: BasePrepareParams): BasePrepareParams;
+    protected ensureRecipient(): string;
+    protected ensureAmount(): string;
+    protected ensureDepositAddress(): string;
+    /**
+     * Get error message for missing authorization
+     * Subclasses can override to provide specific messages
+     */
+    protected getAuthRequiredMessage(): string;
+    protected ensureAuthorized(): void;
+    /**
+     * Try to resume from an existing deposit address
+     *
+     * This method only stores the deposit address if found.
+     * It does NOT update the status - the caller must do that
+     * after performing any additional validation (e.g., fee authorization).
+     *
+     * @param recipient - The recipient address to check
+     * @returns true if a deposit address was found, false otherwise
+     */
+    protected resumeFromExistingDeposit(recipient: string): Promise<boolean>;
+    /**
+     * Generate a Bitcoin deposit address
+     *
+     * Template method that:
+     * 1. Validates status and authorization
+     * 2. Calls API to generate address
+     * 3. Updates state and emits progress
+     *
+     * Subclasses must implement getDepositAddressParams() to provide API params.
+     */
+    protected generateDepositAddressImpl(): Promise<string>;
+    /**
+     * Execute the action - generate address and optionally send BTC
+     *
+     * Template method that:
+     * 1. Ensures deposit address exists
+     * 2. Tries to send BTC if provider available
+     * 3. Returns result
+     */
+    protected executeImpl(): Promise<{
+        depositAddress: string;
+        txHash?: string;
+    }>;
+    /**
+     * Emit initial progress with action-specific steps
+     */
+    protected emitInitialProgress(): void;
+    /**
+     * Monitor Bitcoin deposit progress
+     */
+    monitorDeposit(): Promise<MonitorProgress | undefined>;
+    protected trySendBitcoin(depositAddress: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=BaseBtcAction.d.ts.map

package/dist/chains/btc/actions/shared/BaseBtcAction.d.ts.map

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

package/dist/chains/btc/actions/shared/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared BTC Action Utilities
+ *
+ * Common utilities and base classes for BTC actions.
+ *
+ * @module chains/btc/actions/shared
+ */
+export type { BaseBtcParams, BtcAuthorizationState, StatusConfig, StepDefinition, } from './BaseBtcAction';
+export { BaseBtcAction } from './BaseBtcAction';
+export { assetIdToToken } from './tokenUtils';
+export type { ValidatableConfig, ValidatableParams, ValidationContext, } from './validation';
+export { isAssetSupported, isDestChainSupported, isRouteAvailable, validateBtcActionParams, validateProtocol, } from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/chains/btc/actions/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/chains/btc/actions/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/chains/btc/actions/shared/tokenUtils.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Token Utilities for BTC Actions
+ *
+ * Shared utilities for mapping asset IDs to tokens.
+ *
+ * ## Token Parameter Pattern for StakeAndBake/DepositAndDeploy
+ *
+ * The `token` parameter in authorization functions determines which DEFI_REGISTRY
+ * entry is used, which affects the `amountStrategy`:
+ *
+ * | Action              | Flow               | Token Param   | Strategy    | Reason                     |
+ * |---------------------|-------------------|---------------|-------------|----------------------------|
+ * | BtcStakeAndDeploy   | BTC → LBTC → Vault | AssetId.BTC  | btcToLbtc   | Apply BTC/LBTC ratio       |
+ * | BtcDepositAndDeploy | BTC → BTCb → Vault | Token.BTCb   | identity    | 1:1 ratio, no conversion   |
+ *
+ * **Key Insight:**
+ * - LBTC has a variable exchange rate with BTC (~1.00265 BTC = 1 LBTC)
+ * - BTC.b is 1:1 with BTC (wrapped representation)
+ *
+ * For LBTC outputs, use the SOURCE asset (`'BTC'`) to trigger ratio conversion.
+ * For BTC.b outputs, use the OUTPUT asset (`Token.BTCb`) since no conversion needed.
+ *
+ * @see DEFI_REGISTRY in defi/defi-registry.ts
+ * @see signStakeAndBake for how amountStrategy is applied
+ *
+ * @module chains/btc/actions/shared/tokenUtils
+ */
+import { AssetId } from '../../../../core/assets';
+import { Token } from '../../../../tokens/token-addresses';
+/**
+ * Maps an AssetId to its corresponding Token value for API calls.
+ *
+ * **Note:** This function handles LBTC and BTCb. For BTC → LBTC flows that need
+ * ratio conversion, use `AssetId.BTC` directly instead of this function.
+ *
+ * @param assetId - The asset ID to convert
+ * @param defaultToken - The default token if assetId doesn't match known types (defaults to LBTC)
+ * @returns The corresponding Token value
+ *
+ * @example
+ * // For BTC.b outputs (1:1 with BTC)
+ * assetIdToToken(AssetId.BTCb) // returns Token.BTCb
+ *
+ * @example
+ * // For LBTC outputs from LBTC source (no ratio conversion)
+ * assetIdToToken(AssetId.LBTC) // returns Token.LBTC
+ *
+ * @example
+ * // For BTC → LBTC (needs ratio conversion)
+ * // DON'T use assetIdToToken, use AssetId.BTC directly
+ * token: AssetId.BTC // triggers btcToLbtc strategy
+ */
+export declare function assetIdToToken(assetId: AssetId, defaultToken?: Token): Token;
+//# sourceMappingURL=tokenUtils.d.ts.map

package/dist/chains/btc/actions/shared/tokenUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenUtils.d.ts","sourceRoot":"","sources":["../../../../../src/chains/btc/actions/shared/tokenUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,YAAY,GAAE,KAAkB,GAC/B,KAAK,CASP"}

package/dist/chains/btc/actions/shared/validation.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Shared Validation Utilities for BTC Actions
+ *
+ * Provides common validation logic used across all BTC actions.
+ * Reduces code duplication and ensures consistent error handling.
+ *
+ * @module chains/btc/actions/shared/validation
+ */
+import type { AssetId, Chain, Env } from '../../../../core';
+/**
+ * Common config interface for validation
+ * All BTC action configs should implement these properties
+ */
+export interface ValidatableConfig {
+    destChains: Chain[];
+    supportedAssetsOut: AssetId[];
+    routes: Array<{
+        sourceChains: Chain[];
+        envs: Env[];
+    }>;
+}
+/**
+ * Common params interface for validation
+ */
+export interface ValidatableParams {
+    assetOut: AssetId;
+    destChain: Chain;
+    sourceChain?: Chain;
+}
+/**
+ * Validation context
+ */
+export interface ValidationContext {
+    env: Env;
+    actionName: string;
+    expectedAssets: AssetId[];
+    alternativeAction?: string;
+}
+/**
+ * Check if an asset is in the supported list
+ */
+export declare function isAssetSupported(supportedAssets: AssetId[], assetOut: AssetId): boolean;
+/**
+ * Check if a destination chain is in the supported list
+ */
+export declare function isDestChainSupported(supportedChains: Chain[], destChain: Chain): boolean;
+/**
+ * Check if a route is available for the given source chain and environment
+ */
+export declare function isRouteAvailable(routes: ValidatableConfig['routes'], sourceChain: Chain | undefined, env: Env): boolean;
+/**
+ * Validate common BTC action parameters
+ *
+ * Performs all standard validations in one call:
+ * - Asset output validation
+ * - Destination chain validation
+ * - Route availability validation
+ *
+ * Throws descriptive errors if validation fails.
+ *
+ * @param config - Action configuration with supported chains/assets
+ * @param params - Action parameters to validate
+ * @param context - Validation context (env, action name, etc.)
+ *
+ * @throws LombardError with appropriate code and message
+ *
+ * @example
+ * ```typescript
+ * validateBtcActionParams(
+ *   stakeConfig,
+ *   { assetOut: AssetId.LBTC, destChain: Chain.ETHEREUM },
+ *   {
+ *     env: 'prod',
+ *     actionName: 'BTC Stake',
+ *     expectedAssets: [AssetId.LBTC],
+ *     alternativeAction: 'BtcDeposit',
+ *   }
+ * );
+ * ```
+ */
+export declare function validateBtcActionParams(config: ValidatableConfig, params: ValidatableParams, context: ValidationContext): void;
+/**
+ * Validate protocol is supported (for deploy actions)
+ *
+ * @param supportedProtocols - List of supported protocols
+ * @param protocol - Protocol to validate
+ * @param actionName - Name of action for error message
+ */
+export declare function validateProtocol(supportedProtocols: string[], protocol: string, actionName: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/chains/btc/actions/shared/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../src/chains/btc/actions/shared/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAO5D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,KAAK,EAAE,CAAC;IACpB,kBAAkB,EAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,EAAE,KAAK,CAAC;QACZ,YAAY,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,EAAE,GAAG,EAAE,CAAC;KACb,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,KAAK,CAAC;IACjB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,GAAG,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,OAAO,EAAE,EAC1B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,KAAK,EAAE,EACxB,SAAS,EAAE,KAAK,GACf,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EACnC,WAAW,EAAE,KAAK,GAAG,SAAS,EAC9B,GAAG,EAAE,GAAG,GACP,OAAO,CAOT;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAgCN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,EAAE,MAAM,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,IAAI,CAQN"}

package/dist/chains/btc/actions/stake/BtcStake.d.ts

@@ -0,0 +1,82 @@
+/**
+ * BTC Stake Action
+ *
+ * A configuration-driven action that handles BTC → LBTC staking
+ * to any supported destination chain. Chain-specific logic is delegated
+ * to ChainConfig objects in the config/ folder.
+ *
+ * @module chains/btc/actions/stake/BtcStake
+ */
+import type { z } from 'zod';
+import type { ChainId, SolanaChain, StarknetChainId, SuiChain } from '../../../../common/chains';
+import { BtcActionStatus } from '../../../../shared/constants/statusConstants';
+import type { BtcCoreContext } from '../../../../shared/context';
+import type { StakeEventMap } from '../../../../shared/events';
+import type { MonitorProgress } from '../../../../shared/monitoring';
+import { BaseBtcAction, type StatusConfig, type StepDefinition } from '../shared';
+import type { BtcStake as IBtcStake, BtcStakeParams } from './types';
+type AnyChainId = ChainId | SolanaChain | SuiChain | StarknetChainId;
+/**
+ * BTC Stake Action
+ *
+ * Handles BTC → LBTC staking to any supported destination chain.
+ * Uses configuration-driven design for chain-specific logic.
+ *
+ * @example
+ * ```typescript
+ * const stake = new BtcStake(ctx, {
+ *   assetOut: AssetId.LBTC,
+ *   destChain: Chain.ETHEREUM,
+ * });
+ *
+ * await stake.prepare({ amount: '0.1', recipient: '0x...' });
+ * await stake.authorize();
+ * const address = await stake.generateDepositAddress();
+ * ```
+ */
+export declare class BtcStake extends BaseBtcAction<StakeEventMap, BtcActionStatus, BtcStakeParams> implements IBtcStake {
+    private readonly config;
+    private readonly chainId;
+    private readonly authState;
+    /** Fee auth config - null if not required for this destination */
+    private feeAuthConfig;
+    constructor(ctx: BtcCoreContext, params: BtcStakeParams);
+    protected getAddressSchema(): z.ZodType<string>;
+    protected getStatusConfig(): StatusConfig<BtcActionStatus>;
+    protected getInitialSteps(): StepDefinition;
+    protected isAuthorized(): boolean;
+    protected getChainId(): AnyChainId;
+    protected getDepositAddressParams(): {
+        address: string;
+        chainId: AnyChainId;
+        signature: string;
+        token: string;
+        eip712Data: string | undefined;
+        pubKey: string | undefined;
+        partnerId: string | undefined;
+        referrerCode: string | undefined;
+    };
+    /**
+     * Get expected token for this action (LBTC by default for BTC Stake)
+     */
+    protected getExpectedToken(): string;
+    protected getAuthRequiredMessage(): string;
+    /** Get minting fee (available after prepare() for fee-auth chains) */
+    get mintingFee(): string | undefined;
+    prepare(params: {
+        amount: string;
+        recipient: string;
+        referralCode?: string;
+    }): Promise<void>;
+    authorize(): Promise<void>;
+    generateDepositAddress(): Promise<string>;
+    execute(): Promise<{
+        depositAddress: string;
+        txHash?: string;
+    }>;
+    monitorDeposit(): Promise<MonitorProgress | undefined>;
+    private ensureMintingFee;
+    private getActiveSignature;
+}
+export {};
+//# sourceMappingURL=BtcStake.d.ts.map

package/dist/chains/btc/actions/stake/BtcStake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BtcStake.d.ts","sourceRoot":"","sources":["../../../../../src/chains/btc/actions/stake/BtcStake.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EACR,OAAO,EACP,WAAW,EACX,eAAe,EACf,QAAQ,EACX,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,EAEH,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACtB,MAAM,WAAW,CAAC;AAUnB,OAAO,KAAK,EAAE,QAAQ,IAAI,SAAS,EAAC,cAAc,EAAE,MAAM,SAAS,CAAC;AAMpE,KAAK,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAC;AAgBrE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QACX,SAAQ,aAAa,CAAC,aAAa,EAAE,eAAe,EAAE,cAAc,CACpE,YAAW,SAAS;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IAEvE,kEAAkE;IAClE,OAAO,CAAC,aAAa,CAA8B;gBAEvC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc;IA8CvD,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAI/C,SAAS,CAAC,eAAe,IAAI,YAAY,CAAC,eAAe,CAAC;IAQ1D,SAAS,CAAC,eAAe,IAAI,cAAc;IAQ3C,SAAS,CAAC,YAAY,IAAI,OAAO;IAIjC,SAAS,CAAC,UAAU,IAAI,UAAU;IAIlC,SAAS,CAAC,uBAAuB;;;;;;;;;;IAuBjC;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;IAIpC,SAAS,CAAC,sBAAsB,IAAI,MAAM;IAQ1C,sEAAsE;IACtE,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAMK,OAAO,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiGX,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC1B,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC;IAyCzC,OAAO,IAAI,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/D,cAAc,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAQ5D,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/chains/btc/actions/stake/config/evm.d.ts

@@ -0,0 +1,20 @@
+/**
+ * EVM Chain Configuration
+ *
+ * Handles all EVM-compatible destination chains (Ethereum, Base, Arbitrum, etc.)
+ * Includes fee authorization for Ethereum mainnet and destination signing for others.
+ *
+ * Supported chains are derived from ASSET_CATALOG - single source of truth.
+ *
+ * @module chains/btc/actions/stake/config/evm
+ */
+import type { ChainConfig } from './types';
+/**
+ * EVM chain configuration for BTC stake
+ *
+ * BTC Stake: BTC → LBTC (yield-bearing staked BTC)
+ * Supports staking BTC to LBTC on any EVM-compatible chain.
+ * Supported chains are derived from ASSET_CATALOG[AssetId.LBTC].deployments.
+ */
+export declare const evmConfig: ChainConfig;
+//# sourceMappingURL=evm.d.ts.map

package/dist/chains/btc/actions/stake/config/evm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/btc/actions/stake/config/evm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAuG1D;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,WAiDvB,CAAC"}

package/dist/chains/btc/actions/stake/config/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Chain Configuration Registry
+ *
+ * Exports all chain configurations and provides registry lookup functions.
+ *
+ * BTC Stake: BTC → LBTC (yield-bearing staked BTC)
+ *
+ * @module chains/btc/actions/stake/config
+ */
+import type { AssetId, Chain, ChainType, Env } from '../../../../../core';
+import type { ChainConfig } from './types';
+export type { ChainConfig, FeeAuthConfig, FeeAuthResult, RouteDefinition, SignatureResult, StoredFeeSignature, } from './types';
+export { evmConfig } from './evm';
+export { solanaConfig } from './solana';
+export { starknetConfig } from './starknet';
+export { suiConfig } from './sui';
+/**
+ * Registry of all chain configurations
+ *
+ * Add new chain types here to support additional destination chains.
+ * The key must match the ChainType from the chain catalog.
+ */
+export declare const chainConfigs: Partial<Record<ChainType, ChainConfig>>;
+/**
+ * Get chain configuration by chain type
+ *
+ * @param chainType - The chain type from getChainType()
+ * @returns ChainConfig or undefined if not supported
+ */
+export declare function getChainConfig(chainType: ChainType): ChainConfig | undefined;
+/**
+ * Check if a chain type is supported for BTC staking
+ *
+ * @param chainType - The chain type to check
+ * @returns true if supported
+ */
+export declare function isChainTypeSupported(chainType: ChainType): boolean;
+/**
+ * Check if a specific route is available
+ *
+ * @param config - Chain configuration
+ * @param sourceChain - Source chain (Bitcoin network)
+ * @param env - Environment
+ * @returns true if route is available
+ */
+export declare function isRouteAvailable(config: ChainConfig, sourceChain: Chain | undefined, env: Env): boolean;
+/**
+ * Check if a destination chain is supported by a config
+ *
+ * @param config - Chain configuration
+ * @param destChain - Destination chain
+ * @returns true if destination chain is supported
+ */
+export declare function isDestChainSupported(config: ChainConfig, destChain: Chain): boolean;
+/**
+ * Check if an output asset is supported by a config
+ *
+ * @param config - Chain configuration
+ * @param assetOut - Output asset
+ * @returns true if output asset is supported
+ */
+export declare function isAssetOutSupported(config: ChainConfig, assetOut: AssetId): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/chains/btc/actions/stake/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/btc/actions/stake/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMlC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAKhE,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,KAAK,GAAG,SAAS,EAC9B,GAAG,EAAE,GAAG,GACP,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,KAAK,GACf,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAET"}

package/dist/chains/btc/actions/stake/config/solana.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Solana Chain Configuration
+ *
+ * Handles Solana destination chains (mainnet and devnet).
+ * Uses Solana wallet signing via the Solana SDK module.
+ *
+ * BTC Stake: BTC → LBTC (yield-bearing staked BTC)
+ * Supported chains derived from ASSET_CATALOG.
+ *
+ * @module chains/btc/actions/stake/config/solana
+ */
+import type { ChainConfig } from './types';
+/**
+ * Solana chain configuration for BTC stake
+ *
+ * Supports staking BTC to LBTC on Solana.
+ * Requires the @lombard.finance/sdk-solana module to be installed.
+ */
+export declare const solanaConfig: ChainConfig;
+//# sourceMappingURL=solana.d.ts.map

package/dist/chains/btc/actions/stake/config/solana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/btc/actions/stake/config/solana.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAkC3C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,WAqC1B,CAAC"}

package/dist/chains/btc/actions/stake/config/starknet.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Starknet Chain Configuration
+ *
+ * Handles Starknet destination chains (mainnet and Sepolia).
+ * Uses Starknet wallet signing via the Starknet SDK module.
+ * Note: Starknet requires address padding and returns a public key.
+ *
+ * BTC Stake: BTC → LBTC (yield-bearing staked BTC)
+ * Supported chains derived from ASSET_CATALOG.
+ *
+ * @module chains/btc/actions/stake/config/starknet
+ */
+import type { ChainConfig } from './types';
+/**
+ * Starknet chain configuration for BTC stake
+ *
+ * Supports staking BTC to LBTC on Starknet.
+ * Requires the @lombard.finance/sdk-starknet module to be installed.
+ */
+export declare const starknetConfig: ChainConfig;
+//# sourceMappingURL=starknet.d.ts.map

package/dist/chains/btc/actions/stake/config/starknet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starknet.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/btc/actions/stake/config/starknet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,WAsC5B,CAAC"}

package/dist/chains/btc/actions/stake/config/sui.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Sui Chain Configuration
+ *
+ * Handles Sui destination chains (mainnet and testnet).
+ * Uses Sui wallet signing via the Sui SDK module.
+ *
+ * BTC Stake: BTC → LBTC (yield-bearing staked BTC)
+ * Supported chains derived from ASSET_CATALOG.
+ *
+ * @module chains/btc/actions/stake/config/sui
+ */
+import type { ChainConfig } from './types';
+/**
+ * Sui chain configuration for BTC stake
+ *
+ * Supports staking BTC to LBTC on Sui.
+ * Requires the @lombard.finance/sdk-sui module to be installed.
+ */
+export declare const suiConfig: ChainConfig;
+//# sourceMappingURL=sui.d.ts.map

package/dist/chains/btc/actions/stake/config/sui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/btc/actions/stake/config/sui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAmCvB,CAAC"}