@gearbox-protocol/sdk 18.3.1 → 18.4.0

package/dist/types/permissionless/bindings/kill-switch-proxy.d.ts

@@ -0,0 +1,205 @@
+import { ParsedCallArgs } from "../../onchain/base/types.js";
+import { RawTx } from "../../onchain/types/transactions.js";
+import { BaseContract } from "../../onchain/base/BaseContract.js";
+import "../../onchain/index.js";
+import { BytecodeRepositoryContract } from "./bytecode-repository.js";
+import { Address, BaseError, Chain, DecodeFunctionDataReturnType, Hex, PublicClient, Transport } from "viem";
+//#region src/permissionless/bindings/kill-switch-proxy.d.ts
+declare const abi: readonly [{
+  readonly type: "constructor";
+  readonly inputs: readonly [{
+    readonly name: "_owner";
+    readonly internalType: "address";
+    readonly type: "address";
+  }, {
+    readonly name: "_caller";
+    readonly internalType: "address";
+    readonly type: "address";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly inputs: readonly [];
+  readonly name: "caller";
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly internalType: "address";
+    readonly type: "address";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly inputs: readonly [];
+  readonly name: "contractType";
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly internalType: "bytes32";
+    readonly type: "bytes32";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly inputs: readonly [];
+  readonly name: "isKilled";
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly internalType: "bool";
+    readonly type: "bool";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly inputs: readonly [];
+  readonly name: "kill";
+  readonly outputs: readonly [];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly inputs: readonly [];
+  readonly name: "owner";
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly internalType: "address";
+    readonly type: "address";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly inputs: readonly [{
+    readonly name: "target";
+    readonly internalType: "address";
+    readonly type: "address";
+  }, {
+    readonly name: "data";
+    readonly internalType: "bytes";
+    readonly type: "bytes";
+  }];
+  readonly name: "proxyCall";
+  readonly outputs: readonly [{
+    readonly name: "result";
+    readonly internalType: "bytes";
+    readonly type: "bytes";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly inputs: readonly [];
+  readonly name: "version";
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly internalType: "uint256";
+    readonly type: "uint256";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "event";
+  readonly anonymous: false;
+  readonly inputs: readonly [];
+  readonly name: "Killed";
+}, {
+  readonly type: "error";
+  readonly inputs: readonly [{
+    readonly name: "caller";
+    readonly internalType: "address";
+    readonly type: "address";
+  }];
+  readonly name: "CallerIsNotOwnerException";
+}, {
+  readonly type: "error";
+  readonly inputs: readonly [];
+  readonly name: "KilledException";
+}, {
+  readonly type: "error";
+  readonly inputs: readonly [];
+  readonly name: "OnlyCallerException";
+}, {
+  readonly type: "error";
+  readonly inputs: readonly [];
+  readonly name: "OwnerSameAsCallerException";
+}];
+/**
+ * Minor version of kill switch proxy, the latest allowed patch of it is deployed
+ */
+export declare const KILL_SWITCH_PROXY_MINOR_VERSION = 310;
+/**
+ * Salt of kill switch proxy deployed together with market configurator,
+ * makes each curator's market configurator get its own proxy
+ */
+export declare function killSwitchProxySalt(curatorName: string): Hex;
+/**
+ * Thrown when bytecode repository has no allowed kill switch proxy bytecode,
+ * so its address can't be computed and it can't be deployed
+ */
+export declare class KillSwitchProxyNotAllowedError extends BaseError {
+  name: string;
+  readonly bytecodeRepository: Address;
+  constructor(bytecodeRepository: Address);
+}
+export interface PreparedKillSwitchProxyDeployment {
+  address: Address;
+  version: number;
+  encodedParams: Hex;
+  salt: Hex;
+  isAlreadyDeployed: boolean;
+  /**
+   * Whether already deployed proxy is killed, always false for not yet deployed one
+   */
+  isKilled: boolean;
+  /**
+   * Bytecode repository `deploy` transaction, must be sent by the deployer
+   */
+  tx: RawTx;
+}
+/**
+ * Kill switch proxy forwards calls of its `caller` via `proxyCall` until `owner` kills it.
+ * It is used as market configurator's emergency admin, so that emergency powers
+ * can be revoked instantly without going through the timelock.
+ */
+export declare class KillSwitchProxyContract extends BaseContract<typeof abi> {
+  #private;
+  constructor(addr: Address, client: PublicClient<Transport, Chain>);
+  /**
+   * Encodes `constructor(address _owner, address _caller)` params
+   * @throws if any address is zero or owner equals caller (constructor reverts in that case)
+   */
+  static encodeConstructorParams(args: {
+    owner: Address;
+    caller: Address;
+  }): Hex;
+  /**
+   * Returns whether some patch of kill switch proxy v3.10 is allowed in bytecode repository
+   */
+  static isAvailable(bcr: BytecodeRepositoryContract): Promise<boolean>;
+  /**
+   * Computes address of kill switch proxy and prepares its deployment via bytecode repository
+   * @param bcr - bytecode repository
+   * @param args.deployer - address that will send deployment transaction, it is mixed into the salt
+   * @param args.owner - address that can kill the proxy
+   * @param args.caller - address that can call through the proxy
+   * @param args.salt - deployment salt
+   * @throws {KillSwitchProxyNotAllowedError} if kill switch proxy is not allowed in bytecode repository
+   */
+  static prepareDeploy(bcr: BytecodeRepositoryContract, args: {
+    deployer: Address;
+    owner: Address;
+    caller: Address;
+    salt: Hex;
+  }): Promise<PreparedKillSwitchProxyDeployment>;
+  isKilled(): Promise<boolean>;
+  state(): Promise<{
+    caller: Address;
+    owner: Address;
+    isKilled: boolean;
+  }>;
+  /**
+   * Wraps transaction into `proxyCall`, must be sent by proxy's caller
+   */
+  proxyCallTx(tx: RawTx): RawTx;
+  /**
+   * Permanently disables `proxyCall`, must be sent by proxy's owner
+   */
+  killTx(): RawTx;
+  protected parseFunctionParams(params: DecodeFunctionDataReturnType<typeof abi>): ParsedCallArgs;
+}
+//#endregion
+export {};

package/dist/types/permissionless/bindings/market-configurator-factory.d.ts

@@ -229,6 +229,36 @@ export declare class MarketConfiguratorFactoryContract extends BaseContract<type
     curatorName: string;
     deployGovernor: boolean;
   }): RawTx;
+  /**
+   * Builds transactions that deploy market configurator with kill switch proxy as its emergency admin:
+   * 1. kill switch proxy deployment via bytecode repository (skipped if already deployed)
+   * 2. market configurator creation with proxy as emergency admin
+   *
+   * Transactions must be sent in this order by `admin`, e.g. as one Safe batch.
+   * When `deployGovernor` is true, proxy also becomes governor's veto admin.
+   *
+   * @param args.admin - address that sends transactions, becomes market configurator admin
+   * @param args.emergencyAdmin - address that executes emergency actions through the proxy
+   * @param args.killSwitchOwner - address that can kill the proxy, defaults to `admin`
+   * @throws {KillSwitchProxyNotAllowedError} if kill switch proxy is not allowed in bytecode repository,
+   * use {@link createMarketConfiguratorTx} to deploy market configurator without it
+   */
+  createMarketConfiguratorWithKillSwitchTxs(args: {
+    admin: Address;
+    emergencyAdmin: Address;
+    killSwitchOwner?: Address;
+    adminFeeTreasury: Address;
+    curatorName: string;
+    deployGovernor: boolean;
+  }): Promise<{
+    killSwitchProxy: Address;
+    /**
+     * True if proxy with the same deployer, owner, caller and curator name already exists,
+     * in which case it is reused and its deployment transaction is omitted
+     */
+    isKillSwitchProxyDeployed: boolean;
+    txs: RawTx[];
+  }>;
   getMarketConfigurators(): Promise<Address[]>;
   getShutdownMarketConfigurators(): Promise<Address[]>;
   syncMarketConfigurators(fromBlock: bigint, toBlock: bigint): Promise<{

package/dist/types/permissionless/bindings/market-configurator.d.ts

@@ -3,7 +3,7 @@ import { RawTx } from "../../onchain/types/transactions.js";
 import { BaseContract } from "../../onchain/base/BaseContract.js";
 import "../../onchain/index.js";
 import { AddressProviderContract } from "./address-provider.js";
-import { AddAssetParams, AllowTokenParams, DeployParams, ForbidAdapterParams, ForbidTokenParams, Market, PauseCreditManagerParams, PeripheryDomain, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, UnpauseCreditManagerParams } from "./types.js";
+import { AddAssetParams, AllowTokenParams, DeployParams, EmergencyAdmin, ForbidAdapterParams, ForbidTokenParams, Market, PauseCreditManagerParams, PeripheryDomain, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, UnpauseCreditManagerParams } from "./types.js";
 import { CreditFactory } from "./factory/credit-factory.js";
 import { LossPolicyFactory } from "./factory/loss-policy-factory.js";
 import { PoolFactory } from "./factory/pool-factory.js";
@@ -1536,6 +1536,7 @@ declare const abi: readonly [{
   readonly name: "UnauthorizedFactoryException";
 }];
 export declare class MarketConfiguratorContract extends BaseContract<typeof abi> {
+  #private;
   readonly creditFactory: CreditFactory;
   readonly poolFactory: PoolFactory;
   readonly priceOracleFactory: PriceOracleFactory;
@@ -1647,6 +1648,26 @@ export declare class MarketConfiguratorContract extends BaseContract<typeof abi>
     emergencyLiquidators: Address[];
   }>;
   multipause(): Promise<Address | undefined>;
+  /**
+   * Returns emergency admin of the market configurator.
+   * If it is a `KILL_SWITCH_PROXY`, emergency transactions must be sent by proxy's caller via `proxyCall`,
+   * otherwise directly by emergency admin itself
+   * @param emergencyAdmin - emergency admin address, read from the market configurator if not provided
+   */
+  getEmergencyAdmin(emergencyAdmin?: Address): Promise<EmergencyAdmin>;
+  /**
+   * Routes emergency transaction to the market configurator through its emergency admin:
+   * returns transaction as is for direct emergency admin, or wraps it into `proxyCall` of kill switch proxy
+   * @param tx - emergency transaction to the market configurator, e.g. built by `emergencyConfigurePool`
+   * @param emergencyAdmin - result of {@link getEmergencyAdmin}
+   * @throws if transaction is not addressed to this market configurator or kill switch proxy is killed
+   */
+  wrapEmergencyTx(tx: RawTx, emergencyAdmin: EmergencyAdmin): RawTx;
+  /**
+   * Reads emergency admin and routes emergency transaction through it, see {@link wrapEmergencyTx}
+   * @param tx - emergency transaction to the market configurator, e.g. built by `emergencyConfigurePool`
+   */
+  emergencyTx(tx: RawTx): Promise<RawTx>;
   grantRole(role: string, address: Address): RawTx;
   revokeRole(role: string, address: Address): RawTx;
   setEmergencyAdmin(newEmergencyAdmin: Address): RawTx;
@@ -1667,6 +1688,14 @@ export declare class MarketConfiguratorContract extends BaseContract<typeof abi>
   emergencyConfigureCreditSuite(creditManager: Address, calldata: Hex): RawTx;
   emergencyConfigurePriceOracle(pool: Address, calldata: Hex): RawTx;
   emergencyConfigureLossPolicy(pool: Address, calldata: Hex): RawTx;
+  /**
+   * Note: current interest rate model factory forbids all emergency configuration calls
+   */
+  emergencyConfigureInterestRateModel(pool: Address, calldata: Hex): RawTx;
+  /**
+   * Note: current rate keeper factory forbids all emergency configuration calls
+   */
+  emergencyConfigureRateKeeper(pool: Address, calldata: Hex): RawTx;
 }
 //#endregion
 export {};

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

@@ -66,4 +66,31 @@ export declare enum AccessMode {
   Forbidden = 2
 }
 export type PeripheryDomain = "ZAPPER" | "DEGEN_NFT";
+/**
+ * Emergency admin of a market configurator, as seen by the SDK
+ * - `direct`: emergency admin is an EOA or Safe that calls the market configurator itself
+ * - `killSwitch`: emergency admin is a `KILL_SWITCH_PROXY`, `caller` executes emergency calls
+ *   via `proxyCall` until `owner` kills the proxy
+ */
+export type EmergencyAdmin = {
+  type: "direct";
+  address: Address;
+  /**
+   * Address that must send emergency transactions
+   */
+  executor: Address;
+} | {
+  type: "killSwitch";
+  /**
+   * Address of the kill switch proxy
+   */
+  address: Address;
+  caller: Address;
+  owner: Address;
+  isKilled: boolean;
+  /**
+   * Address that must send emergency transactions, i.e. proxy caller
+   */
+  executor: Address;
+};
 //#endregion

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

@@ -13,10 +13,12 @@ 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, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./api/oracles/types.js";
+import { AssetScore, AssetScoresArgs, FeedPairScore, FeedPairScoreArgs, GroupImpact, MarketScore, ScoredFeed } from "./api/oracles/score/types.js";
+import { BreakingPoint, FeedOutcome, GroupReport, GroupScenarioOutcome, SlotOutcome, StressReport, StressScenario, StressSource, StressSourceKind, StressTestArgs } from "./api/oracles/stress/types.js";
+import { AssetArgs, AssetCap, AssetsArgs, FeedCap, MarketCap, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetQuota, PermissionlessAssetSummary, PermissionlessIndexedAssetDetails, PermissionlessIndexedAssetSummary, PermissionlessIndexedPriceFeedDetails, PermissionlessIndexedPriceFeedMarket, PermissionlessMarket, PermissionlessMarketSlot, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedStore, PermissionlessQuotaTotals, PriceFeedArgs, PriceFeedDecimals, PriceFeedPrice, PriceFeedRef } 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";
+import { BytecodeRepositoryContract, ComputeAddressArgs } from "./bindings/bytecode-repository.js";
 import { TokenCompressorContract } from "./bindings/compressors/token-compressor.js";
 import { WithdrawalCompressorContract } from "./bindings/compressors/withdrawal-compressor.js";
 import { ConstructorParams, CrossChainMultisigContract, Proposal } from "./bindings/cross-chain-multisig.js";
@@ -24,7 +26,8 @@ import { QueuedAndExecutedTransaction, SafeBatch, SafeMeta, SafeTx, TimelockTran
 import { GovernorContract } from "./bindings/governance/governor.js";
 import { TimeLockContract } from "./bindings/governance/timelock.js";
 import { InstanceManagerContract } from "./bindings/instance-manager.js";
-import { AccessMode, AddAssetParams, AllowTokenParams, CreditManagerFees, DeployParams, ForbidAdapterParams, ForbidTokenParams, Market, PauseCreditManagerParams, PeripheryDomain, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, UnpauseCreditManagerParams } from "./bindings/types.js";
+import { KILL_SWITCH_PROXY_MINOR_VERSION, KillSwitchProxyContract, KillSwitchProxyNotAllowedError, PreparedKillSwitchProxyDeployment, killSwitchProxySalt } from "./bindings/kill-switch-proxy.js";
+import { AccessMode, AddAssetParams, AllowTokenParams, CreditManagerFees, DeployParams, EmergencyAdmin, ForbidAdapterParams, ForbidTokenParams, Market, PauseCreditManagerParams, PeripheryDomain, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, UnpauseCreditManagerParams } from "./bindings/types.js";
 import { MarketConfiguratorContract } from "./bindings/market-configurator.js";
 import { MarketConfiguratorFactoryContract } from "./bindings/market-configurator-factory.js";
 import { PriceFeedStoreContract } from "./bindings/price-feed-store.js";
@@ -38,6 +41,12 @@ import { InstanceOwnerTransactions } from "./api/transactions/InstanceOwnerTrans
 import { GearboxPermissionless } from "./api/GearboxPermissionless.js";
 import { deriveEffectiveStalenessPeriod } from "./api/deploy/effective-staleness.js";
 import { PermissionlessChainUnreachableError, PermissionlessNotAttachedError, PriceFeedNotInStoreError, PriceFeedSaltMissingError, PriceFeedStalenessUnknownError } from "./api/errors.js";
+import { SCORE_MULTIPLIER, factorOf, finalPrice, scoreOfFactor, worstOf } from "./api/oracles/score/formula.js";
+import { runAssetScores, runFeedPairScore } from "./api/oracles/score/run.js";
+import { TreeNode, classifySources, sourcesByFeed } from "./api/oracles/stress/classify.js";
+import { UNBOUNDED_DOWN, UNBOUNDED_UP, groupOverride, perturb, rateStub, roundDataStub } from "./api/oracles/stress/override.js";
+import { DEFAULT_SCENARIOS, RATE_FEED_TYPE, readFeedTrees, readForest, readRateTargets, readUnder, runStressTest } from "./api/oracles/stress/run.js";
+import { scoreGroup, slotHarm, verdictOf } from "./api/oracles/stress/score.js";
 import "./api/index.js";
 import { ArchiveTransport, ArchiveTransportConfig } from "./chains/archive-transport.js";
 import { chunkedLogsTransport } from "./chains/chunked-log-transport.js";
@@ -48,10 +57,10 @@ import { PUBLIC_CREATE2_FACTORY, checkCreate2Deployment, checkCreate2DeploymentA
 import { convertPercent, deepJsonParse, formatBytecodeSize, formatBytecodeVersion, shortenHash, significantTrunc } from "./utils/format.js";
 import { calculateChecksum, convertRawTxToSafeMultisigTx, getSafeBatch, getSafeBatches } from "./utils/governance/batch.js";
 import { convertQueueBatchToExecuteTx } from "./utils/governance/timelock-txs.js";
-import { BYTECODE_REPOSITORY, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, INSTANCE_MANAGER, MARKET_CONFIGURATOR_FACTORY, PRICE_FEED_STORE, TOKEN_COMPRESSOR } from "./utils/literals.js";
+import { BYTECODE_REPOSITORY, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, INSTANCE_MANAGER, KILL_SWITCH_PROXY, MARKET_CONFIGURATOR_FACTORY, PRICE_FEED_STORE, TOKEN_COMPRESSOR } from "./utils/literals.js";
 import { getPriceUpdateTx } from "./utils/price-update/get-price-update-tx.js";
-import { getPrices } from "./utils/price-update/get-prices.js";
+import { getFeedDecimals, getLatestPrices, 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, 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, AssetCap, AssetScore, AssetScoresArgs, AssetsArgs, AttachChainsArgs, AuditEvent, Auditor, BYTECODE_REPOSITORY, Batch, BreakingPoint, Bytecode, BytecodeRepositoryContract, CCMConstructorParams, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, ChainScope, ChainSummaryArgs, ChainsNamespace, ChangeNamesArgs, ChangeStalenessPeriodsArgs, ComputeAddressArgs, ConstructorParams, CreditManagerFees, CrossChainCall, CrossChainMultisigContract, DEFAULT_DEPLOY_SALT, DEFAULT_SCENARIOS, DeployArgs, DeployContractArgs, DeployParams, DeployPriceFeedArgs, Deployment, DeploymentExtended, EmergencyAdmin, FeedCap, FeedOutcome, FeedPairScore, FeedPairScoreArgs, ForbidAdapterParams, ForbidFeedsArgs, ForbidTokenParams, FunctionParams, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GearboxPermissionless, GearboxPermissionlessOptions, GetUpdatablePriceFeedsArgs, GovernorContract, GroupImpact, GroupReport, GroupScenarioOutcome, INSTANCE_MANAGER, InputValueParams, InstanceManagerContract, InstanceOwnerTransactions, InstanceTxs, InstanceTxsArgs, KILL_SWITCH_PROXY, KILL_SWITCH_PROXY_MINOR_VERSION, KillSwitchProxyContract, KillSwitchProxyNotAllowedError, MAINNET_CCM_CONSTRUCTOR_PARAMS, MAINNET_DEPLOYMENT_BLOCK, MAINNET_DEPLOYMENT_CCM_SALT, MAINNET_DEPLOYMENT_IM_SALT, MARKET_CONFIGURATOR_FACTORY, Market, MarketCap, MarketConfiguratorContract, MarketConfiguratorFactoryContract, MarketScore, PRICE_FEED_STORE, PUBLIC_CREATE2_FACTORY, PauseCreditManagerParams, PeripheryDomain, PermissionlessAnalytics, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetQuota, PermissionlessAssetSummary, PermissionlessChain, PermissionlessChainSummary, PermissionlessChainUnreachableError, PermissionlessDeploy, PermissionlessIndexedAssetDetails, PermissionlessIndexedAssetSummary, PermissionlessIndexedPriceFeedDetails, PermissionlessIndexedPriceFeedMarket, PermissionlessMarket, PermissionlessMarketSlot, PermissionlessNotAttachedError, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedStore, PermissionlessQuotaTotals, PreparedDeployment, PreparedKillSwitchProxyDeployment, PreparedPriceFeedDeployment, PriceChartArgs, PriceFeed, PriceFeedArgs, PriceFeedChartPoint, PriceFeedConstructorParam, PriceFeedDecimals, PriceFeedNotInStoreError, PriceFeedPair, PriceFeedParamType, PriceFeedParams, PriceFeedPrice, PriceFeedPriceChart, PriceFeedRef, PriceFeedSaltMissingError, PriceFeedSetupParams, PriceFeedStalenessUnknownError, PriceFeedStoreContract, Proposal, QueuedAndExecutedTransaction, RATE_FEED_TYPE, RecoveryMessage, RoutingManagerContract, SCORE_MULTIPLIER, SafeBatch, SafeMeta, SafeTx, ScoredFeed, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, Signature, SlotOutcome, StressReport, StressScenario, StressSource, StressSourceKind, StressTestArgs, TOKEN_COMPRESSOR, TimeLockContract, TimelockTransaction, TimelockTxParams, TimelockTxs, TokenCompressorContract, TreasurySplitterContract, TreeNode, UNBOUNDED_DOWN, UNBOUNDED_UP, UnpauseCreditManagerParams, ValueParams, WithdrawalCompressorContract, calculateChecksum, checkCreate2Deployment, checkCreate2DeploymentAddress, chunkedLogsTransport, classifySources, convertPercent, convertQueueBatchToExecuteTx, convertRawTxToSafeMultisigTx, createCallData, createCreate2DeployRawTx, deepJsonParse, deployUsingPublicCreate2, deriveEffectiveStalenessPeriod, encodeFunctionParams, factorOf, finalPrice, formatBytecodeSize, formatBytecodeVersion, getBlockNumberByTimestamp, getCreate2AddressPublicFactory, getCreate2DeploymentAddress, getFeedDecimals, getLatestPrices, getPriceUpdateTx, getPrices, getSafeBatch, getSafeBatches, getUpdatablePriceFeeds, groupOverride, handleSalt, killSwitchProxySalt, normalizeSignature, perturb, priceFeedSalt, priceFeedSetupParams, rateStub, readFeedTrees, readForest, readRateTargets, readUnder, roundDataStub, runAssetScores, runFeedPairScore, runStressTest, scoreGroup, scoreOfFactor, shortenHash, significantTrunc, slotHarm, sourcesByFeed, verdictOf, worstOf };

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

@@ -6,10 +6,10 @@ import { convertPercent, deepJsonParse, formatBytecodeSize, formatBytecodeVersio
 import { calculateChecksum, convertRawTxToSafeMultisigTx, getSafeBatch, getSafeBatches } from "./governance/batch.js";
 import { convertQueueBatchToExecuteTx } from "./governance/timelock-txs.js";
 import "./governance/index.js";
-import { BYTECODE_REPOSITORY, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, INSTANCE_MANAGER, MARKET_CONFIGURATOR_FACTORY, PRICE_FEED_STORE, TOKEN_COMPRESSOR } from "./literals.js";
+import { BYTECODE_REPOSITORY, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, INSTANCE_MANAGER, KILL_SWITCH_PROXY, MARKET_CONFIGURATOR_FACTORY, PRICE_FEED_STORE, TOKEN_COMPRESSOR } from "./literals.js";
 import { getPriceUpdateTx } from "./price-update/get-price-update-tx.js";
-import { getPrices } from "./price-update/get-prices.js";
+import { getFeedDecimals, getLatestPrices, getPrices } from "./price-update/get-prices.js";
 import { GetUpdatablePriceFeedsArgs, getUpdatablePriceFeeds } from "./price-update/get-updatable-feeds.js";
 import "./price-update/index.js";
 import { normalizeSignature } from "./signature.js";
-export { BYTECODE_REPOSITORY, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, FunctionParams, GetUpdatablePriceFeedsArgs, INSTANCE_MANAGER, InstanceTxs, MARKET_CONFIGURATOR_FACTORY, PRICE_FEED_STORE, PUBLIC_CREATE2_FACTORY, TOKEN_COMPRESSOR, TimelockTxs, ValueParams, calculateChecksum, checkCreate2Deployment, checkCreate2DeploymentAddress, convertPercent, convertQueueBatchToExecuteTx, convertRawTxToSafeMultisigTx, createCreate2DeployRawTx, deepJsonParse, deployUsingPublicCreate2, encodeFunctionParams, formatBytecodeSize, formatBytecodeVersion, getBlockNumberByTimestamp, getCreate2AddressPublicFactory, getCreate2DeploymentAddress, getPriceUpdateTx, getPrices, getSafeBatch, getSafeBatches, getUpdatablePriceFeeds, handleSalt, normalizeSignature, shortenHash, significantTrunc };
+export { BYTECODE_REPOSITORY, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, FunctionParams, GetUpdatablePriceFeedsArgs, INSTANCE_MANAGER, InstanceTxs, KILL_SWITCH_PROXY, MARKET_CONFIGURATOR_FACTORY, PRICE_FEED_STORE, PUBLIC_CREATE2_FACTORY, TOKEN_COMPRESSOR, TimelockTxs, ValueParams, calculateChecksum, checkCreate2Deployment, checkCreate2DeploymentAddress, convertPercent, convertQueueBatchToExecuteTx, convertRawTxToSafeMultisigTx, createCreate2DeployRawTx, deepJsonParse, deployUsingPublicCreate2, encodeFunctionParams, formatBytecodeSize, formatBytecodeVersion, getBlockNumberByTimestamp, getCreate2AddressPublicFactory, getCreate2DeploymentAddress, getFeedDecimals, getLatestPrices, getPriceUpdateTx, getPrices, getSafeBatch, getSafeBatches, getUpdatablePriceFeeds, handleSalt, normalizeSignature, shortenHash, significantTrunc };

package/dist/types/permissionless/utils/literals.d.ts

@@ -6,4 +6,5 @@ export declare const TOKEN_COMPRESSOR = "GLOBAL::TOKEN_COMPRESSOR";
 export declare const CROSS_CHAIN_MULTISIG = "CROSS_CHAIN_MULTISIG";
 export declare const PRICE_FEED_STORE = "PRICE_FEED_STORE";
 export declare const MARKET_CONFIGURATOR_FACTORY = "MARKET_CONFIGURATOR_FACTORY";
+export declare const KILL_SWITCH_PROXY = "KILL_SWITCH_PROXY";
 //#endregion

package/dist/types/permissionless/utils/price-update/get-prices.d.ts

@@ -1,5 +1,38 @@
 import { Address, PublicClient } from "viem";
 //#region src/permissionless/utils/price-update/get-prices.d.ts
+/**
+ * The scale each feed's answer is in, in one multicall.
+ *
+ * Part of the Chainlink interface every feed in a Gearbox tree implements,
+ * and the only way to read an answer that is not an oracle's own: a feed an
+ * oracle holds reports 8 decimals by construction, while the feeds beneath a
+ * composite are whatever was deployed — an ETH/USD aggregator at 8 and a
+ * rate leg at 18 sit under the same parent.
+ *
+ * `null` is a feed that would not answer, which a caller should treat as
+ * unknown rather than defaulting it to 8.
+ */
+export declare function getFeedDecimals({ client, priceFeeds }: {
+  client: PublicClient;
+  priceFeeds: Address[];
+}): Promise<Record<Address, number | null>>;
+/**
+ * What the feeds report as they stand, in one multicall.
+ *
+ * What {@link getPrices} does without the part that makes it expensive: no
+ * `OnchainSDK` to attach and no update transactions to assemble, which is the
+ * whole cost of that call and is wasted on a feed that answers already. A feed
+ * that needs a fresh answer before it will be read comes back `null` here, so
+ * a caller that must price those falls back to {@link getPrices} for them and
+ * pays once for the few rather than once for all.
+ *
+ * `null` is also a feed whose read reverted for any other reason, which is not
+ * a zero.
+ */
+export declare function getLatestPrices({ client, priceFeeds }: {
+  client: PublicClient;
+  priceFeeds: Address[];
+}): Promise<Record<Address, bigint | null>>;
 export declare function getPrices({ client, priceFeeds, chunkSize, gasLimit }: {
   client: PublicClient;
   priceFeeds: Address[];

package/dist/types/permissionless/utils/price-update/index.d.ts

@@ -1,4 +1,4 @@
 import { getPriceUpdateTx } from "./get-price-update-tx.js";
-import { getPrices } from "./get-prices.js";
+import { getFeedDecimals, getLatestPrices, getPrices } from "./get-prices.js";
 import { GetUpdatablePriceFeedsArgs, getUpdatablePriceFeeds } from "./get-updatable-feeds.js";
-export { GetUpdatablePriceFeedsArgs, getPriceUpdateTx, getPrices, getUpdatablePriceFeeds };
+export { GetUpdatablePriceFeedsArgs, getFeedDecimals, getLatestPrices, getPriceUpdateTx, getPrices, getUpdatablePriceFeeds };

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