@ckb-ccc/core 1.2.2 → 1.3.0

package/dist.commonjs/molecule/codec.js

@@ -254,13 +254,13 @@ function table(codecLayout) {
         },
         decode(buffer) {
             const value = (0, index_js_1.bytesFrom)(buffer);
+            if (value.byteLength < 4) {
+                throw new Error(`table: too short buffer, expected at least 4 bytes, but got ${value.byteLength}`);
+            }
             const byteLength = uint32From(value.slice(0, 4));
             if (byteLength !== value.byteLength) {
                 throw new Error(`table: invalid buffer size, expected ${byteLength}, but got ${value.byteLength}`);
             }
-            if (byteLength <= 4) {
-                throw new Error("table: empty buffer");
-            }
             const offsets = keys.map((_, index) => uint32From(value.slice(4 + index * 4, 8 + index * 4)));
             offsets.push(byteLength);
             const object = {};

package/dist.commonjs/molecule/predefined.d.ts

@@ -36,6 +36,18 @@ export declare const Uint512Vec: Codec<import("../barrel.js").NumLike[], bigint[
 export declare const Bytes: Codec<HexLike, Hex>;
 export declare const BytesOpt: Codec<import("../bytes/index.js").BytesLike | null | undefined, `0x${string}` | undefined>;
 export declare const BytesVec: Codec<import("../bytes/index.js").BytesLike[], `0x${string}`[]>;
+export declare const Bool: Codec<boolean>;
+export declare const BoolOpt: Codec<boolean | null | undefined, boolean | undefined>;
+export declare const BoolVec: Codec<boolean[], boolean[]>;
+export declare const Byte4: Codec<HexLike, Hex>;
+export declare const Byte4Opt: Codec<import("../bytes/index.js").BytesLike | null | undefined, `0x${string}` | undefined>;
+export declare const Byte4Vec: Codec<import("../bytes/index.js").BytesLike[], `0x${string}`[]>;
+export declare const Byte8: Codec<HexLike, Hex>;
+export declare const Byte8Opt: Codec<import("../bytes/index.js").BytesLike | null | undefined, `0x${string}` | undefined>;
+export declare const Byte8Vec: Codec<import("../bytes/index.js").BytesLike[], `0x${string}`[]>;
+export declare const Byte16: Codec<HexLike, Hex>;
+export declare const Byte16Opt: Codec<import("../bytes/index.js").BytesLike | null | undefined, `0x${string}` | undefined>;
+export declare const Byte16Vec: Codec<import("../bytes/index.js").BytesLike[], `0x${string}`[]>;
 export declare const Byte32: Codec<HexLike, Hex>;
 export declare const Byte32Opt: Codec<import("../bytes/index.js").BytesLike | null | undefined, `0x${string}` | undefined>;
 export declare const Byte32Vec: Codec<import("../bytes/index.js").BytesLike[], `0x${string}`[]>;

package/dist.commonjs/molecule/predefined.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"predefined.d.ts","sourceRoot":"","sources":["../../src/molecule/predefined.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAW,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAW,KAAK,EAAoC,MAAM,YAAY,CAAC;AAE9E,eAAO,MAAM,KAAK,+CAAsB,CAAC;AACzC,eAAO,MAAM,QAAQ,8EAAgB,CAAC;AACtC,eAAO,MAAM,QAAQ,mDAAgB,CAAC;AAEtC,eAAO,MAAM,QAAQ,+CAAsB,CAAC;AAC5C,eAAO,MAAM,QAAQ,+CAAgB,CAAC;AACtC,eAAO,MAAM,MAAM,+CAAW,CAAC;AAC/B,eAAO,MAAM,SAAS,8EAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,mDAAiB,CAAC;AAExC,eAAO,MAAM,QAAQ,+CAAsB,CAAC;AAC5C,eAAO,MAAM,QAAQ,+CAAgB,CAAC;AACtC,eAAO,MAAM,MAAM,+CAAW,CAAC;AAC/B,eAAO,MAAM,SAAS,8EAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,mDAAiB,CAAC;AAExC,eAAO,MAAM,QAAQ,+CAAgB,CAAC;AACtC,eAAO,MAAM,QAAQ,+CAAU,CAAC;AAChC,eAAO,MAAM,MAAM,+CAAW,CAAC;AAC/B,eAAO,MAAM,SAAS,8EAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,mDAAiB,CAAC;AAExC,eAAO,MAAM,SAAS,+CAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,+CAAW,CAAC;AAClC,eAAO,MAAM,OAAO,+CAAY,CAAC;AACjC,eAAO,MAAM,UAAU,8EAAkB,CAAC;AAC1C,eAAO,MAAM,UAAU,mDAAkB,CAAC;AAE1C,eAAO,MAAM,SAAS,+CAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,+CAAW,CAAC;AAClC,eAAO,MAAM,OAAO,+CAAY,CAAC;AACjC,eAAO,MAAM,UAAU,8EAAkB,CAAC;AAC1C,eAAO,MAAM,UAAU,mDAAkB,CAAC;AAE1C,eAAO,MAAM,SAAS,+CAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,+CAAW,CAAC;AAClC,eAAO,MAAM,OAAO,+CAAY,CAAC;AACjC,eAAO,MAAM,UAAU,8EAAkB,CAAC;AAC1C,eAAO,MAAM,UAAU,mDAAkB,CAAC;AAE1C,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAGpC,CAAC;AACH,eAAO,MAAM,QAAQ,4FAAgB,CAAC;AACtC,eAAO,MAAM,QAAQ,iEAAgB,CAAC;AAEtC,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAIrC,CAAC;AACH,eAAO,MAAM,SAAS,4FAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,iEAAiB,CAAC;AAExC,eAAO,MAAM,MAAM,uBAGjB,CAAC;AACH,eAAO,MAAM,SAAS,2BAAiB,CAAC;AACxC,eAAO,MAAM,SAAS,sDAAiB,CAAC"}
+{"version":3,"file":"predefined.d.ts","sourceRoot":"","sources":["../../src/molecule/predefined.ts"],"names":[],"mappings":"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"}

package/dist.commonjs/molecule/predefined.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StringOpt = exports.StringVec = exports.String = exports.Byte32Vec = exports.Byte32Opt = exports.Byte32 = exports.BytesVec = exports.BytesOpt = exports.Bytes = exports.Uint512Vec = exports.Uint512Opt = exports.Uint512 = exports.Uint512BE = exports.Uint512LE = exports.Uint256Vec = exports.Uint256Opt = exports.Uint256 = exports.Uint256BE = exports.Uint256LE = exports.Uint128Vec = exports.Uint128Opt = exports.Uint128 = exports.Uint128BE = exports.Uint128LE = exports.Uint64Vec = exports.Uint64Opt = exports.Uint64 = exports.Uint64BE = exports.Uint64LE = exports.Uint32Vec = exports.Uint32Opt = exports.Uint32 = exports.Uint32BE = exports.Uint32LE = exports.Uint16Vec = exports.Uint16Opt = exports.Uint16 = exports.Uint16BE = exports.Uint16LE = exports.Uint8Vec = exports.Uint8Opt = exports.Uint8 = void 0;
+exports.Byte32Opt = exports.Byte32 = exports.Byte16Vec = exports.Byte16Opt = exports.Byte16 = exports.Byte8Vec = exports.Byte8Opt = exports.Byte8 = exports.Byte4Vec = exports.Byte4Opt = exports.Byte4 = exports.BoolVec = exports.BoolOpt = exports.Bool = exports.BytesVec = exports.BytesOpt = exports.Bytes = exports.Uint512Vec = exports.Uint512Opt = exports.Uint512 = exports.Uint512BE = exports.Uint512LE = exports.Uint256Vec = exports.Uint256Opt = exports.Uint256 = exports.Uint256BE = exports.Uint256LE = exports.Uint128Vec = exports.Uint128Opt = exports.Uint128 = exports.Uint128BE = exports.Uint128LE = exports.Uint64Vec = exports.Uint64Opt = exports.Uint64 = exports.Uint64BE = exports.Uint64LE = exports.Uint32Vec = exports.Uint32Opt = exports.Uint32 = exports.Uint32BE = exports.Uint32LE = exports.Uint16Vec = exports.Uint16Opt = exports.Uint16 = exports.Uint16BE = exports.Uint16LE = exports.Uint8Vec = exports.Uint8Opt = exports.Uint8 = void 0;
+exports.StringOpt = exports.StringVec = exports.String = exports.Byte32Vec = void 0;
 const index_js_1 = require("../bytes/index.js");
 const index_js_2 = require("../hex/index.js");
 const codec_js_1 = require("./codec.js");
@@ -43,6 +44,34 @@ exports.Bytes = (0, codec_js_1.byteVec)({
 });
 exports.BytesOpt = (0, codec_js_1.option)(exports.Bytes);
 exports.BytesVec = (0, codec_js_1.vector)(exports.Bytes);
+exports.Bool = codec_js_1.Codec.from({
+    byteLength: 1,
+    encode: (value) => (0, index_js_1.bytesFrom)(value ? [1] : [0]),
+    decode: (buffer) => (0, index_js_1.bytesFrom)(buffer)[0] !== 0,
+});
+exports.BoolOpt = (0, codec_js_1.option)(exports.Bool);
+exports.BoolVec = (0, codec_js_1.vector)(exports.Bool);
+exports.Byte4 = codec_js_1.Codec.from({
+    byteLength: 4,
+    encode: (value) => (0, index_js_1.bytesFrom)(value),
+    decode: (buffer) => (0, index_js_2.hexFrom)(buffer),
+});
+exports.Byte4Opt = (0, codec_js_1.option)(exports.Byte4);
+exports.Byte4Vec = (0, codec_js_1.vector)(exports.Byte4);
+exports.Byte8 = codec_js_1.Codec.from({
+    byteLength: 8,
+    encode: (value) => (0, index_js_1.bytesFrom)(value),
+    decode: (buffer) => (0, index_js_2.hexFrom)(buffer),
+});
+exports.Byte8Opt = (0, codec_js_1.option)(exports.Byte8);
+exports.Byte8Vec = (0, codec_js_1.vector)(exports.Byte8);
+exports.Byte16 = codec_js_1.Codec.from({
+    byteLength: 16,
+    encode: (value) => (0, index_js_1.bytesFrom)(value),
+    decode: (buffer) => (0, index_js_2.hexFrom)(buffer),
+});
+exports.Byte16Opt = (0, codec_js_1.option)(exports.Byte16);
+exports.Byte16Vec = (0, codec_js_1.vector)(exports.Byte16);
 exports.Byte32 = codec_js_1.Codec.from({
     byteLength: 32,
     encode: (value) => (0, index_js_1.bytesFrom)(value),

package/dist.commonjs/num/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/num/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAA0B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,GAAG,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,GAAG,CAS7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,GAAG,CAS7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAUzC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAE1C;AAED;;;;;;;;;;;;GAYG;AAEH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAE9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAEhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAOhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAEhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAElD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/num/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAA0B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,GAAG,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,GAAG,CAS7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,GAAG,CAS7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAczC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAE1C;AAED;;;;;;;;;;;;GAYG;AAEH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAE9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAEhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAOhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAEhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAQlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAElD"}

package/dist.commonjs/num/index.js

@@ -76,7 +76,11 @@ function numFrom(val) {
     if (typeof val === "string" || typeof val === "number") {
         return BigInt(val);
     }
-    return BigInt((0, index_js_2.hexFrom)(val));
+    const hex = (0, index_js_2.hexFrom)(val);
+    if (hex === "0x") {
+        return BigInt(0);
+    }
+    return BigInt(hex);
 }
 /**
  * Converts a NumLike value to a hexadecimal string.
@@ -173,7 +177,11 @@ function numFromBytes(val) {
  * ```
  */
 function numLeFromBytes(val) {
-    return numBeFromBytes((0, index_js_1.bytesFrom)(val).reverse());
+    // reverse() modifies the original array
+    // so we use the map to copy it to avoid this
+    return numBeFromBytes((0, index_js_1.bytesFrom)(val)
+        .map((v) => v)
+        .reverse());
 }
 /**
  * Converts a byte array to a Num (bigint) assuming big-endian order.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckb-ccc/core",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Core of CCC - CKBer's Codebase",
   "author": "Hanssen0 <hanssen0@hanssen0.com>",
   "license": "MIT",

package/src/advancedBarrel.ts

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

package/src/barrel.ts

@@ -5,6 +5,7 @@ export * from "./client/index.js";
 export * from "./fixedPoint/index.js";
 export * from "./hasher/index.js";
 export * from "./hex/index.js";
+export * from "./jsonRpc/index.js";
 export * from "./keystore/index.js";
 export * from "./molecule/index.js";
 export * from "./num/index.js";

package/src/ckb/script.ts

@@ -211,3 +211,4 @@ export class Script extends mol.Entity.Base<ScriptLike, Script>() {
 }
 
 export const ScriptOpt = mol.option(Script);
+export const ScriptVec = mol.vector(Script);

package/src/ckb/transaction.ts

@@ -1487,8 +1487,13 @@ export class Transaction extends mol.Entity.Base<
     return addedCount;
   }
 
-  async completeInputsByUdt(from: Signer, type: ScriptLike): Promise<number> {
-    const exceptedBalance = this.getOutputsUdtBalance(type);
+  async completeInputsByUdt(
+    from: Signer,
+    type: ScriptLike,
+    balanceTweak?: NumLike,
+  ): Promise<number> {
+    const exceptedBalance =
+      this.getOutputsUdtBalance(type) + numFrom(balanceTweak ?? 0);
     const inputsBalance = await this.getInputsUdtBalance(from.client, type);
     if (inputsBalance >= exceptedBalance) {
       return 0;
@@ -1517,6 +1522,51 @@ export class Transaction extends mol.Entity.Base<
     );
   }
 
+  async completeInputsAddOne(
+    from: Signer,
+    filter?: ClientCollectableSearchKeyFilterLike,
+  ): Promise<number> {
+    for await (const cell of from.findCells(
+      filter ?? {
+        scriptLenRange: [0, 1],
+        outputDataLenRange: [0, 1],
+      },
+      true,
+      undefined,
+      1,
+    )) {
+      if (
+        this.inputs.some(({ previousOutput }) =>
+          previousOutput.eq(cell.outPoint),
+        )
+      ) {
+        continue;
+      }
+
+      this.inputs.push(
+        CellInput.from({
+          previousOutput: cell.outPoint,
+          outputData: cell.outputData,
+          cellOutput: cell.cellOutput,
+        }),
+      );
+      return 1;
+    }
+
+    throw new Error(`Insufficient CKB, need at least one new cell`);
+  }
+
+  async completeInputsAtLeastOne(
+    from: Signer,
+    filter?: ClientCollectableSearchKeyFilterLike,
+  ): Promise<number> {
+    if (this.inputs.length > 0) {
+      return 0;
+    }
+
+    return this.completeInputsAddOne(from, filter);
+  }
+
   estimateFee(feeRate: NumLike): Num {
     const txSize = this.toBytes().length + 4;
     return (numFrom(txSize) * numFrom(feeRate) + numFrom(1000)) / numFrom(1000);

package/src/client/advanced.ts

@@ -3,4 +3,3 @@ export * from "./clientPublicMainnet.advanced.js";
 export * from "./clientPublicTestnet.advanced.js";
 export * from "./clientTypes.advanced.js";
 export * from "./jsonRpc/advanced.js";
-export * from "./transports/advanced.js";

package/src/client/clientPublicMainnet.ts

@@ -1,22 +1,16 @@
 import WebSocket from "isomorphic-ws";
-import { ClientCache } from "./cache/index.js";
 import { MAINNET_SCRIPTS } from "./clientPublicMainnet.advanced.js";
 import { KnownScript, ScriptInfo, ScriptInfoLike } from "./clientTypes.js";
-import { ClientJsonRpc } from "./jsonRpc/index.js";
-import { Transport } from "./transports/advanced.js";
+import { ClientJsonRpc, ClientJsonRpcConfig } from "./jsonRpc/index.js";
 
 /**
  * @public
  */
 export class ClientPublicMainnet extends ClientJsonRpc {
   constructor(
-    private readonly config?: {
+    private readonly config?: ClientJsonRpcConfig & {
       url?: string;
-      timeout?: number;
-      maxConcurrent?: number;
-      transport?: Transport;
       scripts?: Record<KnownScript, ScriptInfoLike | undefined>;
-      cache?: ClientCache;
     },
   ) {
     super(

package/src/client/clientPublicTestnet.ts

@@ -1,22 +1,16 @@
 import WebSocket from "isomorphic-ws";
-import { ClientCache } from "./cache/index.js";
 import { TESTNET_SCRIPTS } from "./clientPublicTestnet.advanced.js";
 import { KnownScript, ScriptInfo, ScriptInfoLike } from "./clientTypes.js";
-import { ClientJsonRpc } from "./jsonRpc/index.js";
-import { Transport } from "./transports/advanced.js";
+import { ClientJsonRpc, ClientJsonRpcConfig } from "./jsonRpc/index.js";
 
 /**
  * @public
  */
 export class ClientPublicTestnet extends ClientJsonRpc {
   constructor(
-    private readonly config?: {
+    private readonly config?: ClientJsonRpcConfig & {
       url?: string;
-      timeout?: number;
-      maxConcurrent?: number;
-      transport?: Transport;
       scripts?: Record<KnownScript, ScriptInfoLike | undefined>;
-      cache?: ClientCache;
     },
   ) {
     super(

package/src/client/jsonRpc/client.ts

@@ -0,0 +1,395 @@
+import {
+  Cell,
+  OutPoint,
+  OutPointLike,
+  TransactionLike,
+} from "../../ckb/index.js";
+import { Hex, HexLike, hexFrom } from "../../hex/index.js";
+import {
+  RequestorJsonRpc,
+  RequestorJsonRpcConfig,
+} from "../../jsonRpc/requestor.js";
+import { Num, NumLike, numFrom, numToHex } from "../../num/index.js";
+import { apply } from "../../utils/index.js";
+import { ClientCache } from "../cache/index.js";
+import { Client } from "../client.js";
+import {
+  ClientFindCellsResponse,
+  ClientIndexerSearchKeyLike,
+  ClientTransactionResponse,
+  ErrorClientBase,
+  ErrorClientBaseLike,
+  ErrorClientDuplicatedTransaction,
+  ErrorClientRBFRejected,
+  ErrorClientResolveUnknown,
+  ErrorClientVerification,
+  OutputsValidator,
+} from "../clientTypes.js";
+import {
+  JsonRpcBlock,
+  JsonRpcBlockHeader,
+  JsonRpcCellOutput,
+  JsonRpcTransformers,
+} from "./advanced.js";
+
+const ERROR_PARSERS: [
+  string,
+  (error: ErrorClientBaseLike, match: RegExpMatchArray) => ErrorClientBase,
+][] = [
+  [
+    "Resolve\\(Unknown\\(OutPoint\\((0x.*)\\)\\)\\)",
+    (error, match) =>
+      new ErrorClientResolveUnknown(error, OutPoint.fromBytes(match[1])),
+  ],
+  [
+    "Verification\\(Error { kind: Script, inner: TransactionScriptError { source: (Inputs|Outputs)\\[([0-9]*)\\].(Lock|Type), cause: ValidationFailure: see error code (-?[0-9])* on page https://nervosnetwork\\.github\\.io/ckb-script-error-codes/by-(type|data)-hash/(.*)\\.html",
+    (error, match) =>
+      new ErrorClientVerification(
+        error,
+        match[3] === "Lock"
+          ? "lock"
+          : match[1] === "Inputs"
+            ? "inputType"
+            : "outputType",
+        match[2],
+        Number(match[4]),
+        match[5] === "data" ? "data" : "type",
+        match[6],
+      ),
+  ],
+  [
+    "Duplicated\\(Byte32\\((0x.*)\\)\\)",
+    (error, match) => new ErrorClientDuplicatedTransaction(error, match[1]),
+  ],
+  [
+    'RBFRejected\\("Tx\'s current fee is ([0-9]*), expect it to >= ([0-9]*) to replace old txs"\\)',
+    (error, match) => new ErrorClientRBFRejected(error, match[1], match[2]),
+  ],
+];
+
+export type ClientJsonRpcConfig = RequestorJsonRpcConfig & {
+  cache?: ClientCache;
+  requestor?: RequestorJsonRpc;
+};
+
+/**
+ * An abstract class implementing JSON-RPC client functionality for a specific URL and timeout.
+ * Provides methods for sending transactions and building JSON-RPC payloads.
+ */
+export abstract class ClientJsonRpc extends Client {
+  public readonly requestor: RequestorJsonRpc;
+
+  /**
+   * Creates an instance of ClientJsonRpc.
+   *
+   * @param url_ - The URL of the JSON-RPC server.
+   * @param timeout - The timeout for requests in milliseconds
+   */
+
+  constructor(url_: string, config?: ClientJsonRpcConfig) {
+    super(config);
+
+    this.requestor =
+      config?.requestor ??
+      new RequestorJsonRpc(url_, config, (errAny) => {
+        if (
+          typeof errAny !== "object" ||
+          errAny === null ||
+          !("data" in errAny) ||
+          typeof errAny.data !== "string"
+        ) {
+          throw errAny;
+        }
+        const err = errAny as ErrorClientBaseLike;
+
+        for (const [regexp, builder] of ERROR_PARSERS) {
+          const match = err.data.match(regexp);
+          if (match) {
+            throw builder(err, match);
+          }
+        }
+
+        throw new ErrorClientBase(err);
+      });
+  }
+
+  /**
+   * Returns the URL of the JSON-RPC server.
+   *
+   * @returns The URL of the JSON-RPC server.
+   */
+  get url(): string {
+    return this.requestor.url;
+  }
+
+  /**
+   * Get fee rate statistics
+   *
+   * @returns Fee rate statistics
+   */
+
+  getFeeRateStatistics = this.buildSender(
+    "get_fee_rate_statistics",
+    [(n: NumLike) => apply(numFrom, n)],
+    ({ mean, median }: { mean: NumLike; median: NumLike }) => ({
+      mean: numFrom(mean),
+      median: numFrom(median),
+    }),
+  ) as Client["getFeeRateStatistics"];
+
+  /**
+   * Get tip block number
+   *
+   * @returns Tip block number
+   */
+
+  getTip = this.buildSender(
+    "get_tip_block_number",
+    [],
+    numFrom,
+  ) as () => Promise<Num>;
+
+  /**
+   * Get tip block header
+   *
+   * @param verbosity - result format which allows 0 and 1. (Optional, the default is 1.)
+   * @returns BlockHeader
+   */
+  getTipHeader = this.buildSender(
+    "get_tip_header",
+    [],
+    (b: JsonRpcBlockHeader) => apply(JsonRpcTransformers.blockHeaderTo, b),
+  ) as Client["getTipHeader"];
+
+  /**
+   * Get block by block number
+   *
+   * @param blockNumber - The block number.
+   * @param verbosity - result format which allows 0 and 2. (Optional, the default is 2.)
+   * @param withCycles - whether the return cycles of block transactions. (Optional, default false.)
+   * @returns Block
+   */
+  getBlockByNumber = this.buildSender(
+    "get_block_by_number",
+    [(v: NumLike) => numToHex(numFrom(v))],
+    (b: JsonRpcBlock) => apply(JsonRpcTransformers.blockTo, b),
+  ) as Client["getBlockByNumber"];
+
+  /**
+   * Get block by block hash
+   *
+   * @param blockHash - The block hash.
+   * @param verbosity - result format which allows 0 and 2. (Optional, the default is 2.)
+   * @param withCycles - whether the return cycles of block transactions. (Optional, default false.)
+   * @returns Block
+   */
+  getBlockByHash = this.buildSender("get_block", [hexFrom], (b: JsonRpcBlock) =>
+    apply(JsonRpcTransformers.blockTo, b),
+  ) as Client["getBlockByHash"];
+
+  /**
+   * Get header by block number
+   *
+   * @param blockNumber - The block number.
+   * @param verbosity - result format which allows 0 and 1. (Optional, the default is 1.)
+   * @returns BlockHeader
+   */
+  getHeaderByNumber = this.buildSender(
+    "get_header_by_number",
+    [(v: NumLike) => numToHex(numFrom(v))],
+    (b: JsonRpcBlockHeader) => apply(JsonRpcTransformers.blockHeaderTo, b),
+  ) as Client["getHeaderByNumber"];
+
+  /**
+   * Get header by block hash
+   *
+   * @param blockHash - The block hash.
+   * @param verbosity - result format which allows 0 and 1. (Optional, the default is 1.)
+   * @returns BlockHeader
+   */
+  getHeaderByHash = this.buildSender(
+    "get_header",
+    [hexFrom],
+    (b: JsonRpcBlockHeader) => apply(JsonRpcTransformers.blockHeaderTo, b),
+  ) as Client["getHeaderByHash"];
+
+  /**
+   * Estimate cycles of a transaction.
+   *
+   * @param transaction - The transaction to estimate.
+   * @returns Consumed cycles
+   */
+  estimateCycles = this.buildSender(
+    "estimate_cycles",
+    [JsonRpcTransformers.transactionFrom],
+    ({ cycles }: { cycles: NumLike }) => numFrom(cycles),
+  ) as Client["estimateCycles"];
+
+  /**
+   * Test a transaction.
+   *
+   * @param transaction - The transaction to test.
+   * @param validator - "passthrough": Disable validation. "well_known_scripts_only": Only accept well known scripts in the transaction.
+   * @returns Consumed cycles
+   */
+
+  sendTransactionDry = this.buildSender(
+    "test_tx_pool_accept",
+    [JsonRpcTransformers.transactionFrom],
+    ({ cycles }: { cycles: NumLike }) => numFrom(cycles),
+  ) as Client["sendTransactionDry"];
+
+  /**
+   * Send a transaction to node.
+   *
+   * @param transaction - The transaction to send.
+   * @param validator - "passthrough": Disable validation. "well_known_scripts_only": Only accept well known scripts in the transaction.
+   * @returns Transaction hash.
+   */
+
+  sendTransactionNoCache = this.buildSender(
+    "send_transaction",
+    [JsonRpcTransformers.transactionFrom],
+    hexFrom,
+  ) as (
+    transaction: TransactionLike,
+    validator?: OutputsValidator | undefined,
+  ) => Promise<Hex>;
+
+  /**
+   * Get a transaction from node.
+   *
+   * @param txHash - The hash of the transaction.
+   * @returns The transaction with status.
+   */
+
+  getTransactionNoCache = this.buildSender(
+    "get_transaction",
+    [hexFrom],
+    JsonRpcTransformers.transactionResponseTo,
+  ) as (txHash: HexLike) => Promise<ClientTransactionResponse | undefined>;
+
+  /**
+   * Get a live cell from node.
+   *
+   * @param outPoint - The out point of the cell.
+   * @param withData - Include data in the response.
+   * @param includeTxPool - Include cells in the tx pool.
+   * @returns The cell
+   */
+  getCellLiveNoCache(
+    outPoint: OutPointLike,
+    withData?: boolean | null,
+    includeTxPool?: boolean | null,
+  ) {
+    return this.buildSender(
+      "get_live_cell",
+      [JsonRpcTransformers.outPointFrom],
+      ({
+        cell,
+      }: {
+        cell?: {
+          output: JsonRpcCellOutput;
+          data?: { content: HexLike; hash: HexLike };
+        };
+      }) =>
+        apply(
+          ({
+            output,
+            data,
+          }: {
+            output: JsonRpcCellOutput;
+            data?: { content: HexLike; hash: HexLike };
+          }) =>
+            Cell.from({
+              cellOutput: JsonRpcTransformers.cellOutputTo(output),
+              outputData: data?.content ?? "0x",
+              outPoint,
+            }),
+          cell,
+        ),
+    )(outPoint, withData ?? true, includeTxPool) as Promise<Cell | undefined>;
+  }
+
+  /**
+   * find cells from node.
+   *
+   * @param key - The search key of cells.
+   * @param order - The order of cells.
+   * @param limit - The max return size of cells.
+   * @param after - Pagination parameter.
+   * @returns The found cells.
+   */
+
+  findCellsPagedNoCache = this.buildSender(
+    "get_cells",
+    [
+      JsonRpcTransformers.indexerSearchKeyFrom,
+      (order?: "asc" | "desc") => order ?? "asc",
+      (limit?: NumLike) => numToHex(limit ?? 10),
+    ],
+    JsonRpcTransformers.findCellsResponseTo,
+  ) as (
+    key: ClientIndexerSearchKeyLike,
+    order?: "asc" | "desc",
+    limit?: NumLike,
+    after?: string,
+  ) => Promise<ClientFindCellsResponse>;
+
+  /**
+   * find transactions from node.
+   *
+   * @param key - The search key of transactions.
+   * @param order - The order of transactions.
+   * @param limit - The max return size of transactions.
+   * @param after - Pagination parameter.
+   * @returns The found transactions.
+   */
+
+  findTransactionsPaged = this.buildSender(
+    "get_transactions",
+    [
+      JsonRpcTransformers.indexerSearchKeyTransactionFrom,
+      (order?: "asc" | "desc") => order ?? "asc",
+      (limit?: NumLike) => numToHex(limit ?? 10),
+    ],
+    JsonRpcTransformers.findTransactionsResponseTo,
+  ) as Client["findTransactionsPaged"];
+
+  /**
+   * get cells capacity from node.
+   *
+   * @param key - The search key of cells.
+   * @returns The sum of cells capacity.
+   */
+
+  getCellsCapacity = this.buildSender(
+    "get_cells_capacity",
+    [JsonRpcTransformers.indexerSearchKeyFrom],
+    ({ capacity }: { capacity: NumLike }) => numFrom(capacity),
+  ) as (key: ClientIndexerSearchKeyLike) => Promise<Num>;
+
+  /**
+   * Builds a sender function for a JSON-RPC method.
+   *
+   * @param rpcMethod - The JSON-RPC method.
+   * @param inTransformers - An array of input transformers.
+   * @param outTransformer - An output transformer function.
+   * @returns A function that sends a JSON-RPC request with the given method and transformed parameters.
+   */
+
+  buildSender(
+    rpcMethod: Parameters<RequestorJsonRpc["request"]>[0],
+    inTransformers?: Parameters<RequestorJsonRpc["request"]>[2],
+    outTransformer?: Parameters<RequestorJsonRpc["request"]>[3],
+  ): (...req: unknown[]) => Promise<unknown> {
+    return async (...req: unknown[]) => {
+      return this.requestor.request(
+        rpcMethod,
+        req,
+        inTransformers,
+        outTransformer,
+      );
+    };
+  }
+}