@did-btcr2/bitcoin 0.3.4 → 0.5.0

package/dist/cjs/client/http.js

@@ -0,0 +1,9 @@
+/**
+ * Default executor backed by the global `fetch` function.
+ */
+export const defaultHttpExecutor = (req) => fetch(req.url, {
+    method: req.method,
+    headers: req.headers,
+    body: req.body,
+});
+//# sourceMappingURL=http.js.map

package/dist/cjs/client/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/client/http.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiB,CAAC,GAAgB,EAAqB,EAAE,CACvF,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;IACb,MAAM,EAAI,GAAG,CAAC,MAAM;IACpB,OAAO,EAAG,GAAG,CAAC,OAAO;IACrB,IAAI,EAAM,GAAG,CAAC,IAAI;CACnB,CAAC,CAAC"}

package/dist/cjs/client/rest/address.js

@@ -1,28 +1,27 @@
 /**
- * Implements a strongly-typed BitcoinRest to connect to remote bitcoin node via REST API for address-related operations.
- * @class BitcoinAddress
- * @type {BitcoinAddress}
+ * Address-related Esplora REST API operations.
  */
 export class BitcoinAddress {
-    api;
-    constructor(api) {
-        this.api = api;
+    protocol;
+    exec;
+    constructor(protocol, exec) {
+        this.protocol = protocol;
+        this.exec = exec;
     }
     /**
      * Get transaction history for the specified address/scripthash, sorted with newest first.
      * Returns up to 50 mempool transactions plus the first 25 confirmed transactions.
      * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-addressaddresstxs | Esplora GET /address/:address/txs } for details.
      * @param {string} addressOrScripthash The address or scripthash to check.
-     * @returns {Promise<Array<RawTransactionRest>>} A promise resolving to an array of {@link RawTransactionRest} objects.
+     * @returns {Promise<Array<RawTransactionRest>>} Transaction history.
      */
     async getTxs(addressOrScripthash) {
-        return await this.api({ path: `/address/${addressOrScripthash}/txs` });
+        return await this.exec(this.protocol.getAddressTxs(addressOrScripthash));
     }
     /**
-     * Calls getAddressTxs and checks if any funds come back.
-     * Toggle if those funds are confirmed.
+     * Checks if an address has any confirmed funded transactions.
      * @param {string} addressOrScripthash The address or scripthash to check.
-     * @returns {Promise<boolean>} True if the address has any funds, false otherwise.
+     * @returns {Promise<boolean>} True if the address has confirmed funds.
      */
     async isFundedAddress(addressOrScripthash) {
         const txs = await this.getConfirmedTxs(addressOrScripthash);
@@ -33,44 +32,37 @@ export class BitcoinAddress {
      * Get unconfirmed transaction history for the specified address/scripthash.
      * Returns up to 50 transactions (no paging).
      * @param {string} addressOrScripthash The address or scripthash to check.
-     * @returns {Promise<Array<RawTransactionRest>>} A promise resolving to an array of {@link RawTransactionRest} objects.
+     * @returns {Promise<Array<RawTransactionRest>>} Unconfirmed transactions.
      */
     async getTxsMempool(addressOrScripthash) {
-        return await this.api({ path: `/address/${addressOrScripthash}/txs/mempool` });
+        return await this.exec(this.protocol.getAddressTxsMempool(addressOrScripthash));
     }
     /**
      * Get information about an address/scripthash.
-     * Available fields: address/scripthash, chain_stats and mempool_stats.
-     * {chain,mempool}_stats each contain an object with tx_count, funded_txo_count, funded_txo_sum, spent_txo_count and spent_txo_sum.
-     * Elements-based chains don't have the {funded,spent}_txo_sum fields.
      * @param {string} addressOrScripthash The address or scripthash to check.
-     * @returns {Promise<AddressInfo>} A promise resolving to an {@link AddressInfo} object.
+     * @returns {Promise<AddressInfo>} Address information.
      */
     async getInfo(addressOrScripthash) {
-        return await this.api({ path: `/address/${addressOrScripthash}` });
+        return await this.exec(this.protocol.getAddressInfo(addressOrScripthash));
     }
     /**
      * Get confirmed transaction history for the specified address/scripthash, sorted with newest first.
-     * Returns 25 transactions per page. More can be requested by specifying the last txid seen by the previous query.
+     * Returns 25 transactions per page.
      * @param {string} addressOrScripthash The address or scripthash to check.
-     * @param lastSeenTxId The last transaction id seen by the previous query (optional).
-     * @returns {Promise<Array<RawTransactionRest>>} A promise resolving to an array of {@link RawTransactionRest} objects.
+     * @param {string} [lastSeenTxId] The last transaction id seen by the previous query for pagination.
+     * @returns {Promise<Array<RawTransactionRest>>} Confirmed transactions.
      */
     async getConfirmedTxs(addressOrScripthash, lastSeenTxId) {
-        return await this.api({
-            path: lastSeenTxId
-                ? `/address/${addressOrScripthash}/txs/chain/${lastSeenTxId}`
-                : `/address/${addressOrScripthash}/txs/chain`
-        });
+        return await this.exec(this.protocol.getAddressTxsChain(addressOrScripthash, lastSeenTxId));
     }
     /**
      * Get the list of unspent transaction outputs associated with the address/scripthash.
      * See {@link https://github.com/Blockstream/esplora/blob/master/API.md#get-addressaddressutxo | Esplora GET /address/:address/utxo } for details.
      * @param {string} addressOrScripthash The address or scripthash to check.
-     * @returns {Promise<Array<RawTransactionRest>>} A promise resolving to an array of {@link RawTransactionRest} objects.
+     * @returns {Promise<Array<AddressUtxo>>} Unspent transaction outputs.
      */
     async getUtxos(addressOrScripthash) {
-        return await this.api({ path: `/address/${addressOrScripthash}/utxo` });
+        return await this.exec(this.protocol.getAddressUtxos(addressOrScripthash));
     }
 }
 //# sourceMappingURL=address.js.map

package/dist/cjs/client/rest/address.js.map

@@ -1 +1 @@
-{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../../src/client/rest/address.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACjB,GAAG,CAA8C;IAEzD,YAAY,GAAgD;QAC1D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAC,mBAA2B;QAC7C,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,YAAY,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,eAAe,CAAC,mBAA2B;QACtD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,aAAa,CAAC,mBAA2B;QACpD,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,YAAY,mBAAmB,cAAc,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,OAAO,CAAC,mBAA2B;QAC9C,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,YAAY,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,eAAe,CAAC,mBAA2B,EAAE,YAAqB;QAC7E,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC;YACpB,IAAI,EAAG,YAAY;gBACjB,CAAC,CAAC,YAAY,mBAAmB,cAAc,YAAY,EAAE;gBAC7D,CAAC,CAAC,YAAY,mBAAmB,YAAY;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,QAAQ,CAAC,mBAA2B;QAC/C,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,YAAY,mBAAmB,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../../src/client/rest/address.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,cAAc;IACR,QAAQ,CAAkB;IAC1B,IAAI,CAAqC;IAE1D,YAAY,QAAyB,EAAE,IAAwC;QAC7E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAC,mBAA2B;QAC7C,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe,CAAC,mBAA2B;QACtD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,aAAa,CAAC,mBAA2B;QACpD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAClF,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAAC,mBAA2B;QAC9C,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,eAAe,CAAC,mBAA2B,EAAE,YAAqB;QAC7E,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,QAAQ,CAAC,mBAA2B;QAC/C,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/dist/cjs/client/rest/block.js

@@ -1,50 +1,51 @@
 import { BitcoinRestError } from '../../errors.js';
 /**
- * Implements a strongly-typed BitcoinRest to connect to remote bitcoin node via REST API for block-related operations.
- * @class BitcoinBlock
- * @type {BitcoinBlock}
+ * Block-related Esplora REST API operations.
+ *
+ * Note: The Esplora API always returns the same block format regardless
+ * of any "verbosity" setting (unlike Bitcoin Core RPC).  Use the RPC
+ * client if you need verbosity-controlled block responses.
  */
 export class BitcoinBlock {
-    api;
-    constructor(api) {
-        this.api = api;
+    protocol;
+    exec;
+    constructor(protocol, exec) {
+        this.protocol = protocol;
+        this.exec = exec;
     }
     /**
-     * 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.
+     * @returns {Promise<number>} The current block height.
      */
     async count() {
-        return await this.api({ path: '/blocks/tip/height' });
+        return await this.exec(this.protocol.getBlockTipHeight());
     }
     /**
-     * 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.
-     * @returns {BlockResponse} A promise resolving to a {@link BlockResponse} formatted depending on `verbosity` level.
-     * @throws {BitcoinRpcError} If neither `blockhash` nor `height` is provided.
+     * Returns the Esplora block data for a given blockhash or height.
+     * @param {object} params The block hash or height.
+     * @param {string} [params.blockhash] The blockhash of the block to query.
+     * @param {number} [params.height] The block height of the block to query.
+     * @returns {Promise<EsploraBlock | undefined>} The block data.
+     * @throws {BitcoinRestError} If neither blockhash nor height is provided.
      */
     async get({ blockhash, height }) {
-        // Check if blockhash or height is provided, if neither throw an error
         if (!blockhash && height === undefined) {
-            throw new BitcoinRestError('INVALID_PARAMS_GET_BLOCK: blockhash or height required', { blockhash, height });
+            throw new BitcoinRestError('blockhash or height required', { blockhash, height });
         }
-        // If height is provided, get the blockhash
         blockhash ??= await this.getHash(height);
         if (!blockhash || typeof blockhash !== 'string') {
             return undefined;
         }
-        // Get the block data
-        return await this.api({ path: `/block/${blockhash}` });
+        return await this.exec(this.protocol.getBlock(blockhash));
     }
     /**
      * Get the block hash for a given block height.
      * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-block-heightheight | Esplora GET /block-height/:height } for details.
      * @param {number} height The block height (required).
-     * @returns {Promise<string>} The hash of the block currently at height..
+     * @returns {Promise<string>} The hash of the block at the given height.
      */
     async getHash(height) {
-        return await this.api({ path: `/block-height/${height}` });
+        return await this.exec(this.protocol.getBlockHeight(height));
     }
 }
 //# sourceMappingURL=block.js.map

package/dist/cjs/client/rest/block.js.map

@@ -1 +1 @@
-{"version":3,"file":"block.js","sourceRoot":"","sources":["../../../../src/client/rest/block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACf,GAAG,CAA8C;IAEzD,YAAY,GAAgD;QAC1D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK;QAChB,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAAkB;QACpD,sEAAsE;QACtE,IAAG,CAAC,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,gBAAgB,CAAC,wDAAwD,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9G,CAAC;QAED,2CAA2C;QAC3C,SAAS,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,CAAC;QAC1C,IAAG,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC/C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,qBAAqB;QACrB,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,SAAS,EAAE,EAAE,CAAY,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,OAAO,CAAC,MAAc;QACjC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,iBAAiB,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../../../src/client/rest/block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKnD;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,CAAkB;IAC1B,IAAI,CAAqC;IAE1D,YAAY,QAAyB,EAAE,IAAwC;QAC7E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK;QAChB,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAA2C;QAC7E,IAAI,CAAC,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,gBAAgB,CAAC,8BAA8B,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,SAAS,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAiB,CAAC;IAC5E,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,OAAO,CAAC,MAAc;QACjC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/cjs/client/rest/index.js

@@ -1,107 +1,54 @@
-import { JSONUtils, MethodError, StringUtils } from '@did-btcr2/common';
-import { DEFAULT_BITCOIN_NETWORK_CONFIG } from '../../constants.js';
+import { MethodError } from '@did-btcr2/common';
 import { BitcoinAddress } from './address.js';
 import { BitcoinBlock } from './block.js';
 import { BitcoinTransaction } from './transaction.js';
-import { RestClientConfig } from '../../types.js';
+import { EsploraProtocol } from './protocol.js';
+import { defaultHttpExecutor } from '../http.js';
 /**
- * Implements a strongly-typed BitcoinRestClient to connect to remote bitcoin node via REST API.
- * @class BitcoinRestClient
- * @type {BitcoinRestClient}
+ * Esplora REST API client for Bitcoin.
+ *
+ * Wraps the sans-I/O {@link EsploraProtocol} with an {@link HttpExecutor}
+ * for convenience.  Users who want full control over I/O can access the
+ * protocol layer directly via the {@link protocol} property.
  */
 export class BitcoinRestClient {
-    /**
-     * The encapsulated {@link RestClientConfig} object.
-     * @private
-     * @type {RestClientConfig}
-     */
     _config;
     /**
-     * The api calls related to bitcoin transactions.
-     * @type {BitcoinTransaction}
+     * The sans-I/O protocol layer.  Use this to build {@link HttpRequest}
+     * descriptors without performing any I/O.
      */
+    protocol;
+    executor;
+    /** Transaction-related API calls. */
     transaction;
-    /**
-     * The api calls related to bitcoin blocks.
-     * @type {BitcoinBlock}
-     */
+    /** Block-related API calls. */
     block;
-    /**
-     * The api calls related to bitcoin addresses.
-     * @type {BitcoinAddress}
-     */
+    /** Address-related API calls. */
     address;
-    /**
-     * The API call method that can be used to make requests to the REST API.
-     * @returns {Promise<any>} A promise resolving to the response data.
-     */
-    api = this.call;
-    constructor(config) {
-        this._config = new RestClientConfig(config);
-        this.api = this.call.bind(this);
-        this.transaction = new BitcoinTransaction(this.api);
-        this.block = new BitcoinBlock(this.api);
-        this.address = new BitcoinAddress(this.api);
+    constructor(config, executor) {
+        this._config = config;
+        this.protocol = new EsploraProtocol(config);
+        this.executor = executor ?? defaultHttpExecutor;
+        const exec = this.executeRequest.bind(this);
+        this.transaction = new BitcoinTransaction(this.protocol, exec);
+        this.block = new BitcoinBlock(this.protocol, exec);
+        this.address = new BitcoinAddress(this.protocol, exec);
     }
-    /**
-     * Get the configuration object.
-     * @private
-     */
     get config() {
-        const config = this._config;
-        return config;
+        return this._config;
     }
     /**
-     * Static method connects to a bitcoin node running a esplora REST API.
-     *
-     * @param {RestClientConfig} config The configuration object for the client (optional).
-     * @returns {BitcoinRestClient} A new {@link BitcoinRestClient} instance.
-     * @example
-     * ```
-     * const rest = BitcoinRestClient.connect();
-     * ```
+     * Execute an {@link HttpRequest} built by the protocol layer,
+     * parse the response, and throw on HTTP errors.
      */
-    static connect(config) {
-        return new BitcoinRestClient(config ?? DEFAULT_BITCOIN_NETWORK_CONFIG.regtest.rest);
-    }
-    /**
-     * Make a REST API call to the configured Bitcoin node.
-     * @private
-     * @param {RestApiCallParams} params The parameters for the API call. See {@link RestApiCallParams} for details.
-     * @param {string} [params.path] The path to the API endpoint (required).
-     * @param {string} [params.url] The full URL to the API endpoint (optional).
-     * @param {string} [params.method] The HTTP method to use (default is 'GET').
-     * @param {any} [params.body] The body of the request (optional).
-     * @param {any} [params.headers] Additional headers to include in the request (optional).
-     * @returns {Promise<any>} A promise resolving to the response data.
-     */
-    async call({ path, url, method, body, headers }) {
-        // Construct the URL if not provided
-        url ??= `${StringUtils.replaceEnd(this.config.host, '/')}${path}`;
-        // Set the method to GET if not provided
-        method ??= 'GET';
-        // Construct the request options
-        const requestInit = {
-            method,
-            headers: headers ?? {
-                'Content-Type': 'application/json',
-                ...this.config.headers,
-            }
-        };
-        // If the method is POST or PUT, add the body to the request
-        if (body) {
-            requestInit.body = JSONUtils.isObject(body) ? JSON.stringify(body) : body;
-            requestInit.method = 'POST';
-        }
-        // Make the request
-        const response = await fetch(url, requestInit);
-        // Check if the response is a text/plain response
-        const data = (response.headers.get('Content-Type') ?? 'json') === 'text/plain'
+    async executeRequest(request) {
+        const response = await this.executor(request);
+        const contentType = response.headers.get('Content-Type') ?? '';
+        const data = contentType.includes('text/plain')
             ? await response.text()
             : await response.json();
-        // Check if the response is ok (status in the range 200-299)
         if (!response.ok) {
-            throw new MethodError(`Request to ${url} failed: ${response.status} - ${response.statusText}`, 'FAILED_HTTP_REQUEST', { data, response });
+            throw new MethodError(`Request to ${request.url} failed: ${response.status} - ${response.statusText}`, 'FAILED_HTTP_REQUEST', { data });
         }
         return data;
     }

package/dist/cjs/client/rest/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/client/rest/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/client/rest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAA6B,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACpB,OAAO,CAAa;IAE5B;;;OAGG;IACM,QAAQ,CAAkB;IAElB,QAAQ,CAAe;IAExC,qCAAqC;IAC9B,WAAW,CAAqB;IAEvC,+BAA+B;IACxB,KAAK,CAAe;IAE3B,iCAAiC;IAC1B,OAAO,CAAiB;IAE/B,YAAY,MAAkB,EAAE,QAAuB;QACrD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,mBAAmB,CAAC;QAEhD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc,CAAC,OAAoB;QAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC7C,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE;YACvB,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE1B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,WAAW,CACnB,cAAc,OAAO,CAAC,GAAG,YAAY,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,UAAU,EAAE,EAC/E,qBAAqB,EACrB,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/cjs/client/rest/protocol.js

@@ -0,0 +1,129 @@
+import { StringUtils } from '@did-btcr2/common';
+const HEX64_RE = /^[0-9a-f]{64}$/i;
+/**
+ * Sans-I/O Esplora REST API protocol.
+ *
+ * Every method returns an {@link HttpRequest} descriptor — a plain object
+ * describing *what* to request — without performing any I/O.  The caller
+ * is responsible for executing the request with an HTTP client of their
+ * choice and deserializing the response.
+ *
+ * This mirrors the pattern used by the Rust `esploda` crate where
+ * `Esplora` methods return `http::Request<()>` objects.
+ *
+ * @example
+ * ```ts
+ * const protocol = new EsploraProtocol({ host: 'https://mempool.space/api' });
+ *
+ * // Build a request descriptor (no I/O)
+ * const req = protocol.getTx('abc123...');
+ *
+ * // Execute with any HTTP client
+ * const res = await fetch(req.url, req);
+ * const tx: RawTransactionRest = await res.json();
+ * ```
+ */
+export class EsploraProtocol {
+    baseUrl;
+    defaultHeaders;
+    constructor(config) {
+        this.baseUrl = StringUtils.replaceEnd(config.host, '/');
+        this.defaultHeaders = {
+            'Content-Type': 'application/json',
+            ...config.headers,
+        };
+    }
+    // ── validation ─────────────────────────────────────────────────────
+    static assertHex64(value, label) {
+        if (!HEX64_RE.test(value)) {
+            throw new Error(`Invalid ${label}: expected 64-char hex string`);
+        }
+    }
+    static assertAddress(value) {
+        if (!value || /[/\\.?#]/.test(value)) {
+            throw new Error('Invalid address: contains illegal characters');
+        }
+    }
+    // ── helpers ──────────────────────────────────────────────────────────
+    get(path) {
+        return {
+            url: `${this.baseUrl}${path}`,
+            method: 'GET',
+            headers: { ...this.defaultHeaders },
+        };
+    }
+    post(path, body, headers) {
+        return {
+            url: `${this.baseUrl}${path}`,
+            method: 'POST',
+            headers: headers ?? { ...this.defaultHeaders },
+            body,
+        };
+    }
+    // ── Transaction ──────────────────────────────────────────────────────
+    /** GET /tx/:txid */
+    getTx(txid) {
+        EsploraProtocol.assertHex64(txid, 'txid');
+        return this.get(`/tx/${txid}`);
+    }
+    /** GET /tx/:txid/hex */
+    getTxHex(txid) {
+        EsploraProtocol.assertHex64(txid, 'txid');
+        return this.get(`/tx/${txid}/hex`);
+    }
+    /** GET /tx/:txid/raw */
+    getTxRaw(txid) {
+        EsploraProtocol.assertHex64(txid, 'txid');
+        return this.get(`/tx/${txid}/raw`);
+    }
+    /** POST /tx */
+    postTx(hex) {
+        return this.post('/tx', hex, { 'Content-Type': 'text/plain' });
+    }
+    // ── Block ────────────────────────────────────────────────────────────
+    /** GET /blocks/tip/height */
+    getBlockTipHeight() {
+        return this.get('/blocks/tip/height');
+    }
+    /** GET /block/:blockhash */
+    getBlock(blockhash) {
+        EsploraProtocol.assertHex64(blockhash, 'blockhash');
+        return this.get(`/block/${blockhash}`);
+    }
+    /** GET /block-height/:height */
+    getBlockHeight(height) {
+        return this.get(`/block-height/${height}`);
+    }
+    // ── Address ──────────────────────────────────────────────────────────
+    /** GET /address/:address/txs */
+    getAddressTxs(address) {
+        EsploraProtocol.assertAddress(address);
+        return this.get(`/address/${address}/txs`);
+    }
+    /** GET /address/:address/txs/mempool */
+    getAddressTxsMempool(address) {
+        EsploraProtocol.assertAddress(address);
+        return this.get(`/address/${address}/txs/mempool`);
+    }
+    /** GET /address/:address/txs/chain[/:last_seen_txid] */
+    getAddressTxsChain(address, lastSeenTxId) {
+        EsploraProtocol.assertAddress(address);
+        if (lastSeenTxId)
+            EsploraProtocol.assertHex64(lastSeenTxId, 'lastSeenTxId');
+        const path = lastSeenTxId
+            ? `/address/${address}/txs/chain/${lastSeenTxId}`
+            : `/address/${address}/txs/chain`;
+        return this.get(path);
+    }
+    /** GET /address/:address */
+    getAddressInfo(address) {
+        EsploraProtocol.assertAddress(address);
+        return this.get(`/address/${address}`);
+    }
+    /** GET /address/:address/utxo */
+    getAddressUtxos(address) {
+        EsploraProtocol.assertAddress(address);
+        return this.get(`/address/${address}/utxo`);
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/cjs/client/rest/protocol.js.map

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

package/dist/cjs/client/rest/transaction.js

@@ -1,56 +1,54 @@
 export class BitcoinTransaction {
-    api;
-    constructor(api) {
-        this.api = api;
+    protocol;
+    exec;
+    constructor(protocol, exec) {
+        this.protocol = protocol;
+        this.exec = exec;
     }
     /**
      * Returns the transaction in JSON format.
      * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxid | Esplora GET /tx/:txid } for details.
      * @param {string} txid The transaction id (required).
-     * @returns {GetRawTransaction} A promise resolving to data about a transaction in the form specified by verbosity.
+     * @returns {Promise<RawTransactionRest>} A promise resolving to data about a transaction.
      */
     async get(txid) {
-        return await this.api({ path: `/tx/${txid}` });
+        return await this.exec(this.protocol.getTx(txid));
     }
     /**
-     * Returns the transaction in JSON format.
-     * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxid | Esplora GET /tx/:txid } for details.
+     * Checks if a transaction is confirmed.
      * @param {string} txid The transaction id (required).
-     * @returns {GetRawTransaction} A promise resolving to data about a transaction in the form specified by verbosity.
+     * @returns {Promise<boolean>} True if the transaction is confirmed.
      */
     async isConfirmed(txid) {
         const tx = await this.get(txid);
         return tx.status.confirmed;
     }
     /**
-     * Returns the raw transaction in hex or as binary data.
-     * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxidhex | Esplora GET /tx/:txid/hex } and
-     * {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxidraw | Esplora GET /tx/:txid/raw } for details.
+     * Returns the raw transaction as a hex string.
+     * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxidhex | Esplora GET /tx/:txid/hex } for details.
      * @param {string} txid The transaction id (required).
-     * @returns {Promise<RawTransactionRest | string>} A promise resolving to the raw transaction in the specified format.
+     * @returns {Promise<string>} A promise resolving to the raw transaction hex.
      */
     async getHex(txid) {
-        return await this.api({ path: `/tx/${txid}/hex` });
+        return await this.exec(this.protocol.getTxHex(txid));
     }
     /**
-     * Returns the raw transaction in hex or as binary data.
-     * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxidhex | Esplora GET /tx/:txid/hex } and
-     * {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxidraw | Esplora GET /tx/:txid/raw } for details.
+     * Returns the raw transaction as binary data.
+     * See {@link https://github.com/blockstream/esplora/blob/master/API.md#get-txtxidraw | Esplora GET /tx/:txid/raw } for details.
      * @param {string} txid The transaction id (required).
-     * @returns {Promise<RawTransactionRest | string>} A promise resolving to the raw transaction in the specified format.
+     * @returns {Promise<Bytes>} A promise resolving to the raw transaction bytes.
      */
     async getRaw(txid) {
-        return await this.api({ path: `/tx/${txid}/raw` });
+        return await this.exec(this.protocol.getTxRaw(txid));
     }
     /**
-     * Broadcast a raw transaction to the network. The transaction should be provided as hex in the request body. The txid
-     * will be returned on success.
+     * Broadcast a raw transaction to the network.
      * See {@link https://github.com/blockstream/esplora/blob/master/API.md#post-tx | Esplora POST /tx } for details.
      * @param {string} tx The raw transaction in hex format (required).
      * @returns {Promise<string>} The transaction id of the broadcasted transaction.
      */
     async send(tx) {
-        return await this.api({ path: '/tx', method: 'POST', body: tx, headers: { 'Content-Type': 'text/plain' } });
+        return await this.exec(this.protocol.postTx(tx));
     }
 }
 //# sourceMappingURL=transaction.js.map

package/dist/cjs/client/rest/transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../../src/client/rest/transaction.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,kBAAkB;IACrB,GAAG,CAA8C;IAEzD,YAAY,GAAgD;QAC1D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAAG,CAAC,IAAY;QAC3B,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,WAAW,CAAC,IAAY;QACnC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAC,IAAY;QAC9B,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAC,IAAY;QAC9B,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAAC,EAAU;QAC1B,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IAC9G,CAAC;CACF"}
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../../src/client/rest/transaction.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,kBAAkB;IACZ,QAAQ,CAAkB;IAC1B,IAAI,CAAqC;IAE1D,YAAY,QAAyB,EAAE,IAAwC;QAC7E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAAG,CAAC,IAAY;QAC3B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,WAAW,CAAC,IAAY;QACnC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,MAAM,CAAC,IAAY;QAC9B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,MAAM,CAAC,IAAY;QAC9B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAI,CAAC,EAAU;QAC1B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;CACF"}