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 type { NetworkName, RestConfig, RpcConfig } from './types.js';
/**
 * Options for creating a BitcoinConnection.
 */
export type BitcoinConnectionOptions = {
    network: NetworkName;
    rest: RestConfig;
    rpc?: RpcConfig;
    /** Optional HTTP executor for sans-I/O usage. Defaults to global `fetch`. */
    executor?: HttpExecutor;
};
/**
 * Represents a connection to a single Bitcoin network.
 * Holds the REST and optional RPC clients for that network.
 *
 * The underlying clients use a sans-I/O protocol layer that separates
 * request construction from HTTP execution.  By default, requests are
 * 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
 * // 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 = new BitcoinConnection({
 *   network: 'testnet4',
 *   rest: { host: 'https://my-mempool/api' },
 *   executor: myCustomExecutor,
 * });
 *
 * // Direct usage
 * const tx = await btc.rest.transaction.get(txid);
 * const block = await btc.rpc?.getBlock({ height: 100 });
 *
 * // Sans-I/O: build requests without performing I/O
 * const req = btc.rest.protocol.getTx(txid);
 * const res = await myHttpClient.execute(req);
 * ```
 */
export declare class BitcoinConnection {
    /** The network this connection targets. */
    readonly name: NetworkName;
    /** REST client (Esplora API). */
    readonly rest: BitcoinRestClient;
    /** RPC client (Bitcoin Core). May be undefined if not configured. */
    readonly rpc?: BitcoinCoreRpcClient;
    /** Bitcoin network params (for address derivation, PSBT signing, etc.). */
    readonly data: BTCNetwork;
    constructor(options: BitcoinConnectionOptions);
    /**
     * Converts Bitcoin (BTC) to satoshis.
     * Uses string-based arithmetic to avoid floating-point precision errors.
     * @throws {RangeError} If the value has more than 8 decimal places.
     */
    static btcToSats(btc: number): number;
    /**
     * Converts satoshis to Bitcoin (BTC).
     * Uses string-based arithmetic to avoid floating-point precision errors.
     * @param sats Must be a non-negative integer.
     */
    static satsToBtc(sats: number): number;
}
//# sourceMappingURL=connection.d.ts.map