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

package/dist/types/permissionless/api/oracles/types.d.ts

@@ -1,30 +1,37 @@
+import { PermissionlessChain } from "../chains/types.js";
 import { PriceFeed } from "../../core/pricefeed.js";
 import "../../core/index.js";
 import { Address } from "viem";
 //#region src/permissionless/api/oracles/types.d.ts
 /**
- * One asset of a chain, with the feeds allowed for it. The backend indexes
- * the chain, so every feed listed here is one the PriceFeedStore carries and
- * allows for the asset.
+ * What identifies an asset, which is all a feed's own listing of one says.
+ *
+ * Used on its own where the asset hangs off something else — a feed's assets,
+ * say, where listing the feeds allowed for each would only name the feed back.
  **/
-export interface PermissionlessAsset {
+export interface PermissionlessPriceFeedAsset {
   address: Address;
   symbol: string;
   name: string;
   decimals: number;
+}
+/**
+ * One asset of a chain, with the feeds allowed for it. The backend indexes
+ * the chain, so every feed listed here is one the PriceFeedStore carries and
+ * allows for the asset.
+ **/
+export interface PermissionlessAsset extends PermissionlessPriceFeedAsset {
   owner: Address;
   priceFeeds: PriceFeed[];
 }
 /**
  * The PriceFeedStore of one chain as the backend has indexed it: the assets
  * it prices, the feeds it carries, and which feed is allowed on which asset.
+ *
+ * A store is a chain's, so it is described by the same fields the chain list
+ * answers with, plus what it holds.
  **/
-export interface PermissionlessPriceFeedStore {
-  chainId: number;
-  name: string;
-  isPublic: boolean;
-  isActivated: boolean;
-  explorerUrl: string;
+export interface PermissionlessPriceFeedStore extends PermissionlessChain {
   assets: PermissionlessAsset[];
   priceFeeds: PriceFeed[];
 }
@@ -38,25 +45,17 @@ export interface PermissionlessPrices {
   time: number;
 }
 /**
- * An asset the PriceFeedStore currently allows one feed to price.
+ * What names a market, whichever side it is being listed from.
  *
- * Narrower than {@link PermissionlessAsset} on purpose: this hangs off the
- * feed, so listing the feeds allowed for it would just name the feed back.
- **/
-export interface PermissionlessPriceFeedAsset {
-  address: Address;
-  symbol: string;
-  name: string;
-  decimals: number;
-}
-/**
- * One token a market prices with the feed.
+ * A feed's markets and an asset's markets are different reads, but what they
+ * say about the market is the same: who curates it, what it is denominated in
+ * and how much of its quota is taken. Only the thing the row is about differs,
+ * which is what each of the two below adds.
  *
- * A row per `(market, token, role)` rather than per market: the same feed can
- * be the main feed of one token and the reserve feed of another in the very
- * same market, and both are reported.
+ * "This token" throughout means whatever the extending row is about — the
+ * token the feed prices, or the asset the market holds as collateral.
  **/
-export interface PermissionlessPriceFeedMarket {
+export interface PermissionlessMarket {
   market: Address;
   marketConfigurator: Address;
   /** The configurator's own name, as the backend's sync recorded it. */
@@ -66,17 +65,12 @@ export interface PermissionlessPriceFeedMarket {
    * of the backend calls a market by as well.
    */
   marketName: string | null;
-  token: Address;
-  /** `null` for a token the backend has no metadata row for. */
-  tokenSymbol: string | null;
   /**
    * Symbol of the market's underlying, which is both what the market is
-   * pictured by and what its quota limit is denominated in.
+   * pictured by and what its quota figures are denominated in.
    */
   underlyingSymbol: string | null;
-  /** The feed is the market's reserve feed for this token, not its main one. */
-  reserve: boolean;
-  /** The token is the market's underlying. */
+  /** This token is the market's own underlying, so it is not quota-managed. */
   isUnderlying: boolean;
   /**
    * What the pool will take of this token, in units of the market's
@@ -101,6 +95,20 @@ export interface PermissionlessPriceFeedMarket {
    * holds no entry for at all.
    */
   quotaUsed: number | null;
+}
+/**
+ * One token a market prices with the feed.
+ *
+ * A row per `(market, token, role)` rather than per market: the same feed can
+ * be the main feed of one token and the reserve feed of another in the very
+ * same market, and both are reported.
+ **/
+export interface PermissionlessPriceFeedMarket extends PermissionlessMarket {
+  token: Address;
+  /** `null` for a token the backend has no metadata row for. */
+  tokenSymbol: string | null;
+  /** The feed is the market's reserve feed for this token, not its main one. */
+  reserve: boolean;
   /**
    * Staleness period this market's own price oracle holds for the slot, in
    * seconds.
@@ -165,19 +173,9 @@ export interface PermissionlessAssetMarketFeed {
  * columns of the same market's row, and the quota is the market's whatever
  * feed holds which slot.
  **/
-export interface PermissionlessAssetMarket {
-  market: Address;
-  marketConfigurator: Address;
-  /** The configurator's own name, as the backend's sync recorded it. */
-  curatorName: string | null;
-  /** The market's own name, which is the name of its pool token. */
-  marketName: string | null;
+export interface PermissionlessAssetMarket extends PermissionlessMarket {
   /** The market's underlying, which its quota figures are denominated in. */
   underlyingToken: Address;
-  /** `null` for an underlying the backend has no metadata row for. */
-  underlyingSymbol: string | null;
-  /** The asset is this market's own underlying, so it is not quota-managed. */
-  isUnderlying: boolean;
   /**
    * The market has been shut down.
    *
@@ -190,16 +188,6 @@ export interface PermissionlessAssetMarket {
   mainFeed: PermissionlessAssetMarketFeed | null;
   /** The feed the market falls back to, or `null` if it has none. */
   reserveFeed: PermissionlessAssetMarketFeed | null;
-  /**
-   * What the pool will take of the asset, in units of {@link underlyingToken}.
-   *
-   * `null` for an asset the quota keeper was never told a limit for, which the
-   * market's own underlying always is. A zero is a limit set to zero, and the
-   * two are different answers.
-   */
-  quotaLimit: number | null;
-  /** How much of {@link quotaLimit} is actually taken, in the same units. */
-  quotaUsed: number | null;
 }
 /**
  * One asset of the store: what prices it, and what it is used as collateral
@@ -318,6 +306,11 @@ export interface AssetArgs {
   chainId: number;
   address: Address;
 }
+/** Args of {@link PermissionlessOracles.assets}. */
+export interface AssetsArgs {
+  /** Omit for every chain the backend serves. */
+  chainId?: number;
+}
 /** Args of {@link PermissionlessOracles.getPrices}. */
 export interface GetPricesArgs {
   chainId: number;

package/dist/types/permissionless/api/schemas.d.ts

@@ -11,8 +11,6 @@ import { z } from "zod/v4";
  **/
 /** An address, in whatever case the backend serves it. */
 export declare const addressSchema: z.ZodCustom<`0x${string}`, `0x${string}`>;
-/** A `0x`-prefixed hex string, as viem's `Hex`. */
-export declare const hexSchema: z.ZodCustom<`0x${string}`, `0x${string}`>;
 /**
  * A record keyed by address. Spelled out here because zod types a record key
  * by the schema's output, which the branded `Address` is not inferred as.

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

@@ -13,7 +13,7 @@ import "./core/index.js";
 import { FunctionParams, ValueParams, encodeFunctionParams } from "./utils/abi-encoder.js";
 import { DeployArgs, DeployContractArgs, DeployPriceFeedArgs, PreparedDeployment, PreparedPriceFeedDeployment } from "./api/deploy/types.js";
 import { DEFAULT_DEPLOY_SALT, PermissionlessDeploy, priceFeedSalt } from "./api/deploy/PermissionlessDeploy.js";
-import { AssetArgs, GetPricesArgs, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessAssetSummary, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./api/oracles/types.js";
+import { AssetArgs, AssetsArgs, GetPricesArgs, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessAssetSummary, PermissionlessMarket, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./api/oracles/types.js";
 import { GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, PermissionlessOracles } from "./api/oracles/PermissionlessOracles.js";
 import { AddressProviderContract } from "./bindings/address-provider.js";
 import { BytecodeRepositoryContract } from "./bindings/bytecode-repository.js";
@@ -54,4 +54,4 @@ import { getPrices } from "./utils/price-update/get-prices.js";
 import { GetUpdatablePriceFeedsArgs, getUpdatablePriceFeeds } from "./utils/price-update/get-updatable-feeds.js";
 import { normalizeSignature } from "./utils/signature.js";
 import "./utils/index.js";
-export { AccessMode, AddAssetParams, AddFeedsArgs, AddressProviderContract, Addresses, AllowTokenParams, ArchiveTransport, ArchiveTransportConfig, AssetArgs, AttachChainsArgs, AuditEvent, Auditor, BYTECODE_REPOSITORY, Batch, Bytecode, BytecodeRepositoryContract, CCMConstructorParams, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, ChainScope, ChainSummaryArgs, ChainsNamespace, ChangeNamesArgs, ChangeStalenessPeriodsArgs, ConstructorParams, CreditManagerFees, CrossChainCall, CrossChainMultisigContract, DEFAULT_DEPLOY_SALT, DeployArgs, DeployContractArgs, DeployParams, DeployPriceFeedArgs, Deployment, DeploymentExtended, ForbidAdapterParams, ForbidFeedsArgs, ForbidTokenParams, FunctionParams, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GearboxPermissionless, GearboxPermissionlessOptions, GetPricesArgs, GetUpdatablePriceFeedsArgs, GovernorContract, INSTANCE_MANAGER, InputValueParams, InstanceManagerContract, InstanceOwnerTransactions, InstanceTxs, InstanceTxsArgs, MAINNET_CCM_CONSTRUCTOR_PARAMS, MAINNET_DEPLOYMENT_BLOCK, MAINNET_DEPLOYMENT_CCM_SALT, MAINNET_DEPLOYMENT_IM_SALT, MARKET_CONFIGURATOR_FACTORY, Market, MarketConfiguratorContract, MarketConfiguratorFactoryContract, PRICE_FEED_STORE, PUBLIC_CREATE2_FACTORY, PauseCreditManagerParams, PeripheryDomain, PermissionlessAnalytics, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessAssetSummary, PermissionlessChain, PermissionlessChainSummary, PermissionlessChainUnreachableError, PermissionlessDeploy, PermissionlessNotAttachedError, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PreparedDeployment, PreparedPriceFeedDeployment, PriceChartArgs, PriceFeed, PriceFeedArgs, PriceFeedChartPoint, PriceFeedConstructorParam, PriceFeedNotInStoreError, PriceFeedPair, PriceFeedParamType, PriceFeedParams, PriceFeedPriceChart, PriceFeedSaltMissingError, PriceFeedSetupParams, PriceFeedStalenessUnknownError, PriceFeedStoreContract, Proposal, QueuedAndExecutedTransaction, RecoveryMessage, RoutingManagerContract, SafeBatch, SafeMeta, SafeTx, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, Signature, TOKEN_COMPRESSOR, TimeLockContract, TimelockTransaction, TimelockTxParams, TimelockTxs, TokenCompressorContract, TreasurySplitterContract, UnpauseCreditManagerParams, ValueParams, WithdrawalCompressorContract, calculateChecksum, checkCreate2Deployment, checkCreate2DeploymentAddress, chunkedLogsTransport, convertPercent, convertQueueBatchToExecuteTx, convertRawTxToSafeMultisigTx, createCallData, createCreate2DeployRawTx, deepJsonParse, deployUsingPublicCreate2, deriveEffectiveStalenessPeriod, encodeFunctionParams, formatBytecodeSize, formatBytecodeVersion, getBlockNumberByTimestamp, getCreate2AddressPublicFactory, getCreate2DeploymentAddress, getPriceUpdateTx, getPrices, getSafeBatch, getSafeBatches, getUpdatablePriceFeeds, handleSalt, normalizeSignature, priceFeedSalt, priceFeedSetupParams, shortenHash, significantTrunc };
+export { AccessMode, AddAssetParams, AddFeedsArgs, AddressProviderContract, Addresses, AllowTokenParams, ArchiveTransport, ArchiveTransportConfig, AssetArgs, AssetsArgs, AttachChainsArgs, AuditEvent, Auditor, BYTECODE_REPOSITORY, Batch, Bytecode, BytecodeRepositoryContract, CCMConstructorParams, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, ChainScope, ChainSummaryArgs, ChainsNamespace, ChangeNamesArgs, ChangeStalenessPeriodsArgs, ConstructorParams, CreditManagerFees, CrossChainCall, CrossChainMultisigContract, DEFAULT_DEPLOY_SALT, DeployArgs, DeployContractArgs, DeployParams, DeployPriceFeedArgs, Deployment, DeploymentExtended, ForbidAdapterParams, ForbidFeedsArgs, ForbidTokenParams, FunctionParams, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GearboxPermissionless, GearboxPermissionlessOptions, GetPricesArgs, GetUpdatablePriceFeedsArgs, GovernorContract, INSTANCE_MANAGER, InputValueParams, InstanceManagerContract, InstanceOwnerTransactions, InstanceTxs, InstanceTxsArgs, MAINNET_CCM_CONSTRUCTOR_PARAMS, MAINNET_DEPLOYMENT_BLOCK, MAINNET_DEPLOYMENT_CCM_SALT, MAINNET_DEPLOYMENT_IM_SALT, MARKET_CONFIGURATOR_FACTORY, Market, MarketConfiguratorContract, MarketConfiguratorFactoryContract, PRICE_FEED_STORE, PUBLIC_CREATE2_FACTORY, PauseCreditManagerParams, PeripheryDomain, PermissionlessAnalytics, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessAssetSummary, PermissionlessChain, PermissionlessChainSummary, PermissionlessChainUnreachableError, PermissionlessDeploy, PermissionlessMarket, PermissionlessNotAttachedError, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PreparedDeployment, PreparedPriceFeedDeployment, PriceChartArgs, PriceFeed, PriceFeedArgs, PriceFeedChartPoint, PriceFeedConstructorParam, PriceFeedNotInStoreError, PriceFeedPair, PriceFeedParamType, PriceFeedParams, PriceFeedPriceChart, PriceFeedSaltMissingError, PriceFeedSetupParams, PriceFeedStalenessUnknownError, PriceFeedStoreContract, Proposal, QueuedAndExecutedTransaction, RecoveryMessage, RoutingManagerContract, SafeBatch, SafeMeta, SafeTx, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, Signature, TOKEN_COMPRESSOR, TimeLockContract, TimelockTransaction, TimelockTxParams, TimelockTxs, TokenCompressorContract, TreasurySplitterContract, UnpauseCreditManagerParams, ValueParams, WithdrawalCompressorContract, calculateChecksum, checkCreate2Deployment, checkCreate2DeploymentAddress, chunkedLogsTransport, convertPercent, convertQueueBatchToExecuteTx, convertRawTxToSafeMultisigTx, createCallData, createCreate2DeployRawTx, deepJsonParse, deployUsingPublicCreate2, deriveEffectiveStalenessPeriod, encodeFunctionParams, formatBytecodeSize, formatBytecodeVersion, getBlockNumberByTimestamp, getCreate2AddressPublicFactory, getCreate2DeploymentAddress, getPriceUpdateTx, getPrices, getSafeBatch, getSafeBatches, getUpdatablePriceFeeds, handleSalt, normalizeSignature, priceFeedSalt, priceFeedSetupParams, shortenHash, significantTrunc };

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

@@ -0,0 +1,108 @@
+import { ILogger } from "../onchain/types/logger.js";
+import { CreateTestnetRequest, Testnet, TestnetFiles, TestnetStatus } from "./types.js";
+//#region src/testnets/TestnetsAPI.d.ts
+/**
+ * Options of a {@link TestnetsAPI}.
+ **/
+export interface TestnetsAPIOptions {
+  /**
+   * Base URL of anvil-manager.
+   *
+   * @defaultValue `"https://anvil.gearbox.foundation"`
+   **/
+  baseUrl?: string;
+  /**
+   * API key sent as a bearer token with every request. Without it the private
+   * routes (create, kill) answer 401, which surfaces as a
+   * {@link TestnetStatusError}.
+   **/
+  apiKey?: string;
+  /**
+   * Timeout of one request, in milliseconds.
+   *
+   * @defaultValue `30_000`
+   **/
+  timeout?: number;
+  logger?: ILogger;
+}
+/**
+ * Options of {@link TestnetsAPI.waitUntilReady}.
+ **/
+export interface WaitUntilReadyOptions {
+  /**
+   * How long to wait for the testnet to become ready, in milliseconds.
+   *
+   * @defaultValue `600_000` (10 minutes)
+   **/
+  timeout?: number;
+  /**
+   * Pause between two status polls, in milliseconds.
+   *
+   * @defaultValue `5_000`
+   **/
+  interval?: number;
+}
+/**
+ * Client for anvil-manager, which runs the anvil forks Gearbox calls
+ * testnets. It manages non-persistent testnets only, addressed by their
+ * execution id.
+ *
+ * ```ts
+ * const testnets = new TestnetsAPI({ apiKey: process.env.ANVIL_MANAGER_API_KEY });
+ * const { executionId } = await testnets.create({ network: "Mainnet", timeout: "2h" });
+ * const status = await testnets.waitUntilReady(executionId);
+ * // ... use status.rpcUrl ...
+ * await testnets.kill(executionId);
+ * ```
+ *
+ * Every method throws a {@link TestnetsError} subclass when it fails, except
+ * when a response body is not JSON: then it rejects with the error of
+ * `response.json()`.
+ **/
+export declare class TestnetsAPI {
+  #private;
+  protected readonly logger?: ILogger;
+  constructor(options?: TestnetsAPIOptions);
+  /**
+   * Base URL every request of this client is sent to.
+   **/
+  get baseUrl(): string;
+  /**
+   * Every testnet anvil-manager knows of, persistent ones included.
+   **/
+  list(): Promise<Testnet[]>;
+  /**
+   * Status of one testnet.
+   *
+   * @param id - Execution id of the testnet.
+   * @throws {@link TestnetNotFoundError} when there is no such testnet.
+   **/
+  get(id: string): Promise<TestnetStatus>;
+  /**
+   * Starts a testnet. It answers as soon as the testnet is created, long
+   * before it is {@link TestnetStatus.ready}.
+   *
+   * @param files - Saved in the testnet's shared dir, where scripts and tasks
+   * can read them.
+   **/
+  create(request: CreateTestnetRequest, files?: TestnetFiles): Promise<TestnetStatus>;
+  /**
+   * Stops a testnet. Stopping one that is already stopped succeeds.
+   *
+   * @param id - Execution id of the testnet.
+   * @throws {@link TestnetNotFoundError} when there is no such testnet.
+   * @throws {@link TestnetStatusError} with status 400 when the testnet is
+   * persistent.
+   **/
+  kill(id: string): Promise<void>;
+  /**
+   * Polls a testnet's status until it is {@link TestnetStatus.ready}.
+   *
+   * @param id - Execution id of the testnet.
+   * @returns The first status that is ready.
+   * @throws {@link TestnetWaitTimeoutError} when the testnet is not ready in
+   * time. Any error of a poll is thrown as is, without retrying.
+   **/
+  waitUntilReady(id: string, options?: WaitUntilReadyOptions): Promise<TestnetStatus>;
+}
+//#endregion

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 };