mirror of
https://github.com/bitcoinresearchkit/brk.git
synced 2026-04-30 01:20:00 -07:00
3369 lines
68 KiB
Markdown
3369 lines
68 KiB
Markdown
[**brk-client**](../README.md)
|
|
|
|
***
|
|
|
|
[brk-client](../globals.md) / BrkClient
|
|
|
|
# Class: BrkClient
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:7224](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L7224)
|
|
|
|
Main BRK client with series tree and API methods
|
|
|
|
## Extends
|
|
|
|
- `BrkClientBase`
|
|
|
|
## Constructors
|
|
|
|
### Constructor
|
|
|
|
> **new BrkClient**(`options`): `BrkClient`
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:8403](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L8403)
|
|
|
|
#### Parameters
|
|
|
|
##### options
|
|
|
|
`string` \| [`BrkClientOptions`](../interfaces/BrkClientOptions.md)
|
|
|
|
#### Returns
|
|
|
|
`BrkClient`
|
|
|
|
#### Overrides
|
|
|
|
`BrkClientBase.constructor`
|
|
|
|
## Properties
|
|
|
|
### \_cache
|
|
|
|
> **\_cache**: `Cache` \| `null`
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:1632](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L1632)
|
|
|
|
#### Inherited from
|
|
|
|
`BrkClientBase._cache`
|
|
|
|
***
|
|
|
|
### \_cachePromise
|
|
|
|
> **\_cachePromise**: `Promise`\<`Cache` \| `null`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:1630](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L1630)
|
|
|
|
#### Inherited from
|
|
|
|
`BrkClientBase._cachePromise`
|
|
|
|
***
|
|
|
|
### series
|
|
|
|
> **series**: [`SeriesTree`](../interfaces/SeriesTree.md)
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:8406](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L8406)
|
|
|
|
## Methods
|
|
|
|
### \_fetchSeriesData()
|
|
|
|
> **\_fetchSeriesData**\<`T`\>(`path`, `onUpdate?`): `Promise`\<[`DateSeriesData`](../type-aliases/DateSeriesData.md)\<`T`\>\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:1735](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L1735)
|
|
|
|
Fetch series data and wrap with helper methods (internal)
|
|
|
|
#### Type Parameters
|
|
|
|
##### T
|
|
|
|
`T`
|
|
|
|
#### Parameters
|
|
|
|
##### path
|
|
|
|
`string`
|
|
|
|
##### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`DateSeriesData`](../type-aliases/DateSeriesData.md)\<`T`\>\>
|
|
|
|
#### Inherited from
|
|
|
|
`BrkClientBase._fetchSeriesData`
|
|
|
|
***
|
|
|
|
### \_getCached()
|
|
|
|
> **\_getCached**\<`T`\>(`path`, `parse`, `options?`): `Promise`\<`T`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:1659](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L1659)
|
|
|
|
Make a GET request - races cache vs network, first to resolve calls onUpdate.
|
|
Shared implementation backing `getJson` and `getText`.
|
|
|
|
#### Type Parameters
|
|
|
|
##### T
|
|
|
|
`T`
|
|
|
|
#### Parameters
|
|
|
|
##### path
|
|
|
|
`string`
|
|
|
|
##### parse
|
|
|
|
(`res`) => `Promise`\<`T`\>
|
|
|
|
Response body reader
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`T`\>
|
|
|
|
#### Inherited from
|
|
|
|
`BrkClientBase._getCached`
|
|
|
|
***
|
|
|
|
### dateToIndex()
|
|
|
|
> **dateToIndex**(`index`, `d`): `number`
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:8395](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L8395)
|
|
|
|
Convert a Date to an index value for date-based indexes.
|
|
|
|
#### Parameters
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
The index type
|
|
|
|
##### d
|
|
|
|
`Date`
|
|
|
|
The date to convert
|
|
|
|
#### Returns
|
|
|
|
`number`
|
|
|
|
***
|
|
|
|
### get()
|
|
|
|
> **get**(`path`, `options?`): `Promise`\<`Response`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:1641](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L1641)
|
|
|
|
#### Parameters
|
|
|
|
##### path
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`Response`\>
|
|
|
|
#### Inherited from
|
|
|
|
`BrkClientBase.get`
|
|
|
|
***
|
|
|
|
### getAddress()
|
|
|
|
> **getAddress**(`address`, `options?`): `Promise`\<[`AddrStats`](../interfaces/AddrStats.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10220](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10220)
|
|
|
|
Address information
|
|
|
|
Retrieve address information including balance and transaction counts. Supports all standard Bitcoin address types (P2PKH, P2SH, P2WPKH, P2WSH, P2TR).
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-address)*
|
|
|
|
Endpoint: `GET /api/address/{address}`
|
|
|
|
#### Parameters
|
|
|
|
##### address
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`AddrStats`](../interfaces/AddrStats.md)\>
|
|
|
|
***
|
|
|
|
### getAddressConfirmedTxs()
|
|
|
|
> **getAddressConfirmedTxs**(`address`, `after_txid?`, `options?`): `Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10261](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10261)
|
|
|
|
Address confirmed transactions
|
|
|
|
Get confirmed transactions for an address, 25 per page. Use ?after_txid=<txid> for pagination.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-address-transactions-chain)*
|
|
|
|
Endpoint: `GET /api/address/{address}/txs/chain`
|
|
|
|
#### Parameters
|
|
|
|
##### address
|
|
|
|
`string`
|
|
|
|
##### after\_txid?
|
|
|
|
`string`
|
|
|
|
Txid to paginate from (return transactions before this one)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
***
|
|
|
|
### getAddressMempoolTxs()
|
|
|
|
> **getAddressMempoolTxs**(`address`, `options?`): `Promise`\<`string`[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10282](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10282)
|
|
|
|
Address mempool transactions
|
|
|
|
Get unconfirmed transaction IDs for an address from the mempool (up to 50).
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-address-transactions-mempool)*
|
|
|
|
Endpoint: `GET /api/address/{address}/txs/mempool`
|
|
|
|
#### Parameters
|
|
|
|
##### address
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string`[]\>
|
|
|
|
***
|
|
|
|
### getAddressTxs()
|
|
|
|
> **getAddressTxs**(`address`, `after_txid?`, `options?`): `Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10239](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10239)
|
|
|
|
Address transactions
|
|
|
|
Get transaction history for an address, sorted with newest first. Returns up to 50 mempool transactions plus the first 25 confirmed transactions. Use ?after_txid=<txid> for pagination.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-address-transactions)*
|
|
|
|
Endpoint: `GET /api/address/{address}/txs`
|
|
|
|
#### Parameters
|
|
|
|
##### address
|
|
|
|
`string`
|
|
|
|
##### after\_txid?
|
|
|
|
`string`
|
|
|
|
Txid to paginate from (return transactions before this one)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
***
|
|
|
|
### getAddressUtxos()
|
|
|
|
> **getAddressUtxos**(`address`, `options?`): `Promise`\<[`Utxo`](../interfaces/Utxo.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10300](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10300)
|
|
|
|
Address UTXOs
|
|
|
|
Get unspent transaction outputs (UTXOs) for an address. Returns txid, vout, value, and confirmation status for each UTXO.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-address-utxo)*
|
|
|
|
Endpoint: `GET /api/address/{address}/utxo`
|
|
|
|
#### Parameters
|
|
|
|
##### address
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Utxo`](../interfaces/Utxo.md)[]\>
|
|
|
|
***
|
|
|
|
### getApi()
|
|
|
|
> **getApi**(`options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10202](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10202)
|
|
|
|
Compact OpenAPI specification
|
|
|
|
Compact OpenAPI specification optimized for LLM consumption. Removes redundant fields while preserving essential API information. Full spec available at `/openapi.json`.
|
|
|
|
Endpoint: `GET /api.json`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getBlock()
|
|
|
|
> **getBlock**(`hash`, `options?`): `Promise`\<[`BlockInfo`](../interfaces/BlockInfo.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10336](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10336)
|
|
|
|
Block information
|
|
|
|
Retrieve block information by block hash. Returns block metadata including height, timestamp, difficulty, size, weight, and transaction count.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block)*
|
|
|
|
Endpoint: `GET /api/block/{hash}`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfo`](../interfaces/BlockInfo.md)\>
|
|
|
|
***
|
|
|
|
### getBlockByHeight()
|
|
|
|
> **getBlockByHeight**(`height`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10318](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10318)
|
|
|
|
Block hash by height
|
|
|
|
Retrieve the block hash at a given height. Returns the hash as plain text.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-height)*
|
|
|
|
Endpoint: `GET /api/block-height/{height}`
|
|
|
|
#### Parameters
|
|
|
|
##### height
|
|
|
|
`number`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getBlockByTimestamp()
|
|
|
|
> **getBlockByTimestamp**(`timestamp`, `options?`): `Promise`\<[`BlockTimestamp`](../interfaces/BlockTimestamp.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11338](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11338)
|
|
|
|
Block by timestamp
|
|
|
|
Find the block closest to a given UNIX timestamp.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-timestamp)*
|
|
|
|
Endpoint: `GET /api/v1/mining/blocks/timestamp/{timestamp}`
|
|
|
|
#### Parameters
|
|
|
|
##### timestamp
|
|
|
|
`number`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockTimestamp`](../interfaces/BlockTimestamp.md)\>
|
|
|
|
***
|
|
|
|
### getBlockFeeRates()
|
|
|
|
> **getBlockFeeRates**(`time_period`, `options?`): `Promise`\<[`BlockFeeRatesEntry`](../interfaces/BlockFeeRatesEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11266](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11266)
|
|
|
|
Block fee rates
|
|
|
|
Get block fee rate percentiles (min, 10th, 25th, median, 75th, 90th, max) for a time period. Valid periods: `24h`, `3d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-feerates)*
|
|
|
|
Endpoint: `GET /api/v1/mining/blocks/fee-rates/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockFeeRatesEntry`](../interfaces/BlockFeeRatesEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlockFees()
|
|
|
|
> **getBlockFees**(`time_period`, `options?`): `Promise`\<[`BlockFeesEntry`](../interfaces/BlockFeesEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11284](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11284)
|
|
|
|
Block fees
|
|
|
|
Get average total fees per block for a time period. Valid periods: `24h`, `3d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-fees)*
|
|
|
|
Endpoint: `GET /api/v1/mining/blocks/fees/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockFeesEntry`](../interfaces/BlockFeesEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlockHeader()
|
|
|
|
> **getBlockHeader**(`hash`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10354](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10354)
|
|
|
|
Block header
|
|
|
|
Returns the hex-encoded 80-byte block header.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-header)*
|
|
|
|
Endpoint: `GET /api/block/{hash}/header`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getBlockRaw()
|
|
|
|
> **getBlockRaw**(`hash`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10372](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10372)
|
|
|
|
Raw block
|
|
|
|
Returns the raw block data in binary format.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-raw)*
|
|
|
|
Endpoint: `GET /api/block/{hash}/raw`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getBlockRewards()
|
|
|
|
> **getBlockRewards**(`time_period`, `options?`): `Promise`\<[`BlockRewardsEntry`](../interfaces/BlockRewardsEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11302](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11302)
|
|
|
|
Block rewards
|
|
|
|
Get average coinbase reward (subsidy + fees) per block for a time period. Valid periods: `24h`, `3d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-rewards)*
|
|
|
|
Endpoint: `GET /api/v1/mining/blocks/rewards/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockRewardsEntry`](../interfaces/BlockRewardsEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlocks()
|
|
|
|
> **getBlocks**(`options?`): `Promise`\<[`BlockInfo`](../interfaces/BlockInfo.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10480](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10480)
|
|
|
|
Recent blocks
|
|
|
|
Retrieve the last 10 blocks. Returns block metadata for each block.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-blocks)*
|
|
|
|
Endpoint: `GET /api/blocks`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfo`](../interfaces/BlockInfo.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlocksFromHeight()
|
|
|
|
> **getBlocksFromHeight**(`height`, `options?`): `Promise`\<[`BlockInfo`](../interfaces/BlockInfo.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10530](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10530)
|
|
|
|
Blocks from height
|
|
|
|
Retrieve up to 10 blocks going backwards from the given height. For example, height=100 returns blocks 100, 99, 98, ..., 91. Height=0 returns only block 0.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-blocks)*
|
|
|
|
Endpoint: `GET /api/blocks/{height}`
|
|
|
|
#### Parameters
|
|
|
|
##### height
|
|
|
|
`number`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfo`](../interfaces/BlockInfo.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlockSizesWeights()
|
|
|
|
> **getBlockSizesWeights**(`time_period`, `options?`): `Promise`\<[`BlockSizesWeights`](../interfaces/BlockSizesWeights.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11320](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11320)
|
|
|
|
Block sizes and weights
|
|
|
|
Get average block sizes and weights for a time period. Valid periods: `24h`, `3d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-sizes-weights)*
|
|
|
|
Endpoint: `GET /api/v1/mining/blocks/sizes-weights/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockSizesWeights`](../interfaces/BlockSizesWeights.md)\>
|
|
|
|
***
|
|
|
|
### getBlockStatus()
|
|
|
|
> **getBlockStatus**(`hash`, `options?`): `Promise`\<[`BlockStatus`](../interfaces/BlockStatus.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10390](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10390)
|
|
|
|
Block status
|
|
|
|
Retrieve the status of a block. Returns whether the block is in the best chain and, if so, its height and the hash of the next block.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-status)*
|
|
|
|
Endpoint: `GET /api/block/{hash}/status`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockStatus`](../interfaces/BlockStatus.md)\>
|
|
|
|
***
|
|
|
|
### getBlocksV1()
|
|
|
|
> **getBlocksV1**(`options?`): `Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11127](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11127)
|
|
|
|
Recent blocks with extras
|
|
|
|
Retrieve the last 10 blocks with extended data including pool identification and fee statistics.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-blocks-v1)*
|
|
|
|
Endpoint: `GET /api/v1/blocks`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlocksV1FromHeight()
|
|
|
|
> **getBlocksV1FromHeight**(`height`, `options?`): `Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11145](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11145)
|
|
|
|
Blocks from height with extras
|
|
|
|
Retrieve up to 10 blocks with extended data going backwards from the given height.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-blocks-v1)*
|
|
|
|
Endpoint: `GET /api/v1/blocks/{height}`
|
|
|
|
#### Parameters
|
|
|
|
##### height
|
|
|
|
`number`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlockTipHash()
|
|
|
|
> **getBlockTipHash**(`options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10496](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10496)
|
|
|
|
Block tip hash
|
|
|
|
Returns the hash of the last block.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-tip-hash)*
|
|
|
|
Endpoint: `GET /api/blocks/tip/hash`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getBlockTipHeight()
|
|
|
|
> **getBlockTipHeight**(`options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10512](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10512)
|
|
|
|
Block tip height
|
|
|
|
Returns the height of the last block.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-tip-height)*
|
|
|
|
Endpoint: `GET /api/blocks/tip/height`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getBlockTxid()
|
|
|
|
> **getBlockTxid**(`hash`, `index`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10409](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10409)
|
|
|
|
Transaction ID at index
|
|
|
|
Retrieve a single transaction ID at a specific index within a block. Returns plain text txid.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-transaction-id)*
|
|
|
|
Endpoint: `GET /api/block/{hash}/txid/{index}`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
Bitcoin block hash
|
|
|
|
##### index
|
|
|
|
`number`
|
|
|
|
Transaction index within the block (0-based)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getBlockTxids()
|
|
|
|
> **getBlockTxids**(`hash`, `options?`): `Promise`\<`string`[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10427](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10427)
|
|
|
|
Block transaction IDs
|
|
|
|
Retrieve all transaction IDs in a block. Returns an array of txids in block order.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-transaction-ids)*
|
|
|
|
Endpoint: `GET /api/block/{hash}/txids`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string`[]\>
|
|
|
|
***
|
|
|
|
### getBlockTxs()
|
|
|
|
> **getBlockTxs**(`hash`, `options?`): `Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10445](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10445)
|
|
|
|
Block transactions
|
|
|
|
Retrieve transactions in a block by block hash. Returns up to 25 transactions starting from index 0.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-transactions)*
|
|
|
|
Endpoint: `GET /api/block/{hash}/txs`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlockTxsFromIndex()
|
|
|
|
> **getBlockTxsFromIndex**(`hash`, `start_index`, `options?`): `Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10464](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10464)
|
|
|
|
Block transactions (paginated)
|
|
|
|
Retrieve transactions in a block by block hash, starting from the specified index. Returns up to 25 transactions at a time.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-transactions)*
|
|
|
|
Endpoint: `GET /api/block/{hash}/txs/{start_index}`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
Bitcoin block hash
|
|
|
|
##### start\_index
|
|
|
|
`number`
|
|
|
|
Starting transaction index within the block (0-based)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Transaction`](../interfaces/Transaction.md)[]\>
|
|
|
|
***
|
|
|
|
### getBlockV1()
|
|
|
|
> **getBlockV1**(`hash`, `options?`): `Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11111](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11111)
|
|
|
|
Block (v1)
|
|
|
|
Returns block details with extras by hash.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-v1)*
|
|
|
|
Endpoint: `GET /api/v1/block/{hash}`
|
|
|
|
#### Parameters
|
|
|
|
##### hash
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)\>
|
|
|
|
***
|
|
|
|
### getCpfp()
|
|
|
|
> **getCpfp**(`txid`, `options?`): `Promise`\<[`CpfpInfo`](../interfaces/CpfpInfo.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11163](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11163)
|
|
|
|
CPFP info
|
|
|
|
Returns ancestors and descendants for a CPFP (Child Pays For Parent) transaction, including the effective fee rate of the package.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-children-pay-for-parent)*
|
|
|
|
Endpoint: `GET /api/v1/cpfp/{txid}`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`CpfpInfo`](../interfaces/CpfpInfo.md)\>
|
|
|
|
***
|
|
|
|
### getDifficultyAdjustment()
|
|
|
|
> **getDifficultyAdjustment**(`options?`): `Promise`\<[`DifficultyAdjustment`](../interfaces/DifficultyAdjustment.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11179](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11179)
|
|
|
|
Difficulty adjustment
|
|
|
|
Get current difficulty adjustment progress and estimates.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-difficulty-adjustment)*
|
|
|
|
Endpoint: `GET /api/v1/difficulty-adjustment`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`DifficultyAdjustment`](../interfaces/DifficultyAdjustment.md)\>
|
|
|
|
***
|
|
|
|
### getDifficultyAdjustments()
|
|
|
|
> **getDifficultyAdjustments**(`options?`): `Promise`\<[`DifficultyAdjustmentEntry`](../interfaces/DifficultyAdjustmentEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11354](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11354)
|
|
|
|
Difficulty adjustments (all time)
|
|
|
|
Get historical difficulty adjustments including timestamp, block height, difficulty value, and percentage change.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-difficulty-adjustments)*
|
|
|
|
Endpoint: `GET /api/v1/mining/difficulty-adjustments`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`DifficultyAdjustmentEntry`](../interfaces/DifficultyAdjustmentEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getDifficultyAdjustmentsByPeriod()
|
|
|
|
> **getDifficultyAdjustmentsByPeriod**(`time_period`, `options?`): `Promise`\<[`DifficultyAdjustmentEntry`](../interfaces/DifficultyAdjustmentEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11372](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11372)
|
|
|
|
Difficulty adjustments
|
|
|
|
Get historical difficulty adjustments for a time period. Valid periods: `24h`, `3d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-difficulty-adjustments)*
|
|
|
|
Endpoint: `GET /api/v1/mining/difficulty-adjustments/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`DifficultyAdjustmentEntry`](../interfaces/DifficultyAdjustmentEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getDiskUsage()
|
|
|
|
> **getDiskUsage**(`options?`): `Promise`\<[`DiskUsage`](../interfaces/DiskUsage.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10843](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10843)
|
|
|
|
Disk usage
|
|
|
|
Returns the disk space used by BRK and Bitcoin data.
|
|
|
|
Endpoint: `GET /api/server/disk`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`DiskUsage`](../interfaces/DiskUsage.md)\>
|
|
|
|
***
|
|
|
|
### getHashrate()
|
|
|
|
> **getHashrate**(`options?`): `Promise`\<[`HashrateSummary`](../interfaces/HashrateSummary.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11388](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11388)
|
|
|
|
Network hashrate (all time)
|
|
|
|
Get network hashrate and difficulty data for all time.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-hashrate)*
|
|
|
|
Endpoint: `GET /api/v1/mining/hashrate`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`HashrateSummary`](../interfaces/HashrateSummary.md)\>
|
|
|
|
***
|
|
|
|
### getHashrateByPeriod()
|
|
|
|
> **getHashrateByPeriod**(`time_period`, `options?`): `Promise`\<[`HashrateSummary`](../interfaces/HashrateSummary.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11440](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11440)
|
|
|
|
Network hashrate
|
|
|
|
Get network hashrate and difficulty data for a time period. Valid periods: `24h`, `3d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-hashrate)*
|
|
|
|
Endpoint: `GET /api/v1/mining/hashrate/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`HashrateSummary`](../interfaces/HashrateSummary.md)\>
|
|
|
|
***
|
|
|
|
### getHealth()
|
|
|
|
> **getHealth**(`options?`): `Promise`\<[`Health`](../interfaces/Health.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11629](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11629)
|
|
|
|
Health check
|
|
|
|
Returns the health status of the API server, including uptime information.
|
|
|
|
Endpoint: `GET /health`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Health`](../interfaces/Health.md)\>
|
|
|
|
***
|
|
|
|
### getHistoricalPrice()
|
|
|
|
> **getHistoricalPrice**(`timestamp?`, `options?`): `Promise`\<[`HistoricalPrice`](../interfaces/HistoricalPrice.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11245](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11245)
|
|
|
|
Historical price
|
|
|
|
Get historical BTC/USD price. Optionally specify a UNIX timestamp to get the price at that time.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-historical-price)*
|
|
|
|
Endpoint: `GET /api/v1/historical-price`
|
|
|
|
#### Parameters
|
|
|
|
##### timestamp?
|
|
|
|
`number`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`HistoricalPrice`](../interfaces/HistoricalPrice.md)\>
|
|
|
|
***
|
|
|
|
### getIndexes()
|
|
|
|
> **getIndexes**(`options?`): `Promise`\<[`IndexInfo`](../interfaces/IndexInfo.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10664](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10664)
|
|
|
|
List available indexes
|
|
|
|
Returns all available indexes with their accepted query aliases. Use any alias when querying series.
|
|
|
|
Endpoint: `GET /api/series/indexes`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`IndexInfo`](../interfaces/IndexInfo.md)[]\>
|
|
|
|
***
|
|
|
|
### getJson()
|
|
|
|
> **getJson**\<`T`\>(`path`, `options?`): `Promise`\<`T`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:1713](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L1713)
|
|
|
|
Make a GET request expecting a JSON response. Cached and supports `onUpdate`.
|
|
|
|
#### Type Parameters
|
|
|
|
##### T
|
|
|
|
`T`
|
|
|
|
#### Parameters
|
|
|
|
##### path
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`T`\>
|
|
|
|
#### Inherited from
|
|
|
|
`BrkClientBase.getJson`
|
|
|
|
***
|
|
|
|
### getLivePrice()
|
|
|
|
> **getLivePrice**(`options?`): `Promise`\<`number`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10560](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10560)
|
|
|
|
Live BTC/USD price
|
|
|
|
Returns the current BTC/USD price in dollars, derived from on-chain round-dollar output patterns in the last 12 blocks plus mempool.
|
|
|
|
Endpoint: `GET /api/mempool/price`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`number`\>
|
|
|
|
***
|
|
|
|
### getMempool()
|
|
|
|
> **getMempool**(`options?`): `Promise`\<[`MempoolInfo`](../interfaces/MempoolInfo.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10546](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10546)
|
|
|
|
Mempool statistics
|
|
|
|
Get current mempool statistics including transaction count, total vsize, total fees, and fee histogram.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool)*
|
|
|
|
Endpoint: `GET /api/mempool`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`MempoolInfo`](../interfaces/MempoolInfo.md)\>
|
|
|
|
***
|
|
|
|
### getMempoolBlocks()
|
|
|
|
> **getMempoolBlocks**(`options?`): `Promise`\<[`MempoolBlock`](../interfaces/MempoolBlock.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11195](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11195)
|
|
|
|
Projected mempool blocks
|
|
|
|
Get projected blocks from the mempool for fee estimation.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool-blocks-fees)*
|
|
|
|
Endpoint: `GET /api/v1/fees/mempool-blocks`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`MempoolBlock`](../interfaces/MempoolBlock.md)[]\>
|
|
|
|
***
|
|
|
|
### getMempoolRecent()
|
|
|
|
> **getMempoolRecent**(`options?`): `Promise`\<[`MempoolRecentTx`](../interfaces/MempoolRecentTx.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10576](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10576)
|
|
|
|
Recent mempool transactions
|
|
|
|
Get the last 10 transactions to enter the mempool.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool-recent)*
|
|
|
|
Endpoint: `GET /api/mempool/recent`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`MempoolRecentTx`](../interfaces/MempoolRecentTx.md)[]\>
|
|
|
|
***
|
|
|
|
### getMempoolTxids()
|
|
|
|
> **getMempoolTxids**(`options?`): `Promise`\<`string`[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10592](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10592)
|
|
|
|
Mempool transaction IDs
|
|
|
|
Get all transaction IDs currently in the mempool.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool-transaction-ids)*
|
|
|
|
Endpoint: `GET /api/mempool/txids`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string`[]\>
|
|
|
|
***
|
|
|
|
### getOpenapi()
|
|
|
|
> **getOpenapi**(`options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11643](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11643)
|
|
|
|
OpenAPI specification
|
|
|
|
Full OpenAPI 3.1 specification for this API.
|
|
|
|
Endpoint: `GET /openapi.json`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getPool()
|
|
|
|
> **getPool**(`slug`, `options?`): `Promise`\<[`PoolDetail`](../interfaces/PoolDetail.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11458](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11458)
|
|
|
|
Mining pool details
|
|
|
|
Get detailed information about a specific mining pool including block counts and shares for different time periods.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pool)*
|
|
|
|
Endpoint: `GET /api/v1/mining/pool/{slug}`
|
|
|
|
#### Parameters
|
|
|
|
##### slug
|
|
|
|
[`PoolSlug`](../type-aliases/PoolSlug.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`PoolDetail`](../interfaces/PoolDetail.md)\>
|
|
|
|
***
|
|
|
|
### getPoolBlocks()
|
|
|
|
> **getPoolBlocks**(`slug`, `options?`): `Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11476](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11476)
|
|
|
|
Mining pool blocks
|
|
|
|
Get the 10 most recent blocks mined by a specific pool.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pool-blocks)*
|
|
|
|
Endpoint: `GET /api/v1/mining/pool/{slug}/blocks`
|
|
|
|
#### Parameters
|
|
|
|
##### slug
|
|
|
|
[`PoolSlug`](../type-aliases/PoolSlug.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
***
|
|
|
|
### getPoolBlocksFrom()
|
|
|
|
> **getPoolBlocksFrom**(`slug`, `height`, `options?`): `Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11495](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11495)
|
|
|
|
Mining pool blocks from height
|
|
|
|
Get 10 blocks mined by a specific pool before (and including) the given height.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pool-blocks)*
|
|
|
|
Endpoint: `GET /api/v1/mining/pool/{slug}/blocks/{height}`
|
|
|
|
#### Parameters
|
|
|
|
##### slug
|
|
|
|
[`PoolSlug`](../type-aliases/PoolSlug.md)
|
|
|
|
##### height
|
|
|
|
`number`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`BlockInfoV1`](../interfaces/BlockInfoV1.md)[]\>
|
|
|
|
***
|
|
|
|
### getPoolHashrate()
|
|
|
|
> **getPoolHashrate**(`slug`, `options?`): `Promise`\<[`PoolHashrateEntry`](../interfaces/PoolHashrateEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11513](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11513)
|
|
|
|
Mining pool hashrate
|
|
|
|
Get hashrate history for a specific mining pool.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pool-hashrate)*
|
|
|
|
Endpoint: `GET /api/v1/mining/pool/{slug}/hashrate`
|
|
|
|
#### Parameters
|
|
|
|
##### slug
|
|
|
|
[`PoolSlug`](../type-aliases/PoolSlug.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`PoolHashrateEntry`](../interfaces/PoolHashrateEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getPools()
|
|
|
|
> **getPools**(`options?`): `Promise`\<[`PoolInfo`](../interfaces/PoolInfo.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11529](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11529)
|
|
|
|
List all mining pools
|
|
|
|
Get list of all known mining pools with their identifiers.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pools)*
|
|
|
|
Endpoint: `GET /api/v1/mining/pools`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`PoolInfo`](../interfaces/PoolInfo.md)[]\>
|
|
|
|
***
|
|
|
|
### getPoolsHashrate()
|
|
|
|
> **getPoolsHashrate**(`options?`): `Promise`\<[`PoolHashrateEntry`](../interfaces/PoolHashrateEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11404](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11404)
|
|
|
|
All pools hashrate (all time)
|
|
|
|
Get hashrate data for all mining pools.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pool-hashrates)*
|
|
|
|
Endpoint: `GET /api/v1/mining/hashrate/pools`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`PoolHashrateEntry`](../interfaces/PoolHashrateEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getPoolsHashrateByPeriod()
|
|
|
|
> **getPoolsHashrateByPeriod**(`time_period`, `options?`): `Promise`\<[`PoolHashrateEntry`](../interfaces/PoolHashrateEntry.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11422](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11422)
|
|
|
|
All pools hashrate
|
|
|
|
Get hashrate data for all mining pools for a time period. Valid periods: `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pool-hashrates)*
|
|
|
|
Endpoint: `GET /api/v1/mining/hashrate/pools/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`PoolHashrateEntry`](../interfaces/PoolHashrateEntry.md)[]\>
|
|
|
|
***
|
|
|
|
### getPoolStats()
|
|
|
|
> **getPoolStats**(`time_period`, `options?`): `Promise`\<[`PoolsSummary`](../interfaces/PoolsSummary.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11547](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11547)
|
|
|
|
Mining pool statistics
|
|
|
|
Get mining pool statistics for a time period. Valid periods: `24h`, `3d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pools)*
|
|
|
|
Endpoint: `GET /api/v1/mining/pools/{time_period}`
|
|
|
|
#### Parameters
|
|
|
|
##### time\_period
|
|
|
|
[`TimePeriod`](../type-aliases/TimePeriod.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`PoolsSummary`](../interfaces/PoolsSummary.md)\>
|
|
|
|
***
|
|
|
|
### getPreciseFees()
|
|
|
|
> **getPreciseFees**(`options?`): `Promise`\<[`RecommendedFees`](../interfaces/RecommendedFees.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11211](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11211)
|
|
|
|
Precise recommended fees
|
|
|
|
Get recommended fee rates with up to 3 decimal places.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-recommended-fees-precise)*
|
|
|
|
Endpoint: `GET /api/v1/fees/precise`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`RecommendedFees`](../interfaces/RecommendedFees.md)\>
|
|
|
|
***
|
|
|
|
### getPrices()
|
|
|
|
> **getPrices**(`options?`): `Promise`\<[`Prices`](../interfaces/Prices.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11581](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11581)
|
|
|
|
Current BTC price
|
|
|
|
Returns bitcoin latest price (on-chain derived, USD only).
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-price)*
|
|
|
|
Endpoint: `GET /api/v1/prices`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Prices`](../interfaces/Prices.md)\>
|
|
|
|
***
|
|
|
|
### getRecommendedFees()
|
|
|
|
> **getRecommendedFees**(`options?`): `Promise`\<[`RecommendedFees`](../interfaces/RecommendedFees.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11227](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11227)
|
|
|
|
Recommended fees
|
|
|
|
Get recommended fee rates for different confirmation targets.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-recommended-fees)*
|
|
|
|
Endpoint: `GET /api/v1/fees/recommended`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`RecommendedFees`](../interfaces/RecommendedFees.md)\>
|
|
|
|
***
|
|
|
|
### getRewardStats()
|
|
|
|
> **getRewardStats**(`block_count`, `options?`): `Promise`\<[`RewardStats`](../interfaces/RewardStats.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11565](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11565)
|
|
|
|
Mining reward statistics
|
|
|
|
Get mining reward statistics for the last N blocks including total rewards, fees, and transaction count.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-reward-stats)*
|
|
|
|
Endpoint: `GET /api/v1/mining/reward-stats/{block_count}`
|
|
|
|
#### Parameters
|
|
|
|
##### block\_count
|
|
|
|
`number`
|
|
|
|
Number of recent blocks to include
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`RewardStats`](../interfaces/RewardStats.md)\>
|
|
|
|
***
|
|
|
|
### getSeries()
|
|
|
|
> **getSeries**(`series`, `index`, `start?`, `end?`, `limit?`, `format?`, `options?`): `Promise`\<`string` \| [`AnySeriesData`](../type-aliases/AnySeriesData.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10743](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10743)
|
|
|
|
Get series data
|
|
|
|
Fetch data for a specific series at the given index. Use query parameters to filter by date range and format (json/csv).
|
|
|
|
Endpoint: `GET /api/series/{series}/{index}`
|
|
|
|
#### Parameters
|
|
|
|
##### series
|
|
|
|
`string`
|
|
|
|
Series name
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
Aggregation index
|
|
|
|
##### start?
|
|
|
|
`number`
|
|
|
|
Inclusive start: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `from`, `f`, `s`
|
|
|
|
##### end?
|
|
|
|
`number`
|
|
|
|
Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `to`, `t`, `e`
|
|
|
|
##### limit?
|
|
|
|
`number`
|
|
|
|
Maximum number of values to return (ignored if `end` is set). Aliases: `count`, `c`, `l`
|
|
|
|
##### format?
|
|
|
|
[`Format`](../type-aliases/Format.md)
|
|
|
|
Format of the output
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string` \| [`AnySeriesData`](../type-aliases/AnySeriesData.md)\>
|
|
|
|
***
|
|
|
|
### getSeriesBulk()
|
|
|
|
> **getSeriesBulk**(`series?`, `index?`, `start?`, `end?`, `limit?`, `format?`, `options?`): `Promise`\<`string` \| [`AnySeriesData`](../type-aliases/AnySeriesData.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10627](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10627)
|
|
|
|
Bulk series data
|
|
|
|
Fetch multiple series in a single request. Supports filtering by index and date range. Returns an array of SeriesData objects. For a single series, use `get_series` instead.
|
|
|
|
Endpoint: `GET /api/series/bulk`
|
|
|
|
#### Parameters
|
|
|
|
##### series?
|
|
|
|
`string`
|
|
|
|
Requested series
|
|
|
|
##### index?
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
Index to query
|
|
|
|
##### start?
|
|
|
|
`number`
|
|
|
|
Inclusive start: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `from`, `f`, `s`
|
|
|
|
##### end?
|
|
|
|
`number`
|
|
|
|
Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `to`, `t`, `e`
|
|
|
|
##### limit?
|
|
|
|
`number`
|
|
|
|
Maximum number of values to return (ignored if `end` is set). Aliases: `count`, `c`, `l`
|
|
|
|
##### format?
|
|
|
|
[`Format`](../type-aliases/Format.md)
|
|
|
|
Format of the output
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string` \| [`AnySeriesData`](../type-aliases/AnySeriesData.md)[]\>
|
|
|
|
***
|
|
|
|
### getSeriesCount()
|
|
|
|
> **getSeriesCount**(`options?`): `Promise`\<[`SeriesCount`](../interfaces/SeriesCount.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10650](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10650)
|
|
|
|
Series count
|
|
|
|
Returns the number of series available per index type.
|
|
|
|
Endpoint: `GET /api/series/count`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`SeriesCount`](../interfaces/SeriesCount.md)[]\>
|
|
|
|
***
|
|
|
|
### getSeriesData()
|
|
|
|
> **getSeriesData**(`series`, `index`, `start?`, `end?`, `limit?`, `format?`, `options?`): `Promise`\<`string` \| `boolean`[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10771](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10771)
|
|
|
|
Get raw series data
|
|
|
|
Returns just the data array without the SeriesData wrapper. Supports the same range and format parameters as the standard endpoint.
|
|
|
|
Endpoint: `GET /api/series/{series}/{index}/data`
|
|
|
|
#### Parameters
|
|
|
|
##### series
|
|
|
|
`string`
|
|
|
|
Series name
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
Aggregation index
|
|
|
|
##### start?
|
|
|
|
`number`
|
|
|
|
Inclusive start: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `from`, `f`, `s`
|
|
|
|
##### end?
|
|
|
|
`number`
|
|
|
|
Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `to`, `t`, `e`
|
|
|
|
##### limit?
|
|
|
|
`number`
|
|
|
|
Maximum number of values to return (ignored if `end` is set). Aliases: `count`, `c`, `l`
|
|
|
|
##### format?
|
|
|
|
[`Format`](../type-aliases/Format.md)
|
|
|
|
Format of the output
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string` \| `boolean`[]\>
|
|
|
|
***
|
|
|
|
### getSeriesInfo()
|
|
|
|
> **getSeriesInfo**(`series`, `options?`): `Promise`\<[`SeriesInfo`](../interfaces/SeriesInfo.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10722](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10722)
|
|
|
|
Get series info
|
|
|
|
Returns the supported indexes and value type for the specified series.
|
|
|
|
Endpoint: `GET /api/series/{series}`
|
|
|
|
#### Parameters
|
|
|
|
##### series
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`SeriesInfo`](../interfaces/SeriesInfo.md)\>
|
|
|
|
***
|
|
|
|
### getSeriesLatest()
|
|
|
|
> **getSeriesLatest**(`series`, `index`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10795](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10795)
|
|
|
|
Get latest series value
|
|
|
|
Returns the single most recent value for a series, unwrapped (not inside a SeriesData object).
|
|
|
|
Endpoint: `GET /api/series/{series}/{index}/latest`
|
|
|
|
#### Parameters
|
|
|
|
##### series
|
|
|
|
`string`
|
|
|
|
Series name
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
Aggregation index
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getSeriesLen()
|
|
|
|
> **getSeriesLen**(`series`, `index`, `options?`): `Promise`\<`number`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10812](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10812)
|
|
|
|
Get series data length
|
|
|
|
Returns the total number of data points for a series at the given index.
|
|
|
|
Endpoint: `GET /api/series/{series}/{index}/len`
|
|
|
|
#### Parameters
|
|
|
|
##### series
|
|
|
|
`string`
|
|
|
|
Series name
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
Aggregation index
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`number`\>
|
|
|
|
***
|
|
|
|
### getSeriesTree()
|
|
|
|
> **getSeriesTree**(`options?`): `Promise`\<[`TreeNode`](../type-aliases/TreeNode.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10606](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10606)
|
|
|
|
Series catalog
|
|
|
|
Returns the complete hierarchical catalog of available series organized as a tree structure. Series are grouped by categories and subcategories.
|
|
|
|
Endpoint: `GET /api/series`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`TreeNode`](../type-aliases/TreeNode.md)\>
|
|
|
|
***
|
|
|
|
### getSeriesVersion()
|
|
|
|
> **getSeriesVersion**(`series`, `index`, `options?`): `Promise`\<`number`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10829](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10829)
|
|
|
|
Get series version
|
|
|
|
Returns the current version of a series. Changes when the series data is updated.
|
|
|
|
Endpoint: `GET /api/series/{series}/{index}/version`
|
|
|
|
#### Parameters
|
|
|
|
##### series
|
|
|
|
`string`
|
|
|
|
Series name
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
Aggregation index
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`number`\>
|
|
|
|
***
|
|
|
|
### getSyncStatus()
|
|
|
|
> **getSyncStatus**(`options?`): `Promise`\<[`SyncStatus`](../interfaces/SyncStatus.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10857](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10857)
|
|
|
|
Sync status
|
|
|
|
Returns the sync status of the indexer, including indexed height, tip height, blocks behind, and last indexed timestamp.
|
|
|
|
Endpoint: `GET /api/server/sync`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`SyncStatus`](../interfaces/SyncStatus.md)\>
|
|
|
|
***
|
|
|
|
### getText()
|
|
|
|
> **getText**(`path`, `options?`): `Promise`\<`string`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:1724](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L1724)
|
|
|
|
Make a GET request expecting a text response (text/plain, text/csv, ...).
|
|
Cached and supports `onUpdate`, same as `getJson`.
|
|
|
|
#### Parameters
|
|
|
|
##### path
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string`\>
|
|
|
|
#### Inherited from
|
|
|
|
`BrkClientBase.getText`
|
|
|
|
***
|
|
|
|
### getTransactionTimes()
|
|
|
|
> **getTransactionTimes**(`options?`): `Promise`\<`number`[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11597](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11597)
|
|
|
|
Transaction first-seen times
|
|
|
|
Returns timestamps when transactions were first seen in the mempool. Returns 0 for mined or unknown transactions.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-times)*
|
|
|
|
Endpoint: `GET /api/v1/transaction-times`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`number`[]\>
|
|
|
|
***
|
|
|
|
### getTx()
|
|
|
|
> **getTx**(`txid`, `options?`): `Promise`\<[`Transaction`](../interfaces/Transaction.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10891](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10891)
|
|
|
|
Transaction information
|
|
|
|
Retrieve complete transaction data by transaction ID (txid). Returns inputs, outputs, fee, size, and confirmation status.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Transaction`](../interfaces/Transaction.md)\>
|
|
|
|
***
|
|
|
|
### getTxByIndex()
|
|
|
|
> **getTxByIndex**(`index`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10873](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10873)
|
|
|
|
Txid by index
|
|
|
|
Retrieve the transaction ID (txid) at a given global transaction index. Returns the txid as plain text.
|
|
|
|
Endpoint: `GET /api/tx-index/{index}`
|
|
|
|
#### Parameters
|
|
|
|
##### index
|
|
|
|
`number`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getTxHex()
|
|
|
|
> **getTxHex**(`txid`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10909](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10909)
|
|
|
|
Transaction hex
|
|
|
|
Retrieve the raw transaction as a hex-encoded string. Returns the serialized transaction in hexadecimal format.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-hex)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}/hex`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getTxMerkleblockProof()
|
|
|
|
> **getTxMerkleblockProof**(`txid`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10945](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10945)
|
|
|
|
Transaction merkleblock proof
|
|
|
|
Get the merkleblock proof for a transaction (BIP37 format, hex encoded).
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-merkleblock-proof)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}/merkleblock-proof`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getTxMerkleProof()
|
|
|
|
> **getTxMerkleProof**(`txid`, `options?`): `Promise`\<[`MerkleProof`](../interfaces/MerkleProof.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10927](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10927)
|
|
|
|
Transaction merkle proof
|
|
|
|
Get the merkle inclusion proof for a transaction.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-merkle-proof)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}/merkle-proof`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`MerkleProof`](../interfaces/MerkleProof.md)\>
|
|
|
|
***
|
|
|
|
### getTxOutspend()
|
|
|
|
> **getTxOutspend**(`txid`, `vout`, `options?`): `Promise`\<[`TxOutspend`](../interfaces/TxOutspend.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10964](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10964)
|
|
|
|
Output spend status
|
|
|
|
Get the spending status of a transaction output. Returns whether the output has been spent and, if so, the spending transaction details.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-outspend)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}/outspend/{vout}`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
Transaction ID
|
|
|
|
##### vout
|
|
|
|
`number`
|
|
|
|
Output index
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`TxOutspend`](../interfaces/TxOutspend.md)\>
|
|
|
|
***
|
|
|
|
### getTxOutspends()
|
|
|
|
> **getTxOutspends**(`txid`, `options?`): `Promise`\<[`TxOutspend`](../interfaces/TxOutspend.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10982](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10982)
|
|
|
|
All output spend statuses
|
|
|
|
Get the spending status of all outputs in a transaction. Returns an array with the spend status for each output.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-outspends)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}/outspends`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`TxOutspend`](../interfaces/TxOutspend.md)[]\>
|
|
|
|
***
|
|
|
|
### getTxRaw()
|
|
|
|
> **getTxRaw**(`txid`, `options?`): `Promise`\<`any`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11000](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11000)
|
|
|
|
Transaction raw
|
|
|
|
Returns a transaction as binary data.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-raw)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}/raw`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`any`\>
|
|
|
|
***
|
|
|
|
### getTxStatus()
|
|
|
|
> **getTxStatus**(`txid`, `options?`): `Promise`\<[`TxStatus`](../interfaces/TxStatus.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11018](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11018)
|
|
|
|
Transaction status
|
|
|
|
Retrieve the confirmation status of a transaction. Returns whether the transaction is confirmed and, if so, the block height, hash, and timestamp.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-status)*
|
|
|
|
Endpoint: `GET /api/tx/{txid}/status`
|
|
|
|
#### Parameters
|
|
|
|
##### txid
|
|
|
|
`string`
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`TxStatus`](../interfaces/TxStatus.md)\>
|
|
|
|
***
|
|
|
|
### getUrpd()
|
|
|
|
> **getUrpd**(`cohort`, `agg?`, `options?`): `Promise`\<[`Urpd`](../interfaces/Urpd.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11051](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11051)
|
|
|
|
Latest URPD
|
|
|
|
URPD for the most recent available date in the cohort. The response's `date` field echoes which date was served.
|
|
|
|
See the URPD tag description for the response shape and `agg` options.
|
|
|
|
Endpoint: `GET /api/urpd/{cohort}`
|
|
|
|
#### Parameters
|
|
|
|
##### cohort
|
|
|
|
[`Cohort`](../type-aliases/Cohort.md)
|
|
|
|
##### agg?
|
|
|
|
[`UrpdAggregation`](../type-aliases/UrpdAggregation.md)
|
|
|
|
Aggregation strategy. Default: raw (no aggregation). Accepts `bucket` as alias.
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Urpd`](../interfaces/Urpd.md)\>
|
|
|
|
***
|
|
|
|
### getUrpdAt()
|
|
|
|
> **getUrpdAt**(`cohort`, `date`, `agg?`, `options?`): `Promise`\<[`Urpd`](../interfaces/Urpd.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11090](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11090)
|
|
|
|
URPD at date
|
|
|
|
URPD for a (cohort, date) pair. Returns `{ cohort, date, aggregation, close, total_supply, buckets }` where each bucket is `{ price_floor, supply, realized_cap, unrealized_pnl }`.
|
|
|
|
See the URPD tag description for unit conventions and `agg` options.
|
|
|
|
Endpoint: `GET /api/urpd/{cohort}/{date}`
|
|
|
|
#### Parameters
|
|
|
|
##### cohort
|
|
|
|
[`Cohort`](../type-aliases/Cohort.md)
|
|
|
|
##### date
|
|
|
|
`string`
|
|
|
|
##### agg?
|
|
|
|
[`UrpdAggregation`](../type-aliases/UrpdAggregation.md)
|
|
|
|
Aggregation strategy. Default: raw (no aggregation). Accepts `bucket` as alias.
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Urpd`](../interfaces/Urpd.md)\>
|
|
|
|
***
|
|
|
|
### getVersion()
|
|
|
|
> **getVersion**(`options?`): `Promise`\<`string`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11657](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11657)
|
|
|
|
API version
|
|
|
|
Returns the current version of the API server
|
|
|
|
Endpoint: `GET /version`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string`\>
|
|
|
|
***
|
|
|
|
### indexToDate()
|
|
|
|
> **indexToDate**(`index`, `i`): `Date`
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:8385](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L8385)
|
|
|
|
Convert an index value to a Date for date-based indexes.
|
|
|
|
#### Parameters
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
The index type
|
|
|
|
##### i
|
|
|
|
`number`
|
|
|
|
The index value
|
|
|
|
#### Returns
|
|
|
|
`Date`
|
|
|
|
***
|
|
|
|
### listSeries()
|
|
|
|
> **listSeries**(`page?`, `per_page?`, `options?`): `Promise`\<[`PaginatedSeries`](../interfaces/PaginatedSeries.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10681](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10681)
|
|
|
|
Series list
|
|
|
|
Paginated flat list of all available series names. Use `page` query param for pagination.
|
|
|
|
Endpoint: `GET /api/series/list`
|
|
|
|
#### Parameters
|
|
|
|
##### page?
|
|
|
|
`number`
|
|
|
|
Pagination index
|
|
|
|
##### per\_page?
|
|
|
|
`number`
|
|
|
|
Results per page (default: 1000, max: 1000)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`PaginatedSeries`](../interfaces/PaginatedSeries.md)\>
|
|
|
|
***
|
|
|
|
### listUrpdCohorts()
|
|
|
|
> **listUrpdCohorts**(`options?`): `Promise`\<[`Cohort`](../type-aliases/Cohort.md)[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11032](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11032)
|
|
|
|
Available URPD cohorts
|
|
|
|
Cohorts for which URPD data is available. Returns names like `all`, `sth`, `lth`, `utxos_under_1h_old`.
|
|
|
|
Endpoint: `GET /api/urpd`
|
|
|
|
#### Parameters
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`Cohort`](../type-aliases/Cohort.md)[]\>
|
|
|
|
***
|
|
|
|
### listUrpdDates()
|
|
|
|
> **listUrpdDates**(`cohort`, `options?`): `Promise`\<`number`[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11070](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11070)
|
|
|
|
Available URPD dates
|
|
|
|
Dates for which a URPD snapshot is available for the cohort. One entry per UTC day, sorted ascending.
|
|
|
|
Endpoint: `GET /api/urpd/{cohort}/dates`
|
|
|
|
#### Parameters
|
|
|
|
##### cohort
|
|
|
|
[`Cohort`](../type-aliases/Cohort.md)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`number`[]\>
|
|
|
|
***
|
|
|
|
### searchSeries()
|
|
|
|
> **searchSeries**(`q?`, `limit?`, `options?`): `Promise`\<`string`[]\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10702](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10702)
|
|
|
|
Search series
|
|
|
|
Fuzzy search for series by name. Supports partial matches and typos.
|
|
|
|
Endpoint: `GET /api/series/search`
|
|
|
|
#### Parameters
|
|
|
|
##### q?
|
|
|
|
`string`
|
|
|
|
Search query string
|
|
|
|
##### limit?
|
|
|
|
`number`
|
|
|
|
Maximum number of results
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<`string`[]\>
|
|
|
|
***
|
|
|
|
### seriesEndpoint()
|
|
|
|
> **seriesEndpoint**(`series`, `index`): [`SeriesEndpoint`](../interfaces/SeriesEndpoint.md)\<`unknown`\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:10189](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L10189)
|
|
|
|
Create a dynamic series endpoint builder for any series/index combination.
|
|
|
|
Use this for programmatic access when the series name is determined at runtime.
|
|
For type-safe access, use the `series` tree instead.
|
|
|
|
#### Parameters
|
|
|
|
##### series
|
|
|
|
`string`
|
|
|
|
The series name
|
|
|
|
##### index
|
|
|
|
[`Index`](../type-aliases/Index.md)
|
|
|
|
The index name
|
|
|
|
#### Returns
|
|
|
|
[`SeriesEndpoint`](../interfaces/SeriesEndpoint.md)\<`unknown`\>
|
|
|
|
***
|
|
|
|
### validateAddress()
|
|
|
|
> **validateAddress**(`address`, `options?`): `Promise`\<[`AddrValidation`](../interfaces/AddrValidation.md)\>
|
|
|
|
Defined in: [Developer/brk/modules/brk-client/index.js:11615](https://github.com/bitcoinresearchkit/brk/blob/e4496742a4964a986078f3a65d3bfdc1e47a5eba/modules/brk-client/index.js#L11615)
|
|
|
|
Validate address
|
|
|
|
Validate a Bitcoin address and get information about its type and scriptPubKey. Returns `isvalid: false` with an error message for invalid addresses.
|
|
|
|
*[Mempool.space docs](https://mempool.space/docs/api/rest#get-address-validate)*
|
|
|
|
Endpoint: `GET /api/v1/validate-address/{address}`
|
|
|
|
#### Parameters
|
|
|
|
##### address
|
|
|
|
`string`
|
|
|
|
Bitcoin address to validate (can be any string)
|
|
|
|
##### options?
|
|
|
|
###### onUpdate?
|
|
|
|
(`value`) => `void`
|
|
|
|
###### signal?
|
|
|
|
`AbortSignal`
|
|
|
|
#### Returns
|
|
|
|
`Promise`\<[`AddrValidation`](../interfaces/AddrValidation.md)\>
|