@sodax/dapp-kit 2.0.0-rc.12 → 2.0.0-rc.13

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { UseMutationOptions, UseQueryOptions, UseMutationResult, MutateOptions, UseQueryResult, QueryClientConfig, QueryClient } from '@tanstack/react-query';
-import { Result, Sodax, SpokeChainKey, GetEstimateGasReturnType, EstimateGasParams, IStellarWalletProvider, StellarChainKey, INearWalletProvider, GetWalletProviderType, IXServiceBase, XToken, EvmHubProvider, IBitcoinWalletProvider, RadfiWalletBalance, RadfiUtxo, MoneyMarketBorrowActionParams, TxHashPair, MoneyMarketRepayActionParams, MoneyMarketSupplyActionParams, MoneyMarketWithdrawActionParams, UserReserveData, AggregatedReserveData, BaseCurrencyInfo, ReservesDataHumanized, Address as Address$1, MoneyMarketParams, MoneyMarketApproveActionParams, TxReturnType, Erc20Token, ChainKey, ReserveDataHumanized, FormatReserveUSDResponse, FormatUserSummaryResponse, SolverIntentQuoteResponse, SolverErrorResponse, SolverIntentQuoteRequest, SwapActionParams, SwapResponse, SolverIntentStatusResponse, Hex, CreateIntentParams, CreateLimitOrderParams, Intent, LimitOrderActionParams, IntentResponse, UserIntentsResponse, SubmitSwapTxResponse, SubmitSwapTxRequest, RequestOverrideConfig, SubmitSwapTxStatusResponse, OrderbookResponse, MoneyMarketPosition, MoneyMarketAsset, MoneyMarketAssetBorrowers, MoneyMarketAssetSuppliers, MoneyMarketBorrowers, BridgeParams, CreateBridgeIntentParams, BridgeLimit, StakeAction, StakeParams, UnstakeAction, ClaimAction, CancelUnstakeAction, StakingInfo, UnstakingInfo, UnstakeRequestWithPenalty, StakingConfig, InstantUnstakeAction, UnstakeParams, InstantUnstakeParams, PartnerFeeClaimAssetBalance, AutoSwapPreferences, FeeTokenApproveParams, FeeTokenApproveAction, HubChainKey, SetSwapPreferenceAction, PartnerFeeClaimSwapAction, IntentAutoSwapResult, HubAssetBalance, WithdrawHubAssetAction, IcxMigrateAction, IcxRevertMigrationAction, UnifiedBnUSDMigrateAction, BalnMigrateAction, MigrationAction, IcxMigrateParams, IcxCreateRevertMigrationParams, UnifiedBnUSDMigrateParams, BalnMigrateParams, PoolKey, PoolData, ClPositionInfo, AssetDepositAction, AssetWithdrawAction, CreateAssetDepositParams, ClSupplyParams, ClIncreaseLiquidityParams, ClLiquidityDecreaseLiquidityAction, ClDecreaseLiquidityParams, CreateAssetWithdrawParams, PoolSpokeAssets, DestinationParamsType, ClLiquidityClaimRewardsAction, SodaxOptions } from '@sodax/sdk';
+import { Result, Sodax, SpokeChainKey, GetEstimateGasReturnType, EstimateGasParams, IStellarWalletProvider, StellarChainKey, INearWalletProvider, GetWalletProviderType, IXServiceBase, XToken, EvmHubProvider, IBitcoinWalletProvider, RadfiWalletBalance, RadfiUtxo, MoneyMarketBorrowActionParams, TxHashPair, MoneyMarketRepayActionParams, MoneyMarketSupplyActionParams, MoneyMarketWithdrawActionParams, UserReserveData, AggregatedReserveData, BaseCurrencyInfo, ReservesDataHumanized, Address as Address$1, MoneyMarketParams, MoneyMarketApproveActionParams, TxReturnType, Erc20Token, ChainKey, ReserveDataHumanized, FormatReserveUSDResponse, FormatUserSummaryResponse, SolverIntentQuoteResponse, SolverErrorResponse, SolverIntentQuoteRequest, SwapActionParams, SwapResponse, SolverIntentStatusResponse, Hex, CreateIntentParams, CreateLimitOrderParams, Intent, LimitOrderActionParams, IntentResponse, UserIntentsResponse, SubmitSwapTxResponse, SubmitSwapTxRequest, RequestOverrideConfig, SubmitSwapTxStatusResponse, OrderbookResponse, MoneyMarketPosition, MoneyMarketAsset, MoneyMarketAssetBorrowers, MoneyMarketAssetSuppliers, MoneyMarketBorrowers, BridgeParams, CreateBridgeIntentParams, BridgeLimit, StakeAction, StakeParams, UnstakeAction, ClaimAction, CancelUnstakeAction, StakingInfo, UnstakingInfo, UnstakeRequestWithPenalty, StakingConfig, InstantUnstakeAction, UnstakeParams, InstantUnstakeParams, PartnerFeeClaimAssetBalance, AutoSwapPreferences, FeeTokenApproveParams, FeeTokenApproveAction, HubChainKey, SetSwapPreferenceAction, PartnerFeeClaimSwapAction, IntentAutoSwapResult, HubAssetBalance, WithdrawHubAssetAction, IcxMigrateAction, IcxRevertMigrationAction, UnifiedBnUSDMigrateAction, BalnMigrateAction, MigrationAction, IcxMigrateParams, IcxCreateRevertMigrationParams, UnifiedBnUSDMigrateParams, BalnMigrateParams, PoolKey, PoolData, ClPositionInfo, AssetDepositAction, AssetWithdrawAction, CreateAssetDepositParams, ClSupplyParams, ClIncreaseLiquidityParams, ClLiquidityDecreaseLiquidityAction, ClDecreaseLiquidityParams, CreateAssetWithdrawParams, PoolSpokeAssets, DestinationParamsType, ClLiquidityClaimRewardsAction, LeverageYieldEffectiveApr, LeverageYieldPosition, LeverageYieldSwapDepositParams, LeverageYieldSwapPayload, SolverExecutionRequest, SolverExecutionResponse, VaultSwapActionParams, VaultSwapResponse, LeverageYieldSwapWithdrawParams, SodaxOptions } from '@sodax/sdk';
 export * from '@sodax/sdk';
 import { Address } from 'viem';
 import { ReactNode, ReactElement } from 'react';
@@ -1541,6 +1541,188 @@ type UseClaimRewardsVars<K extends SpokeChainKey = SpokeChainKey> = Omit<ClLiqui
  */
 declare function useClaimRewards<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseClaimRewardsVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseClaimRewardsVars<K>>;
 
+type UseLeverageYieldEffectiveAprParams = ReadHookParams<LeverageYieldEffectiveApr, {
+    vault: Address$1 | undefined;
+}>;
+/**
+ * Reads a leverage-yield vault's effective APR — AAVE supply/borrow rates plus the LSD
+ * staking yield, with the vault's leverage formula re-applied on the boosted supply side.
+ *
+ * The underlying SDK call does the on-chain reads (AAVE rates + `targetLTV`) and the
+ * off-chain LSD fetch in parallel. Rates drift slowly, so the default refresh is 60s.
+ *
+ * @example
+ * ```typescript
+ * const { data: apr } = useLeverageYieldEffectiveApr({ params: { vault: vault.vault } });
+ * ```
+ */
+declare function useLeverageYieldEffectiveApr({ params, queryOptions, }?: UseLeverageYieldEffectiveAprParams): UseQueryResult<LeverageYieldEffectiveApr, Error>;
+
+type UseLeverageYieldPositionParams = ReadHookParams<LeverageYieldPosition, {
+    vault: Address$1 | undefined;
+}>;
+/**
+ * Reads a leverage-yield vault's live position snapshot via the vault's `getPositionDetails`:
+ * collateral, debt, current LTV (drift vs `targetLTV`), health factor (∞ when no debt), and
+ * idle (not-yet-deployed) asset.
+ *
+ * LTV shifts with each rebalance/rate tick, so the default refresh (30s) is faster than the
+ * APR/stats reads.
+ *
+ * @example
+ * ```typescript
+ * const { data: position } = useLeverageYieldPosition({ params: { vault: vault.vault } });
+ * ```
+ */
+declare function useLeverageYieldPosition({ params, queryOptions, }?: UseLeverageYieldPositionParams): UseQueryResult<LeverageYieldPosition, Error>;
+
+type UseLeverageYieldTotalAssetsParams = ReadHookParams<bigint, {
+    vault: Address$1 | undefined;
+}>;
+/**
+ * Reads a leverage-yield vault's total underlying assets (vault-asset units, 18 decimals) —
+ * i.e. its TVL. Moves slowly, so the default refresh is 60s.
+ *
+ * @example
+ * ```typescript
+ * const { data: tvl } = useLeverageYieldTotalAssets({ params: { vault: vault.vault } });
+ * ```
+ */
+declare function useLeverageYieldTotalAssets({ params, queryOptions, }?: UseLeverageYieldTotalAssetsParams): UseQueryResult<bigint, Error>;
+
+type UseLeverageYieldPreviewRedeemParams = ReadHookParams<bigint, {
+    vault: Address$1 | undefined;
+    shares: bigint | undefined;
+}>;
+/**
+ * Reads the assets received for redeeming `shares` of a leverage-yield vault (ERC-4626
+ * `previewRedeem`). Passing `10n ** 18n` (one share) yields the per-share price that creeps
+ * up as the vault accrues interest. Moves slowly, so the default refresh is 60s.
+ *
+ * @example
+ * ```typescript
+ * const { data: sharePrice } = useLeverageYieldPreviewRedeem({
+ *   params: { vault: vault.vault, shares: 10n ** 18n },
+ * });
+ * ```
+ */
+declare function useLeverageYieldPreviewRedeem({ params, queryOptions, }?: UseLeverageYieldPreviewRedeemParams): UseQueryResult<bigint, Error>;
+
+/** A single `(chain, hub-wallet holder, share balance)` row produced by {@link useLeverageYieldShareBalances}. */
+type LeverageYieldShareHolding = {
+    chainKey: SpokeChainKey;
+    holder: Address$1;
+    shares: bigint;
+};
+/** A `(chainKey, EOA address)` pair the user controls — one per spoke chain they may hold shares under. */
+type LeverageYieldShareHolder = {
+    chainKey: SpokeChainKey;
+    address: string;
+};
+type UseLeverageYieldShareBalancesParams = ReadHookParams<LeverageYieldShareHolding, {
+    vault: Address$1 | undefined;
+    holders: readonly LeverageYieldShareHolder[] | undefined;
+}>;
+/**
+ * Reads a user's leverage-vault share (`lsoda*`) balances across every chain they may hold a
+ * position under — one query per holder, fanned out via `useQueries`.
+ *
+ * For each `(chainKey, address)` the holder is resolved to the address that actually owns the
+ * shares: the user's **derived hub wallet** on every chain, including the hub itself. Leverage
+ * deposits always deliver `lsoda*` to `getUserHubWalletAddress(srcAddress, srcChainKey)` (the
+ * CREATE3 user-router on Sonic for a hub-sourced deposit, the per-spoke hub wallet otherwise) —
+ * never the bare EOA — so a hub-chain deposit's shares live in the router, not the signing EOA.
+ * Resolving the holder the same way the deposit does is what makes a Sonic-sourced position show
+ * up here instead of reading a stale zero off the EOA.
+ *
+ * Returns the raw `useQueries` result array (15s refresh per query); callers aggregate as needed
+ * (e.g. sum `shares` for a headline total, or pick the row for the active chain).
+ *
+ * `useQueries` has no top-level options slot, so `queryOptions` is spread into every individual
+ * query config (and applies uniformly to each holder's query).
+ *
+ * @example
+ * ```typescript
+ * const balances = useLeverageYieldShareBalances({ params: { vault: vault.vault, holders } });
+ * const total = balances.reduce((acc, q) => acc + (q.data?.shares ?? 0n), 0n);
+ * ```
+ */
+declare function useLeverageYieldShareBalances({ params, queryOptions, }?: UseLeverageYieldShareBalancesParams): UseQueryResult<LeverageYieldShareHolding, Error>[];
+
+/** Mutation variables for {@link useLeverageYieldDeposit} — the swap-style deposit inputs. */
+type UseLeverageYieldDepositVars = LeverageYieldSwapDepositParams;
+/**
+ * Builds the `LeverageYieldSwapPayload` for a leverage-yield deposit (any token → `lsoda*` shares,
+ * delivered to the user's hub wallet). Spread the returned payload into
+ * {@link useLeverageYieldVaultSwap}.
+ *
+ * This is a builder, not an executor — it derives the hub wallet and assembles the intent; the
+ * actual swap is relayed by `useLeverageYieldVaultSwap`. Throws on SDK failure so React Query's
+ * error model engages; returns the unwrapped `LeverageYieldSwapPayload` on success.
+ *
+ * @example
+ * ```typescript
+ * const { mutateAsyncSafe: buildDeposit } = useLeverageYieldDeposit();
+ * const built = await buildDeposit({ vault, srcChainKey, srcAddress, inputToken, inputAmount, minOutputAmount });
+ * if (built.ok) vaultSwap({ ...built.value, walletProvider });
+ * ```
+ */
+declare function useLeverageYieldDeposit({ mutationOptions, }?: MutationHookParams<LeverageYieldSwapPayload, UseLeverageYieldDepositVars>): SafeUseMutationResult<LeverageYieldSwapPayload, Error, UseLeverageYieldDepositVars>;
+
+/** Mutation variables for {@link useLeverageYieldNotifySolver} — the hub-side intent tx hash. */
+type UseLeverageYieldNotifySolverVars = SolverExecutionRequest;
+/**
+ * Notifies the solver that a leverage-yield vault intent landed on the hub, triggering the fill.
+ * The standalone notify step for the manual create → relay → notify flow: build the intent with
+ * `sodax.leverageYield.createVaultIntent`, relay it yourself, then call this with the hub-side
+ * intent tx hash. The end-to-end {@link useLeverageYieldVaultSwap} already calls notifySolver
+ * internally — only reach for this hook when driving the relay manually.
+ *
+ * Throws on SDK failure so React Query's error model engages; returns the unwrapped
+ * `SolverExecutionResponse` (`{ answer: 'OK', intent_hash }`) on success.
+ */
+declare function useLeverageYieldNotifySolver({ mutationOptions, }?: MutationHookParams<SolverExecutionResponse, UseLeverageYieldNotifySolverVars>): SafeUseMutationResult<SolverExecutionResponse, Error, UseLeverageYieldNotifySolverVars>;
+
+/**
+ * Mutation variables for {@link useLeverageYieldVaultSwap}. Generic over `K extends SpokeChainKey`
+ * (defaults to the full union). Sophisticated callers can lock K at the hook call site to narrow
+ * the `walletProvider` and `params.srcChainKey` types.
+ */
+type UseLeverageYieldVaultSwapVars<K extends SpokeChainKey = SpokeChainKey> = Omit<VaultSwapActionParams<K, false>, 'raw'>;
+/**
+ * React hook for executing an end-to-end leverage-yield vault swap (deposit or withdraw).
+ *
+ * Spread a `LeverageYieldSwapPayload` built by {@link useLeverageYieldDeposit} /
+ * {@link useLeverageYieldWithdraw} into `mutate` alongside the wallet provider:
+ * `vaultSwap({ ...payload, walletProvider })`. Runs `sodax.leverageYield.vaultSwap` —
+ * create intent → verify → relay → notify solver — so vault flows never touch the
+ * generic swap surface.
+ *
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `VaultSwapResponse` on success.
+ */
+declare function useLeverageYieldVaultSwap<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<VaultSwapResponse, UseLeverageYieldVaultSwapVars<K>>): SafeUseMutationResult<VaultSwapResponse, Error, UseLeverageYieldVaultSwapVars<K>>;
+
+/** Mutation variables for {@link useLeverageYieldWithdraw} — the swap-style withdraw inputs. */
+type UseLeverageYieldWithdrawVars = LeverageYieldSwapWithdrawParams;
+/**
+ * Builds the `LeverageYieldSwapPayload` for a leverage-yield withdraw (`lsoda*` shares → any token).
+ * The returned payload carries `hubWalletSwap: true`; spread it into
+ * {@link useLeverageYieldVaultSwap}, which authorises the hub wallet to spend the shares via a
+ * `Connection.sendMessage`.
+ *
+ * This is a builder, not an executor. Throws on SDK failure so React Query's error model engages;
+ * returns the unwrapped `LeverageYieldSwapPayload` on success.
+ *
+ * @example
+ * ```typescript
+ * const { mutateAsyncSafe: buildWithdraw } = useLeverageYieldWithdraw();
+ * const built = await buildWithdraw({ vault, srcChainKey, srcAddress, dstChainKey, outputToken, inputAmount, minOutputAmount });
+ * if (built.ok) vaultSwap({ ...built.value, walletProvider });
+ * ```
+ */
+declare function useLeverageYieldWithdraw({ mutationOptions, }?: MutationHookParams<LeverageYieldSwapPayload, UseLeverageYieldWithdrawVars>): SafeUseMutationResult<LeverageYieldSwapPayload, Error, UseLeverageYieldWithdrawVars>;
+
 interface SodaxProviderProps {
     children: ReactNode;
     /**
@@ -1646,4 +1828,4 @@ interface NearStorageGateState {
  */
 declare function resolveNearStorageGate(chainKey: SpokeChainKey, check: NearStorageCheckResult): NearStorageGateState;
 
-export { type ATokenData, type BackendPaginationParams, type CreateSodaxQueryClientOptions, type DecreaseLiquidityParamsCore, type DepositParamsCore, type MutationHookOptions, type MutationHookParams, type NearStorageCheckResult, type NearStorageGateState, type RadfiSession, type ReadHookParams, type ReadQueryOptions, type ReserveUsdFormat, type SafeUseMutationResult, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseApproveTokenVars, type UseBitcoinBalanceParams, type UseBorrowVars, type UseBridgeAllowanceParams, type UseBridgeApproveVars, type UseBridgeVars, type UseClaimRewardsVars, type UseCreateDecreaseLiquidityParamsProps, type UseCreateDepositParamsProps, type UseCreateLimitOrderVars, type UseCreateSupplyLiquidityParamsProps, type UseCreateSupplyLiquidityParamsResult, type UseCreateWithdrawParamsProps, type UseDecreaseLiquidityVars, type UseDeriveUserWalletAddressParams, type UseDexAllowanceParams, type UseDexApproveVars, type UseDexDepositVars, type UseDexWithdrawVars, type UseExpiredUtxosParams, type UseFeeClaimSwapVars, type UseFetchAssetsBalancesParams, type UseFundTradingWalletVars, type UseGetAutoSwapPreferencesParams, type UseGetBridgeableAmountParams, type UseGetBridgeableTokensParams, type UseGetUserHubWalletAddressParams, type UseHubAssetBalancesParams, type UseIsTokenApprovedParams, type UseLiquidityAmountsResult, type UseMMAllowanceParams, type UseMMApproveVars, type UseMigrateBalnVars, type UseMigrateIcxToSodaVars, type UseMigratebnUSDVars, type UseMigrationAllowanceInputs, type UseMigrationAllowanceParams, type UseMigrationApproveVars, type UseNearStorageCheckParams, type UsePoolBalancesParams, type UsePoolBalancesResponse, type UsePoolDataParams, type UsePoolsParams, type UsePositionInfoParams, type UsePositionInfoResponse, type UseQuoteParams, type UseRadfiAuthVars, type UseRadfiSessionReturn, type UseRadfiWithdrawVars, type UseRegisterNearStorageVars, type UseRenewUtxosVars, type UseRepayVars, type UseReservesDataParams, type UseReservesHumanizedParams, type UseReservesListParams, type UseReservesUsdFormatParams, type UseRevertMigrateSodaToIcxVars, type UseSetSwapPreferenceVars, type UseSetSwapPreferenceVarsHub, type UseStatusParams, type UseStellarTrustlineCheckParams, type UseSupplyLiquidityVars, type UseSupplyVars, type UseSwapAllowanceParams, type UseSwapApproveVars, type UseSwapVars, type UseTradingWalletBalanceParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawHubAssetVars, type UseWithdrawVars, type UseXBalancesParams, type WithdrawParamsCore, type XBalancesInputs, clearRadfiSession, createDecreaseLiquidityParamsProps, createDepositParamsProps, createSodaxQueryClient, createSupplyLiquidityParamsProps, createWithdrawParamsProps, getXBalancesQueryOptions, loadRadfiSession, resolveNearStorageGate, saveRadfiSession, toResult, unwrapResult, useAToken, useATokensBalances, useApproveToken, useBackendAllMoneyMarketAssets, useBackendAllMoneyMarketBorrowers, useBackendIntentByHash, useBackendIntentByTxHash, useBackendMoneyMarketAsset, useBackendMoneyMarketAssetBorrowers, useBackendMoneyMarketAssetSuppliers, useBackendMoneyMarketPosition, useBackendOrderbook, useBackendSubmitSwapTx, useBackendSubmitSwapTxStatus, useBackendUserIntents, useBitcoinBalance, useBorrow, useBridge, useBridgeAllowance, useBridgeApprove, useCancelLimitOrder, useCancelSwap, useCancelUnstake, useClaim, useClaimRewards, useConvertedAssets, useCreateDecreaseLiquidityParams, useCreateDepositParams, useCreateLimitOrder, useCreateSupplyLiquidityParams, useCreateWithdrawParams, useDecreaseLiquidity, useDeriveUserWalletAddress, useDexAllowance, useDexApprove, useDexDeposit, useDexWithdraw, useEstimateGas, useExpiredUtxos, useFeeClaimSwap, useFetchAssetsBalances, useFundTradingWallet, useGetAutoSwapPreferences, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubAssetBalances, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useIsTokenApproved, useLiquidityAmounts, useMMAllowance, useMMApprove, useMigrateBaln, useMigrateIcxToSoda, useMigratebnUSD, useMigrationAllowance, useMigrationApprove, useNearStorageCheck, useNearStorageGate, usePoolBalances, usePoolData, usePools, usePositionInfo, useQuote, useRadfiAuth, useRadfiSession, useRadfiWithdraw, useRegisterNearStorage, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesHumanized, useReservesList, useReservesUsdFormat, useRevertMigrateSodaToIcx, useSafeMutation, useSetSwapPreference, useSodaxContext, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSupplyLiquidity, useSwap, useSwapAllowance, useSwapApprove, useTradingWallet, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw, useWithdrawHubAsset, useXBalances };
+export { type ATokenData, type BackendPaginationParams, type CreateSodaxQueryClientOptions, type DecreaseLiquidityParamsCore, type DepositParamsCore, type LeverageYieldShareHolder, type LeverageYieldShareHolding, type MutationHookOptions, type MutationHookParams, type NearStorageCheckResult, type NearStorageGateState, type RadfiSession, type ReadHookParams, type ReadQueryOptions, type ReserveUsdFormat, type SafeUseMutationResult, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseApproveTokenVars, type UseBitcoinBalanceParams, type UseBorrowVars, type UseBridgeAllowanceParams, type UseBridgeApproveVars, type UseBridgeVars, type UseClaimRewardsVars, type UseCreateDecreaseLiquidityParamsProps, type UseCreateDepositParamsProps, type UseCreateLimitOrderVars, type UseCreateSupplyLiquidityParamsProps, type UseCreateSupplyLiquidityParamsResult, type UseCreateWithdrawParamsProps, type UseDecreaseLiquidityVars, type UseDeriveUserWalletAddressParams, type UseDexAllowanceParams, type UseDexApproveVars, type UseDexDepositVars, type UseDexWithdrawVars, type UseExpiredUtxosParams, type UseFeeClaimSwapVars, type UseFetchAssetsBalancesParams, type UseFundTradingWalletVars, type UseGetAutoSwapPreferencesParams, type UseGetBridgeableAmountParams, type UseGetBridgeableTokensParams, type UseGetUserHubWalletAddressParams, type UseHubAssetBalancesParams, type UseIsTokenApprovedParams, type UseLeverageYieldDepositVars, type UseLeverageYieldEffectiveAprParams, type UseLeverageYieldNotifySolverVars, type UseLeverageYieldPositionParams, type UseLeverageYieldPreviewRedeemParams, type UseLeverageYieldShareBalancesParams, type UseLeverageYieldTotalAssetsParams, type UseLeverageYieldVaultSwapVars, type UseLeverageYieldWithdrawVars, type UseLiquidityAmountsResult, type UseMMAllowanceParams, type UseMMApproveVars, type UseMigrateBalnVars, type UseMigrateIcxToSodaVars, type UseMigratebnUSDVars, type UseMigrationAllowanceInputs, type UseMigrationAllowanceParams, type UseMigrationApproveVars, type UseNearStorageCheckParams, type UsePoolBalancesParams, type UsePoolBalancesResponse, type UsePoolDataParams, type UsePoolsParams, type UsePositionInfoParams, type UsePositionInfoResponse, type UseQuoteParams, type UseRadfiAuthVars, type UseRadfiSessionReturn, type UseRadfiWithdrawVars, type UseRegisterNearStorageVars, type UseRenewUtxosVars, type UseRepayVars, type UseReservesDataParams, type UseReservesHumanizedParams, type UseReservesListParams, type UseReservesUsdFormatParams, type UseRevertMigrateSodaToIcxVars, type UseSetSwapPreferenceVars, type UseSetSwapPreferenceVarsHub, type UseStatusParams, type UseStellarTrustlineCheckParams, type UseSupplyLiquidityVars, type UseSupplyVars, type UseSwapAllowanceParams, type UseSwapApproveVars, type UseSwapVars, type UseTradingWalletBalanceParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawHubAssetVars, type UseWithdrawVars, type UseXBalancesParams, type WithdrawParamsCore, type XBalancesInputs, clearRadfiSession, createDecreaseLiquidityParamsProps, createDepositParamsProps, createSodaxQueryClient, createSupplyLiquidityParamsProps, createWithdrawParamsProps, getXBalancesQueryOptions, loadRadfiSession, resolveNearStorageGate, saveRadfiSession, toResult, unwrapResult, useAToken, useATokensBalances, useApproveToken, useBackendAllMoneyMarketAssets, useBackendAllMoneyMarketBorrowers, useBackendIntentByHash, useBackendIntentByTxHash, useBackendMoneyMarketAsset, useBackendMoneyMarketAssetBorrowers, useBackendMoneyMarketAssetSuppliers, useBackendMoneyMarketPosition, useBackendOrderbook, useBackendSubmitSwapTx, useBackendSubmitSwapTxStatus, useBackendUserIntents, useBitcoinBalance, useBorrow, useBridge, useBridgeAllowance, useBridgeApprove, useCancelLimitOrder, useCancelSwap, useCancelUnstake, useClaim, useClaimRewards, useConvertedAssets, useCreateDecreaseLiquidityParams, useCreateDepositParams, useCreateLimitOrder, useCreateSupplyLiquidityParams, useCreateWithdrawParams, useDecreaseLiquidity, useDeriveUserWalletAddress, useDexAllowance, useDexApprove, useDexDeposit, useDexWithdraw, useEstimateGas, useExpiredUtxos, useFeeClaimSwap, useFetchAssetsBalances, useFundTradingWallet, useGetAutoSwapPreferences, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubAssetBalances, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useIsTokenApproved, useLeverageYieldDeposit, useLeverageYieldEffectiveApr, useLeverageYieldNotifySolver, useLeverageYieldPosition, useLeverageYieldPreviewRedeem, useLeverageYieldShareBalances, useLeverageYieldTotalAssets, useLeverageYieldVaultSwap, useLeverageYieldWithdraw, useLiquidityAmounts, useMMAllowance, useMMApprove, useMigrateBaln, useMigrateIcxToSoda, useMigratebnUSD, useMigrationAllowance, useMigrationApprove, useNearStorageCheck, useNearStorageGate, usePoolBalances, usePoolData, usePools, usePositionInfo, useQuote, useRadfiAuth, useRadfiSession, useRadfiWithdraw, useRegisterNearStorage, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesHumanized, useReservesList, useReservesUsdFormat, useRevertMigrateSodaToIcx, useSafeMutation, useSetSwapPreference, useSodaxContext, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSupplyLiquidity, useSwap, useSwapAllowance, useSwapApprove, useTradingWallet, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw, useWithdrawHubAsset, useXBalances };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { useMutation, useQuery, useQueryClient, QueryClient, MutationCache } from '@tanstack/react-query';
+import { useMutation, useQuery, useQueryClient, useQueries, QueryClient, MutationCache } from '@tanstack/react-query';
 import { createContext, useCallback, useContext, useState, useRef, useEffect, useMemo } from 'react';
 import { ChainKeys, RadfiApiError, normalizePsbtToBase64, ClService, Sodax } from '@sodax/sdk';
 export * from '@sodax/sdk';
@@ -2573,6 +2573,158 @@ function useClaimRewards({
     }
   });
 }
+function useLeverageYieldEffectiveApr({
+  params,
+  queryOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+  return useQuery({
+    queryKey: ["leverageYield", "effectiveApr", vault],
+    queryFn: async () => {
+      if (!vault) throw new Error("vault is required");
+      const result = await sodax.leverageYield.getEffectiveApr(vault);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault,
+    refetchInterval: 6e4,
+    ...queryOptions
+  });
+}
+function useLeverageYieldPosition({
+  params,
+  queryOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+  return useQuery({
+    queryKey: ["leverageYield", "position", vault],
+    queryFn: async () => {
+      if (!vault) throw new Error("vault is required");
+      const result = await sodax.leverageYield.getPosition(vault);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault,
+    refetchInterval: 3e4,
+    ...queryOptions
+  });
+}
+function useLeverageYieldTotalAssets({
+  params,
+  queryOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+  return useQuery({
+    queryKey: ["leverageYield", "totalAssets", vault],
+    queryFn: async () => {
+      if (!vault) throw new Error("vault is required");
+      const result = await sodax.leverageYield.getTotalAssets(vault);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault,
+    refetchInterval: 6e4,
+    ...queryOptions
+  });
+}
+function useLeverageYieldPreviewRedeem({
+  params,
+  queryOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+  const shares = params?.shares;
+  return useQuery({
+    queryKey: ["leverageYield", "previewRedeem", vault, shares?.toString()],
+    queryFn: async () => {
+      if (!vault || shares === void 0) throw new Error("vault and shares are required");
+      const result = await sodax.leverageYield.previewRedeem(vault, shares);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault && shares !== void 0,
+    refetchInterval: 6e4,
+    ...queryOptions
+  });
+}
+function useLeverageYieldShareBalances({
+  params,
+  queryOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+  const holders = params?.holders;
+  return useQueries({
+    queries: (holders ?? []).map(({ chainKey, address }) => ({
+      queryKey: ["leverageYield", "shareBalance", vault, chainKey, address],
+      refetchInterval: 15e3,
+      ...queryOptions,
+      enabled: !!vault,
+      queryFn: async () => {
+        if (!vault) throw new Error("vault is required");
+        const holder = await sodax.hubProvider.getUserHubWalletAddress(address, chainKey);
+        const result = await sodax.leverageYield.getShareBalance(vault, holder);
+        if (!result.ok) throw result.error;
+        return { chainKey, holder, shares: result.value };
+      }
+    }))
+  });
+}
+
+// src/hooks/leverageYield/useLeverageYieldDeposit.ts
+function useLeverageYieldDeposit({
+  mutationOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  return useSafeMutation({
+    mutationKey: ["leverageYield", "deposit"],
+    ...mutationOptions,
+    mutationFn: async (vars) => unwrapResult(await sodax.leverageYield.deposit(vars))
+  });
+}
+
+// src/hooks/leverageYield/useLeverageYieldNotifySolver.ts
+function useLeverageYieldNotifySolver({
+  mutationOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  return useSafeMutation({
+    mutationKey: ["leverageYield", "notifySolver"],
+    ...mutationOptions,
+    mutationFn: async (vars) => unwrapResult(await sodax.leverageYield.notifySolver(vars))
+  });
+}
+function useLeverageYieldVaultSwap({
+  mutationOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  const queryClient = useQueryClient();
+  return useSafeMutation({
+    mutationKey: ["leverageYield", "vaultSwap"],
+    ...mutationOptions,
+    mutationFn: async (vars) => unwrapResult(await sodax.leverageYield.vaultSwap({ ...vars, raw: false })),
+    onSuccess: async (data, vars, ctx) => {
+      queryClient.invalidateQueries({ queryKey: ["shared", "xBalances", vars.params.srcChainKey] });
+      queryClient.invalidateQueries({ queryKey: ["shared", "xBalances", vars.params.dstChainKey] });
+      await mutationOptions?.onSuccess?.(data, vars, ctx);
+    }
+  });
+}
+
+// src/hooks/leverageYield/useLeverageYieldWithdraw.ts
+function useLeverageYieldWithdraw({
+  mutationOptions
+} = {}) {
+  const { sodax } = useSodaxContext();
+  return useSafeMutation({
+    mutationKey: ["leverageYield", "withdraw"],
+    ...mutationOptions,
+    mutationFn: async (vars) => unwrapResult(await sodax.leverageYield.withdraw(vars))
+  });
+}
 var SodaxProvider = ({ children, config }) => {
   const sodax = useMemo(() => new Sodax(config), [config]);
   const contextValue = useMemo(() => ({ sodax }), [sodax]);
@@ -2604,4 +2756,4 @@ function createSodaxQueryClient({
   });
 }
 
-export { SodaxProvider, clearRadfiSession, createDecreaseLiquidityParamsProps, createDepositParamsProps, createSodaxQueryClient, createSupplyLiquidityParamsProps, createWithdrawParamsProps, getXBalancesQueryOptions, loadRadfiSession, resolveNearStorageGate, saveRadfiSession, toResult, unwrapResult, useAToken, useATokensBalances, useApproveToken, useBackendAllMoneyMarketAssets, useBackendAllMoneyMarketBorrowers, useBackendIntentByHash, useBackendIntentByTxHash, useBackendMoneyMarketAsset, useBackendMoneyMarketAssetBorrowers, useBackendMoneyMarketAssetSuppliers, useBackendMoneyMarketPosition, useBackendOrderbook, useBackendSubmitSwapTx, useBackendSubmitSwapTxStatus, useBackendUserIntents, useBitcoinBalance, useBorrow, useBridge, useBridgeAllowance, useBridgeApprove, useCancelLimitOrder, useCancelSwap, useCancelUnstake, useClaim, useClaimRewards, useConvertedAssets, useCreateDecreaseLiquidityParams, useCreateDepositParams, useCreateLimitOrder, useCreateSupplyLiquidityParams, useCreateWithdrawParams, useDecreaseLiquidity, useDeriveUserWalletAddress, useDexAllowance, useDexApprove, useDexDeposit, useDexWithdraw, useEstimateGas, useExpiredUtxos, useFeeClaimSwap, useFetchAssetsBalances, useFundTradingWallet, useGetAutoSwapPreferences, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubAssetBalances, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useIsTokenApproved, useLiquidityAmounts, useMMAllowance, useMMApprove, useMigrateBaln, useMigrateIcxToSoda, useMigratebnUSD, useMigrationAllowance, useMigrationApprove, useNearStorageCheck, useNearStorageGate, usePoolBalances, usePoolData, usePools, usePositionInfo, useQuote, useRadfiAuth, useRadfiSession, useRadfiWithdraw, useRegisterNearStorage, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesHumanized, useReservesList, useReservesUsdFormat, useRevertMigrateSodaToIcx, useSafeMutation, useSetSwapPreference, useSodaxContext, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSupplyLiquidity, useSwap, useSwapAllowance, useSwapApprove, useTradingWallet, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw, useWithdrawHubAsset, useXBalances };
+export { SodaxProvider, clearRadfiSession, createDecreaseLiquidityParamsProps, createDepositParamsProps, createSodaxQueryClient, createSupplyLiquidityParamsProps, createWithdrawParamsProps, getXBalancesQueryOptions, loadRadfiSession, resolveNearStorageGate, saveRadfiSession, toResult, unwrapResult, useAToken, useATokensBalances, useApproveToken, useBackendAllMoneyMarketAssets, useBackendAllMoneyMarketBorrowers, useBackendIntentByHash, useBackendIntentByTxHash, useBackendMoneyMarketAsset, useBackendMoneyMarketAssetBorrowers, useBackendMoneyMarketAssetSuppliers, useBackendMoneyMarketPosition, useBackendOrderbook, useBackendSubmitSwapTx, useBackendSubmitSwapTxStatus, useBackendUserIntents, useBitcoinBalance, useBorrow, useBridge, useBridgeAllowance, useBridgeApprove, useCancelLimitOrder, useCancelSwap, useCancelUnstake, useClaim, useClaimRewards, useConvertedAssets, useCreateDecreaseLiquidityParams, useCreateDepositParams, useCreateLimitOrder, useCreateSupplyLiquidityParams, useCreateWithdrawParams, useDecreaseLiquidity, useDeriveUserWalletAddress, useDexAllowance, useDexApprove, useDexDeposit, useDexWithdraw, useEstimateGas, useExpiredUtxos, useFeeClaimSwap, useFetchAssetsBalances, useFundTradingWallet, useGetAutoSwapPreferences, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubAssetBalances, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useIsTokenApproved, useLeverageYieldDeposit, useLeverageYieldEffectiveApr, useLeverageYieldNotifySolver, useLeverageYieldPosition, useLeverageYieldPreviewRedeem, useLeverageYieldShareBalances, useLeverageYieldTotalAssets, useLeverageYieldVaultSwap, useLeverageYieldWithdraw, useLiquidityAmounts, useMMAllowance, useMMApprove, useMigrateBaln, useMigrateIcxToSoda, useMigratebnUSD, useMigrationAllowance, useMigrationApprove, useNearStorageCheck, useNearStorageGate, usePoolBalances, usePoolData, usePools, usePositionInfo, useQuote, useRadfiAuth, useRadfiSession, useRadfiWithdraw, useRegisterNearStorage, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesHumanized, useReservesList, useReservesUsdFormat, useRevertMigrateSodaToIcx, useSafeMutation, useSetSwapPreference, useSodaxContext, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSupplyLiquidity, useSwap, useSwapAllowance, useSwapApprove, useTradingWallet, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw, useWithdrawHubAsset, useXBalances };

package/package.json

@@ -5,7 +5,7 @@
     "access": "public"
   },
   "license": "MIT",
-  "version": "2.0.0-rc.12",
+  "version": "2.0.0-rc.13",
   "description": "React hooks for building dApps on the SODAX cross-chain DeFi platform",
   "keywords": [
     "sodax",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "viem": "2.29.2",
-    "@sodax/sdk": "2.0.0-rc.12"
+    "@sodax/sdk": "2.0.0-rc.13"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.17.4",

package/src/hooks/_mutationContract.test.ts

@@ -26,6 +26,10 @@ const HOOKS: Array<{ path: string; nativeThrow?: true }> = [
   { path: 'dex/useDexDeposit.ts' },
   { path: 'dex/useDexWithdraw.ts' },
   { path: 'dex/useSupplyLiquidity.ts' },
+  { path: 'leverageYield/useLeverageYieldDeposit.ts' },
+  { path: 'leverageYield/useLeverageYieldNotifySolver.ts' },
+  { path: 'leverageYield/useLeverageYieldVaultSwap.ts' },
+  { path: 'leverageYield/useLeverageYieldWithdraw.ts' },
   { path: 'migrate/useMigrateBaln.ts' },
   { path: 'migrate/useMigrateIcxToSoda.ts' },
   { path: 'migrate/useMigratebnUSD.ts' },

package/src/hooks/index.ts

@@ -10,3 +10,4 @@ export * from './partner/index.js';
 export * from './recovery/index.js';
 export * from './migrate/index.js';
 export * from './dex/index.js';
+export * from './leverageYield/index.js';

package/src/hooks/leverageYield/index.ts

@@ -0,0 +1,9 @@
+export * from './useLeverageYieldEffectiveApr.js';
+export * from './useLeverageYieldPosition.js';
+export * from './useLeverageYieldTotalAssets.js';
+export * from './useLeverageYieldPreviewRedeem.js';
+export * from './useLeverageYieldShareBalances.js';
+export * from './useLeverageYieldDeposit.js';
+export * from './useLeverageYieldNotifySolver.js';
+export * from './useLeverageYieldVaultSwap.js';
+export * from './useLeverageYieldWithdraw.js';

package/src/hooks/leverageYield/useLeverageYieldDeposit.ts

@@ -0,0 +1,40 @@
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { LeverageYieldSwapPayload, LeverageYieldSwapDepositParams } from '@sodax/sdk';
+import type { MutationHookParams } from '../shared/types.js';
+import { useSafeMutation, type SafeUseMutationResult } from '../shared/useSafeMutation.js';
+import { unwrapResult } from '../shared/unwrapResult.js';
+
+/** Mutation variables for {@link useLeverageYieldDeposit} — the swap-style deposit inputs. */
+export type UseLeverageYieldDepositVars = LeverageYieldSwapDepositParams;
+
+/**
+ * Builds the `LeverageYieldSwapPayload` for a leverage-yield deposit (any token → `lsoda*` shares,
+ * delivered to the user's hub wallet). Spread the returned payload into
+ * {@link useLeverageYieldVaultSwap}.
+ *
+ * This is a builder, not an executor — it derives the hub wallet and assembles the intent; the
+ * actual swap is relayed by `useLeverageYieldVaultSwap`. Throws on SDK failure so React Query's
+ * error model engages; returns the unwrapped `LeverageYieldSwapPayload` on success.
+ *
+ * @example
+ * ```typescript
+ * const { mutateAsyncSafe: buildDeposit } = useLeverageYieldDeposit();
+ * const built = await buildDeposit({ vault, srcChainKey, srcAddress, inputToken, inputAmount, minOutputAmount });
+ * if (built.ok) vaultSwap({ ...built.value, walletProvider });
+ * ```
+ */
+export function useLeverageYieldDeposit({
+  mutationOptions,
+}: MutationHookParams<LeverageYieldSwapPayload, UseLeverageYieldDepositVars> = {}): SafeUseMutationResult<
+  LeverageYieldSwapPayload,
+  Error,
+  UseLeverageYieldDepositVars
+> {
+  const { sodax } = useSodaxContext();
+
+  return useSafeMutation<LeverageYieldSwapPayload, Error, UseLeverageYieldDepositVars>({
+    mutationKey: ['leverageYield', 'deposit'],
+    ...mutationOptions,
+    mutationFn: async vars => unwrapResult(await sodax.leverageYield.deposit(vars)),
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldEffectiveApr.ts

@@ -0,0 +1,42 @@
+import { useQuery, type UseQueryResult } from '@tanstack/react-query';
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { Address, LeverageYieldEffectiveApr } from '@sodax/sdk';
+import type { ReadHookParams } from '../shared/types.js';
+
+export type UseLeverageYieldEffectiveAprParams = ReadHookParams<
+  LeverageYieldEffectiveApr,
+  { vault: Address | undefined }
+>;
+
+/**
+ * Reads a leverage-yield vault's effective APR — AAVE supply/borrow rates plus the LSD
+ * staking yield, with the vault's leverage formula re-applied on the boosted supply side.
+ *
+ * The underlying SDK call does the on-chain reads (AAVE rates + `targetLTV`) and the
+ * off-chain LSD fetch in parallel. Rates drift slowly, so the default refresh is 60s.
+ *
+ * @example
+ * ```typescript
+ * const { data: apr } = useLeverageYieldEffectiveApr({ params: { vault: vault.vault } });
+ * ```
+ */
+export function useLeverageYieldEffectiveApr({
+  params,
+  queryOptions,
+}: UseLeverageYieldEffectiveAprParams = {}): UseQueryResult<LeverageYieldEffectiveApr, Error> {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+
+  return useQuery<LeverageYieldEffectiveApr, Error>({
+    queryKey: ['leverageYield', 'effectiveApr', vault],
+    queryFn: async () => {
+      if (!vault) throw new Error('vault is required');
+      const result = await sodax.leverageYield.getEffectiveApr(vault);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault,
+    refetchInterval: 60_000,
+    ...queryOptions,
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldNotifySolver.ts

@@ -0,0 +1,34 @@
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { SolverExecutionRequest, SolverExecutionResponse } from '@sodax/sdk';
+import type { MutationHookParams } from '../shared/types.js';
+import { useSafeMutation, type SafeUseMutationResult } from '../shared/useSafeMutation.js';
+import { unwrapResult } from '../shared/unwrapResult.js';
+
+/** Mutation variables for {@link useLeverageYieldNotifySolver} — the hub-side intent tx hash. */
+export type UseLeverageYieldNotifySolverVars = SolverExecutionRequest;
+
+/**
+ * Notifies the solver that a leverage-yield vault intent landed on the hub, triggering the fill.
+ * The standalone notify step for the manual create → relay → notify flow: build the intent with
+ * `sodax.leverageYield.createVaultIntent`, relay it yourself, then call this with the hub-side
+ * intent tx hash. The end-to-end {@link useLeverageYieldVaultSwap} already calls notifySolver
+ * internally — only reach for this hook when driving the relay manually.
+ *
+ * Throws on SDK failure so React Query's error model engages; returns the unwrapped
+ * `SolverExecutionResponse` (`{ answer: 'OK', intent_hash }`) on success.
+ */
+export function useLeverageYieldNotifySolver({
+  mutationOptions,
+}: MutationHookParams<SolverExecutionResponse, UseLeverageYieldNotifySolverVars> = {}): SafeUseMutationResult<
+  SolverExecutionResponse,
+  Error,
+  UseLeverageYieldNotifySolverVars
+> {
+  const { sodax } = useSodaxContext();
+
+  return useSafeMutation<SolverExecutionResponse, Error, UseLeverageYieldNotifySolverVars>({
+    mutationKey: ['leverageYield', 'notifySolver'],
+    ...mutationOptions,
+    mutationFn: async vars => unwrapResult(await sodax.leverageYield.notifySolver(vars)),
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldPosition.ts

@@ -0,0 +1,40 @@
+import { useQuery, type UseQueryResult } from '@tanstack/react-query';
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { Address, LeverageYieldPosition } from '@sodax/sdk';
+import type { ReadHookParams } from '../shared/types.js';
+
+export type UseLeverageYieldPositionParams = ReadHookParams<LeverageYieldPosition, { vault: Address | undefined }>;
+
+/**
+ * Reads a leverage-yield vault's live position snapshot via the vault's `getPositionDetails`:
+ * collateral, debt, current LTV (drift vs `targetLTV`), health factor (∞ when no debt), and
+ * idle (not-yet-deployed) asset.
+ *
+ * LTV shifts with each rebalance/rate tick, so the default refresh (30s) is faster than the
+ * APR/stats reads.
+ *
+ * @example
+ * ```typescript
+ * const { data: position } = useLeverageYieldPosition({ params: { vault: vault.vault } });
+ * ```
+ */
+export function useLeverageYieldPosition({
+  params,
+  queryOptions,
+}: UseLeverageYieldPositionParams = {}): UseQueryResult<LeverageYieldPosition, Error> {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+
+  return useQuery<LeverageYieldPosition, Error>({
+    queryKey: ['leverageYield', 'position', vault],
+    queryFn: async () => {
+      if (!vault) throw new Error('vault is required');
+      const result = await sodax.leverageYield.getPosition(vault);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault,
+    refetchInterval: 30_000,
+    ...queryOptions,
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldPreviewRedeem.ts

@@ -0,0 +1,43 @@
+import { useQuery, type UseQueryResult } from '@tanstack/react-query';
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { Address } from '@sodax/sdk';
+import type { ReadHookParams } from '../shared/types.js';
+
+export type UseLeverageYieldPreviewRedeemParams = ReadHookParams<
+  bigint,
+  { vault: Address | undefined; shares: bigint | undefined }
+>;
+
+/**
+ * Reads the assets received for redeeming `shares` of a leverage-yield vault (ERC-4626
+ * `previewRedeem`). Passing `10n ** 18n` (one share) yields the per-share price that creeps
+ * up as the vault accrues interest. Moves slowly, so the default refresh is 60s.
+ *
+ * @example
+ * ```typescript
+ * const { data: sharePrice } = useLeverageYieldPreviewRedeem({
+ *   params: { vault: vault.vault, shares: 10n ** 18n },
+ * });
+ * ```
+ */
+export function useLeverageYieldPreviewRedeem({
+  params,
+  queryOptions,
+}: UseLeverageYieldPreviewRedeemParams = {}): UseQueryResult<bigint, Error> {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+  const shares = params?.shares;
+
+  return useQuery<bigint, Error>({
+    queryKey: ['leverageYield', 'previewRedeem', vault, shares?.toString()],
+    queryFn: async () => {
+      if (!vault || shares === undefined) throw new Error('vault and shares are required');
+      const result = await sodax.leverageYield.previewRedeem(vault, shares);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault && shares !== undefined,
+    refetchInterval: 60_000,
+    ...queryOptions,
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldShareBalances.ts

@@ -0,0 +1,74 @@
+import { useQueries, type UseQueryResult } from '@tanstack/react-query';
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { Address, SpokeChainKey } from '@sodax/sdk';
+import type { ReadHookParams } from '../shared/types.js';
+
+/** A single `(chain, hub-wallet holder, share balance)` row produced by {@link useLeverageYieldShareBalances}. */
+export type LeverageYieldShareHolding = {
+  chainKey: SpokeChainKey;
+  holder: Address;
+  shares: bigint;
+};
+
+/** A `(chainKey, EOA address)` pair the user controls — one per spoke chain they may hold shares under. */
+export type LeverageYieldShareHolder = {
+  chainKey: SpokeChainKey;
+  address: string;
+};
+
+export type UseLeverageYieldShareBalancesParams = ReadHookParams<
+  LeverageYieldShareHolding,
+  { vault: Address | undefined; holders: readonly LeverageYieldShareHolder[] | undefined }
+>;
+
+/**
+ * Reads a user's leverage-vault share (`lsoda*`) balances across every chain they may hold a
+ * position under — one query per holder, fanned out via `useQueries`.
+ *
+ * For each `(chainKey, address)` the holder is resolved to the address that actually owns the
+ * shares: the user's **derived hub wallet** on every chain, including the hub itself. Leverage
+ * deposits always deliver `lsoda*` to `getUserHubWalletAddress(srcAddress, srcChainKey)` (the
+ * CREATE3 user-router on Sonic for a hub-sourced deposit, the per-spoke hub wallet otherwise) —
+ * never the bare EOA — so a hub-chain deposit's shares live in the router, not the signing EOA.
+ * Resolving the holder the same way the deposit does is what makes a Sonic-sourced position show
+ * up here instead of reading a stale zero off the EOA.
+ *
+ * Returns the raw `useQueries` result array (15s refresh per query); callers aggregate as needed
+ * (e.g. sum `shares` for a headline total, or pick the row for the active chain).
+ *
+ * `useQueries` has no top-level options slot, so `queryOptions` is spread into every individual
+ * query config (and applies uniformly to each holder's query).
+ *
+ * @example
+ * ```typescript
+ * const balances = useLeverageYieldShareBalances({ params: { vault: vault.vault, holders } });
+ * const total = balances.reduce((acc, q) => acc + (q.data?.shares ?? 0n), 0n);
+ * ```
+ */
+export function useLeverageYieldShareBalances({
+  params,
+  queryOptions,
+}: UseLeverageYieldShareBalancesParams = {}): UseQueryResult<LeverageYieldShareHolding, Error>[] {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+  const holders = params?.holders;
+
+  return useQueries({
+    queries: (holders ?? []).map(({ chainKey, address }) => ({
+      queryKey: ['leverageYield', 'shareBalance', vault, chainKey, address] as const,
+      refetchInterval: 15_000,
+      ...queryOptions,
+      enabled: !!vault,
+      queryFn: async (): Promise<LeverageYieldShareHolding> => {
+        if (!vault) throw new Error('vault is required');
+        // Always the derived hub wallet — on the hub chain too. A leverage deposit delivers
+        // shares to getUserHubWalletAddress(...), the CREATE3 router on Sonic, never the EOA,
+        // so reading balanceOf(EOA) for the hub chain would always come back zero.
+        const holder = await sodax.hubProvider.getUserHubWalletAddress(address, chainKey);
+        const result = await sodax.leverageYield.getShareBalance(vault, holder);
+        if (!result.ok) throw result.error;
+        return { chainKey, holder, shares: result.value };
+      },
+    })),
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldTotalAssets.ts

@@ -0,0 +1,36 @@
+import { useQuery, type UseQueryResult } from '@tanstack/react-query';
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { Address } from '@sodax/sdk';
+import type { ReadHookParams } from '../shared/types.js';
+
+export type UseLeverageYieldTotalAssetsParams = ReadHookParams<bigint, { vault: Address | undefined }>;
+
+/**
+ * Reads a leverage-yield vault's total underlying assets (vault-asset units, 18 decimals) —
+ * i.e. its TVL. Moves slowly, so the default refresh is 60s.
+ *
+ * @example
+ * ```typescript
+ * const { data: tvl } = useLeverageYieldTotalAssets({ params: { vault: vault.vault } });
+ * ```
+ */
+export function useLeverageYieldTotalAssets({
+  params,
+  queryOptions,
+}: UseLeverageYieldTotalAssetsParams = {}): UseQueryResult<bigint, Error> {
+  const { sodax } = useSodaxContext();
+  const vault = params?.vault;
+
+  return useQuery<bigint, Error>({
+    queryKey: ['leverageYield', 'totalAssets', vault],
+    queryFn: async () => {
+      if (!vault) throw new Error('vault is required');
+      const result = await sodax.leverageYield.getTotalAssets(vault);
+      if (!result.ok) throw result.error;
+      return result.value;
+    },
+    enabled: !!vault,
+    refetchInterval: 60_000,
+    ...queryOptions,
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldVaultSwap.ts

@@ -0,0 +1,50 @@
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { SpokeChainKey, VaultSwapActionParams, VaultSwapResponse } from '@sodax/sdk';
+import { useQueryClient } from '@tanstack/react-query';
+import type { MutationHookParams } from '../shared/types.js';
+import { useSafeMutation, type SafeUseMutationResult } from '../shared/useSafeMutation.js';
+import { unwrapResult } from '../shared/unwrapResult.js';
+
+/**
+ * Mutation variables for {@link useLeverageYieldVaultSwap}. Generic over `K extends SpokeChainKey`
+ * (defaults to the full union). Sophisticated callers can lock K at the hook call site to narrow
+ * the `walletProvider` and `params.srcChainKey` types.
+ */
+export type UseLeverageYieldVaultSwapVars<K extends SpokeChainKey = SpokeChainKey> = Omit<
+  VaultSwapActionParams<K, false>,
+  'raw'
+>;
+
+/**
+ * React hook for executing an end-to-end leverage-yield vault swap (deposit or withdraw).
+ *
+ * Spread a `LeverageYieldSwapPayload` built by {@link useLeverageYieldDeposit} /
+ * {@link useLeverageYieldWithdraw} into `mutate` alongside the wallet provider:
+ * `vaultSwap({ ...payload, walletProvider })`. Runs `sodax.leverageYield.vaultSwap` —
+ * create intent → verify → relay → notify solver — so vault flows never touch the
+ * generic swap surface.
+ *
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `VaultSwapResponse` on success.
+ */
+export function useLeverageYieldVaultSwap<K extends SpokeChainKey = SpokeChainKey>({
+  mutationOptions,
+}: MutationHookParams<VaultSwapResponse, UseLeverageYieldVaultSwapVars<K>> = {}): SafeUseMutationResult<
+  VaultSwapResponse,
+  Error,
+  UseLeverageYieldVaultSwapVars<K>
+> {
+  const { sodax } = useSodaxContext();
+  const queryClient = useQueryClient();
+
+  return useSafeMutation<VaultSwapResponse, Error, UseLeverageYieldVaultSwapVars<K>>({
+    mutationKey: ['leverageYield', 'vaultSwap'],
+    ...mutationOptions,
+    mutationFn: async vars => unwrapResult(await sodax.leverageYield.vaultSwap({ ...vars, raw: false })),
+    onSuccess: async (data, vars, ctx) => {
+      queryClient.invalidateQueries({ queryKey: ['shared', 'xBalances', vars.params.srcChainKey] });
+      queryClient.invalidateQueries({ queryKey: ['shared', 'xBalances', vars.params.dstChainKey] });
+      await mutationOptions?.onSuccess?.(data, vars, ctx);
+    },
+  });
+}

package/src/hooks/leverageYield/useLeverageYieldWithdraw.ts

@@ -0,0 +1,40 @@
+import { useSodaxContext } from '../shared/useSodaxContext.js';
+import type { LeverageYieldSwapPayload, LeverageYieldSwapWithdrawParams } from '@sodax/sdk';
+import type { MutationHookParams } from '../shared/types.js';
+import { useSafeMutation, type SafeUseMutationResult } from '../shared/useSafeMutation.js';
+import { unwrapResult } from '../shared/unwrapResult.js';
+
+/** Mutation variables for {@link useLeverageYieldWithdraw} — the swap-style withdraw inputs. */
+export type UseLeverageYieldWithdrawVars = LeverageYieldSwapWithdrawParams;
+
+/**
+ * Builds the `LeverageYieldSwapPayload` for a leverage-yield withdraw (`lsoda*` shares → any token).
+ * The returned payload carries `hubWalletSwap: true`; spread it into
+ * {@link useLeverageYieldVaultSwap}, which authorises the hub wallet to spend the shares via a
+ * `Connection.sendMessage`.
+ *
+ * This is a builder, not an executor. Throws on SDK failure so React Query's error model engages;
+ * returns the unwrapped `LeverageYieldSwapPayload` on success.
+ *
+ * @example
+ * ```typescript
+ * const { mutateAsyncSafe: buildWithdraw } = useLeverageYieldWithdraw();
+ * const built = await buildWithdraw({ vault, srcChainKey, srcAddress, dstChainKey, outputToken, inputAmount, minOutputAmount });
+ * if (built.ok) vaultSwap({ ...built.value, walletProvider });
+ * ```
+ */
+export function useLeverageYieldWithdraw({
+  mutationOptions,
+}: MutationHookParams<LeverageYieldSwapPayload, UseLeverageYieldWithdrawVars> = {}): SafeUseMutationResult<
+  LeverageYieldSwapPayload,
+  Error,
+  UseLeverageYieldWithdrawVars
+> {
+  const { sodax } = useSodaxContext();
+
+  return useSafeMutation<LeverageYieldSwapPayload, Error, UseLeverageYieldWithdrawVars>({
+    mutationKey: ['leverageYield', 'withdraw'],
+    ...mutationOptions,
+    mutationFn: async vars => unwrapResult(await sodax.leverageYield.withdraw(vars)),
+  });
+}