@sodax/sdk 2.0.0-rc.12 → 2.0.0-rc.14

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { IConfigApi, ApiConfig, SodaxLogger, Result, SubmitSwapTxRequest, SubmitSwapTxResponse, GetSubmitSwapTxStatusParams, SubmitSwapTxStatusResponse, Address, GetAllConfigApiResponse, GetChainsApiResponse, GetSwapTokensApiResponse, SpokeChainKey, GetSwapTokensByChainIdApiResponse, GetMoneyMarketTokensApiResponse, GetMoneyMarketReserveAssetsApiResponse, GetMoneyMarketTokensByChainIdApiResponse, GetRelayChainIdMapApiResponse, GetSpokeChainConfigApiResponse, SodaxConfig, DeepPartial, XToken, OriginalAssetAddress, IntentRelayChainId, HubChainKey, HubConfig, PoolKey, SpokeChainConfig, RelayConfig, SolverConfig, SwapsConfig, BridgeConfig, MoneyMarketConfig, DexConfig, GetSpokeChainConfigType, EvmContractCall, Hex, IEvmWalletProvider, EvmRawTransactionReceipt, PartnerFee, QuoteType, EvmChainKey, WalletProviderSlot, TxReturnType, ChainType, GetChainType, SolanaRawTransactionReceipt, StellarSorobanTransactionReceipt, IconTransactionResult, SuiRawTransactionReceipt, InjectiveRawTransactionReceipt, NearRawTransactionReceipt, StacksRawTransactionReceipt, BitcoinRawTransactionReceipt, GetAddressType, HubAddress, GetTokenAddressType, EvmSpokeOnlyChainKey, StellarChainKey, SonicChainKey, AssetInfo, TokenInfo, VaultReserves, StacksChainKey, FeeEstimateTransaction, StacksTransactionParams, HttpUrl, RadfiConfig, IBitcoinWalletProvider, RadfiDepositTxResponse, BtcAddressType, BitcoinChainKey, NearChainKey, FillData, NearRawTransaction, INearWalletProvider, SuiPaginatedCoins, SuiChainKey, SuiExecutionResult, SuiGasEstimate, IStellarWalletProvider, StellarGasEstimate, SolanaChainKey, SolanaGasEstimate, SolanaBase58PublicKey, SolanaRawTransactionInstruction, SolanaSerializedTransaction, SolanaRpcResponseAndContext, SolanaTokenAmount, IconChainKey, IconGasEstimate, InjectiveChainKey, InjectiveGasEstimate, JsonObject, InjectiveRawTransaction, IInjectiveWalletProvider, InjectiveExecuteResponse, GetEstimateGasReturnType, IconAddress, IWalletProvider, EvmSpokeChainConfig, PartnerFeeAmount, PartnerFeePercentage, GetWalletProviderType, SodaxLoggerOption, SpokeExecActionParams, FeeAmount, Hash as Hash$1, SolverIntentQuoteRequest, SolverIntentQuoteResponse, SolverErrorResponse, SolverIntentStatusRequest, SolverIntentStatusResponse, SolverExecutionRequest, SolverExecutionResponse, IconEoaAddress, IcxTokenType, IconContractAddress, BridgeLimit, UserUnstakeInfo, ConcentratedLiquidityConfig, SodaxOptions } from '@sodax/types';
+import { IConfigApi, ApiConfig, SodaxLogger, Result, SubmitSwapTxRequest, SubmitSwapTxResponse, GetSubmitSwapTxStatusParams, SubmitSwapTxStatusResponse, Address, GetAllConfigApiResponse, GetChainsApiResponse, GetSwapTokensApiResponse, SpokeChainKey, GetSwapTokensByChainIdApiResponse, GetMoneyMarketTokensApiResponse, GetMoneyMarketReserveAssetsApiResponse, GetMoneyMarketTokensByChainIdApiResponse, GetRelayChainIdMapApiResponse, GetSpokeChainConfigApiResponse, PartnerFee, SodaxConfig, SodaxOptions, XToken, OriginalAssetAddress, IntentRelayChainId, HubChainKey, HubConfig, PoolKey, SpokeChainConfig, RelayConfig, SolverConfig, SwapsConfig, BridgeConfig, MoneyMarketConfig, LeverageYieldConfig, DexConfig, GetSpokeChainConfigType, SodaxDefaultConfig, EvmContractCall, Hex, IEvmWalletProvider, EvmRawTransactionReceipt, QuoteType, EvmChainKey, DeepPartial, WalletProviderSlot, TxReturnType, ChainType, GetChainType, SolanaRawTransactionReceipt, StellarSorobanTransactionReceipt, IconTransactionResult, SuiRawTransactionReceipt, InjectiveRawTransactionReceipt, NearRawTransactionReceipt, StacksRawTransactionReceipt, BitcoinRawTransactionReceipt, GetAddressType, HubAddress, GetTokenAddressType, EvmSpokeOnlyChainKey, StellarChainKey, SonicChainKey, AssetInfo, TokenInfo, VaultReserves, StacksChainKey, FeeEstimateTransaction, StacksTransactionParams, HttpUrl, RadfiConfig, IBitcoinWalletProvider, RadfiDepositTxResponse, BtcAddressType, BitcoinChainKey, NearChainKey, FillData, NearRawTransaction, INearWalletProvider, SuiPaginatedCoins, SuiChainKey, SuiExecutionResult, SuiGasEstimate, IStellarWalletProvider, StellarGasEstimate, SolanaChainKey, SolanaGasEstimate, SolanaBase58PublicKey, SolanaRawTransactionInstruction, SolanaSerializedTransaction, SolanaRpcResponseAndContext, SolanaTokenAmount, IconChainKey, IconGasEstimate, InjectiveChainKey, InjectiveGasEstimate, JsonObject, InjectiveCoin, InjectiveRawTransaction, IInjectiveWalletProvider, InjectiveExecuteResponse, GetEstimateGasReturnType, IconAddress, IWalletProvider, EvmSpokeChainConfig, PartnerFeeAmount, PartnerFeePercentage, GetWalletProviderType, SodaxLoggerOption, SpokeExecActionParams, FeeAmount, Hash as Hash$1, SolverIntentQuoteRequest, SolverIntentQuoteResponse, SolverErrorResponse, SolverIntentStatusRequest, SolverIntentStatusResponse, SolverExecutionRequest, SolverExecutionResponse, IconEoaAddress, IcxTokenType, IconContractAddress, BridgeLimit, UserUnstakeInfo, ConcentratedLiquidityConfig, LeverageYieldVault } from '@sodax/types';
 export * from '@sodax/types';
 import * as viem from 'viem';
 import { Hex as Hex$1, Chain, Address as Address$1, PublicClient, HttpTransport, Hash, GetLogsReturnType } from 'viem';
@@ -62,7 +62,7 @@ type SodaxErrorCode = 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'EXECUTIO
  * The producing feature of a SodaxError. Required at construction so consumers /
  * loggers always have a feature tag.
  */
-type SodaxFeature = 'swap' | 'moneyMarket' | 'bridge' | 'staking' | 'migration' | 'dex' | 'partner' | 'recovery';
+type SodaxFeature = 'swap' | 'moneyMarket' | 'bridge' | 'staking' | 'migration' | 'dex' | 'partner' | 'recovery' | 'leverageYield';
 /**
  * Orchestration phase tag attached via `context.phase`. Canonical superset across all
  * features — all features draw from this list rather than minting their own.
@@ -133,7 +133,7 @@ declare const LOOKUP_CODES: ReadonlySet<LookupErrorCode>;
 /** Runtime list of all valid error codes — useful for membership checks and exhaustive switches. */
 declare const SODAX_ERROR_CODES: readonly ["VALIDATION_FAILED", "INTENT_CREATION_FAILED", "EXECUTION_FAILED", "TX_VERIFICATION_FAILED", "TX_SUBMIT_FAILED", "RELAY_TIMEOUT", "RELAY_FAILED", "APPROVE_FAILED", "ALLOWANCE_CHECK_FAILED", "GAS_ESTIMATION_FAILED", "LOOKUP_FAILED", "EXTERNAL_API_ERROR", "UNKNOWN"];
 /** Runtime list of all valid feature tags. */
-declare const SODAX_FEATURES: readonly ["swap", "moneyMarket", "bridge", "staking", "migration", "dex", "partner", "recovery"];
+declare const SODAX_FEATURES: readonly ["swap", "moneyMarket", "bridge", "staking", "migration", "dex", "partner", "recovery", "leverageYield"];
 
 /**
  * Canonical error type for the SODAX SDK.
@@ -7813,16 +7813,22 @@ type ConfigServiceConstructorParams = {
     api: BackendApiService;
     config: SodaxConfig;
     /**
-     * The raw user-provided config override (the `DeepPartial<SodaxConfig>` passed to `new Sodax(...)`),
+     * The raw user-provided config override (the `SodaxOptions` passed to `new Sodax(...)`),
      * NOT the merged result. Re-applied on top of dynamic config in {@link ConfigService.initialize} so
      * that a remote config fetch never clobbers explicit user overrides.
      */
-    userConfig?: DeepPartial<SodaxConfig>;
+    userConfig?: SodaxOptions;
     /**
      * Pre-resolved SDK log sink. Held outside the swappable `SodaxConfig` so a dynamic config fetch
      * in {@link ConfigService.initialize} never replaces it. Defaults to the console logger when omitted.
      */
     logger?: SodaxLogger;
+    /**
+     * Global partner fee (the `fee` option passed to `new Sodax(...)`). Held outside the swappable
+     * `SodaxConfig` — like {@link logger} — so a dynamic config fetch never replaces it. The backend
+     * never supplies it; it is purely a client-side option.
+     */
+    fee?: PartnerFee;
 };
 /**
  * ConfigApiService - Service for fetching configuration data from the backend API or fallbacking to default values
@@ -7836,6 +7842,12 @@ declare class ConfigService {
      * {@link initialize}'s dynamic-config swap never clobbers it. Read by services via `config.logger`.
      */
     readonly logger: SodaxLogger;
+    /**
+     * Global partner fee. Resolved once at construction and kept independent of {@link sodax} so that
+     * {@link initialize}'s dynamic-config swap never clobbers it. The backend never supplies it — it is
+     * a client-side option set via `new Sodax({ fee })`. Per-feature overrides live on the feature config.
+     */
+    readonly fee: PartnerFee | undefined;
     private initialized;
     private supportedHubAssetsSet;
     private supportedSodaVaultAssetsSet;
@@ -7846,7 +7858,7 @@ declare class ConfigService {
     private stakedATokenAddressesSet;
     private chainToSupportedTokenAddressMap;
     private hubAssetToXTokenMap;
-    constructor({ api, config, userConfig, logger }: ConfigServiceConstructorParams);
+    constructor({ api, config, userConfig, logger, fee }: ConfigServiceConstructorParams);
     initialize(): Promise<Result<void>>;
     getChains(): GetChainsApiResponse;
     getSwapTokens(): GetSwapTokensApiResponse;
@@ -7899,6 +7911,11 @@ declare class ConfigService {
     get swaps(): SwapsConfig;
     get bridge(): BridgeConfig;
     get moneyMarket(): MoneyMarketConfig;
+    get leverageYield(): LeverageYieldConfig;
+    get swapPartnerFee(): PartnerFee | undefined;
+    get moneyMarketPartnerFee(): PartnerFee | undefined;
+    get bridgePartnerFee(): PartnerFee | undefined;
+    get leverageYieldPartnerFee(): PartnerFee | undefined;
     get dex(): DexConfig;
     getChainConfig<K extends SpokeChainKey>(key: K): GetSpokeChainConfigType<K>;
     get sodaxConfig(): SodaxConfig;
@@ -7912,18 +7929,25 @@ declare class ConfigService {
 declare function parseTokenArrayFromJson(input: unknown): readonly XToken[];
 
 /**
- * Layers a user `DeepPartial<SodaxConfig>` override on top of a full base config (the static default in the
+ * Layers a user SodaxOptions override on top of a full base config (the static default in the
  * Sodax constructor, or the dynamic config in {@link ConfigService.initialize}).
  *
- * Most fields are deep-merged, so a user can override `api.timeout` without dropping the sibling `api.baseURL`.
- * `PartnerFee` is the exception: it is a discriminated union (`{address, amount}` | `{address, percentage}`),
- * so deep-merging a percentage override onto an amount base (or vice versa) would yield an invalid hybrid
- * carrying both keys. Downstream discrimination treats any object with a bigint `amount` as the amount
- * variant (see `isPartnerFeeAmount` / `calculateFeeAmount`), so such a hybrid silently mis-charges the fee.
- * The two `PartnerFee`-typed config fields are therefore atomic — the override replaces the base value
- * wholesale, which means a fee override must be a complete `PartnerFee`, not a partial.
+ * Every field is deep-merged, so a user can override `api.timeout` without dropping the sibling `api.baseURL`,
+ * and can set a per-feature `partnerFee` (`swaps` / `moneyMarket` / `bridge` / `leverageYield`) without
+ * disturbing that feature's other defaults. A per-feature `partnerFee` is never present on the base config —
+ * it is a `SodaxOptions`/feature-options field, not part of `SodaxDefaultConfig` or the backend dynamic
+ * config, so it never travels on the wire. Every fee override therefore lands on an empty slot and a complete
+ * `PartnerFee` is written wholesale; there is no base variant to merge against, so no partial-variant hybrid
+ * (`{address, amount, percentage}`) can arise. `PartnerFee` is a discriminated union and downstream
+ * discrimination treats any object with a bigint `amount` as the amount variant (see `isPartnerFeeAmount` /
+ * `calculateFeeAmount`), which is exactly why a fee override must be a complete `PartnerFee`, not a partial.
+ *
+ * The global `fee` is NOT merged here: it is a `SodaxOptions` client option (like `logger`), resolved once
+ * and held on `ConfigService.fee`, where it acts as the per-feature fee fallback (`featureFee ?? fee`, via
+ * `ConfigService.swapPartnerFee` / `moneyMarketPartnerFee` / `bridgePartnerFee`). Config merging and
+ * effective-fee resolution are separate concerns, so the merge layer deliberately leaves `fee` alone.
  */
-declare function mergeSodaxConfig(base: SodaxConfig, override: DeepPartial<SodaxConfig>): SodaxConfig;
+declare function mergeSodaxConfig(base: SodaxDefaultConfig, override: SodaxOptions): SodaxConfig;
 
 /**
  * ABI-encode an array of ContractCall objects.
@@ -8091,6 +8115,7 @@ type OptionalSkipSimulation$1 = {
 };
 type DepositParams<C extends SpokeChainKey, Raw extends boolean = boolean> = {
     srcAddress: GetAddressType<C>;
+    srcPublicKey?: string;
     srcChainKey: C;
     to: HubAddress;
     token: GetTokenAddressType<C>;
@@ -8225,6 +8250,19 @@ type CreateIntentParams<K extends SpokeChainKey = SpokeChainKey> = {
 type CreateLimitOrderParams<K extends SpokeChainKey = SpokeChainKey> = Omit<CreateIntentParams<K>, 'deadline'> & {
     deadline?: bigint;
 };
+type SrcPublicKeySlot<K extends SpokeChainKey> = GetChainType<K> extends 'STACKS' ? {
+    srcPublicKey?: string;
+} : {
+    srcPublicKey?: never;
+};
+/**
+ * Per-action extras for swap intent creation, supplied via the `extras` slot of the swap
+ * action params.
+ */
+type SwapExtras<K extends SpokeChainKey = SpokeChainKey> = {
+    /** Overrides the configured swap partner fee for this action; falls back to config when omitted. */
+    partnerFee?: PartnerFee;
+} & SrcPublicKeySlot<K>;
 type Intent = {
     intentId: bigint;
     creator: Address;
@@ -8654,11 +8692,30 @@ type IntentDeliveryInfo = {
     dstTxHash: string;
     dstAddress: string;
 };
+type RelayTxStatus = 'pending' | 'validating' | 'executing' | 'executed';
+type PacketData = {
+    src_chain_id: number;
+    src_tx_hash: string;
+    src_address: string;
+    status: RelayTxStatus;
+    dst_chain_id: number;
+    conn_sn: number;
+    dst_address: string;
+    dst_tx_hash: string;
+    signatures: string[];
+    payload: string;
+};
 type WaitUntilIntentExecutedPayload = {
     intentRelayChainId: string;
     srcTxHash: string;
     timeout?: number;
     apiUrl: HttpUrl;
+    /**
+     * Disambiguates when a single src tx emits multiple relay packets. Receives the candidates
+     * already filtered by `srcTxHash` and returns the desired one (or undefined to keep polling).
+     * Defaults to "first candidate" — the legacy behavior for single-packet flows.
+     */
+    selectPacket?: (packets: PacketData[]) => PacketData | undefined;
 };
 type RelayAction = 'submit' | 'get_transaction_packets' | 'get_packet';
 type IntentRelayRequest<T extends RelayAction> = {
@@ -9469,14 +9526,6 @@ interface State {
     hub_chain_id: string;
     owner: string;
 }
-/**
- * InjectiveSpokeService provides methods for interacting with the Injective spoke chain,
- * specifically for managing token deposits and transfers between the spoke chain and hub chain.
- * It handles the cross-chain communication and token bridging functionality, allowing users to:
- * - Deposit tokens from Injective to the hub chain
- * - Check token balances on the spoke chain
- * - Transfer tokens with custom data payloads
- */
 declare class InjectiveSpokeService {
     private readonly config;
     readonly chainGrpcWasmApi: ChainGrpcWasmApi;
@@ -9484,7 +9533,10 @@ declare class InjectiveSpokeService {
     readonly endpoints: NetworkEndpoints;
     private readonly pollingIntervalMs;
     private readonly maxTimeoutMs;
+    private readonly gasPrice;
     constructor(config: ConfigService);
+    /** Parse a chain-config gas price like `"500000000inj"` into its numeric price and denom. */
+    private parseGasPrice;
     /**
      * Estimate the gas for a transaction.
      * @param {InjectiveRawTransaction} rawTx - The raw transaction to estimate the gas for.
@@ -9508,7 +9560,7 @@ declare class InjectiveSpokeService {
      * @returns {Promise<bigint>} The balance of the token.
      */
     getDeposit(params: GetDepositParams<InjectiveChainKey>): Promise<bigint>;
-    getRawTransaction(chainId: string, senderAddress: string, contractAddress: string, msg: JsonObject, memo?: string): Promise<InjectiveRawTransaction>;
+    getRawTransaction(chainId: string, senderAddress: string, contractAddress: string, msg: JsonObject, memo?: string, funds?: InjectiveCoin[]): Promise<InjectiveRawTransaction>;
     getState(chainId: InjectiveChainKey): Promise<State>;
     /**
      * Sends a message to the hub chain.
@@ -9649,7 +9701,6 @@ declare class SpokeService {
     waitForTxReceipt<C extends SpokeChainKey = SpokeChainKey>(params: WaitForTxReceiptParams<C>): Promise<Result<WaitForTxReceiptReturnType<C>>>;
 }
 
-type RelayTxStatus = 'pending' | 'validating' | 'executing' | 'executed';
 /**
  * Stable error message strings emitted by relay-layer helpers ({@link submitTransaction},
  * {@link relayTxAndWaitPacket}) on failure.
@@ -9704,18 +9755,6 @@ type SubmitTxResponse = {
     success: boolean;
     message: string;
 };
-type PacketData = {
-    src_chain_id: number;
-    src_tx_hash: string;
-    src_address: string;
-    status: RelayTxStatus;
-    dst_chain_id: number;
-    conn_sn: number;
-    dst_address: string;
-    dst_tx_hash: string;
-    signatures: string[];
-    payload: string;
-};
 type GetTransactionPacketsResponse = {
     success: boolean;
     data: PacketData[];
@@ -11688,8 +11727,8 @@ type CreateIntentResult<K extends SpokeChainKey, Raw extends boolean> = {
     intent: Intent & FeeAmount;
     relayData: RelayExtraData;
 };
-type SwapActionParams<K extends SpokeChainKey, Raw extends boolean = false> = SpokeExecActionParams<K, Raw, CreateIntentParams<K>>;
-type LimitOrderActionParams<K extends SpokeChainKey, Raw extends boolean = false> = SpokeExecActionParams<K, Raw, CreateLimitOrderParams<K>>;
+type SwapActionParams<K extends SpokeChainKey, Raw extends boolean = false> = SpokeExecActionParams<K, Raw, CreateIntentParams<K>, SwapExtras<K>>;
+type LimitOrderActionParams<K extends SpokeChainKey, Raw extends boolean = false> = SpokeExecActionParams<K, Raw, CreateLimitOrderParams<K>, SwapExtras<K>>;
 /**
  * Params for `cancelIntent`.
  * Because `Intent.srcChain` is an `IntentRelayChainId` (bigint) whose literal type cannot
@@ -11703,6 +11742,10 @@ type CancelIntentParams<K extends SpokeChainKey> = {
     timeout?: number;
 };
 type CancelIntentActionParams<K extends SpokeChainKey, Raw extends boolean = false> = SpokeExecActionParams<K, Raw, CancelIntentParams<K>>;
+type GetQuoteParams = SolverIntentQuoteRequest & {
+    /** Optional per-call override of the configured swap partner fee. Falls back to config when omitted. */
+    partnerFee?: PartnerFee;
+};
 type SwapServiceConstructorParams = {
     config: ConfigService;
     spoke: SpokeService;
@@ -11742,10 +11785,13 @@ declare class SwapService {
     /**
      * Requests a price quote from the solver API for a given token pair and amount.
      *
-     * Adjusts `payload.amount` by the configured partner fee before forwarding to the solver,
-     * so the returned `quoted_amount` reflects the net output the user actually receives.
+     * Adjusts `payload.amount` by the partner fee before forwarding to the solver, so the returned
+     * `quoted_amount` reflects the net output the user actually receives. Pass `partnerFee` to match
+     * a per-action override supplied to `createIntent` (`extras.partnerFee`); omit it to use the
+     * configured swap fee.
      *
-     * @param payload - Source/destination tokens, chain IDs, input amount, and quote type.
+     * @param payload - The solver quote request, optionally carrying a per-call `partnerFee` override
+     *   (defaults to the configured swap partner fee). `partnerFee` is stripped before forwarding.
      * @returns A `Result` containing `{ quoted_amount: bigint }` on success, or a
      *   `SolverErrorResponse` (with a `SolverIntentErrorCode`) on failure.
      *
@@ -11760,7 +11806,7 @@ declare class SwapService {
      * });
      * if (response.ok) console.log('Quoted amount:', response.value.quoted_amount);
      */
-    getQuote(payload: SolverIntentQuoteRequest): Promise<Result<SolverIntentQuoteResponse, SolverErrorResponse>>;
+    getQuote(payload: GetQuoteParams): Promise<Result<SolverIntentQuoteResponse, SolverErrorResponse>>;
     /**
      * Calculates the partner fee that will be deducted from the given input amount.
      *
@@ -12040,6 +12086,11 @@ declare class SwapService {
      * Use this after `getStatus` returns `SolverIntentStatusCode.SOLVED (3)` to obtain the
      * destination-chain transaction hash from `packet.dst_tx_hash`.
      *
+     * A single solver fill tx emits multiple relay packets sharing the same `src_tx_hash`. The
+     * user-facing `IntentFilled` delivery is the packet whose payload targets the hub intents
+     * contract; `selectSolvedIntentPacket` disambiguates so the returned `dst_tx_hash` is the
+     * destination delivery tx rather than an internal hop.
+     *
      * @param chainId - The destination spoke chain key (where output tokens are delivered).
      * @param fillTxHash - The solver's fill transaction hash, obtained from `getStatus.fill_tx_hash`.
      * @param timeout - Poll timeout in milliseconds. Defaults to `DEFAULT_RELAY_TX_TIMEOUT` (120 s).
@@ -16011,6 +16062,481 @@ declare class RecoveryService {
     withdrawHubAsset<K extends SpokeChainKey, Raw extends boolean>(_params: WithdrawHubAssetAction<K, Raw>): Promise<Result<TxReturnType<K, Raw>>>;
 }
 
+/**
+ * leverageYield module narrow error types.
+ *
+ * The service owns the full vault-swap lifecycle: `deposit` / `withdraw` build
+ * `CreateIntentParams`, `createVaultIntent` submits the intent on the source spoke chain,
+ * and `vaultSwap` orchestrates the end-to-end flow (create → verify → relay → notify
+ * solver). `approve` / `isAllowanceValid` manage the underlying-asset allowance on Sonic,
+ * and the read methods query on-chain state.
+ *
+ * User-facing actions discriminated by `context.action`: `'deposit' | 'withdraw' |
+ * 'approve' | 'vaultSwap'`. Read-only methods emit `LOOKUP_FAILED` partitioned by
+ * `context.method`. Relay/verify codes appear only on `vaultSwap` — `createVaultIntent`
+ * alone emits the create-intent subset.
+ */
+
+declare const leverageYieldInvariant: FeatureInvariant;
+type LeverageYieldAction = 'deposit' | 'withdraw' | 'approve' | 'allowanceCheck' | 'vaultSwap';
+type LeverageYieldCreateIntentErrorCode = CreateIntentErrorCode;
+type LeverageYieldApproveErrorCode = ApproveErrorCode;
+type LeverageYieldAllowanceCheckErrorCode = AllowanceCheckErrorCode;
+type LeverageYieldLookupErrorCode = LookupErrorCode;
+/**
+ * Codes returnable by the solver-notify step inside `vaultSwap`. Mirrors the swap
+ * domain's `PostExecutionErrorCode` — duplicated deliberately so the leverage-yield
+ * error surface stands alone (see `vaultSwap`).
+ */
+type LeverageYieldPostExecutionErrorCode = Extract<SodaxErrorCode, 'EXECUTION_FAILED' | 'EXTERNAL_API_ERROR' | 'UNKNOWN'>;
+/**
+ * Codes returnable by the end-to-end `vaultSwap` orchestrator: the create-intent subset
+ * plus verify, relay and solver-notify codes. Mirrors the swap domain's `SwapErrorCode`.
+ */
+type LeverageYieldSwapErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'EXTERNAL_API_ERROR' | 'UNKNOWN'>;
+type LeverageYieldErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'APPROVE_FAILED' | 'ALLOWANCE_CHECK_FAILED' | 'LOOKUP_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'EXTERNAL_API_ERROR' | 'UNKNOWN'>;
+type LeverageYieldCreateIntentError = SodaxError<LeverageYieldCreateIntentErrorCode>;
+type LeverageYieldApproveError = SodaxError<LeverageYieldApproveErrorCode>;
+type LeverageYieldAllowanceCheckError = SodaxError<LeverageYieldAllowanceCheckErrorCode>;
+type LeverageYieldLookupError = SodaxError<LeverageYieldLookupErrorCode>;
+type LeverageYieldPostExecutionError = SodaxError<LeverageYieldPostExecutionErrorCode>;
+type LeverageYieldSwapError = SodaxError<LeverageYieldSwapErrorCode>;
+type LeverageYieldError = SodaxError<LeverageYieldErrorCode>;
+declare const isLeverageYieldCreateIntentError: (e: unknown) => e is SodaxError<CreateIntentErrorCode>;
+declare const isLeverageYieldApproveError: (e: unknown) => e is SodaxError<ApproveErrorCode>;
+declare const isLeverageYieldAllowanceCheckError: (e: unknown) => e is SodaxError<AllowanceCheckErrorCode>;
+declare const isLeverageYieldLookupError: (e: unknown) => e is SodaxError<LookupErrorCode>;
+declare const isLeverageYieldPostExecutionError: (e: unknown) => e is SodaxError<LeverageYieldPostExecutionErrorCode>;
+declare const isLeverageYieldSwapError: (e: unknown) => e is SodaxError<LeverageYieldSwapErrorCode>;
+declare const isLeverageYieldError: (e: unknown) => e is SodaxError<LeverageYieldErrorCode>;
+
+/**
+ * Leveraged-position snapshot from the vault's non-standard `getPositionDetails()`.
+ * Field scales (mirroring the AAVE conventions the vault inherits):
+ */
+type LeverageYieldPosition = {
+    /** Collateral supplied to the AAVE pool, in vault-asset units (18 decimals). */
+    collateral: bigint;
+    /** Variable debt borrowed against the collateral, in vault-asset units (18 decimals). */
+    debt: bigint;
+    /** Current loan-to-value in basis points (out of `10_000`; e.g. `8_500` = 85%). */
+    ltv: bigint;
+    /** AAVE health factor in WAD (1e18); below `1e18` implies liquidation risk, `type(uint256).max` = no debt. */
+    healthFactor: bigint;
+    /** Asset held by the vault but not yet supplied to the pool, in vault-asset units (18 decimals). */
+    idleAsset: bigint;
+};
+/**
+ * Output of {@link LeverageYieldService.getApr}. All rate fields are in RAY (1e27 = 100%)
+ * matching the AAVE convention — divide by `RAY = 10n ** 27n` for the decimal form.
+ *
+ * `netAprRay` is the headline number a UI shows: net APR earned by a depositor at the
+ * vault's `targetLTV`. It's a STEADY-STATE APR, not realised APY — assumes the AAVE rates
+ * stay constant and the vault holds at `targetLTV` continuously. Realised APY in practice
+ * depends on tick cadence, rate volatility, and the spread between supplyApr and borrowApr.
+ *
+ * The math:
+ * ```
+ * leverageMultiplier = targetLTV / (1 - targetLTV)   // e.g. 0.85 / 0.15 = 5.667x
+ * netAprRay = supplyAprRay + leverageMultiplier × (supplyAprRay - borrowAprRay)
+ * ```
+ * Equivalent to the geometric-series limit of recursive borrow → swap → supply at the
+ * vault's target LTV. When `supplyApr > borrowApr` the leverage adds yield; when the
+ * spread inverts the loop is a net cost and `netAprRay` goes negative.
+ */
+type LeverageYieldApr = {
+    /** AAVE supply rate of the vault's `asset` (sodaWEETH-style), in RAY. */
+    supplyAprRay: bigint;
+    /** AAVE variable borrow rate of the vault's `borrowToken` (sodaETH-style), in RAY. */
+    borrowAprRay: bigint;
+    /** Target LTV in basis points, as read from `vault.targetLTV()`. */
+    targetLtvBps: bigint;
+    /**
+     * Leverage multiplier ×1e18 (e.g. 5.667x is `5_666_666_666_666_666_667n`). Caller can
+     * divide by `10n ** 18n` for the decimal form.
+     */
+    leverageMultiplierWad: bigint;
+    /** Net APR earned by a depositor at `targetLtvBps`, in RAY. Can be negative. */
+    netAprRay: bigint;
+};
+/**
+ * Off-chain LSD staking-APR snapshot for a leverage-yield vault's underlying asset.
+ * Returned by {@link LeverageYieldService.getLsdApr} and embedded in
+ * {@link LeverageYieldEffectiveApr}.
+ */
+type LeverageYieldLsdApr = {
+    /** LSD staking APR in RAY (1e27 = 100%). Zero when the vault has no configured LSD source. */
+    aprRay: bigint;
+    /** Human-readable provider label, e.g. `'Lido (stETH)'` (suffixed with `(fallback)` on error). */
+    label: string;
+    /**
+     * `true` when this value came from the hardcoded `fallbackAprPct` rather than a live
+     * fetch — either because the provider has no live endpoint (`manual`), the network
+     * call failed, or the vault has no LSD source configured. UIs should label the value
+     * as an estimate in this state.
+     */
+    stale: boolean;
+};
+/**
+ * Combined AAVE + LSD APR view — extends {@link LeverageYieldApr} with the LSD staking
+ * yield folded into the supply side. Returned by {@link LeverageYieldService.getEffectiveApr}.
+ *
+ * The `netAprRay` inherited from {@link LeverageYieldApr} is the **AAVE-only** number —
+ * the negative-spread case the SDK historically reported. `effectiveNetAprRay` is the
+ * honest one for LSD-backed strategies because it includes the LSD's native staking yield,
+ * which is the dominant component for these vaults.
+ */
+type LeverageYieldEffectiveApr = LeverageYieldApr & {
+    /** LSD staking APR snapshot used to compute the effective rates. */
+    lsdApr: LeverageYieldLsdApr;
+    /** `supplyAprRay + lsdApr.aprRay`, in RAY — the yield the supply side actually earns. */
+    effectiveSupplyAprRay: bigint;
+    /**
+     * `effectiveSupplyAprRay + leverage × (effectiveSupplyAprRay − borrowAprRay)`, in RAY.
+     * The headline number a UI should display.
+     */
+    effectiveNetAprRay: bigint;
+};
+/**
+ * Builds the swap payload for a swap-style leverage-yield deposit — swapping any
+ * solver-supported `inputToken` on `srcChainKey` into the vault's lsoda* share token,
+ * delivered to the user's hub wallet on Sonic. Spread the result into `swaps.swap()`.
+ */
+type LeverageYieldSwapDepositParams = {
+    /** Hub-side LeverageYieldVault proxy address — its address doubles as the lsoda* token. */
+    vault: Address;
+    /** Spoke chain the user holds `inputToken` on and signs from. */
+    srcChainKey: SpokeChainKey;
+    /** User's EOA on `srcChainKey`. */
+    srcAddress: string;
+    /** Spoke-side token the user pays in. */
+    inputToken: string;
+    /** Amount of `inputToken` to swap (input-token decimals). */
+    inputAmount: bigint;
+    /** Minimum acceptable lsoda* output (18 decimals). Slippage already applied. */
+    minOutputAmount: bigint;
+    /** Deadline (unix seconds). Defaults to the hub block timestamp + 5 min. */
+    deadline?: bigint;
+    /** Optional specific solver. `0x0` = any solver. */
+    solver?: Address;
+    /**
+     * Partner fee for this deposit, carried on the payload as the swap layer's per-intent
+     * fee override. Defaults to the effective swap fee (`config.swapPartnerFee` = the `swaps`
+     * override if set, else the global `fee`).
+     */
+    partnerFee?: PartnerFee;
+};
+/**
+ * Builds the swap payload for a swap-style leverage-yield withdraw — swapping the vault's
+ * lsoda* shares (held in the user's hub wallet) back into any solver-supported token on
+ * any chain. The payload carries `hubWalletSwap: true`; spread it into `swaps.swap()`,
+ * which authorises the hub wallet via `Connection.sendMessage`.
+ */
+type LeverageYieldSwapWithdrawParams = {
+    /** Hub-side LeverageYieldVault proxy address — its address doubles as the lsoda* token. */
+    vault: Address;
+    /** Spoke chain the user signs the `sendMessage` from (drives hub-wallet derivation). */
+    srcChainKey: SpokeChainKey;
+    /** User's EOA on `srcChainKey`. */
+    srcAddress: string;
+    /** Output chain — where the solver delivers the swapped-back token. */
+    dstChainKey: SpokeChainKey;
+    /** Output spoke-side token address. */
+    outputToken: string;
+    /** Amount of lsoda* shares to swap (18 decimals). */
+    inputAmount: bigint;
+    /** Minimum acceptable output (output-token decimals). Slippage already applied. */
+    minOutputAmount: bigint;
+    /** Recipient on `dstChainKey`. Defaults to `srcAddress`. */
+    recipient?: string;
+    /** Deadline (unix seconds). Defaults to the hub block timestamp + 5 min. */
+    deadline?: bigint;
+    /** Optional specific solver. `0x0` = any solver. */
+    solver?: Address;
+};
+/**
+ * Action-shaped swap payload built by {@link LeverageYieldService.deposit} /
+ * {@link LeverageYieldService.withdraw}. Spread it into
+ * {@link LeverageYieldService.vaultSwap} (or {@link LeverageYieldService.createVaultIntent})
+ * alongside the wallet provider: `vaultSwap({ ...payload, walletProvider })`.
+ * `withdraw` sets `hubWalletSwap: true` so the swap spends the lsoda* held in the
+ * user's hub wallet.
+ */
+type LeverageYieldSwapPayload = {
+    params: CreateIntentParams;
+    hubWalletSwap?: true;
+    /** Per-intent partner-fee override (deposit only). */
+    partnerFee?: PartnerFee;
+};
+/**
+ * Exec-mode params for {@link LeverageYieldService.createVaultIntent} /
+ * {@link LeverageYieldService.vaultSwap}: `walletProvider` is required and K-narrowed
+ * (`raw: true` returns unsigned tx data instead). The two vault-specific execution
+ * modifiers live HERE — on the leverage-yield action wrapper, never on the generic swap
+ * surface:
+ * - `hubWalletSwap` marks `params.inputToken` as a hub-chain token already sitting in the
+ *   user's hub wallet — `srcChainKey` is then the chain the user *signs* on, and the
+ *   intent is created by authorising the hub wallet via a `Connection.sendMessage`
+ *   instead of a spoke-side AssetManager deposit.
+ * - `partnerFee` overrides the effective swap fee (`config.swapPartnerFee`) for this
+ *   intent only.
+ */
+type VaultSwapActionParams<K extends SpokeChainKey, Raw extends boolean = false> = SpokeExecActionParams<K, Raw, CreateIntentParams<K>> & {
+    hubWalletSwap?: boolean;
+    partnerFee?: PartnerFee;
+};
+/**
+ * Success value of {@link LeverageYieldService.createVaultIntent}. Mirrors the swap
+ * domain's `CreateIntentResult` — duplicated deliberately so the leverage-yield surface
+ * stands alone.
+ */
+type CreateVaultIntentResult<K extends SpokeChainKey, Raw extends boolean> = {
+    tx: TxReturnType<K, Raw>;
+    intent: Intent & FeeAmount;
+    relayData: RelayExtraData;
+};
+/**
+ * Success value of {@link LeverageYieldService.vaultSwap}. Mirrors the swap domain's
+ * `SwapResponse` — duplicated deliberately so the leverage-yield surface stands alone.
+ */
+type VaultSwapResponse = {
+    solverExecutionResponse: SolverExecutionResponse;
+    intent: Intent;
+    intentDeliveryInfo: IntentDeliveryInfo;
+};
+type LeverageYieldApproveParams<R extends boolean> = {
+    vault: Address;
+    /** Amount of the vault's underlying asset to approve. */
+    amount: bigint;
+    walletProvider: IEvmWalletProvider;
+    raw?: R;
+};
+type LeverageYieldAllowanceParams = {
+    vault: Address;
+    amount: bigint;
+    owner: Address;
+};
+type LeverageYieldServiceConstructorParams = {
+    hubProvider: HubProvider;
+    config: ConfigService;
+    spoke: SpokeService;
+};
+/**
+ * Treats leverage-yield ERC-4626 vault shares (lsoda* tokens) as solver-tradeable tokens:
+ * deposits and withdrawals are intent-based swaps the service executes itself via
+ * `vaultSwap()` — the generic swap surface stays untouched by vault concerns.
+ *
+ * Methods:
+ * - `deposit` / `withdraw` — build a {@link LeverageYieldSwapPayload} for a swap-style deposit
+ *   (any token → lsoda*) and withdraw (lsoda* → any token); spread the result into
+ *   `vaultSwap()`. `withdraw` sets `hubWalletSwap: true` so the vault swap spends the lsoda*
+ *   held in the user's hub wallet via a `Connection.sendMessage`.
+ * - `createVaultIntent` / `vaultSwap` / `notifySolver` — leverage-yield copies of the swap
+ *   domain's `createIntent` / `swap()` / `postExecution` (duplicated deliberately — the vault
+ *   execution modifiers `hubWalletSwap` and per-intent `partnerFee` live here, not on the swap
+ *   domain). `createVaultIntent` submits the intent tx on the source spoke chain; `vaultSwap`
+ *   orchestrates the full create → verify → relay → notify-solver lifecycle; `notifySolver` is
+ *   the standalone notify step, public so callers driving the relay themselves (after a
+ *   `createVaultIntent`) can complete the flow.
+ * - `approve` / `isAllowanceValid` — Sonic-direct allowance management for the vault's
+ *   underlying asset (sodaWEETH-style).
+ * - `getPosition` / `getApr` / `getEffectiveApr` / `getLsdApr` / `getMaxWithdraw` /
+ *   `getMaxWithdrawForUser` / `getShareBalance` / `getShareBalanceForUser` /
+ *   `getTotalAssets` / `previewDeposit` / `previewWithdraw` / `previewRedeem` — reads.
+ *   Use `getEffectiveApr` for the honest LSD-aware APR; `getApr` reports the AAVE-only
+ *   spread and goes negative when the LSD's native staking yield is the alpha source.
+ * - `listVaults` / `getVault` / `getVaultByAddress` — registry lookups.
+ */
+declare class LeverageYieldService {
+    private readonly hubProvider;
+    private readonly config;
+    private readonly spoke;
+    constructor({ hubProvider, config, spoke }: LeverageYieldServiceConstructorParams);
+    /** Returns the static registry of known leverage-yield vaults. */
+    listVaults(): readonly LeverageYieldVault[];
+    /** Looks up a vault by its `name` field. Returns `undefined` when not registered. */
+    getVault(name: string): LeverageYieldVault | undefined;
+    /**
+     * Looks up a registered vault by its on-chain proxy address (case-insensitive).
+     * Returns `undefined` when the address isn't in the registry.
+     */
+    getVaultByAddress(address: Address): LeverageYieldVault | undefined;
+    /**
+     * Resolves the intent `deadline`: returns the caller-supplied value verbatim, otherwise
+     * derives a default from the hub-chain (Sonic) block timestamp plus
+     * {@link INTENT_DEADLINE_BUFFER_SECONDS}. The deadline is enforced on-chain against the hub
+     * block time, so the default is anchored to that block — never the client clock, which can
+     * drift and produce an already-expired or over-extended deadline.
+     *
+     * Returns a {@link Result}: a `getBlock` RPC outage is a read failure, surfaced as
+     * `LOOKUP_FAILED` (`method: 'resolveDeadline'`) rather than masquerading as an intent-build
+     * failure. The `deposit` / `withdraw` callers forward it verbatim.
+     */
+    private resolveDeadline;
+    /**
+     * Builds the {@link LeverageYieldSwapPayload} for a leverage-yield deposit (any token → lsoda*).
+     * The lsoda* output is delivered to the user's hub wallet on Sonic so a later
+     * {@link LeverageYieldService.withdraw} can swap it back. Spread the result into
+     * {@link LeverageYieldService.vaultSwap}: `vaultSwap({ ...payload, walletProvider })`.
+     * An optional `partnerFee` is forwarded on the payload as the per-intent fee override.
+     *
+     * For `minOutputAmount`, quote via `sodax.swaps.getQuote` with the vault address as the
+     * destination token (`token_dst`) — vault shares are solver-tradeable, so the generic swap
+     * quote applies; then subtract your slippage tolerance.
+     */
+    deposit(params: LeverageYieldSwapDepositParams): Promise<Result<LeverageYieldSwapPayload, LeverageYieldCreateIntentError | LeverageYieldLookupError>>;
+    /**
+     * Builds the {@link LeverageYieldSwapPayload} for a leverage-yield withdraw (lsoda* → any
+     * token). The payload carries `hubWalletSwap: true` — {@link LeverageYieldService.vaultSwap}
+     * then spends the lsoda* held in the user's hub wallet by authorising it via a
+     * `Connection.sendMessage` the user signs on `srcChainKey`. Wrapped in a {@link Result} for
+     * a call shape uniform with {@link LeverageYieldService.deposit}; async because the default
+     * `deadline` is read from the hub block timestamp.
+     *
+     * For `minOutputAmount`, quote via `sodax.swaps.getQuote` with the vault address as the
+     * source token (`token_src`) — vault shares are solver-tradeable, so the generic swap quote
+     * applies; then subtract your slippage tolerance.
+     */
+    withdraw(params: LeverageYieldSwapWithdrawParams): Promise<Result<LeverageYieldSwapPayload, LeverageYieldCreateIntentError | LeverageYieldLookupError>>;
+    /**
+     * Creates a vault swap intent on the user's source spoke chain without submitting it to
+     * the solver. Leverage-yield copy of the swap domain's `createIntent`, specialised for
+     * vault flows — duplicated deliberately so the vault-specific execution modifiers
+     * (`hubWalletSwap`, per-intent `partnerFee`) stay off the generic swap surface.
+     *
+     * Use {@link LeverageYieldService.vaultSwap} for the full end-to-end flow
+     * (create → relay → notify solver); use this directly when you need the raw transaction
+     * or drive the relay yourself (e.g. the backend submit-tx path). To complete a manual flow,
+     * relay the returned `relayData` (the shared `relayTxAndWaitPacket` helper) and then call
+     * {@link LeverageYieldService.notifySolver} with the hub-side intent tx hash.
+     *
+     * @param _params - Intent parameters, source chain key, wallet provider (when `raw: false`),
+     *   and optional `skipSimulation` / `hubWalletSwap` / `partnerFee`.
+     * @returns A `Result<CreateVaultIntentResult<K, Raw>, LeverageYieldCreateIntentError>`.
+     *   On success contains:
+     *   - `tx` — chain-specific tx hash (executed) or raw tx data (raw mode).
+     *   - `intent` — the fully constructed `Intent` object augmented with `feeAmount`.
+     *   - `relayData` — `{ address, payload }` needed to submit the intent to the relayer.
+     *
+     *   On failure `result.error` is a SodaxError with `VALIDATION_FAILED` (invariant
+     *   precondition), `INTENT_CREATION_FAILED` (spoke-side creation/deposit failed) or
+     *   `UNKNOWN` (defensive fallback).
+     */
+    createVaultIntent<K extends SpokeChainKey, Raw extends boolean>(_params: VaultSwapActionParams<K, Raw>): Promise<Result<CreateVaultIntentResult<K, Raw>, LeverageYieldCreateIntentError>>;
+    /**
+     * Executes a full end-to-end leverage-yield vault swap (deposit or withdraw).
+     * Leverage-yield copy of the swap domain's `swap()` orchestrator:
+     * 1. Calls {@link LeverageYieldService.createVaultIntent} to submit the intent
+     *    transaction on the source spoke chain.
+     * 2. Verifies the spoke transaction landed on-chain.
+     * 3. For non-hub source chains: submits the spoke tx to the relayer and waits for the
+     *    relay packet to land on the hub (Sonic). Skipped when `srcChainKey` is the hub.
+     * 4. Notifies the solver, triggering it to fill the intent.
+     *
+     * Spread a {@link LeverageYieldSwapPayload} from `deposit` / `withdraw` into this method
+     * alongside the wallet provider: `vaultSwap({ ...payload, walletProvider })`.
+     *
+     * @returns A `Result<VaultSwapResponse, LeverageYieldSwapError>`. On success:
+     *   - `solverExecutionResponse` — solver acknowledgement (`{ answer: 'OK', intent_hash }`).
+     *   - `intent` — the on-chain intent object that was created.
+     *   - `intentDeliveryInfo` — source/destination chain keys, tx hashes, and user addresses.
+     *
+     *   On failure `result.error` carries one of the create-intent codes plus
+     *   `TX_VERIFICATION_FAILED`, `TX_SUBMIT_FAILED`, `RELAY_TIMEOUT`, `RELAY_FAILED`,
+     *   `EXECUTION_FAILED`, `EXTERNAL_API_ERROR` or `UNKNOWN`.
+     */
+    vaultSwap<K extends SpokeChainKey>(_params: VaultSwapActionParams<K, false>): Promise<Result<VaultSwapResponse, LeverageYieldSwapError>>;
+    /**
+     * Notifies the solver that the vault intent landed on the hub, triggering it to fill.
+     * Leverage-yield copy of the swap domain's `postExecution` — emits only
+     * `EXECUTION_FAILED` / `EXTERNAL_API_ERROR` / `UNKNOWN` (relay/verify codes appear only
+     * on {@link LeverageYieldService.vaultSwap}, which owns the verify + relay steps).
+     *
+     * Called automatically by {@link LeverageYieldService.vaultSwap} after the relay packet
+     * lands on the hub. Public so callers who created the intent via
+     * {@link LeverageYieldService.createVaultIntent} and relayed it themselves can finish the
+     * flow manually.
+     *
+     * @param request - `{ intent_tx_hash }` — the hub-chain (Sonic) tx hash where the intent
+     *   was registered (the relay packet's `dst_tx_hash`, or the spoke tx hash for hub-sourced
+     *   intents).
+     */
+    notifySolver(request: SolverExecutionRequest): Promise<Result<SolverExecutionResponse, LeverageYieldPostExecutionError>>;
+    /**
+     * Approves the vault's underlying asset to the leverage vault on Sonic. For callers
+     * interacting with the vault directly on the hub — the swap-style {@link
+     * LeverageYieldService.deposit} flow handles its own approvals.
+     */
+    approve<R extends boolean = false>(params: LeverageYieldApproveParams<R>): Promise<Result<TxReturnType<HubChainKey, R>, LeverageYieldApproveError>>;
+    /**
+     * Reads on-chain allowance of the vault's underlying asset for `owner → vault`. Returns
+     * `true` when the allowance covers `amount`. Use before a direct
+     * {@link LeverageYieldService.deposit}.
+     */
+    isAllowanceValid(params: LeverageYieldAllowanceParams): Promise<Result<boolean, LeverageYieldAllowanceCheckError>>;
+    /** ERC-4626 `asset()` of the vault — the sodaWEETH-style underlying. */
+    getAsset(vault: Address): Promise<Result<Address, LeverageYieldLookupError>>;
+    /** Reads the vault's leveraged position snapshot via the non-standard `getPositionDetails`. */
+    getPosition(vault: Address): Promise<Result<LeverageYieldPosition, LeverageYieldLookupError>>;
+    /**
+     * Computes the steady-state APR of a leverage-yield vault from the AAVE supply/borrow
+     * rates of its asset and borrowToken, scaled by the vault's target leverage. Matches the
+     * convention used by leveraged-LSD vaults (Origami, Gearbox, etc.) — assumes constant
+     * LTV at `targetLTV` and constant AAVE rates.
+     *
+     * Returns raw fields in RAY (1e27, AAVE's native rate scale) plus the leverage multiplier
+     * in WAD (1e18). See {@link LeverageYieldApr} for the formula and caveats.
+     */
+    getApr(vault: Address): Promise<Result<LeverageYieldApr, LeverageYieldLookupError>>;
+    /**
+     * Off-chain LSD staking-APR for the vault's underlying asset. Looks the vault up in the
+     * registry, hits DefiLlama's per-pool chart endpoint for the configured `poolId`, and on
+     * any fetch failure returns the registry's hardcoded `fallbackAprPct` with `stale: true`.
+     *
+     * Always resolves to `{ ok: true, ... }` for a known vault — the fallback path replaces
+     * the error, since a missing LSD APR shouldn't break the parent call. Returns
+     * `{ aprRay: 0n, stale: true, label: 'no LSD source' }` for vaults without an
+     * `lsdSource` configured (non-LSD strategies); callers can treat that as "skip LSD".
+     */
+    getLsdApr(vault: Address): Promise<Result<LeverageYieldLsdApr, LeverageYieldLookupError>>;
+    /**
+     * Combined view of {@link getApr} + {@link getLsdApr}: re-applies the vault's leverage
+     * formula with the LSD's native staking yield folded into the supply side, exposing the
+     * **effective** net APR that LSD-backed strategies actually earn. The AAVE-only
+     * `netAprRay` is preserved on the return value for callers who want to display both.
+     *
+     *   effectiveSupply = supplyAprRay + lsdApr.aprRay
+     *   effectiveNet    = effectiveSupply + leverage × (effectiveSupply − borrowAprRay)
+     *
+     * Fetches AAVE rates and the LSD APR in parallel for one round-trip's worth of latency.
+     */
+    getEffectiveApr(vault: Address): Promise<Result<LeverageYieldEffectiveApr, LeverageYieldLookupError>>;
+    /** Synchronously withdrawable assets for `owner` (clamped against leverage HF floor). */
+    getMaxWithdraw(vault: Address, owner: Address): Promise<Result<bigint, LeverageYieldLookupError>>;
+    /** Total underlying assets currently held by the vault (vault-asset units, 18 decimals) — TVL. */
+    getTotalAssets(vault: Address): Promise<Result<bigint, LeverageYieldLookupError>>;
+    /** Shares minted for a given asset deposit. */
+    previewDeposit(vault: Address, assets: bigint): Promise<Result<bigint, LeverageYieldLookupError>>;
+    /** Shares burned for a given asset withdrawal. */
+    previewWithdraw(vault: Address, assets: bigint): Promise<Result<bigint, LeverageYieldLookupError>>;
+    /** Assets received for a given share redemption. */
+    previewRedeem(vault: Address, shares: bigint): Promise<Result<bigint, LeverageYieldLookupError>>;
+    /** Vault shares held by `owner`. */
+    getShareBalance(vault: Address, owner: Address): Promise<Result<bigint, LeverageYieldLookupError>>;
+    /**
+     * Convenience: resolves the user's hub wallet from `(srcChainKey, srcAddress)` and
+     * returns its on-chain `maxWithdraw`, less {@link MAX_WITHDRAW_DUST_BUFFER}. The trim
+     * keeps the value safe for an asset-denominated ERC-4626 `withdraw` — the raw
+     * `maxWithdraw` can trip the round-up that asks for one more share than the user holds.
+     */
+    getMaxWithdrawForUser<K extends SpokeChainKey>(vault: Address, srcChainKey: K, srcAddress: string): Promise<Result<bigint, LeverageYieldLookupError>>;
+    /**
+     * Convenience: resolves the user's hub wallet from `(srcChainKey, srcAddress)` and
+     * returns its on-chain share balance.
+     */
+    getShareBalanceForUser<K extends SpokeChainKey>(vault: Address, srcChainKey: K, srcAddress: string): Promise<Result<bigint, LeverageYieldLookupError>>;
+}
+
 /**
  * Sodax class is used to interact with the Sodax.
  *
@@ -16027,10 +16553,11 @@ declare class Sodax {
     readonly partners: PartnerService;
     readonly recovery: RecoveryService;
     readonly dex: DexService;
+    readonly leverageYield: LeverageYieldService;
     readonly config: ConfigService;
     readonly hubProvider: HubProvider;
     readonly spoke: SpokeService;
-    constructor(config?: SodaxOptions);
+    constructor(options?: SodaxOptions);
     /**
      * Initializes the Sodax instance with dynamic configuration.
      * You should use this option if you do not want to update package versions when new chains and tokens are added.
@@ -16587,4 +17114,4 @@ type DexErrorCode = LookupErrorCode;
 type DexError = SodaxError<DexErrorCode>;
 declare const isDexError: (e: unknown) => e is SodaxError<LookupErrorCode>;
 
-export { ALLOWANCE_CHECK_CODES, APPROVE_CODES, type AggregatedReserveData, type AllowanceCheckErrorCode, type AllowanceInfo, type AllowanceResponse, type AllowanceTransferDetails, type ApiResponse, type ApproveErrorCode, type ApyRange, type AssetDepositAction, type AssetEntry, AssetService, type AssetServiceConstructorParams, type AssetWithdrawAction, type AutoSwapPreferences, BackendApiService, type BalnLockParams, type BalnMigrateAction, type BalnMigrateParams, type BalnSwapAbi, BalnSwapService, type BalnSwapServiceConstructorParams, type BaseCurrencyInfo, BigIntToHex, type BigNumberValue, BigNumberZeroDecimal, BitcoinSpokeService, type BitcoinTransactionResult, type BitcoinUTXO, BnUSDMigrationService, type BnUSDMigrationServiceConstructorParams, type BnUSDRevertMigrationParams, type BorrowInfo, type BridgeAction, type BridgeAllowanceCheckError, type BridgeAllowanceCheckErrorCode, type BridgeApproveError, type BridgeApproveErrorCode, type BridgeCreateIntentError, type BridgeCreateIntentErrorCode, type BridgeError, type BridgeErrorCode, type BridgeLookupError, type BridgeLookupErrorCode, type BridgeOrchestrationError, type BridgeOrchestrationErrorCode, type BridgeParams, BridgeService, type BridgeServiceConstructorParams, type BtcPayload, CREATE_INTENT_CODES, type CalculateAllReserveIncentivesRequest, type CalculateAllUserIncentivesRequest, type CalculateCompoundedRateRequest, type CallResponse, type CancelIntentActionParams, type CancelIntentParams, type CancelUnstakeAction, type CancelUnstakeParams, type ClClaimRewardsParams, type ClDecreaseLiquidityParams, type ClGetPoolDataParams, type ClIncreaseLiquidityParams, type ClLiquidityClaimRewardsAction, type ClLiquidityDecreaseLiquidityAction, type ClLiquidityIncreaseLiquidityAction, type ClLiquidityWithdrawAction, type ClMintPositionEventLog, type ClPositionInfo, ClService, type ClServiceConstructorParams, type ClSupplyAction, type ClSupplyParams, type ClWithdrawParams, type ClaimAction, type ClaimParams, type CombinedReserveData, type ComputedUserReserve, type ConcentratedLiquidityParams, type ConcentratedLiquidityTokenInfo, ConfigService, type ConfigServiceConstructorParams, type ConnMsg, type CreateAssetDepositParams, type CreateAssetWithdrawParams, type CreateBridgeIntentParams, type CreateIntentErrorCode, type CreateIntentParams, type CreateIntentResult, type CreateLimitOrderParams, type CreateSonicSwapIntentParams, type CreateViemPublicClientParams, CustomSorobanServer, CustomStellarAccount, type DepositParams, type DepositSimulationParams, type DestinationParamsType, type DetailedLock, type DexError, type DexErrorCode, DexService, type DexServiceConstructorParams, type EModeCategory, type EModeCategoryHumanized, type EModeData, type EModeDataString, type EmodeDataHumanized, type EnrichedToken, type Erc20ApproveParams, type Erc20IsAllowanceParams, Erc20Service, type Erc20Token, Erc4626Service, type EstimateGasParams, EvmAssetManagerService, type EvmDepositToDataParams, EvmHubProvider, type EvmHubProviderConstructorParams, EvmSolverService, EvmSpokeService, EvmVaultTokenService, type EvmWithdrawAssetDataParams, type ExecuteMsg, type FeatureInvariant, type FeeData, type FeeTokenApproveAction, type FeeTokenApproveParams, type FetchHubAssetBalancesParams, type FormatReserveRequest, type FormatReserveResponse, type FormatReserveUSDRequest, type FormatReserveUSDResponse, type FormatReservesAndIncentivesUSDRequest, type FormatReservesUSDRequest, type FormatUserSummaryAndIncentivesRequest, type FormatUserSummaryAndIncentivesResponse, type FormatUserSummaryRequest, type FormatUserSummaryResponse, type FormattedReserveEMode, GAS_ESTIMATION_CODES, type GasEstimationErrorCode, type GetDepositParams, type GetIntentSubmitTxExtraDataParams, type GetPacketParams, type GetPacketResponse, type GetRelayRequestParamType, type GetRelayResponse, type GetSpokeServiceType, type GetTransactionPacketsParams, type GetTransactionPacketsResponse, type GetTxReceiptType, type GetUserRouterParams, HALF_RAY, HALF_WAD, type HanaWalletRequestEvent, type HanaWalletResponseEvent, HttpRelayError, type HubAssetBalance, type HubProvider, type IconJsonRpcVersion, IconSpokeService, type IcxCreateRevertMigrationParams, type IcxMigrateAction, type IcxMigrateParams, IcxMigrationService, type IcxMigrationServiceConstructorParams, type IcxRevertMigrationAction, type IcxRevertMigrationParams, type IncentiveDataHumanized, type InjTokenInfo, Injective20Token, type InjectiveBalance, InjectiveSpokeService, type InstantUnstakeAction, type InstantUnstakeParams, type InstantiateMsg, type Intent, type IntentAutoSwapResult, IntentCreatedEventAbi, type IntentCreatedEventLog, type IntentData, IntentDataType, type IntentDeliveryInfo, IntentFilledEventAbi, type IntentFilledEventLog, type IntentRelayRequest, type IntentRelayRequestParams, type IntentResponse, type IntentState, type IntentTxResult, IntentsAbi, type JsonRpcPayloadResponse, LOOKUP_CODES, LTV_PRECISION, LendingPoolService, type LendingPoolServiceConstructorParams, type LimitOrderActionParams, LockupMultiplier, LockupPeriod, type LookupErrorCode, type MapRelayFailureCtx, type MigrateOrchestrationError, type MigrateOrchestrationErrorCode, type MigrationAction, type MigrationAllowanceCheckError, type MigrationAllowanceCheckErrorCode, type MigrationApproveError, type MigrationApproveErrorCode, type MigrationCreateIntentError, type MigrationCreateIntentErrorCode, type MigrationDirection, type MigrationError, type MigrationErrorCode, type MigrationLookupError, type MigrationLookupErrorCode, type MigrationOp, type MigrationParams, type MigrationRevertParams, MigrationService, type MigrationServiceConstructorParams, type MigrationTokens, MintPositionEventAbi, type MintPositionEventLog, type MoneyMarketAction, type MoneyMarketAllowanceCheckError, type MoneyMarketAllowanceCheckErrorCode, type MoneyMarketAllowanceParams, type MoneyMarketApproveActionParams, type MoneyMarketApproveError, type MoneyMarketApproveErrorCode, type MoneyMarketAsset, type MoneyMarketAssetBorrowers, type MoneyMarketAssetSuppliers, type MoneyMarketBorrowActionParams, type MoneyMarketBorrowParams, type MoneyMarketBorrowers, type MoneyMarketCreateIntentError, type MoneyMarketCreateIntentErrorCode, MoneyMarketDataService, type MoneyMarketDataServiceConstructorParams, type MoneyMarketEncodeBorrowParams, type MoneyMarketEncodeRepayParams, type MoneyMarketEncodeRepayWithATokensParams, type MoneyMarketEncodeSupplyParams, type MoneyMarketEncodeWithdrawParams, type MoneyMarketError, type MoneyMarketErrorCode, type MoneyMarketGasEstimationError, type MoneyMarketGasEstimationErrorCode, type MoneyMarketOrchestrationError, type MoneyMarketOrchestrationErrorCode, type MoneyMarketParams, type MoneyMarketPosition, type MoneyMarketRepayActionParams, type MoneyMarketRepayParams, MoneyMarketService, type MoneyMarketServiceConstructorParams, type MoneyMarketSupplyActionParams, type MoneyMarketSupplyParams, type MoneyMarketWithdrawActionParams, type MoneyMarketWithdrawParams, NEAR_DEFAULT_GAS, NEAR_STORAGE_DEPOSIT, NearSpokeService, type OnDemandBtcPayload, type OnDemandRelayData, type OptionalRaw, type OptionalSkipSimulation, type OptionalTimeout, type OrderbookResponse, type PacketData, type PartnerAction, type PartnerError, type PartnerErrorCode, type PartnerFeeClaimAssetBalance, PartnerFeeClaimService, type PartnerFeeClaimServiceConstructorParams, type PartnerFeeClaimSwapAction, type PartnerFeeClaimSwapParams, PartnerService, type PartnerServiceConfig, type PartnerServiceConstructorParams, Permit2Service, type PermitBatch, type PermitDetails, type PermitSingle, type PoolBaseCurrencyHumanized, type PoolData, type PoolRewardConfig, type PoolSpokeAssets, type PostExecutionError, type PostExecutionErrorCode, ProtocolIntentsAbi, type QueryMsg, type QueryResponse, RAY, RAY_DECIMALS, RELAY_ERROR_CODES, RadfiApiError, type RadfiAuthResult, type RadfiBuildTxResponse, type RadfiErrorBody, type RadfiMaxSpentResponse, RadfiProvider, type RadfiTradingWallet, type RadfiUtxo, type RadfiUtxoListResponse, type RadfiWalletBalance, type RateLimitConfig, type RawDestinationParams, type RecoveryAction, type RecoveryError, type RecoveryErrorCode, RecoveryService, type RecoveryServiceConstructorParams, type RelayAction, type RelayAndWaitParams, type RelayCode, type RelayErrorCode, type RelayExtraData, type RelayRequestDetail, type RelayRequestSigning, type RelayTxStatus, type RelayWrappedErrorCode, type RequestConfig, type RequestOverrideConfig, type RequestTrustlineParams, type ReserveCalculationData, type ReserveData, type ReserveDataHumanized, type ReserveDataLegacy, type ReserveDataWithPrice, type ReserveEMode, type ReserveIncentiveDict, type ReservesDataHumanized, type ReservesIncentiveDataHumanized, type ResponseAddressType, type ResponseSigningType, type RevertMigrationOrchestrationError, type RevertMigrationOrchestrationErrorCode, type RewardInfoHumanized, SECONDS_PER_YEAR, SODAX_ERROR_CODES, SODAX_FEATURES, type SendMessageParams, type SetSwapPreferenceAction, type SetSwapPreferenceParams, Sodax, SodaxError, type SodaxErrorCode, type SodaxErrorContext, type SodaxErrorJSON, type SodaxFeature, type SodaxPhase, SolanaSpokeService, SolverApiService, SonicSpokeService, type SpokeApproveParams, type SpokeApproveParamsEvmSpoke, type SpokeApproveParamsHub, type SpokeApproveParamsStellar, type SpokeIsAllowanceValidParams, type SpokeIsAllowanceValidParamsEvmSpoke, type SpokeIsAllowanceValidParamsHub, type SpokeIsAllowanceValidParamsOther, type SpokeIsAllowanceValidParamsStellar, SpokeService, type SpokeServiceConstructorParams, type SpokeServiceType, StacksSpokeService, type StakeAction, type StakeOrchestrationError, type StakeOrchestrationErrorCode, type StakeParams, type StakingActionType, type StakingActionUnion, type StakingAllowanceCheckError, type StakingAllowanceCheckErrorCode, type StakingApproveError, type StakingApproveErrorCode, type StakingConfig, type StakingCreateIntentError, type StakingCreateIntentErrorCode, type StakingError, type StakingErrorCode, type StakingInfo, type StakingInfoFetchError, type StakingInfoFetchErrorCode, StakingLogic, type StakingOrchestrationError, type StakingOrchestrationErrorCode, type StakingParamsUnion, StakingService, type StakingServiceConstructorParams, type State, StellarSpokeService, type SubmitTxParams, type SubmitTxResponse, SuiSpokeService, SupportedMigrationTokens, type SwapAction, type SwapActionParams, type SwapCreateIntentError, type SwapCreateIntentErrorCode, type SwapError, type SwapErrorCode, type SwapResponse, SwapService, type SwapServiceConstructorParams, type TokenSpenderPair, type TokenWithConversion, type TxHashPair, type TxStatus, USD_DECIMALS, type UiPoolDataProviderInterface, UiPoolDataProviderService, type UiPoolDataProviderServiceConstructorParams, type UnifiedBnUSDMigrateAction, type UnifiedBnUSDMigrateParams, type UnstakeAction, type UnstakeParams, type UnstakeRequest, type UnstakeRequestWithPenalty, type UnstakingInfo, type UserIncentiveData, type UserIncentiveDataHumanized, type UserIncentiveDict, type UserIntentsResponse, type UserReserveCalculationData, type UserReserveData, type UserReserveDataHumanized, type UserReserveDataString, type UserReservesIncentivesDataHumanized, type UserRewardInfoHumanized, type VerifySimulationParams, type VerifyTxHashParams, WAD, WAD_RAY_RATIO, WEI_DECIMALS, type WaitForTxReceiptParams, type WaitForTxReceiptReturnType, type WaitUntilIntentExecutedPayload, type WalletMode, type WalletSimulationParams, type WithdrawHubAssetAction, type WithdrawHubAssetParams, type WithdrawInfo, adjustAmountByFee, allowanceCheckFailed, approveFailed, assetManagerAbi, balnSwapAbi, binomialApproximatedRayPow, bridgeInvariant, calcOpReturnOutputVbytes, calculateAllReserveIncentives, calculateAllUserIncentives, calculateAvailableBorrowsMarketReferenceCurrency, calculateCompoundedInterest, calculateCompoundedRate, calculateFeeAmount, calculateHealthFactorFromBalances, calculateHealthFactorFromBalancesBigUnits, calculateLinearInterest, calculatePercentageFeeAmount, clPoolAbi, clPoolManagerAbi, clPositionManagerAbi, clQuoterAbi, clRouterAbi, clTickLensAbi, connectionAbi, consoleLogger, convertTransactionInstructionToRaw, createInvariant, deepMerge, defaultHookAbi, dexInvariant, encodeAddress, encodeBtcPayloadToBytes, encodeContractCalls, erc20Abi, erc4626Abi, estimateBitcoinTxSize, executionFailed, formatBasisPoints, formatEModeCategory, formatEModes, formatPercentage, formatReserve, formatReserveUSD, formatReserves, formatReservesAndIncentives, formatUserSummary, formatUserSummaryAndIncentives, gasEstimationFailed, getAndFormatReserveEModes, getAssetManagerIdl, getAssetManagerProgram, getCompoundedBalance, getConnectionIdl, getConnectionProgram, getEvmViemChain, getIconAddressBytes, getLinearBalance, getMarketReferenceCurrencyAndUsdBalance, getPacket, getProvider, getRandomBytes, getReserveNormalizedIncome, getReservesEModes, getSolanaAddressBytes, getTransactionPackets, hexToBigInt, hexToSolanaAddress, hyper, intentCreationFailed, isBalnMigrateParams, isBitcoinChainKeyType, isBitcoinWalletProviderType, isBridgeAllowanceCheckError, isBridgeApproveError, isBridgeCreateIntentError, isBridgeError, isBridgeLookupError, isBridgeOrchestrationError, isCodeMember, isDexError, isEvmChainKeyType, isEvmSpokeChainConfig, isEvmSpokeOnlyChainKeyType, isEvmWalletProviderType, isFeatureError, isHubChainKeyType, isIconAddress, isIconChainKeyType, isIcxCreateRevertMigrationParams, isIcxMigrateParams, isInjectiveChainKeyType, isJsonRpcPayloadResponse, isMigrateOrchestrationError, isMigrationAllowanceCheckError, isMigrationApproveError, isMigrationCreateIntentError, isMigrationError, isMigrationLookupError, isMoneyMarketAllowanceCheckError, isMoneyMarketApproveError, isMoneyMarketCreateIntentError, isMoneyMarketError, isMoneyMarketGasEstimationError, isMoneyMarketOrchestrationError, isNearChainKeyType, isOptionalBitcoinWalletProviderType, isOptionalEvmWalletProviderType, isOptionalStellarWalletProviderType, isPartnerError, isPartnerFeeAmount, isPartnerFeePercentage, isPostExecutionError, isRawDestinationParams, isRecoveryError, isResponseAddressType, isResponseSigningType, isRevertMigrationOrchestrationError, isSodaxError, isSolanaChainKeyType, isSolanaNativeToken, isSonicChainKeyType, isSpokeApproveParamsEvmSpoke, isSpokeApproveParamsHub, isSpokeApproveParamsStellar, isSpokeIsAllowanceValidParamsEvmSpoke, isSpokeIsAllowanceValidParamsHub, isSpokeIsAllowanceValidParamsStellar, isStacksChainKeyType, isStakeOrchestrationError, isStakingAllowanceCheckError, isStakingApproveError, isStakingCreateIntentError, isStakingError, isStakingInfoFetchError, isStakingOrchestrationError, isStellarChainKeyType, isStellarWalletProviderType, isSubmitSwapTxResponse, isSubmitSwapTxStatusResponse, isSuiChainKeyType, isSwapCreateIntentError, isSwapError, isUndefinedOrValidWalletProviderForChainKey, isUnifiedBnUSDMigrateParams, lookupFailed, mapRelayFailure, mergeSodaxConfig, messageOf, migrationInvariant, mintPositionParamsAbi, mmInvariant, modifyLiquidityParamsAbi, nativeToUSD, normalize, normalizeBN, normalizePsbtToBase64, normalizeSignatureToBase64, normalizedToUsd, pancakeSwapInfinityDefaultHookAbi, pancakeSwapInfinityPoolManagerAbi, pancakeSwapInfinityPositionManagerAbi, parseToStroops, parseTokenArrayFromJson, partnerInvariant, permit2Abi, poolAbi, poolKeyAbi, randomUint256, rayDiv, rayMul, rayPow, rayToWad, recoveryInvariant, relayTxAndWaitPacket, requestAddress, requestJsonRpc, requestSigning, resolveLogger, retry, reverseEncodeAddress, serializeAddressData, silentLogger, sleep, sodaxInvariant, sonicWalletFactoryAbi, spokeAssetManagerAbi, stakedSodaAbi, stakingInvariant, stakingRouterAbi, stataTokenFactoryAbi, submitTransaction, swapExactInSingleParamsAbi, swapInvariant, uiPoolDataAbi, universalRouterAbi, unknownFailed, valueToBigNumber, valueToZDBigNumber, variableDebtTokenAbi, vaultTokenAbi, verifyFailed, wadToRay, waitForStacksTransaction, waitForTransactionReceipt, waitUntilIntentExecuted, walletFactoryAbi, wrappedSonicAbi };
+export { ALLOWANCE_CHECK_CODES, APPROVE_CODES, type AggregatedReserveData, type AllowanceCheckErrorCode, type AllowanceInfo, type AllowanceResponse, type AllowanceTransferDetails, type ApiResponse, type ApproveErrorCode, type ApyRange, type AssetDepositAction, type AssetEntry, AssetService, type AssetServiceConstructorParams, type AssetWithdrawAction, type AutoSwapPreferences, BackendApiService, type BalnLockParams, type BalnMigrateAction, type BalnMigrateParams, type BalnSwapAbi, BalnSwapService, type BalnSwapServiceConstructorParams, type BaseCurrencyInfo, BigIntToHex, type BigNumberValue, BigNumberZeroDecimal, BitcoinSpokeService, type BitcoinTransactionResult, type BitcoinUTXO, BnUSDMigrationService, type BnUSDMigrationServiceConstructorParams, type BnUSDRevertMigrationParams, type BorrowInfo, type BridgeAction, type BridgeAllowanceCheckError, type BridgeAllowanceCheckErrorCode, type BridgeApproveError, type BridgeApproveErrorCode, type BridgeCreateIntentError, type BridgeCreateIntentErrorCode, type BridgeError, type BridgeErrorCode, type BridgeLookupError, type BridgeLookupErrorCode, type BridgeOrchestrationError, type BridgeOrchestrationErrorCode, type BridgeParams, BridgeService, type BridgeServiceConstructorParams, type BtcPayload, CREATE_INTENT_CODES, type CalculateAllReserveIncentivesRequest, type CalculateAllUserIncentivesRequest, type CalculateCompoundedRateRequest, type CallResponse, type CancelIntentActionParams, type CancelIntentParams, type CancelUnstakeAction, type CancelUnstakeParams, type ClClaimRewardsParams, type ClDecreaseLiquidityParams, type ClGetPoolDataParams, type ClIncreaseLiquidityParams, type ClLiquidityClaimRewardsAction, type ClLiquidityDecreaseLiquidityAction, type ClLiquidityIncreaseLiquidityAction, type ClLiquidityWithdrawAction, type ClMintPositionEventLog, type ClPositionInfo, ClService, type ClServiceConstructorParams, type ClSupplyAction, type ClSupplyParams, type ClWithdrawParams, type ClaimAction, type ClaimParams, type CombinedReserveData, type ComputedUserReserve, type ConcentratedLiquidityParams, type ConcentratedLiquidityTokenInfo, ConfigService, type ConfigServiceConstructorParams, type ConnMsg, type CreateAssetDepositParams, type CreateAssetWithdrawParams, type CreateBridgeIntentParams, type CreateIntentErrorCode, type CreateIntentParams, type CreateIntentResult, type CreateLimitOrderParams, type CreateSonicSwapIntentParams, type CreateVaultIntentResult, type CreateViemPublicClientParams, CustomSorobanServer, CustomStellarAccount, type DepositParams, type DepositSimulationParams, type DestinationParamsType, type DetailedLock, type DexError, type DexErrorCode, DexService, type DexServiceConstructorParams, type EModeCategory, type EModeCategoryHumanized, type EModeData, type EModeDataString, type EmodeDataHumanized, type EnrichedToken, type Erc20ApproveParams, type Erc20IsAllowanceParams, Erc20Service, type Erc20Token, Erc4626Service, type EstimateGasParams, EvmAssetManagerService, type EvmDepositToDataParams, EvmHubProvider, type EvmHubProviderConstructorParams, EvmSolverService, EvmSpokeService, EvmVaultTokenService, type EvmWithdrawAssetDataParams, type ExecuteMsg, type FeatureInvariant, type FeeData, type FeeTokenApproveAction, type FeeTokenApproveParams, type FetchHubAssetBalancesParams, type FormatReserveRequest, type FormatReserveResponse, type FormatReserveUSDRequest, type FormatReserveUSDResponse, type FormatReservesAndIncentivesUSDRequest, type FormatReservesUSDRequest, type FormatUserSummaryAndIncentivesRequest, type FormatUserSummaryAndIncentivesResponse, type FormatUserSummaryRequest, type FormatUserSummaryResponse, type FormattedReserveEMode, GAS_ESTIMATION_CODES, type GasEstimationErrorCode, type GetDepositParams, type GetIntentSubmitTxExtraDataParams, type GetPacketParams, type GetPacketResponse, type GetQuoteParams, type GetRelayRequestParamType, type GetRelayResponse, type GetSpokeServiceType, type GetTransactionPacketsParams, type GetTransactionPacketsResponse, type GetTxReceiptType, type GetUserRouterParams, HALF_RAY, HALF_WAD, type HanaWalletRequestEvent, type HanaWalletResponseEvent, HttpRelayError, type HubAssetBalance, type HubProvider, type IconJsonRpcVersion, IconSpokeService, type IcxCreateRevertMigrationParams, type IcxMigrateAction, type IcxMigrateParams, IcxMigrationService, type IcxMigrationServiceConstructorParams, type IcxRevertMigrationAction, type IcxRevertMigrationParams, type IncentiveDataHumanized, type InjTokenInfo, Injective20Token, type InjectiveBalance, InjectiveSpokeService, type InstantUnstakeAction, type InstantUnstakeParams, type InstantiateMsg, type Intent, type IntentAutoSwapResult, IntentCreatedEventAbi, type IntentCreatedEventLog, type IntentData, IntentDataType, type IntentDeliveryInfo, IntentFilledEventAbi, type IntentFilledEventLog, type IntentRelayRequest, type IntentRelayRequestParams, type IntentResponse, type IntentState, type IntentTxResult, IntentsAbi, type JsonRpcPayloadResponse, LOOKUP_CODES, LTV_PRECISION, LendingPoolService, type LendingPoolServiceConstructorParams, type LeverageYieldAction, type LeverageYieldAllowanceCheckError, type LeverageYieldAllowanceCheckErrorCode, type LeverageYieldAllowanceParams, type LeverageYieldApproveError, type LeverageYieldApproveErrorCode, type LeverageYieldApproveParams, type LeverageYieldApr, type LeverageYieldCreateIntentError, type LeverageYieldCreateIntentErrorCode, type LeverageYieldEffectiveApr, type LeverageYieldError, type LeverageYieldErrorCode, type LeverageYieldLookupError, type LeverageYieldLookupErrorCode, type LeverageYieldLsdApr, type LeverageYieldPosition, type LeverageYieldPostExecutionError, type LeverageYieldPostExecutionErrorCode, LeverageYieldService, type LeverageYieldServiceConstructorParams, type LeverageYieldSwapDepositParams, type LeverageYieldSwapError, type LeverageYieldSwapErrorCode, type LeverageYieldSwapPayload, type LeverageYieldSwapWithdrawParams, type LimitOrderActionParams, LockupMultiplier, LockupPeriod, type LookupErrorCode, type MapRelayFailureCtx, type MigrateOrchestrationError, type MigrateOrchestrationErrorCode, type MigrationAction, type MigrationAllowanceCheckError, type MigrationAllowanceCheckErrorCode, type MigrationApproveError, type MigrationApproveErrorCode, type MigrationCreateIntentError, type MigrationCreateIntentErrorCode, type MigrationDirection, type MigrationError, type MigrationErrorCode, type MigrationLookupError, type MigrationLookupErrorCode, type MigrationOp, type MigrationParams, type MigrationRevertParams, MigrationService, type MigrationServiceConstructorParams, type MigrationTokens, MintPositionEventAbi, type MintPositionEventLog, type MoneyMarketAction, type MoneyMarketAllowanceCheckError, type MoneyMarketAllowanceCheckErrorCode, type MoneyMarketAllowanceParams, type MoneyMarketApproveActionParams, type MoneyMarketApproveError, type MoneyMarketApproveErrorCode, type MoneyMarketAsset, type MoneyMarketAssetBorrowers, type MoneyMarketAssetSuppliers, type MoneyMarketBorrowActionParams, type MoneyMarketBorrowParams, type MoneyMarketBorrowers, type MoneyMarketCreateIntentError, type MoneyMarketCreateIntentErrorCode, MoneyMarketDataService, type MoneyMarketDataServiceConstructorParams, type MoneyMarketEncodeBorrowParams, type MoneyMarketEncodeRepayParams, type MoneyMarketEncodeRepayWithATokensParams, type MoneyMarketEncodeSupplyParams, type MoneyMarketEncodeWithdrawParams, type MoneyMarketError, type MoneyMarketErrorCode, type MoneyMarketGasEstimationError, type MoneyMarketGasEstimationErrorCode, type MoneyMarketOrchestrationError, type MoneyMarketOrchestrationErrorCode, type MoneyMarketParams, type MoneyMarketPosition, type MoneyMarketRepayActionParams, type MoneyMarketRepayParams, MoneyMarketService, type MoneyMarketServiceConstructorParams, type MoneyMarketSupplyActionParams, type MoneyMarketSupplyParams, type MoneyMarketWithdrawActionParams, type MoneyMarketWithdrawParams, NEAR_DEFAULT_GAS, NEAR_STORAGE_DEPOSIT, NearSpokeService, type OnDemandBtcPayload, type OnDemandRelayData, type OptionalRaw, type OptionalSkipSimulation, type OptionalTimeout, type OrderbookResponse, type PacketData, type PartnerAction, type PartnerError, type PartnerErrorCode, type PartnerFeeClaimAssetBalance, PartnerFeeClaimService, type PartnerFeeClaimServiceConstructorParams, type PartnerFeeClaimSwapAction, type PartnerFeeClaimSwapParams, PartnerService, type PartnerServiceConfig, type PartnerServiceConstructorParams, Permit2Service, type PermitBatch, type PermitDetails, type PermitSingle, type PoolBaseCurrencyHumanized, type PoolData, type PoolRewardConfig, type PoolSpokeAssets, type PostExecutionError, type PostExecutionErrorCode, ProtocolIntentsAbi, type QueryMsg, type QueryResponse, RAY, RAY_DECIMALS, RELAY_ERROR_CODES, RadfiApiError, type RadfiAuthResult, type RadfiBuildTxResponse, type RadfiErrorBody, type RadfiMaxSpentResponse, RadfiProvider, type RadfiTradingWallet, type RadfiUtxo, type RadfiUtxoListResponse, type RadfiWalletBalance, type RateLimitConfig, type RawDestinationParams, type RecoveryAction, type RecoveryError, type RecoveryErrorCode, RecoveryService, type RecoveryServiceConstructorParams, type RelayAction, type RelayAndWaitParams, type RelayCode, type RelayErrorCode, type RelayExtraData, type RelayRequestDetail, type RelayRequestSigning, type RelayTxStatus, type RelayWrappedErrorCode, type RequestConfig, type RequestOverrideConfig, type RequestTrustlineParams, type ReserveCalculationData, type ReserveData, type ReserveDataHumanized, type ReserveDataLegacy, type ReserveDataWithPrice, type ReserveEMode, type ReserveIncentiveDict, type ReservesDataHumanized, type ReservesIncentiveDataHumanized, type ResponseAddressType, type ResponseSigningType, type RevertMigrationOrchestrationError, type RevertMigrationOrchestrationErrorCode, type RewardInfoHumanized, SECONDS_PER_YEAR, SODAX_ERROR_CODES, SODAX_FEATURES, type SendMessageParams, type SetSwapPreferenceAction, type SetSwapPreferenceParams, Sodax, SodaxError, type SodaxErrorCode, type SodaxErrorContext, type SodaxErrorJSON, type SodaxFeature, type SodaxPhase, SolanaSpokeService, SolverApiService, SonicSpokeService, type SpokeApproveParams, type SpokeApproveParamsEvmSpoke, type SpokeApproveParamsHub, type SpokeApproveParamsStellar, type SpokeIsAllowanceValidParams, type SpokeIsAllowanceValidParamsEvmSpoke, type SpokeIsAllowanceValidParamsHub, type SpokeIsAllowanceValidParamsOther, type SpokeIsAllowanceValidParamsStellar, SpokeService, type SpokeServiceConstructorParams, type SpokeServiceType, StacksSpokeService, type StakeAction, type StakeOrchestrationError, type StakeOrchestrationErrorCode, type StakeParams, type StakingActionType, type StakingActionUnion, type StakingAllowanceCheckError, type StakingAllowanceCheckErrorCode, type StakingApproveError, type StakingApproveErrorCode, type StakingConfig, type StakingCreateIntentError, type StakingCreateIntentErrorCode, type StakingError, type StakingErrorCode, type StakingInfo, type StakingInfoFetchError, type StakingInfoFetchErrorCode, StakingLogic, type StakingOrchestrationError, type StakingOrchestrationErrorCode, type StakingParamsUnion, StakingService, type StakingServiceConstructorParams, type State, StellarSpokeService, type SubmitTxParams, type SubmitTxResponse, SuiSpokeService, SupportedMigrationTokens, type SwapAction, type SwapActionParams, type SwapCreateIntentError, type SwapCreateIntentErrorCode, type SwapError, type SwapErrorCode, type SwapExtras, type SwapResponse, SwapService, type SwapServiceConstructorParams, type TokenSpenderPair, type TokenWithConversion, type TxHashPair, type TxStatus, USD_DECIMALS, type UiPoolDataProviderInterface, UiPoolDataProviderService, type UiPoolDataProviderServiceConstructorParams, type UnifiedBnUSDMigrateAction, type UnifiedBnUSDMigrateParams, type UnstakeAction, type UnstakeParams, type UnstakeRequest, type UnstakeRequestWithPenalty, type UnstakingInfo, type UserIncentiveData, type UserIncentiveDataHumanized, type UserIncentiveDict, type UserIntentsResponse, type UserReserveCalculationData, type UserReserveData, type UserReserveDataHumanized, type UserReserveDataString, type UserReservesIncentivesDataHumanized, type UserRewardInfoHumanized, type VaultSwapActionParams, type VaultSwapResponse, type VerifySimulationParams, type VerifyTxHashParams, WAD, WAD_RAY_RATIO, WEI_DECIMALS, type WaitForTxReceiptParams, type WaitForTxReceiptReturnType, type WaitUntilIntentExecutedPayload, type WalletMode, type WalletSimulationParams, type WithdrawHubAssetAction, type WithdrawHubAssetParams, type WithdrawInfo, adjustAmountByFee, allowanceCheckFailed, approveFailed, assetManagerAbi, balnSwapAbi, binomialApproximatedRayPow, bridgeInvariant, calcOpReturnOutputVbytes, calculateAllReserveIncentives, calculateAllUserIncentives, calculateAvailableBorrowsMarketReferenceCurrency, calculateCompoundedInterest, calculateCompoundedRate, calculateFeeAmount, calculateHealthFactorFromBalances, calculateHealthFactorFromBalancesBigUnits, calculateLinearInterest, calculatePercentageFeeAmount, clPoolAbi, clPoolManagerAbi, clPositionManagerAbi, clQuoterAbi, clRouterAbi, clTickLensAbi, connectionAbi, consoleLogger, convertTransactionInstructionToRaw, createInvariant, deepMerge, defaultHookAbi, dexInvariant, encodeAddress, encodeBtcPayloadToBytes, encodeContractCalls, erc20Abi, erc4626Abi, estimateBitcoinTxSize, executionFailed, formatBasisPoints, formatEModeCategory, formatEModes, formatPercentage, formatReserve, formatReserveUSD, formatReserves, formatReservesAndIncentives, formatUserSummary, formatUserSummaryAndIncentives, gasEstimationFailed, getAndFormatReserveEModes, getAssetManagerIdl, getAssetManagerProgram, getCompoundedBalance, getConnectionIdl, getConnectionProgram, getEvmViemChain, getIconAddressBytes, getLinearBalance, getMarketReferenceCurrencyAndUsdBalance, getPacket, getProvider, getRandomBytes, getReserveNormalizedIncome, getReservesEModes, getSolanaAddressBytes, getTransactionPackets, hexToBigInt, hexToSolanaAddress, hyper, intentCreationFailed, isBalnMigrateParams, isBitcoinChainKeyType, isBitcoinWalletProviderType, isBridgeAllowanceCheckError, isBridgeApproveError, isBridgeCreateIntentError, isBridgeError, isBridgeLookupError, isBridgeOrchestrationError, isCodeMember, isDexError, isEvmChainKeyType, isEvmSpokeChainConfig, isEvmSpokeOnlyChainKeyType, isEvmWalletProviderType, isFeatureError, isHubChainKeyType, isIconAddress, isIconChainKeyType, isIcxCreateRevertMigrationParams, isIcxMigrateParams, isInjectiveChainKeyType, isJsonRpcPayloadResponse, isLeverageYieldAllowanceCheckError, isLeverageYieldApproveError, isLeverageYieldCreateIntentError, isLeverageYieldError, isLeverageYieldLookupError, isLeverageYieldPostExecutionError, isLeverageYieldSwapError, isMigrateOrchestrationError, isMigrationAllowanceCheckError, isMigrationApproveError, isMigrationCreateIntentError, isMigrationError, isMigrationLookupError, isMoneyMarketAllowanceCheckError, isMoneyMarketApproveError, isMoneyMarketCreateIntentError, isMoneyMarketError, isMoneyMarketGasEstimationError, isMoneyMarketOrchestrationError, isNearChainKeyType, isOptionalBitcoinWalletProviderType, isOptionalEvmWalletProviderType, isOptionalStellarWalletProviderType, isPartnerError, isPartnerFeeAmount, isPartnerFeePercentage, isPostExecutionError, isRawDestinationParams, isRecoveryError, isResponseAddressType, isResponseSigningType, isRevertMigrationOrchestrationError, isSodaxError, isSolanaChainKeyType, isSolanaNativeToken, isSonicChainKeyType, isSpokeApproveParamsEvmSpoke, isSpokeApproveParamsHub, isSpokeApproveParamsStellar, isSpokeIsAllowanceValidParamsEvmSpoke, isSpokeIsAllowanceValidParamsHub, isSpokeIsAllowanceValidParamsStellar, isStacksChainKeyType, isStakeOrchestrationError, isStakingAllowanceCheckError, isStakingApproveError, isStakingCreateIntentError, isStakingError, isStakingInfoFetchError, isStakingOrchestrationError, isStellarChainKeyType, isStellarWalletProviderType, isSubmitSwapTxResponse, isSubmitSwapTxStatusResponse, isSuiChainKeyType, isSwapCreateIntentError, isSwapError, isUndefinedOrValidWalletProviderForChainKey, isUnifiedBnUSDMigrateParams, leverageYieldInvariant, lookupFailed, mapRelayFailure, mergeSodaxConfig, messageOf, migrationInvariant, mintPositionParamsAbi, mmInvariant, modifyLiquidityParamsAbi, nativeToUSD, normalize, normalizeBN, normalizePsbtToBase64, normalizeSignatureToBase64, normalizedToUsd, pancakeSwapInfinityDefaultHookAbi, pancakeSwapInfinityPoolManagerAbi, pancakeSwapInfinityPositionManagerAbi, parseToStroops, parseTokenArrayFromJson, partnerInvariant, permit2Abi, poolAbi, poolKeyAbi, randomUint256, rayDiv, rayMul, rayPow, rayToWad, recoveryInvariant, relayTxAndWaitPacket, requestAddress, requestJsonRpc, requestSigning, resolveLogger, retry, reverseEncodeAddress, serializeAddressData, silentLogger, sleep, sodaxInvariant, sonicWalletFactoryAbi, spokeAssetManagerAbi, stakedSodaAbi, stakingInvariant, stakingRouterAbi, stataTokenFactoryAbi, submitTransaction, swapExactInSingleParamsAbi, swapInvariant, uiPoolDataAbi, universalRouterAbi, unknownFailed, valueToBigNumber, valueToZDBigNumber, variableDebtTokenAbi, vaultTokenAbi, verifyFailed, wadToRay, waitForStacksTransaction, waitForTransactionReceipt, waitUntilIntentExecuted, walletFactoryAbi, wrappedSonicAbi };