@ckb-ccc/core
Version:
Core of CCC - CKBer's Codebase
225 lines (224 loc) • 10.6 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.ClientJsonRpc = void 0;
const index_js_1 = require("../../ckb/index.js");
const index_js_2 = require("../../hex/index.js");
const requestor_js_1 = require("../../jsonRpc/requestor.js");
const index_js_3 = require("../../num/index.js");
const index_js_4 = require("../../utils/index.js");
const client_js_1 = require("../client.js");
const clientTypes_js_1 = require("../clientTypes.js");
const advanced_js_1 = require("./advanced.js");
const ERROR_PARSERS = [
[
"Resolve\\(Unknown\\(OutPoint\\((0x.*)\\)\\)\\)",
(error, match) => new clientTypes_js_1.ErrorClientResolveUnknown(error, index_js_1.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 clientTypes_js_1.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 clientTypes_js_1.ErrorClientDuplicatedTransaction(error, match[1]),
],
[
'RBFRejected\\("Tx\'s current fee is ([0-9]*), expect it to >= ([0-9]*) to replace old txs"\\)',
(error, match) => new clientTypes_js_1.ErrorClientRBFRejected(error, match[1], match[2]),
],
];
/**
* An abstract class implementing JSON-RPC client functionality for a specific URL and timeout.
* Provides methods for sending transactions and building JSON-RPC payloads.
*/
class ClientJsonRpc extends client_js_1.Client {
/**
* 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) {
super(config);
/**
* Get fee rate statistics
*
* @returns Fee rate statistics
*/
this.getFeeRateStatistics = this.buildSender("get_fee_rate_statistics", [(n) => (0, index_js_4.apply)(index_js_3.numFrom, n)], ({ mean, median }) => ({
mean: (0, index_js_3.numFrom)(mean),
median: (0, index_js_3.numFrom)(median),
}));
/**
* Get tip block number
*
* @returns Tip block number
*/
this.getTip = this.buildSender("get_tip_block_number", [], index_js_3.numFrom);
/**
* Get tip block header
*
* @param verbosity - result format which allows 0 and 1. (Optional, the default is 1.)
* @returns BlockHeader
*/
this.getTipHeader = this.buildSender("get_tip_header", [], (b) => (0, index_js_4.apply)(advanced_js_1.JsonRpcTransformers.blockHeaderTo, b));
/**
* 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
*/
this.getBlockByNumberNoCache = this.buildSender("get_block_by_number", [(v) => (0, index_js_3.numToHex)((0, index_js_3.numFrom)(v))], (b) => (0, index_js_4.apply)(advanced_js_1.JsonRpcTransformers.blockTo, b));
/**
* 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
*/
this.getBlockByHashNoCache = this.buildSender("get_block", [index_js_2.hexFrom], (b) => (0, index_js_4.apply)(advanced_js_1.JsonRpcTransformers.blockTo, b));
/**
* 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
*/
this.getHeaderByNumberNoCache = this.buildSender("get_header_by_number", [(v) => (0, index_js_3.numToHex)((0, index_js_3.numFrom)(v))], (b) => (0, index_js_4.apply)(advanced_js_1.JsonRpcTransformers.blockHeaderTo, b));
/**
* 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
*/
this.getHeaderByHashNoCache = this.buildSender("get_header", [index_js_2.hexFrom], (b) => (0, index_js_4.apply)(advanced_js_1.JsonRpcTransformers.blockHeaderTo, b));
/**
* Estimate cycles of a transaction.
*
* @param transaction - The transaction to estimate.
* @returns Consumed cycles
*/
this.estimateCycles = this.buildSender("estimate_cycles", [advanced_js_1.JsonRpcTransformers.transactionFrom], ({ cycles }) => (0, index_js_3.numFrom)(cycles));
/**
* 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
*/
this.sendTransactionDry = this.buildSender("test_tx_pool_accept", [advanced_js_1.JsonRpcTransformers.transactionFrom], ({ cycles }) => (0, index_js_3.numFrom)(cycles));
/**
* 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.
*/
this.sendTransactionNoCache = this.buildSender("send_transaction", [advanced_js_1.JsonRpcTransformers.transactionFrom], index_js_2.hexFrom);
/**
* Get a transaction from node.
*
* @param txHash - The hash of the transaction.
* @returns The transaction with status.
*/
this.getTransactionNoCache = this.buildSender("get_transaction", [index_js_2.hexFrom], advanced_js_1.JsonRpcTransformers.transactionResponseTo);
/**
* 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.
*/
this.findCellsPagedNoCache = this.buildSender("get_cells", [
advanced_js_1.JsonRpcTransformers.indexerSearchKeyFrom,
(order) => order ?? "asc",
(limit) => (0, index_js_3.numToHex)(limit ?? 10),
], advanced_js_1.JsonRpcTransformers.findCellsResponseTo);
/**
* 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.
*/
this.findTransactionsPaged = this.buildSender("get_transactions", [
advanced_js_1.JsonRpcTransformers.indexerSearchKeyTransactionFrom,
(order) => order ?? "asc",
(limit) => (0, index_js_3.numToHex)(limit ?? 10),
], advanced_js_1.JsonRpcTransformers.findTransactionsResponseTo);
/**
* get cells capacity from node.
*
* @param key - The search key of cells.
* @returns The sum of cells capacity.
*/
this.getCellsCapacity = this.buildSender("get_cells_capacity", [advanced_js_1.JsonRpcTransformers.indexerSearchKeyFrom], ({ capacity }) => (0, index_js_3.numFrom)(capacity));
this.requestor =
config?.requestor ??
new requestor_js_1.RequestorJsonRpc(url_, config, (errAny) => {
if (typeof errAny !== "object" ||
errAny === null ||
!("data" in errAny) ||
typeof errAny.data !== "string") {
throw errAny;
}
const err = errAny;
for (const [regexp, builder] of ERROR_PARSERS) {
const match = err.data.match(regexp);
if (match) {
throw builder(err, match);
}
}
throw new clientTypes_js_1.ErrorClientBase(err);
});
}
/**
* Returns the URL of the JSON-RPC server.
*
* @returns The URL of the JSON-RPC server.
*/
get url() {
return this.requestor.url;
}
/**
* 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, withData, includeTxPool) {
return this.buildSender("get_live_cell", [advanced_js_1.JsonRpcTransformers.outPointFrom], ({ cell, }) => (0, index_js_4.apply)(({ output, data, }) => index_js_1.Cell.from({
cellOutput: advanced_js_1.JsonRpcTransformers.cellOutputTo(output),
outputData: data?.content ?? "0x",
outPoint,
}), cell))(outPoint, withData ?? true, includeTxPool);
}
/**
* 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, inTransformers, outTransformer) {
return async (...req) => {
return this.requestor.request(rpcMethod, req, inTransformers, outTransformer);
};
}
}
exports.ClientJsonRpc = ClientJsonRpc;