@gearbox-protocol/sdk 18.2.0-next.5 → 18.2.0-next.6

package/dist/types/testnets/errors/TestnetNotFoundError.d.ts

@@ -0,0 +1,12 @@
+import { TestnetStatusError } from "./TestnetStatusError.js";
+//#region src/testnets/errors/TestnetNotFoundError.d.ts
+/**
+ * Thrown when anvil-manager answered 404: there is no testnet with that
+ * execution id.
+ **/
+export declare class TestnetNotFoundError extends TestnetStatusError {
+  name: string;
+  readonly status: 404;
+  constructor(url: string, details?: string);
+}
+//#endregion

package/dist/types/testnets/errors/TestnetRequestFailedError.d.ts

@@ -0,0 +1,11 @@
+import { TestnetsError } from "./TestnetsError.js";
+//#region src/testnets/errors/TestnetRequestFailedError.d.ts
+/**
+ * Thrown when a request to anvil-manager never completed: the network was
+ * down, or it took longer than the client's timeout.
+ **/
+export declare class TestnetRequestFailedError extends TestnetsError {
+  name: string;
+  constructor(url: string, cause: unknown);
+}
+//#endregion

package/dist/types/testnets/errors/TestnetStatusError.d.ts

@@ -0,0 +1,15 @@
+import { TestnetsError } from "./TestnetsError.js";
+//#region src/testnets/errors/TestnetStatusError.d.ts
+/**
+ * Thrown when anvil-manager answered with a status outside the 2xx range. What
+ * it said about it, when it said anything, is the `details` of the error.
+ **/
+export declare class TestnetStatusError extends TestnetsError {
+  name: string;
+  /**
+   * Status anvil-manager answered with.
+   **/
+  readonly status: number;
+  constructor(url: string, status: number, details?: string);
+}
+//#endregion

package/dist/types/testnets/errors/TestnetValidationError.d.ts

@@ -0,0 +1,16 @@
+import { TestnetsError } from "./TestnetsError.js";
+import { z } from "zod/v4";
+//#region src/testnets/errors/TestnetValidationError.d.ts
+/**
+ * Thrown when anvil-manager answered, but with a payload the testnet schemas
+ * do not describe, i.e. the two are of different versions.
+ **/
+export declare class TestnetValidationError extends TestnetsError {
+  name: string;
+  /**
+   * The zod failure itself, e.g. for `z.treeifyError(error.zodError)`.
+   **/
+  readonly zodError: z.core.$ZodError;
+  constructor(url: string, zodError: z.core.$ZodError);
+}
+//#endregion

package/dist/types/testnets/errors/TestnetWaitTimeoutError.d.ts

@@ -0,0 +1,21 @@
+import { TestnetsError } from "./TestnetsError.js";
+//#region src/testnets/errors/TestnetWaitTimeoutError.d.ts
+/**
+ * Thrown when a testnet did not become ready before the wait for it ran out.
+ **/
+export declare class TestnetWaitTimeoutError extends TestnetsError {
+  name: string;
+  /**
+   * Execution id of the testnet that was waited for.
+   **/
+  readonly id: string;
+  /**
+   * How long the wait lasted, in milliseconds.
+   **/
+  readonly timeout: number;
+  /**
+   * @param url - Status URL that was polled.
+   **/
+  constructor(url: string, id: string, timeout: number);
+}
+//#endregion

package/dist/types/testnets/errors/TestnetsError.d.ts

@@ -0,0 +1,47 @@
+import { BaseError } from "viem";
+//#region src/testnets/errors/TestnetsError.d.ts
+/**
+ * What every failure of a testnet API call names, see {@link TestnetsError}.
+ **/
+export interface TestnetsErrorParams {
+  /**
+   * URL that was requested.
+   **/
+  url: string;
+  /**
+   * Status anvil-manager answered with, absent when the request never
+   * completed.
+   **/
+  status?: number;
+  /**
+   * Value that was caught. An `Error` becomes the `cause`, anything else is
+   * stringified into the details.
+   **/
+  cause?: unknown;
+  /**
+   * What anvil-manager itself said. Used only when there is no {@link cause},
+   * whose message viem reports instead.
+   **/
+  details?: string;
+  /**
+   * Extra lines reported after the URL and status.
+   **/
+  metaMessages?: string[];
+}
+/**
+ * Thrown by every testnet API call that fails. Its subclasses say how it
+ * failed; catch this one to catch all of them.
+ **/
+export declare abstract class TestnetsError extends BaseError {
+  /**
+   * URL that was requested.
+   **/
+  readonly url: string;
+  /**
+   * Status anvil-manager answered with, absent when the request never
+   * completed.
+   **/
+  readonly status?: number;
+  protected constructor(summary: string, params: TestnetsErrorParams);
+}
+//#endregion

package/dist/types/testnets/errors/index.d.ts

@@ -0,0 +1,7 @@
+import { TestnetsError, TestnetsErrorParams } from "./TestnetsError.js";
+import { TestnetStatusError } from "./TestnetStatusError.js";
+import { TestnetNotFoundError } from "./TestnetNotFoundError.js";
+import { TestnetRequestFailedError } from "./TestnetRequestFailedError.js";
+import { TestnetValidationError } from "./TestnetValidationError.js";
+import { TestnetWaitTimeoutError } from "./TestnetWaitTimeoutError.js";
+export { TestnetNotFoundError, TestnetRequestFailedError, TestnetStatusError, TestnetValidationError, TestnetWaitTimeoutError, TestnetsError, TestnetsErrorParams };

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

@@ -0,0 +1,11 @@
+import { CreateTestnetRequest, Testnet, TestnetBackendOptions, TestnetBackendState, TestnetBackendStatus, TestnetBlock, TestnetFiles, TestnetOptions, TestnetScript, TestnetScriptBlock, TestnetScriptOptions, TestnetScriptRequest, TestnetStageStatus, TestnetStatus, TestnetTask, TestnetTaskDefinition, TestnetTaskDefinitionRequest, TestnetTaskProgress } from "./types.js";
+import { TestnetsAPI, TestnetsAPIOptions, WaitUntilReadyOptions } from "./TestnetsAPI.js";
+import { TestnetsError, TestnetsErrorParams } from "./errors/TestnetsError.js";
+import { TestnetStatusError } from "./errors/TestnetStatusError.js";
+import { TestnetNotFoundError } from "./errors/TestnetNotFoundError.js";
+import { TestnetRequestFailedError } from "./errors/TestnetRequestFailedError.js";
+import { TestnetValidationError } from "./errors/TestnetValidationError.js";
+import { TestnetWaitTimeoutError } from "./errors/TestnetWaitTimeoutError.js";
+import "./errors/index.js";
+import { testnetBackendOptionsSchema, testnetBackendStateSchema, testnetBackendStatusSchema, testnetBlockSchema, testnetOptionsSchema, testnetSchema, testnetScriptBlockSchema, testnetScriptOptionsSchema, testnetScriptSchema, testnetStageStatusSchema, testnetStatusSchema, testnetTaskDefinitionSchema, testnetTaskProgressSchema, testnetTaskSchema } from "./schemas.js";
+export { CreateTestnetRequest, Testnet, TestnetBackendOptions, TestnetBackendState, TestnetBackendStatus, TestnetBlock, TestnetFiles, TestnetNotFoundError, TestnetOptions, TestnetRequestFailedError, TestnetScript, TestnetScriptBlock, TestnetScriptOptions, TestnetScriptRequest, TestnetStageStatus, TestnetStatus, TestnetStatusError, TestnetTask, TestnetTaskDefinition, TestnetTaskDefinitionRequest, TestnetTaskProgress, TestnetValidationError, TestnetWaitTimeoutError, TestnetsAPI, TestnetsAPIOptions, TestnetsError, TestnetsErrorParams, WaitUntilReadyOptions, testnetBackendOptionsSchema, testnetBackendStateSchema, testnetBackendStatusSchema, testnetBlockSchema, testnetOptionsSchema, testnetSchema, testnetScriptBlockSchema, testnetScriptOptionsSchema, testnetScriptSchema, testnetStageStatusSchema, testnetStatusSchema, testnetTaskDefinitionSchema, testnetTaskProgressSchema, testnetTaskSchema };