Class EsploraProvider

constructor

• new EsploraProvider(
      baseUrl?: string,
      opts?: { forcePolling?: boolean; pollingInterval?: number },
  ): EsploraProvider

  Parameters

  • baseUrl: string = ...
  • Optionalopts: { forcePolling?: boolean; pollingInterval?: number }

    • OptionalforcePolling?: boolean

      Force polling even when websocket transport is available.

    • OptionalpollingInterval?: number

      Polling interval in milliseconds.

  Returns EsploraProvider

ReadonlyforcePolling

ReadonlypollingInterval

broadcastTransaction

• broadcastTransaction(...txs: string[]): Promise<string>

  Broadcast a single transaction or a 1P1C package.

  Parameters

  • ...txs: string[]

    One or more raw transaction hex strings

  Returns Promise<string>

  Broadcast transaction id

  Throws

  Error if the broadcast request fails or the package shape is invalid

getChainTip

• getChainTip(): Promise<{ hash: string; height: number; time: number }>

  Fetch the current chain tip.

  Returns Promise<{ hash: string; height: number; time: number }>

  Current chain height, block time, and block hash

getCoins

• getCoins(address: string): Promise<Coin[]>

  Fetch spendable onchain outputs for an address.

  Parameters

  • address: string

    Bitcoin address to query

  Returns Promise<Coin[]>

  Spendable onchain outputs for the address

  See

  Coin

getFeeRate

• getFeeRate(): Promise<number | undefined>

  Fetch the current fastest fee rate estimate.

  Returns Promise<number | undefined>

  Fee rate in sats/vB, if available

  Remarks

  Implementations may return undefined when the backing service does not expose a usable fee estimate.

getTransactions

• getTransactions(address: string): Promise<ExplorerTransaction[]>

  Fetch transactions associated with an address.

  Parameters

  • address: string

    Bitcoin address to query

  Returns Promise<ExplorerTransaction[]>

  Transactions involving the address

  See

  ExplorerTransaction

getTxOutspends

• getTxOutspends(txid: string): Promise<{ spent: boolean; txid?: string }[]>

  Fetch outspend information for every output in a transaction.

  Parameters

  • txid: string

    Transaction id to inspect

  Returns Promise<{ spent: boolean; txid?: string }[]>

  Per-output spend status information. txid (the spender) may be absent even when spent is true: some Esplora deployments (e.g. mempool.arkade.sh) omit it from /outspends.

  See

  getTxStatus

getTxStatus

• getTxStatus(
      txid: string,
  ): Promise<
      | { confirmed: false }
      | { blockHeight: number; blockTime: number; confirmed: true },
  >

  Fetch confirmation status for a transaction.

  Parameters

  • txid: string

    Transaction id to inspect

  Returns Promise<
      | { confirmed: false }
      | { blockHeight: number; blockTime: number; confirmed: true },
  >

  Confirmation status and block metadata when confirmed

  See

  getTxOutspends

watchAddresses

• watchAddresses(
      addresses: string[],
      callback: (txs: ExplorerTransaction[]) => void,
  ): Promise<() => void>

  Watch a set of addresses and invoke the callback when transactions are observed.

  Parameters

  • addresses: string[]

    Addresses to monitor

  • callback: (txs: ExplorerTransaction[]) => void

  Returns Promise<() => void>

  Stop function that cancels the watch

  Remarks

  Implementations may use websockets, server-sent events, polling, or a hybrid strategy.

  See

  getTransactions