@gearbox-protocol/sdk 16.0.0-next.5 → 16.0.0-next.50

package/dist/types/preview/simulate/simulatePoolOperation.d.ts

@@ -1,8 +1,28 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
 import { PoolOperation } from "../parse/types-pools.js";
 import { PreviewOperationOptions } from "../types.js";
 import "../parse/index.js";
+import { PreviewSimulationError } from "./errors.js";
 import { PoolOperationSimulationResult, SimulationInput } from "./types.js";
+import { ContractFunctionParameters } from "viem";
 //#region src/preview/simulate/simulatePoolOperation.d.ts
+/**
+ * Builds the preview read that converts the operation's known amount into its
+ * counterpart. Direct operations read the pool's ERC4626 preview; zapper-routed
+ * operations (only ever `Deposit`/`Redeem`) read the zapper's
+ * `previewDeposit`/`previewRedeem`, which account for the zapper's own
+ * conversion in addition to the pool's.
+ */
+declare function previewContract(operation: PoolOperation): ContractFunctionParameters;
+/**
+ * Maps a pool operation and its preview result to the amounts of tokens going
+ * in (user -> pool) and out (pool -> user). `previewAmount` is the counterpart
+ * amount returned by the matching preview read (shares for deposit/withdraw,
+ * assets for mint/redeem, and the zapper's converted amount for zapper-routed
+ * deposit/redeem).
+ */
+declare function amountsInOut(operation: PoolOperation, previewAmount: bigint): PoolOperationSimulationResult;
 /**
  * Simulates a pool deposit/mint/withdraw/redeem (direct or zapper-routed) and
  * returns the resulting token amounts going in and out. Throws a
@@ -17,6 +37,6 @@ import { PoolOperationSimulationResult, SimulationInput } from "./types.js";
  * It does not execute the calldata, so it ignores balance/allowance
  * prerequisites (preview reads succeed regardless).
  */
-declare function simulatePoolOperation(input: SimulationInput<PoolOperation>, options?: PreviewOperationOptions): Promise<PoolOperationSimulationResult>;
+declare function simulatePoolOperation(input: SimulationInput<PoolOperation>, options?: PreviewOperationOptions): Promise<SDKReturn<PoolOperationSimulationResult, PreviewSimulationError>>;
 //#endregion
-export { simulatePoolOperation };
+export { amountsInOut, previewContract, simulatePoolOperation };

package/dist/types/preview/simulate/types.d.ts

@@ -26,13 +26,21 @@ interface SimulationInput<Op extends Operation = Operation> {
  */
 interface PoolOperationSimulationResult {
   /**
-   * Amount of tokens going from the user to the pool (underlying or zapper
-   * input token for deposit/mint, pool shares for withdraw/redeem).
+   * User -> pool.
+   *
+   * Deposit/mint: underlying (or zapper input); `withdrawFee` does not apply.
+   *
+   * Withdraw/redeem: shares burned. On withdraw, `previewWithdraw` inflates
+   * that burn for `withdrawFee`; on redeem, the shares from calldata.
    **/
   amountIn: bigint;
   /**
-   * Amount of tokens going from the pool to the user (pool shares or zapper
-   * output token for deposit/mint, underlying for withdraw/redeem).
+   * Pool -> user.
+   *
+   * Deposit/mint: shares minted (or zapper output); `withdrawFee` does not apply.
+   *
+   * Withdraw/redeem: underlying paid out. On withdraw, the requested amount;
+   * on redeem, `previewRedeem` after `withdrawFee`.
    **/
   amountOut: bigint;
 }

package/dist/types/preview/trace/extractAdapterCallTraces.d.ts

@@ -1,4 +1,4 @@
-import { CallTrace } from "../../common-utils/utils/trace.js";
+import { CallTrace } from "../../onchain/utils/trace.js";
 //#region src/preview/trace/extractAdapterCallTraces.d.ts
 /**
  * Extracts the user multicall's adapter-level call traces from a single facade

package/dist/types/preview/trace/findFacadeCalls.d.ts

@@ -1,4 +1,4 @@
-import { CallTrace } from "../../common-utils/utils/trace.js";
+import { CallTrace } from "../../onchain/utils/trace.js";
 import { ChainContractsRegister } from "../../onchain/base/ChainContractsRegister.js";
 import "../../onchain/index.js";
 import { FacadeParsedCall } from "./types.js";

package/dist/types/preview/trace/types.d.ts

@@ -1,5 +1,5 @@
 import { ParsedCallV2 } from "../../onchain/base/types.js";
-import { CallTrace } from "../../common-utils/utils/trace.js";
+import { CallTrace } from "../../onchain/utils/trace.js";
 import "../../onchain/index.js";
 import { Address } from "viem";
 //#region src/preview/trace/types.d.ts

package/dist/types/preview/validate/checkOperation.d.ts

@@ -0,0 +1,71 @@
+import { Bps } from "../../model/primitives.js";
+import { AccountHoldings, AccountMetrics, AccountProjection, OperationPreview } from "../../model/previews.js";
+import "../../model/index.js";
+import { AddressMap } from "../../onchain/utils/AddressMap.js";
+import { CreditSuite } from "../../onchain/market/credit/CreditSuite.js";
+import { OnchainSDK } from "../../onchain/OnchainSDK.js";
+import { PreviewIssue } from "../../onchain/validation/refusal.js";
+import "../../onchain/index.js";
+//#region src/preview/validate/checkOperation.d.ts
+/** Omitting a bar switches its check off — there is no single right one. */
+interface CheckOperationOptions {
+  /** Lowest acceptable health factor at main prices, in bps. */
+  minHealthFactor?: Bps;
+  /** Lowest acceptable health factor at safe prices, in bps. */
+  minSafeHealthFactor?: Bps;
+  /**
+   * Balances the operation is funded from, by token. Given, the wallet's side
+   * is checked offline; omitted, funding is left to `checkPrerequisites`.
+   */
+  balances?: AddressMap<bigint>;
+  /**
+   * The factor the account stands at now. Given, an operation that raises it
+   * passes even from under the bar — the top-ups that rescue a position would
+   * otherwise be refused by the very check meant to protect it.
+   */
+  currentHealthFactor?: Bps;
+}
+/**
+ * Whether a parsed operation may be signed at all — the protocol state that
+ * `checkPrerequisites` leaves out, since that one covers only what the sender
+ * can fix themselves.
+ *
+ * Synchronous: the preview carries the numbers and the market is attached.
+ * Reports the most fundamental issue it finds and stops there, which is the one
+ * a caller acts on.
+ */
+declare function checkOperation(input: {
+  sdk: OnchainSDK;
+  preview: OperationPreview;
+}, options?: CheckOperationOptions): PreviewIssue | null;
+/** What the market itself refuses, whatever the operation does. */
+declare function marketIssues(suite: CreditSuite): PreviewIssue | null;
+/**
+ * A bar that reads nothing but the projected account, so a parsed transaction
+ * and a simulated one are held to it by the same code.
+ *
+ * These stay separate functions rather than one block because the order the
+ * checks run in is the answer: `checkOperation` interleaves the checks that
+ * need an operation's *delta* between them, and the caller acts on the first
+ * issue reported.
+ */
+declare function quotaCountIssue(suite: CreditSuite, account: Pick<AccountProjection, "quotas">): PreviewIssue | null;
+/**
+ * An account's factors, in whichever branch of a routed leg the caller means to
+ * be held to: `prepare` reports the outcome the router expects, `preview` the
+ * floor its calldata guarantees. The bar is indifferent — it weighs the numbers
+ * it is handed — and passing them one by one is what makes the choice visible
+ * where it is made.
+ */
+interface WeighedFactors extends Pick<AccountHoldings, "totalDebt">, Pick<AccountMetrics, "healthFactor" | "safeHealthFactor"> {}
+/**
+ * The account against whichever bars the caller holds it to.
+ *
+ * A loan-free account is nothing to weigh: the health factor reports its
+ * zero-debt sentinel and no bar applies.
+ *
+ * {@inheritDoc quotaCountIssue}
+ */
+declare function collateralIssue(account: WeighedFactors, options: CheckOperationOptions): PreviewIssue | null;
+//#endregion
+export { CheckOperationOptions, WeighedFactors, checkOperation, collateralIssue, marketIssues, quotaCountIssue };

package/dist/types/preview/validate/checkSimulation.d.ts

@@ -0,0 +1,32 @@
+import { OnchainSDK } from "../../onchain/OnchainSDK.js";
+import { PreviewIssue } from "../../onchain/validation/refusal.js";
+import { OperationState } from "../../onchain/accounts/intents/types.js";
+import "../../onchain/index.js";
+import { CheckOperationOptions } from "./checkOperation.js";
+//#region src/preview/validate/checkSimulation.d.ts
+/**
+ * Whether a simulated operation clears the caller's own bars.
+ *
+ * The engine holds an account to the facade's `1.0`, because its guards answer
+ * "would this revert". A form is wiser to ask for more, and the engine's own
+ * note says so — a caller wanting the stricter bar applies it itself. This is
+ * that second opinion, over the numbers the engine already reported.
+ *
+ * Three of the checks below the engine does not make at all: both health-factor
+ * bars are its own `1.0`, and the quota count it never weighs. The other two run
+ * against the same numbers the engine used, and are here so that a change in the
+ * engine cannot pass silently.
+ *
+ * What is deliberately absent: the forbidden-token, quota-limit and funding
+ * checks all need the *delta* an operation applies, and `OperationState` reports
+ * only the state after it. Weighing them against absolutes would refuse a
+ * forbidden token the account merely holds, or a quota the operation never
+ * touched. The engine performed all three during the walk, so a simulation that
+ * came back `ok` has already passed them.
+ */
+declare function checkSimulation(input: {
+  sdk: OnchainSDK;
+  state: OperationState;
+}, options?: CheckOperationOptions): PreviewIssue | null;
+//#endregion
+export { checkSimulation };

package/dist/types/preview/validate/index.d.ts

@@ -0,0 +1,3 @@
+import { CheckOperationOptions, WeighedFactors, checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./checkOperation.js";
+import { checkSimulation } from "./checkSimulation.js";
+export { CheckOperationOptions, WeighedFactors, checkOperation, checkSimulation, collateralIssue, marketIssues, quotaCountIssue };

package/dist/types/rewards/index.d.ts

@@ -1,7 +1,7 @@
 import { Apy, ApyDetails, DebtReward, ExternalApy, ExtraCollateralAPY, ExtraCollateralPointsInfo, FarmInfo, GearAPY, GearAPYDetails, PointsInfo, PointsReward, PoolExtraApy, PoolOutputDetails, PoolPointsInfo, TokenOutputDetails } from "./apy/output-details.js";
 import { DataResult, Output } from "./apy/output.js";
 import "./apy/index.js";
-import { GearboxExtraMerkleLmReward, GearboxLmReward, GetLmRewardsMerkleProps, PoolData, RewardAmountAPI } from "./rewards/api.js";
+import { GetMerklRewardsProps, MerklReward, MerklRewardsSdk, getMerklRewards } from "./rewards/api.js";
 import { GetPointsByPoolProps, GetTotalTokensOnProtocolProps, PoolPointsAPI, PoolPointsBase, getKeyForPoolPointsInfo } from "./rewards/extra-apy.js";
 import "./rewards/index.js";
-export { Apy, ApyDetails, DataResult, DebtReward, ExternalApy, ExtraCollateralAPY, ExtraCollateralPointsInfo, FarmInfo, GearAPY, GearAPYDetails, GearboxExtraMerkleLmReward, GearboxLmReward, GetLmRewardsMerkleProps, GetPointsByPoolProps, GetTotalTokensOnProtocolProps, Output, PointsInfo, PointsReward, PoolData, PoolExtraApy, PoolOutputDetails, PoolPointsAPI, PoolPointsBase, PoolPointsInfo, RewardAmountAPI, TokenOutputDetails, getKeyForPoolPointsInfo };
+export { Apy, ApyDetails, DataResult, DebtReward, ExternalApy, ExtraCollateralAPY, ExtraCollateralPointsInfo, FarmInfo, GearAPY, GearAPYDetails, GetMerklRewardsProps, GetPointsByPoolProps, GetTotalTokensOnProtocolProps, MerklReward, MerklRewardsSdk, Output, PointsInfo, PointsReward, PoolExtraApy, PoolOutputDetails, PoolPointsAPI, PoolPointsBase, PoolPointsInfo, TokenOutputDetails, getKeyForPoolPointsInfo, getMerklRewards };

package/dist/types/rewards/rewards/api.d.ts

@@ -1,39 +1,60 @@
-import { NetworkType } from "../../onchain/chain/chains.js";
+import { ChainId, Token, TokenAmount } from "../../model/primitives.js";
+import "../../model/index.js";
+import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 import "../../onchain/index.js";
 import { Address } from "viem";
 //#region src/rewards/rewards/api.d.ts
-interface PoolData {
-  address: Address;
-  version: number;
-  underlyingToken: Address;
-  dieselRateRay: bigint;
-  dieselToken: Address;
-  stakedDieselToken: Address[];
-  stakedDieselToken_old: Address[];
-  expectedLiquidity: bigint;
+/**
+ * One claimable Merkl liquidity-mining reward, denominated and priced.
+ *
+ * Both tokens arrive resolved, so a consumer neither looks one up nor
+ * reassembles one out of the loose fields Merkl sends.
+ */
+interface MerklReward {
+  readonly chainId: ChainId;
+  /** Market pool whose depositors the campaign rewards. */
+  readonly pool: Address;
+  /** That pool's share token — what the campaign is keyed on. */
+  readonly poolToken: Token;
+  /**
+   * The incentive token being handed out, how much of it is claimable
+   * (distributed minus already claimed, always > 0) and what that is worth.
+   *
+   * Priced by Merkl, not by the market oracles: a campaign's incentive token
+   * is rarely collateral in the pool it incentivises, so the oracles usually
+   * do not know it — GEAR, which most Gearbox campaigns pay in, among them.
+   * `valueUsd` is `null` for a token Merkl does not price either.
+   */
+  readonly amount: TokenAmount;
 }
-interface GearboxExtraMerkleLmReward {
-  pool: Address;
-  poolToken: Address;
-  rewardTokenSymbol: string;
-  rewardTokenDecimals: number;
-  rewardToken: Address;
-  amount: bigint;
-  type: "extraMerkle";
-}
-type GearboxLmReward = GearboxExtraMerkleLmReward;
 type ReportHandler = (e: unknown, description?: string) => void;
-interface GetLmRewardsMerkleProps {
-  pools: Record<Address, PoolData>;
+/**
+ * What this read needs off a chain's SDK: which chain to ask Merkl about, the
+ * pools a campaign can be keyed on, and the registry that names their tokens.
+ *
+ * Sliced rather than taking the whole {@link OnchainSDK} so a caller can hand
+ * over a narrowed object — a test fixture included — without casting.
+ */
+type MerklRewardsSdk = Pick<OnchainSDK, "chainId" | "marketRegister" | "tokensMeta">;
+interface GetMerklRewardsProps {
+  /**
+   * The chain's SDK, attached. Reading `marketRegister` before attach throws,
+   * which the slice above cannot express.
+   */
+  sdk: MerklRewardsSdk;
   account: Address;
-  network: NetworkType;
   reportError?: ReportHandler;
+  /** Raises Merkl's rate limit; the keyless path answers too. */
   apiKey?: string;
 }
-declare class RewardAmountAPI {
-  private constructor();
-  static getLmRewardsMerkle({ pools, account, network, reportError, apiKey }: GetLmRewardsMerkleProps): Promise<GearboxExtraMerkleLmReward[]>;
-  private static extractFulfilled;
-}
+/**
+ * The wallet's claimable Merkl rewards on one chain.
+ *
+ * Never rejects on a transport failure: the fetch is settled rather than
+ * awaited, and a failure goes to `reportError` and yields an empty list. A
+ * caller that must tell "this chain is down" from "this chain has no rewards"
+ * has to watch that callback.
+ */
+declare function getMerklRewards({ sdk, account, reportError, apiKey }: GetMerklRewardsProps): Promise<MerklReward[]>;
 //#endregion
-export { GearboxExtraMerkleLmReward, GearboxLmReward, GetLmRewardsMerkleProps, PoolData, RewardAmountAPI };
+export { GetMerklRewardsProps, MerklReward, MerklRewardsSdk, getMerklRewards };

package/dist/types/rewards/rewards/extra-apy.d.ts

@@ -2,9 +2,9 @@ import { NetworkType } from "../../onchain/chain/chains.js";
 import { Asset } from "../../onchain/base/types.js";
 import { MarketSuite } from "../../onchain/market/MarketSuite.js";
 import { TokensMeta } from "../../onchain/base/TokensMeta.js";
+import "../../onchain/index.js";
 import { PoolPointsInfo } from "../apy/output-details.js";
 import { TokenData } from "./common.js";
-import "../../onchain/index.js";
 import { Address } from "viem";
 //#region src/rewards/rewards/extra-apy.d.ts
 interface GetPointsByPoolProps {

package/dist/types/rewards/rewards/index.d.ts

@@ -1,3 +1,3 @@
-import { GearboxExtraMerkleLmReward, GearboxLmReward, GetLmRewardsMerkleProps, PoolData, RewardAmountAPI } from "./api.js";
+import { GetMerklRewardsProps, MerklReward, MerklRewardsSdk, getMerklRewards } from "./api.js";
 import { GetPointsByPoolProps, GetTotalTokensOnProtocolProps, PoolPointsAPI, PoolPointsBase, getKeyForPoolPointsInfo } from "./extra-apy.js";
-export { GearboxExtraMerkleLmReward, GearboxLmReward, GetLmRewardsMerkleProps, GetPointsByPoolProps, GetTotalTokensOnProtocolProps, PoolData, PoolPointsAPI, PoolPointsBase, RewardAmountAPI, getKeyForPoolPointsInfo };
+export { GetMerklRewardsProps, GetPointsByPoolProps, GetTotalTokensOnProtocolProps, MerklReward, MerklRewardsSdk, PoolPointsAPI, PoolPointsBase, getKeyForPoolPointsInfo, getMerklRewards };

package/dist/types/rewards/rewards/merkl-api.d.ts

@@ -20,6 +20,12 @@ interface MerkleXYZUserRewardsV4 {
       chainId: number;
       symbol: string;
       decimals: number;
+      /**
+       * USD price of one whole token. Optional because Merkl omits the key
+       * outright for the tokens it does not price — points and the like —
+       * rather than sending a null.
+       */
+      price?: number;
     };
     breakdowns: Array<{
       reason: string;

package/dist/types/sdk/AbstractNamespace.d.ts

@@ -2,9 +2,9 @@ import { ILogger } from "../onchain/types/logger.js";
 import { ChainId } from "../model/primitives.js";
 import { DataResponse } from "../model/response.js";
 import "../model/index.js";
-import { EnsureFreshChains, NamespaceOptions } from "./types.js";
 import { EntityMerger, ListMerger } from "./utils/types.js";
 import "./utils/index.js";
+import { EnsureFreshChains, NamespaceOptions } from "./types.js";
 //#region src/sdk/AbstractNamespace.d.ts
 /**
  * One read of a combined namespace: the same query against each source, plus

package/dist/types/sdk/GearboxSDK.d.ts

@@ -1,13 +1,13 @@
 import { NetworkType } from "../onchain/chain/chains.js";
 import "../onchain/index.js";
-import { GearboxSDKOptions, Mode, NoticesByMode, OffchainByMode, OnchainByMode } from "./types.js";
-import { LiquidationsByMode } from "./liquidations/types.js";
+import { ILiquidationsByMode } from "./liquidations/types.js";
+import { IOpportunities } from "./opportunities/types.js";
+import { IPositions } from "./positions/types.js";
+import { IPreviewByMode } from "./preview/types.js";
+import { GearboxSDKOptions, IGearboxSDK, INoticesByMode, Mode, OffchainByMode, OnchainByMode } from "./types.js";
 import "./liquidations/index.js";
-import { Opportunities } from "./opportunities/types.js";
 import "./opportunities/index.js";
-import { Positions } from "./positions/types.js";
 import "./positions/index.js";
-import { PreviewByMode } from "./preview/types.js";
 import "./preview/index.js";
 //#region src/sdk/GearboxSDK.d.ts
 /**
@@ -34,7 +34,7 @@ declare const DEFAULT_MAX_STATE_AGE = 30;
  *
  * @typeParam M - Mode the instance was built in.
  **/
-declare class GearboxSDK<const M extends Mode = Mode> {
+declare class GearboxSDK<const M extends Mode = Mode> implements IGearboxSDK<M> {
   #private;
   /**
    * Sources this instance reads from.
@@ -47,30 +47,30 @@ declare class GearboxSDK<const M extends Mode = Mode> {
   /**
    * Namespace for pool and strategy opportunities.
    **/
-  readonly opportunities: Opportunities<M>;
+  readonly opportunities: IOpportunities<M>;
   /**
    * Namespace for the positions a wallet holds.
    **/
-  readonly positions: Positions<M>;
+  readonly positions: IPositions<M>;
   /**
    * Namespace for liquidatable credit accounts and delayed-withdrawal
    * positions a liquidator holds. Onchain-only, hence gated by mode like
    * every other chain read: absent in `offchain` mode.
    **/
-  readonly liquidations: LiquidationsByMode[M];
+  readonly liquidations: ILiquidationsByMode[M];
   /**
    * Namespace for on-chain previews of raw operation calldata. Onchain-only,
    * hence gated by mode like every other chain read: absent in `offchain`
    * mode.
    **/
-  readonly preview: PreviewByMode[M];
+  readonly preview: IPreviewByMode[M];
   /**
    * The banners the backend attaches to a pool opportunity or a strategy
    * position, see {@link Notice}. Top-level because the subject is either
    * kind of entity, so neither namespace owns it. Backend-only, hence gated
    * by mode like every other backend read: absent in `onchain` mode.
    **/
-  readonly notices: NoticesByMode[M];
+  readonly notices: INoticesByMode[M];
   constructor(options: GearboxSDKOptions<M>);
   /**
    * Attaches the on-chain SDK when this instance owns one; a no-op in `offchain`

package/dist/types/sdk/execute/ExecuteApi.d.ts

@@ -1,108 +1,19 @@
-import { ChainId } from "../../model/primitives.js";
-import "../../model/index.js";
-import { Asset } from "../../onchain/base/types.js";
-import { SecuritizeRegisterMessage } from "../../onchain/market/rwa/securitize/types.js";
 import { RawTx } from "../../onchain/types/transactions.js";
 import "../../onchain/index.js";
-import { LpSimulate, OpenStrategySimulate, StrategySimulate } from "../prepare/types.js";
 import { ChainOf } from "../prepare/PrepareApi.js";
 import "../prepare/index.js";
-import { Address } from "viem";
+import { IOpportunitiesExecute, PrepareRequest } from "./types.js";
 //#region src/sdk/execute/ExecuteApi.d.ts
 /**
- * A pool deposit, withdrawal or redemption, as
- * {@link OpportunitiesPrepare.deposit} / {@link OpportunitiesPrepare.withdraw}
- * / {@link OpportunitiesPrepare.redeem} priced it. The simulation carries the
- * tokens on both sides and the zapper, so nothing else is needed to encode
- * the call.
+ * {@inheritDoc IOpportunitiesExecute}
  **/
-interface PoolPrepareRequest {
-  kind: "pool";
-  chainId: ChainId;
-  pool: Address;
-  wallet: Address;
-  op: "deposit" | "withdraw" | "redeem";
-  sim: Extract<LpSimulate, {
-    ok: true;
-  }>;
-}
-/**
- * Opening a new position, from a viable
- * {@link OpportunitiesPrepare.openNewStrategy} result. The preview values
- * collateral in underlying only, so the wallet's actual collateral assets and
- * the native value to attach come from the caller.
- **/
-interface OpenPrepareRequest {
-  kind: "open";
-  chainId: ChainId;
-  creditManager: Address;
-  wallet: Address;
-  sim: Extract<OpenStrategySimulate, {
-    ok: true;
-  }>;
-  /** What leaves the wallet, token by token. */
-  collateral: Asset[];
-  /** Native value to attach when paying a wrapped-native market in the coin. */
-  ethAmount: bigint;
-  /**
-   * Token the position ends up in. RWA markets resolve their open
-   * requirements against it; omitting it skips the RWA check entirely.
-   **/
-  targetToken?: Address;
-  /**
-   * EIP-712 registration signatures the wallet already signed this session,
-   * attached as `signaturesToCache` when the market is RWA-gated.
-   **/
-  signaturesToCache?: SecuritizeRegisterMessage[];
-}
-/**
- * Any of the five operations on an existing account, from a viable
- * {@link StrategySimulate}: the facade multicall is the simulation's `calls`.
- **/
-interface AccountPrepareRequest {
-  kind: "account";
-  chainId: ChainId;
-  creditAccount: Address;
-  wallet: Address;
-  sim: Extract<StrategySimulate, {
-    ok: true;
-  }>;
-}
-/**
- * What {@link OpportunitiesExecute.buildTx} turns into a transaction: a
- * `prepare` result plus the few facts about the wallet the simulation does not
- * carry.
- **/
-type PrepareRequest = PoolPrepareRequest | OpenPrepareRequest | AccountPrepareRequest;
-/**
- * The write side of the opportunities namespace: turns what `prepare`
- * answered into the transaction to sign. Sending, and whatever the wallet has
- * to do first (allowances, permits, RWA signatures), stays with the caller —
- * `checkPrerequisites` reports the former on the built transaction.
- **/
-interface OpportunitiesExecute {
-  /**
-   * The transaction to sign, from a `prepare` result. No second round of math:
-   * `account` requests submit the simulation's own multicall, `open` requests
-   * hand the preview's router path and quotas to `openCA`, `pool` requests
-   * encode the deposit / redeem the simulation priced.
-   *
-   * @throws on a simulation that is not `ok`; when a `pool` request names a
-   * route the pool has no metadata for, or one the pool does not accept a
-   * transaction for (RWA on-demand deposits)
-   **/
-  buildTx(request: PrepareRequest): Promise<RawTx>;
-}
-/**
- * {@inheritDoc OpportunitiesExecute}
- **/
-declare class ExecuteApi implements OpportunitiesExecute {
+declare class ExecuteApi implements IOpportunitiesExecute {
   #private;
   constructor(chainOf: ChainOf);
   /**
-   * {@inheritDoc OpportunitiesExecute.buildTx}
+   * {@inheritDoc IOpportunitiesExecute.buildTx}
    **/
   buildTx(request: PrepareRequest): Promise<RawTx>;
 }
 //#endregion
-export { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest };
+export { ExecuteApi };

package/dist/types/sdk/execute/index.d.ts

@@ -1,2 +1,3 @@
-import { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest } from "./ExecuteApi.js";
-export { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest };
+import { AccountPrepareRequest, IOpportunitiesExecute, OpenPrepareRequest, PoolPrepareRequest, PrepareRequest } from "./types.js";
+import { ExecuteApi } from "./ExecuteApi.js";
+export { AccountPrepareRequest, ExecuteApi, IOpportunitiesExecute, OpenPrepareRequest, PoolPrepareRequest, PrepareRequest };

package/dist/types/sdk/execute/types.d.ts

@@ -0,0 +1,91 @@
+import { ChainId } from "../../model/primitives.js";
+import { SDKResult } from "../../model/result.js";
+import "../../model/index.js";
+import { Asset } from "../../onchain/base/types.js";
+import { SecuritizeRegisterMessage } from "../../onchain/market/rwa/securitize/types.js";
+import { RawTx } from "../../onchain/types/transactions.js";
+import "../../onchain/index.js";
+import { LpResult, OpenStrategyResult, StrategyResult } from "../prepare/types.js";
+import "../prepare/index.js";
+import { Address } from "viem";
+//#region src/sdk/execute/types.d.ts
+/**
+ * A pool deposit, withdrawal or redemption, as
+ * {@link IOpportunitiesPrepare.deposit} / {@link IOpportunitiesPrepare.withdraw}
+ * / {@link IOpportunitiesPrepare.redeem} priced it. The prepared state carries
+ * the tokens on both sides and the zapper, so nothing else is needed to encode
+ * the call.
+ **/
+interface PoolPrepareRequest {
+  kind: "pool";
+  chainId: ChainId;
+  pool: Address;
+  wallet: Address;
+  op: "deposit" | "withdraw" | "redeem";
+  sim: SDKResult<LpResult>;
+}
+/**
+ * Opening a new position, from a viable
+ * {@link IOpportunitiesPrepare.openNewStrategy} result. The prepared state
+ * values collateral in underlying only, so the wallet's actual collateral
+ * assets and the native value to attach come from the caller.
+ **/
+interface OpenPrepareRequest {
+  kind: "open";
+  chainId: ChainId;
+  creditManager: Address;
+  wallet: Address;
+  sim: SDKResult<OpenStrategyResult>;
+  /** What leaves the wallet, token by token. */
+  collateral: Asset[];
+  /** Native value to attach when paying a wrapped-native market in the coin. */
+  ethAmount: bigint;
+  /**
+   * Token the position ends up in. RWA markets resolve their open
+   * requirements against it; omitting it skips the RWA check entirely.
+   **/
+  targetToken?: Address;
+  /**
+   * EIP-712 registration signatures the wallet already signed this session,
+   * attached as `signaturesToCache` when the market is RWA-gated.
+   **/
+  signaturesToCache?: SecuritizeRegisterMessage[];
+}
+/**
+ * Any of the five operations on an existing account, from a viable
+ * {@link StrategyResult}: the facade multicall is the result's `calls`.
+ **/
+interface AccountPrepareRequest {
+  kind: "account";
+  chainId: ChainId;
+  creditAccount: Address;
+  wallet: Address;
+  sim: SDKResult<StrategyResult>;
+}
+/**
+ * What {@link IOpportunitiesExecute.buildTx} turns into a transaction: a
+ * `prepare` result plus the few facts about the wallet the preparation does not
+ * carry.
+ **/
+type PrepareRequest = PoolPrepareRequest | OpenPrepareRequest | AccountPrepareRequest;
+/**
+ * The write side of the opportunities namespace: turns what `prepare`
+ * answered into the transaction to sign. Sending, and whatever the wallet has
+ * to do first (allowances, permits, RWA signatures), stays with the caller —
+ * `checkPrerequisites` reports the former on the built transaction.
+ **/
+interface IOpportunitiesExecute {
+  /**
+   * The transaction to sign, from a `prepare` result. No second round of math:
+   * `account` requests submit the result's own multicall, `open` requests hand
+   * the state's router path and quotas to `openCA`, `pool` requests encode the
+   * deposit / redeem the result priced.
+   *
+   * @throws on a refused `prepare` result; when a `pool` request names a route
+   * the pool has no metadata for, or one the pool does not accept a transaction
+   * for (RWA on-demand deposits)
+   **/
+  buildTx(request: PrepareRequest): Promise<RawTx>;
+}
+//#endregion
+export { AccountPrepareRequest, IOpportunitiesExecute, OpenPrepareRequest, PoolPrepareRequest, PrepareRequest };