@sodax/sdk 2.0.0-rc.17 → 2.0.0-rc.19

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { IConfigApi, ApiConfig, SodaxLogger, Result, SubmitSwapTxRequest, SubmitSwapTxResponse, GetSubmitSwapTxStatusParams, SubmitSwapTxStatusResponse, Address, GetAllConfigApiResponse, GetChainsApiResponse, GetSwapTokensApiResponse, SpokeChainKey, GetSwapTokensByChainIdApiResponse, GetMoneyMarketTokensApiResponse, GetMoneyMarketReserveAssetsApiResponse, GetMoneyMarketTokensByChainIdApiResponse, GetRelayChainIdMapApiResponse, GetSpokeChainConfigApiResponse, PartnerFee, SodaxConfig, SodaxOptions, XToken, OriginalAssetAddress, IntentRelayChainId, HubChainKey, HubConfig, PoolKey, SpokeChainConfig, RelayConfig, SolverConfig, SwapsConfig, BridgeConfig, MoneyMarketConfig, LeverageYieldConfig, DexConfig, GetSpokeChainConfigType, SodaxDefaultConfig, EvmContractCall, Hex, IEvmWalletProvider, EvmRawTransactionReceipt, QuoteType, EvmChainKey, DeepPartial, WalletProviderSlot, TxReturnType, ChainType, GetChainType, SolanaRawTransactionReceipt, StellarSorobanTransactionReceipt, IconTransactionResult, SuiRawTransactionReceipt, InjectiveRawTransactionReceipt, NearRawTransactionReceipt, StacksRawTransactionReceipt, BitcoinRawTransactionReceipt, GetAddressType, HubAddress, GetTokenAddressType, EvmSpokeOnlyChainKey, StellarChainKey, HookKind, SonicChainKey, AssetInfo, TokenInfo, VaultReserves, StacksChainKey, FeeEstimateTransaction, StacksTransactionParams, HttpUrl, RadfiConfig, IBitcoinWalletProvider, RadfiDepositTxResponse, BtcAddressType, BitcoinChainKey, NearChainKey, FillData, NearRawTransaction, INearWalletProvider, SuiPaginatedCoins, SuiChainKey, SuiExecutionResult, SuiGasEstimate, IStellarWalletProvider, StellarGasEstimate, SolanaChainKey, SolanaGasEstimate, SolanaBase58PublicKey, SolanaRawTransactionInstruction, SolanaSerializedTransaction, SolanaRpcResponseAndContext, SolanaTokenAmount, IconChainKey, IconGasEstimate, InjectiveChainKey, InjectiveGasEstimate, JsonObject, InjectiveCoin, InjectiveRawTransaction, IInjectiveWalletProvider, InjectiveExecuteResponse, GetEstimateGasReturnType, IconAddress, IWalletProvider, EvmSpokeChainConfig, PartnerFeeAmount, PartnerFeePercentage, GetWalletProviderType, SodaxLoggerOption, SpokeExecActionParams, FeeAmount, Hash as Hash$1, SolverIntentQuoteRequest, SolverIntentQuoteResponse, SolverErrorResponse, SolverIntentStatusRequest, SolverIntentStatusResponse, SolverExecutionRequest, SolverExecutionResponse, IconEoaAddress, IcxTokenType, IconContractAddress, BridgeLimit, UserUnstakeInfo, ConcentratedLiquidityConfig, LeverageYieldVault } from '@sodax/types';
+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 { StacksNetwork, ClarityValue } from '@sodax/libs/stacks/core';
@@ -30,6 +31,7 @@ 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?".
@@ -53,16 +55,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' | 'leverageYield';
+
 /**
  * Orchestration phase tag attached via `context.phase`. Canonical superset across all
  * features — all features draw from this list rather than minting their own.
@@ -108,7 +106,7 @@ type SodaxErrorContext = {
     srcChainKey?: string;
     dstChainKey?: string;
     relayCode?: RelayCode;
-    api?: 'solver' | 'backend';
+    api?: 'solver' | 'backend' | 'swaps';
     method?: string;
     direction?: 'forward' | 'reverse';
     field?: string;
@@ -133,7 +131,7 @@ declare const LOOKUP_CODES: ReadonlySet<LookupErrorCode>;
 /** Runtime list of all valid error codes — useful for membership checks and exhaustive switches. */
 declare const SODAX_ERROR_CODES: readonly ["VALIDATION_FAILED", "INTENT_CREATION_FAILED", "EXECUTION_FAILED", "TX_VERIFICATION_FAILED", "TX_SUBMIT_FAILED", "RELAY_TIMEOUT", "RELAY_FAILED", "APPROVE_FAILED", "ALLOWANCE_CHECK_FAILED", "GAS_ESTIMATION_FAILED", "LOOKUP_FAILED", "EXTERNAL_API_ERROR", "UNKNOWN"];
 /** Runtime list of all valid feature tags. */
-declare const SODAX_FEATURES: readonly ["swap", "moneyMarket", "bridge", "staking", "migration", "dex", "partner", "recovery", "leverageYield"];
+declare const SODAX_FEATURES: readonly ["swap", "moneyMarket", "bridge", "staking", "migration", "dex", "partner", "recovery", "backend", "leverageYield"];
 
 /**
  * Canonical error type for the SODAX SDK.
@@ -4851,6 +4849,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 +7488,195 @@ 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/*`).
+ *
+ * Mirrors every endpoint of {@link ISwapsApiV2} (one method per route) and
+ * validates each response at runtime with a valibot schema (see
+ * `swapsApiSchemas.ts`). On a contract drift, the response is rejected as
+ * `{ ok: false }` with a descriptive error rather than returned untyped.
+ *
+ * All public methods return `Promise<Result<T>>` — they never throw. 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'`)
+ * 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`.
+ *
+ * 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);
+    /**
+     * Issues a single HTTP request, validates the JSON body against `schema`, and
+     * wraps the result in `Result<T>`. The service-level `baseURL`/`timeout`/
+     * `headers` are merged with the optional per-call `overrideConfig` (which takes
+     * precedence) inside {@link makeRequest}. Every public method delegates here.
+     */
+    private request;
+    /**
+     * Fetch all supported swap tokens grouped by SpokeChainKey.
+     *
+     * @returns `Result<GetSwapTokensResponseV2>` — map of chain key → token list.
+     */
+    getTokens(config?: RequestOverrideConfig): Promise<Result<GetSwapTokensResponseV2>>;
+    /**
+     * Fetch supported swap tokens for a single SpokeChainKey.
+     *
+     * @param chainKey - SODAX SpokeChainKey (e.g. `0xa4b1.arbitrum`, `solana`).
+     * @returns `Result<GetSwapTokensByChainResponseV2>` — token list for the chain.
+     */
+    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`) using the quoted amount as `minOutputAmount`; in that
+     * case `srcAddress`/`dstAddress` are required in the body.
+     *
+     * @returns `Result<QuoteResponseV2>` — `quotedAmount` (decimal string) and optional `txData`.
+     */
+    getQuote(body: QuoteRequestV2, query?: QuoteQueryV2, config?: RequestOverrideConfig): Promise<Result<QuoteResponseV2>>;
+    /**
+     * Compute a swap deadline (hub timestamp + `offsetSeconds`, default 300s).
+     *
+     * @returns `Result<DeadlineResponseV2>` — unix-seconds deadline (decimal string).
+     */
+    getDeadline(query?: DeadlineQueryV2, config?: RequestOverrideConfig): Promise<Result<DeadlineResponseV2>>;
+    /**
+     * Check whether the source token allowance is already sufficient for the intent.
+     *
+     * @returns `Result<AllowanceCheckResponseV2>` — `{ valid }`.
+     */
+    checkAllowance(body: CreateIntentParamsV2, config?: RequestOverrideConfig): Promise<Result<AllowanceCheckResponseV2>>;
+    /**
+     * Build an unsigned token-approval transaction for the source token.
+     *
+     * @returns `Result<ApproveResponseV2>` — `{ tx }` (chain-specific unsigned tx).
+     */
+    approve(body: CreateIntentParamsV2, config?: RequestOverrideConfig): Promise<Result<ApproveResponseV2>>;
+    /**
+     * Build an unsigned create-intent transaction.
+     *
+     * @returns `Result<CreateIntentResponseV2>` — `{ tx, intent, relayData }`.
+     */
+    createIntent(body: CreateIntentParamsV2, config?: RequestOverrideConfig): Promise<Result<CreateIntentResponseV2>>;
+    /**
+     * Submit the broadcast intent tx to the relay.
+     *
+     * @returns `Result<SubmitIntentResponseV2>` — `{ result }` (opaque relay response).
+     */
+    submitIntent(body: SubmitIntentRequestV2, config?: RequestOverrideConfig): Promise<Result<SubmitIntentResponseV2>>;
+    /**
+     * Poll the solver for intent execution status.
+     *
+     * @returns `Result<StatusResponseV2>` — `{ status, fillTxHash? }` (`fillTxHash` set when `status === 3`).
+     */
+    getStatus(body: StatusRequestV2, config?: RequestOverrideConfig): Promise<Result<StatusResponseV2>>;
+    /**
+     * Build an unsigned cancel-intent transaction. The `intent` field carries
+     * `bigint` numerics — {@link toJsonBody} serializes them to decimal strings.
+     *
+     * @returns `Result<CancelIntentResponseV2>` — `{ tx }`.
+     */
+    cancelIntent(body: CancelIntentRequestV2, config?: RequestOverrideConfig): Promise<Result<CancelIntentResponseV2>>;
+    /**
+     * Compute the keccak256 hash of an Intent struct. The `intent` field carries
+     * `bigint` numerics — {@link toJsonBody} serializes them to decimal strings.
+     *
+     * @returns `Result<IntentHashResponseV2>` — `{ hash }`.
+     */
+    getIntentHash(body: IntentHashRequestV2, config?: RequestOverrideConfig): Promise<Result<IntentHashResponseV2>>;
+    /**
+     * Long-poll the relayer until the fill packet lands on the destination chain.
+     *
+     * @returns `Result<IntentPacketResponseV2>` — delivered packet data.
+     */
+    getSolvedIntentPacket(body: IntentPacketRequestV2, config?: RequestOverrideConfig): Promise<Result<IntentPacketResponseV2>>;
+    /**
+     * Recover the relay extra data needed by `/swaps/intents/submit`. Provide
+     * EITHER `txHash` OR `intent` (whose `bigint` numerics {@link toJsonBody} serializes).
+     *
+     * @returns `Result<IntentExtraDataResponseV2>` — `{ address, payload }`.
+     */
+    getIntentSubmitTxExtraData(body: IntentExtraDataRequestV2, config?: RequestOverrideConfig): Promise<Result<IntentExtraDataResponseV2>>;
+    /**
+     * Get the on-chain fill state for an intent by its hub-chain tx hash.
+     *
+     * @returns `Result<IntentStateV2>` — `{ exists, remainingInput, receivedOutput, pendingPayment }`.
+     */
+    getFilledIntent(txHash: string, config?: RequestOverrideConfig): Promise<Result<IntentStateV2>>;
+    /**
+     * Look up an Intent struct by its hub-chain creation tx hash.
+     *
+     * @returns `Result<GetIntentResponseV2>` — the decoded intent (bigint fields as decimal strings).
+     */
+    getIntent(txHash: string, config?: RequestOverrideConfig): Promise<Result<GetIntentResponseV2>>;
+    /**
+     * Build an unsigned create-limit-order-intent transaction (same as create-intent
+     * but `deadline` is optional).
+     *
+     * @returns `Result<CreateLimitOrderResponseV2>` — `{ tx, intent, relayData }`.
+     */
+    createLimitOrderIntent(body: CreateLimitOrderParamsV2, config?: RequestOverrideConfig): Promise<Result<CreateLimitOrderResponseV2>>;
+    /**
+     * Estimate gas for a raw transaction on a spoke chain.
+     *
+     * @returns `Result<GasEstimateResponseV2>` — `{ gas }` (chain-specific shape).
+     */
+    estimateGas(body: GasEstimateRequestV2, config?: RequestOverrideConfig): Promise<Result<GasEstimateResponseV2>>;
+    /**
+     * Compute the partner fee for a given input amount.
+     *
+     * @returns `Result<FeeResponseV2>` — `{ fee }` (decimal string).
+     */
+    getPartnerFee(query: FeeQueryV2, config?: RequestOverrideConfig): Promise<Result<FeeResponseV2>>;
+    /**
+     * Compute the protocol (solver) fee for a given input amount.
+     *
+     * @returns `Result<FeeResponseV2>` — `{ fee }` (decimal string).
+     */
+    getSolverFee(query: FeeQueryV2, config?: RequestOverrideConfig): Promise<Result<FeeResponseV2>>;
+    /**
+     * Submit a swap transaction to be processed (relay, post-execution, etc.). The
+     * `intent` field carries `bigint` numerics — {@link toJsonBody} serializes them.
+     * Idempotent on `(txHash, srcChainKey)`.
+     *
+     * @returns `Result<SubmitTxResponseV2>` — `{ success, data: { status, message } }`.
+     */
+    submitTx(body: SubmitTxRequestV2, config?: RequestOverrideConfig): Promise<Result<SubmitTxResponseV2>>;
+    /**
+     * Get the processing status of a submitted swap transaction by `(txHash, srcChainKey)`.
+     *
+     * @returns `Result<SubmitTxStatusResponseV2>` — `{ success, data }` (processing state).
+     */
+    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.
+     */
+    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 +7688,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,37 +7810,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;
     private readonly logger;
     constructor(config: ApiConfig, logger?: SodaxLogger);
-    /**
-     * 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;
     /**
      * 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.
      *
@@ -7565,34 +7876,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.
@@ -7798,6 +8081,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;
@@ -7809,6 +8096,59 @@ 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;
@@ -7823,6 +8163,11 @@ type ConfigServiceConstructorParams = {
      * 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
@@ -7835,13 +8180,17 @@ type ConfigServiceConstructorParams = {
  */
 declare class ConfigService {
     private sodax;
-    private readonly api;
-    private readonly userConfig?;
     /**
      * 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
@@ -7858,7 +8207,7 @@ declare class ConfigService {
     private stakedATokenAddressesSet;
     private chainToSupportedTokenAddressMap;
     private hubAssetToXTokenMap;
-    constructor({ api, config, userConfig, logger, fee }: ConfigServiceConstructorParams);
+    constructor({ api, config, userConfig, logger, analytics, fee }: ConfigServiceConstructorParams);
     initialize(): Promise<Result<void>>;
     getChains(): GetChainsApiResponse;
     getSwapTokens(): GetSwapTokensApiResponse;
@@ -7869,6 +8218,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;
     /**
@@ -9188,6 +9545,26 @@ declare class BitcoinSpokeService {
      * Deposit operation - transfer BTC to the asset manager
      */
     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<string>;
     /**
      * Build deposit PSBT with embedded cross-chain data
      */
@@ -9859,6 +10236,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.
@@ -11734,8 +12113,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;
@@ -11818,6 +12195,9 @@ 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.
@@ -11842,7 +12222,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.
      *
@@ -11936,14 +12318,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.
@@ -11964,6 +12354,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 `executed`, 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.
      *
@@ -13060,6 +13473,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.
      *
@@ -15839,6 +16262,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;
@@ -15973,6 +16408,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.
@@ -16003,10 +16443,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 = {
@@ -16616,6 +17105,7 @@ declare class Sodax {
     readonly moneyMarket: MoneyMarketService;
     readonly migration: MigrationService;
     readonly backendApi: BackendApiService;
+    readonly api: BackendApiService;
     readonly bridge: BridgeService;
     readonly staking: StakingService;
     readonly partners: PartnerService;
@@ -17266,4 +17756,4 @@ type DexErrorCode = LookupErrorCode;
 type DexError = SodaxError<DexErrorCode>;
 declare const isDexError: (e: unknown) => e is SodaxError<LookupErrorCode>;
 
-export { ALLOWANCE_CHECK_CODES, APPROVE_CODES, type AggregatedReserveData, type AllowanceCheckErrorCode, type AllowanceInfo, type AllowanceResponse, type AllowanceTransferDetails, type ApiResponse, type ApproveErrorCode, type ApyRange, type AssetDepositAction, type AssetEntry, AssetService, type AssetServiceConstructorParams, type AssetWithdrawAction, type AutoSwapPreferences, BackendApiService, type BalnLockParams, type BalnMigrateAction, type BalnMigrateParams, type BalnSwapAbi, BalnSwapService, type BalnSwapServiceConstructorParams, type BaseCurrencyInfo, BigIntToHex, type BigNumberValue, BigNumberZeroDecimal, 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 DexError, type DexErrorCode, DexService, type DexServiceConstructorParams, type EModeCategory, type EModeCategoryHumanized, type EModeData, type EModeDataString, type EmodeDataHumanized, type EnrichedToken, type Erc20ApproveParams, type Erc20IsAllowanceParams, Erc20Service, type Erc20Token, Erc4626Service, type EstimateGasParams, EvmAssetManagerService, type EvmDepositToDataParams, EvmHubProvider, type EvmHubProviderConstructorParams, EvmSolverService, EvmSpokeService, EvmVaultTokenService, type EvmWithdrawAssetDataParams, type ExecuteMsg, type FeatureInvariant, type FeeData, type FeeTokenApproveAction, type FeeTokenApproveParams, type FetchHubAssetBalancesParams, type FormatReserveRequest, type FormatReserveResponse, type FormatReserveUSDRequest, type FormatReserveUSDResponse, type FormatReservesAndIncentivesUSDRequest, type FormatReservesUSDRequest, type FormatUserSummaryAndIncentivesRequest, type FormatUserSummaryAndIncentivesResponse, type FormatUserSummaryRequest, type FormatUserSummaryResponse, type FormattedReserveEMode, GAS_ESTIMATION_CODES, type GasEstimationErrorCode, type GetDepositParams, type GetIntentSubmitTxExtraDataParams, type GetPacketParams, type GetPacketResponse, type GetQuoteParams, type GetRelayRequestParamType, type GetRelayResponse, type GetSpokeServiceType, type GetTransactionPacketsParams, type GetTransactionPacketsResponse, type GetTxReceiptType, type GetUserRouterParams, HALF_RAY, HALF_WAD, type HanaWalletRequestEvent, type HanaWalletResponseEvent, 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, 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 ResponseAddressType, type ResponseSigningType, type RevertMigrationOrchestrationError, type RevertMigrationOrchestrationErrorCode, type RewardInfoHumanized, SECONDS_PER_YEAR, SODAX_ERROR_CODES, SODAX_FEATURES, type SendMessageParams, type SetSwapPreferenceAction, type SetSwapPreferenceParams, Sodax, SodaxError, type SodaxErrorCode, type SodaxErrorContext, type SodaxErrorJSON, type SodaxFeature, type SodaxPhase, SolanaSpokeService, SolverApiService, SonicSpokeService, type SpokeApproveParams, type SpokeApproveParamsEvmSpoke, type SpokeApproveParamsHub, type SpokeApproveParamsStellar, type SpokeIsAllowanceValidParams, type SpokeIsAllowanceValidParamsEvmSpoke, type SpokeIsAllowanceValidParamsHub, type SpokeIsAllowanceValidParamsOther, type SpokeIsAllowanceValidParamsStellar, SpokeService, type SpokeServiceConstructorParams, type SpokeServiceType, StacksSpokeService, type StakeAction, type StakeOrchestrationError, type StakeOrchestrationErrorCode, type StakeParams, type StakingActionType, type StakingActionUnion, type StakingAllowanceCheckError, type StakingAllowanceCheckErrorCode, type StakingApproveError, type StakingApproveErrorCode, type StakingConfig, type StakingCreateIntentError, type StakingCreateIntentErrorCode, type StakingError, type StakingErrorCode, type StakingInfo, type StakingInfoFetchError, type StakingInfoFetchErrorCode, StakingLogic, type StakingOrchestrationError, type StakingOrchestrationErrorCode, type StakingParamsUnion, StakingService, type StakingServiceConstructorParams, type State, StellarSpokeService, type SubmitTxParams, type SubmitTxResponse, SuiSpokeService, SupportedMigrationTokens, type SwapAction, type SwapActionParams, type SwapCreateIntentError, type SwapCreateIntentErrorCode, type SwapError, type SwapErrorCode, type SwapExtras, type SwapResponse, SwapService, type SwapServiceConstructorParams, type TokenSpenderPair, type TokenWithConversion, type TxHashPair, type TxStatus, USD_DECIMALS, type UiPoolDataProviderInterface, UiPoolDataProviderService, type UiPoolDataProviderServiceConstructorParams, type UnifiedBnUSDMigrateAction, type UnifiedBnUSDMigrateParams, type UnstakeAction, type UnstakeParams, type UnstakeRequest, type UnstakeRequestWithPenalty, type UnstakingInfo, type UserIncentiveData, type UserIncentiveDataHumanized, type UserIncentiveDict, type UserIntentsResponse, type UserReserveCalculationData, type UserReserveData, type UserReserveDataHumanized, type UserReserveDataString, type UserReservesIncentivesDataHumanized, type UserRewardInfoHumanized, type VaultSwapActionParams, type VaultSwapResponse, type VerifySimulationParams, type VerifyTxHashParams, WAD, WAD_RAY_RATIO, WEI_DECIMALS, type WaitForTxReceiptParams, type WaitForTxReceiptReturnType, type WaitUntilIntentExecutedPayload, type WalletMode, type WalletSimulationParams, type WithdrawHubAssetAction, type WithdrawHubAssetParams, type WithdrawInfo, adjustAmountByFee, allowanceCheckFailed, approveFailed, assetManagerAbi, balnSwapAbi, binomialApproximatedRayPow, bridgeInvariant, calcOpReturnOutputVbytes, calculateAllReserveIncentives, calculateAllUserIncentives, calculateAvailableBorrowsMarketReferenceCurrency, calculateCompoundedInterest, calculateCompoundedRate, calculateFeeAmount, calculateHealthFactorFromBalances, calculateHealthFactorFromBalancesBigUnits, calculateLinearInterest, calculatePercentageFeeAmount, clPoolAbi, clPoolManagerAbi, clPositionManagerAbi, clQuoterAbi, clRouterAbi, clTickLensAbi, connectionAbi, consoleLogger, convertTransactionInstructionToRaw, createInvariant, deepMerge, defaultHookAbi, dexInvariant, encodeAddress, encodeBtcPayloadToBytes, encodeContractCalls, erc20Abi, erc4626Abi, estimateBitcoinTxSize, executionFailed, formatBasisPoints, formatEModeCategory, formatEModes, formatPercentage, formatReserve, formatReserveUSD, formatReserves, formatReservesAndIncentives, formatUserSummary, formatUserSummaryAndIncentives, gasEstimationFailed, getAndFormatReserveEModes, getAssetManagerIdl, getAssetManagerProgram, getCompoundedBalance, getConnectionIdl, getConnectionProgram, getEvmViemChain, getIconAddressBytes, getLinearBalance, getMarketReferenceCurrencyAndUsdBalance, getPacket, getProvider, getRandomBytes, getReserveNormalizedIncome, getReservesEModes, getSolanaAddressBytes, getTransactionPackets, hexToBigInt, hexToSolanaAddress, hyper, intentCreationFailed, isBalnMigrateParams, isBitcoinChainKeyType, isBitcoinWalletProviderType, isBridgeAllowanceCheckError, isBridgeApproveError, isBridgeCreateIntentError, isBridgeError, isBridgeLookupError, isBridgeOrchestrationError, isCodeMember, isDexError, isEvmChainKeyType, isEvmSpokeChainConfig, isEvmSpokeOnlyChainKeyType, isEvmWalletProviderType, isFeatureError, isHubChainKeyType, isIconAddress, isIconChainKeyType, isIcxCreateRevertMigrationParams, isIcxMigrateParams, isInjectiveChainKeyType, isJsonRpcPayloadResponse, isLeverageYieldAllowanceCheckError, isLeverageYieldApproveError, isLeverageYieldCreateIntentError, isLeverageYieldError, isLeverageYieldLookupError, isLeverageYieldPostExecutionError, isLeverageYieldSwapError, isMigrateOrchestrationError, isMigrationAllowanceCheckError, isMigrationApproveError, isMigrationCreateIntentError, isMigrationError, isMigrationLookupError, isMoneyMarketAllowanceCheckError, isMoneyMarketApproveError, isMoneyMarketCreateIntentError, isMoneyMarketError, isMoneyMarketGasEstimationError, isMoneyMarketOrchestrationError, isNearChainKeyType, isOptionalBitcoinWalletProviderType, isOptionalEvmWalletProviderType, isOptionalStellarWalletProviderType, isPartnerError, isPartnerFeeAmount, isPartnerFeePercentage, isPostExecutionError, isRawDestinationParams, isRecoveryError, isResponseAddressType, isResponseSigningType, isRevertMigrationOrchestrationError, isSodaxError, isSolanaChainKeyType, isSolanaNativeToken, isSonicChainKeyType, isSpokeApproveParamsEvmSpoke, isSpokeApproveParamsHub, isSpokeApproveParamsStellar, isSpokeIsAllowanceValidParamsEvmSpoke, isSpokeIsAllowanceValidParamsHub, isSpokeIsAllowanceValidParamsStellar, isStacksChainKeyType, isStakeOrchestrationError, isStakingAllowanceCheckError, isStakingApproveError, isStakingCreateIntentError, isStakingError, isStakingInfoFetchError, isStakingOrchestrationError, isStellarChainKeyType, isStellarWalletProviderType, isSubmitSwapTxResponse, isSubmitSwapTxStatusResponse, isSuiChainKeyType, isSwapCreateIntentError, isSwapError, isUndefinedOrValidWalletProviderForChainKey, isUnifiedBnUSDMigrateParams, leverageYieldInvariant, lookupFailed, mapRelayFailure, mergeSodaxConfig, messageOf, migrationInvariant, mintPositionParamsAbi, mmInvariant, modifyLiquidityParamsAbi, nativeToUSD, normalize, normalizeBN, normalizePsbtToBase64, normalizeSignatureToBase64, normalizedToUsd, pancakeSwapInfinityDefaultHookAbi, pancakeSwapInfinityPoolManagerAbi, pancakeSwapInfinityPositionManagerAbi, parseToStroops, parseTokenArrayFromJson, partnerInvariant, permit2Abi, poolAbi, poolKeyAbi, randomUint256, rayDiv, rayMul, rayPow, rayToWad, recoveryInvariant, relayTxAndWaitPacket, requestAddress, requestJsonRpc, requestSigning, resolveLogger, retry, reverseEncodeAddress, serializeAddressData, silentLogger, sleep, sodaxInvariant, sonicWalletFactoryAbi, spokeAssetManagerAbi, stakedSodaAbi, stakingInvariant, stakingRouterAbi, stataTokenFactoryAbi, submitTransaction, swapExactInSingleParamsAbi, swapInvariant, uiPoolDataAbi, universalRouterAbi, unknownFailed, valueToBigNumber, valueToZDBigNumber, variableDebtTokenAbi, vaultTokenAbi, verifyFailed, wadToRay, waitForStacksTransaction, waitForTransactionReceipt, waitUntilIntentExecuted, walletFactoryAbi, wrappedSonicAbi };
+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 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, 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 };