@gearbox-protocol/sdk 11.11.0-next.2 → 11.11.1

package/dist/esm/plugins/bots/BotsPlugin.js

@@ -1,17 +1,32 @@
+import {
+  decodeAbiParameters,
+  encodeAbiParameters,
+  stringToHex
+} from "viem";
+import { iBytecodeRepositoryAbi } from "../../abi/310/iBytecodeRepository.js";
 import { peripheryCompressorAbi } from "../../abi/compressors/peripheryCompressor.js";
 import {
   AddressMap,
+  AP_BYTECODE_REPOSITORY,
   AP_PERIPHERY_COMPRESSOR,
+  AP_TREASURY,
   BasePlugin,
+  hexEq,
   isV300,
   isV310,
   TypedObjectUtils,
   VERSION_RANGE_310
 } from "../../sdk/index.js";
-import deserializePartialLiquidationBotParams from "./deserializePartialLiquidationBotParams.js";
+import { iPartialLiquidationBotV310Abi } from "./abi/iPartialLiquidationBotV310.js";
+import {
+  PARTIAL_LIQUIDATION_BOT_CONFIGS,
+  PARTIAL_LIQUIDATION_BOT_DEPLOYER,
+  PARTIAL_LIQUIDATION_BOT_SALT
+} from "./config.js";
 import { PartialLiquidationBotV300Contract } from "./PartialLiquidationBotV300Contract.js";
 import { PartialLiquidationBotV310Contract } from "./PartialLiquidationBotV310Contract.js";
 import {
+  BOT_PARAMS_ABI,
   LIQUIDATION_BOT_TYPES
 } from "./types.js";
 class UnsupportedBotVersionError extends Error {
@@ -59,16 +74,100 @@ class BotsPlugin extends BasePlugin {
     }
     return this.state;
   }
+  async findDeployedPartialLiquidationBots() {
+    const treasury = this.sdk.addressProvider.getAddress(AP_TREASURY);
+    const bcr = this.sdk.addressProvider.getAddress(AP_BYTECODE_REPOSITORY);
+    const configs = PARTIAL_LIQUIDATION_BOT_CONFIGS[this.sdk.networkType] ?? [];
+    const result = new AddressMap();
+    if (!configs.length) {
+      return result;
+    }
+    const deployedBots = await this.client.multicall({
+      contracts: configs.map(
+        (config) => ({
+          address: bcr,
+          abi: iBytecodeRepositoryAbi,
+          functionName: "computeAddress",
+          args: [
+            stringToHex("BOT::PARTIAL_LIQUIDATION", { size: 32 }),
+            310,
+            encodeAbiParameters(BOT_PARAMS_ABI, [
+              treasury,
+              config.minHealthFactor,
+              config.maxHealthFactor,
+              config.premiumScaleFactor,
+              config.feeScaleFactor
+            ]),
+            stringToHex(PARTIAL_LIQUIDATION_BOT_SALT, { size: 32 }),
+            // salt
+            PARTIAL_LIQUIDATION_BOT_DEPLOYER
+          ]
+        })
+      ),
+      allowFailure: true,
+      blockNumber: this.sdk.currentBlock
+    });
+    const expectedBots = new AddressMap();
+    for (let i = 0; i < configs.length; i++) {
+      const b = deployedBots[i];
+      const { minHealthFactor, maxHealthFactor } = configs[i];
+      if (b.status === "success") {
+        expectedBots.upsert(b.result, { ...configs[i], treasury });
+        this.logger?.debug(
+          `expected bot [${minHealthFactor}, ${maxHealthFactor}] at ${b.result}`
+        );
+      } else {
+        this.logger?.error(
+          `failed compute address for bot [${minHealthFactor}, ${maxHealthFactor}]`,
+          b.error
+        );
+      }
+    }
+    const botAddrs = expectedBots.keys();
+    const serializedBots = await this.client.multicall({
+      contracts: botAddrs.map(
+        (address) => ({
+          address,
+          abi: iPartialLiquidationBotV310Abi,
+          functionName: "serialize"
+        })
+      ),
+      allowFailure: true,
+      blockNumber: this.sdk.currentBlock
+    });
+    for (let i = 0; i < botAddrs.length; i++) {
+      const serialized = serializedBots[i];
+      const expected = expectedBots.mustGet(botAddrs[i]);
+      if (serialized.status === "success") {
+        const [
+          treasury2,
+          minHealthFactor,
+          maxHealthFactor,
+          premiumScaleFactor,
+          feeScaleFactor
+        ] = decodeAbiParameters(BOT_PARAMS_ABI, serialized.result);
+        if (!hexEq(treasury2, expected.treasury) || minHealthFactor !== expected.minHealthFactor || maxHealthFactor !== expected.maxHealthFactor || premiumScaleFactor !== expected.premiumScaleFactor || feeScaleFactor !== expected.feeScaleFactor) {
+          this.logger?.error(
+            `serialized bot ${botAddrs[i]} does not match expected bot`,
+            serialized.error
+          );
+        } else {
+          result.upsert(botAddrs[i], expected);
+        }
+      }
+    }
+    return result;
+  }
   #loadStateMarketState(mc, state) {
-    const states = [...state].sort(
-      (a, b) => deserializePartialLiquidationBotParams(a.baseParams).minHealthFactor - deserializePartialLiquidationBotParams(b.baseParams).minHealthFactor
-    );
-    if (states.length && isV300(states[0].baseParams.version)) {
-      if (states.length !== 4) {
+    const bots = state.map((state2) => this.#createBot(mc, state2)).sort((a, b) => a.minHealthFactor - b.minHealthFactor);
+    if (bots.length && isV300(Number(bots[0].version))) {
+      if (bots.length !== 4) {
         throw new Error(`expected 4 bots v300 for market configurator ${mc}`);
       }
+      for (let i = 0; i < bots.length; i++) {
+        bots[i].botType = LIQUIDATION_BOT_TYPES[i];
+      }
     }
-    const bots = states.map((s, i) => this.#createBot(mc, s, i));
     this.botsByMarket.upsert(mc, bots);
   }
   stateHuman(raw) {
@@ -106,15 +205,13 @@ class BotsPlugin extends BasePlugin {
       this.#loadStateMarketState(mc, botStates);
     }
   }
-  #createBot(marketConfigurator, data, index) {
+  #createBot(marketConfigurator, data) {
     const v = Number(data.baseParams.version);
     if (isV300(v)) {
-      const botType = LIQUIDATION_BOT_TYPES[index];
       return new PartialLiquidationBotV300Contract(
         this.sdk,
         data,
-        marketConfigurator,
-        botType
+        marketConfigurator
       );
     } else if (isV310(v)) {
       return new PartialLiquidationBotV310Contract(

package/dist/esm/plugins/bots/PartialLiquidationBotBaseContract.js

@@ -1,5 +1,8 @@
+import { decodeAbiParameters } from "viem";
 import { BaseContract, formatPercentage } from "../../sdk/index.js";
-import deserializePartialLiquidationBotParams from "./deserializePartialLiquidationBotParams.js";
+import {
+  BOT_PARAMS_ABI
+} from "./types.js";
 class PartialLiquidationBotBaseContract extends BaseContract {
   requiredPermissions;
   marketConfigurator;
@@ -7,12 +10,18 @@ class PartialLiquidationBotBaseContract extends BaseContract {
   constructor(sdk, args) {
     super(sdk, args);
     this.#serializedParams = args.serializedParams;
-    const bp = deserializePartialLiquidationBotParams(args);
-    this.treasury = bp.treasury;
-    this.minHealthFactor = bp.minHealthFactor;
-    this.maxHealthFactor = bp.maxHealthFactor;
-    this.premiumScaleFactor = bp.premiumScaleFactor;
-    this.feeScaleFactor = bp.feeScaleFactor;
+    const [
+      treasury,
+      minHealthFactor,
+      maxHealthFactor,
+      premiumScaleFactor,
+      feeScaleFactor
+    ] = decodeAbiParameters(BOT_PARAMS_ABI, args.serializedParams);
+    this.treasury = treasury;
+    this.minHealthFactor = minHealthFactor;
+    this.maxHealthFactor = maxHealthFactor;
+    this.premiumScaleFactor = premiumScaleFactor;
+    this.feeScaleFactor = feeScaleFactor;
     this.marketConfigurator = args.marketConfigurator;
     this.requiredPermissions = args.requiredPermissions;
   }

package/dist/esm/plugins/bots/PartialLiquidationBotV300Contract.js

@@ -2,16 +2,15 @@ import { iPartialLiquidationBotV300Abi } from "./abi/index.js";
 import { PartialLiquidationBotBaseContract } from "./PartialLiquidationBotBaseContract.js";
 const abi = iPartialLiquidationBotV300Abi;
 class PartialLiquidationBotV300Contract extends PartialLiquidationBotBaseContract {
-  botType;
-  constructor(sdk, args, marketConfigurator, botType) {
+  #botType;
+  constructor(sdk, args, marketConfigurator) {
     super(sdk, {
       abi,
       ...args.baseParams,
       requiredPermissions: args.requiredPermissions,
       marketConfigurator,
-      name: `PartialLiquidationBotV300 (${botType})`
+      name: "PartialLiquidationBotV300"
     });
-    this.botType = botType;
   }
   stateHuman(raw) {
     return {
@@ -19,6 +18,23 @@ class PartialLiquidationBotV300Contract extends PartialLiquidationBotBaseContrac
       botType: this.botType
     };
   }
+  /**
+   * Set the bot type
+   * This method should only be called once from BotsPlugin
+   */
+  set botType(type) {
+    if (this.#botType) {
+      throw new Error("bot type already set");
+    }
+    this.#botType = type;
+    this.name = `PartialLiquidationBotV300 (${type})`;
+  }
+  get botType() {
+    if (!this.#botType) {
+      throw new Error("bot type not set");
+    }
+    return this.#botType;
+  }
 }
 export {
   PartialLiquidationBotV300Contract

package/dist/esm/plugins/bots/config.js

@@ -0,0 +1,33 @@
+const PARTIAL_LIQUIDATION_BOT_CONFIGS = {
+  Mainnet: [
+    {
+      minHealthFactor: 10300,
+      maxHealthFactor: 10700,
+      premiumScaleFactor: 1e4,
+      feeScaleFactor: 1e4
+    }
+  ],
+  Monad: [
+    {
+      minHealthFactor: 10300,
+      maxHealthFactor: 10700,
+      premiumScaleFactor: 1e4,
+      feeScaleFactor: 1e4
+    }
+  ],
+  Plasma: [
+    {
+      minHealthFactor: 10300,
+      maxHealthFactor: 10700,
+      premiumScaleFactor: 1e4,
+      feeScaleFactor: 1e4
+    }
+  ]
+};
+const PARTIAL_LIQUIDATION_BOT_SALT = "GEARBOX";
+const PARTIAL_LIQUIDATION_BOT_DEPLOYER = "0xc93155E0a835Cf4E17a19463Fa67ed43c164d06a";
+export {
+  PARTIAL_LIQUIDATION_BOT_CONFIGS,
+  PARTIAL_LIQUIDATION_BOT_DEPLOYER,
+  PARTIAL_LIQUIDATION_BOT_SALT
+};

package/dist/esm/plugins/bots/index.js

@@ -1,4 +1,6 @@
 export * from "./abi/index.js";
 export * from "./BotsPlugin.js";
+export * from "./config.js";
 export * from "./PartialLiquidationBotV300Contract.js";
+export * from "./PartialLiquidationBotV310Contract.js";
 export * from "./types.js";

package/dist/esm/plugins/bots/types.js

@@ -1,3 +1,10 @@
+const BOT_PARAMS_ABI = [
+  { type: "address", name: "treasury" },
+  { type: "uint16", name: "minHealthFactor" },
+  { type: "uint16", name: "maxHealthFactor" },
+  { type: "uint16", name: "premiumScaleFactor" },
+  { type: "uint16", name: "feeScaleFactor" }
+];
 const LIQUIDATION_BOT_TYPES = [
   "PARTIAL_LIQUIDATION_BOT",
   "DELEVERAGE_BOT_PEGGED",
@@ -5,5 +12,6 @@ const LIQUIDATION_BOT_TYPES = [
   "DELEVERAGE_BOT_HV"
 ];
 export {
+  BOT_PARAMS_ABI,
   LIQUIDATION_BOT_TYPES
 };

package/dist/esm/plugins/zappers/ZappersPlugin.js

@@ -115,7 +115,7 @@ class ZappersPlugin extends BasePlugin {
     const extraZappersTokens = this.extraZappers.values().flatMap((l) => l.flatMap((z) => [z.tokenIn, z.tokenOut]));
     for (const t of [...zappersTokens, ...extraZappersTokens]) {
       this.sdk.tokensMeta.upsert(t.addr, t);
-      this.sdk.setAddressLabel(t.addr, t.symbol);
+      this.sdk.addressLabels.set(t.addr, t.symbol);
     }
   }
 }

package/dist/esm/sdk/GearboxSDK.js

@@ -5,7 +5,7 @@ import {
   http,
   parseEventLogs
 } from "viem";
-import { ChainContractsRegister } from "./base/index.js";
+import { AddressLabeller, TokensMeta } from "./base/index.js";
 import { detectNetwork, getChain } from "./chain/index.js";
 import {
   ADDRESS_PROVIDER_V310,
@@ -30,7 +30,7 @@ import {
   PluginStateVersionError
 } from "./plugins/index.js";
 import { createRouter } from "./router/index.js";
-import { TypedObjectUtils, toAddress } from "./utils/index.js";
+import { AddressMap, TypedObjectUtils, toAddress } from "./utils/index.js";
 import { Hooks } from "./utils/internal/index.js";
 import { getLogsSafe } from "./utils/viem/index.js";
 const ERR_NOT_ATTACHED = new Error("Gearbox SDK not attached");
@@ -69,9 +69,10 @@ async function attachClient(options, network) {
   }
   return createClient(options, { networkType, chainId });
 }
-class GearboxSDK extends ChainContractsRegister {
+class GearboxSDK {
   #hooks = new Hooks();
   plugins;
+  #client;
   // Block which was use for data query
   #currentBlock;
   #timestamp;
@@ -82,11 +83,29 @@ class GearboxSDK extends ChainContractsRegister {
   // Collection of markets
   #marketRegister;
   #priceFeeds;
+  logger;
   gasLimit;
+  addressLabels = new AddressLabeller();
+  /**
+   * Interest rate models can be reused across chain (and SDK operates on chain level)
+   * TODO: use whatever interface is necessary for InterestRateModels
+   */
+  interestRateModels = new AddressMap();
   /**
    * Will throw an error if contract type is not supported, otherwise will try to use generic contract first, if possible
    */
   strictContractTypes;
+  /**
+   * All contracts known to sdk
+   */
+  contracts = new AddressMap(
+    void 0,
+    "contracts"
+  );
+  /**
+   * Token metadata such as symbol and decimals
+   */
+  tokensMeta;
   addHook = this.#hooks.addHook.bind(this.#hooks);
   removeHook = this.#hooks.removeHook.bind(this.#hooks);
   static async attach(options) {
@@ -139,16 +158,17 @@ class GearboxSDK extends ChainContractsRegister {
     }).#hydrate(rest, state);
   }
   constructor(options) {
-    super(options.client, options.logger);
+    this.logger = options.logger;
     this.strictContractTypes = options.strictContractTypes ?? false;
     this.plugins = options.plugins ?? {};
+    this.#client = options.client;
     for (const plugin of Object.values(this.plugins)) {
       plugin.sdk = this;
     }
     if (options.gasLimit !== null) {
       this.gasLimit = options.gasLimit || 550000000n;
     }
-    Object.assign(this, ChainContractsRegister.for(this.client, this.logger));
+    this.tokensMeta = new TokensMeta(this);
   }
   async #attach(opts) {
     const {
@@ -304,9 +324,74 @@ class GearboxSDK extends ChainContractsRegister {
       timestamp: state.timestamp
     });
   }
+  get client() {
+    return this.#client;
+  }
+  /**
+   * Replaces client inflight
+   * You're responsible for all inconsistencies between new and old client
+   * @param options
+   */
+  replaceClient(options, network) {
+    this.#client = createClient(options, network);
+  }
   get networkType() {
     return this.client.chain.network;
   }
+  get chain() {
+    return this.client.chain;
+  }
+  get chainId() {
+    return this.client.chain.id;
+  }
+  /**
+   * Converts contract call into some human-friendly string
+   * This method is safe and should not throw
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseFunctionData(address, calldata) {
+    const contract = this.contracts.get(address);
+    return contract ? contract.parseFunctionData(calldata) : `unknown: ${address}.${calldata.slice(0, 10)}`;
+  }
+  /**
+   * Converts multicalls into some human-friendly strings
+   * This method is safe and should not throw
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseMultiCall(calls) {
+    return calls.map(
+      (call) => this.parseFunctionData(call.target, call.callData)
+    );
+  }
+  /**
+   * Return args, function, type and address name from contract call
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseFunctionDataToObject(address, calldata) {
+    const contract = this.contracts.get(address);
+    return contract ? {
+      ...contract.parseFunctionDataToObject(calldata),
+      address,
+      type: contract.contractType
+    } : null;
+  }
+  /**
+   * Converts multicalls into call info
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseMultiCallToObject(calls) {
+    return calls.map(
+      (call) => this.parseFunctionDataToObject(call.target, call.callData)
+    );
+  }
   stateHuman(raw = true) {
     return {
       block: Number(this.currentBlock),
@@ -398,7 +483,7 @@ class GearboxSDK extends ChainContractsRegister {
         address: watchAddresses
       });
       for (const log of logs) {
-        const contract = this.getContract(log.address);
+        const contract = this.contracts.get(log.address);
         if (contract) {
           const event = parseEventLogs({
             abi: contract.abi,
@@ -487,11 +572,17 @@ class GearboxSDK extends ChainContractsRegister {
   }
   get botListContract() {
     const addr = this.addressProvider.getAddress(AP_BOT_LIST, NO_VERSION);
-    return this.getContract(addr) ?? new BotListContract(this, addr);
+    if (!this.contracts.has(addr)) {
+      return new BotListContract(this, addr);
+    }
+    return this.contracts.get(addr);
   }
   get gearStakingContract() {
     const addr = this.addressProvider.getAddress(AP_GEAR_STAKING, NO_VERSION);
-    return this.getContract(addr) ?? new GearStakingContract(this, addr);
+    if (!this.contracts.has(addr)) {
+      return new GearStakingContract(this, addr);
+    }
+    return this.contracts.get(addr);
   }
   get marketRegister() {
     if (this.#marketRegister === void 0) {
@@ -518,7 +609,7 @@ class GearboxSDK extends ChainContractsRegister {
         );
         facadeAddr = cm.creditFacade.address;
       }
-      const facadeV = this.mustGetContract(facadeAddr).version;
+      const facadeV = this.contracts.mustGet(facadeAddr).version;
       routerRange = isV310(facadeV) ? VERSION_RANGE_310 : VERSION_RANGE_300;
     }
     const routerEntry = this.addressProvider.getLatest(AP_ROUTER, routerRange);
@@ -526,7 +617,18 @@ class GearboxSDK extends ChainContractsRegister {
       throw new Error(`router not found in version range ${routerRange}`);
     }
     const [routerAddr, routerV] = routerEntry;
-    return createRouter(this, routerAddr, routerV);
+    if (!this.contracts.has(routerAddr)) {
+      return createRouter(this, routerAddr, routerV);
+    }
+    return this.contracts.get(routerAddr);
+  }
+  /**
+   * Helper to get human-friendly label for address
+   * @param address
+   * @returns
+   */
+  labelAddress(address) {
+    return this.addressLabels.get(address);
   }
 }
 export {

package/dist/esm/sdk/accountMigration/AbstractMigrateCreditAccountsService.js

@@ -7,7 +7,9 @@ import { createCreditAccountService } from "../accounts/createCreditAccountServi
 import { SDKConstruct } from "../base/index.js";
 import { chains as CHAINS } from "../chain/chains.js";
 import { isV310 } from "../constants/versions.js";
+import { childLogger } from "../utils/index.js";
 class AbstractMigrateCreditAccountsService extends SDKConstruct {
+  #logger;
   #version;
   #service;
   // TODO: HARDCODED
@@ -29,7 +31,8 @@ class AbstractMigrateCreditAccountsService extends SDKConstruct {
     super(sdk);
     this.#version = version;
     this.#service = createCreditAccountService(this.sdk, version);
-    this.logger?.debug(
+    this.#logger = childLogger("MigrateCreditAccountsService", sdk.logger);
+    this.#logger?.debug(
       `Created MigrateCreditAccountsService with version: ${this.#version}`
     );
   }

package/dist/esm/sdk/accounts/AbstractCreditAccountsService.js

@@ -25,7 +25,7 @@ import {
 } from "../constants/index.js";
 import { assetsMap } from "../router/index.js";
 import { BigIntMath } from "../sdk-legacy/index.js";
-import { AddressMap } from "../utils/index.js";
+import { AddressMap, childLogger } from "../utils/index.js";
 import { simulateWithPriceUpdates } from "../utils/viem/index.js";
 function getWithdrawalCompressorAddress(chainId) {
   const compressor = chainId === 1 ? "0xfB79b6713fe214B8748ED7b0db1f93E4f1aC9d29" : void 0;
@@ -34,6 +34,7 @@ function getWithdrawalCompressorAddress(chainId) {
 class AbstractCreditAccountService extends SDKConstruct {
   #compressor;
   #batchSize;
+  #logger;
   constructor(sdk, options) {
     super(sdk);
     [this.#compressor] = sdk.addressProvider.mustGetLatest(
@@ -41,7 +42,8 @@ class AbstractCreditAccountService extends SDKConstruct {
       VERSION_RANGE_310
     );
     this.#batchSize = options?.batchSize;
-    this.logger?.debug(
+    this.#logger = childLogger("CreditAccountsService", sdk.logger);
+    this.#logger?.debug(
       `credit account compressor address: ${this.#compressor}`
     );
   }
@@ -143,7 +145,7 @@ class AbstractCreditAccountService extends SDKConstruct {
         offset = newOffset;
       } while (offset !== 0n);
     }
-    this.logger?.debug(
+    this.#logger?.debug(
       `loaded ${allCAs.length} credit accounts (${allCAs.length - revertingOffset} reverting)`
     );
     return allCAs.sort((a, b) => Number(a.healthFactor - b.healthFactor));
@@ -280,7 +282,7 @@ class AbstractCreditAccountService extends SDKConstruct {
       lossPolicyData = await market.lossPolicy.getLiquidationData(
         account.creditAccount
       );
-      this.logger?.debug({ lossPolicyData }, "loss policy data");
+      this.#logger?.debug({ lossPolicyData }, "loss policy data");
     }
     const tx = cm.creditFacade.liquidateCreditAccount(
       account.creditAccount,
@@ -838,7 +840,7 @@ class AbstractCreditAccountService extends SDKConstruct {
         gas: this.sdk.gasLimit
       });
     }
-    this.logger?.debug(
+    this.#logger?.debug(
       {
         accounts: resp[0]?.length ?? 0,
         nextOffset: Number(resp[1])
@@ -918,7 +920,7 @@ class AbstractCreditAccountService extends SDKConstruct {
     });
     const tStr = Array.from(tokens).map((t) => this.labelAddress(t)).join(", ");
     const remark = ignoreReservePrices ? " main" : "";
-    this.logger?.debug(
+    this.#logger?.debug(
       { account: creditAccount?.creditAccount, manager: cm.name },
       `generating price feed updates for ${tStr} from ${priceFeeds.length}${remark} price feeds`
     );
@@ -934,7 +936,7 @@ class AbstractCreditAccountService extends SDKConstruct {
     const market = this.sdk.marketRegister.findByCreditManager(creditManager);
     const cm = this.sdk.marketRegister.findCreditManager(creditManager);
     const update = await this.getUpdateForAccount(options);
-    this.logger?.debug(
+    this.#logger?.debug(
       { account: creditAccount?.creditAccount, manager: cm.name },
       `getting on demand price updates from ${update.txs.length} txs`
     );

package/dist/esm/sdk/base/AddressLabeller.js

@@ -0,0 +1,25 @@
+import { NOT_DEPLOYED } from "../constants/index.js";
+import { AddressMap } from "../utils/index.js";
+class AddressLabeller {
+  #labels = new AddressMap(void 0, "addressLabeller");
+  set(address, label) {
+    if (address === NOT_DEPLOYED) {
+      return;
+    }
+    if (typeof label === "string") {
+      this.#labels.upsert(address, label);
+    } else {
+      this.#labels.upsert(address, label(this.#labels.get(address)));
+    }
+  }
+  get(address) {
+    const label = this.#labels.get(address);
+    return label ? `${address} [${label}]` : address;
+  }
+  get all() {
+    return this.#labels.asRecord();
+  }
+}
+export {
+  AddressLabeller
+};