@ckb-ccc/core 1.19.1 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckb-ccc/core",
-  "version": "1.19.1",
+  "version": "1.20.0",
   "description": "Core of CCC - CKBer's Codebase",
   "author": "Hanssen0 <hanssen0@hanssen0.com>",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "eslint-plugin-prettier": "^5.5.6",
     "prettier": "^3.8.4",
     "prettier-plugin-organize-imports": "^4.3.0",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
     "typescript-eslint": "^8.61.1",
@@ -56,22 +56,23 @@
     "@noble/hashes": "^2.2.0",
     "bech32": "^2.0.0",
     "bs58check": "^4.0.0",
-    "buffer": "^6.0.3",
     "ethers": "^6.17.0",
     "isomorphic-ws": "^5.0.0",
+    "uint8array-extras": "^1.5.0",
     "ws": "^8.21.0"
   },
   "types": "./dist.commonjs/index.d.ts",
   "inlinedDependencies": {
-    "@noble/ciphers": "2.3.0",
-    "@noble/curves": "2.3.0",
+    "@noble/ciphers": "2.4.0",
+    "@noble/curves": "2.4.0",
     "@noble/hashes": [
       "1.8.0",
-      "2.3.0"
+      "2.4.0"
     ],
     "base-x": "5.0.1",
     "bs58": "6.0.0",
-    "bs58check": "4.0.0"
+    "bs58check": "4.0.0",
+    "uint8array-extras": "1.5.0"
   },
   "scripts": {
     "test": "vitest",

package/src/advancedBarrel.ts

@@ -4,3 +4,4 @@ export * from "./ckb/advanced.js";
 export * from "./client/advanced.js";
 export * from "./hasher/advanced.js";
 export * from "./jsonRpc/advanced.js";
+export * from "./signer/advanced.js";

package/src/bytes/advanced.ts

@@ -4,11 +4,6 @@
  */
 export type BytesFromEncoding =
   | "utf8" // UTF-8 encoding
-  | "utf16le" // UTF-16 Little Endian encoding
-  | "latin1" // Latin-1 (ISO-8859-1) encoding
   | "base64" // Base64 encoding
   | "base64url" // Base64 URL encoding
-  | "hex" // Hexadecimal encoding
-  | "ascii" // ASCII encoding
-  | "binary" // Binary encoding
-  | "ucs2"; // UCS-2 (alias of UTF-16LE) encoding
+  | "hex"; // Hexadecimal encoding

package/src/bytes/index.ts

@@ -1,5 +1,12 @@
-import { Buffer } from "buffer/index.js";
-import { BytesFromEncoding } from "./advanced.js";
+import {
+  base64ToUint8Array,
+  hexToUint8Array,
+  stringToUint8Array,
+  uint8ArrayToBase64,
+  uint8ArrayToHex,
+  uint8ArrayToString,
+} from "uint8array-extras";
+import type { BytesFromEncoding } from "./advanced.js";
 
 /**
  * @public
@@ -91,7 +98,18 @@ export function bytesConcat(...args: BytesLike[]): Bytes {
  */
 
 export function bytesTo(val: BytesLike, encoding: BytesFromEncoding): string {
-  return Buffer.from(bytesFrom(val)).toString(encoding);
+  const bytes = bytesFrom(val);
+
+  switch (encoding) {
+    case "utf8":
+      return uint8ArrayToString(bytes);
+    case "base64":
+      return uint8ArrayToBase64(bytes);
+    case "base64url":
+      return uint8ArrayToBase64(bytes, { urlSafe: true });
+    case "hex":
+      return uint8ArrayToHex(bytes);
+  }
 }
 
 /**
@@ -133,17 +151,13 @@ export function bytesFrom(
   }
 
   if (typeof bytes === "string") {
-    if (encoding !== undefined) {
-      return Buffer.from(bytes, encoding);
+    if (encoding !== undefined && encoding !== "hex") {
+      return bytesFromString(bytes, encoding);
     }
 
     const str = bytes.startsWith("0x") ? bytes.slice(2) : bytes;
     const paddedStr = str.length % 2 === 0 ? str : `0${str}`;
-    const data = Buffer.from(paddedStr, "hex");
-    if (data.length * 2 !== paddedStr.length) {
-      throw new Error(`Invalid bytes ${bytes}`);
-    }
-    return data;
+    return hexToUint8Array(paddedStr);
   }
 
   const bytesArr = Array.from(bytes);
@@ -153,6 +167,19 @@ export function bytesFrom(
   return new Uint8Array(bytes);
 }
 
+function bytesFromString(
+  value: string,
+  encoding: Exclude<BytesFromEncoding, "hex">,
+): Bytes {
+  switch (encoding) {
+    case "utf8":
+      return stringToUint8Array(value);
+    case "base64":
+    case "base64url":
+      return base64ToUint8Array(value);
+  }
+}
+
 /**
  * Compares two byte-like values for equality.
  * @public

package/src/ckb/transaction.ts

@@ -1,11 +1,11 @@
 import { Bytes, BytesLike, bytesFrom } from "../bytes/index.js";
+import type { Client } from "../client/client.js";
 import type { ClientCollectableSearchKeyFilterLike } from "../client/clientTypes.advanced.js";
 import {
   ClientBlockHeader,
   type CellDepInfoLike,
-  type Client,
   type ClientBlockHeaderLike,
-} from "../client/index.js";
+} from "../client/clientTypes.js";
 import { KnownScript } from "../client/knownScript.js";
 import { Codec, Entity, codec } from "../codec/index.js";
 import { Zero, fixedPointFrom } from "../fixedPoint/index.js";
@@ -1098,7 +1098,7 @@ export class WitnessArgs extends Entity.Base<WitnessArgsLike, WitnessArgs>() {
  * @public
  */
 export function udtBalanceFrom(dataLike: BytesLike): Num {
-  const data = bytesFrom(dataLike).slice(0, 16);
+  const data = bytesFrom(dataLike).subarray(0, 16);
   return data.length === 0 ? Zero : numFromBytes(data);
 }
 
@@ -2795,9 +2795,9 @@ export function calcDaoClaimEpoch(
   if (
     partialCycle !== Zero ||
     //  deposit.numerator        withdraw.numerator
-    // --------------------- <= ----------------------
+    // --------------------- < -----------------------
     //  deposit.denominator      withdraw.denominator
-    deposit.numerator * withdraw.denominator <=
+    deposit.numerator * withdraw.denominator <
       withdraw.numerator * deposit.denominator
   ) {
     // Need to wait for the next cycle

package/src/client/client.ts

@@ -34,19 +34,33 @@ import {
   ErrorClientWaitTransactionTimeout,
   OutputsValidator,
   ScriptInfo,
+  type ScriptInfoLike,
 } from "./clientTypes.js";
 import { KnownScript } from "./knownScript.js";
 
+export type ClientConfig = {
+  cache?: ClientCache;
+  scripts?: Partial<Record<KnownScript, ScriptInfoLike>>;
+};
+
 /**
  * @public
  */
 export abstract class Client {
   public cache: ClientCache;
+  private readonly scripts: Partial<Record<KnownScript, ScriptInfoLike>>;
 
-  constructor(config?: { cache?: ClientCache }) {
+  constructor(config?: ClientConfig) {
     this.cache = config?.cache ?? new ClientCacheMemory();
+    this.scripts = config?.scripts ?? {};
   }
 
+  /**
+   * The legacy primary URL associated with this Client.
+   *
+   * @deprecated A Client may use multiple endpoints or a Transport without a
+   * URL, so this value does not reliably identify its connection.
+   */
   abstract get url(): string;
   abstract get addressPrefix(): string;
 
@@ -61,7 +75,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    *
    * // Get xUDT script deployment info
    * const xudtInfo = await client.getKnownScript(ccc.KnownScript.XUdt);
@@ -75,7 +91,15 @@ export abstract class Client {
    * );
    * ```
    */
-  abstract getKnownScript(script: KnownScript): Promise<ScriptInfo>;
+  async getKnownScript(script: KnownScript): Promise<ScriptInfo> {
+    const found = this.scripts[script];
+    if (!found) {
+      throw new Error(
+        `No script information was found for ${script} on ${this.addressPrefix}`,
+      );
+    }
+    return ScriptInfo.from(found);
+  }
 
   abstract getFeeRateStatistics(
     blockRange?: NumLike,
@@ -92,7 +116,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const feeRate = await client.getFeeRate();
    * console.log(`Current fee rate: ${feeRate} Shannons/KB`);
    * ```
@@ -123,7 +149,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const tipBlockNumber = await client.getTip();
    * console.log(`Current block height: ${tipBlockNumber}`);
    * ```
@@ -140,7 +168,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const header = await client.getTipHeader();
    * console.log(`Block #${header.number}, hash: ${header.hash}`);
    * ```
@@ -260,7 +290,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const cell = await client.getCell({
    *   txHash: "0xTX_HASH...",
    *   index: 0,
@@ -339,7 +371,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const cell = await client.getCellLive(
    *   { txHash: "0xTX_HASH...", index: 0 },
    *   true,  // include data
@@ -388,7 +422,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const { script: lock } = await ccc.Address.fromString("ckt1q...", client);
    *
    * // Get first page of cells
@@ -453,7 +489,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const { script: lock } = await ccc.Address.fromString("ckt1q...", client);
    *
    * // Find all cells owned by a lock script
@@ -507,7 +545,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const { script: lock } = await ccc.Address.fromString("ckt1q...", client);
    *
    * // Find all cells belonging to this address
@@ -559,7 +599,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * // Find all xUDT cells of a specific token
    * const xudtType = await ccc.Script.fromKnownScript(
    *   client, ccc.KnownScript.XUdt, "0xOWNER_LOCK_HASH...",
@@ -612,7 +654,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const xudtInfo = await client.getKnownScript(ccc.KnownScript.XUdt);
    * const cellDeps = await client.getCellDeps(xudtInfo.cellDeps);
    * // cellDeps can be added to a transaction:
@@ -729,7 +773,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const { script: lock } = await ccc.Address.fromString("ckt1q...", client);
    *
    * // List all transactions related to an address (grouped)
@@ -842,7 +888,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const { script: lock } = await ccc.Address.fromString(
    *   "ckt1qzda0cr08m85hc8jlnfp3zer7xulejywt49kt2rr0vthywaa50xwsq...",
    *   client,
@@ -874,7 +922,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const signer = new ccc.SignerCkbPrivateKey(client, "0x...");
    * await signer.connect();
    *
@@ -905,7 +955,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const signer = new ccc.SignerCkbPrivateKey(client, "0x...");
    * await signer.connect();
    *
@@ -949,7 +1001,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * const txResponse = await client.getTransaction("0xTX_HASH...");
    * if (txResponse) {
    *   console.log(`Status: ${txResponse.status}`);
@@ -1022,7 +1076,9 @@ export abstract class Client {
    * ```typescript
    * import { ccc } from "@ckb-ccc/core";
    *
-   * const client = new ccc.ClientPublicTestnet();
+   * const clientOwner = ccc.ClientPublicTestnet.open();
+   * const client = clientOwner.value;
+   * // Call `await clientOwner.dispose()` when the client is no longer needed.
    * // Wait for transaction to be committed (0 confirmations)
    * const tx = await client.waitTransaction("0xTX_HASH...");
    * console.log(`Confirmed in block: ${tx?.blockNumber}`);

package/src/client/clientPublicMainnet.ts

@@ -1,55 +1,94 @@
 import WebSocket from "isomorphic-ws";
+import { RequestorJsonRpc } from "../jsonRpc/requestor.js";
+import type { ClientConfig } from "./client.js";
 import { MAINNET_SCRIPTS } from "./clientPublicMainnet.advanced.js";
-import { ScriptInfo, ScriptInfoLike } from "./clientTypes.js";
-import { ClientJsonRpc, ClientJsonRpcConfig } from "./jsonRpc/index.js";
-import { KnownScript } from "./knownScript.js";
+import { ClientJsonRpc, type ClientJsonRpcConfig } from "./jsonRpc/client.js";
 
 /**
  * @public
  */
 export class ClientPublicMainnet extends ClientJsonRpc {
+  private static defaultUrls(): readonly [string, ...string[]] {
+    return typeof WebSocket !== "undefined"
+      ? [
+          "wss://mainnet.ckb.dev/ws",
+          "https://mainnet.ckb.dev/",
+          "https://mainnet.ckbapp.dev/",
+        ]
+      : ["https://mainnet.ckb.dev/", "https://mainnet.ckbapp.dev/"];
+  }
+
+  private static resolveConfig(
+    config?: ClientJsonRpcConfig & {
+      /** @deprecated URL belongs to Transport construction. */
+      url?: string;
+    },
+  ): ClientJsonRpcConfig & { url: string; fallbacks: string[] } {
+    const defaultUrls = this.defaultUrls();
+    return {
+      ...config,
+      url: config?.url ?? defaultUrls[0],
+      fallbacks: config?.fallbacks ?? [...defaultUrls],
+      scripts: config?.scripts ?? MAINNET_SCRIPTS,
+    };
+  }
+
+  /**
+   * @deprecated Use {@link ClientPublicMainnet.new} with a borrowed Transport or
+   * {@link ClientPublicMainnet.open} when creating Transports.
+   */
   constructor(
-    private readonly config?: ClientJsonRpcConfig & {
+    config?: ClientJsonRpcConfig & {
+      /** @deprecated URL belongs to Transport construction. */
       url?: string;
-      scripts?: Record<KnownScript, ScriptInfoLike | undefined>;
     },
   ) {
-    const hasWebSocket = typeof WebSocket !== "undefined";
-    super(
-      config?.url ??
-        (hasWebSocket
-          ? "wss://mainnet.ckb.dev/ws"
-          : "https://mainnet.ckb.dev/"),
-      {
-        ...config,
-        fallbacks:
-          config?.fallbacks ??
-          (hasWebSocket
-            ? [
-                "wss://mainnet.ckb.dev/ws",
-                "https://mainnet.ckb.dev/",
-                "https://mainnet.ckbapp.dev/",
-              ]
-            : ["https://mainnet.ckb.dev/", "https://mainnet.ckbapp.dev/"]),
-      },
-    );
+    const resolved = ClientPublicMainnet.resolveConfig(config);
+    super(resolved.url, resolved);
   }
 
-  get scripts(): Record<KnownScript, ScriptInfoLike | undefined> {
-    return this.config?.scripts ?? MAINNET_SCRIPTS;
+  /** Creates a Client that borrows an existing Transport. */
+  static new(
+    config: Omit<Parameters<typeof RequestorJsonRpc.new>[0], "onError"> &
+      ClientConfig,
+  ): ClientPublicMainnet {
+    const { cache, scripts, ...requestorConfig } = config;
+    const requestor = this.newRequestor(requestorConfig);
+    return new ClientPublicMainnet({ cache, scripts, requestor });
   }
 
-  get addressPrefix(): string {
-    return "ckb";
+  /** Opens a Client with explicit ownership of its default dependencies. */
+  static open(
+    config?: Omit<
+      Parameters<typeof RequestorJsonRpc.open>[0],
+      "onError" | "urls"
+    > &
+      ClientConfig & {
+        urls?: Parameters<typeof RequestorJsonRpc.open>[0]["urls"];
+      },
+  ) {
+    const {
+      cache,
+      scripts,
+      urls = this.defaultUrls(),
+      ...requestorConfig
+    } = config ?? {};
+    return this.openRequestor({
+      ...requestorConfig,
+      urls,
+    }).map(
+      (requestor) =>
+        new ClientPublicMainnet({
+          cache,
+          scripts,
+          requestor,
+          url: urls[0],
+          fallbacks: [...urls.slice(1)],
+        }),
+    );
   }
 
-  async getKnownScript(script: KnownScript): Promise<ScriptInfo> {
-    const found = this.scripts[script];
-    if (!found) {
-      throw new Error(
-        `No script information was found for ${script} on ${this.addressPrefix}`,
-      );
-    }
-    return ScriptInfo.from(found);
+  get addressPrefix(): string {
+    return "ckb";
   }
 }

package/src/client/clientPublicTestnet.ts

@@ -1,55 +1,94 @@
 import WebSocket from "isomorphic-ws";
+import { RequestorJsonRpc } from "../jsonRpc/requestor.js";
+import type { ClientConfig } from "./client.js";
 import { TESTNET_SCRIPTS } from "./clientPublicTestnet.advanced.js";
-import { ScriptInfo, ScriptInfoLike } from "./clientTypes.js";
-import { ClientJsonRpc, ClientJsonRpcConfig } from "./jsonRpc/index.js";
-import { KnownScript } from "./knownScript.js";
+import { ClientJsonRpc, type ClientJsonRpcConfig } from "./jsonRpc/client.js";
 
 /**
  * @public
  */
 export class ClientPublicTestnet extends ClientJsonRpc {
+  private static defaultUrls(): readonly [string, ...string[]] {
+    return typeof WebSocket !== "undefined"
+      ? [
+          "wss://testnet.ckb.dev/ws",
+          "https://testnet.ckb.dev/",
+          "https://testnet.ckbapp.dev/",
+        ]
+      : ["https://testnet.ckb.dev/", "https://testnet.ckbapp.dev/"];
+  }
+
+  private static resolveConfig(
+    config?: ClientJsonRpcConfig & {
+      /** @deprecated URL belongs to Transport construction. */
+      url?: string;
+    },
+  ): ClientJsonRpcConfig & { url: string; fallbacks: string[] } {
+    const defaultUrls = this.defaultUrls();
+    return {
+      ...config,
+      url: config?.url ?? defaultUrls[0],
+      fallbacks: config?.fallbacks ?? [...defaultUrls],
+      scripts: config?.scripts ?? TESTNET_SCRIPTS,
+    };
+  }
+
+  /**
+   * @deprecated Use {@link ClientPublicTestnet.new} with a borrowed Transport or
+   * {@link ClientPublicTestnet.open} when creating Transports.
+   */
   constructor(
-    private readonly config?: ClientJsonRpcConfig & {
+    config?: ClientJsonRpcConfig & {
+      /** @deprecated URL belongs to Transport construction. */
       url?: string;
-      scripts?: Record<KnownScript, ScriptInfoLike | undefined>;
     },
   ) {
-    const hasWebSocket = typeof WebSocket !== "undefined";
-    super(
-      config?.url ??
-        (hasWebSocket
-          ? "wss://testnet.ckb.dev/ws"
-          : "https://testnet.ckb.dev/"),
-      {
-        ...config,
-        fallbacks:
-          config?.fallbacks ??
-          (hasWebSocket
-            ? [
-                "wss://testnet.ckb.dev/ws",
-                "https://testnet.ckb.dev/",
-                "https://testnet.ckbapp.dev/",
-              ]
-            : ["https://testnet.ckb.dev/", "https://testnet.ckbapp.dev/"]),
-      },
-    );
+    const resolved = ClientPublicTestnet.resolveConfig(config);
+    super(resolved.url, resolved);
   }
 
-  get scripts(): Record<KnownScript, ScriptInfoLike | undefined> {
-    return this.config?.scripts ?? TESTNET_SCRIPTS;
+  /** Creates a Client that borrows an existing Transport. */
+  static new(
+    config: Omit<Parameters<typeof RequestorJsonRpc.new>[0], "onError"> &
+      ClientConfig,
+  ): ClientPublicTestnet {
+    const { cache, scripts, ...requestorConfig } = config;
+    const requestor = this.newRequestor(requestorConfig);
+    return new ClientPublicTestnet({ cache, scripts, requestor });
   }
 
-  get addressPrefix(): string {
-    return "ckt";
+  /** Opens a Client with explicit ownership of its default dependencies. */
+  static open(
+    config?: Omit<
+      Parameters<typeof RequestorJsonRpc.open>[0],
+      "onError" | "urls"
+    > &
+      ClientConfig & {
+        urls?: Parameters<typeof RequestorJsonRpc.open>[0]["urls"];
+      },
+  ) {
+    const {
+      cache,
+      scripts,
+      urls = this.defaultUrls(),
+      ...requestorConfig
+    } = config ?? {};
+    return this.openRequestor({
+      ...requestorConfig,
+      urls,
+    }).map(
+      (requestor) =>
+        new ClientPublicTestnet({
+          cache,
+          scripts,
+          requestor,
+          url: urls[0],
+          fallbacks: [...urls.slice(1)],
+        }),
+    );
   }
 
-  async getKnownScript(script: KnownScript): Promise<ScriptInfo> {
-    const found = this.scripts[script];
-    if (!found) {
-      throw new Error(
-        `No script information was found for ${script} on ${this.addressPrefix}`,
-      );
-    }
-    return ScriptInfo.from(found);
+  get addressPrefix(): string {
+    return "ckt";
   }
 }