@gearbox-protocol/sdk 16.3.0-next.2 → 16.3.0-next.4

package/dist/types/onchain/market/rwa/securitize/SecuritizeRWAFactory.d.ts

@@ -1,8 +1,8 @@
-import { RWA_FACTORY_SECURITIZE, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs } from "../../../../model/rwa.js";
+import { RWA_FACTORY_SECURITIZE, SecuritizeOperationArgs } from "../../../../model/rwa.js";
 import "../../../../model/index.js";
 import { DStokenData, SecuritizeInvestorData, SecuritizeRWAFactoryStateHuman } from "./types.js";
 import { SecuritizeDegenNFT } from "./SecuritizeDegenNFT.js";
-import { GetInvestorOptions, GetOpenAccountRequirementsProps, IRWAFactory, RWACompressorInvestorData, RWAFactoryData } from "../types.js";
+import { GetInvestorOptions, IRWAFactory, RWACompressorInvestorData, RWAFactoryData } from "../types.js";
 import { MultiCall, RawTx } from "../../../types/transactions.js";
 import { OnchainSDK } from "../../../OnchainSDK.js";
 import "../../../types/index.js";
@@ -497,18 +497,6 @@ declare class SecuritizeRWAFactory extends BaseContract<abi> implements IRWAFact
    * {@inheritDoc IRWAFactory.multicall}
    */
   multicall(creditAccount: Address, calls: MultiCall[], args?: SecuritizeOperationArgs): RawTx;
-  /**
-   * {@inheritDoc IRWAFactory.getOpenAccountRequirements}
-   */
-  getOpenAccountRequirements(investor: Address, props: GetOpenAccountRequirementsProps): Promise<SecuritizeOpenAccountRequirements | undefined>;
-  /**
-   * {@inheritDoc IRWAFactory.getMissingRequirements}
-   *
-   * A required signature is omitted when `providedArgs.signaturesToCache`
-   * already carries a signature for the same token: the transaction caches it
-   * on-chain as part of the operation.
-   */
-  getMissingRequirements(requirements: SecuritizeOpenAccountRequirements, providedArgs?: SecuritizeOperationArgs): SecuritizeMissingOpenAccountRequirements | undefined;
   /**
    * {@inheritDoc IRWAFactory.openCreditAccount}
    */

package/dist/types/onchain/market/rwa/types.d.ts

@@ -1,5 +1,5 @@
 import { iRWACompressorAbi } from "../../../abi/rwa/iRWACompressor.js";
-import { KycProtocol, RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWA_FACTORY_SECURITIZE } from "../../../model/rwa.js";
+import { RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWAProtocol, RWA_FACTORY_SECURITIZE } from "../../../model/rwa.js";
 import "../../../model/index.js";
 import { IBaseContract, Unarray } from "../../base/types.js";
 import { SecuritizeInvestorData, SecuritizeRWAFactoryStateHuman } from "./securitize/types.js";
@@ -19,10 +19,15 @@ import { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from "abitype";
  **/
 interface RWAFactoryTypeMap {
   [RWA_FACTORY_SECURITIZE]: {
+    protocol: "securitize";
     investorData: SecuritizeInvestorData;
     stateHuman: SecuritizeRWAFactoryStateHuman;
   };
 }
+/**
+ * {@link RWAProtocol} of the factory type `T`.
+ **/
+type RWAFactoryProtocol<T extends RWAFactoryType> = RWAFactoryTypeMap[T]["protocol"];
 /**
  * Investor data decoded from the RWA compressor, defaults to union of all factory types
  * Can be discriminated by type
@@ -151,26 +156,7 @@ interface IRWAFactory<T extends RWAFactoryType = RWAFactoryType> extends IBaseCo
    * @param args - factory-specific args (e.g. tokens to register, signatures to cache).
    *   Undefined value means that no RWA actions are required
    **/
-  multicall(creditAccount: Address, calls: MultiCall[], args?: RWAOperationArgs<T>): RawTx;
-  /**
-   * Checks if the user can open a credit account with this factory.
-   * @param investor - investor address
-   * @param props - {@link GetOpenAccountRequirementsProps}
-   * @returns open account requirements for the investor, or `undefined` if the
-   *   user can open a credit account without any further actions
-   **/
-  getOpenAccountRequirements(investor: Address, props: GetOpenAccountRequirementsProps): Promise<RWAOpenAccountRequirements<T> | undefined>;
-  /**
-   * Computes the subset of `requirements` still unfulfilled, given the
-   * factory-specific params already carried by the transaction calldata.
-   *
-   * @param requirements - requirements fetched via {@link getOpenAccountRequirements}
-   * @param providedArgs - params decoded from the transaction calldata, if
-   *   any; e.g. signatures already included there need not be signed again
-   * @returns the missing requirements, or `undefined` when everything is
-   *   satisfied
-   **/
-  getMissingRequirements(requirements: RWAOpenAccountRequirements<T>, providedArgs?: RWAOperationArgs<T>): RWAMissingOpenAccountRequirements<T> | undefined;
+  multicall(creditAccount: Address, calls: MultiCall[], args?: RWAOperationArgs<RWAFactoryProtocol<T>>): RawTx;
   /**
    * Creates a raw transaction to open a credit account.
    * Similar to {@link CreditFacadeV310Contract.openCreditAccount}.
@@ -180,25 +166,41 @@ interface IRWAFactory<T extends RWAFactoryType = RWAFactoryType> extends IBaseCo
    * @param args - factory-specific args (e.g. tokens to register, signatures to cache).
    * Undefined value means that no RWA actions are required (e.g. when we open second credit account)
    **/
-  openCreditAccount(creditManager: Address, calls: MultiCall[], args?: RWAOperationArgs<T>): RawTx;
-}
-/**
- * Result of {@link IDegenNFT.checkKyc}.
- */
-interface KycCheckResult {
-  eligible: boolean;
-  /** Token the wallet must be registered for. */
-  token: Address;
+  openCreditAccount(creditManager: Address, calls: MultiCall[], args?: RWAOperationArgs<RWAFactoryProtocol<T>>): RawTx;
+  /**
+   * Degen NFT this factory deploys as the KYC gate. Midas has no factory;
+   * its NFT is loaded separately via {@link createDegenNFT}.
+   **/
+  readonly degenNFT: IDegenNFT<RWAFactoryProtocol<T>>;
 }
 /**
- * Degen NFT that gates credit-account opening behind a KYC provider.
- */
-interface IDegenNFT extends IBaseContract {
-  readonly protocol: KycProtocol;
+ * Degen NFT that gates credit-account opening behind an RWA KYC provider.
+ **/
+interface IDegenNFT<P extends RWAProtocol = RWAProtocol> extends IBaseContract {
+  readonly protocol: P;
+  readonly registrationLink: string;
+  /**
+   * Tokens this gate is about: Securitize DS tokens, or the Midas mToken.
+   */
+  getTokens(): Promise<Address[]>;
+  /**
+   * What `wallet` still has to do before this gate lets it open on the
+   * strategy token in `props`.
+   */
+  getOpenAccountRequirements(wallet: Address, props: GetOpenAccountRequirementsProps): Promise<RWAOpenAccountRequirements<P>>;
+  /**
+   * Protocol-side KYC is done: registered at Securitize for every requested
+   * DS token, or greenlisted by Midas.
+   *
+   * User might still be required to do additional actions on Gearbox side,
+   * e.g. sign EIP-712 messages for Securitize
+   */
+  isRegistered(requirements: RWAOpenAccountRequirements<P>): boolean;
   /**
-   * Same predicate the NFT's `burn` reverts on.
+   * Leftover Gearbox-tx work given `providedArgs` already on the calldata.
+   * Always `undefined` for Midas (no tx args).
    */
-  checkKyc(wallet: Address, targetCollateral: Address): Promise<KycCheckResult>;
+  getMissingRequirements(requirements: RWAOpenAccountRequirements<P>, providedArgs?: RWAOperationArgs<P>): RWAMissingOpenAccountRequirements<P> | undefined;
 }
 /**
  * Narrows any contract to an {@link IRWAFactory}.
@@ -211,4 +213,4 @@ interface IDegenNFT extends IBaseContract {
  **/
 declare function isRWAFactory<T extends RWAFactoryType = RWAFactoryType>(contract: IBaseContract, type?: T): contract is IRWAFactory<T>;
 //#endregion
-export { GetInvestorOptions, GetOpenAccountRequirementsProps, IDegenNFT, IRWAFactory, KycCheckResult, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryStateHuman, RWAInvestorData, RWAState, RWAStateHuman, RWAUnderlyingData, isRWAFactory };
+export { GetInvestorOptions, GetOpenAccountRequirementsProps, IDegenNFT, IRWAFactory, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryProtocol, RWAFactoryStateHuman, RWAInvestorData, RWAState, RWAStateHuman, RWAUnderlyingData, isRWAFactory };

package/dist/types/onchain/opportunities/MultichainOpportunitiesService.d.ts

@@ -33,7 +33,11 @@ declare class MultichainOpportunitiesService<const Plugins extends PluginsMap =
    *
    * See {@link MultichainOpportunitiesService.getPool}.
    **/
-  getStrategy(key: StrategyOpportunityKey, wallet?: Address): Promise<DataResponse<StrategyOpportunityDetail>>;
+  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
+  /**
+   * {@inheritDoc OpportunitiesService.isEligibleForStrategy}
+   **/
+  isEligibleForStrategy(key: StrategyOpportunityKey, wallet: Address): Promise<boolean>;
 }
 //#endregion
 export { MultichainOpportunitiesService };

package/dist/types/onchain/opportunities/OpportunitiesService.d.ts

@@ -34,13 +34,20 @@ declare class OpportunitiesService extends SDKConstruct {
    * A single strategy opportunity plus the rate curve of the pool it borrows
    * from and the price feeds its liquidation price depends on.
    *
-   * @param wallet - When given, `kyc` says whether this wallet must register
-   * with the strategy's KYC provider first; `null` otherwise.
+   * `kyc` is the strategy's KYC gate, independent of any wallet.
    *
    * @throws If the credit manager is unknown, or does not currently offer a
    * strategy.
    **/
-  getStrategy(key: StrategyOpportunityKey, wallet?: Address): Promise<StrategyOpportunityDetail>;
+  getStrategy(key: StrategyOpportunityKey): Promise<StrategyOpportunityDetail>;
+  /**
+   * Whether `wallet` may open this strategy today: `true` when it is not
+   * KYC-gated or the wallet already passed the gate.
+   *
+   * @throws If the credit manager is unknown, or does not currently offer a
+   * strategy.
+   **/
+  isEligibleForStrategy(key: StrategyOpportunityKey, wallet: Address): Promise<boolean>;
 }
 //#endregion
 export { OpportunitiesService };

package/dist/types/onchain/opportunities/types.d.ts

@@ -22,7 +22,12 @@ interface IMultichainOpportunitiesService {
   /**
    * Detailed view of one strategy opportunity.
    **/
-  getStrategy(key: StrategyOpportunityKey, wallet?: Address): Promise<DataResponse<StrategyOpportunityDetail>>;
+  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
+  /**
+   * Whether `wallet` may open this strategy today. Throws when that chain
+   * cannot answer.
+   **/
+  isEligibleForStrategy(key: StrategyOpportunityKey, wallet: Address): Promise<boolean>;
 }
 //#endregion
 export { IMultichainOpportunitiesService };

package/dist/types/onchain/validation/bundles/checkRWAOpenRequirements.d.ts

@@ -10,10 +10,10 @@ interface CheckRWAOpenRequirementsInput {
   wallet: Address;
   creditManager: Address;
   token: Address;
-  providedArgs: RWAOperationArgs;
+  providedArgs?: RWAOperationArgs;
 }
 /**
- * The RWA factory is satisfied that `wallet` may open on `token` with the
+ * The degen NFT is satisfied that `wallet` may open on `token` with the
  * registration args already on the transaction.
  */
 declare function checkRWAOpenRequirements(input: CheckRWAOpenRequirementsInput): Promise<(RWAOpenRequirementsError | UnexpectedFailureError)[]>;

package/dist/types/onchain/validation/bundles/checkRWAOpening.d.ts

@@ -1,17 +1,17 @@
 import { RWAOpenRequirementsError } from "../../../model/errors/operation-errors.js";
 import { UnexpectedFailureError } from "../../../model/errors/prepare-errors.js";
-import { OpenRWAStrategyPositionPreview } from "../../../model/previews.js";
+import { OpenStrategyPositionPreview } from "../../../model/previews.js";
 import "../../../model/index.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
 import { Address } from "viem";
 //#region src/onchain/validation/bundles/checkRWAOpening.d.ts
 interface CheckRWAOpeningInput {
   sdk: OnchainSDK;
-  preview: OpenRWAStrategyPositionPreview;
+  preview: OpenStrategyPositionPreview;
   sender: Address;
 }
 /**
- * Per factory-gated token among `collateralAdded ∪ quotas`, whether the
+ * Per KYC-gated token among `collateralAdded ∪ quotas`, whether the
  * borrower still has to register or sign before this opening can land.
  */
 declare function checkRWAOpening(input: CheckRWAOpeningInput): Promise<(RWAOpenRequirementsError | UnexpectedFailureError)[]>;

package/dist/types/onchain/validation/checkSimulation.d.ts

@@ -1,33 +1,20 @@
 import { ChainId } from "../../model/primitives.js";
 import { DebtOutOfRangeError, InsufficientCollateralError, QuotaCountExceededError } from "../../model/errors/operation-errors.js";
 import "../../model/index.js";
-import { PoolSimulation } from "../pools/types.js";
 import { OnchainSDK } from "../OnchainSDK.js";
 import { OperationState } from "../accounts/intents/types.js";
+import { OpenStrategyState } from "../accounts/intents/open-strategy.js";
 import { HealthFactorThresholds } from "./bundles/checkHealthFactors.js";
 import { MarketStateError } from "./bundles/checkMarket.js";
-import { PoolOperationError } from "./bundles/checkPoolOperation.js";
-import { Address } from "viem";
 //#region src/onchain/validation/checkSimulation.d.ts
 /** A simulated credit operation, as the intents engine reports one. */
 interface CreditSimulationInput {
   chainId: ChainId;
-  state: OperationState;
+  state: OperationState | OpenStrategyState;
 }
-/**
- * A simulated pool operation. The pool comes alongside the state, which names
- * the tokens moving through it but not the market they belong to.
- */
-interface PoolSimulationInput {
-  chainId: ChainId;
-  pool: Address;
-  state: PoolSimulation;
-  /** Whether the operation puts liquidity in rather than taking it out. */
-  isDeposit: boolean;
-}
-type CheckSimulationInput = CreditSimulationInput | PoolSimulationInput;
+type CheckSimulationInput = CreditSimulationInput;
 /** {@inheritDoc checkSimulation} */
-type SimulationValidationError = MarketStateError | DebtOutOfRangeError | QuotaCountExceededError | InsufficientCollateralError | PoolOperationError;
+type SimulationValidationError = MarketStateError | DebtOutOfRangeError | QuotaCountExceededError | InsufficientCollateralError;
 /**
  * Whether a simulated operation clears the caller's own thresholds.
  *
@@ -48,9 +35,11 @@ type SimulationValidationError = MarketStateError | DebtOutOfRangeError | QuotaC
  * touched. The engine performed all three during the walk, so a simulation that
  * came back `ok` has already passed them.
  *
- * A pool operation has no account to weigh, so what is left is the pool's own
- * state — which the engine does not read either.
+ * A credit account only, opened or adjusted: a pool operation has no account
+ * to weigh, and the three things its own state decides are read by `prepare`
+ * before it answers. An opening names its quotas `averageQuota` — the branch
+ * the planner already weighed it as.
  */
 declare function checkSimulation(sdk: OnchainSDK, input: CheckSimulationInput, options?: HealthFactorThresholds): SimulationValidationError[];
 //#endregion
-export { CheckSimulationInput, CreditSimulationInput, PoolSimulationInput, SimulationValidationError, checkSimulation };
+export { CheckSimulationInput, CreditSimulationInput, SimulationValidationError, checkSimulation };

package/dist/types/onchain/validation/checks/checkDebtLimits.d.ts

@@ -1,6 +1,8 @@
 import { Token } from "../../../model/primitives.js";
 import { DebtOutOfRangeError } from "../../../model/errors/operation-errors.js";
 import "../../../model/index.js";
+import { MaxBorrowAmount } from "../../market/credit/types.js";
+import "../../market/index.js";
 //#region src/onchain/validation/checks/checkDebtLimits.d.ts
 interface DebtLimitsArgs {
   debt: bigint;
@@ -14,6 +16,8 @@ interface DebtLimitsArgs {
    * rather than assumed.
    */
   allowZero: boolean;
+  /** From the caller's suite; a caller that raises to throw advises nobody. */
+  maxBorrowAmount?: MaxBorrowAmount;
 }
 /** A debt the facade would revert on. */
 declare function checkDebtLimits(args: DebtLimitsArgs): DebtOutOfRangeError[];

package/dist/types/onchain/validation/index.d.ts

@@ -19,7 +19,7 @@ import { CheckWalletBalanceInput, checkWalletBalance } from "./bundles/checkWall
 import "./bundles/index.js";
 import { CheckLiquidationInput, CheckLiquidationOptions, LiquidationValidationError, checkLiquidation } from "./checkLiquidation.js";
 import { CheckOperationInput, CheckOperationOptions, OperationValidationError, checkOperation } from "./checkOperation.js";
-import { CheckSimulationInput, CreditSimulationInput, PoolSimulationInput, SimulationValidationError, checkSimulation } from "./checkSimulation.js";
+import { CheckSimulationInput, CreditSimulationInput, SimulationValidationError, checkSimulation } from "./checkSimulation.js";
 import { BorrowLimitArgs, checkBorrowLimit } from "./checks/checkBorrowLimit.js";
 import { CollateralisedArgs, checkCollateralised } from "./checks/checkCollateralised.js";
 import { CreditAccountFrozenArgs, checkCreditAccountFrozen } from "./checks/checkCreditAccountFrozen.js";
@@ -40,4 +40,4 @@ import { amountOf } from "./helpers/amount.js";
 import { MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM } from "./helpers/health-factor-limits.js";
 import { toToken, toTokenAmount } from "./helpers/token.js";
 import "./helpers/index.js";
-export { BorrowLimitArgs, CheckCollateralFundingInput, CheckLiquidationEligibilityInput, CheckLiquidationFundingInput, CheckLiquidationInput, CheckLiquidationOptions, CheckOperationInput, CheckOperationOptions, CheckPoolFundingInput, CheckRWAOpenRequirementsInput, CheckRWAOpeningInput, CheckSimulationInput, CheckWalletAllowanceInput, CheckWalletBalanceInput, CheckWalletInput, CollateralFundingPreview, CollateralisedArgs, CreditAccountFrozenArgs, CreditManagerPausedArgs, CreditOperationArgs, CreditOperationError, CreditOperationPreview, CreditSimulationInput, DebtLimitsArgs, EmergencyLiquidatorArgs, ForbiddenTokenArgs, HealthFactorThresholds, type IntentValidationError, LeverageArgs, LiquidationEligibilityError, LiquidationValidationError, LiquidatorEligibleArgs, MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM, MarketExpiredArgs, MarketStateError, OperationValidationError, PoolLiquidityArgs, PoolOperationArgs, PoolOperationError, PoolPausedArgs, PoolSimulationInput, PoolSunsetArgs, QuotaCountArgs, QuotaLimitArgs, SimulationValidationError, WalletFundingError, WeighedFactors, amountOf, checkAccountQuotas, checkBorrowLimit, checkCollateralFunding, checkCollateralised, checkCreditAccountFrozen, checkCreditManagerPaused, checkCreditOperation, checkDebtLimits, checkDraw, checkEmergencyLiquidator, checkForbiddenToken, checkHealthFactors, checkLeverage, checkLiquidation, checkLiquidationEligibility, checkLiquidationFunding, checkLiquidatorEligible, checkMarket, checkMarketExpired, checkObtained, checkOperation, checkPoolFunding, checkPoolLiquidity, checkPoolOperation, checkPoolPaused, checkPoolSunset, checkQuotaCount, checkQuotaLimit, checkQuotasAsked, checkRWAOpenRequirements, checkRWAOpening, checkSimulation, checkWallet, checkWalletAllowance, checkWalletBalance, raise, toToken, toTokenAmount };
+export { BorrowLimitArgs, CheckCollateralFundingInput, CheckLiquidationEligibilityInput, CheckLiquidationFundingInput, CheckLiquidationInput, CheckLiquidationOptions, CheckOperationInput, CheckOperationOptions, CheckPoolFundingInput, CheckRWAOpenRequirementsInput, CheckRWAOpeningInput, CheckSimulationInput, CheckWalletAllowanceInput, CheckWalletBalanceInput, CheckWalletInput, CollateralFundingPreview, CollateralisedArgs, CreditAccountFrozenArgs, CreditManagerPausedArgs, CreditOperationArgs, CreditOperationError, CreditOperationPreview, CreditSimulationInput, DebtLimitsArgs, EmergencyLiquidatorArgs, ForbiddenTokenArgs, HealthFactorThresholds, type IntentValidationError, LeverageArgs, LiquidationEligibilityError, LiquidationValidationError, LiquidatorEligibleArgs, MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM, MarketExpiredArgs, MarketStateError, OperationValidationError, PoolLiquidityArgs, PoolOperationArgs, PoolOperationError, PoolPausedArgs, PoolSunsetArgs, QuotaCountArgs, QuotaLimitArgs, SimulationValidationError, WalletFundingError, WeighedFactors, amountOf, checkAccountQuotas, checkBorrowLimit, checkCollateralFunding, checkCollateralised, checkCreditAccountFrozen, checkCreditManagerPaused, checkCreditOperation, checkDebtLimits, checkDraw, checkEmergencyLiquidator, checkForbiddenToken, checkHealthFactors, checkLeverage, checkLiquidation, checkLiquidationEligibility, checkLiquidationFunding, checkLiquidatorEligible, checkMarket, checkMarketExpired, checkObtained, checkOperation, checkPoolFunding, checkPoolLiquidity, checkPoolOperation, checkPoolPaused, checkPoolSunset, checkQuotaCount, checkQuotaLimit, checkQuotasAsked, checkRWAOpenRequirements, checkRWAOpening, checkSimulation, checkWallet, checkWalletAllowance, checkWalletBalance, raise, toToken, toTokenAmount };

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

@@ -1,9 +1,10 @@
-import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure } from "../model/errors/prepare-errors.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, noStrategyTargetCollateral, unexpectedFailure } from "../model/errors/prepare-errors.js";
 import { LeverageBand } from "../onchain/accounts/intents/leverage-band.js";
 import { OperationState, PathLossRate, RouteErrors, WithdrawCeilings } from "../onchain/accounts/intents/types.js";
+import { PoolOperationError } from "../onchain/validation/bundles/checkPoolOperation.js";
 import { IAnalytics, IAnalyticsByMode } from "./analytics/types.js";
 import { ILiquidations, ILiquidationsByMode } from "./liquidations/types.js";
-import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/types.js";
+import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, OpenFlowError, OpenStrategyEmptyParams, OpenStrategyFundedParams, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/types.js";
 import { ChainOf, PrepareApi } from "./prepare/PrepareApi.js";
 import "./prepare/index.js";
 import { AccountPrepareRequest, IOpportunitiesExecute, OpenPrepareRequest, PoolPrepareRequest, PrepareRequest } from "./execute/types.js";
@@ -37,4 +38,4 @@ import { SourceUnavailableError } from "./errors/SourceUnavailableError.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
 import { everyChainFailed } from "./errors/everyChainFailed.js";
 import "./errors/index.js";
-export { AbstractNamespace, AccountFlowError, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, AnalyticsNamespace, ChainOf, ChainRef, CheckOperationProps, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DelayedStrategyResult, DepositStrategyParams, type EmptyOpenTakesNothingError, EnsureFreshChains, type EntityMerger, ExecuteApi, type FilterResult, FinalizeParams, FinalizeResult, GearboxSDK, GearboxSDKOptions, IAnalytics, IAnalyticsByMode, IGearboxSDK, ILiquidations, ILiquidationsByMode, INotices, INoticesByMode, IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesExecute, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunitiesPrepare, IOpportunityMergers, IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, IPreview, IPreviewByMode, type LeverageBand, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpResult, LpState, type MergeListResult, MergedQuery, MissingSourceError, Mode, type MultipleDelayedWithdrawalsError, NamespaceOptions, type NoDelayedRouteError, type NoRecordedIntentError, NoSourceServedError, type NoStrategyTargetCollateralError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenFlowError, OpenPrepareRequest, OpenStrategyParams, OpenStrategyResult, type OperationState, OpportunitiesNamespace, type PathLossRate, PlainMultichainSDKOptions, PoolInput, PoolPrepareRequest, PositionInput, PositionsNamespace, PrepareApi, PrepareOptions, PrepareRequest, PreviewNamespace, RepayStrategyParams, type RouteErrors, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, unexpectedFailure };
+export { AbstractNamespace, AccountFlowError, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, AnalyticsNamespace, ChainOf, ChainRef, CheckOperationProps, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DelayedStrategyResult, DepositStrategyParams, EnsureFreshChains, type EntityMerger, ExecuteApi, type FilterResult, FinalizeParams, FinalizeResult, GearboxSDK, GearboxSDKOptions, IAnalytics, IAnalyticsByMode, IGearboxSDK, ILiquidations, ILiquidationsByMode, INotices, INoticesByMode, IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesExecute, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunitiesPrepare, IOpportunityMergers, IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, IPreview, IPreviewByMode, type LeverageBand, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpResult, LpState, type MergeListResult, MergedQuery, MissingSourceError, Mode, type MultipleDelayedWithdrawalsError, NamespaceOptions, type NoDelayedRouteError, type NoRecordedIntentError, NoSourceServedError, type NoStrategyTargetCollateralError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenFlowError, OpenPrepareRequest, OpenStrategyEmptyParams, OpenStrategyFundedParams, OpenStrategyParams, OpenStrategyResult, type OperationState, OpportunitiesNamespace, type PathLossRate, PlainMultichainSDKOptions, PoolInput, type PoolOperationError, PoolPrepareRequest, PositionInput, PositionsNamespace, PrepareApi, PrepareOptions, PrepareRequest, PreviewNamespace, RepayStrategyParams, type RouteErrors, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, unexpectedFailure };

package/dist/types/sdk/opportunities/OpportunitiesNamespace.d.ts

@@ -47,7 +47,11 @@ declare class OpportunitiesNamespace extends AbstractNamespace<MultichainSDK["op
   /**
    * {@inheritDoc IOpportunitiesBase.getStrategy}
    **/
-  getStrategy(key: StrategyOpportunityKey, wallet?: Address): Promise<DataResponse<StrategyOpportunityDetail>>;
+  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
+  /**
+   * {@inheritDoc IOpportunitiesOnchainOnly.isEligibleForStrategy}
+   **/
+  isEligibleForStrategy(key: StrategyOpportunityKey, wallet: Address): Promise<boolean>;
   /**
    * {@inheritDoc IOpportunitiesBase.filter}
    **/

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

@@ -30,10 +30,11 @@ interface IOpportunitiesBase {
    **/
   getPool(key: PoolOpportunityKey): Promise<DataResponse<PoolOpportunityDetail>>;
   /**
-   * Detailed view of one strategy opportunity. With `wallet`, `kyc` tells whether
-   * that wallet must register with the strategy's KYC provider before opening.
+   * Detailed view of one strategy opportunity. `kyc` is the strategy's KYC
+   * gate, independent of any wallet. Use {@link IOpportunitiesOnchainOnly.isEligibleForStrategy}
+   * for a wallet verdict.
    **/
-  getStrategy(key: StrategyOpportunityKey, wallet?: Address): Promise<DataResponse<StrategyOpportunityDetail>>;
+  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
   /**
    * Narrows an already-read list, rows and metadata alike. `undefined` passes
    * through, so a read still in flight stays that way, and a list already read
@@ -88,6 +89,11 @@ interface IOpportunitiesOnchainOnly {
    * same reason as {@link prepare}: it encodes against live chain state.
    **/
   readonly execute: IOpportunitiesExecute;
+  /**
+   * Whether `wallet` may open this strategy today: `true` when it is not
+   * KYC-gated or the wallet already passed the gate. Chain-only.
+   **/
+  isEligibleForStrategy(key: StrategyOpportunityKey, wallet: Address): Promise<boolean>;
 }
 /**
  * The chain on its own, for a consumer that shows each source as it arrives.

package/dist/types/sdk/prepare/PrepareApi.d.ts

@@ -1,6 +1,6 @@
 import { Bps, ChainId } from "../../model/primitives.js";
 import { DebtOutOfRangeError, InsufficientPoolLiquidityError, LeverageOutOfRangeError } from "../../model/errors/operation-errors.js";
-import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
 import { PositionCollateral, StrategyPosition } from "../../model/positions.js";
 import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
@@ -10,6 +10,7 @@ import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import { MultichainConstruct } from "../../onchain/base/MultichainConstruct.js";
 import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
+import { PoolOperationError } from "../../onchain/validation/bundles/checkPoolOperation.js";
 import "../../onchain/index.js";
 import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
 import { EnsureFreshChains } from "../types.js";
@@ -54,19 +55,19 @@ declare class PrepareApi extends MultichainConstruct implements IOpportunitiesPr
   /**
    * {@inheritDoc IOpportunitiesPrepare.deposit}
    **/
-  deposit(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError>>;
+  deposit(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError | PoolOperationError>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.withdraw}
    **/
-  withdraw(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError>>;
+  withdraw(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError | PoolOperationError>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.redeem}
    **/
-  redeem(pool: PoolInput, params: LpRedeemParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError>>;
+  redeem(pool: PoolInput, params: LpRedeemParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError | PoolOperationError>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.openNewStrategy}
    **/
-  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError | EmptyOpenTakesNothingError | CreditAccountNotFoundError | CreditAccountNotEmptyError>>;
+  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError | CreditAccountNotFoundError | CreditAccountNotEmptyError>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.depositStrategy}
    **/

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

@@ -1,7 +1,8 @@
-import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure } from "../../model/errors/prepare-errors.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, noStrategyTargetCollateral, unexpectedFailure } from "../../model/errors/prepare-errors.js";
 import "../../model/index.js";
 import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { OperationState, PathLossRate, RouteErrors, WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
-import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
+import { PoolOperationError } from "../../onchain/validation/bundles/checkPoolOperation.js";
+import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, OpenFlowError, OpenStrategyEmptyParams, OpenStrategyFundedParams, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
 import { ChainOf, PrepareApi } from "./PrepareApi.js";
-export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, ChainOf, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, type EmptyOpenTakesNothingError, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, PositionInput, PrepareApi, PrepareOptions, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure };
+export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, ChainOf, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyEmptyParams, OpenStrategyFundedParams, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, type PoolOperationError, PositionInput, PrepareApi, PrepareOptions, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, noStrategyTargetCollateral, unexpectedFailure };

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

@@ -1,7 +1,7 @@
 import { Bps, Timestamp, TokenAmount } from "../../model/primitives.js";
 import { Curator } from "../../model/curators.js";
 import { CreditManagerPausedError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MarketExpiredError, QuotaLimitReachedError } from "../../model/errors/operation-errors.js";
-import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
 import { PoolOpportunityKey, StrategyOpportunityKey } from "../../model/opportunities.js";
 import { PositionCollateral, StrategyPosition, StrategyPositionKey } from "../../model/positions.js";
 import { SDKReturn } from "../../model/result.js";
@@ -14,6 +14,7 @@ import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { AccountCalculatorOperation } from "../../onchain/accounts/intents/operations.js";
 import { ClaimRemainder, DelayedStart, OperationState, PathLossRate, ResumableIntent, RouteErrors, WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
 import { OpenStrategyState } from "../../onchain/accounts/intents/open-strategy.js";
+import { PoolOperationError } from "../../onchain/validation/bundles/checkPoolOperation.js";
 import "../../onchain/index.js";
 import { Address } from "viem";
 //#region src/sdk/prepare/types.d.ts
@@ -337,7 +338,15 @@ interface WithdrawCollateralParams extends PrepareOptions {
   /** Wallet receiving the tokens. */
   to: Address;
 }
-interface OpenStrategyParams extends PrepareOptions {
+/**
+ * Opening a position, in one of the two shapes an opening comes in.
+ *
+ * The union is the check: an empty opening names nothing to open with, so
+ * collateral it meant to spend or an account it meant to reuse cannot be
+ * silently dropped — those arguments do not typecheck against `empty: true`.
+ **/
+type OpenStrategyParams = OpenStrategyFundedParams | OpenStrategyEmptyParams;
+interface OpenStrategyFundedParams extends PrepareOptions {
   /** Collateral coming from the wallet, in their own tokens. */
   collateral: Asset[];
   /**
@@ -355,25 +364,42 @@ interface OpenStrategyParams extends PrepareOptions {
    * Existing credit account to open the position on, instead of creating one.
    *
    * Must belong to `strategy.creditManager` and carry no debt and no quotas —
-   * an account pre-opened by an {@link empty} opening.
+   * an account pre-opened by an {@link OpenStrategyEmptyParams} opening.
    * The projection is identical either way; only the transaction differs, and
    * `execute.buildTx` reads which one to build off the result's own
    * `state.creditAccount`.
    **/
   creditAccount?: Address;
-  /**
-   * Open the account holding nothing: no collateral, no debt, no quotas, and no
-   * route quoted. A wallet holds one so a position can be put on it later, by
-   * an opening that names it as {@link creditAccount}.
-   *
-   * {@link collateral} must be empty, {@link leverage} zero and
-   * {@link creditAccount} unset — the flag and the arguments have to agree.
-   * Neither leverage nor {@link targetToken} is read: with no collateral the
-   * debt is zero at any leverage, and there is nothing to route anywhere. Zero
-   * is the one leverage an ordinary opening refuses, so it cannot be mistaken
-   * for a request.
-   **/
-  empty?: boolean;
+  empty?: false;
+}
+/**
+ * Opening an account that holds nothing: no collateral, no debt, no quotas, and
+ * no route quoted. A wallet holds one so a position can be put on it later, by
+ * an opening that names it as
+ * {@link OpenStrategyFundedParams.creditAccount}.
+ *
+ * The market is the whole request. There is nothing else to say: with no
+ * collateral the debt is zero at any leverage, and there is nothing to route
+ * anywhere — so leverage and a target token are not merely ignored here, they
+ * cannot be named.
+ **/
+interface OpenStrategyEmptyParams {
+  empty: true;
+  /**
+   * The three an empty opening would otherwise have to drop, spelled out as
+   * `never` rather than merely left out.
+   *
+   * A bare `{ empty: true }` is a structural type, and excess-property checking
+   * only fires on a fresh object literal — so params built up in a variable, as
+   * a form builds them, would pass on the extra members and have them silently
+   * dropped. Naming them closes that: the shape is refused wherever it is
+   * written, and `empty` typed as a plain `boolean` is refused by both branches.
+   **/
+  collateral?: never;
+  leverage?: never;
+  creditAccount?: never;
+  targetToken?: never;
+  leftoverBalances?: never;
 }
 interface LpParams {
   /**
@@ -460,7 +486,7 @@ interface IOpportunitiesPrepare {
    * loaded already; the wait is for the one thing that is not, the shares the
    * wallet holds, without which {@link LpState.netValue} cannot be said.
    **/
-  deposit(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError>>;
+  deposit(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError | PoolOperationError>>;
   /**
    * Taking underlying out of a pool: `amount` is the `tokenOut` the wallet
    * wants back, and the pool burns whatever shares that costs.
@@ -468,19 +494,19 @@ interface IOpportunitiesPrepare {
    * The LP counterpart of {@link withdrawStrategy} / {@link withdrawCollateral},
    * which act on credit accounts.
    **/
-  withdraw(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError>>;
+  withdraw(pool: PoolInput, params: LpParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError | PoolOperationError>>;
   /**
    * Redeeming pool shares: `amount` is the `tokenIn` the wallet parts with,
    * and the reported state is the underlying it converts to.
    **/
-  redeem(pool: PoolInput, params: LpRedeemParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError>>;
+  redeem(pool: PoolInput, params: LpRedeemParams): Promise<SDKReturn<LpResult, UnsupportedTokenPairError | UnexpectedFailureError | PoolOperationError>>;
   /**
    * Opening a leveraged position from wallet collateral.
    *
    * The one flow with no account yet, so the result carries no operation list —
    * it feeds `sdk.accounts.openCA` instead.
    **/
-  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError | EmptyOpenTakesNothingError | CreditAccountNotFoundError | CreditAccountNotEmptyError>>;
+  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError | CreditAccountNotFoundError | CreditAccountNotEmptyError>>;
   /**
    * Growing a position: collateral in, debt drawn on top, both converted into
    * the position token.
@@ -662,4 +688,4 @@ interface IOpportunitiesPrepare {
   finalize(position: PositionInput, params: FinalizeParams): Promise<SDKReturn<FinalizeResult, AccountFlowError | NoRecordedIntentError | NoDelayedRouteError | WithdrawalInProgressError | UnsupportedTokenPairError>>;
 }
 //#endregion
-export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, type EmptyOpenTakesNothingError, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError };
+export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyEmptyParams, OpenStrategyFundedParams, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, type PoolOperationError, PositionInput, PrepareOptions, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "16.3.0-next.2",
+  "version": "16.3.0-next.4",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {