@ckb-ccc/core 1.2.3 → 1.3.0

package/dist.commonjs/jsonRpc/requestor.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestorJsonRpc = void 0;
+const advanced_js_1 = require("./transports/advanced.js");
+/**
+ * Applies a transformation function to a value if the transformer is provided.
+ *
+ * @param value - The value to be transformed.
+ * @param transformer - An optional transformation function.
+ * @returns The transformed value if a transformer is provided, otherwise the original value.
+ *
+ * @example
+ * ```typescript
+ * const result = transform(5, (x) => x * 2); // Outputs 10
+ * const resultWithoutTransformer = transform(5); // Outputs 5
+ * ```
+ */
+function transform(value, transformer) {
+    if (transformer) {
+        return transformer(value);
+    }
+    return value;
+}
+class 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_, config, onError) {
+        this.url_ = url_;
+        this.onError = onError;
+        this.concurrent = 0;
+        this.pending = [];
+        this.id = 0;
+        this.maxConcurrent = config?.maxConcurrent;
+        this.transport = config?.transport ?? (0, advanced_js_1.transportFromUri)(url_, config);
+    }
+    /**
+     * Returns the URL of the JSON-RPC server.
+     *
+     * @returns The URL of the JSON-RPC server.
+     */
+    get url() {
+        return this.url_;
+    }
+    /**
+     * request a JSON-RPC method.
+     *
+     * @param rpcMethod - The JSON-RPC method.
+     * @param params - Params for the method.
+     * @param inTransformers - An array of input transformers.
+     * @param outTransformer - An output transformer function.
+     * @returns Method response.
+     */
+    async request(rpcMethod, params, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    inTransformers, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    outTransformer) {
+        const payload = this.buildPayload(rpcMethod, inTransformers
+            ? await Promise.all(params
+                .concat(Array.from(new Array(Math.max(inTransformers.length - params.length, 0))))
+                .map((v, i) => transform(v, inTransformers[i])))
+            : params);
+        try {
+            return await transform(await this.requestPayload(payload), outTransformer);
+        }
+        catch (err) {
+            if (!this.onError) {
+                throw err;
+            }
+            await this.onError(err);
+        }
+    }
+    async requestPayload(payload) {
+        if (this.maxConcurrent !== undefined &&
+            this.concurrent >= this.maxConcurrent) {
+            const pending = new Promise((resolve) => this.pending.push(resolve));
+            await pending;
+        }
+        this.concurrent += 1;
+        const res = (await this.transport.request(payload));
+        this.concurrent -= 1;
+        this.pending.shift()?.();
+        if (res.id !== payload.id) {
+            throw new Error(`Id mismatched, got ${res.id}, expected ${payload.id}`);
+        }
+        if (res.error) {
+            throw res.error;
+        }
+        return res.result;
+    }
+    /**
+     * Builds a JSON-RPC payload for the given method and parameters.
+     *
+     * @param method - The JSON-RPC method name.
+     * @param req - The parameters for the JSON-RPC method.
+     * @returns The JSON-RPC payload.
+     */
+    buildPayload(method, req) {
+        return {
+            id: this.id++,
+            method,
+            params: req,
+            jsonrpc: "2.0",
+        };
+    }
+}
+exports.RequestorJsonRpc = RequestorJsonRpc;

package/dist.commonjs/jsonRpc/transports/advanced.d.ts

@@ -0,0 +1,5 @@
+export * from "./factory.js";
+export * from "./http.js";
+export * from "./transport.js";
+export * from "./webSocket.js";
+//# sourceMappingURL=advanced.d.ts.map

package/dist.commonjs/jsonRpc/transports/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../src/jsonRpc/transports/advanced.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist.commonjs/{client → jsonRpc}/transports/advanced.js

@@ -14,15 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.transportFromUri = transportFromUri;
-const http_js_1 = require("./http.js");
-const webSocket_js_1 = require("./webSocket.js");
+__exportStar(require("./factory.js"), exports);
 __exportStar(require("./http.js"), exports);
 __exportStar(require("./transport.js"), exports);
 __exportStar(require("./webSocket.js"), exports);
-function transportFromUri(uri, config) {
-    if (uri.startsWith("wss://") || uri.startsWith("ws://")) {
-        return new webSocket_js_1.TransportWebSocket(uri, config?.timeout);
-    }
-    return new http_js_1.TransportHttp(uri, config?.timeout);
-}

package/dist.commonjs/{client/transports/advanced.d.ts → jsonRpc/transports/factory.d.ts}

@@ -1,9 +1,6 @@
 import { TransportHttp } from "./http.js";
 import { TransportWebSocket } from "./webSocket.js";
-export * from "./http.js";
-export * from "./transport.js";
-export * from "./webSocket.js";
 export declare function transportFromUri(uri: string, config?: {
     timeout?: number;
 }): TransportHttp | TransportWebSocket;
-//# sourceMappingURL=advanced.d.ts.map
+//# sourceMappingURL=factory.d.ts.map

package/dist.commonjs/jsonRpc/transports/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/jsonRpc/transports/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,sCAM1E"}

package/dist.commonjs/jsonRpc/transports/factory.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transportFromUri = transportFromUri;
+const http_js_1 = require("./http.js");
+const webSocket_js_1 = require("./webSocket.js");
+function transportFromUri(uri, config) {
+    if (uri.startsWith("wss://") || uri.startsWith("ws://")) {
+        return new webSocket_js_1.TransportWebSocket(uri, config?.timeout);
+    }
+    return new http_js_1.TransportHttp(uri, config?.timeout);
+}

package/dist.commonjs/jsonRpc/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/jsonRpc/transports/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D,qBAAa,aAAc,YAAW,SAAS;IAE3C,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,GAAG,EAAE,MAAM,EACX,OAAO,SAAQ;IAG5B,OAAO,CAAC,OAAO,EAAE,cAAc;CAmBtC"}

package/dist.commonjs/jsonRpc/transports/transport.d.ts

@@ -0,0 +1,18 @@
+export type JsonRpcPayload = {
+    id: number;
+    jsonrpc: "2.0";
+    method: string;
+    params: unknown[] | Record<string, unknown>;
+};
+export interface Transport {
+    /**
+     * Sends a JSON-RPC request to the server.
+     *
+     * @param payload - The JSON-RPC payload to send.
+     * @returns The result of the JSON-RPC request.
+     *
+     * @throws Will throw an error if the response ID does not match the request ID, or if the response contains an error.
+     */
+    request(data: JsonRpcPayload): Promise<unknown>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist.commonjs/jsonRpc/transports/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/jsonRpc/transports/transport.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD"}

package/dist.commonjs/jsonRpc/transports/webSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocket.d.ts","sourceRoot":"","sources":["../../../src/jsonRpc/transports/webSocket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D,qBAAa,kBAAmB,YAAW,SAAS;IAahD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAb1B,OAAO,CAAC,OAAO,CAOD;IACd,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAqB;gBAGrB,GAAG,EAAE,MAAM,EACX,OAAO,SAAQ;IAGlC,OAAO,CAAC,IAAI,EAAE,cAAc;CAyF7B"}

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,CAQlD;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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckb-ccc/core",
-  "version": "1.2.3",
+  "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(