@sodax/sdk 2.0.0-rc.2 → 2.0.0-rc.20

package/dist/index.d.cts

@@ -1,21 +1,23 @@
-import { IConfigApi, ApiConfig, Result, SubmitSwapTxRequest, SubmitSwapTxResponse, GetSubmitSwapTxStatusParams, SubmitSwapTxStatusResponse, Address, GetAllConfigApiResponse, GetChainsApiResponse, GetSwapTokensApiResponse, SpokeChainKey, GetSwapTokensByChainIdApiResponse, GetMoneyMarketTokensApiResponse, GetMoneyMarketReserveAssetsApiResponse, GetMoneyMarketTokensByChainIdApiResponse, GetRelayChainIdMapApiResponse, GetSpokeChainConfigApiResponse, SodaxConfig, XToken, OriginalAssetAddress, IntentRelayChainId, HubChainKey, HubConfig, PoolKey, SpokeChainConfig, RelayConfig, SolverConfig, SwapsConfig, BridgeConfig, MoneyMarketConfig, DexConfig, GetSpokeChainConfigType, EvmContractCall, Hex, IEvmWalletProvider, EvmRawTransactionReceipt, PartnerFee, 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, RadfiConfig, IBitcoinWalletProvider, RadfiDepositTxResponse, BtcAddressType, BitcoinChainKey, HttpUrl, NearChainKey, FillData, NearRawTransaction, SuiPaginatedCoins, SuiChainKey, SuiExecutionResult, SuiGasEstimate, IStellarWalletProvider, StellarGasEstimate, SolanaChainKey, SolanaGasEstimate, SolanaBase58PublicKey, SolanaRawTransactionInstruction, SolanaSerializedTransaction, SolanaRpcResponseAndContext, SolanaTokenAmount, IconChainKey, IconGasEstimate, IconAddress, InjectiveChainKey, InjectiveGasEstimate, JsonObject, InjectiveRawTransaction, IInjectiveWalletProvider, InjectiveExecuteResponse, GetEstimateGasReturnType, EvmSpokeChainConfig, PartnerFeeAmount, PartnerFeePercentage, IWalletProvider, GetWalletProviderType, SolverIntentQuoteRequest, SolverIntentQuoteResponse, SolverErrorResponse, SolverIntentStatusRequest, SolverIntentStatusResponse, SolverExecutionRequest, SolverExecutionResponse, SpokeExecActionParams, FeeAmount, Hash as Hash$1, IcxTokenType, IconEoaAddress, IconContractAddress, BridgeLimit, UserUnstakeInfo, ConcentratedLiquidityConfig } from '@sodax/types';
+import { SodaxFeature, ISwapsApiV2, Result, SwapsApiConfig, SodaxLogger, GetSwapTokensResponseV2, GetSwapTokensByChainResponseV2, QuoteRequestV2, QuoteQueryV2, QuoteResponseV2, DeadlineQueryV2, DeadlineResponseV2, CreateIntentParamsV2, AllowanceCheckResponseV2, ApproveResponseV2, CreateIntentResponseV2, SubmitIntentRequestV2, SubmitIntentResponseV2, StatusRequestV2, StatusResponseV2, CancelIntentRequestV2, CancelIntentResponseV2, IntentHashRequestV2, IntentHashResponseV2, IntentPacketRequestV2, IntentPacketResponseV2, IntentExtraDataRequestV2, IntentExtraDataResponseV2, IntentStateV2, GetIntentResponseV2, CreateLimitOrderParamsV2, CreateLimitOrderResponseV2, GasEstimateRequestV2, GasEstimateResponseV2, FeeQueryV2, FeeResponseV2, SubmitTxRequestV2, SubmitTxResponseV2, SubmitTxStatusQueryV2, SubmitTxStatusResponseV2, IConfigApiV1, ApiConfig, Address, GetAllConfigApiResponse, GetChainsApiResponse, GetSwapTokensApiResponse, SpokeChainKey, GetSwapTokensByChainIdApiResponse, GetMoneyMarketTokensApiResponse, GetMoneyMarketReserveAssetsApiResponse, GetMoneyMarketTokensByChainIdApiResponse, GetRelayChainIdMapApiResponse, GetSpokeChainConfigApiResponse, AnalyticsDetailLevel, AnalyticsEventPhase, AnalyticsOption, 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, HookKind, SonicChainKey, AssetInfo, TokenInfo, VaultReserves, StacksChainKey, FeeEstimateTransaction, StacksTransactionParams, HttpUrl, RadfiConfig, IBitcoinWalletProvider, RadfiDepositTxResponse, BtcAddressType, BitcoinChainKey, BitcoinRawTransaction, 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';
+export { SodaxFeature } from '@sodax/types';
 import * as viem from 'viem';
-import { Hex as Hex$1, Chain, Address as Address$1, PublicClient, HttpTransport, Hash, GetLogsReturnType } from 'viem';
-import { ClarityValue } from '@stacks/transactions';
-import { StacksNetwork } from '@stacks/network';
-import * as bitcoin from 'bitcoinjs-lib';
+import { Hex as Hex$1, Chain, Address as Address$1, PublicClient, Hash, HttpTransport, GetLogsReturnType } from 'viem';
+import { StacksNetwork, ClarityValue } from '@sodax/libs/stacks/core';
+import { networks, Psbt } from 'bitcoinjs-lib';
 import { JsonRpcProvider } from 'near-api-js';
 import { Transaction, TransactionResult } from '@mysten/sui/transactions';
 import { SuiClient } from '@mysten/sui/client';
-import { rpc, Transaction as Transaction$1, Memo, MemoType, Operation, FeeBumpTransaction, Horizon, Account, xdr, Address as Address$2 } from '@stellar/stellar-sdk';
-import { Connection as Connection$1, TransactionInstruction, PublicKey } from '@solana/web3.js';
+import { rpc, Transaction as Transaction$1, Memo, MemoType, Operation, FeeBumpTransaction, Horizon, Account, xdr } from '@stellar/stellar-sdk';
+import { Connection as Connection$1, PublicKey, TransactionInstruction } from '@solana/web3.js';
 import { IconService } from 'icon-sdk-js';
 import { ChainGrpcWasmApi, TxGrpcApi } from '@injectivelabs/sdk-ts';
 import { NetworkEndpoints } from '@injectivelabs/networks';
-import * as anchor from '@coral-xyz/anchor';
+import * as _coral_xyz_anchor from '@coral-xyz/anchor';
+import { AnchorProvider, Program } from '@coral-xyz/anchor';
 import { Price, Token } from '@pancakeswap/swap-sdk-core';
 import BigNumber$1 from 'bignumber.js';
+export { SwapsApiError, SwapsApiErrorCode, SwapsApiErrorContext } from '@sodax/swaps-api';
 
 /**
  * Unified error vocabulary for the SODAX SDK.
@@ -30,10 +32,14 @@ import BigNumber$1 from 'bignumber.js';
  * The closed-union type `SodaxErrorCode` is the default generic of `SodaxError<C>`, so any
  * throw with an unlisted string code is a compile error — additions go through this file.
  */
+
 /**
  * Reason-only error codes. Each code answers "what kind of failure was this?", not
  * "which feature?".
  *
+ * - `USER_REJECTED` — the connected wallet reported a user-initiated rejection of the
+ *   signing / connection / approval prompt. Cancellation is a normal flow, not a failure per
+ *   se — consumers branch on this code to render a "Cancelled" UI.
  * - `VALIDATION_FAILED` — a precondition / invariant tripped before any external call.
  * - `INTENT_CREATION_FAILED` — building the intent / calldata / payload failed (typically
  *   in a `create*Intent` method).
@@ -53,16 +59,12 @@ import BigNumber$1 from 'bignumber.js';
  *   because retry semantics differ — re-estimation is cheap, retry-on-failure is the norm).
  * - `LOOKUP_FAILED` — any other read-only on-chain query / off-chain config fetch.
  *   `context.method` partitions this code (`'getStakingInfo'`, `'getBridgeableAmount'`, …).
- * - `EXTERNAL_API_ERROR` — an upstream API call failed (e.g. solver, backend). `context.api`
+ * - `EXTERNAL_API_ERROR` — an upstream API call failed (e.g. solver, backend, swaps). `context.api`
  *   identifies which service.
  * - `UNKNOWN` — last-resort catch in an outer `try`. Should be extremely rare in production.
  */
-type SodaxErrorCode = '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';
-/**
- * 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 SodaxErrorCode = 'USER_REJECTED' | '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';
+
 /**
  * Orchestration phase tag attached via `context.phase`. Canonical superset across all
  * features — all features draw from this list rather than minting their own.
@@ -108,15 +110,15 @@ type SodaxErrorContext = {
     srcChainKey?: string;
     dstChainKey?: string;
     relayCode?: RelayCode;
-    api?: 'solver' | 'backend';
+    api?: 'solver' | 'backend' | 'swaps';
     method?: string;
     direction?: 'forward' | 'reverse';
     field?: string;
     reason?: string;
     [key: string]: unknown;
 };
-type CreateIntentErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'UNKNOWN'>;
-type ApproveErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'APPROVE_FAILED' | 'UNKNOWN'>;
+type CreateIntentErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'UNKNOWN'>;
+type ApproveErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'APPROVE_FAILED' | 'UNKNOWN'>;
 type AllowanceCheckErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'ALLOWANCE_CHECK_FAILED' | 'UNKNOWN'>;
 type GasEstimationErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'GAS_ESTIMATION_FAILED' | 'UNKNOWN'>;
 type LookupErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'LOOKUP_FAILED' | 'UNKNOWN'>;
@@ -131,9 +133,9 @@ declare const GAS_ESTIMATION_CODES: ReadonlySet<GasEstimationErrorCode>;
 /** Codes any read-only lookup method can return. */
 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"];
+declare const SODAX_ERROR_CODES: readonly ["USER_REJECTED", "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", "backend", "leverageYield"];
 
 /**
  * Canonical error type for the SODAX SDK.
@@ -310,12 +312,22 @@ type Ctx = Partial<SodaxErrorContext>;
 declare function lookupFailed(feature: SodaxFeature, method: string, cause: unknown, context?: Ctx): SodaxError<'LOOKUP_FAILED'>;
 /** `TX_VERIFICATION_FAILED` — spoke `verifyTxHash` returned false / threw. */
 declare function verifyFailed(feature: SodaxFeature, cause: unknown, context?: Ctx): SodaxError<'TX_VERIFICATION_FAILED'>;
-/** `INTENT_CREATION_FAILED` — spoke deposit / sendMessage / intent build failed. */
-declare function intentCreationFailed(feature: SodaxFeature, cause: unknown, context?: Ctx): SodaxError<'INTENT_CREATION_FAILED'>;
+/**
+ * `INTENT_CREATION_FAILED` — spoke deposit / sendMessage / intent build failed.
+ *
+ * Wraps the wallet-sign step. If the cause matches a wallet rejection shape, classifies as
+ * `USER_REJECTED` instead so consumers can branch on a single canonical "cancelled" code.
+ */
+declare function intentCreationFailed(feature: SodaxFeature, cause: unknown, context?: Ctx): SodaxError<'USER_REJECTED' | 'INTENT_CREATION_FAILED'>;
 /** `EXECUTION_FAILED` — orchestrator-level catch-all. `context.action` discriminates the op. */
 declare function executionFailed(feature: SodaxFeature, cause: unknown, context?: Ctx): SodaxError<'EXECUTION_FAILED'>;
-/** `APPROVE_FAILED` — token approval call failed. */
-declare function approveFailed(feature: SodaxFeature, cause: unknown, context?: Ctx): SodaxError<'APPROVE_FAILED'>;
+/**
+ * `APPROVE_FAILED` — token approval call failed.
+ *
+ * Wraps the wallet-sign step. If the cause matches a wallet rejection shape, classifies as
+ * `USER_REJECTED` instead.
+ */
+declare function approveFailed(feature: SodaxFeature, cause: unknown, context?: Ctx): SodaxError<'USER_REJECTED' | 'APPROVE_FAILED'>;
 /** `ALLOWANCE_CHECK_FAILED` — reading on-chain allowance failed. */
 declare function allowanceCheckFailed(feature: SodaxFeature, cause: unknown, context?: Ctx): SodaxError<'ALLOWANCE_CHECK_FAILED'>;
 /** `GAS_ESTIMATION_FAILED` — gas estimation call failed. */
@@ -4851,6 +4863,113 @@ declare const ProtocolIntentsAbi: readonly [{
         }];
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "cancelIntent";
+    readonly inputs: readonly [{
+        readonly name: "fromToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "toToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getUserIntent";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "fromToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "toToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "intentHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getIntentDetails";
+    readonly inputs: readonly [{
+        readonly name: "intentHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "intent";
+        readonly type: "tuple";
+        readonly internalType: "struct Intents.Intent";
+        readonly components: readonly [{
+            readonly name: "intentId";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "creator";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "inputToken";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "outputToken";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "inputAmount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "minOutputAmount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "allowPartialFill";
+            readonly type: "bool";
+            readonly internalType: "bool";
+        }, {
+            readonly name: "srcChain";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "dstChain";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "srcAddress";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "dstAddress";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "solver";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "data";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }];
+    }];
+    readonly stateMutability: "view";
 }];
 
 declare const sonicWalletFactoryAbi: readonly [{
@@ -7383,6 +7502,122 @@ type RequestOverrideConfig = {
     timeout?: number;
     headers?: Record<string, string>;
 };
+
+/**
+ * {@link ISwapsApiV2} with every method's return wrapped in `Result<T>` and an
+ * optional trailing `RequestOverrideConfig`. `SwapsApiService` implements this
+ * (rather than `ISwapsApiV2` directly) because it never throws — like
+ * `BackendApiService`, it returns `{ ok: false }` on failure instead of
+ * `Promise<T>` rejection. The mapped type keeps the class in lockstep with the
+ * canonical interface: every endpoint is covered with its exact payload types.
+ */
+type ResultifiedSwapsApiV2 = {
+    [K in keyof ISwapsApiV2]: ISwapsApiV2[K] extends (...args: infer A) => Promise<infer R> ? (...args: [...A, config?: RequestOverrideConfig]) => Promise<Result<R>> : never;
+};
+/**
+ * HTTP client for the backend **Swaps API v2** (`/swaps/*`).
+ *
+ * A thin adapter over the standalone `@sodax/swaps-api` package (the single source of the wire
+ * client — request building, per-chain `tx` validation/transform, response schemas, HTTP + retry).
+ * This service adds the SDK conventions on top: `Result<T>` (it never throws), a `SodaxLogger`,
+ * `SwapsApiConfig`/`ApiConfig` resolution, and per-call `RequestOverrideConfig`.
+ *
+ * All public methods return `Promise<Result<T>>`. On network failure, timeout, non-2xx HTTP
+ * response, or response-shape validation failure, the returned Result has `ok: false` with a
+ * canonical `SodaxError<'EXTERNAL_API_ERROR'>` (`feature: 'backend'`, `context.api: 'swaps'`,
+ * `context.endpoint`); the underlying `SwapsApiError` is preserved on `error.cause`.
+ *
+ * Per-call request overrides (base URL, timeout, headers) can be passed as the optional last
+ * argument to any method via `RequestOverrideConfig`.
+ *
+ * Reachable on the Sodax facade as `sodax.api.swaps`.
+ */
+declare class SwapsApiService implements ResultifiedSwapsApiV2 {
+    private readonly config;
+    private readonly headers;
+    private readonly logger;
+    constructor(config: SwapsApiConfig, logger?: SodaxLogger);
+    /**
+     * Build a `@sodax/swaps-api` client for a single call. Maps the SDK's `SwapsApiConfig`
+     * (`baseURL`/`timeout`/`headers`) to the package's config (`baseUrl`/`timeout`/`headers`), layering
+     * the optional per-call `RequestOverrideConfig` on top (override wins per field; headers merge).
+     * `timeout` falls back to the backend-API default so a config that omits it still gets a ceiling
+     * rather than an unbounded request. Constructed per call so `setHeaders` mutations and per-call
+     * overrides both take effect without caching stale state.
+     */
+    private buildClient;
+    /**
+     * Run one delegated `SwapsApi` call and wrap it in `Result<T>`. A thrown `SwapsApiError`
+     * (network/timeout/HTTP/parse/validation) becomes `{ ok: false }` with a canonical
+     * `SodaxError<'EXTERNAL_API_ERROR'>`; the original error is kept as `cause`, and its
+     * `code`/`status`/`issues` are projected into `context` so consumers can discriminate failure
+     * kinds without unwrapping `cause`. Only a RESPONSE-shape validation failure is tagged
+     * `reason: 'invalid_response_shape'` — a request-side validation error is a caller bug, not a
+     * backend fault.
+     */
+    private toResult;
+    /**
+     * Drop the SDK-only display field `feeAmount` before an intent reaches the strict wire serializer.
+     * `sodax.swaps.createIntent` returns `Intent & FeeAmount`, which is structurally assignable to the
+     * wire `IntentRequestV2` and so gets passed straight into the intent-carrying endpoints; the extra
+     * bigint would trip `serializeIntentRequest`. This is a no-op for an already-clean `IntentRequestV2`.
+     */
+    private static toWireIntent;
+    /** Fetch all supported swap tokens grouped by SpokeChainKey. */
+    getTokens(config?: RequestOverrideConfig): Promise<Result<GetSwapTokensResponseV2>>;
+    /** Fetch supported swap tokens for a single SpokeChainKey. */
+    getTokensByChain(chainKey: string, config?: RequestOverrideConfig): Promise<Result<GetSwapTokensByChainResponseV2>>;
+    /**
+     * Get a solver quote for a cross-chain swap. Pass `query.includeTxData = true` to also build an
+     * unsigned create-intent transaction (`txData`); in that case `srcAddress`/`dstAddress` are required.
+     */
+    getQuote(body: QuoteRequestV2, query?: QuoteQueryV2, config?: RequestOverrideConfig): Promise<Result<QuoteResponseV2>>;
+    /** Compute a swap deadline (hub timestamp + `offsetSeconds`, default 300s). */
+    getDeadline(query?: DeadlineQueryV2, config?: RequestOverrideConfig): Promise<Result<DeadlineResponseV2>>;
+    /** Check whether the source token allowance is already sufficient for the intent. */
+    checkAllowance(body: CreateIntentParamsV2, config?: RequestOverrideConfig): Promise<Result<AllowanceCheckResponseV2>>;
+    /** Build an unsigned token-approval transaction for the source token. */
+    approve(body: CreateIntentParamsV2, config?: RequestOverrideConfig): Promise<Result<ApproveResponseV2>>;
+    /** Build an unsigned create-intent transaction. */
+    createIntent(body: CreateIntentParamsV2, config?: RequestOverrideConfig): Promise<Result<CreateIntentResponseV2>>;
+    /** Submit the broadcast intent tx to the relay. */
+    submitIntent(body: SubmitIntentRequestV2, config?: RequestOverrideConfig): Promise<Result<SubmitIntentResponseV2>>;
+    /** Poll the solver for intent execution status. */
+    getStatus(body: StatusRequestV2, config?: RequestOverrideConfig): Promise<Result<StatusResponseV2>>;
+    /** Build an unsigned cancel-intent transaction (the `intent` bigint numerics serialize to strings). */
+    cancelIntent(body: CancelIntentRequestV2, config?: RequestOverrideConfig): Promise<Result<CancelIntentResponseV2>>;
+    /** Compute the keccak256 hash of an Intent struct (bigint numerics serialize to strings). */
+    getIntentHash(body: IntentHashRequestV2, config?: RequestOverrideConfig): Promise<Result<IntentHashResponseV2>>;
+    /** Long-poll the relayer until the fill packet lands on the destination chain. */
+    getSolvedIntentPacket(body: IntentPacketRequestV2, config?: RequestOverrideConfig): Promise<Result<IntentPacketResponseV2>>;
+    /** Recover the relay extra data needed by `/swaps/intents/submit` (provide EITHER `txHash` OR `intent`). */
+    getIntentSubmitTxExtraData(body: IntentExtraDataRequestV2, config?: RequestOverrideConfig): Promise<Result<IntentExtraDataResponseV2>>;
+    /** Get the on-chain fill state for an intent by its hub-chain tx hash. */
+    getFilledIntent(txHash: string, config?: RequestOverrideConfig): Promise<Result<IntentStateV2>>;
+    /** Look up an Intent struct by its hub-chain creation tx hash. */
+    getIntent(txHash: string, config?: RequestOverrideConfig): Promise<Result<GetIntentResponseV2>>;
+    /** Build an unsigned create-limit-order-intent transaction (create-intent with optional `deadline`). */
+    createLimitOrderIntent(body: CreateLimitOrderParamsV2, config?: RequestOverrideConfig): Promise<Result<CreateLimitOrderResponseV2>>;
+    /** Estimate gas for a raw transaction on a spoke chain (bigint `tx` numerics serialize to strings). */
+    estimateGas(body: GasEstimateRequestV2, config?: RequestOverrideConfig): Promise<Result<GasEstimateResponseV2>>;
+    /** Compute the partner fee for a given input amount. */
+    getPartnerFee(query: FeeQueryV2, config?: RequestOverrideConfig): Promise<Result<FeeResponseV2>>;
+    /** Compute the protocol (solver) fee for a given input amount. */
+    getSolverFee(query: FeeQueryV2, config?: RequestOverrideConfig): Promise<Result<FeeResponseV2>>;
+    /** Submit a swap transaction to be processed (relay, post-execution, etc.). Idempotent on `(txHash, srcChainKey)`. */
+    submitTx(body: SubmitTxRequestV2, config?: RequestOverrideConfig): Promise<Result<SubmitTxResponseV2>>;
+    /** Get the processing status of a submitted swap transaction by `(txHash, srcChainKey)`. */
+    getSubmitTxStatus(query: SubmitTxStatusQueryV2, config?: RequestOverrideConfig): Promise<Result<SubmitTxStatusResponseV2>>;
+    /**
+     * Merge additional headers into the service's default header set. Existing
+     * keys are overwritten; keys absent from `headers` are preserved. Applied to
+     * every subsequent call (the delegated client is rebuilt per call).
+     */
+    setHeaders(headers: Record<string, string>): void;
+    /** Return the base URL the service is currently pointing at. */
+    getBaseURL(): string;
+}
+
 /** Full details of a single swap intent as stored and returned by the backend. */
 interface IntentResponse {
     intentHash: string;
@@ -7394,16 +7629,16 @@ interface IntentResponse {
     intent: {
         intentId: string;
         creator: string;
-        inputToken: `0x${string}`;
-        outputToken: `0x${string}`;
+        inputToken: string;
+        outputToken: string;
         inputAmount: string;
         minOutputAmount: string;
         deadline: string;
         allowPartialFill: boolean;
         srcChain: number;
         dstChain: number;
-        srcAddress: `0x${string}`;
-        dstAddress: `0x${string}`;
+        srcAddress: string;
+        dstAddress: string;
         solver: string;
         data: string;
     };
@@ -7516,36 +7751,54 @@ interface MoneyMarketBorrowers {
  * - **Money market** — query per-user positions, per-reserve asset stats,
  *   and paginated borrower/supplier lists.
  *
- * All public methods return `Promise<Result<T>>` — they never throw. On
- * network failure, timeout, or a non-2xx HTTP response the returned Result
- * has `ok: false` with a descriptive `Error` in the `error` field.
+ * All public methods return `Promise<Result<T>>` — they never throw. On network
+ * failure, timeout, non-2xx HTTP response, or unexpected response shape the
+ * returned Result has `ok: false` with a canonical `SodaxError<'EXTERNAL_API_ERROR'>`
+ * (`feature: 'backend'`, `context.api: 'backend'`) in the `error` field; the
+ * underlying failure is preserved on `error.cause`.
  *
  * Per-call request overrides (base URL, timeout, headers) can be passed as
  * the optional last argument to any method via `RequestOverrideConfig`.
  */
-declare class BackendApiService implements IConfigApi {
+declare class BackendApiService implements IConfigApiV1 {
+    readonly swaps: SwapsApiService;
     private readonly config;
     private readonly headers;
-    constructor(config: ApiConfig);
-    /**
-     * Execute a single HTTP request and return the parsed JSON body.
-     *
-     * Applies an `AbortController`-backed timeout (falls back to `this.config.timeout`
-     * when `config.timeout` is absent). Throws on non-2xx status codes or when the
-     * request exceeds the timeout, so callers should use {@link request} instead of
-     * calling this directly.
-     *
-     * @throws `Error('HTTP_REQUEST_FAILED')` on non-2xx responses.
-     * @throws `Error('REQUEST_TIMEOUT')` when the request exceeds the timeout.
-     * @throws `Error('UNKNOWN_REQUEST_ERROR')` for any other unexpected failure.
-     */
-    private makeRequest;
+    private readonly logger;
+    constructor(config: ApiConfig, logger?: SodaxLogger);
     /**
      * Wraps {@link makeRequest} in a `Result<T>` so all errors are captured rather
      * than propagated as thrown exceptions. Every public endpoint method delegates
      * here instead of calling `makeRequest` directly.
      */
+    /**
+     * Fold any per-call override (carried on `config` alongside `method`/`body`) over the service
+     * defaults: baseURL truthy-fallback (an empty-string override defers to the default), timeout
+     * nullish-fallback, headers merged (override wins per key). Mirrors the original makeRequest merge.
+     */
+    private resolveRequestConfig;
+    /**
+     * Wrap a thrown transport failure (HTTP_REQUEST_FAILED / REQUEST_TIMEOUT / network error) as the
+     * canonical backend `SodaxError` — identical shape to SwapsApiService; the underlying failure is
+     * preserved on `error.cause`.
+     */
+    private toExternalApiError;
+    /**
+     * Issue a request and validate the JSON body against `schema`, wrapping the result in `Result<T>`.
+     * Mirrors {@link SwapsApiService}: a 2xx body that fails the schema is surfaced as
+     * `EXTERNAL_API_ERROR` (`context.reason: 'invalid_response_shape'`) rather than returned untyped.
+     * Every data/token/money-market method delegates here; the config/relay reads use
+     * {@link requestUnvalidated} instead.
+     */
     private request;
+    /**
+     * Issue a request WITHOUT response-shape validation (passthrough typing). Reserved for the
+     * config/relay reads whose shapes are too large/brittle to schema-validate (`SodaxConfig` via
+     * `getAllConfig`, `SpokeChainConfigMap` via `getSpokeChainConfig`) or carry `bigint` values that
+     * cannot survive JSON validation (`getRelayChainIdMap`). `ConfigService` version-gates and falls
+     * back to packaged defaults, so it relies on no response-shape guarantee from these endpoints.
+     */
+    private requestUnvalidated;
     /**
      * Fetch a swap intent by the hub-chain transaction hash that created it.
      *
@@ -7564,34 +7817,6 @@ declare class BackendApiService implements IConfigApi {
      * @returns `Result<IntentResponse>` — on success, the full intent details.
      */
     getIntentByHash(intentHash: string, config?: RequestOverrideConfig): Promise<Result<IntentResponse>>;
-    /**
-     * Submit a signed spoke-chain swap transaction to the backend for processing.
-     *
-     * The backend relays the transaction to the hub chain, posts execution data
-     * to the solver, and advances the intent through its lifecycle. The response
-     * shape is validated at runtime via a type guard; an invalid shape is
-     * returned as `{ ok: false }`.
-     *
-     * @param params - The signed transaction hash, source chain key, sender wallet
-     *   address, intent data, and relay data required to process the swap.
-     * @returns `Result<SubmitSwapTxResponse>` — on success, a confirmation object
-     *   with `success: true` and a human-readable `message`.
-     */
-    submitSwapTx(params: SubmitSwapTxRequest, config?: RequestOverrideConfig): Promise<Result<SubmitSwapTxResponse>>;
-    /**
-     * Poll the backend relay pipeline for the current status of a previously
-     * submitted swap transaction.
-     *
-     * Status progresses through: `pending` → `verifying` → `verified` →
-     * `relaying` → `relayed` → `posting_execution` → `executed` (or `failed`).
-     *
-     * @param params - Object containing the source-chain transaction hash and,
-     *   optionally, the source chain key to disambiguate cross-chain hashes.
-     * @returns `Result<SubmitSwapTxStatusResponse>` — on success, includes the
-     *   current `status`, any `failureReason`, and (once executed) the
-     *   `dstIntentTxHash` on the hub chain.
-     */
-    getSubmitSwapTxStatus(params: GetSubmitSwapTxStatusParams, config?: RequestOverrideConfig): Promise<Result<SubmitSwapTxStatusResponse>>;
     /**
      * Fetch a paginated snapshot of the solver orderbook — open swap intents
      * that are currently waiting to be filled by the solver.
@@ -7797,6 +8022,10 @@ declare class BackendApiService implements IConfigApi {
      * without constructing a new service instance. Existing header keys are
      * overwritten; keys absent from `headers` are preserved.
      *
+     * The headers are also fanned out to the sub-services (`swaps`), which hold
+     * their own header copies — so a token set here applies to every request made
+     * through this client, including `swaps.*`.
+     *
      * @param headers - Key-value pairs to add or overwrite in the default headers.
      */
     setHeaders(headers: Record<string, string>): void;
@@ -7808,16 +8037,107 @@ declare class BackendApiService implements IConfigApi {
     getBaseURL(): string;
 }
 
+/**
+ * Optional per-phase payload builders for {@link ResolvedAnalytics.trackResult}. Each is a lazy thunk
+ * invoked only if its event actually emits, so payloads are never built when analytics is off.
+ * `success` receives the resolved value, `failure` the `Result` error.
+ */
+interface AnalyticsActionData<T, E> {
+    start?: () => Record<string, unknown>;
+    success?: (value: T) => Record<string, unknown>;
+    failure?: (error: E) => Record<string, unknown>;
+}
+/**
+ * The SDK-internal analytics emitter, resolved once from the consumer's {@link AnalyticsOption} and
+ * held on `ConfigService` (`config.analytics`).
+ *
+ * Services never touch the raw config — they call {@link ResolvedAnalytics.emit}, which is the only
+ * gate. When analytics is disabled, off for a feature/action, or above the configured detail level,
+ * the `build` thunk is never invoked, so event payloads are never constructed on hot feature paths.
+ * This is what keeps feature code free of analytics overhead unless a consumer explicitly opts in.
+ */
+interface ResolvedAnalytics {
+    /**
+     * Whether an event for `feature`/`action` at `level` would be emitted. Call sites rarely need this
+     * directly — {@link emit} checks it internally — but it is exposed for the rare case where even
+     * deciding what to emit is itself costly. Omit `action` to ask whether the feature is tracked at all.
+     */
+    isEnabled(feature: SodaxFeature, action?: string, level?: AnalyticsDetailLevel): boolean;
+    /**
+     * Emit one user-action event. `build` produces the optional structured payload and is invoked
+     * lazily — only when the event passes the enabled/feature/action/level gate — so disabled analytics
+     * costs nothing but a boolean check at the call site. A faulty consumer tracker can never break a
+     * feature flow: delivery is wrapped and fire-and-forget.
+     */
+    emit(feature: SodaxFeature, action: string, phase: AnalyticsEventPhase, build?: () => Record<string, unknown>, level?: AnalyticsDetailLevel): void;
+    /**
+     * Wrap a `Result`-returning action flow: emit `start` before `run`, then `success` or `failure`
+     * from the resolved `Result` (and `failure` + rethrow if `run` throws), returning the `Result`
+     * unchanged. This is the canonical way to instrument a feature method — one call at the boundary
+     * covers every internal return point, so action code stays free of scattered emit calls.
+     */
+    trackResult<T, E>(feature: SodaxFeature, action: string, run: () => Promise<Result<T, E>>, data?: AnalyticsActionData<T, E>): Promise<Result<T, E>>;
+}
+/** Disabled emitter: every gate is closed, `build` is never called, nothing is delivered. */
+declare const noopAnalytics: ResolvedAnalytics;
+/**
+ * Resolve an {@link AnalyticsOption} (a config object, `false`, or `undefined`) into a concrete
+ * {@link ResolvedAnalytics}.
+ *
+ * Defaults to {@link noopAnalytics} so analytics is **off** unless a consumer opts in with an
+ * `AnalyticsConfig`. This mirrors `resolveLogger` but with the opposite default — logging is on by
+ * default, analytics is off — per issue #175 ("no needless invocations unless explicitly enabled").
+ */
+declare function resolveAnalytics(option: AnalyticsOption | undefined): ResolvedAnalytics;
+
 type ConfigServiceConstructorParams = {
     api: BackendApiService;
     config: SodaxConfig;
+    /**
+     * 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?: 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;
+    /**
+     * Pre-resolved analytics emitter. Like {@link logger}, held outside the swappable `SodaxConfig` so a
+     * dynamic config fetch never replaces it. Defaults to the no-op (disabled) emitter when omitted.
+     */
+    analytics?: ResolvedAnalytics;
+    /**
+     * 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
  */
 declare class ConfigService {
     private sodax;
-    private readonly api;
+    /**
+     * SDK log sink. Resolved once at construction and kept independent of {@link sodax} so that
+     * {@link initialize}'s dynamic-config swap never clobbers it. Read by services via `config.logger`.
+     */
+    readonly logger: SodaxLogger;
+    /**
+     * Analytics emitter. Resolved once at construction and kept independent of {@link sodax} so that
+     * {@link initialize}'s dynamic-config swap never clobbers it. Read by services via `config.analytics`;
+     * disabled (no-op) unless the consumer passed an `analytics` config to `new Sodax(...)`.
+     */
+    readonly analytics: ResolvedAnalytics;
+    /**
+     * 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;
@@ -7828,7 +8148,7 @@ declare class ConfigService {
     private stakedATokenAddressesSet;
     private chainToSupportedTokenAddressMap;
     private hubAssetToXTokenMap;
-    constructor({ api, config }: ConfigServiceConstructorParams);
+    constructor({ api, config, userConfig, logger, analytics, fee }: ConfigServiceConstructorParams);
     initialize(): Promise<Result<void>>;
     getChains(): GetChainsApiResponse;
     getSwapTokens(): GetSwapTokensApiResponse;
@@ -7839,6 +8159,14 @@ declare class ConfigService {
     getMoneyMarketReserveAssets(): GetMoneyMarketReserveAssetsApiResponse;
     isValidOriginalAssetAddress(chainId: SpokeChainKey, asset: OriginalAssetAddress): boolean;
     getOriginalAssetAddress(chainId: SpokeChainKey, hubAsset: Address): OriginalAssetAddress | undefined;
+    /**
+     * Resolves the {@link XToken} descriptor (hub asset, vault, decimals) for a hub-asset address.
+     *
+     * Useful when a caller holds a hub asset directly on Sonic that has no spoke-token entry under
+     * the hub chain — e.g. a partner BTC fee held as the BTC hub asset, which only exists as a spoke
+     * token on Bitcoin. Returns `undefined` when the address is not a known hub asset.
+     */
+    getXTokenFromHubAsset(hubAsset: string): XToken | undefined;
     getSpokeTokenFromOriginalAssetAddress(chainId: SpokeChainKey, originalAssetAddress: OriginalAssetAddress): XToken | undefined;
     isValidHubAsset(hubAsset: Address): boolean;
     /**
@@ -7881,6 +8209,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;
@@ -7893,6 +8226,27 @@ declare class ConfigService {
  */
 declare function parseTokenArrayFromJson(input: unknown): readonly XToken[];
 
+/**
+ * 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}).
+ *
+ * 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: SodaxDefaultConfig, override: SodaxOptions): SodaxConfig;
+
 /**
  * ABI-encode an array of ContractCall objects.
  * @param calls An array of ContractCall objects.
@@ -8059,6 +8413,8 @@ type OptionalSkipSimulation$1 = {
 };
 type DepositParams<C extends SpokeChainKey, Raw extends boolean = boolean> = {
     srcAddress: GetAddressType<C>;
+    srcPublicKey?: string;
+    accessToken?: string;
     srcChainKey: C;
     to: HubAddress;
     token: GetTokenAddressType<C>;
@@ -8172,6 +8528,17 @@ type RawDestinationParams = {
     dstAddress: string;
 };
 
+/**
+ * High-level request for routing an intent's output through a deployed delivery hook. Pick a hook by
+ * its {@link HookKind}; the SDK resolves the hook's deployed address and encodes the payload it expects
+ * (so address and codec can never drift). The recipient is taken from the intent's `dstAddress`.
+ *
+ * Prefer this over setting {@link CreateIntentParams.deliveryData} + `dstAddress` by hand — those remain
+ * available as a low-level escape hatch for hooks not yet in the registry.
+ */
+type HookRequest = {
+    kind: typeof HookKind.HYPERCORE_DEPOSIT;
+};
 type CreateIntentParams<K extends SpokeChainKey = SpokeChainKey> = {
     inputToken: string;
     outputToken: string;
@@ -8185,6 +8552,21 @@ type CreateIntentParams<K extends SpokeChainKey = SpokeChainKey> = {
     dstAddress: string;
     solver?: Address;
     data: Hex;
+    /**
+     * High-level delivery-hook selector. When set, the SDK routes the output through the chosen hook:
+     * it overrides `dstAddress` with the hook's deployed address and encodes `deliveryData` from this
+     * request (the recipient is the `dstAddress` you supply). This is the preferred way to use hooks —
+     * the hook address and its payload codec come from the registry, so they can never drift.
+     */
+    hook?: HookRequest;
+    /**
+     * Low-level delivery payload forwarded with the output transfer — an escape hatch for hooks not in
+     * the registry. On arrival at the destination spoke, `SpokeAssetManager` calls
+     * `ISpokeReceiver(dstAddress).hook(token, amount, deliveryData)`. Opaque bytes whose schema is
+     * defined by the destination receiver; when set, you must also point `dstAddress` at that receiver.
+     * Prefer {@link hook} when the target is a registered hook. Ignored when {@link hook} is set.
+     */
+    deliveryData?: Hex;
 };
 /**
  * Parameters for creating a limit order intent.
@@ -8193,6 +8575,29 @@ 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;
+};
+/** Bound Exchange (Radfi) inputs for raw Bitcoin TRADING-mode swap intents. */
+type BitcoinBoundExtras = {
+    /** Bound token, for raw Bitcoin TRADING callers; falls back to the RadfiProvider instance token when omitted. */
+    accessToken?: string;
+};
+type BitcoinBoundSlot<K extends SpokeChainKey> = GetChainType<K> extends 'BITCOIN' ? {
+    bound?: BitcoinBoundExtras;
+} : {
+    bound?: 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> & BitcoinBoundSlot<K>;
 type Intent = {
     intentId: bigint;
     creator: Address;
@@ -8210,7 +8615,10 @@ type Intent = {
     data: Hex;
 };
 declare enum IntentDataType {
-    FEE = 1
+    ARRAY = 0,
+    FEE = 1,
+    HOOK = 2,
+    DELIVERY = 3
 }
 type FeeData = {
     fee: bigint;
@@ -8227,22 +8635,6 @@ type IntentState = {
     pendingPayment: boolean;
 };
 
-type SonicSpokeDepositParams<Raw extends boolean> = {
-    srcAddress: Address$1;
-    srcChainKey: SonicChainKey;
-    to: HubAddress;
-    token: Address$1;
-    amount: bigint;
-    data: Hex;
-} & WalletProviderSlot<SonicChainKey, Raw>;
-type SonicDepositParams = {
-    srcAddress: Address$1;
-    srcChainKey: SonicChainKey;
-    to: HubAddress;
-    token: Address$1;
-    amount: bigint;
-    data: Hex;
-};
 type WithdrawInfo = {
     aTokenAddress: Address$1;
     aTokenAmount: bigint;
@@ -8267,15 +8659,9 @@ type CreateSonicSwapIntentParams<Raw extends boolean> = {
         chainConfig: HubConfig;
     };
 } & WalletProviderSlot<SonicChainKey, Raw>;
-type ApproveSonicWithdrawParams<Raw extends boolean> = {
-    srcAddress: Address$1;
-    srcChainKey: SonicChainKey;
-    from: Address$1;
-    withdrawInfo: WithdrawInfo;
-} & WalletProviderSlot<SonicChainKey, Raw>;
 declare class SonicSpokeService {
     private readonly config;
-    readonly publicClient: PublicClient<HttpTransport>;
+    readonly publicClient: PublicClient;
     private readonly pollingIntervalMs;
     private readonly maxTimeoutMs;
     constructor(config: ConfigService);
@@ -8316,7 +8702,7 @@ declare class SonicSpokeService {
     getUserRouter(params: GetUserRouterParams): Promise<HubAddress>;
     /**
      * Deposit tokens to the spoke chain using the Sonic wallet abstraction.
-     * @param {SonicSpokeDepositParams<Raw>} params - The parameters for the deposit
+     * @param {DepositParams<SonicChainKey, Raw>} params - The parameters for the deposit
      * @returns {Promise<TxReturnType<SonicChainKey, Raw>>} A promise that resolves to the transaction hash
      */
     deposit<Raw extends boolean>(params: DepositParams<SonicChainKey, Raw>): Promise<TxReturnType<SonicChainKey, Raw>>;
@@ -8340,11 +8726,11 @@ type EvmHubProviderConstructorParams = {
     config: ConfigService;
 };
 declare class EvmHubProvider {
-    readonly publicClient: PublicClient<HttpTransport>;
+    readonly publicClient: PublicClient;
     readonly chainConfig: HubConfig;
     readonly config: ConfigService;
     readonly service: SonicSpokeService;
-    readonly hubAddressMap: Map<`${string}:0xa86a.avax` | `${string}:0xa4b1.arbitrum` | `${string}:0x2105.base` | `${string}:0x38.bsc` | `${string}:injective-1` | `${string}:sonic` | `${string}:0x1.icon` | `${string}:sui` | `${string}:0xa.optimism` | `${string}:0x89.polygon` | `${string}:solana` | `${string}:stellar` | `${string}:hyper` | `${string}:lightlink` | `${string}:near` | `${string}:ethereum` | `${string}:bitcoin` | `${string}:redbelly` | `${string}:0x2019.kaia` | `${string}:stacks`, `0x${string}`>;
+    readonly hubAddressMap: Map<`${string}:0xa86a.avax` | `${string}:0xa4b1.arbitrum` | `${string}:0x2105.base` | `${string}:0x38.bsc` | `${string}:injective-1` | `${string}:sonic` | `${string}:0x1.icon` | `${string}:sui` | `${string}:0xa.optimism` | `${string}:0x89.polygon` | `${string}:solana` | `${string}:stellar` | `${string}:hyper` | `${string}:lightlink` | `${string}:near` | `${string}:ethereum` | `${string}:bitcoin` | `${string}:redbelly` | `${string}:0x2019.kaia` | `${string}:stacks` | `${string}:hedera`, `0x${string}`>;
     constructor({ config }: EvmHubProviderConstructorParams);
     /**
      * Gets the cached user's hub wallet address for a spoke chain address.
@@ -8434,10 +8820,10 @@ declare class EvmVaultTokenService {
      * Fetches token information for a specific token in the vault.
      * @param vault - The address of the vault.
      * @param token - The address of the token.
-     * @param publicClient - PublicClient<HttpTransport>
+     * @param publicClient - PublicClient
      * @returns Token information as a TokenInfo object.
      */
-    static getTokenInfo(vault: Address$1, token: Address$1, publicClient: PublicClient<HttpTransport>): Promise<TokenInfo>;
+    static getTokenInfo(vault: Address$1, token: Address$1, publicClient: PublicClient): Promise<TokenInfo>;
     /**
      * Fetches token information for a list of tokens in a vault using a multicall.
      * @param vault - The address of the vault contract.
@@ -8445,21 +8831,21 @@ declare class EvmVaultTokenService {
      * @param publicClient - The Viem PublicClient instance used to interact with the blockchain.
      * @returns A promise that resolves to an array of TokenInfo objects, one for each provided token.
      */
-    static getTokenInfos(vault: Address$1, tokens: Address$1[], publicClient: PublicClient<HttpTransport>): Promise<TokenInfo[]>;
+    static getTokenInfos(vault: Address$1, tokens: Address$1[], publicClient: PublicClient): Promise<TokenInfo[]>;
     /**
      * Retrieves the reserves of the vault.
      * @param vault - The address of the vault.
-     * @param publicClient - PublicClient<HttpTransport>
+     * @param publicClient - PublicClient
      * @returns An object containing tokens and their balances.
      */
-    static getVaultReserves(vault: Address$1, publicClient: PublicClient<HttpTransport>): Promise<VaultReserves>;
+    static getVaultReserves(vault: Address$1, publicClient: PublicClient): Promise<VaultReserves>;
     /**
      * Retrieves all token information for the vault.
      * @param vault - The address of the vault.
-     * @param publicClient - PublicClient<HttpTransport>
+     * @param publicClient - PublicClient
      * @returns A promise that resolves to an object containing tokens, their infos, and reserves.
      */
-    static getAllTokenInfo(vault: Address$1, publicClient: PublicClient<HttpTransport>): Promise<{
+    static getAllTokenInfo(vault: Address$1, publicClient: PublicClient): Promise<{
         tokens: readonly Address$1[];
         infos: readonly TokenInfo[];
         reserves: readonly bigint[];
@@ -8621,41 +9007,148 @@ declare class StacksSpokeService {
     waitForTransactionReceipt(params: WaitForTxReceiptParams<StacksChainKey>): Promise<Result<WaitForTxReceiptReturnType<StacksChainKey>>>;
 }
 
-/**
- * Raw error body shape returned by the Radfi HTTP API on non-2xx responses.
- * The human-readable detail typically lives at `error.details` (nested), with
- * `code` carrying a Radfi-specific identifier (e.g. "2002" insufficientBTCBalance,
- * "4008" duplicatedPubKey) and `message` an i18n key.
- */
-type RadfiErrorBody = {
-    code?: string;
-    message?: string;
-    details?: string;
-    error?: {
-        details?: string;
-        message?: string;
-    };
+type RelayExtraData = {
+    address: Hex;
+    payload: Hex;
 };
 /**
- * Structured error from a Radfi HTTP request. Exposes `status` (HTTP), `code`
- * (Radfi-specific identifier), and `details` (human-readable) so callers can
- * discriminate without fragile string-matching on `message`. The raw response
- * body is preserved on `cause` for structured logging.
+ * Signed Bitcoin on-demand payload (money-market borrow/withdraw) carried in the relay submit
+ * `data` as a JSON object — not a stringified JSON. There is no broadcast tx for these.
+ * `public_key` is the signer's public key, required by the relay to verify a BIP-322 signature
+ * (BIP-322 is not public-key-recoverable, unlike BIP-137).
  */
-declare class RadfiApiError extends Error {
-    readonly status: number;
-    readonly code?: string;
-    readonly details?: string;
-    readonly cause?: unknown;
-    constructor(status: number, body: RadfiErrorBody, fallback: string);
-}
-type RadfiTradingWallet = {
-    tradingAddress: string;
-    userAddress: string;
-    userPublicKey: string;
+type OnDemandRelayData = {
+    payload_hex: string;
+    signature?: string;
+    public_key?: string;
 };
-type RadfiAuthResult = {
-    accessToken: string;
+type IntentDeliveryInfo = {
+    srcChainKey: SpokeChainKey;
+    srcTxHash: string;
+    srcAddress: string;
+    dstChainKey: SpokeChainKey;
+    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> = {
+    action: T;
+    params: T extends 'submit' ? {
+        chain_id: string;
+        tx_hash: string;
+        data?: RelayExtraData | OnDemandRelayData;
+    } : T extends 'get_transaction_packets' ? {
+        chain_id: string;
+        tx_hash: string;
+    } : T extends 'get_packet' ? {
+        chain_id: string;
+        tx_hash: string;
+        conn_sn: string;
+    } : never;
+};
+
+/**
+ * Types derived from Core SDK specific types
+ * NOTE: common (non Core SDK specific) types should be put in @sodax/types package
+ */
+type HubProvider = EvmHubProvider;
+type RateLimitConfig = {
+    maxAvailable: number;
+    ratePerSecond: number;
+    available: number;
+};
+/**
+ * Structural types
+ */
+type OptionalRaw<R extends boolean> = {
+    raw?: R;
+};
+type OptionalSkipSimulation = {
+    skipSimulation?: boolean;
+};
+type OptionalTimeout = {
+    timeout?: number;
+};
+type TxHashPair = {
+    srcChainTxHash: string;
+    dstChainTxHash: string;
+};
+type IntentTxResult<K extends SpokeChainKey, Raw extends boolean> = {
+    tx: TxReturnType<K, Raw>;
+    relayData: RelayExtraData;
+};
+
+type DestinationParamsType = RawDestinationParams;
+
+/**
+ * Raw error body shape returned by the Bound Exchange HTTP API on non-2xx responses.
+ * The human-readable detail typically lives at `error.details` (nested), with
+ * `code` carrying a Bound Exchange-specific identifier (e.g. "2002" insufficientBTCBalance,
+ * "4008" duplicatedPubKey) and `message` an i18n key.
+ */
+type RadfiErrorBody = {
+    code?: string;
+    message?: string;
+    details?: string;
+    error?: {
+        details?: string;
+        message?: string;
+    };
+};
+/**
+ * Shape of a parsed Bound Exchange JSON response: the {@link RadfiErrorBody} envelope fields plus an
+ * optional, per-call typed `data` payload. Modeled as a superset of `RadfiErrorBody` so a parsed body
+ * can be handed straight to {@link RadfiApiError} on the error path. `data` is optional because Bound
+ * can answer 2xx with a logical-error envelope (no `data`); callers guard before dereferencing it.
+ */
+type RadfiResponseEnvelope<T = unknown> = RadfiErrorBody & {
+    data?: T;
+};
+/**
+ * Structured error from a Bound Exchange HTTP request. Exposes `status` (HTTP), `code`
+ * (Bound Exchange-specific identifier), and `details` (human-readable) so callers can
+ * discriminate without fragile string-matching on `message`. The raw response
+ * body is preserved on `cause` for structured logging.
+ */
+declare class RadfiApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: string;
+    readonly cause?: unknown;
+    constructor(status: number, body: RadfiErrorBody, fallback: string);
+}
+type RadfiTradingWallet = {
+    tradingAddress: string;
+    userAddress: string;
+    userPublicKey: string;
+};
+type RadfiAuthResult = {
+    accessToken: string;
     refreshToken: string;
     tradingAddress: string;
 };
@@ -8713,7 +9206,7 @@ declare class RadfiProvider {
     refreshToken: string;
     constructor(config: RadfiConfig);
     /**
-     * Authenticate with Radfi: BIP322-sign a login message, then call the Radfi API.
+     * Authenticate with Bound Exchange: BIP322-sign a login message, then call the Bound Exchange API.
      * Returns accessToken, refreshToken, and tradingAddress.
      */
     authenticateWithWallet(walletProvider: IBitcoinWalletProvider, cachedPublicKey?: string): Promise<{
@@ -8723,8 +9216,8 @@ declare class RadfiProvider {
         publicKey: string;
     }>;
     /**
-     * Ensure a valid Radfi access token is set on this provider.
-     * If a token exists, validates it via the Radfi API.
+     * Ensure a valid Bound Exchange access token is set on this provider.
+     * If a token exists, validates it via the Bound Exchange API.
      * If invalid, tries refreshing with the refresh token first.
      * If refresh also fails, falls back to full re-authentication (BIP322 sign).
      */
@@ -8744,7 +9237,7 @@ declare class RadfiProvider {
         walletAddress: string;
         publicKey: string;
     }, accessToken: string): Promise<RadfiTradingWallet>;
-    getTradingWallet(userAddress: string, accessToken?: string): Promise<RadfiTradingWallet>;
+    getTradingWallet(userAddress: string): Promise<RadfiTradingWallet>;
     getBalance(address: string): Promise<RadfiWalletBalance>;
     checkIfTradingWalletExists(userAddress: string): Promise<boolean>;
     createWithdrawTransaction(params: {
@@ -8754,9 +9247,18 @@ declare class RadfiProvider {
         userAddress: string;
         data: string;
     }, accessToken: string): Promise<RadfiDepositTxResponse>;
+    /**
+     * Co-sign and broadcast a `sodax-withdraw` deposit via the Bound Exchange API.
+     *
+     * `relayData` ({ address, payload }) is the same `RelayExtraData` the SDK returns from
+     * `createIntent()` / money-market supply etc. It is optional and non-breaking: when supplied,
+     * the Bound Exchange backend persists it so it can auto-resubmit the intent relay if the relay
+     * gets stuck (otherwise a stuck relay eventually refunds instead of completing the swap).
+     */
     requestRadfiSignature(params: {
         userAddress: string;
         signedBase64Tx: string;
+        relayData?: RelayExtraData;
     }, accessToken: string): Promise<string>;
     /**
      * Fetch expired (or near-expiry) UTXOs for a trading wallet address from UMS API.
@@ -8766,7 +9268,7 @@ declare class RadfiProvider {
         pageSize?: number;
     }): Promise<RadfiUtxoListResponse>;
     /**
-     * Build a renew-utxo transaction via the Radfi API.
+     * Build a renew-utxo transaction via the Bound Exchange API.
      * Returns a PSBT that needs to be signed by the user.
      */
     buildRenewUtxoTransaction(params: {
@@ -8774,8 +9276,8 @@ declare class RadfiProvider {
         txIdVouts: string[];
     }, accessToken: string): Promise<RadfiBuildTxResponse>;
     /**
-     * Sign and broadcast a renew-utxo transaction via the Radfi API.
-     * The user signs the PSBT first, then Radfi co-signs and broadcasts.
+     * Sign and broadcast a renew-utxo transaction via the Bound Exchange API.
+     * The user signs the PSBT first, then Bound Exchange co-signs and broadcasts.
      */
     signAndBroadcastRenewUtxo(params: {
         userAddress: string;
@@ -8792,7 +9294,7 @@ declare class RadfiProvider {
         withdrawTo: string;
     }, accessToken: string): Promise<RadfiBuildTxResponse>;
     /**
-     * Sign and broadcast a withdraw transaction via Radfi.
+     * Sign and broadcast a withdraw transaction via Bound Exchange.
      */
     signAndBroadcastWithdraw(params: {
         userAddress: string;
@@ -8807,6 +9309,27 @@ declare class RadfiProvider {
         tokenId: string;
         withdrawTo: string;
     }, accessToken: string): Promise<RadfiMaxSpentResponse>;
+    /**
+     * Resolve the bearer credential for an authenticated Bound Exchange call, failing fast when none
+     * is available. A server-side raw-build caller that never ran the interactive sign-in would
+     * otherwise send `Authorization: Bearer ` (empty) and get an opaque 403 from Bound's gateway;
+     * throwing here turns that into an actionable client-side error naming the fix. We deliberately do
+     * NOT validate the token's contents (expiry / scope / signature) — only Bound can, and an invalid
+     * token still surfaces as a legible 401/403 via `parseJsonBody`.
+     */
+    private resolveAuth;
+    /**
+     * Parse a Bound Exchange response body as JSON defensively.
+     *
+     * Bound (or an upstream gateway / WAF / CDN) can answer a request with an HTML error page
+     * instead of JSON — e.g. an unauthenticated call, a blocked origin, a 404, or a 5xx. Calling
+     * `res.json()` on that throws a cryptic `SyntaxError: Unexpected token '<'` that masks the real
+     * HTTP status and bubbles up as an opaque failure (it surfaced as a `createIntent` /
+     * `INTENT_CREATION_FAILED` "is not valid JSON" error on the Bitcoin raw-tx path). Reading the
+     * body as text first and parsing it ourselves lets us raise a `RadfiApiError` carrying the
+     * actual status code and a body snippet instead.
+     */
+    private parseJsonBody;
     private request;
 }
 
@@ -8820,38 +9343,34 @@ interface BtcPayload {
     timestamp: number;
     address_type: BtcAddressType;
 }
+/**
+ * Calculate the actual vbytes of an OP_RETURN output given the payload byte length.
+ * Accounts for variable-length pushdata opcodes and script-length varints.
+ */
+declare function calcOpReturnOutputVbytes(payloadByteLength: number): number;
 /**
  * Estimate transaction size in vbytes.
  * @param addressType — caller's address type for accurate per-input weight.
  *   P2PKH ≈ 148 vB, P2SH-P2WPKH ≈ 91 vB, P2WPKH ≈ 68 vB, P2TR ≈ 58 vB.
  *   Defaults to P2WPKH (68 vB) when omitted.
+ * @param opReturnOutputVbytes — actual OP_RETURN output size in vbytes.
+ *   Use calcOpReturnOutputVbytes() when the payload size is known. Defaults to 44 vB (~33-byte payload).
  */
-declare function estimateBitcoinTxSize(inputCount: number, outputCount: number, addressType?: BtcAddressType): number;
+declare function estimateBitcoinTxSize(inputCount: number, outputCount: number, addressType?: BtcAddressType, opReturnOutputVbytes?: number): number;
 declare function encodeBtcPayloadToBytes(payload: BtcPayload): string;
 /**
  * Normalize a signed PSBT to base64 format.
  * Unisat/OKX wallets return hex, Xverse returns base64.
- * Radfi API expects base64.
+ * Bound Exchange API expects base64.
  */
 declare function normalizePsbtToBase64(signedPsbt: string): string;
+/**
+ * Normalize a wallet message signature to base64. The intent relay requires the on-demand
+ * withdrawal signature as base64. Browser wallets (UniSat/Xverse/OKX) already return base64; a hex
+ * signature (e.g. a private-key wallet) is encoded. Mirrors `normalizePsbtToBase64`.
+ */
+declare function normalizeSignatureToBase64(signature: string): string;
 
-type BitcoinSpokeDepositParams = {
-    srcChainKey: BitcoinChainKey;
-    srcAddress: GetAddressType<BitcoinChainKey>;
-    to: HubAddress;
-    token: string;
-    amount: bigint;
-    data: Hex;
-    accessToken?: string;
-};
-type BitcoinTransferToHubParams = {
-    srcChainKey: BitcoinChainKey;
-    srcAddress: GetAddressType<BitcoinChainKey>;
-    token: string;
-    amount: bigint;
-    data?: Hex;
-    accessToken?: string;
-};
 type BitcoinUTXO = {
     txid: string;
     vout: number;
@@ -8872,6 +9391,7 @@ interface BitcoinTransactionResult {
 interface OnDemandBtcPayload {
     payload_hex: string;
     signature?: string;
+    public_key?: string;
 }
 declare class BitcoinSpokeService {
     private readonly config;
@@ -8881,7 +9401,7 @@ declare class BitcoinSpokeService {
     private readonly pollingIntervalMs;
     private readonly maxTimeoutMs;
     constructor(config: ConfigService);
-    getBtcNetwork(chainId: BitcoinChainKey): bitcoin.networks.Network;
+    getBtcNetwork(chainId: BitcoinChainKey): networks.Network;
     getBalance(tokenAddress: string, walletAddress: string): Promise<bigint>;
     fetchScriptPubKey(utxo: BitcoinUTXO): Promise<string>;
     /**
@@ -8917,7 +9437,7 @@ declare class BitcoinSpokeService {
      */
     getDeposit(params: GetDepositParams<BitcoinChainKey>): Promise<bigint>;
     /**
-     * Fund the Radfi trading wallet by sending BTC from the user's personal wallet
+     * Fund the Bound Exchange trading wallet by sending BTC from the user's personal wallet
      *
      * @param {bigint} amount - Amount in satoshis to send
      * @param {BitcoinSpokeProvider} spokeProvider - The Bitcoin spoke provider (must have signing capability)
@@ -8938,27 +9458,68 @@ declare class BitcoinSpokeService {
     sendMessage<Raw extends boolean>(params: SendMessageParams<BitcoinChainKey, Raw> & {
         walletMode?: WalletMode;
     }): Promise<TxReturnType<BitcoinChainKey, Raw>>;
+    /**
+     * Build the relay submit/poll identity for an on-demand action (borrow/withdraw).
+     *
+     * Bitcoin borrow/withdraw are on-demand: there is no broadcast transaction — the spoke result is
+     * the signed payload JSON produced by {@link encodeWithdrawalData}/{@link sendMessage}. The relay
+     * accepts the submit under the literal `withdraw` tx_hash with the signed payload (as a JSON object)
+     * in `data`, then tracks the resulting packet under a derived id: `od:` + keccak256 of the ASCII
+     * `payload_hex` string (hash the hex characters, not the decoded bytes). Polling must use that
+     * derived id (`pollTxHash`), not `withdraw`.
+     *
+     * @param tx - The JSON-stringified signed payload returned by `sendMessage` / `encodeWithdrawalData`.
+     */
+    getOnDemandRelayIdentity(tx: string): {
+        srcTxHash: string;
+        data: OnDemandRelayData;
+        pollTxHash: string;
+    };
     /**
      * Build a priority Bitcoin transaction with proper fee calculation
      */
     buildBitcoinTransaction(utxos: BitcoinUTXO[], outputs: Array<{
         address: string;
         value: number;
-    }>, changeAddress: string, chainId: BitcoinChainKey, walletProvider: IBitcoinWalletProvider, feeRate?: number): Promise<bitcoin.Psbt>;
+    }>, changeAddress: string, chainId: BitcoinChainKey, walletProvider: IBitcoinWalletProvider, feeRate?: number, opReturnOutputVbytes?: number): Promise<Psbt>;
     /**
      * Deposit operation - transfer BTC to the asset manager
      */
-    deposit<Raw extends boolean = false>(params: DepositParams<BitcoinChainKey, Raw> & {
+    deposit<Raw extends boolean = false>(params: DepositParams<BitcoinChainKey, Raw>): Promise<TxReturnType<BitcoinChainKey, Raw>>;
+    /**
+     * Sign and submit a TRADING-wallet raw transaction — the Bound-built *unsigned* PSBT returned by
+     * `deposit({ raw: true })` / the Swaps API (`createIntent().tx.data`). Signs it with the wallet
+     * provider's key, then sends it to Bound Exchange to co-sign with the second 2-of-2 key and
+     * broadcast. Returns the broadcast tx id.
+     *
+     * This is the client-side completion of the TRADING deposit flow: the backend builds the PSBT
+     * (it can't broadcast — the user's signature is missing), the client signs here, and Bound
+     * co-signs + broadcasts. `relayData` ({ address, payload }) is the relay identity returned by
+     * `createIntent()`; forwarding it lets Bound auto-resubmit a stuck relay. It is **not** recoverable
+     * from `rawTx` (whose `to` is the asset manager, not the hub wallet), so callers must supply it.
+     *
+     * @throws if the chain is not in `TRADING` wallet mode (raw txs only exist in TRADING mode).
+     */
+    signAndSubmitRawTransaction(params: {
+        rawTx: BitcoinRawTransaction;
+        walletProvider: IBitcoinWalletProvider;
+        relayData?: RelayExtraData;
         accessToken?: string;
-    }): Promise<TxReturnType<BitcoinChainKey, Raw>>;
+    }): Promise<string>;
     /**
      * Build deposit PSBT with embedded cross-chain data
      */
-    buildDepositPsbt(walletAddress: string, walletProvider: IBitcoinWalletProvider, srcChainKey: BitcoinChainKey, token: string, amount: bigint, data: string, utxos: BitcoinUTXO[]): Promise<bitcoin.Psbt>;
+    buildDepositPsbt(walletAddress: string, walletProvider: IBitcoinWalletProvider, srcChainKey: BitcoinChainKey, token: string, amount: bigint, data: string, utxos: BitcoinUTXO[]): Promise<Psbt>;
     /**
      * Fetch UTXOs for an address
      */
     fetchUTXOs(address: string): Promise<BitcoinUTXO[]>;
+    /**
+     * Returns the set of "txid:vout" outpoints currently being spent by
+     * unconfirmed transactions in the mempool for the given address.
+     * Used to prevent double-spend when building a new PSBT.
+     */
+    private fetchMempoolSpentOutpoints;
     /**
      * Fetch raw transaction hex
      */
@@ -8969,7 +9530,7 @@ declare class BitcoinSpokeService {
     /**
      * Sign and broadcast a Bitcoin transaction
      */
-    signAndBroadcastTransaction(psbt: bitcoin.Psbt | string, walletProvider: IBitcoinWalletProvider): Promise<string>;
+    signAndBroadcastTransaction(psbt: Psbt | string, walletProvider: IBitcoinWalletProvider): Promise<string>;
     /**
      * Broadcast a signed transaction
      */
@@ -8977,77 +9538,11 @@ declare class BitcoinSpokeService {
     waitForTransactionReceipt(params: WaitForTxReceiptParams<BitcoinChainKey>): Promise<Result<WaitForTxReceiptReturnType<BitcoinChainKey>>>;
 }
 
-type RelayExtraData = {
-    address: Hex;
-    payload: Hex;
-};
-type IntentDeliveryInfo = {
-    srcChainKey: SpokeChainKey;
-    srcTxHash: string;
-    srcAddress: string;
-    dstChainKey: SpokeChainKey;
-    dstTxHash: string;
-    dstAddress: string;
-};
-type WaitUntilIntentExecutedPayload = {
-    intentRelayChainId: string;
-    srcTxHash: string;
-    timeout?: number;
-    apiUrl: HttpUrl;
-};
-type RelayAction = 'submit' | 'get_transaction_packets' | 'get_packet';
-type IntentRelayRequest<T extends RelayAction> = {
-    action: T;
-    params: T extends 'submit' ? {
-        chain_id: string;
-        tx_hash: string;
-        data?: RelayExtraData;
-    } : T extends 'get_transaction_packets' ? {
-        chain_id: string;
-        tx_hash: string;
-    } : T extends 'get_packet' ? {
-        chain_id: string;
-        tx_hash: string;
-        conn_sn: string;
-    } : never;
-};
-
-/**
- * Types derived from Core SDK specific types
- * NOTE: common (non Core SDK specific) types should be put in @sodax/types package
- */
-type HubProvider = EvmHubProvider;
-type RateLimitConfig = {
-    maxAvailable: number;
-    ratePerSecond: number;
-    available: number;
-};
-/**
- * Structural types
- */
-type OptionalRaw<R extends boolean> = {
-    raw?: R;
-};
-type OptionalSkipSimulation = {
-    skipSimulation?: boolean;
-};
-type OptionalTimeout = {
-    timeout?: number;
-};
-type TxHashPair = {
-    srcChainTxHash: string;
-    dstChainTxHash: string;
-};
-type IntentTxResult<K extends SpokeChainKey, Raw extends boolean> = {
-    tx: TxReturnType<K, Raw>;
-    relayData: RelayExtraData;
-};
-
-type DestinationParamsType = RawDestinationParams;
-
 type QueryResponse = string | number | boolean | object | undefined;
 type CallResponse = string | number | object | bigint | boolean;
 declare const NEAR_DEFAULT_GAS: bigint;
+/** NEP-141 default storage bond for a one-time `storage_deposit` registration (0.00125 NEAR). */
+declare const NEAR_STORAGE_DEPOSIT: bigint;
 declare class NearSpokeService {
     private readonly config;
     readonly rpcProvider: JsonRpcProvider;
@@ -9078,6 +9573,34 @@ declare class NearSpokeService {
      * @returns {Promise<bigint>} The balance of the token.
      */
     getDeposit(params: GetDepositParams<NearChainKey>): Promise<bigint>;
+    /**
+     * Whether `accountId` is storage-registered on a NEP-141 `token` contract. NEP-141 requires an
+     * account to pay a one-time storage bond before it can receive (hold a balance of) the token, so
+     * this gates any leg that delivers a token to a user on NEAR (swap output on NEAR, bridge into
+     * NEAR, money-market borrow/withdraw to NEAR).
+     *
+     * Native NEAR is not a NEP-141 token and has no storage registration, so this returns `true` for
+     * the native token. The view goes through {@link queryContract}, i.e. the configurable RPC from
+     * chain config — a custom `rpcUrl` passed to the SDK is honoured.
+     */
+    isStorageRegistered(token: string, accountId: string): Promise<boolean>;
+    /**
+     * Build (and, unless `raw`, submit) a NEP-141 `storage_deposit` registration for `accountId` on
+     * the `token` contract. Call this when {@link isStorageRegistered} is `false` before a token is
+     * delivered to the account on NEAR.
+     *
+     * Native NEAR has no storage registration — passing the native token throws.
+     *
+     * @param params.deposit Storage bond to attach; defaults to {@link NEAR_STORAGE_DEPOSIT}
+     *   (0.00125 NEAR). Override per token if its `storage_balance_bounds.min` differs.
+     */
+    registerStorage<Raw extends boolean = false>(params: {
+        token: string;
+        accountId: string;
+        walletProvider: INearWalletProvider;
+        deposit?: bigint;
+        raw?: Raw;
+    }): Promise<TxReturnType<NearChainKey, Raw>>;
     /**
      * Sends a message to the hub chain.
      * @param {SendMessageParams} params - Includes dstChainKey, the chain key of the hub chain.
@@ -9128,7 +9651,6 @@ declare class SuiSpokeService {
         stateId: string;
     };
     getNativeCoin(tx: Transaction, amount: bigint): Promise<SuiNativeCoinResult>;
-    static getAddressBCSBytes(suiaddress: string): Hex;
     encodeSimulationParams(token: string, assetManager: string): {
         encodedToken: Hex;
         encodedSrcAddress: Hex;
@@ -9151,20 +9673,19 @@ declare class SuiSpokeService {
     estimateGas({ tx }: EstimateGasParams<SuiChainKey>): Promise<SuiGasEstimate>;
     /**
      * Get the balance of the token in the spoke chain.
-     * @param {Address} token - The address of the token to get the balance of.
-     * @param {SuiSpokeProvider} spokeProvider - The spoke provider.
+     * @param {GetDepositParams<SuiChainKey>} params - The src chain key, src address, and token address.
      * @returns {Promise<bigint>} The balance of the token.
      */
     getDeposit(params: GetDepositParams<SuiChainKey>): Promise<bigint>;
     /**
      * Fetch the asset manager config from the spoke chain.
-     * @param {SuiBaseSpokeProvider} suiSpokeProvider - The spoke provider.
+     * @param {SuiChainKey} chainId - The Sui chain key.
      * @returns {Promise<string>} The asset manager config.
      */
     fetchAssetManagerAddress(chainId: SuiChainKey): Promise<string>;
     /**
      * Fetch the latest asset manager package id from the spoke chain.
-     * @param {SuiBaseSpokeProvider} suiSpokeProvider - The spoke provider.
+     * @param {SuiChainKey} chainId - The Sui chain key.
      * @returns {Promise<string>} The latest asset manager package id.
      */
     fetchLatestAssetManagerPackageId(chainId: SuiChainKey): Promise<string>;
@@ -9196,19 +9717,6 @@ declare class CustomStellarAccount {
     decrementSequenceNumber(): void;
     resetSequenceNumber(): void;
 }
-type StellarSpokeDepositParams = {
-    from: Hex$1;
-    to?: HubAddress;
-    token: string;
-    amount: bigint;
-    data: Hex$1;
-};
-type StellarTransferToHubParams = {
-    token: string;
-    recipient: Address$2;
-    amount: bigint;
-    data: Hex$1;
-};
 type RequestTrustlineParams<S extends StellarChainKey, Raw extends boolean> = {
     srcAddress: string;
     srcChainKey: S;
@@ -9277,19 +9785,6 @@ declare class StellarSpokeService {
     waitForTransactionReceipt(params: WaitForTxReceiptParams<StellarChainKey>): Promise<Result<WaitForTxReceiptReturnType<StellarChainKey>>>;
 }
 
-type SolanaSpokeDepositParams = {
-    from: SolanaBase58PublicKey;
-    to?: HubAddress;
-    token: SolanaBase58PublicKey;
-    amount: bigint;
-    data: Hex$1;
-};
-type SolanaTransferToHubParams = {
-    token: PublicKey;
-    recipient: string;
-    amount: string;
-    data: Hex$1;
-};
 declare class SolanaSpokeService {
     private readonly config;
     private readonly rpcUrl;
@@ -9325,31 +9820,15 @@ declare class SolanaSpokeService {
     waitForTransactionReceipt(params: WaitForTxReceiptParams<SolanaChainKey>): Promise<Result<WaitForTxReceiptReturnType<SolanaChainKey>>>;
     static getBalance(connection: Connection$1, publicKey: SolanaBase58PublicKey): Promise<number>;
     static getTokenAccountBalance(connection: Connection$1, publicKey: SolanaBase58PublicKey): Promise<SolanaRpcResponseAndContext<SolanaTokenAmount>>;
-    static getAssociatedTokenAddress(mint: SolanaBase58PublicKey, walletAddress: SolanaBase58PublicKey): Promise<SolanaBase58PublicKey>;
+    /**
+     * Resolves the token program that owns a mint (legacy SPL Token vs Token-2022). Falls back to
+     * the legacy SPL Token program when the mint account can't be read.
+     */
+    static getMintTokenProgramId(connection: Connection$1, mint: PublicKey): Promise<PublicKey>;
+    static getAssociatedTokenAddress(mint: SolanaBase58PublicKey, walletAddress: SolanaBase58PublicKey, tokenProgramId?: PublicKey): Promise<SolanaBase58PublicKey>;
     static buildTransactionInstruction(rawInstructions: SolanaRawTransactionInstruction[]): TransactionInstruction[];
 }
 
-type IconSpokeDepositParams = {
-    from: IconAddress;
-    srcChainKey: IconChainKey;
-    to?: HubAddress;
-    token: string;
-    amount: bigint;
-    data: Hex;
-};
-type IconTransferToHubParams = {
-    token: string;
-    recipient: Address;
-    amount: bigint;
-    data: Hex;
-};
-type IconCallParams<Raw extends boolean> = {
-    srcChainKey: IconChainKey;
-    srcAddress: GetAddressType<IconChainKey>;
-    dstChainKey: HubChainKey;
-    dstAddress: HubAddress;
-    payload: Hex;
-} & WalletProviderSlot<IconChainKey, Raw>;
 declare class IconSpokeService {
     private readonly config;
     readonly iconService: IconService;
@@ -9360,7 +9839,7 @@ declare class IconSpokeService {
     estimateGas({ tx }: EstimateGasParams<IconChainKey>): Promise<IconGasEstimate>;
     /**
      * Deposit tokens to the spoke chain.
-     * @param {IconSpokeDepositParams} params - The parameters for the deposit
+     * @param {DepositParams<IconChainKey, R>} params - The parameters for the deposit
      * @param {IconSpokeProviderType} spokeProvider - The provider for the spoke chain
      * @param {EvmHubProvider} hubProvider - The provider for the hub chain
      * @param {boolean} raw - The return type raw or just transaction hash
@@ -9433,14 +9912,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;
@@ -9448,7 +9919,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.
@@ -9472,7 +9946,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.
@@ -9613,7 +10087,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.
@@ -9668,18 +10141,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[];
@@ -9696,10 +10157,11 @@ type GetRelayResponse<T extends RelayAction> = T extends 'submit' ? SubmitTxResp
 type IntentRelayRequestParams = SubmitTxParams | GetTransactionPacketsParams | GetPacketParams;
 type RelayAndWaitParams = {
     srcTxHash: string;
-    data: RelayExtraData;
+    data: RelayExtraData | OnDemandRelayData;
     chainKey: SpokeChainKey;
     relayerApiEndpoint: HttpUrl;
     timeout: number | undefined;
+    pollTxHash?: string;
 };
 /**
  * Submits a transaction to the intent relay service.
@@ -9715,6 +10177,8 @@ type RelayAndWaitParams = {
  * requires coordinated updates across all callers — prefer adding a new code to
  * {@link RELAY_ERROR_CODES} over renaming.
  *
+ * NOTE: if transaction was already relayed, post request will return { success: true, message: 'Transaction registered' }
+ *
  * @param payload - The request payload containing the 'submit' action type and parameters.
  * @param apiUrl - The URL of the intent relay service.
  * @returns The response from the intent relay service.
@@ -11545,11 +12009,11 @@ type Connection = {
     ];
 };
 
-declare function getProvider(base58PublicKey: string, rpcUrl: string): Promise<anchor.AnchorProvider>;
-declare function getAssetManagerIdl(assetManager: string, provider: anchor.AnchorProvider): Promise<anchor.Idl>;
-declare function getConnectionIdl(connection: string, provider: anchor.AnchorProvider): Promise<anchor.Idl>;
-declare function getAssetManagerProgram(base58PublicKey: string, rpcUrl: string, assetManager: string): Promise<anchor.Program<AssetManager>>;
-declare function getConnectionProgram(base58PublicKey: string, rpcUrl: string, connection: string): Promise<anchor.Program<Connection>>;
+declare function getProvider(base58PublicKey: string, rpcUrl: string): Promise<AnchorProvider>;
+declare function getAssetManagerIdl(assetManager: string, provider: AnchorProvider): Promise<_coral_xyz_anchor.Idl>;
+declare function getConnectionIdl(connection: string, provider: AnchorProvider): Promise<_coral_xyz_anchor.Idl>;
+declare function getAssetManagerProgram(base58PublicKey: string, rpcUrl: string, assetManager: string): Promise<Program<AssetManager>>;
+declare function getConnectionProgram(base58PublicKey: string, rpcUrl: string, connection: string): Promise<Program<Connection>>;
 declare function getSolanaAddressBytes(address: PublicKey): Hex$1;
 declare function hexToSolanaAddress(hex: Hex$1): PublicKey;
 declare function isSolanaNativeToken(address: PublicKey): boolean;
@@ -11590,8 +12054,6 @@ declare function isSpokeApproveParamsStellar<K extends SpokeChainKey, Raw extend
     srcChainKey: StellarChainKey;
 }>;
 declare function isRawDestinationParams(value: unknown): value is RawDestinationParams;
-declare function isSubmitSwapTxResponse(value: unknown): value is SubmitSwapTxResponse;
-declare function isSubmitSwapTxStatusResponse(value: unknown): value is SubmitSwapTxStatusResponse;
 declare function isBitcoinWalletProviderType(wp: IWalletProvider): wp is IBitcoinWalletProvider;
 declare function isEvmWalletProviderType(walletProvider: IWalletProvider): walletProvider is IEvmWalletProvider;
 declare function isStellarWalletProviderType(walletProvider: IWalletProvider): walletProvider is IStellarWalletProvider;
@@ -11601,6 +12063,20 @@ declare function isOptionalStellarWalletProviderType(walletProvider: IWalletProv
 declare function isUndefinedOrValidWalletProviderForChainKey<K extends SpokeChainKey>(chainKey: K, walletProvider: IWalletProvider | undefined): walletProvider is GetWalletProviderType<K> | undefined;
 declare function isOptionalBitcoinWalletProviderType(walletProvider: IWalletProvider | undefined): walletProvider is IBitcoinWalletProvider | undefined;
 
+/**
+ * Default logger. Mirrors the SDK's historical `console.*` behavior so existing consumers
+ * see no change when they don't pass a `logger`. `data` is appended only when present to keep
+ * single-arg log lines unchanged.
+ */
+declare const consoleLogger: SodaxLogger;
+/** No-op logger. Drops every SDK log line. Selected via `new Sodax({ logger: 'silent' })`. */
+declare const silentLogger: SodaxLogger;
+/**
+ * Resolve a {@link SodaxLoggerOption} (a preset name, a custom logger, or `undefined`) into a
+ * concrete {@link SodaxLogger}. Defaults to {@link consoleLogger} so logging is on unless opted out.
+ */
+declare function resolveLogger(option: SodaxLoggerOption | undefined): SodaxLogger;
+
 /** Swap-module narrow error types. */
 
 declare const swapInvariant: FeatureInvariant;
@@ -11614,7 +12090,7 @@ type SwapCreateIntentErrorCode = CreateIntentErrorCode;
  * that handles both `postExecution` and `swap` errors expecting the same union.
  */
 type PostExecutionErrorCode = Extract<SodaxErrorCode, 'EXECUTION_FAILED' | 'EXTERNAL_API_ERROR' | 'UNKNOWN'>;
-type SwapErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'EXTERNAL_API_ERROR' | 'UNKNOWN'>;
+type SwapErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'EXTERNAL_API_ERROR' | 'UNKNOWN'>;
 type SwapCreateIntentError = SodaxError<SwapCreateIntentErrorCode>;
 type PostExecutionError = SodaxError<PostExecutionErrorCode>;
 type SwapError = SodaxError<SwapErrorCode>;
@@ -11637,8 +12113,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
@@ -11652,10 +12128,17 @@ 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;
     hubProvider: HubProvider;
+    backendApi: BackendApiService;
+    /** Opt-in backend submit-tx 2-step flow (from `SodaxOptions.swapsOptions.useBackendSubmitTx`). Default off. */
+    useBackendSubmitTx?: boolean;
 };
 /**
  * Main entry point for the SODAX swap feature.
@@ -11680,7 +12163,9 @@ declare class SwapService {
     readonly solver: SolverConfig;
     readonly partnerFee: PartnerFee | undefined;
     readonly relayerApiEndpoint: HttpUrl;
-    constructor({ config, hubProvider, spoke }: SwapServiceConstructorParams);
+    readonly backendApi: BackendApiService;
+    readonly useBackendSubmitTx: boolean;
+    constructor({ config, hubProvider, spoke, backendApi, useBackendSubmitTx }: SwapServiceConstructorParams);
     /**
      * Estimates the gas cost for a raw (unsigned) transaction on a spoke chain.
      *
@@ -11691,10 +12176,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.
      *
@@ -11709,7 +12197,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.
      *
@@ -11771,14 +12259,22 @@ declare class SwapService {
     /**
      * Executes a full end-to-end cross-chain swap.
      *
-     * Orchestrates the complete swap lifecycle:
-     * 1. Calls `createIntent` 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. Calls `postExecution` to notify the solver, triggering it to fill the intent.
-     *
-     * @param _params - Swap action params including intent parameters, wallet provider, and optional timeout.
+     * Orchestrates the complete swap lifecycle. `createIntent` first submits the intent transaction on
+     * the source spoke chain; completion then runs via one of two paths, both bounded by a single
+     * shared `timeout` budget:
+     *
+     * - **Client-side (default), {@link fallbackSwapSteps}:** verifies the spoke tx landed on-chain,
+     *   relays it to the hub (Sonic) and waits for the packet — skipped when `srcChainKey` is the hub,
+     *   where the spoke tx already is the hub tx — then calls `postExecution` to notify the solver,
+     *   triggering it to fill the intent.
+     * - **Backend 2-step (opt-in via `swapsOptions.useBackendSubmitTx`), {@link submitTx}:** hands the
+     *   broadcast tx to the swaps API, which verifies, relays and post-executes server-side, then polls
+     *   for completion. On ANY non-success it transparently falls back to the client-side path above —
+     *   safe because re-relaying / re-posting an already-processed swap is idempotent (no double-fill).
+     *
+     * @param _params - Swap action params including intent parameters, wallet provider, and an optional
+     *   `timeout` — the single shared budget for the whole completion flow (relay/poll plus any
+     *   fallback), so total wall-clock never exceeds it.
      * @returns A `Result<SwapResponse, SwapError>`. On success:
      *   - `solverExecutionResponse` — solver acknowledgement (`{ answer: 'OK', intent_hash }`).
      *   - `intent` — the on-chain intent object that was created.
@@ -11799,6 +12295,29 @@ declare class SwapService {
      *   - `UNKNOWN` — uncategorized fallback.
      */
     swap<K extends SpokeChainKey>(_params: SwapActionParams<K, false>): Promise<Result<SwapResponse, SwapError>>;
+    /**
+     * Client-side swap completion (the default path): relay the broadcast intent tx to the hub — or
+     * use it directly when the source IS the hub — then notify the solver via post-execution and
+     * build the {@link SwapResponse}. Extracted verbatim from `swap()` so the opt-in backend 2-step
+     * path ({@link submitTx}) can fall back to it on any non-success.
+     */
+    private fallbackSwapSteps;
+    /**
+     * Backend 2-step swap path (opt-in via `swapsOptions.useBackendSubmitTx`): hand the broadcast
+     * intent tx to the swaps API (`POST /swaps/submit-tx`); the backend relays + post-executes
+     * server-side. Polls `getSubmitTxStatus` until `solved`, then reconstructs the same
+     * {@link SwapResponse} the client-side path returns (`result.dstIntentTxHash` → delivery info,
+     * `result.intent_hash` → solver response).
+     *
+     * Never throws — returns `{ ok: false }` on any non-success (submit `!ok`, terminal `failed` /
+     * abandoned, or poll timeout) so `swap()` falls back to {@link fallbackSwapSteps}.
+     *
+     * Falling back is safe: re-relaying / re-posting an already-processed swap is idempotent — the
+     * relay dedups and returns the existing `executed` packet, and the solver re-affirms the intent
+     * (no double-fill). Verified live by `e2e-tests/e2e-relay.test.ts`. Polling stops at
+     * `deadline - reserve` so the fallback keeps a guaranteed slice of the shared `swap` budget.
+     */
+    private submitTx;
     /**
      * Checks whether the relevant spender contract is already approved to spend the input token amount.
      *
@@ -11842,7 +12361,7 @@ declare class SwapService {
      * - `raw: false` — broadcasts the transaction; `walletProvider` is required and must match `K`.
      *
      * Validates tokens and chain keys against the active `ConfigService` before constructing the
-     * intent. Bitcoin source chains require an additional RadFi access token step.
+     * intent. Bitcoin source chains require an additional Bound Exchange access token step.
      *
      * @param _params - Intent parameters, source chain key, wallet provider (when `raw: false`),
      *   and optional `skipSimulation` flag.
@@ -11945,6 +12464,24 @@ declare class SwapService {
      * @returns A `Result` containing `RelayExtraData`: `{ address: Hex; payload: Hex }`.
      */
     getIntentSubmitTxExtraData(params: GetIntentSubmitTxExtraDataParams): Promise<Result<RelayExtraData>>;
+    /**
+     * Re-derives the byte-identical relay extra data (`{ address, payload }`) for a swap intent from a
+     * fully-populated `Intent` alone — no on-chain call, no original `createIntent` return value needed.
+     *
+     * The `payload` matches exactly what `createIntent` relayed when the intent was first created:
+     * - Sonic-hub source — raw `createIntent(intent)` calldata.
+     * - Any spoke source — the `[approve, createIntent]` multicall (uniform across all spokes).
+     *
+     * Byte-identity is possible because the only originally-random field, `intentId`, is already
+     * carried on the `Intent`; everything else in the payload is a pure function of the intent and
+     * the configured intents contract. Use this to rebuild relay submission data for a manual relay
+     * step when the runtime `relayData` from `createIntent` is no longer available.
+     *
+     * @param intent - A fully-populated intent (e.g. from `getIntent(txHash)` or the `intent` field
+     *   returned by `createIntent`).
+     * @returns A `Result` containing `RelayExtraData`: `{ address: Hex; payload: Hex }`.
+     */
+    reconstructRelayData(intent: Intent): Result<RelayExtraData>;
     /**
      * Fetches a previously created `Intent` from the hub chain by its transaction hash.
      *
@@ -11971,6 +12508,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).
@@ -12028,13 +12570,13 @@ declare class SwapService {
 declare const migrationInvariant: FeatureInvariant;
 type MigrationOp = 'migratebnUSD' | 'migrateIcxToSoda' | 'revertMigrateSodaToIcx' | 'migrateBaln';
 type MigrationDirection = 'forward' | 'reverse';
-type MigrateOrchestrationErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
+type MigrateOrchestrationErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
 type RevertMigrationOrchestrationErrorCode = Exclude<MigrateOrchestrationErrorCode, 'TX_VERIFICATION_FAILED'>;
 type MigrationCreateIntentErrorCode = CreateIntentErrorCode;
 type MigrationApproveErrorCode = ApproveErrorCode;
 type MigrationAllowanceCheckErrorCode = AllowanceCheckErrorCode;
 type MigrationLookupErrorCode = LookupErrorCode;
-type MigrationErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'APPROVE_FAILED' | 'ALLOWANCE_CHECK_FAILED' | 'LOOKUP_FAILED' | 'UNKNOWN'>;
+type MigrationErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'APPROVE_FAILED' | 'ALLOWANCE_CHECK_FAILED' | 'LOOKUP_FAILED' | 'UNKNOWN'>;
 type MigrateOrchestrationError = SodaxError<MigrateOrchestrationErrorCode>;
 type RevertMigrationOrchestrationError = SodaxError<RevertMigrationOrchestrationErrorCode>;
 type MigrationCreateIntentError = SodaxError<MigrationCreateIntentErrorCode>;
@@ -12435,7 +12977,7 @@ declare class BalnSwapService {
      * @param user - The EVM address of the user to query locks for.
      * @returns An immutable array of `DetailedLock` objects, one per active lock.
      */
-    getDetailedUserLocks(publicClient: PublicClient<HttpTransport>, user: Address$1): Promise<readonly DetailedLock[]>;
+    getDetailedUserLocks(publicClient: PublicClient, user: Address$1): Promise<readonly DetailedLock[]>;
     /**
      * Encodes a single `swap` call on the BALN swap contract.
      *
@@ -12720,12 +13262,12 @@ declare class MigrationService {
 
 declare const bridgeInvariant: FeatureInvariant;
 type BridgeAction = 'bridge';
-type BridgeOrchestrationErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
+type BridgeOrchestrationErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
 type BridgeCreateIntentErrorCode = CreateIntentErrorCode;
 type BridgeApproveErrorCode = ApproveErrorCode;
 type BridgeAllowanceCheckErrorCode = AllowanceCheckErrorCode;
 type BridgeLookupErrorCode = LookupErrorCode;
-type BridgeErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'APPROVE_FAILED' | 'ALLOWANCE_CHECK_FAILED' | 'LOOKUP_FAILED' | 'UNKNOWN'>;
+type BridgeErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'APPROVE_FAILED' | 'ALLOWANCE_CHECK_FAILED' | 'LOOKUP_FAILED' | 'UNKNOWN'>;
 type BridgeOrchestrationError = SodaxError<BridgeOrchestrationErrorCode>;
 type BridgeCreateIntentError = SodaxError<BridgeCreateIntentErrorCode>;
 type BridgeApproveError = SodaxError<BridgeApproveErrorCode>;
@@ -12862,7 +13404,7 @@ declare class BridgeService {
      * transaction simulation or batching). When `raw` is `false`, signs and submits the deposit
      * transaction via the provided wallet provider.
      *
-     * Bitcoin is only supported with `raw: false` because it requires the RadFi trading wallet
+     * Bitcoin is only supported with `raw: false` because it requires the Bound Exchange trading wallet
      * derivation flow.
      *
      * @param _params - Bridge parameters including source/destination chain keys, token addresses,
@@ -12872,6 +13414,16 @@ declare class BridgeService {
      *   contains the hub wallet address and encoded hub execution payload needed for relay.
      */
     createBridgeIntent<K extends SpokeChainKey, Raw extends boolean>(_params: BridgeParams<K, Raw>): Promise<Result<IntentTxResult<K, Raw>, BridgeCreateIntentError>>;
+    /**
+     * Resolves a bridge endpoint's {@link XToken} descriptor from a chain key + token address.
+     *
+     * Spoke endpoints (and hub-native tokens such as USDC/WETH/S whose on-chain address equals their
+     * hub asset) resolve by original asset address. On the hub a caller may instead hold a hub asset
+     * that has no spoke-token entry under the hub chain — e.g. a partner BTC fee held as the BTC hub
+     * asset, whose only spoke-token entry lives on Bitcoin. Resolve those by hub-asset address so the
+     * Sonic-sourced "withdraw directly" bridge can find the matching vault/decimals.
+     */
+    private resolveBridgeEndpointToken;
     /**
      * Encodes the hub-side execution payload for a bridge operation.
      *
@@ -12930,7 +13482,7 @@ declare class BridgeService {
      *   checking theoretical bridgeability without requiring both chains to be in the active config.
      * @returns `true` if the tokens share the same hub vault; `false` otherwise.
      */
-    isBridgeable({ from, to, unchecked, }: {
+    isBridgeable({ from, to, unchecked }: {
         from: XToken;
         to: XToken;
         unchecked?: boolean;
@@ -12988,7 +13540,7 @@ declare const stakingInvariant: FeatureInvariant;
 /** The 5 user-facing staking operations. Carried on `context.action`. */
 type StakingActionType = 'stake' | 'unstake' | 'instantUnstake' | 'claim' | 'cancelUnstake';
 /** Codes the `stake` orchestrator can return — only one that calls `verifyTxHash`. */
-type StakeOrchestrationErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
+type StakeOrchestrationErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
 /** Codes the 4 non-stake orchestrators (`unstake`/`instantUnstake`/`claim`/`cancelUnstake`) share. */
 type StakingOrchestrationErrorCode = Exclude<StakeOrchestrationErrorCode, 'TX_VERIFICATION_FAILED'>;
 type StakingCreateIntentErrorCode = CreateIntentErrorCode;
@@ -13988,7 +14540,7 @@ declare class ClService {
      * @returns `Result<PoolRewardConfig>` — on success, contains the reward token address,
      *   reward rate per second, and the timestamp of the last position-affecting action.
      */
-    getPoolRewardConfig(poolKey: PoolKey, publicClient: PublicClient<HttpTransport>): Promise<Result<PoolRewardConfig>>;
+    getPoolRewardConfig(poolKey: PoolKey, publicClient: PublicClient): Promise<Result<PoolRewardConfig>>;
     /**
      * Build and submit the spoke-side transaction that harvests hook rewards for a position.
      *
@@ -14057,7 +14609,7 @@ declare class ClService {
      *   fee tiers, token metadata with optional StatAToken enrichment, and optional
      *   reward configuration. `isActive` is `true` when `sqrtPriceX96 > 0`.
      */
-    getPoolData(poolKey: PoolKey<'CL'>, publicClient: PublicClient<HttpTransport>): Promise<Result<PoolData>>;
+    getPoolData(poolKey: PoolKey<'CL'>, publicClient: PublicClient): Promise<Result<PoolData>>;
     /**
      * Fetch full details for a concentrated-liquidity position NFT.
      *
@@ -14074,7 +14626,7 @@ declare class ClService {
      *   current token amounts, tick-boundary prices, unclaimed fees, and optional
      *   underlying amounts for StatAToken pools.
      */
-    getPositionInfo(tokenId: bigint, publicClient: PublicClient<HttpTransport>): Promise<Result<ClPositionInfo>>;
+    getPositionInfo(tokenId: bigint, publicClient: PublicClient): Promise<Result<ClPositionInfo>>;
     /**
      * Compute the maximum liquidity achievable given both token input amounts.
      *
@@ -14205,7 +14757,7 @@ declare const mmInvariant: FeatureInvariant;
 type MoneyMarketAction = 'supply' | 'borrow' | 'withdraw' | 'repay';
 type MoneyMarketCreateIntentErrorCode = CreateIntentErrorCode;
 /** Codes any of the 4 orchestrators (`supply`/`borrow`/`withdraw`/`repay`) can return. */
-type MoneyMarketOrchestrationErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
+type MoneyMarketOrchestrationErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'INTENT_CREATION_FAILED' | 'TX_VERIFICATION_FAILED' | 'TX_SUBMIT_FAILED' | 'RELAY_TIMEOUT' | 'RELAY_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
 type MoneyMarketApproveErrorCode = ApproveErrorCode;
 type MoneyMarketAllowanceCheckErrorCode = AllowanceCheckErrorCode;
 type MoneyMarketGasEstimationErrorCode = GasEstimationErrorCode;
@@ -15353,6 +15905,15 @@ declare class MoneyMarketService {
      *   trigger the hub-side execution via {@link relayTxAndWaitPacket}.
      */
     createSupplyIntent<K extends SpokeChainKey, Raw extends boolean>(_params: MoneyMarketSupplyActionParams<K, Raw>): Promise<Result<IntentTxResult<K, Raw>, MoneyMarketCreateIntentError>>;
+    /**
+     * Build the relay submit/poll identity for a money-market borrow/withdraw.
+     *
+     * Bitcoin borrow/withdraw are on-demand: the spoke result is a signed payload JSON that the relay
+     * submits under the literal "withdraw" tx_hash and tracks under a derived `od:<hash>` poll id
+     * (see {@link BitcoinSpokeService.getOnDemandRelayIdentity}). Every other chain relays and polls by
+     * its real spoke tx hash, so `pollTxHash` is undefined and `srcChainTxHash` stays the spoke tx.
+     */
+    private buildRelayIdentity;
     /**
      * Borrow tokens from the money market lending pool and wait for the cross-chain relay to
      * deliver the funds to the destination address.
@@ -15642,6 +16203,18 @@ type PartnerFeeClaimSwapParams = {
     timeout?: number;
 };
 type PartnerFeeClaimSwapAction<K extends SpokeChainKey, Raw extends boolean> = SpokeExecActionParams<K, Raw, PartnerFeeClaimSwapParams>;
+type PartnerFeeClaimCancelParams = {
+    srcChainKey: HubChainKey;
+    srcAddress: Address$1;
+    fromToken: Address$1;
+    toToken: Address$1;
+};
+type PartnerFeeClaimCancelAction<K extends SpokeChainKey, Raw extends boolean> = SpokeExecActionParams<K, Raw, PartnerFeeClaimCancelParams>;
+type GetUserIntentParams = {
+    user: Address$1;
+    fromToken: Address$1;
+    toToken: Address$1;
+};
 type PartnerFeeClaimServiceConstructorParams = {
     config: ConfigService;
     hubProvider: HubProvider;
@@ -15776,6 +16349,11 @@ declare class PartnerFeeClaimService {
      * This is the low-level building block. Use `swap` for the full flow that also waits for
      * the solver to execute the intent.
      *
+     * Guards against same-token intents: if the configured output token equals `fromToken` the solver
+     * cannot fill the swap, so the call is rejected with `VALIDATION_FAILED` before any transaction is
+     * built. The guard fails closed — if the preference lookup fails the call returns that error rather
+     * than submitting an intent that may become unfillable.
+     *
      * @param _params - Action descriptor containing:
      *   - `params.srcChainKey` — must be the hub chain key (Sonic).
      *   - `params.srcAddress` — partner's EVM address; also used as the intent creator.
@@ -15806,10 +16384,59 @@ declare class PartnerFeeClaimService {
      *
      *   On failure the `error` is tagged:
      *   - `WAIT_INTENT_AUTO_SWAP_FAILED` — transaction was submitted but receipt polling failed.
-     *   - Error from `createIntentAutoSwap` — if the initial submission failed.
+     *   - Error from `createIntentAutoSwap` — if the initial submission failed, including
+     *     `VALIDATION_FAILED` when the output token equals the fee token (same-token guard) or the
+     *     preference lookup that backs the guard fails.
      *   - Error from `SolverApiService.postExecution` — if the solver notification failed.
      */
     swap(_params: PartnerFeeClaimSwapAction<HubChainKey, false>): Promise<Result<IntentAutoSwapResult>>;
+    /**
+     * Cancels a partner fee-claim auto-swap intent and refunds the input token to the partner.
+     *
+     * This targets the ProtocolIntents contract's own `cancelIntent(fromToken, toToken)`, which is
+     * the only authorized cancel path for partner auto-swap intents: the intent's `creator` is the
+     * ProtocolIntents contract (not the partner), so the generic `SwapService.cancelIntent` reverts
+     * with `Unauthorized()`. ProtocolIntents looks up the caller's intent for the token pair, cancels
+     * it in the main intents contract (as the creator), and transfers the locked `inputAmount` back
+     * to the partner (`msg.sender`).
+     *
+     * Use this to recover funds stuck in an unfillable intent — most commonly a same-token claim
+     * (`fromToken === toToken`) the solver refused to fill (see the guard in {@link swap}).
+     *
+     * @param _params - Action descriptor containing:
+     *   - `params.srcChainKey` — must be the hub chain key (Sonic).
+     *   - `params.srcAddress` — the partner's EVM address; must match the intent's owner.
+     *   - `params.fromToken` — the stuck intent's input (fee) token, hub-chain address.
+     *   - `params.toToken` — the stuck intent's output token, hub-chain address.
+     *   - `raw` — when `true`, returns the unsigned transaction object instead of submitting it.
+     *   - `walletProvider` — required when `raw` is `false`; must be an EVM wallet provider.
+     * @returns A `Result` containing the submitted transaction hash (`raw: false`) or the unsigned
+     *   raw transaction (`raw: true`).
+     */
+    cancelIntent<Raw extends boolean>(_params: PartnerFeeClaimCancelAction<HubChainKey, Raw>): Promise<Result<TxReturnType<HubChainKey, Raw>>>;
+    /**
+     * Returns the stored intent hash for a partner's `(user, fromToken, toToken)` token pair.
+     *
+     * A non-zero hash means an auto-swap intent currently exists for that pair (e.g. an unfilled
+     * same-token claim) and can be cancelled via {@link cancelIntent}. A zero hash
+     * (`0x000…0`) means there is no open intent for the pair.
+     *
+     * @param params.user - The partner's EVM address on Sonic.
+     * @param params.fromToken - Input (fee) token, hub-chain address.
+     * @param params.toToken - Output token, hub-chain address.
+     * @returns A `Result` containing the intent hash, or an `Error` tagged `LOOKUP_FAILED`.
+     */
+    getUserIntent({ user, fromToken, toToken }: GetUserIntentParams): Promise<Result<Hex, Error>>;
+    /**
+     * Reads the full {@link Intent} details for a stored intent hash from the ProtocolIntents contract.
+     *
+     * Useful for displaying a stuck intent before cancelling it — e.g. the locked `inputAmount` and
+     * `inputToken`. Pair with {@link getUserIntent} to resolve the hash from a token pair.
+     *
+     * @param intentHash - The intent hash (from {@link getUserIntent}).
+     * @returns A `Result` containing the `Intent`, or an `Error` tagged `LOOKUP_FAILED`.
+     */
+    getIntentDetails(intentHash: Hex): Promise<Result<Intent, Error>>;
 }
 
 type PartnerServiceConfig = {
@@ -15933,6 +16560,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, 'USER_REJECTED' | '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, 'USER_REJECTED' | '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.
  *
@@ -15944,15 +17046,17 @@ declare class Sodax {
     readonly moneyMarket: MoneyMarketService;
     readonly migration: MigrationService;
     readonly backendApi: BackendApiService;
+    readonly api: BackendApiService;
     readonly bridge: BridgeService;
     readonly staking: StakingService;
     readonly partners: PartnerService;
     readonly recovery: RecoveryService;
     readonly dex: DexService;
+    readonly leverageYield: LeverageYieldService;
     readonly config: ConfigService;
     readonly hubProvider: HubProvider;
     readonly spoke: SpokeService;
-    constructor(config?: DeepPartial<SodaxConfig>);
+    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.
@@ -16137,6 +17241,40 @@ declare class EvmSolverService {
      * @throws Invariant error if `inputAmount` is `0n` or if the fee percentage is out of range.
      */
     static createIntentFeeData(fee: PartnerFee | undefined, inputAmount: bigint): [Hex, bigint];
+    /**
+     * Recovers the partner fee amount embedded in an intent's `data` field.
+     *
+     * Inverse of {@link createIntentFeeData}: returns the encoded fee, regardless of whether the `data`
+     * is a bare fee envelope or a multi-entry envelope that also carries delivery data. The envelope
+     * parsing lives in {@link IntentDataService.extractFeePayload}; this method just decodes the fee struct.
+     *
+     * @param data - The intent's `data` field (`'0x'` when no fee was configured).
+     * @returns The fee amount in the input token's smallest unit (`0n` when no fee is present).
+     */
+    static decodeIntentFeeAmount(data: Hex): bigint;
+    /** Decodes a raw `FeeData` payload (`abi.encode(uint256 fee, address receiver)`) to its fee amount. */
+    private static decodeFeePayload;
+    /**
+     * Re-derives the byte-identical relay payload that `createIntent` originally produced, from a
+     * fully-populated `Intent` alone.
+     *
+     * Mirrors the two payload shapes built at intent-creation time:
+     * - Hub (Sonic) source — raw `createIntent(intent)` calldata (no approval, no multicall), matching
+     *   {@link SonicSpokeService.createSwapIntent}.
+     * - Spoke source — the `[approve(intentsContract, gross), createIntent(intent)]` multicall, matching
+     *   {@link constructCreateIntentData}. The gross approval amount is recovered as
+     *   `intent.inputAmount + feeAmount`, where `feeAmount` comes from {@link decodeIntentFeeAmount}.
+     *
+     * Byte-identity holds because this reuses the exact encode primitives (`encodeCreateIntent`,
+     * `Erc20Service.encodeApprove`, `encodeContractCalls`) that produced the original — the only
+     * originally-random input, `intentId`, is already carried on the `Intent`.
+     *
+     * @param intent - The fully-populated intent (e.g. from `createIntent` or `getIntent`).
+     * @param intentsContract - The hub-chain intents contract address (`config.solver.intentsContract`).
+     * @param isHubSource - `true` when the intent's source chain is the hub (Sonic).
+     * @returns The byte-identical relay payload `Hex`.
+     */
+    static reconstructCreateIntentData(intent: Intent, intentsContract: Address$1, isHubSource: boolean): Hex;
     /**
      * Reads an `Intent` struct from a hub-chain transaction receipt.
      *
@@ -16151,7 +17289,7 @@ declare class EvmSolverService {
      * @throws If the transaction contains no matching `IntentCreated` event, or if the
      *   intent's chain IDs are not recognized.
      */
-    static getIntent(txHash: Hash$1, config: ConfigService, publicClient: PublicClient<HttpTransport>): Promise<Intent>;
+    static getIntent(txHash: Hash$1, config: ConfigService, publicClient: PublicClient): Promise<Intent>;
     /**
      * Reads an `IntentState` struct from a hub-chain fill transaction receipt.
      *
@@ -16164,7 +17302,7 @@ declare class EvmSolverService {
      * @returns `IntentState`: `{ exists, remainingInput, receivedOutput, pendingPayment }`.
      * @throws If the transaction contains no matching `IntentFilled` event.
      */
-    static getFilledIntent(txHash: Hash$1, solverConfig: SolverConfig, publicClient: PublicClient<HttpTransport>): Promise<IntentState>;
+    static getFilledIntent(txHash: Hash$1, solverConfig: SolverConfig, publicClient: PublicClient): Promise<IntentState>;
     /**
      * Computes the keccak256 hash of an intent struct, which serves as its unique ID on the hub chain.
      *
@@ -16193,6 +17331,89 @@ declare class EvmSolverService {
     static encodeCancelIntent(intent: Intent, intentsContract: Address$1): EvmContractCall;
 }
 
+/**
+ * Stateless utility for the SODAX solver's delivery hooks.
+ *
+ * A delivery hook lets an intent's output be handed to `ISpokeReceiver(dstAddress).hook(...)` on the
+ * destination spoke instead of transferred straight to the recipient. Each hook is two coupled things:
+ * its **deployed address** (the registry in `@sodax/types`) and its **`deliveryData` codec** (here).
+ * This class fuses them so the address and payload can never drift, and exposes a single
+ * type-differentiated {@link encodeDeliveryData} rather than one encoder per hook.
+ */
+declare class HookService {
+    private constructor();
+    /**
+     * Encodes a hook's `deliveryData` payload. One common entry point for all hooks — the encoding is
+     * selected by {@link HookRequest.kind} and uses that hook's schema from {@link HOOK_DELIVERY_ABI}.
+     *
+     * @param request - The hook selection (and any hook-specific params).
+     * @param recipient - The end recipient the hook should credit (the intent's `dstAddress`).
+     */
+    static encodeDeliveryData(request: HookRequest, recipient: string): Hex;
+    /**
+     * Resolves a high-level {@link HookRequest} to the on-chain delivery pair: the deployed hook address
+     * (becomes the intent's `dstAddress`) and the encoded payload the hook expects (`deliveryData`).
+     * Bundling lookup + codec here guarantees the address and its payload schema can never drift.
+     *
+     * @param chainKey - Destination spoke chain (must have the requested hook deployed).
+     * @param request - The hook selection (and any hook-specific params).
+     * @param recipient - The end recipient the hook should credit (the intent's `dstAddress`).
+     */
+    static resolveDeliveryHook(chainKey: SpokeChainKey, request: HookRequest, recipient: string): {
+        dstAddress: Address$1;
+        deliveryData: Hex;
+    };
+    /**
+     * Resolves the effective delivery target for an intent. When {@link CreateIntentParams.hook} is set,
+     * routes the output through that registered hook (overriding `dstAddress` and deriving `deliveryData`);
+     * otherwise returns the caller's `dstAddress` and low-level `deliveryData` unchanged. Centralised so
+     * both the hub and Sonic intent constructors apply hooks identically.
+     *
+     * @returns `{ dstAddress, deliveryData }` — the address to deliver to and the payload to forward.
+     */
+    static resolveDelivery(params: CreateIntentParams): {
+        dstAddress: string;
+        deliveryData: Hex | undefined;
+    };
+}
+
+/**
+ * Stateless utility for the `Intent.data` envelope layer.
+ *
+ * `Intent.data` carries zero or more typed entries (a partner-fee payload, a delivery payload, …).
+ * This class owns how those entries are packed into bytes the on-chain `IntentDataLib` decodes and
+ * how they are recovered back out, keeping the `ArrayData` codec ({@link ARRAY_DATA_ABI}) in one
+ * place. The delivery payloads themselves are produced by `HookService`; this layer is agnostic to
+ * their contents and simply folds them in alongside the fee.
+ */
+declare class IntentDataService {
+    private constructor();
+    /**
+     * Folds a partner-fee envelope and an optional delivery payload into the final `Intent.data`:
+     * - Neither → `'0x'`.
+     * - Exactly one → that single packed `[uint8 type, bytes payload]` envelope (byte-identical to a
+     *   bare fee envelope, so a fee-only intent's `data` is unchanged and stays decode-stable).
+     * - Both → a `TYPE_ARRAY` envelope wrapping `[FEE, DELIVERY]` entries.
+     *
+     * @param feeEnvelope - The packed fee envelope from `EvmSolverService.createIntentFeeData` (`'0x'` if no fee).
+     * @param deliveryData - Opaque delivery payload (e.g. from `HookService.encodeDeliveryData`), or `undefined`.
+     */
+    static composeIntentData(feeEnvelope: Hex, deliveryData?: Hex): Hex;
+    /**
+     * Encodes a list of typed `IntentData` entries into the `Intent.data` bytes the contract decodes.
+     * Empty → `'0x'`; single → a packed `[uint8 type, bytes payload]` envelope; multiple → a `TYPE_ARRAY`
+     * envelope wrapping the entries as `ArrayData { DataEntry[] }`.
+     */
+    static encodeIntentData(entries: IntentData[]): Hex;
+    /**
+     * Extracts the raw `FeeData` payload (`abi.encode(uint256 fee, address receiver)`) from an intent's
+     * `data`, unwrapping whichever envelope shape it uses. Returns `undefined` when there is no fee:
+     * empty `data`, a delivery-only envelope, or an unknown type byte (logged). Used by
+     * `EvmSolverService.decodeIntentFeeAmount` to recover fees regardless of delivery data.
+     */
+    static extractFeePayload(data: Hex): Hex | undefined;
+}
+
 /**
  * Stateless HTTP client for the SODAX solver API.
  *
@@ -16233,7 +17454,7 @@ declare class SolverApiService {
      * @param config - Solver endpoint configuration.
      * @returns A `Result` containing `{ answer: 'OK', intent_hash: Hex }` on success.
      */
-    static postExecution(request: SolverExecutionRequest, config: SolverConfig): Promise<Result<SolverExecutionResponse, SolverErrorResponse>>;
+    static postExecution(request: SolverExecutionRequest, config: SolverConfig, logger?: SodaxLogger): Promise<Result<SolverExecutionResponse, SolverErrorResponse>>;
     /**
      * Polls the solver API for the current execution status of an intent (`POST /status`).
      *
@@ -16243,7 +17464,7 @@ declare class SolverApiService {
      *   `fill_tx_hash` is set only when `status === SolverIntentStatusCode.SOLVED (3)`.
      * @throws Invariant error if `intent_tx_hash` is empty (thrown before the async request).
      */
-    static getStatus(request: SolverIntentStatusRequest, config: SolverConfig): Promise<Result<SolverIntentStatusResponse, SolverErrorResponse>>;
+    static getStatus(request: SolverIntentStatusRequest, config: SolverConfig, logger?: SodaxLogger): Promise<Result<SolverIntentStatusResponse, SolverErrorResponse>>;
 }
 
 /**
@@ -16266,7 +17487,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns Array of `UserUnstakeInfo` records for all active unstake requests.
      */
-    static getUnstakeSodaRequests(stakedSoda: Address$1, user: Address$1, publicClient: PublicClient<HttpTransport>): Promise<readonly UserUnstakeInfo[]>;
+    static getUnstakeSodaRequests(stakedSoda: Address$1, user: Address$1, publicClient: PublicClient): Promise<readonly UserUnstakeInfo[]>;
     /**
      * Encodes the depositFor transaction data.
      * @param stakedSoda - The address of the StakedSoda contract.
@@ -16318,7 +17539,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns Total SODA deposited across all stakers.
      */
-    static getXSodaTotalAssets(xSoda: Address$1, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static getXSodaTotalAssets(xSoda: Address$1, publicClient: PublicClient): Promise<bigint>;
     /**
      * Calculates the number of xSoda shares equivalent to a given amount of SODA assets (`convertToShares`).
      * @param xSoda - The address of the xSoda ERC-4626 vault contract.
@@ -16326,7 +17547,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns The xSoda share count equivalent to `assets` at the current exchange rate.
      */
-    static convertSodaToXSodaShares(xSoda: Address$1, assets: bigint, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static convertSodaToXSodaShares(xSoda: Address$1, assets: bigint, publicClient: PublicClient): Promise<bigint>;
     /**
      * Calculates the SODA asset amount corresponding to a given number of xSoda shares (`convertToAssets`).
      * @param xSoda - The address of the xSoda ERC-4626 vault contract.
@@ -16334,7 +17555,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns The SODA asset amount equivalent to `shares` at the current exchange rate.
      */
-    static convertXSodaSharesToSoda(xSoda: Address$1, shares: bigint, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static convertXSodaSharesToSoda(xSoda: Address$1, shares: bigint, publicClient: PublicClient): Promise<bigint>;
     /**
      * Simulates a SODA deposit into the xSoda vault (`previewDeposit`) without executing it.
      * @param xSoda - The address of the xSoda ERC-4626 vault contract.
@@ -16342,7 +17563,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns The xSoda shares that would be minted for `assets`.
      */
-    static previewXSodaDeposit(xSoda: Address$1, assets: bigint, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static previewXSodaDeposit(xSoda: Address$1, assets: bigint, publicClient: PublicClient): Promise<bigint>;
     /**
      * Simulates minting a specific number of xSoda shares (`previewMint`) without executing it.
      * @param xSoda - The address of the xSoda ERC-4626 vault contract.
@@ -16350,7 +17571,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns The SODA assets that would need to be deposited to mint `shares`.
      */
-    static previewXSodaMint(xSoda: Address$1, shares: bigint, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static previewXSodaMint(xSoda: Address$1, shares: bigint, publicClient: PublicClient): Promise<bigint>;
     /**
      * Simulates withdrawing a specific SODA amount from the xSoda vault (`previewWithdraw`) without executing it.
      * @param xSoda - The address of the xSoda ERC-4626 vault contract.
@@ -16358,7 +17579,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns The xSoda shares that would be burned to withdraw `assets`.
      */
-    static previewXSodaWithdraw(xSoda: Address$1, assets: bigint, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static previewXSodaWithdraw(xSoda: Address$1, assets: bigint, publicClient: PublicClient): Promise<bigint>;
     /**
      * Simulates redeeming a specific number of xSoda shares (`previewRedeem`) without executing it.
      * @param xSoda - The address of the xSoda ERC-4626 vault contract.
@@ -16366,7 +17587,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns The SODA assets that would be withdrawn for `shares`.
      */
-    static previewXSodaRedeem(xSoda: Address$1, shares: bigint, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static previewXSodaRedeem(xSoda: Address$1, shares: bigint, publicClient: PublicClient): Promise<bigint>;
     /**
      * Encodes the xSoda deposit transaction data (deposit SODA to get xSoda shares).
      * @param xSoda - The address of the xSoda token contract.
@@ -16432,7 +17653,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns Tuple `[xSodaAmount, previewDepositAmount]` — estimated shares and vault preview figure.
      */
-    static estimateXSodaAmount(stakingRouter: Address$1, amount: bigint, publicClient: PublicClient<HttpTransport>): Promise<readonly [bigint, bigint]>;
+    static estimateXSodaAmount(stakingRouter: Address$1, amount: bigint, publicClient: PublicClient): Promise<readonly [bigint, bigint]>;
     /**
      * Estimates the SODA output for instantly unstaking a given xSoda amount.
      *
@@ -16445,7 +17666,7 @@ declare class StakingLogic {
      * @param publicClient - Viem public client connected to the hub chain.
      * @returns The estimated SODA output for the instant unstake.
      */
-    static estimateInstantUnstake(stakingRouter: Address$1, amount: bigint, publicClient: PublicClient<HttpTransport>): Promise<bigint>;
+    static estimateInstantUnstake(stakingRouter: Address$1, amount: bigint, publicClient: PublicClient): Promise<bigint>;
 }
 
 declare function isIcxMigrateParams(value: unknown): value is IcxMigrateParams;
@@ -16457,7 +17678,7 @@ declare function isIcxCreateRevertMigrationParams(value: unknown): value is IcxC
 
 declare const partnerInvariant: FeatureInvariant;
 type PartnerAction = 'waitAutoSwap';
-type PartnerErrorCode = Extract<SodaxErrorCode, 'VALIDATION_FAILED' | 'LOOKUP_FAILED' | 'APPROVE_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
+type PartnerErrorCode = Extract<SodaxErrorCode, 'USER_REJECTED' | 'VALIDATION_FAILED' | 'LOOKUP_FAILED' | 'APPROVE_FAILED' | 'EXECUTION_FAILED' | 'UNKNOWN'>;
 type PartnerError = SodaxError<PartnerErrorCode>;
 declare const isPartnerError: (e: unknown) => e is SodaxError<PartnerErrorCode>;
 
@@ -16475,5 +17696,13 @@ declare const dexInvariant: FeatureInvariant;
 type DexErrorCode = LookupErrorCode;
 type DexError = SodaxError<DexErrorCode>;
 declare const isDexError: (e: unknown) => e is SodaxError<LookupErrorCode>;
+/** Codes any DEX `executeXxx` / intent-creation method can return. */
+type DexCreateIntentErrorCode = CreateIntentErrorCode;
+type DexCreateIntentError = SodaxError<DexCreateIntentErrorCode>;
+declare const isDexCreateIntentError: (e: unknown) => e is SodaxError<CreateIntentErrorCode>;
+/** Codes the DEX `approve` method can return. */
+type DexApproveErrorCode = ApproveErrorCode;
+type DexApproveError = SodaxError<DexApproveErrorCode>;
+declare const isDexApproveError: (e: unknown) => e is SodaxError<ApproveErrorCode>;
 
-export { ALLOWANCE_CHECK_CODES, APPROVE_CODES, type AggregatedReserveData, type AllowanceCheckErrorCode, type AllowanceInfo, type AllowanceResponse, type AllowanceTransferDetails, type ApiResponse, type ApproveErrorCode, type ApproveSonicWithdrawParams, 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, type BitcoinSpokeDepositParams, BitcoinSpokeService, type BitcoinTransactionResult, type BitcoinTransferToHubParams, 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 IconCallParams, type IconJsonRpcVersion, type IconSpokeDepositParams, IconSpokeService, type IconTransferToHubParams, 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, NearSpokeService, type OnDemandBtcPayload, 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, type SolanaSpokeDepositParams, SolanaSpokeService, type SolanaTransferToHubParams, SolverApiService, type SonicDepositParams, type SonicSpokeDepositParams, 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, type StellarSpokeDepositParams, StellarSpokeService, type StellarTransferToHubParams, type SubmitTxParams, type SubmitTxResponse, type SuiNativeCoinResult, SuiSpokeService, type SuiTxObject, 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, calculateAllReserveIncentives, calculateAllUserIncentives, calculateAvailableBorrowsMarketReferenceCurrency, calculateCompoundedInterest, calculateCompoundedRate, calculateFeeAmount, calculateHealthFactorFromBalances, calculateHealthFactorFromBalancesBigUnits, calculateLinearInterest, calculatePercentageFeeAmount, clPoolAbi, clPoolManagerAbi, clPositionManagerAbi, clQuoterAbi, clRouterAbi, clTickLensAbi, connectionAbi, 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, messageOf, migrationInvariant, mintPositionParamsAbi, mmInvariant, modifyLiquidityParamsAbi, nativeToUSD, normalize, normalizeBN, normalizePsbtToBase64, normalizedToUsd, pancakeSwapInfinityDefaultHookAbi, pancakeSwapInfinityPoolManagerAbi, pancakeSwapInfinityPositionManagerAbi, parseToStroops, parseTokenArrayFromJson, partnerInvariant, permit2Abi, poolAbi, poolKeyAbi, randomUint256, rayDiv, rayMul, rayPow, rayToWad, recoveryInvariant, relayTxAndWaitPacket, requestAddress, requestJsonRpc, requestSigning, retry, reverseEncodeAddress, serializeAddressData, 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 AnalyticsActionData, 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, type BitcoinBoundExtras, 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 DexApproveError, type DexApproveErrorCode, type DexCreateIntentError, type DexCreateIntentErrorCode, 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 GetUserIntentParams, type GetUserRouterParams, HALF_RAY, HALF_WAD, type HanaWalletRequestEvent, type HanaWalletResponseEvent, type HookRequest, HookService, 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, IntentDataService, 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, type PartnerFeeClaimCancelAction, type PartnerFeeClaimCancelParams, 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 RadfiResponseEnvelope, 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 ResolvedAnalytics, 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 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, SwapsApiService, 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, isDexApproveError, isDexCreateIntentError, 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, isSuiChainKeyType, isSwapCreateIntentError, isSwapError, isUndefinedOrValidWalletProviderForChainKey, isUnifiedBnUSDMigrateParams, leverageYieldInvariant, lookupFailed, mapRelayFailure, mergeSodaxConfig, messageOf, migrationInvariant, mintPositionParamsAbi, mmInvariant, modifyLiquidityParamsAbi, nativeToUSD, noopAnalytics, normalize, normalizeBN, normalizePsbtToBase64, normalizeSignatureToBase64, normalizedToUsd, pancakeSwapInfinityDefaultHookAbi, pancakeSwapInfinityPoolManagerAbi, pancakeSwapInfinityPositionManagerAbi, parseToStroops, parseTokenArrayFromJson, partnerInvariant, permit2Abi, poolAbi, poolKeyAbi, randomUint256, rayDiv, rayMul, rayPow, rayToWad, recoveryInvariant, relayTxAndWaitPacket, requestAddress, requestJsonRpc, requestSigning, resolveAnalytics, 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 };