@did-btcr2/bitcoin 0.3.3 → 0.4.0

package/dist/types/client/rpc/index.d.ts

@@ -1,293 +1,145 @@
-import { BitcoinRpcClientConfig, BlockResponse, ChainInfo, CreateRawTxInputs, CreateRawTxOutputs, DerivedAddresses, GetBlockParams, ListTransactionsParams, ListTransactionsResult, RawTransactionResponse, RawTransactionV2, RpcClientConfig, SignedRawTx, UnspentTxInfo, VerbosityLevel, WalletTransaction } from '../../types.js';
+import { BlockResponse, ChainInfo, CreateRawTxInputs, CreateRawTxOutputs, DerivedAddresses, GetBlockParams, ListTransactionsParams, ListTransactionsResult, RawTransactionResponse, RawTransactionV2, RpcConfig, SignedRawTx, UnspentTxInfo, VerbosityLevel, WalletTransaction } from '../../types.js';
+import { HttpExecutor } from '../http.js';
 import { BitcoinRpcClient } from './interface.js';
 import { JsonRpcTransport } from './json-rpc.js';
 /**
- * Class representing a Bitcoin Core RPC client.
- * @class BitcoinCoreRpcClient
- * @type {BitcoinCoreRpcClient}
+ * Maps Bitcoin Core JSON-RPC method names to their parameter and return types.
+ * Used by {@link BitcoinCoreRpcClient.executeRpc} for compile-time safety.
+ */
+export interface RpcMethodMap {
+    getbestblockhash: {
+        params: [];
+        result: string;
+    };
+    getblock: {
+        params: [string, number?];
+        result: BlockResponse;
+    };
+    getblockchaininfo: {
+        params: [];
+        result: ChainInfo;
+    };
+    getblockcount: {
+        params: [];
+        result: number;
+    };
+    getblockhash: {
+        params: [number];
+        result: string;
+    };
+    getbalance: {
+        params: [];
+        result: number;
+    };
+    getnewaddress: {
+        params: [string?, string?];
+        result: string;
+    };
+    gettransaction: {
+        params: [string, boolean?];
+        result: WalletTransaction;
+    };
+    getrawtransaction: {
+        params: [string, number?, string?];
+        result: RawTransactionResponse;
+    };
+    createrawtransaction: {
+        params: [CreateRawTxInputs[], CreateRawTxOutputs[], number?, boolean?];
+        result: string;
+    };
+    signrawtransactionwithwallet: {
+        params: [string];
+        result: SignedRawTx;
+    };
+    sendrawtransaction: {
+        params: [string, (number | string)?, (number | string)?];
+        result: string;
+    };
+    listtransactions: {
+        params: [string?, number?, number?, boolean?];
+        result: ListTransactionsResult;
+    };
+    listunspent: {
+        params: [number?, number?, string[]?, boolean?];
+        result: UnspentTxInfo[];
+    };
+    sendtoaddress: {
+        params: [string, number];
+        result: string;
+    };
+    signmessage: {
+        params: [string, string];
+        result: string;
+    };
+    verifymessage: {
+        params: [string, string, string];
+        result: boolean;
+    };
+    deriveaddresses: {
+        params: [string, number[]?];
+        result: DerivedAddresses[];
+    };
+}
+/** Method names that have typed definitions in {@link RpcMethodMap}. */
+export type TypedRpcMethod = keyof RpcMethodMap;
+/**
+ * Bitcoin Core RPC client.
  * @implements {BitcoinRpcClient}
  */
 export declare class BitcoinCoreRpcClient implements BitcoinRpcClient {
     #private;
-    /**
-     * Constructs a new {@link BitcoinCoreRpcClient} instance from a new {@link RpcClient | RpcClient}.
-     * @param {RpcClientConfig} config The bitcoin-core client instance.
-     * @example
-     * ```
-     *  import BitcoinRpcClient from '@did-btcr2/method';
-     *  const bob = BitcoinRpcClient.connect(); // To use default polar config, pass no args. Polar must run locally.
-     * ```
-     */
-    constructor(config: RpcClientConfig);
-    /**
-     * Get the config for the current BitcoinRpcClient object.
-     * @returns {BitcoinRpcClient} The encapsulated {@link BitcoinRpcClient} object.
-     * @example
-     * ```
-     *  import BitcoinRpcClient from '@did-btcr2/method';
-     *  const alice = BitcoinRpcClient.connect();
-     *  const config = alice.config;
-     * ```
-     */
-    get config(): BitcoinRpcClientConfig;
-    /**
-     * Get the client for the current BitcoinRpcClient object.
-     * @returns {RpcClient} The encapsulated {@link RpcClient} object.
-     * @example
-     * ```
-     * const alice = BitcoinRpcClient.connect();
-     * const config = alice.client;
-     * ```
-     */
+    constructor(config: RpcConfig, executor?: HttpExecutor);
+    get config(): RpcConfig;
     get client(): JsonRpcTransport;
     /**
-     * Static method initializes a static instance of BitcoinCoreRpcClient with the given configuration.
-     * The RpcClient returned by this method does not have any named methods.
-     * Use this method to create and pass a new RpcClient instance to a BitcoinCoreRpcClient constructor.
-     *
-     * @param {RpcClientConfig} config The configuration object for the client (optional).
-     * @returns {BitcoinCoreRpcClient} A new RpcClient instance.
-     * @example
-     * ```
-     * const options: RpcClientConfig = {
-     *     host: 'http://localhost:18443',
-     *     username: 'alice',
-     *     password: 'alicepass',
-     *     version: '28.1.0',
-     * }
-     * const alice = BitcoinCoreRpcClient.initialize(options); // Client config required
-     * ```
-     */
-    static initialize(config?: RpcClientConfig): BitcoinCoreRpcClient;
-    /**
-     * Static method connects to a bitcoin node running the bitcoin core daemon (bitcoind).
-     * To use default polar config, do not pass a config. See {@link DEFAULT_BITCOIN_NETWORK_CONFIG} for default config.
-     * @required A locally running {@link https://github.com/jamaljsr/polar | Polar Lightning} regtest node.
-     *
-     * @param {?RpcClientConfig} config The configuration object for the client (optional).
-     * @returns A new {@link BitcoinRpcClient} instance.
-     * @example
-     * ```
-     * const alice = BitcoinRpcClient.connect();
-     * ```
-     */
-    static connect(config?: RpcClientConfig): BitcoinCoreRpcClient;
-    /**
-     * Check if the given error is a JSON-RPC error.
-     * @param {unknown} e The error to check.
-     * @returns {boolean} True if the error is a JSON-RPC error, false otherwise.
-     */
-    isJsonRpcError(e: unknown): e is Error & {
-        name: 'RpcError';
-        code?: number;
-    };
-    /**
-     * Executes a JSON-RPC command on the bitcoind node.
-     * @param {MethodNameInLowerCase} method The name of the method to call.
-     * @param {Array<any>} parameters The parameters to pass to the method.
-     * @returns {Promise<T>} A promise resolving to the result of the command.
+     * Executes a typed JSON-RPC command on the bitcoind node.
      */
     private executeRpc;
-    /**
-     *
-     * Map JSON-RPC error codes to HTTP status codes.
-     * @param {number | undefined} code The JSON-RPC error code.
-     * @returns {number} The corresponding HTTP status code.
-     *
-     * | Error type                     | HTTP code           |
-     * | -------------------------------| --------------------|
-     * | Valid JSON-RPC failure         | **400 / 404 / 422** |
-     * | JSON-RPC authentication issues | **401 / 403**       |
-     * | Upstream bitcoind unreachable  | **502**             |
-     * | Upstream timeout               | **504**             |
-     * | Network transient errors       | **503**             |
-     * | Unknown unexpected errors      | **500**             |
-     */
-    private mapRpcCodeToHttp;
-    /**
-     * Handle errors that occur while executing commands.
-     * @param methods An array of {@link BatchOption} objects.
-     * @param error The error that was thrown.
-     * @throws Throws a {@link BitcoinRpcError} with the error message.
-     */
-    private handleError;
     /**
      * Returns the block data associated with a `blockhash` of a valid block.
-     * @param {GetBlockParams} params See {@link GetBlockParams} for details.
-     * @param {?string} params.blockhash The blockhash of the block to query.
-     * @param {?number} params.height The block height of the block to query.
-     * @param {?VerbosityLevel} params.verbosity The verbosity level. See {@link VerbosityLevel}.
-     * @returns {BlockResponse} A promise resolving to a {@link BlockResponse} formatted depending on `verbosity` level.
-     * @throws {BitcoinRpcError} If neither `blockhash` nor `height` is provided.
      */
     getBlock({ blockhash, height, verbosity }: GetBlockParams): Promise<BlockResponse | undefined>;
-    /**
-     * Returns the blockheight of the most-work fully-validated chain. The genesis block has height 0.
-     * @returns {Blockheight} The number of the blockheight with the most-work of the fully-validated chain.
-     */
+    /** Returns the blockheight of the most-work fully-validated chain. */
     getBlockCount(): Promise<number>;
-    /**
-     * Returns the blockhash of the block at the given height in the active chain.
-     */
+    /** Returns the blockhash of the block at the given height. */
     getBlockHash(height: number): Promise<string>;
-    /**
-     * Returns an object containing various blockchain state info.
-     */
+    /** Returns various blockchain state info. */
     getBlockchainInfo(): Promise<ChainInfo>;
-    /**
-     * Sign inputs for raw transaction (serialized, hex-encoded).
-     * The second optional argument (may be null) is an array of previous transaction outputs that
-     * this transaction depends on but may not yet be in the block chain.
-     * Requires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.
-     * @param {string} hexstring The hex-encoded transaction to send.
-     */
+    /** Sign inputs for raw transaction (serialized, hex-encoded). */
     signRawTransaction(hexstring: string): Promise<SignedRawTx>;
-    /**
-     * Submit a raw transaction (serialized, hex-encoded) to local node and network.
-     *
-     * The transaction will be sent unconditionally to all peers, so using sendrawtransaction
-     * for manual rebroadcast may degrade privacy by leaking the transaction's origin, as
-     * nodes will normally not rebroadcast non-wallet transactions already in their mempool.
-     *
-     * @param {string} hexstring The hex-encoded transaction to send.
-     * @param {numbner} [maxfeerate] If not passed, default is 0.10.
-     * @returns {Promise<string>} A promise resolving to the transaction hash in hex.
-     */
+    /** Submit a raw transaction (serialized, hex-encoded) to local node and network. */
     sendRawTransaction(hexstring: string, maxfeerate?: number | string, maxBurnAmount?: number | string): Promise<string>;
-    /**
-     * Combines calls to `signRawTransaction` and `sendRawTransaction`.
-     * @param {string} params.hexstring The hex-encoded transaction to send.
-     * @returns {Promise<string>} A promise resolving to the transaction hash in hex.
-     */
+    /** Signs and sends a raw transaction. */
     signAndSendRawTransaction(hexstring: string): Promise<string>;
-    /**
-     * Combines calls to `createRawTransaction`, `signRawTransaction` and `sendRawTransaction`.
-     * @param {CreateRawTxInputs[]} inputs The inputs to the transaction (required).
-     * @param {CreateRawTxOutputs[]} outputs The outputs of the transaction (required).
-     * @returns {Promise<string>} A promise resolving to the transaction hash in hex.
-     */
+    /** Creates, signs, and sends a raw transaction. */
     createSignSendRawTransaction(inputs: CreateRawTxInputs[], outputs: CreateRawTxOutputs[]): Promise<string>;
-    /**
-     * Returns up to 'count' most recent transactions skipping the first 'from' transactions for account 'label'.
-     * @param {ListTransactionsParams} params The parameters for the listTransactions command.
-     * @returns {Promise<ListTransactionsResult>} A promise resolving to a {@link ListTransactionsResult} object.
-     */
+    /** Returns up to 'count' most recent transactions. */
     listTransactions(params: ListTransactionsParams): Promise<ListTransactionsResult>;
-    /**
-     * Create a transaction spending the given inputs and creating new outputs.
-     * Outputs can be addresses or data.
-     * Returns hex-encoded raw transaction.
-     * Note that the transaction's inputs are not signed, and
-     * it is not stored in the wallet or transmitted to the network.
-     * @param {TxInForCreateRaw[]} inputs The inputs to the transaction (required).
-     * @param {CreateRawTxOutputs[]} outputs The outputs of the transaction (required).
-     * @param {number} [locktime] The locktime of the transaction (optional).
-     * @param {boolean} [replacable] Whether the transaction is replaceable (optional).
-     * @returns {string} The hex-encoded raw transaction.
-     */
+    /** Create a transaction spending the given inputs and creating new outputs. */
     createRawTransaction(inputs: CreateRawTxInputs[], outputs: CreateRawTxOutputs[], locktime?: number, replacable?: boolean): Promise<string>;
-    /**
-     * Derives one or more addresses corresponding to an output descriptor.
-     * Examples of output descriptors are:
-     *   pkh(<pubkey>)                                     P2PKH outputs for the given pubkey
-     *   wpkh(<pubkey>)                                    Native segwit P2PKH outputs for the given pubkey
-     *   sh(multi(<n>,<pubkey>,<pubkey>,...))              P2SH-multisig outputs for the given threshold and pubkeys
-     *   raw(<hex script>)                                 Outputs whose output script equals the specified hex-encoded bytes
-     *   tr(<pubkey>,multi_a(<n>,<pubkey>,<pubkey>,...))   P2TR-multisig outputs for the given threshold and pubkeys
-     *
-     * In the above, <pubkey> either refers to a fixed public key in hexadecimal notation, or to an xpub/xprv optionally followed by one
-     * or more path elements separated by "/", where "h" represents a hardened child key.
-     *
-     * See {@link https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md | github.com/bitcoin/bitcoin/descriptors.md}
-     * for more information.
-     * @param {string} descriptor The descriptor.
-     * @param {Array<number>} range If descriptor is ranged, must specify end or [begin,end] to derive.
-     * @returns {Array<DerivedAddresses>} a list of derived addresses
-     * @example First three native segwit receive addresses
-     * ```
-     * const bitcoind = BitcoinRpcClient.connect()
-     * const addresses = bitcoind.deriveAddresses("wpkh([d34db33f/84h/0h/0h]xpub6DJ2dN.../0/*)#cjjspncu", [0,2])
-     * ```
-     */
+    /** Derives one or more addresses corresponding to an output descriptor. */
     deriveAddresses(descriptor: string, range?: Array<number>): Promise<Array<DerivedAddresses>>;
-    /**
-     * Returns the total available balance. The available balance is what the wallet
-     * considers currently spendable, and is thus affected by options which limit
-     * spendability such as -spendzeroconfchange.
-     * @returns {Promise<number>} A promise resolving to the total available balance in BTC.
-     */
+    /** Returns the total available balance. */
     getBalance(): Promise<number>;
-    /**
-     * Returns a new Bitcoin address for receiving payments. If 'label' is specified,
-     * it is added to the address book so payments received with the address will be associated with 'label'.
-     * The 'address_type' can be one of "legacy", "p2sh-segwit", "bech32", or "bech32m".
-     * @param {string} addressType The address type to use (required, options=["legacy", "p2sh-segwit", "bech32", "bech32m"], default="bech32").
-     * @param {string} [label] The label to associate with the new address (optional).
-     * @returns {Promise<string>} A promise resolving to the new address.
-     */
+    /** Returns a new Bitcoin address for receiving payments. */
     getNewAddress(addressType: string, label?: string): Promise<string>;
-    /**
-     * Returns array of unspent transaction outputs with between minconf and maxconf (inclusive) confirmations.
-     * Optionally filter to only include txouts paid to specified addresses.
-     * @param {Object} params The parameters for the listUnspent command.
-     * @param {number} [params.minconf=0] The minimum number of confirmations an output must have to be included.
-     * @param {number} [params.maxconf=9999999] The maximum number of confirmations an output can have to be included.
-     * @param {string[]} [params.address] Only include outputs paid to these addresses.
-     * @param {boolean} [params.include_unsafe=true] Whether to include outputs that are not safe to spend.
-     * @returns {Promise<UnspentTxInfo[]>} A promise resolving to an array of {@link UnspentTxInfo} objects.
-     */
+    /** Returns array of unspent transaction outputs. */
     listUnspent(params: {
         minconf?: number;
         maxconf?: number;
         address?: string[];
         include_unsafe?: boolean;
     }): Promise<UnspentTxInfo[]>;
-    /**
-     * Send an amount to a given address.
-     * @param {string} address The address to send to.
-     * @param {number} amount The amount to send in BTC.
-     * @returns {Promise<SendToAddressResult>} A promise resolving to the transaction id.
-     */
+    /** Send an amount to a given address. */
     sendToAddress(address: string, amount: number): Promise<RawTransactionV2>;
-    /**
-     * Sign a message with the private key of an address.
-     * @param {string} address The address to sign the message with.
-     * @param {string} message The message to sign.
-     * @returns {Promise<string>} A promise resolving to the signature in base64.
-     */
+    /** Sign a message with the private key of an address. */
     signMessage(address: string, message: string): Promise<string>;
-    /**
-     * Verify a signed message.
-     * @param {string} address The address to verify the message with.
-     * @param {string} signature The signature to verify in base64.
-     * @param {string} message The message to verify.
-     * @returns {Promise<boolean>} A promise resolving to true if the signature is valid, false otherwise.
-     */
+    /** Verify a signed message. */
     verifyMessage(address: string, signature: string, message: string): Promise<boolean>;
-    /**
-     * Get detailed information about in-wallet transaction <txid>.
-     * @param txid: The transaction id. (string, required)
-     * @param {boolean} include_watchonly Whether to include watch-only addresses in balance calculation and details.
-     * @returns {WalletTransaction} A promise resolving to a {@link WalletTransaction} object.
-     */
+    /** Get detailed information about in-wallet transaction. */
     getTransaction(txid: string, include_watchonly?: boolean): Promise<WalletTransaction>;
-    /**
-     * Get detailed information about a transaction.
-     * By default, this call only returns a transaction if it is in the mempool. If -txindex is enabled
-     * and no blockhash argument is passed, it will return the transaction if it is in the mempool or any block.
-     * If a blockhash argument is passed, it will return the transaction if the specified block is available and
-     * the transaction is in that block.
-     * @param {string} txid The transaction id (required).
-     * @param {?VerbosityLevel} verbosity Response format: 0 (hex), 1 (json) or 2 (jsonext).
-     * @param {?string} blockhash The block in which to look for the transaction (optional).
-     * @returns {GetRawTransaction} A promise resolving to data about a transaction in the form specified by verbosity.
-     */
+    /** Get detailed information about a transaction. */
     getRawTransaction(txid: string, verbosity?: VerbosityLevel, blockhash?: string): Promise<RawTransactionResponse>;
-    /**
-     * Get detailed information about multiple transactions. An extension of {@link getRawTransaction}.
-     * @param {Array<string>} txids An array of transaction ids.
-     * @param {?VerbosityLevel} verbosity Response format: 0 (hex), 1 (json) or 2 (jsonext).
-     * @returns {Promise<Array<RawTransactionResponse>>}
-     */
+    /** Get detailed information about multiple transactions using JSON-RPC batching. */
     getRawTransactions(txids: string[], verbosity?: VerbosityLevel): Promise<RawTransactionResponse[]>;
 }

package/dist/types/client/rpc/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/rpc/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/rpc/index.ts"],"names":[],"mappings":"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"}

package/dist/types/client/rpc/interface.d.ts

@@ -1,8 +1,6 @@
 import { BlockResponse, ChainInfo, CreateRawTxInputs, CreateRawTxOutputs, FeeEstimateMode, GetBlockParams, RawTransactionResponse } from '../../types.js';
 /**
- * General interface for a Bitcoin Core RPC client.\
- * @name BitcoinRpcClient
- * @type {BitcoinRpcClient}
+ * General interface for a Bitcoin Core RPC client.
  */
 export interface BitcoinRpcClient {
     /** Creates a raw transaction spending specified inputs to specified outputs. */
@@ -25,4 +23,3 @@ export interface BitcoinRpcClient {
     verifyMessage(address: string, signature: string, message: string): Promise<boolean>;
     signMessage(address: string, message: string): Promise<string>;
 }
-export declare function isBitcoinRpcClient(obj: any): obj is BitcoinRpcClient;

package/dist/types/client/rpc/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/client/rpc/interface.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gFAAgF;IAChF,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3I,8DAA8D;IAC9D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjC,kDAAkD;IAClD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;IAE9F,+CAA+C;IAC/C,iBAAiB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAExC,yDAAyD;IACzD,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,wDAAwD;IACxD,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,6CAA6C;IAC7C,aAAa,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,sBAAsB,CAAC,EAAE,OAAO,EAChC,WAAW,CAAC,EAAE,OAAO,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,iCAAiC;IACjC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,gBAAgB,CAKpE"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/client/rpc/interface.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3I,8DAA8D;IAC9D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjC,kDAAkD;IAClD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;IAE9F,+CAA+C;IAC/C,iBAAiB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAExC,yDAAyD;IACzD,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,wDAAwD;IACxD,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,6CAA6C;IAC7C,aAAa,CACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,sBAAsB,CAAC,EAAE,OAAO,EAChC,WAAW,CAAC,EAAE,OAAO,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,eAAe,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,iCAAiC;IACjC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE"}

package/dist/types/client/rpc/json-rpc.d.ts

@@ -1,24 +1,26 @@
-import { BatchOption, RpcClientConfig } from '../../types.js';
+import { RpcConfig } from '../../types.js';
+import { HttpExecutor } from '../http.js';
+import { JsonRpcProtocol } from './protocol.js';
 export declare class JsonRpcTransport {
-    private url;
-    private authHeader?;
-    private id;
-    constructor(cfg: RpcClientConfig);
     /**
-     * Make a JSON-RPC call or batch of calls to the Bitcoin node.
-     * @param {BatchOption[] | { method: string; parameters?: any[] }} batch A single RPC call or an array of calls to be made.
-     * @returns {Promise<any[] | any>} The result of the RPC call(s).
-     * @example
+     * The sans-I/O protocol layer.  Use this to build {@link HttpRequest}
+     * descriptors without performing any I/O.
      */
-    command(batch: BatchOption[] | {
-        method: string;
-        parameters?: any[];
-    }): Promise<any[] | any>;
+    readonly protocol: JsonRpcProtocol;
+    private readonly execute;
+    constructor(cfg: RpcConfig, executor?: HttpExecutor);
+    /** @internal Expose URL for tests that inspect transport state. */
+    get url(): string;
+    /**
+     * Execute a single JSON-RPC call.
+     */
+    call(method: string, params?: unknown[]): Promise<unknown>;
     /**
-     * Internal method to perform the actual JSON-RPC call.
-     * @param {string} method The RPC method to call.
-     * @param {any[]} params The parameters for the RPC method.
-     * @returns {Promise<any>} The result of the RPC call.
+     * Execute a JSON-RPC batch in a single HTTP request.
+     * Returns results in the same order as the input calls.
      */
-    private call;
+    batch(calls: Array<{
+        method: string;
+        params: unknown[];
+    }>): Promise<unknown[]>;
 }

package/dist/types/client/rpc/json-rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../../../../src/client/rpc/json-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG9D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,EAAE,CAAK;gBAEH,GAAG,EAAE,eAAe;IAmBhC;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC;IAYlG;;;;;OAKG;YACW,IAAI;CA6BnB"}
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../../../../src/client/rpc/json-rpc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,YAAY;IAKnD,mEAAmE;IACnE,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBpE;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAuBrF"}

package/dist/types/client/rpc/protocol.d.ts

@@ -0,0 +1,82 @@
+import { RpcConfig } from '../../types.js';
+import { HttpRequest } from '../http.js';
+/**
+ * Sans-I/O JSON-RPC protocol for Bitcoin Core.
+ *
+ * Builds {@link HttpRequest} descriptors for JSON-RPC method calls and
+ * provides response parsing — without performing any I/O.
+ *
+ * **Security note:** Built requests include an `Authorization` header when
+ * credentials are configured.  Do not log or persist {@link HttpRequest}
+ * objects without redacting the `Authorization` header.
+ *
+ * @example
+ * ```ts
+ * const protocol = new JsonRpcProtocol({
+ *   host: 'http://localhost:18443',
+ *   username: 'user',
+ *   password: 'pass',
+ * });
+ *
+ * // Build a request descriptor (no I/O)
+ * const req = protocol.buildRequest('getblockcount', []);
+ *
+ * // Execute with any HTTP client
+ * const res = await fetch(req.url, req);
+ * const json = await res.json();
+ *
+ * // Parse the JSON-RPC response (throws on errors)
+ * const blockCount = protocol.parseResponse(json, 'getblockcount', []);
+ * ```
+ */
+export declare class JsonRpcProtocol {
+    readonly url: string;
+    /** Whether this protocol instance has credentials configured. */
+    readonly hasAuth: boolean;
+    private readonly _headers;
+    private _id;
+    constructor(cfg: RpcConfig);
+    /**
+     * Build an {@link HttpRequest} for a JSON-RPC method call.
+     */
+    buildRequest(method: string, params: unknown[]): HttpRequest;
+    /**
+     * Build an {@link HttpRequest} for a JSON-RPC batch call.
+     * Sends all calls in a single HTTP request per the JSON-RPC 2.0 spec.
+     */
+    buildBatchRequest(calls: Array<{
+        method: string;
+        params: unknown[];
+    }>): HttpRequest;
+    /**
+     * Parse a JSON-RPC response payload, throwing {@link BitcoinRpcError}
+     * if the response contains an error.
+     */
+    parseResponse(payload: {
+        result?: unknown;
+        error?: {
+            code: number;
+            message: string;
+        };
+    }, method: string): unknown;
+    /**
+     * Parse a JSON-RPC batch response payload.
+     * Returns results in the same order as the original calls.
+     */
+    parseBatchResponse(payloads: Array<{
+        id: number;
+        result?: unknown;
+        error?: {
+            code: number;
+            message: string;
+        };
+    }>, calls: Array<{
+        method: string;
+        params: unknown[];
+    }>): unknown[];
+    /**
+     * Return a copy of the headers with the Authorization value redacted.
+     * Use this for logging or debugging.
+     */
+    redactedHeaders(): Record<string, string>;
+}

package/dist/types/client/rpc/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/client/rpc/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,GAAG,CAAK;gBAEJ,GAAG,EAAE,SAAS;IA2B1B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW;IAU5D;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,GAAG,WAAW;IAenF;;;OAGG;IACH,aAAa,CACX,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EACxE,MAAM,EAAE,MAAM,GACb,OAAO;IAYV;;;OAGG;IACH,kBAAkB,CAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,EAC5F,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,GAClD,OAAO,EAAE;IAoBZ;;;OAGG;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAO1C"}

package/dist/types/constants.d.ts

@@ -4,6 +4,22 @@ export declare const COINBASE_MATURITY_DELAY = 100;
 export declare const DEFAULT_BLOCK_CONFIRMATIONS = 7;
 export declare const TXIN_WITNESS_COINBASE = "0000000000000000000000000000000000000000000000000000000000000000";
 export declare const GENESIS_TX_ID = "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b";
+/**
+ * Default endpoint configuration per Bitcoin network.
+ *
+ * **Regtest RPC:** Credentials are intentionally omitted — callers must
+ * provide `username` and `password` via overrides or explicit config.
+ * This prevents accidentally using hardcoded credentials in non-local
+ * environments.
+ *
+ * @example
+ * ```ts
+ * // Provide credentials explicitly
+ * BitcoinConnection.forNetwork('regtest', {
+ *   rpc: { username: 'polaruser', password: 'polarpass' },
+ * });
+ * ```
+ */
 export declare const DEFAULT_BITCOIN_NETWORK_CONFIG: {
     readonly bitcoin: {
         readonly rpc: undefined;
@@ -37,13 +53,8 @@ export declare const DEFAULT_BITCOIN_NETWORK_CONFIG: {
     };
     readonly regtest: {
         readonly rpc: {
-            readonly network: "regtest";
             readonly host: "http://localhost:18443";
-            readonly port: 18443;
-            readonly username: "polaruser";
-            readonly password: "polarpass";
             readonly allowDefaultWallet: true;
-            readonly version: "28.1.0";
         };
         readonly rest: {
             readonly host: "http://localhost:3000";

package/dist/types/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,qBAAqB,qEAAqE,CAAC;AACxG,eAAO,MAAM,aAAa,qEAAqE,CAAC;AAChG,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCjC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,qBAAqB,qEAAqE,CAAC;AACxG,eAAO,MAAM,aAAa,qEAAqE,CAAC;AAEhG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjC,CAAC"}

package/dist/types/errors.d.ts

@@ -1,11 +1,12 @@
+export type RpcErrorType = 'HTTP_ERROR' | 'RPC_ERROR' | 'INVALID_PARAMS_GET_BLOCK' | 'SIGNING_INCOMPLETE' | 'UNKNOWN_ERROR';
 /**
  * Custom Error class for handling Bitcoin RPC errors.
  */
 export declare class BitcoinRpcError extends Error {
-    readonly type: string;
+    readonly type: RpcErrorType;
     readonly code: number;
-    readonly data?: any;
-    constructor(type: string, code: number, message: string, data?: any);
+    readonly data?: unknown;
+    constructor(type: RpcErrorType, code: number, message: string, data?: unknown);
 }
 export declare class BitcoinRestError extends Error {
     readonly data?: any;