@did-btcr2/bitcoin 0.6.0 → 0.8.0

package/dist/esm/client/rpc/protocol.js

@@ -4,7 +4,7 @@ import { toBase64 } from '../utils.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.
+ * 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}

package/dist/esm/connection.js

@@ -1,8 +1,6 @@
-import { MethodError } from '@did-btcr2/common';
 import { BitcoinRestClient } from './client/rest/index.js';
 import { BitcoinCoreRpcClient } from './client/rpc/index.js';
 import { getNetwork } from './network.js';
-import { DEFAULT_BITCOIN_NETWORK_CONFIG } from './constants.js';
 /**
  * Represents a connection to a single Bitcoin network.
  * Holds the REST and optional RPC clients for that network.
@@ -12,13 +10,19 @@ import { DEFAULT_BITCOIN_NETWORK_CONFIG } from './constants.js';
  * executed via the global `fetch` function.  Supply a custom
  * {@link HttpExecutor} to use any HTTP client.
  *
+ * Endpoints are explicit: this transport layer holds no service URLs. Callers
+ * supply the REST host (and optional RPC) themselves, or use the SDK facade
+ * ({@link https://github.com/dcdpr/did-btcr2-js/tree/main/packages/api | @did-btcr2/api}),
+ * which carries per-network convenience defaults.
+ *
  * @example
  * ```ts
- * // Quick setup with defaults (uses fetch)
- * const btc = BitcoinConnection.forNetwork('regtest');
+ * // Explicit endpoint (uses the global fetch executor by default)
+ * const btc = new BitcoinConnection({ network: 'regtest', rest: { host: 'http://localhost:3000' } });
  *
  * // With a custom HTTP executor
- * const btc = BitcoinConnection.forNetwork('testnet4', {
+ * const btc = new BitcoinConnection({
+ *   network: 'testnet4',
  *   rest: { host: 'https://my-mempool/api' },
  *   executor: myCustomExecutor,
  * });
@@ -47,32 +51,6 @@ export class BitcoinConnection {
         this.rpc = options.rpc ? new BitcoinCoreRpcClient(options.rpc, options.executor) : undefined;
         this.data = getNetwork(options.network);
     }
-    /**
-     * Create a connection for a single network with optional REST/RPC endpoint overrides.
-     * Merges overrides on top of defaults from DEFAULT_BITCOIN_NETWORK_CONFIG.
-     * Does not read environment variables.
-     *
-     * @param network The network name (e.g., 'regtest', 'testnet4', 'bitcoin').
-     * @param overrides Optional endpoint and executor overrides.
-     * @returns A BitcoinConnection for the requested network.
-     */
-    static forNetwork(network, overrides) {
-        const defaults = DEFAULT_BITCOIN_NETWORK_CONFIG[network];
-        if (!defaults) {
-            throw new MethodError(`Unknown network '${network}'. Available: bitcoin, testnet3, testnet4, signet, mutinynet, regtest`, 'UNKNOWN_NETWORK', { network });
-        }
-        const restCfg = { ...defaults.rest, ...overrides?.rest };
-        const hasRpc = defaults.rpc !== undefined || overrides?.rpc !== undefined;
-        const rpcCfg = hasRpc
-            ? { ...defaults.rpc, ...overrides?.rpc }
-            : undefined;
-        return new BitcoinConnection({
-            network,
-            rest: restCfg,
-            rpc: rpcCfg,
-            executor: overrides?.executor,
-        });
-    }
     /**
      * Converts Bitcoin (BTC) to satoshis.
      * Uses string-based arithmetic to avoid floating-point precision errors.

package/dist/esm/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAO,iBAAiB;IAC5B,2CAA2C;IAClC,IAAI,CAAc;IAE3B,iCAAiC;IACxB,IAAI,CAAoB;IAEjC,qEAAqE;IAC5D,GAAG,CAAwB;IAEpC,2EAA2E;IAClE,IAAI,CAAa;IAE1B,YAAY,OAAiC;QAC3C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG,GAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9F,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,GAAW;QAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,iDAAiD;QACjD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,IAAI,UAAU,CAAC,aAAa,GAAG,wCAAwC,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACtE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;CACF"}

package/dist/esm/constants.js

@@ -4,49 +4,4 @@ export const COINBASE_MATURITY_DELAY = 100;
 export const DEFAULT_BLOCK_CONFIRMATIONS = 7;
 export const TXIN_WITNESS_COINBASE = '0000000000000000000000000000000000000000000000000000000000000000';
 export 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 const DEFAULT_BITCOIN_NETWORK_CONFIG = {
-    bitcoin: {
-        rpc: undefined,
-        rest: { host: 'https://mempool.space/api' }
-    },
-    testnet3: {
-        rpc: undefined,
-        rest: { host: 'https://mempool.space/testnet/api' }
-    },
-    testnet4: {
-        rpc: undefined,
-        rest: { host: 'https://mempool.space/testnet4/api' }
-    },
-    signet: {
-        rpc: undefined,
-        rest: { host: 'https://mempool.space/signet/api' }
-    },
-    mutinynet: {
-        rpc: undefined,
-        rest: { host: 'https://mutinynet.com/api' }
-    },
-    regtest: {
-        rpc: {
-            host: 'http://localhost:18443',
-            allowDefaultWallet: true,
-        },
-        rest: { host: 'http://localhost:3000' }
-    },
-};
 //# sourceMappingURL=constants.js.map

package/dist/esm/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,kEAAkE,CAAC;AACxG,MAAM,CAAC,MAAM,aAAa,GAAG,kEAAkE,CAAC;AAEhG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,OAAO,EAAG;QACR,GAAG,EAAI,SAAS;QAChB,IAAI,EAAG,EAAE,IAAI,EAAE,2BAA2B,EAAE;KAC7C;IACD,QAAQ,EAAG;QACT,GAAG,EAAI,SAAS;QAChB,IAAI,EAAG,EAAE,IAAI,EAAE,mCAAmC,EAAE;KACrD;IACD,QAAQ,EAAG;QACT,GAAG,EAAI,SAAS;QAChB,IAAI,EAAG,EAAE,IAAI,EAAE,oCAAoC,EAAE;KACtD;IACD,MAAM,EAAI;QACR,GAAG,EAAI,SAAS;QAChB,IAAI,EAAG,EAAE,IAAI,EAAE,kCAAkC,EAAE;KACpD;IACD,SAAS,EAAG;QACV,GAAG,EAAI,SAAS;QAChB,IAAI,EAAG,EAAE,IAAI,EAAE,2BAA2B,EAAE;KAC7C;IACD,OAAO,EAAG;QACR,GAAG,EAAI;YACL,IAAI,EAAiB,wBAAwB;YAC7C,kBAAkB,EAAG,IAAI;SAC1B;QACD,IAAI,EAAG,EAAE,IAAI,EAAE,uBAAuB,EAAE;KACzC;CACO,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,kEAAkE,CAAC;AACxG,MAAM,CAAC,MAAM,aAAa,GAAG,kEAAkE,CAAC"}

package/dist/esm/fee-estimator.js

@@ -0,0 +1,30 @@
+/**
+ * Fee estimator that returns a fixed fee rate regardless of network conditions.
+ *
+ * Suitable for:
+ * - Tests (deterministic outputs)
+ * - Regtest (no real fee market)
+ * - Environments where a fee rate is supplied out-of-band
+ *
+ * For mainnet production use, prefer a dynamic estimator that queries current
+ * network conditions (mempool APIs, Bitcoin Core RPC).
+ */
+export class StaticFeeEstimator {
+    satsPerVbyte;
+    /**
+     * @param satsPerVbyte Fee rate in satoshis per virtual byte. Default: 5 sat/vB.
+     */
+    constructor(satsPerVbyte = 5) {
+        if (satsPerVbyte < 0 || !Number.isFinite(satsPerVbyte)) {
+            throw new Error(`Invalid satsPerVbyte: ${satsPerVbyte}`);
+        }
+        this.satsPerVbyte = satsPerVbyte;
+    }
+    async estimateFee(vsize) {
+        if (vsize < 0 || !Number.isFinite(vsize)) {
+            throw new Error(`Invalid vsize: ${vsize}`);
+        }
+        return BigInt(Math.ceil(vsize * this.satsPerVbyte));
+    }
+}
+//# sourceMappingURL=fee-estimator.js.map

package/dist/esm/fee-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee-estimator.js","sourceRoot":"","sources":["../../src/fee-estimator.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IACpB,YAAY,CAAS;IAE9B;;OAEG;IACH,YAAY,eAAuB,CAAC;QAClC,IAAG,YAAY,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,IAAG,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/esm/index.js

@@ -13,10 +13,12 @@ export { BitcoinTransaction } from './client/rest/transaction.js';
 export { JsonRpcTransport } from './client/rpc/json-rpc.js';
 // Errors
 export { BitcoinRpcError, BitcoinRestError } from './errors.js';
+// Fee estimation
+export { StaticFeeEstimator } from './fee-estimator.js';
 // Helpers
 export { getNetwork } from './network.js';
 export { toBase64, safeText } from './client/utils.js';
 // Constants
-export { DEFAULT_BITCOIN_NETWORK_CONFIG, INITIAL_BLOCK_REWARD, HALVING_INTERVAL, COINBASE_MATURITY_DELAY, DEFAULT_BLOCK_CONFIRMATIONS, TXIN_WITNESS_COINBASE, GENESIS_TX_ID, } from './constants.js';
+export { INITIAL_BLOCK_REWARD, HALVING_INTERVAL, COINBASE_MATURITY_DELAY, DEFAULT_BLOCK_CONFIRMATIONS, TXIN_WITNESS_COINBASE, GENESIS_TX_ID, } from './constants.js';
 export { VerbosityLevel } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAiC,MAAM,iBAAiB,CAAC;AAInF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,2DAA2D;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGhE,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEvD,YAAY;AACZ,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC;AA0CxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAiC,MAAM,iBAAiB,CAAC;AAInF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,2DAA2D;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGhE,iBAAiB;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEvD,YAAY;AACZ,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC;AA0CxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/client/http.d.ts

@@ -1,6 +1,6 @@
 /**
  * HTTP request descriptor. Represents a request that can be executed
- * by any HTTP client — the library never performs I/O itself at the
+ * by any HTTP client - the library never performs I/O itself at the
  * protocol layer.
  */
 export interface HttpRequest {

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

@@ -3,8 +3,8 @@ import type { HttpRequest } from '../http.js';
 /**
  * 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
+ * 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.
  *

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

@@ -4,7 +4,7 @@ import type { 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.
+ * 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}

package/dist/types/connection.d.ts

@@ -22,13 +22,19 @@ export type BitcoinConnectionOptions = {
  * executed via the global `fetch` function.  Supply a custom
  * {@link HttpExecutor} to use any HTTP client.
  *
+ * Endpoints are explicit: this transport layer holds no service URLs. Callers
+ * supply the REST host (and optional RPC) themselves, or use the SDK facade
+ * ({@link https://github.com/dcdpr/did-btcr2-js/tree/main/packages/api | @did-btcr2/api}),
+ * which carries per-network convenience defaults.
+ *
  * @example
  * ```ts
- * // Quick setup with defaults (uses fetch)
- * const btc = BitcoinConnection.forNetwork('regtest');
+ * // Explicit endpoint (uses the global fetch executor by default)
+ * const btc = new BitcoinConnection({ network: 'regtest', rest: { host: 'http://localhost:3000' } });
  *
  * // With a custom HTTP executor
- * const btc = BitcoinConnection.forNetwork('testnet4', {
+ * const btc = new BitcoinConnection({
+ *   network: 'testnet4',
  *   rest: { host: 'https://my-mempool/api' },
  *   executor: myCustomExecutor,
  * });
@@ -52,20 +58,6 @@ export declare class BitcoinConnection {
     /** Bitcoin network params (for address derivation, PSBT signing, etc.). */
     readonly data: BTCNetwork;
     constructor(options: BitcoinConnectionOptions);
-    /**
-     * Create a connection for a single network with optional REST/RPC endpoint overrides.
-     * Merges overrides on top of defaults from DEFAULT_BITCOIN_NETWORK_CONFIG.
-     * Does not read environment variables.
-     *
-     * @param network The network name (e.g., 'regtest', 'testnet4', 'bitcoin').
-     * @param overrides Optional endpoint and executor overrides.
-     * @returns A BitcoinConnection for the requested network.
-     */
-    static forNetwork(network: NetworkName, overrides?: {
-        rest?: Partial<RestConfig>;
-        rpc?: RpcConfig;
-        executor?: HttpExecutor;
-    }): BitcoinConnection;
     /**
      * Converts Bitcoin (BTC) to satoshis.
      * Uses string-based arithmetic to avoid floating-point precision errors.

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

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGrE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,iBAAiB;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAEpC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;gBAEd,OAAO,EAAE,wBAAwB;IAO7C;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAAC,GAAG,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,GACnF,iBAAiB;IA0BpB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUrC;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAQvC"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,iBAAiB;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAEpC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;gBAEd,OAAO,EAAE,wBAAwB;IAO7C;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUrC;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAQvC"}

package/dist/types/constants.d.ts

@@ -4,61 +4,4 @@ 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;
-        readonly rest: {
-            readonly host: "https://mempool.space/api";
-        };
-    };
-    readonly testnet3: {
-        readonly rpc: undefined;
-        readonly rest: {
-            readonly host: "https://mempool.space/testnet/api";
-        };
-    };
-    readonly testnet4: {
-        readonly rpc: undefined;
-        readonly rest: {
-            readonly host: "https://mempool.space/testnet4/api";
-        };
-    };
-    readonly signet: {
-        readonly rpc: undefined;
-        readonly rest: {
-            readonly host: "https://mempool.space/signet/api";
-        };
-    };
-    readonly mutinynet: {
-        readonly rpc: undefined;
-        readonly rest: {
-            readonly host: "https://mutinynet.com/api";
-        };
-    };
-    readonly regtest: {
-        readonly rpc: {
-            readonly host: "http://localhost:18443";
-            readonly allowDefaultWallet: true;
-        };
-        readonly rest: {
-            readonly host: "http://localhost:3000";
-        };
-    };
-};
 //# sourceMappingURL=constants.d.ts.map

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;AAEhG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjC,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"}

package/dist/types/fee-estimator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Estimates the fee (in satoshis) for a transaction of a given virtual size.
+ *
+ * Callers that build Bitcoin transactions (the did:btcr2 beacon broadcast paths,
+ * single-party and aggregated) delegate fee calculation to a `FeeEstimator` so they
+ * can plug in different strategies: static fee rates for tests/regtest, mempool APIs
+ * for mainnet, Bitcoin Core `estimatesmartfee` RPC for full-node setups, etc.
+ *
+ * Implementations return the **total fee in satoshis** for a transaction of the given
+ * virtual size (`vsize`). Callers pass the vsize; the estimator decides the fee rate
+ * and computes the total.
+ */
+export interface FeeEstimator {
+    /**
+     * Estimate the total fee in satoshis for a transaction of the given vsize.
+     * @param vsize Transaction virtual size in vbytes.
+     * @returns Total fee in satoshis.
+     */
+    estimateFee(vsize: number): Promise<bigint>;
+}
+/**
+ * Fee estimator that returns a fixed fee rate regardless of network conditions.
+ *
+ * Suitable for:
+ * - Tests (deterministic outputs)
+ * - Regtest (no real fee market)
+ * - Environments where a fee rate is supplied out-of-band
+ *
+ * For mainnet production use, prefer a dynamic estimator that queries current
+ * network conditions (mempool APIs, Bitcoin Core RPC).
+ */
+export declare class StaticFeeEstimator implements FeeEstimator {
+    readonly satsPerVbyte: number;
+    /**
+     * @param satsPerVbyte Fee rate in satoshis per virtual byte. Default: 5 sat/vB.
+     */
+    constructor(satsPerVbyte?: number);
+    estimateFee(vsize: number): Promise<bigint>;
+}
+//# sourceMappingURL=fee-estimator.d.ts.map

package/dist/types/fee-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee-estimator.d.ts","sourceRoot":"","sources":["../../src/fee-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;gBACS,YAAY,GAAE,MAAU;IAO9B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAMlD"}

package/dist/types/index.d.ts

@@ -13,10 +13,12 @@ export { BitcoinTransaction } from './client/rest/transaction.js';
 export { JsonRpcTransport } from './client/rpc/json-rpc.js';
 export { BitcoinRpcError, BitcoinRestError } from './errors.js';
 export type { RpcErrorType } from './errors.js';
+export { StaticFeeEstimator } from './fee-estimator.js';
+export type { FeeEstimator } from './fee-estimator.js';
 export { getNetwork } from './network.js';
 export type { BTCNetwork } from './network.js';
 export { toBase64, safeText } from './client/utils.js';
-export { DEFAULT_BITCOIN_NETWORK_CONFIG, INITIAL_BLOCK_REWARD, HALVING_INTERVAL, COINBASE_MATURITY_DELAY, DEFAULT_BLOCK_CONFIRMATIONS, TXIN_WITNESS_COINBASE, GENESIS_TX_ID, } from './constants.js';
+export { INITIAL_BLOCK_REWARD, HALVING_INTERVAL, COINBASE_MATURITY_DELAY, DEFAULT_BLOCK_CONFIRMATIONS, TXIN_WITNESS_COINBASE, GENESIS_TX_ID, } from './constants.js';
 export type { NetworkName, RestConfig, EsploraBlock, TransactionStatus, Vin, Vout, ChainStats, MempoolStats, AddressInfo, RawTransactionRest, AddressUtxo, RpcConfig, ChainInfo, GetBlockParams, BlockResponse, BlockV0, BlockV1, BlockV2, BlockV3, RawTransactionResponse, RawTransactionV0, RawTransactionV1, RawTransactionV2, CreateRawTxInputs, CreateRawTxOutputs, SignedRawTx, UnspentTxInfo, WalletTransaction, DerivedAddresses, ListTransactionsParams, ListTransactionsResult, MethodNameInLowerCase, FeeEstimateMode, } from './types.js';
 export { VerbosityLevel } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGnF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAEV,WAAW,EAEX,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,GAAG,EACH,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EAEX,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EACb,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGnF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAEV,WAAW,EAEX,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,GAAG,EACH,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EAEX,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EACb,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@did-btcr2/bitcoin",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "type": "module",
   "description": "Bitcoin Core RPC and Rest Client Implementations in JS/TS. Used by @did-btcr2/method.",
   "main": "./dist/cjs/index.js",
@@ -60,8 +60,8 @@
     "@noble/hashes": "^2.0.1",
     "@noble/secp256k1": "^2.3.0",
     "@scure/btc-signer": "^1.8.1",
-    "@did-btcr2/common": "^9.0.0",
-    "@did-btcr2/keypair": "^0.11.4"
+    "@did-btcr2/common": "^9.1.0",
+    "@did-btcr2/keypair": "^0.13.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.22.0",

package/src/client/http.ts

@@ -1,6 +1,6 @@
 /**
  * HTTP request descriptor. Represents a request that can be executed
- * by any HTTP client — the library never performs I/O itself at the
+ * by any HTTP client - the library never performs I/O itself at the
  * protocol layer.
  */
 export interface HttpRequest {

package/src/client/rest/protocol.ts

@@ -7,8 +7,8 @@ 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
+ * 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.
  *

package/src/client/rpc/protocol.ts

@@ -7,7 +7,7 @@ import { toBase64 } from '../utils.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.
+ * 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}

package/src/connection.ts

@@ -1,11 +1,9 @@
-import { MethodError } from '@did-btcr2/common';
 import type { HttpExecutor } from './client/http.js';
 import { BitcoinRestClient } from './client/rest/index.js';
 import { BitcoinCoreRpcClient } from './client/rpc/index.js';
 import type { BTCNetwork } from './network.js';
 import { getNetwork } from './network.js';
 import type { NetworkName, RestConfig, RpcConfig } from './types.js';
-import { DEFAULT_BITCOIN_NETWORK_CONFIG } from './constants.js';
 
 /**
  * Options for creating a BitcoinConnection.
@@ -27,13 +25,19 @@ export type BitcoinConnectionOptions = {
  * executed via the global `fetch` function.  Supply a custom
  * {@link HttpExecutor} to use any HTTP client.
  *
+ * Endpoints are explicit: this transport layer holds no service URLs. Callers
+ * supply the REST host (and optional RPC) themselves, or use the SDK facade
+ * ({@link https://github.com/dcdpr/did-btcr2-js/tree/main/packages/api | @did-btcr2/api}),
+ * which carries per-network convenience defaults.
+ *
  * @example
  * ```ts
- * // Quick setup with defaults (uses fetch)
- * const btc = BitcoinConnection.forNetwork('regtest');
+ * // Explicit endpoint (uses the global fetch executor by default)
+ * const btc = new BitcoinConnection({ network: 'regtest', rest: { host: 'http://localhost:3000' } });
  *
  * // With a custom HTTP executor
- * const btc = BitcoinConnection.forNetwork('testnet4', {
+ * const btc = new BitcoinConnection({
+ *   network: 'testnet4',
  *   rest: { host: 'https://my-mempool/api' },
  *   executor: myCustomExecutor,
  * });
@@ -67,44 +71,6 @@ export class BitcoinConnection {
     this.data = getNetwork(options.network);
   }
 
-  /**
-   * Create a connection for a single network with optional REST/RPC endpoint overrides.
-   * Merges overrides on top of defaults from DEFAULT_BITCOIN_NETWORK_CONFIG.
-   * Does not read environment variables.
-   *
-   * @param network The network name (e.g., 'regtest', 'testnet4', 'bitcoin').
-   * @param overrides Optional endpoint and executor overrides.
-   * @returns A BitcoinConnection for the requested network.
-   */
-  static forNetwork(
-    network: NetworkName,
-    overrides?: { rest?: Partial<RestConfig>; rpc?: RpcConfig; executor?: HttpExecutor }
-  ): BitcoinConnection {
-    const defaults = DEFAULT_BITCOIN_NETWORK_CONFIG[network];
-
-    if (!defaults) {
-      throw new MethodError(
-        `Unknown network '${network}'. Available: bitcoin, testnet3, testnet4, signet, mutinynet, regtest`,
-        'UNKNOWN_NETWORK',
-        { network }
-      );
-    }
-
-    const restCfg: RestConfig = { ...defaults.rest, ...overrides?.rest };
-
-    const hasRpc = defaults.rpc !== undefined || overrides?.rpc !== undefined;
-    const rpcCfg = hasRpc
-      ? { ...defaults.rpc, ...overrides?.rpc } as RpcConfig
-      : undefined;
-
-    return new BitcoinConnection({
-      network,
-      rest     : restCfg,
-      rpc      : rpcCfg,
-      executor : overrides?.executor,
-    });
-  }
-
   /**
    * Converts Bitcoin (BTC) to satoshis.
    * Uses string-based arithmetic to avoid floating-point precision errors.

package/src/constants.ts

@@ -4,49 +4,3 @@ export const COINBASE_MATURITY_DELAY = 100;
 export const DEFAULT_BLOCK_CONFIRMATIONS = 7;
 export const TXIN_WITNESS_COINBASE = '0000000000000000000000000000000000000000000000000000000000000000';
 export 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 const DEFAULT_BITCOIN_NETWORK_CONFIG = {
-  bitcoin : {
-    rpc  : undefined,
-    rest : { host: 'https://mempool.space/api' }
-  },
-  testnet3 : {
-    rpc  : undefined,
-    rest : { host: 'https://mempool.space/testnet/api' }
-  },
-  testnet4 : {
-    rpc  : undefined,
-    rest : { host: 'https://mempool.space/testnet4/api' }
-  },
-  signet  : {
-    rpc  : undefined,
-    rest : { host: 'https://mempool.space/signet/api' }
-  },
-  mutinynet : {
-    rpc  : undefined,
-    rest : { host: 'https://mutinynet.com/api' }
-  },
-  regtest : {
-    rpc  : {
-      host               : 'http://localhost:18443',
-      allowDefaultWallet : true,
-    },
-    rest : { host: 'http://localhost:3000' }
-  },
-} as const;