@gearbox-protocol/sdk 16.0.0-next.43 → 16.0.0-next.44

package/dist/types/preview/parse/parseOperationCalldata.d.ts

@@ -1,6 +1,10 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
+import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import "../../onchain/index.js";
 import { Operation } from "./types.js";
+import { UnsupportedPoolFunctionError, UnsupportedTargetError } from "./errors.js";
 import { PreviewOperationInput } from "../types.js";
 //#region src/preview/parse/parseOperationCalldata.d.ts
 /**
@@ -9,6 +13,6 @@ import { PreviewOperationInput } from "../types.js";
  * Support parsing of pool operations (including via zappers),
  * credit facade operations and RWA factory operations.
  */
-declare function parseOperationCalldata<P extends PluginsMap>(input: PreviewOperationInput<P>): Operation;
+declare function parseOperationCalldata<P extends PluginsMap>(input: PreviewOperationInput<P>): SDKReturn<Operation, UnsupportedTargetError | UnsupportedPoolFunctionError | UnsupportedZapperFunctionError>;
 //#endregion
 export { parseOperationCalldata };

package/dist/types/preview/parse/parsePoolOperationCalldata.d.ts

@@ -1,8 +1,11 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
 import { PoolV310Contract } from "../../onchain/market/pool/PoolV310Contract.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 import "../../onchain/index.js";
 import { PoolOperation } from "./types-pools.js";
 import "./types.js";
+import { UnsupportedPoolFunctionError } from "./errors.js";
 import { Hex } from "viem";
 //#region src/preview/parse/parsePoolOperationCalldata.d.ts
 /**
@@ -11,8 +14,8 @@ import { Hex } from "viem";
  * @param sdk - The SDK instance.
  * @param pool - The pool contract.
  * @param calldata - The calldata to parse.
- * @returns The parsed operation.
+ * @returns The parsed operation behind `ok`, or the refusal.
  */
-declare function parsePoolOperationCalldata(sdk: OnchainSDK, pool: PoolV310Contract, calldata: Hex): PoolOperation;
+declare function parsePoolOperationCalldata(sdk: OnchainSDK, pool: PoolV310Contract, calldata: Hex): SDKReturn<PoolOperation, UnsupportedPoolFunctionError>;
 //#endregion
 export { parsePoolOperationCalldata };

package/dist/types/preview/prerequisites/checkPrerequisites.d.ts

@@ -1,6 +1,11 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
+import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import "../../onchain/index.js";
+import { UnsupportedPoolFunctionError, UnsupportedTargetError } from "../parse/errors.js";
 import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import "../parse/index.js";
 import { PrerequisiteResult } from "./types.js";
 //#region src/preview/prerequisites/checkPrerequisites.d.ts
 /**
@@ -18,6 +23,6 @@ import { PrerequisiteResult } from "./types.js";
  * (e.g. pool is paused) is intentionally out of scope, since the user cannot
  * resolve it.
  */
-declare function checkPrerequisites<P extends PluginsMap>(input: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<PrerequisiteResult[]>;
+declare function checkPrerequisites<P extends PluginsMap>(input: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<SDKReturn<PrerequisiteResult[], UnsupportedTargetError | UnsupportedPoolFunctionError | UnsupportedZapperFunctionError>>;
 //#endregion
 export { checkPrerequisites };

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

@@ -1,5 +1,7 @@
 import { DelayedIntent } from "../../model/delayed-intents.js";
+import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
+import { InvalidDelayedIntentError } from "../../onchain/accounts/withdrawal-compressor/errors.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 import "../../onchain/index.js";
@@ -41,12 +43,11 @@ declare function detectDelayedClaim<P extends PluginsMap>(sdk: OnchainSDK<P>, mu
  * @param sdk - Attached SDK.
  * @param multicall - Parsed inner operations of the multicall.
  * @param blockNumber - Optional block number to read the log at.
- * @returns The decoded intent, or `undefined` when the multicall claims
- * nothing, the redemption logger is not deployed, or the log carries no
- * intent.
- * @throws InvalidDelayedIntentError when the logged `extraData` is non-empty
- * but cannot be decoded as a `DelayedIntent`.
+ * @returns The decoded intent behind `ok` (`undefined` when the multicall
+ * claims nothing, the redemption logger is not deployed, or the log carries
+ * no intent), or the `invalidDelayedIntent` refusal when the logged
+ * `extraData` is non-empty but cannot be decoded as a `DelayedIntent`.
  */
-declare function resolveDelayedClaimIntent<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[], blockNumber?: bigint): Promise<DelayedIntent | undefined>;
+declare function resolveDelayedClaimIntent<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[], blockNumber?: bigint): Promise<SDKReturn<DelayedIntent | undefined, InvalidDelayedIntentError>>;
 //#endregion
 export { DetectedDelayedClaim, detectDelayedClaim, resolveDelayedClaimIntent };

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

@@ -1,5 +1,7 @@
 import { DelayedIntent } from "../../model/delayed-intents.js";
+import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
+import { InvalidDelayedIntentError } from "../../onchain/accounts/withdrawal-compressor/errors.js";
 import { DelayedWithdrawalRequest } from "../../onchain/market/adapters/types.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
@@ -32,6 +34,6 @@ interface DetectedDelayedOperation {
  * @throws InvalidDelayedIntentError when a request carries non-empty
  * `extraData` that cannot be decoded as a `DelayedIntent`.
  */
-declare function detectDelayedOperation<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[]): DetectedDelayedOperation | undefined;
+declare function detectDelayedOperation<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[]): SDKReturn<DetectedDelayedOperation | undefined, InvalidDelayedIntentError>;
 //#endregion
 export { DetectedDelayedOperation, detectDelayedOperation };

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

@@ -2,7 +2,7 @@ import { IGearboxError } from "../../model/errors.js";
 import "../../model/index.js";
 //#region src/preview/preview/errors.d.ts
 /**
- * Verdict answered by `previewOperation` for parsed operations it cannot
+ * Refusal answered by `previewOperation` for parsed operations it cannot
  * preview yet. A plain returned object per the SDK's refusal vocabulary —
  * not a thrown `Error`.
  */
@@ -11,14 +11,5 @@ interface UnsupportedOperationError extends IGearboxError {
   /** The parsed operation kind (the `operation` discriminant). */
   operation: string;
 }
-/**
- * Builds the verdict. Callable with or without `new`, so pre-declassing raise
- * sites keep compiling; `instanceof` matches on the `code` discriminant, and
- * the answer is never an `Error`.
- */
-declare const UnsupportedOperationError: {
-  (operation: string): UnsupportedOperationError;
-  new (operation: string): UnsupportedOperationError;
-};
 //#endregion
 export { UnsupportedOperationError };

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

@@ -7,7 +7,7 @@ import { UnsupportedOperationError } from "./errors.js";
 import { estimateClaimableAt } from "./estimateClaimableAt.js";
 import { previewAdjustStrategyPosition } from "./previewAdjustStrategyPosition.js";
 import { CloseOrRepayOperation, previewExitOrRepayStrategyPosition } from "./previewExitOrRepayStrategyPosition.js";
-import { PreviewVerdictError, previewOperation } from "./previewOperation.js";
+import { PreviewOperationError, previewOperation } from "./previewOperation.js";
 import { ReplayState, makeReplayState, replayInnerOperations } from "./replayInnerOperations.js";
 import { ReplayMulticallResult, ReplayableOperation, replayMulticall } from "./replayMulticall.js";
-export { CloseOrRepayOperation, CreditAccountState, CreditAccountStateProps, DetectedDelayedClaim, DetectedDelayedOperation, PreviewVerdictError, ReplayMulticallResult, ReplayState, ReplayableOperation, UnsupportedOperationError, buildDelayedStrategyPositionOperationPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, estimateClaimableAt, isCloseOrRepay, makeReplayState, previewAdjustStrategyPosition, previewExitOrRepayStrategyPosition, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+export { CloseOrRepayOperation, CreditAccountState, CreditAccountStateProps, DetectedDelayedClaim, DetectedDelayedOperation, PreviewOperationError, ReplayMulticallResult, ReplayState, ReplayableOperation, UnsupportedOperationError, buildDelayedStrategyPositionOperationPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, estimateClaimableAt, isCloseOrRepay, makeReplayState, previewAdjustStrategyPosition, previewExitOrRepayStrategyPosition, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };

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

@@ -1,9 +1,9 @@
 import { OperationPreview } from "../../model/previews.js";
 import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
+import { InvalidDelayedIntentError } from "../../onchain/accounts/withdrawal-compressor/errors.js";
 import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
-import { InvalidDelayedIntentError } from "../../onchain/accounts/withdrawal-compressor/errors.js";
 import "../../onchain/index.js";
 import { UnsupportedPoolFunctionError, UnsupportedTargetError } from "../parse/errors.js";
 import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
@@ -12,21 +12,21 @@ import { UnsupportedOperationError } from "./errors.js";
 import { PreviewSimulationError } from "../simulate/errors.js";
 //#region src/preview/preview/previewOperation.d.ts
 /**
- * Everything {@link previewOperation} can refuse with: the verdicts its
- * pipeline raises, discriminated by `code`. Each is a plain object — never a
- * thrown `Error` — per the SDK's refusal vocabulary.
+ * Everything {@link previewOperation} can refuse with: the refusal errors
+ * its pipeline raises, discriminated by `code`. Each is a plain object —
+ * never a thrown `Error` — per the SDK's refusal vocabulary.
  */
-type PreviewVerdictError = UnsupportedTargetError | UnsupportedPoolFunctionError | UnsupportedZapperFunctionError | UnsupportedOperationError | InvalidDelayedIntentError | PreviewSimulationError;
+type PreviewOperationError = UnsupportedTargetError | UnsupportedPoolFunctionError | UnsupportedZapperFunctionError | UnsupportedOperationError | InvalidDelayedIntentError | PreviewSimulationError;
 /**
  * Previews a raw operation calldata: decodes it into a typed operation and
  * assembles an operation-specific, human-displayable preview.
  *
  * Answers an {@link SDKReturn} envelope: the preview behind `ok: true`, or —
  * when the transaction is one the previewer refuses to read — a
- * {@link PreviewVerdictError} behind `ok: false`. A thrown exception still
- * means the SDK could not do its job (a read failed, the targeted credit
- * account could not be resolved), not a verdict on the transaction.
+ * {@link PreviewOperationError} behind `ok: false`. A thrown exception
+ * still means the SDK could not do its job (a read failed, the targeted
+ * credit account could not be resolved), not a refusal of the transaction.
  */
-declare function previewOperation<P extends PluginsMap = PluginsMap>(input: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewVerdictError>>;
+declare function previewOperation<P extends PluginsMap = PluginsMap>(input: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewOperationError>>;
 //#endregion
-export { PreviewVerdictError, previewOperation };
+export { PreviewOperationError, previewOperation };

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

@@ -1,11 +1,13 @@
 import { PoolPositionOperationPreview } from "../../model/previews.js";
+import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import "../../onchain/index.js";
 import { PoolOperation } from "../parse/types-pools.js";
 import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
 import "../parse/index.js";
+import { PreviewSimulationError } from "../simulate/errors.js";
 //#region src/preview/preview/previewPoolPositionOperation.d.ts
-declare function previewPoolPositionOperation<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: PoolOperation, options?: PreviewOperationOptions): Promise<PoolPositionOperationPreview>;
+declare function previewPoolPositionOperation<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: PoolOperation, options?: PreviewOperationOptions): Promise<SDKReturn<PoolPositionOperationPreview, PreviewSimulationError>>;
 //#endregion
 export { previewPoolPositionOperation };

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

@@ -10,26 +10,17 @@ interface SimulationFlowFailure {
   detail: SimulationError;
 }
 /**
- * Verdict answered when the pool simulation fails. It wraps each flow's
+ * Refusal answered when the pool simulation fails. It wraps each flow's
  * decoded revert reason (see {@link failures}). A plain returned object per
  * the SDK's refusal vocabulary — not a thrown `Error`.
  */
 interface PreviewSimulationError extends IGearboxError {
   code: "previewSimulationFailed";
-  /** Per-flow decoded failures behind this verdict. */
+  /** Per-flow decoded failures behind this refusal. */
   failures: SimulationFlowFailure[];
   /** First flow failure that was itself an `Error`, kept for debugging. */
   cause?: Error;
 }
-/**
- * Builds the verdict. Callable with or without `new`, so pre-declassing raise
- * sites keep compiling; `instanceof` matches on the `code` discriminant, and
- * the answer is never an `Error`.
- */
-declare const PreviewSimulationError: {
-  (failures: SimulationFlowFailure[]): PreviewSimulationError;
-  new (failures: SimulationFlowFailure[]): PreviewSimulationError;
-};
 /**
  * Normalises an unknown rejection reason into a {@link PreviewSimulationError}.
  * Pass-through when it already is one; otherwise decodes it under `source`.

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

@@ -1,7 +1,7 @@
-import { PreviewSimulationError, SimulationError, SimulationFlowFailure, SimulationFlowSource } from "./errors.js";
+import { PreviewSimulationError, SimulationError, SimulationFlowFailure, SimulationFlowSource, asPreviewSimulationError } from "./errors.js";
 import { PoolOperationSimulationResult, SimulationInput } from "./types.js";
 import { simulateFacadeOperation } from "./simulateFacadeOperation.js";
 import { simulateOperation } from "./simulateOperation.js";
 import { simulatePoolOperation } from "./simulatePoolOperation.js";
 import { simulateRWAOperation } from "./simulateRWAOperation.js";
-export { type PoolOperationSimulationResult, PreviewSimulationError, type SimulationError, type SimulationFlowFailure, type SimulationFlowSource, type SimulationInput, simulateFacadeOperation, simulateOperation, simulatePoolOperation, simulateRWAOperation };
+export { type PoolOperationSimulationResult, type PreviewSimulationError, type SimulationError, type SimulationFlowFailure, type SimulationFlowSource, type SimulationInput, asPreviewSimulationError, simulateFacadeOperation, simulateOperation, simulatePoolOperation, simulateRWAOperation };

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

@@ -1,9 +1,12 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
 import { PreviewOperationOptions } from "../types.js";
+import { PreviewSimulationError } from "./errors.js";
 import { PoolOperationSimulationResult, SimulationInput } from "./types.js";
 //#region src/preview/simulate/simulateOperation.d.ts
 /**
  * Simulates a parsed pool or credit account operation
  */
-declare function simulateOperation(input: SimulationInput, options?: PreviewOperationOptions): Promise<PoolOperationSimulationResult>;
+declare function simulateOperation(input: SimulationInput, options?: PreviewOperationOptions): Promise<SDKReturn<PoolOperationSimulationResult, PreviewSimulationError>>;
 //#endregion
 export { simulateOperation };

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

@@ -1,6 +1,9 @@
+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";
 //#region src/preview/simulate/simulatePoolOperation.d.ts
 /**
@@ -17,6 +20,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 };

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

@@ -235,7 +235,7 @@ interface CreditAccountNotFoundError extends IGearboxError {
  * connected to, a market or token address it knows nothing about, a contract
  * that reverted where nothing should, a bug of ours.
  *
- * The one code that is not a verdict on the request — everything above says
+ * The one code that is not a refusal of the request — everything above says
  * "this cannot be done", this one says "we do not know". It exists so that a
  * refusable `prepare` method always answers: the failure that used to escape
  * as an exception arrives here instead, whole, under `cause`.

package/dist/types/sdk/preview/PreviewNamespace.d.ts

@@ -3,7 +3,7 @@ import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
 import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import "../../onchain/index.js";
-import { PreviewVerdictError } from "../../preview/preview/previewOperation.js";
+import { PreviewOperationError } from "../../preview/preview/previewOperation.js";
 import "../../preview/index.js";
 import { IPreview } from "./types.js";
 import { NamespaceOptions } from "../types.js";
@@ -17,7 +17,7 @@ declare class PreviewNamespace implements IPreview {
   /**
    * {@inheritDoc IPreview.previewOperation}
    **/
-  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewVerdictError>>;
+  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewOperationError>>;
 }
 //#endregion
 export { PreviewNamespace };

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

@@ -1,7 +1,7 @@
 import { OperationPreview, PreviewOperationInput, PreviewOperationOptions } from "../../model/previews.js";
 import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
-import { PreviewVerdictError } from "../../preview/preview/previewOperation.js";
+import { PreviewOperationError } from "../../preview/preview/previewOperation.js";
 import "../../preview/index.js";
 //#region src/sdk/preview/types.d.ts
 /**
@@ -10,11 +10,11 @@ import "../../preview/index.js";
 interface IPreview {
   /**
    * Decodes a raw operation and assembles an operation-specific,
-   * human-displayable preview. A verdict on the calldata — an unsupported
+   * human-displayable preview. A refusal of the calldata — an unsupported
    * target, function or operation, a foreign delayed intent, a failed
    * simulation — is the `ok: false` half; genuine failures still throw.
    **/
-  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewVerdictError>>;
+  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewOperationError>>;
 }
 /**
  * `sdk.preview` per mode: an on-chain read, absent when the SDK reads no chain.

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

@@ -114,9 +114,7 @@ interface OnchainByMode {
  * The banners the backend attaches to a pool opportunity or a strategy
  * position, see {@link Notice}.
  **/
-interface INotices {
-  (subject: NoticeSubject): Promise<DataResponse<Notice[]>>;
-}
+type INotices = (subject: NoticeSubject) => Promise<DataResponse<Notice[]>>;
 /**
  * `sdk.notices` per mode: a backend read, absent when the SDK reads no backend.
  **/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "16.0.0-next.43",
+  "version": "16.0.0-next.44",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {