brk-client 0.2.5 → 0.3.0-alpha.1

package/index.js

@@ -60,6 +60,8 @@
  * @property {?boolean=} iswitness - Whether this is a witness address
  * @property {?number=} witnessVersion - Witness version (0 for P2WPKH/P2WSH, 1 for P2TR)
  * @property {?string=} witnessProgram - Witness program in hex
+ * @property {?number[]=} errorLocations - Error locations (empty array for most errors)
+ * @property {?string=} error - Error message for invalid addresses
  */
 /**
  * Unified index for any address type (funded or empty)
@@ -107,13 +109,45 @@
  * @typedef {Object} BlockCountParam
  * @property {number} blockCount - Number of recent blocks to include
  */
+/**
+ * Extended block data matching mempool.space /api/v1/blocks extras
+ *
+ * @typedef {Object} BlockExtras
+ * @property {Sats} totalFees - Total fees in satoshis
+ * @property {FeeRate} medianFee - Median fee rate in sat/vB
+ * @property {FeeRate[]} feeRange - Fee rate range: [min, 10%, 25%, 50%, 75%, 90%, max]
+ * @property {Sats} reward - Total block reward (subsidy + fees) in satoshis
+ * @property {BlockPool} pool - Mining pool that mined this block
+ * @property {Sats} avgFee - Average fee per transaction in satoshis
+ * @property {FeeRate} avgFeeRate - Average fee rate in sat/vB
+ * @property {string} coinbaseRaw - Raw coinbase transaction scriptsig as hex
+ * @property {?string=} coinbaseAddress - Primary coinbase output address
+ * @property {string[]} coinbaseAddresses - All coinbase output addresses
+ * @property {string} coinbaseSignature - Coinbase output script in ASM format
+ * @property {string} coinbaseSignatureAscii - Coinbase scriptsig decoded as ASCII
+ * @property {number} avgTxSize - Average transaction size in bytes
+ * @property {number} totalInputs - Total number of inputs (excluding coinbase)
+ * @property {number} totalOutputs - Total number of outputs
+ * @property {Sats} totalOutputAmt - Total output amount in satoshis
+ * @property {Sats} medianFeeAmt - Median fee amount in satoshis
+ * @property {Sats[]} feePercentiles - Fee amount percentiles in satoshis: [min, 10%, 25%, 50%, 75%, 90%, max]
+ * @property {number} segwitTotalTxs - Number of segwit transactions
+ * @property {number} segwitTotalSize - Total size of segwit transactions in bytes
+ * @property {Weight} segwitTotalWeight - Total weight of segwit transactions
+ * @property {string} header - Raw 80-byte block header as hex
+ * @property {number} utxoSetChange - UTXO set change (outputs created minus inputs spent)
+ * @property {number} utxoSetSize - Total UTXO set size at this height
+ * @property {Sats} totalInputAmt - Total input amount in satoshis
+ * @property {number} virtualSize - Virtual size in vbytes
+ */
 /**
  * A single block fees data point.
  *
  * @typedef {Object} BlockFeesEntry
- * @property {Height} avgHeight
- * @property {Timestamp} timestamp
- * @property {Sats} avgFees
+ * @property {Height} avgHeight - Average block height in this window
+ * @property {Timestamp} timestamp - Unix timestamp at the window midpoint
+ * @property {Sats} avgFees - Average fees per block in this window (sats)
+ * @property {Dollars} uSD - BTC/USD price at this height
  */
 /**
  * Block hash
@@ -135,39 +169,74 @@
  * @property {TxIndex} index - Transaction index within the block (0-based)
  */
 /**
- * Block information returned by the API
+ * Block information matching mempool.space /api/block/{hash}
  *
  * @typedef {Object} BlockInfo
  * @property {BlockHash} id - Block hash
  * @property {Height} height - Block height
- * @property {number} txCount - Number of transactions in the block
+ * @property {number} version - Block version
+ * @property {Timestamp} timestamp - Block timestamp (Unix time)
+ * @property {number} txCount - Number of transactions
  * @property {number} size - Block size in bytes
  * @property {Weight} weight - Block weight in weight units
+ * @property {string} merkleRoot - Merkle root of the transaction tree
+ * @property {BlockHash} previousblockhash - Previous block hash
+ * @property {Timestamp} mediantime - Median time of the last 11 blocks
+ * @property {number} nonce - Nonce
+ * @property {number} bits - Compact target (bits)
+ * @property {number} difficulty - Block difficulty
+ */
+/**
+ * Block information with extras, matching mempool.space /api/v1/blocks
+ *
+ * @typedef {Object} BlockInfoV1
+ * @property {BlockHash} id - Block hash
+ * @property {Height} height - Block height
+ * @property {number} version - Block version
  * @property {Timestamp} timestamp - Block timestamp (Unix time)
- * @property {number} difficulty - Block difficulty as a floating point number
+ * @property {number} txCount - Number of transactions
+ * @property {number} size - Block size in bytes
+ * @property {Weight} weight - Block weight in weight units
+ * @property {string} merkleRoot - Merkle root of the transaction tree
+ * @property {BlockHash} previousblockhash - Previous block hash
+ * @property {Timestamp} mediantime - Median time of the last 11 blocks
+ * @property {number} nonce - Nonce
+ * @property {number} bits - Compact target (bits)
+ * @property {number} difficulty - Block difficulty
+ * @property {BlockExtras} extras - Extended block data
+ */
+/**
+ * Mining pool identification for a block
+ *
+ * @typedef {Object} BlockPool
+ * @property {number} id - Unique pool identifier
+ * @property {string} name - Pool name
+ * @property {PoolSlug} slug - URL-friendly pool identifier
+ * @property {?string=} minerNames - Alternative miner names (if identified)
  */
 /**
  * A single block rewards data point.
  *
  * @typedef {Object} BlockRewardsEntry
- * @property {number} avgHeight
- * @property {number} timestamp
- * @property {number} avgRewards
+ * @property {Height} avgHeight - Average block height in this window
+ * @property {Timestamp} timestamp - Unix timestamp at the window midpoint
+ * @property {Sats} avgRewards - Average coinbase reward per block (subsidy + fees, sats)
+ * @property {Dollars} uSD - BTC/USD price at this height
  */
 /**
  * A single block size data point.
  *
  * @typedef {Object} BlockSizeEntry
- * @property {number} avgHeight
- * @property {number} timestamp
- * @property {number} avgSize
+ * @property {Height} avgHeight - Average block height in this window
+ * @property {Timestamp} timestamp - Unix timestamp at the window midpoint
+ * @property {number} avgSize - Rolling 24h median block size (bytes)
  */
 /**
  * Combined block sizes and weights response.
  *
  * @typedef {Object} BlockSizesWeights
- * @property {BlockSizeEntry[]} sizes
- * @property {BlockWeightEntry[]} weights
+ * @property {BlockSizeEntry[]} sizes - Block size data points
+ * @property {BlockWeightEntry[]} weights - Block weight data points
  */
 /**
  * Block status indicating whether block is in the best chain
@@ -175,7 +244,7 @@
  * @typedef {Object} BlockStatus
  * @property {boolean} inBestChain - Whether this block is in the best chain
  * @property {(Height|null)=} height - Block height (only if in best chain)
- * @property {(BlockHash|null)=} nextBest - Hash of the next block in the best chain (only if in best chain and not tip)
+ * @property {(BlockHash|null)=} nextBest - Hash of the next block in the best chain (null if tip)
  */
 /**
  * Block information returned for timestamp queries
@@ -189,9 +258,9 @@
  * A single block weight data point.
  *
  * @typedef {Object} BlockWeightEntry
- * @property {number} avgHeight
- * @property {number} timestamp
- * @property {number} avgWeight
+ * @property {Height} avgHeight - Average block height in this window
+ * @property {Timestamp} timestamp - Unix timestamp at the window midpoint
+ * @property {Weight} avgWeight - Rolling 24h median block weight (weight units)
  */
 /**
  * Unsigned cents (u64) - for values that should never be negative.
@@ -228,6 +297,17 @@
  *
  * @typedef {string} Cohort
  */
+/**
+ * Coinbase scriptSig tag for pool identification.
+ *
+ * Stored as a fixed 101-byte record (1 byte length + 100 bytes data).
+ * Uses `[u8; 101]` internally so that `size_of::<CoinbaseTag>()` matches
+ * the serialized `Bytes::Array` size (vecdb requires this for alignment).
+ *
+ * Bitcoin consensus limits coinbase scriptSig to 2-100 bytes.
+ *
+ * @typedef {string} CoinbaseTag
+ */
 /**
  * Bucket type for cost basis aggregation.
  * Options: raw (no aggregation), lin200/lin500/lin1000 (linear $200/$500/$1000),
@@ -261,6 +341,25 @@
  *
  * @typedef {("supply"|"realized"|"unrealized")} CostBasisValue
  */
+/**
+ * A transaction in a CPFP relationship
+ *
+ * @typedef {Object} CpfpEntry
+ * @property {Txid} txid - Transaction ID
+ * @property {Weight} weight - Transaction weight
+ * @property {Sats} fee - Transaction fee (sats)
+ */
+/**
+ * CPFP (Child Pays For Parent) information for a transaction
+ *
+ * @typedef {Object} CpfpInfo
+ * @property {CpfpEntry[]} ancestors - Ancestor transactions in the CPFP chain
+ * @property {(CpfpEntry|null)=} bestDescendant - Best (highest fee rate) descendant, if any
+ * @property {CpfpEntry[]} descendants - Descendant transactions in the CPFP chain
+ * @property {FeeRate} effectiveFeePerVsize - Effective fee rate considering CPFP relationships (sat/vB)
+ * @property {Sats} fee - Transaction fee (sats)
+ * @property {VSize} adjustedVsize - Adjusted virtual size (accounting for sigops)
+ */
 /**
  * Data range with output format for API query parameters
  *
@@ -293,32 +392,35 @@
  * @typedef {Object} DifficultyAdjustment
  * @property {number} progressPercent - Progress through current difficulty epoch (0-100%)
  * @property {number} difficultyChange - Estimated difficulty change at next retarget (%)
- * @property {number} estimatedRetargetDate - Estimated Unix timestamp of next retarget
+ * @property {number} estimatedRetargetDate - Estimated timestamp of next retarget (milliseconds)
  * @property {number} remainingBlocks - Blocks remaining until retarget
- * @property {number} remainingTime - Estimated seconds until retarget
+ * @property {number} remainingTime - Estimated time until retarget (milliseconds)
  * @property {number} previousRetarget - Previous difficulty adjustment (%)
+ * @property {Timestamp} previousTime - Timestamp of most recent retarget (seconds)
  * @property {Height} nextRetargetHeight - Height of next retarget
- * @property {number} timeAvg - Average block time in current epoch (seconds)
- * @property {number} adjustedTimeAvg - Time-adjusted average (accounting for timestamp manipulation)
+ * @property {number} timeAvg - Average block time in current epoch (milliseconds)
+ * @property {number} adjustedTimeAvg - Time-adjusted average (milliseconds)
  * @property {number} timeOffset - Time offset from expected schedule (seconds)
+ * @property {number} expectedBlocks - Expected blocks based on wall clock time since epoch start
  */
 /**
  * A single difficulty adjustment entry.
  * Serializes as array: [timestamp, height, difficulty, change_percent]
  *
  * @typedef {Object} DifficultyAdjustmentEntry
- * @property {Timestamp} timestamp
- * @property {Height} height
- * @property {number} difficulty
- * @property {number} changePercent
+ * @property {Timestamp} timestamp - Unix timestamp of the adjustment
+ * @property {Height} height - Block height of the adjustment
+ * @property {number} difficulty - Difficulty value
+ * @property {number} changePercent - Adjustment ratio (new/previous, e.g. 1.068 = +6.8%)
  */
 /**
- * A single difficulty data point.
+ * A single difficulty data point in the hashrate summary.
  *
  * @typedef {Object} DifficultyEntry
- * @property {Timestamp} timestamp - Unix timestamp of the difficulty adjustment.
- * @property {number} difficulty - Difficulty value.
- * @property {Height} height - Block height of the adjustment.
+ * @property {Timestamp} time - Unix timestamp of the difficulty adjustment
+ * @property {Height} height - Block height of the adjustment
+ * @property {number} difficulty - Difficulty value
+ * @property {number} adjustment - Adjustment ratio (new/previous, e.g. 1.068 = +6.8%)
  */
 /**
  * Disk usage of the indexed data
@@ -357,6 +459,11 @@
  * @property {string} message - Human-readable description
  * @property {string} docUrl - Link to API documentation
  */
+/**
+ * Exchange rates (USD base, on-chain only — no fiat pairs available)
+ *
+ * @typedef {Object} ExchangeRates
+ */
 /**
  * Fee rate in sats/vB
  *
@@ -401,10 +508,10 @@
  * Server health status
  *
  * @typedef {Object} Health
- * @property {string} status
- * @property {string} service
- * @property {string} version
- * @property {string} timestamp
+ * @property {string} status - Health status ("healthy")
+ * @property {string} service - Service name
+ * @property {string} version - Server version
+ * @property {string} timestamp - Current server time (ISO 8601)
  * @property {string} startedAt - Server start time (ISO 8601)
  * @property {number} uptimeSeconds - Uptime in seconds
  * @property {Height} indexedHeight - Height of the last indexed block
@@ -424,14 +531,23 @@
  * @property {Height} height
  */
 /**
- * Hex-encoded string
+ * Highest price value for a time period
  *
- * @typedef {string} Hex
+ * @typedef {Dollars} High
  */
 /**
- * Highest price value for a time period
+ * Historical price response
  *
- * @typedef {Dollars} High
+ * @typedef {Object} HistoricalPrice
+ * @property {HistoricalPriceEntry[]} prices - Price data points
+ * @property {ExchangeRates} exchangeRates - Exchange rates (currently empty)
+ */
+/**
+ * A single price data point
+ *
+ * @typedef {Object} HistoricalPriceEntry
+ * @property {number} time - Unix timestamp
+ * @property {Dollars} uSD - BTC/USD price
  */
 /** @typedef {number} Hour1 */
 /** @typedef {number} Hour12 */
@@ -484,12 +600,30 @@
  * @property {FeeRate[]} feeRange - Fee rate range: [min, 10%, 25%, 50%, 75%, 90%, max]
  */
 /**
- * Mempool statistics
+ * Mempool statistics with incrementally maintained fee histogram.
  *
  * @typedef {Object} MempoolInfo
  * @property {number} count - Number of transactions in the mempool
  * @property {VSize} vsize - Total virtual size of all transactions in the mempool (vbytes)
  * @property {Sats} totalFee - Total fees of all transactions in the mempool (satoshis)
+ * @property {{ [key: string]: VSize }} feeHistogram - Fee histogram: `[[fee_rate, vsize], ...]` sorted by descending fee rate
+ */
+/**
+ * Simplified mempool transaction for the `/api/mempool/recent` endpoint.
+ *
+ * @typedef {Object} MempoolRecentTx
+ * @property {Txid} txid - Transaction ID
+ * @property {Sats} fee - Transaction fee (sats)
+ * @property {VSize} vsize - Virtual size (vbytes)
+ * @property {Sats} value - Total output value (sats)
+ */
+/**
+ * Merkle inclusion proof for a transaction
+ *
+ * @typedef {Object} MerkleProof
+ * @property {Height} blockHeight - Block height containing the transaction
+ * @property {string[]} merkle - Merkle proof path (hex-encoded hashes)
+ * @property {number} pos - Transaction position in the block
  */
 /** @typedef {number} Minute10 */
 /** @typedef {number} Minute30 */
@@ -529,6 +663,10 @@
  *
  * @typedef {Dollars} Open
  */
+/**
+ * @typedef {Object} OptionalTimestampParam
+ * @property {(Timestamp|null)=} timestamp
+ */
 /** @typedef {number} OutPoint */
 /**
  * Type (P2PKH, P2WPKH, P2SH, P2TR, etc.)
@@ -600,12 +738,22 @@
  * Pool information for detail view
  *
  * @typedef {Object} PoolDetailInfo
- * @property {number} id - Unique pool identifier
+ * @property {number} id - Pool identifier
  * @property {string} name - Pool name
  * @property {string} link - Pool website URL
- * @property {string[]} addrs - Known payout addresses
+ * @property {string[]} addresses - Known payout addresses
  * @property {string[]} regexes - Coinbase tag patterns (regexes)
  * @property {PoolSlug} slug - URL-friendly pool identifier
+ * @property {number} uniqueId - Unique pool identifier
+ */
+/**
+ * A single pool hashrate data point.
+ *
+ * @typedef {Object} PoolHashrateEntry
+ * @property {Timestamp} timestamp - Unix timestamp.
+ * @property {number} avgHashrate - Average hashrate (H/s).
+ * @property {number} share - Pool's share of total network hashrate.
+ * @property {string} poolName - Pool name.
  */
 /**
  * Basic pool information for listing all pools
@@ -615,7 +763,12 @@
  * @property {PoolSlug} slug - URL-friendly pool identifier
  * @property {number} uniqueId - Unique numeric pool identifier
  */
-/** @typedef {("unknown"|"blockfills"|"ultimuspool"|"terrapool"|"luxor"|"onethash"|"btccom"|"bitfarms"|"huobipool"|"wayicn"|"canoepool"|"btctop"|"bitcoincom"|"pool175btc"|"gbminers"|"axbt"|"asicminer"|"bitminter"|"bitcoinrussia"|"btcserv"|"simplecoinus"|"btcguild"|"eligius"|"ozcoin"|"eclipsemc"|"maxbtc"|"triplemining"|"coinlab"|"pool50btc"|"ghashio"|"stminingcorp"|"bitparking"|"mmpool"|"polmine"|"kncminer"|"bitalo"|"f2pool"|"hhtt"|"megabigpower"|"mtred"|"nmcbit"|"yourbtcnet"|"givemecoins"|"braiinspool"|"antpool"|"multicoinco"|"bcpoolio"|"cointerra"|"kanopool"|"solock"|"ckpool"|"nicehash"|"bitclub"|"bitcoinaffiliatenetwork"|"btcc"|"bwpool"|"exxbw"|"bitsolo"|"bitfury"|"twentyoneinc"|"digitalbtc"|"eightbaochi"|"mybtccoinpool"|"tbdice"|"hashpool"|"nexious"|"bravomining"|"hotpool"|"okexpool"|"bcmonster"|"onehash"|"bixin"|"tatmaspool"|"viabtc"|"connectbtc"|"batpool"|"waterhole"|"dcexploration"|"dcex"|"btpool"|"fiftyeightcoin"|"bitcoinindia"|"shawnp0wers"|"phashio"|"rigpool"|"haozhuzhu"|"sevenpool"|"miningkings"|"hashbx"|"dpool"|"rawpool"|"haominer"|"helix"|"bitcoinukraine"|"poolin"|"secretsuperstar"|"tigerpoolnet"|"sigmapoolcom"|"okpooltop"|"hummerpool"|"tangpool"|"bytepool"|"spiderpool"|"novablock"|"miningcity"|"binancepool"|"minerium"|"lubiancom"|"okkong"|"aaopool"|"emcdpool"|"foundryusa"|"sbicrypto"|"arkpool"|"purebtccom"|"marapool"|"kucoinpool"|"entrustcharitypool"|"okminer"|"titan"|"pegapool"|"btcnuggets"|"cloudhashing"|"digitalxmintsy"|"telco214"|"btcpoolparty"|"multipool"|"transactioncoinmining"|"btcdig"|"trickysbtcpool"|"btcmp"|"eobot"|"unomp"|"patels"|"gogreenlight"|"bitcoinindiapool"|"ekanembtc"|"canoe"|"tiger"|"onem1x"|"zulupool"|"secpool"|"ocean"|"whitepool"|"wiz"|"wk057"|"futurebitapollosolo"|"carbonnegative"|"portlandhodl"|"phoenix"|"neopool"|"maxipool"|"bitfufupool"|"gdpool"|"miningdutch"|"publicpool"|"miningsquared"|"innopolistech"|"btclab"|"parasite"|"redrockpool"|"est3lar")} PoolSlug */
+/** @typedef {("unknown"|"blockfills"|"ultimuspool"|"terrapool"|"luxor"|"onethash"|"btccom"|"bitfarms"|"huobipool"|"wayicn"|"canoepool"|"btctop"|"bitcoincom"|"pool175btc"|"gbminers"|"axbt"|"asicminer"|"bitminter"|"bitcoinrussia"|"btcserv"|"simplecoinus"|"btcguild"|"eligius"|"ozcoin"|"eclipsemc"|"maxbtc"|"triplemining"|"coinlab"|"pool50btc"|"ghashio"|"stminingcorp"|"bitparking"|"mmpool"|"polmine"|"kncminer"|"bitalo"|"f2pool"|"hhtt"|"megabigpower"|"mtred"|"nmcbit"|"yourbtcnet"|"givemecoins"|"braiinspool"|"antpool"|"multicoinco"|"bcpoolio"|"cointerra"|"kanopool"|"solock"|"ckpool"|"nicehash"|"bitclub"|"bitcoinaffiliatenetwork"|"btcc"|"bwpool"|"exxbw"|"bitsolo"|"bitfury"|"twentyoneinc"|"digitalbtc"|"eightbaochi"|"mybtccoinpool"|"tbdice"|"hashpool"|"nexious"|"bravomining"|"hotpool"|"okexpool"|"bcmonster"|"onehash"|"bixin"|"tatmaspool"|"viabtc"|"connectbtc"|"batpool"|"waterhole"|"dcexploration"|"dcex"|"btpool"|"fiftyeightcoin"|"bitcoinindia"|"shawnp0wers"|"phashio"|"rigpool"|"haozhuzhu"|"sevenpool"|"miningkings"|"hashbx"|"dpool"|"rawpool"|"haominer"|"helix"|"bitcoinukraine"|"poolin"|"secretsuperstar"|"tigerpoolnet"|"sigmapoolcom"|"okpooltop"|"hummerpool"|"tangpool"|"bytepool"|"spiderpool"|"novablock"|"miningcity"|"binancepool"|"minerium"|"lubiancom"|"okkong"|"aaopool"|"emcdpool"|"foundryusa"|"sbicrypto"|"arkpool"|"purebtccom"|"marapool"|"kucoinpool"|"entrustcharitypool"|"okminer"|"titan"|"pegapool"|"btcnuggets"|"cloudhashing"|"digitalxmintsy"|"telco214"|"btcpoolparty"|"multipool"|"transactioncoinmining"|"btcdig"|"trickysbtcpool"|"btcmp"|"eobot"|"unomp"|"patels"|"gogreenlight"|"bitcoinindiapool"|"ekanembtc"|"canoe"|"tiger"|"onem1x"|"zulupool"|"secpool"|"ocean"|"whitepool"|"wiz"|"wk057"|"futurebitapollosolo"|"carbonnegative"|"portlandhodl"|"phoenix"|"neopool"|"maxipool"|"bitfufupool"|"gdpool"|"miningdutch"|"publicpool"|"miningsquared"|"innopolistech"|"btclab"|"parasite"|"redrockpool"|"est3lar"|"braiinssolo"|"solopool")} PoolSlug */
+/**
+ * @typedef {Object} PoolSlugAndHeightParam
+ * @property {PoolSlug} slug
+ * @property {Height} height
+ */
 /**
  * @typedef {Object} PoolSlugParam
  * @property {PoolSlug} slug
@@ -632,6 +785,7 @@
  * @property {number} emptyBlocks - Number of empty blocks mined
  * @property {PoolSlug} slug - URL-friendly pool identifier
  * @property {number} share - Pool's share of total blocks (0.0 - 1.0)
+ * @property {number} poolUniqueId - Unique pool identifier
  */
 /**
  * Mining pools response for a time period
@@ -640,6 +794,15 @@
  * @property {PoolStats[]} pools - List of pools sorted by block count descending
  * @property {number} blockCount - Total blocks in the time period
  * @property {number} lastEstimatedHashrate - Estimated network hashrate (hashes per second)
+ * @property {number} lastEstimatedHashrate3d - Estimated network hashrate over last 3 days
+ * @property {number} lastEstimatedHashrate1w - Estimated network hashrate over last 1 week
+ */
+/**
+ * Current price response matching mempool.space /api/v1/prices format
+ *
+ * @typedef {Object} Prices
+ * @property {Timestamp} time - Unix timestamp
+ * @property {Dollars} uSD - BTC/USD price
  */
 /**
  * A range boundary: integer index, date, or timestamp.
@@ -667,9 +830,9 @@
  * @typedef {Object} RewardStats
  * @property {Height} startBlock - First block in the range
  * @property {Height} endBlock - Last block in the range
- * @property {Sats} totalReward
- * @property {Sats} totalFee
- * @property {number} totalTx
+ * @property {Sats} totalReward - Total coinbase rewards (subsidy + fees) in sats
+ * @property {Sats} totalFee - Total transaction fees in sats
+ * @property {number} totalTx - Total number of transactions
  */
 /**
  * Satoshis
@@ -836,17 +999,17 @@
  * Transaction information compatible with mempool.space API format
  *
  * @typedef {Object} Transaction
- * @property {(TxIndex|null)=} index
- * @property {Txid} txid
- * @property {TxVersion} version
- * @property {RawLockTime} locktime
+ * @property {(TxIndex|null)=} index - Internal transaction index (brk-specific, not in mempool.space)
+ * @property {Txid} txid - Transaction ID
+ * @property {TxVersion} version - Transaction version
+ * @property {RawLockTime} locktime - Transaction lock time
+ * @property {TxIn[]} vin - Transaction inputs
+ * @property {TxOut[]} vout - Transaction outputs
  * @property {number} size - Transaction size in bytes
  * @property {Weight} weight - Transaction weight
  * @property {number} sigops - Number of signature operations
  * @property {Sats} fee - Transaction fee in satoshis
- * @property {TxIn[]} vin - Transaction inputs
- * @property {TxOut[]} vout - Transaction outputs
- * @property {TxStatus} status
+ * @property {TxStatus} status - Confirmation status (confirmed, block height/hash/time)
  */
 /**
  * Hierarchical tree node for organizing series into categories
@@ -858,13 +1021,15 @@
  *
  * @typedef {Object} TxIn
  * @property {Txid} txid - Transaction ID of the output being spent
- * @property {Vout} vout
+ * @property {Vout} vout - Output index being spent
  * @property {(TxOut|null)=} prevout - Information about the previous output being spent
- * @property {string} scriptsig - Signature script (for non-SegWit inputs)
+ * @property {string} scriptsig - Signature script (hex, for non-SegWit inputs)
  * @property {string} scriptsigAsm - Signature script in assembly format
+ * @property {string[]} witness - Witness data (hex-encoded stack items, present for SegWit inputs)
  * @property {boolean} isCoinbase - Whether this input is a coinbase (block reward) input
  * @property {number} sequence - Input sequence number
- * @property {?string=} innerRedeemscriptAsm - Inner redeemscript in assembly format (for P2SH-wrapped SegWit)
+ * @property {string} innerRedeemscriptAsm - Inner redeemscript in assembly (for P2SH-wrapped SegWit: scriptsig + witness both present)
+ * @property {string} innerWitnessscriptAsm - Inner witnessscript in assembly (for P2WSH: last witness item decoded as script)
  */
 /** @typedef {number} TxInIndex */
 /** @typedef {number} TxIndex */
@@ -930,10 +1095,10 @@
  * Unspent transaction output
  *
  * @typedef {Object} Utxo
- * @property {Txid} txid
- * @property {Vout} vout
- * @property {TxStatus} status
- * @property {Sats} value
+ * @property {Txid} txid - Transaction ID of the UTXO
+ * @property {Vout} vout - Output index
+ * @property {TxStatus} status - Confirmation status
+ * @property {Sats} value - Output value in satoshis
  */
 /**
  * Virtual size in vbytes (weight / 4, rounded up)
@@ -982,6 +1147,20 @@
 const _isBrowser = typeof window !== 'undefined' && 'caches' in window;
 const _runIdle = (/** @type {VoidFunction} */ fn) => (globalThis.requestIdleCallback ?? setTimeout)(fn);
 const _defaultCacheName = '__BRK_CLIENT__';
+/** @param {*} v */
+const _addCamelGetters = (v) => {
+  if (Array.isArray(v)) { v.forEach(_addCamelGetters); return v; }
+  if (v && typeof v === 'object' && v.constructor === Object) {
+    for (const k in v) {
+      if (k.includes('_')) {
+        const c = k.replace(/_([a-z])/g, (_, l) => l.toUpperCase());
+        if (!(c in v)) Object.defineProperty(v, c, { get() { return this[k]; } });
+      }
+      _addCamelGetters(v[k]);
+    }
+  }
+  return v;
+};
 
 /**
  * @param {string|boolean|undefined} cache
@@ -1378,7 +1557,7 @@ class BrkClientBase {
     const cachePromise = cache?.match(url).then(async (res) => {
       cachedRes = res ?? null;
       if (!res) return null;
-      const json = await res.json();
+      const json = _addCamelGetters(await res.json());
       if (!resolved && onUpdate) {
         resolved = true;
         onUpdate(json);
@@ -1388,7 +1567,7 @@ class BrkClientBase {
 
     const networkPromise = this.get(path).then(async (res) => {
       const cloned = res.clone();
-      const json = await res.json();
+      const json = _addCamelGetters(await res.json());
       // Skip update if ETag matches and cache already delivered
       if (cachedRes?.headers.get('ETag') === res.headers.get('ETag')) {
         if (!resolved && onUpdate) {
@@ -4145,7 +4324,6 @@ function createTransferPattern(client, acc) {
  * @property {SeriesTree_Addrs} addrs
  * @property {SeriesTree_Scripts} scripts
  * @property {SeriesTree_Mining} mining
- * @property {SeriesTree_Positions} positions
  * @property {SeriesTree_Cointime} cointime
  * @property {SeriesTree_Constants} constants
  * @property {SeriesTree_Indexes} indexes
@@ -4161,10 +4339,14 @@ function createTransferPattern(client, acc) {
 /**
  * @typedef {Object} SeriesTree_Blocks
  * @property {SeriesPattern18<BlockHash>} blockhash
+ * @property {SeriesPattern18<CoinbaseTag>} coinbaseTag
  * @property {SeriesTree_Blocks_Difficulty} difficulty
  * @property {SeriesTree_Blocks_Time} time
  * @property {SeriesTree_Blocks_Size} size
  * @property {AverageBaseCumulativeMaxMedianMinPct10Pct25Pct75Pct90SumPattern<Weight>} weight
+ * @property {SeriesPattern18<StoredU32>} segwitTxs
+ * @property {SeriesPattern18<StoredU64>} segwitSize
+ * @property {SeriesPattern18<Weight>} segwitWeight
  * @property {SeriesTree_Blocks_Count} count
  * @property {SeriesTree_Blocks_Lookback} lookback
  * @property {SeriesTree_Blocks_Interval} interval
@@ -4328,6 +4510,7 @@ function createTransferPattern(client, acc) {
  * @property {SeriesPattern19<Sats>} outputValue
  * @property {_6bBlockTxPattern<Sats>} fee
  * @property {_6bBlockTxPattern<FeeRate>} feeRate
+ * @property {_6bBlockTxPattern<FeeRate>} effectiveFeeRate
  */
 
 /**
@@ -4597,6 +4780,7 @@ function createTransferPattern(client, acc) {
  * @property {AverageBlockCumulativeSumPattern3} coinbase
  * @property {SeriesTree_Mining_Rewards_Subsidy} subsidy
  * @property {SeriesTree_Mining_Rewards_Fees} fees
+ * @property {SeriesPattern18<Sats>} outputVolume
  * @property {BlockCumulativePattern} unclaimed
  */
 
@@ -4657,10 +4841,6 @@ function createTransferPattern(client, acc) {
  * @property {SeriesPattern1<StoredF64>} _1y
  */
 
-/**
- * @typedef {Object} SeriesTree_Positions
- */
-
 /**
  * @typedef {Object} SeriesTree_Cointime
  * @property {SeriesTree_Cointime_Activity} activity
@@ -5518,6 +5698,8 @@ function createTransferPattern(client, acc) {
  * @property {BlocksDominancePattern} parasite
  * @property {BlocksDominancePattern} redrockpool
  * @property {BlocksDominancePattern} est3lar
+ * @property {BlocksDominancePattern} braiinssolo
+ * @property {BlocksDominancePattern} solopool
  */
 
 /**
@@ -6381,7 +6563,7 @@ function createTransferPattern(client, acc) {
  * @extends BrkClientBase
  */
 class BrkClient extends BrkClientBase {
-  VERSION = "v0.2.5";
+  VERSION = "v0.3.0-alpha.1";
 
   INDEXES = /** @type {const} */ ([
     "minute10",
@@ -6581,7 +6763,9 @@ class BrkClient extends BrkClientBase {
     "btclab": "BTCLab",
     "parasite": "Parasite",
     "redrockpool": "RedRock Pool",
-    "est3lar": "Est3lar"
+    "est3lar": "Est3lar",
+    "braiinssolo": "Braiins Solo",
+    "solopool": "SoloPool.com"
   });
 
   TERM_NAMES = /** @type {const} */ ({
@@ -7572,6 +7756,7 @@ class BrkClient extends BrkClientBase {
     return {
       blocks: {
         blockhash: createSeriesPattern18(this, 'blockhash'),
+        coinbaseTag: createSeriesPattern18(this, 'coinbase_tag'),
         difficulty: {
           value: createSeriesPattern1(this, 'difficulty'),
           hashrate: createSeriesPattern1(this, 'difficulty_hashrate'),
@@ -7597,6 +7782,9 @@ class BrkClient extends BrkClientBase {
           pct90: create_1m1w1y24hPattern(this, 'block_size_pct90'),
         },
         weight: createAverageBaseCumulativeMaxMedianMinPct10Pct25Pct75Pct90SumPattern(this, 'block_weight'),
+        segwitTxs: createSeriesPattern18(this, 'segwit_txs'),
+        segwitSize: createSeriesPattern18(this, 'segwit_size'),
+        segwitWeight: createSeriesPattern18(this, 'segwit_weight'),
         count: {
           target: create_1m1w1y24hPattern(this, 'block_count_target'),
           total: createAverageBlockCumulativeSumPattern2(this, 'block_count'),
@@ -7695,6 +7883,7 @@ class BrkClient extends BrkClientBase {
           outputValue: createSeriesPattern19(this, 'output_value'),
           fee: create_6bBlockTxPattern(this, 'fee'),
           feeRate: create_6bBlockTxPattern(this, 'fee_rate'),
+          effectiveFeeRate: create_6bBlockTxPattern(this, 'effective_fee_rate'),
         },
         versions: {
           v1: createAverageBlockCumulativeSumPattern(this, 'tx_v1'),
@@ -7893,6 +8082,7 @@ class BrkClient extends BrkClientBase {
               _1y: createBpsRatioPattern2(this, 'fee_to_subsidy_ratio_1y'),
             },
           },
+          outputVolume: createSeriesPattern18(this, 'output_volume'),
           unclaimed: createBlockCumulativePattern(this, 'unclaimed_rewards'),
         },
         hashrate: {
@@ -7911,8 +8101,6 @@ class BrkClient extends BrkClientBase {
           value: createPhsReboundThsPattern(this, 'hash_value'),
         },
       },
-      positions: {
-      },
       cointime: {
         activity: {
           coinblocksCreated: createAverageBlockCumulativeSumPattern(this, 'coinblocks_created'),
@@ -8543,6 +8731,8 @@ class BrkClient extends BrkClientBase {
           parasite: createBlocksDominancePattern(this, 'parasite'),
           redrockpool: createBlocksDominancePattern(this, 'redrockpool'),
           est3lar: createBlocksDominancePattern(this, 'est3lar'),
+          braiinssolo: createBlocksDominancePattern(this, 'braiinssolo'),
+          solopool: createBlocksDominancePattern(this, 'solopool'),
         },
       },
       prices: {
@@ -9338,16 +9528,16 @@ class BrkClient extends BrkClientBase {
   }
 
   /**
-   * Block by height
+   * Block hash by height
    *
-   * Retrieve block information by block height. Returns block metadata including hash, timestamp, difficulty, size, weight, and transaction count.
+   * 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}`
    *
    * @param {Height} height
-   * @returns {Promise<BlockInfo>}
+   * @returns {Promise<*>}
    */
   async getBlockByHeight(height) {
     return this.getJson(`/api/block-height/${height}`);
@@ -9369,6 +9559,22 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/block/${hash}`);
   }
 
+  /**
+   * Block header
+   *
+   * Returns the hex-encoded block header.
+   *
+   * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-header)*
+   *
+   * Endpoint: `GET /api/block/{hash}/header`
+   *
+   * @param {BlockHash} hash
+   * @returns {Promise<*>}
+   */
+  async getBlockHeader(hash) {
+    return this.getJson(`/api/block/${hash}/header`);
+  }
+
   /**
    * Raw block
    *
@@ -9412,7 +9618,7 @@ class BrkClient extends BrkClientBase {
    *
    * @param {BlockHash} hash - Bitcoin block hash
    * @param {TxIndex} index - Transaction index within the block (0-based)
-   * @returns {Promise<Txid>}
+   * @returns {Promise<*>}
    */
   async getBlockTxid(hash, index) {
     return this.getJson(`/api/block/${hash}/txid/${index}`);
@@ -9434,6 +9640,22 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/block/${hash}/txids`);
   }
 
+  /**
+   * 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`
+   *
+   * @param {BlockHash} hash
+   * @returns {Promise<Transaction[]>}
+   */
+  async getBlockTxs(hash) {
+    return this.getJson(`/api/block/${hash}/txs`);
+  }
+
   /**
    * Block transactions (paginated)
    *
@@ -9447,7 +9669,7 @@ class BrkClient extends BrkClientBase {
    * @param {TxIndex} start_index - Starting transaction index within the block (0-based)
    * @returns {Promise<Transaction[]>}
    */
-  async getBlockTxs(hash, start_index) {
+  async getBlockTxsFromIndex(hash, start_index) {
     return this.getJson(`/api/block/${hash}/txs/${start_index}`);
   }
 
@@ -9465,6 +9687,34 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/blocks`);
   }
 
+  /**
+   * 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`
+   * @returns {Promise<*>}
+   */
+  async getBlockTipHash() {
+    return this.getJson(`/api/blocks/tip/hash`);
+  }
+
+  /**
+   * 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`
+   * @returns {Promise<*>}
+   */
+  async getBlockTipHeight() {
+    return this.getJson(`/api/blocks/tip/height`);
+  }
+
   /**
    * Blocks from height
    *
@@ -9484,15 +9734,15 @@ class BrkClient extends BrkClientBase {
   /**
    * Mempool statistics
    *
-   * Get current mempool statistics including transaction count, total vsize, and total fees.
+   * 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/info`
+   * Endpoint: `GET /api/mempool`
    * @returns {Promise<MempoolInfo>}
    */
   async getMempool() {
-    return this.getJson(`/api/mempool/info`);
+    return this.getJson(`/api/mempool`);
   }
 
   /**
@@ -9507,6 +9757,20 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/mempool/price`);
   }
 
+  /**
+   * 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`
+   * @returns {Promise<MempoolRecentTx[]>}
+   */
+  async getMempoolRecent() {
+    return this.getJson(`/api/mempool/recent`);
+  }
+
   /**
    * Mempool transaction IDs
    *
@@ -9847,12 +10111,44 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}/hex`
    *
    * @param {Txid} txid
-   * @returns {Promise<Hex>}
+   * @returns {Promise<*>}
    */
   async getTxHex(txid) {
     return this.getJson(`/api/tx/${txid}/hex`);
   }
 
+  /**
+   * 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`
+   *
+   * @param {Txid} txid
+   * @returns {Promise<MerkleProof>}
+   */
+  async getTxMerkleProof(txid) {
+    return this.getJson(`/api/tx/${txid}/merkle-proof`);
+  }
+
+  /**
+   * 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`
+   *
+   * @param {Txid} txid
+   * @returns {Promise<*>}
+   */
+  async getTxMerkleblockProof(txid) {
+    return this.getJson(`/api/tx/${txid}/merkleblock-proof`);
+  }
+
   /**
    * Output spend status
    *
@@ -9886,6 +10182,22 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/tx/${txid}/outspends`);
   }
 
+  /**
+   * 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`
+   *
+   * @param {Txid} txid
+   * @returns {Promise<number[]>}
+   */
+  async getTxRaw(txid) {
+    return this.getJson(`/api/tx/${txid}/raw`);
+  }
+
   /**
    * Transaction status
    *
@@ -9902,10 +10214,72 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/tx/${txid}/status`);
   }
 
+  /**
+   * 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}`
+   *
+   * @param {BlockHash} hash
+   * @returns {Promise<BlockInfoV1>}
+   */
+  async getBlockV1(hash) {
+    return this.getJson(`/api/v1/block/${hash}`);
+  }
+
+  /**
+   * 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`
+   * @returns {Promise<BlockInfoV1[]>}
+   */
+  async getBlocksV1() {
+    return this.getJson(`/api/v1/blocks`);
+  }
+
+  /**
+   * 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}`
+   *
+   * @param {Height} height
+   * @returns {Promise<BlockInfoV1[]>}
+   */
+  async getBlocksV1FromHeight(height) {
+    return this.getJson(`/api/v1/blocks/${height}`);
+  }
+
+  /**
+   * CPFP info
+   *
+   * Returns ancestors and descendants for a CPFP transaction.
+   *
+   * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-children-pay-for-parent)*
+   *
+   * Endpoint: `GET /api/v1/cpfp/{txid}`
+   *
+   * @param {Txid} txid
+   * @returns {Promise<CpfpInfo>}
+   */
+  async getCpfp(txid) {
+    return this.getJson(`/api/v1/cpfp/${txid}`);
+  }
+
   /**
    * Difficulty adjustment
    *
-   * Get current difficulty adjustment information including progress through the current epoch, estimated retarget date, and difficulty change prediction.
+   * Get current difficulty adjustment progress and estimates.
    *
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-difficulty-adjustment)*
    *
@@ -9919,7 +10293,7 @@ class BrkClient extends BrkClientBase {
   /**
    * Projected mempool blocks
    *
-   * Get projected blocks from the mempool for fee estimation. Each block contains statistics about transactions that would be included if a block were mined now.
+   * Get projected blocks from the mempool for fee estimation.
    *
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool-blocks-fees)*
    *
@@ -9930,10 +10304,24 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/v1/fees/mempool-blocks`);
   }
 
+  /**
+   * 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`
+   * @returns {Promise<RecommendedFees>}
+   */
+  async getPreciseFees() {
+    return this.getJson(`/api/v1/fees/precise`);
+  }
+
   /**
    * Recommended fees
    *
-   * Get recommended fee rates for different confirmation targets based on current mempool state.
+   * Get recommended fee rates for different confirmation targets.
    *
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-recommended-fees)*
    *
@@ -9944,6 +10332,26 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/v1/fees/recommended`);
   }
 
+  /**
+   * 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`
+   *
+   * @param {Timestamp=} [timestamp]
+   * @returns {Promise<HistoricalPrice>}
+   */
+  async getHistoricalPrice(timestamp) {
+    const params = new URLSearchParams();
+    if (timestamp !== undefined) params.set('timestamp', String(timestamp));
+    const query = params.toString();
+    const path = `/api/v1/historical-price${query ? '?' + query : ''}`;
+    return this.getJson(path);
+  }
+
   /**
    * Block fee rates (WIP)
    *
@@ -10068,6 +10476,36 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/v1/mining/hashrate`);
   }
 
+  /**
+   * 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`
+   * @returns {Promise<PoolHashrateEntry[]>}
+   */
+  async getPoolsHashrate() {
+    return this.getJson(`/api/v1/mining/hashrate/pools`);
+  }
+
+  /**
+   * 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}`
+   *
+   * @param {TimePeriod} time_period
+   * @returns {Promise<PoolHashrateEntry[]>}
+   */
+  async getPoolsHashrateByPeriod(time_period) {
+    return this.getJson(`/api/v1/mining/hashrate/pools/${time_period}`);
+  }
+
   /**
    * Network hashrate
    *
@@ -10100,6 +10538,55 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/v1/mining/pool/${slug}`);
   }
 
+  /**
+   * 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`
+   *
+   * @param {PoolSlug} slug
+   * @returns {Promise<BlockInfoV1[]>}
+   */
+  async getPoolBlocks(slug) {
+    return this.getJson(`/api/v1/mining/pool/${slug}/blocks`);
+  }
+
+  /**
+   * 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}`
+   *
+   * @param {PoolSlug} slug
+   * @param {Height} height
+   * @returns {Promise<BlockInfoV1[]>}
+   */
+  async getPoolBlocksFrom(slug, height) {
+    return this.getJson(`/api/v1/mining/pool/${slug}/blocks/${height}`);
+  }
+
+  /**
+   * 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`
+   *
+   * @param {PoolSlug} slug
+   * @returns {Promise<PoolHashrateEntry[]>}
+   */
+  async getPoolHashrate(slug) {
+    return this.getJson(`/api/v1/mining/pool/${slug}/hashrate`);
+  }
+
   /**
    * List all mining pools
    *
@@ -10146,6 +10633,34 @@ class BrkClient extends BrkClientBase {
     return this.getJson(`/api/v1/mining/reward-stats/${block_count}`);
   }
 
+  /**
+   * 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`
+   * @returns {Promise<Prices>}
+   */
+  async getPrices() {
+    return this.getJson(`/api/v1/prices`);
+  }
+
+  /**
+   * 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`
+   * @returns {Promise<number[]>}
+   */
+  async getTransactionTimes() {
+    return this.getJson(`/api/v1/transaction-times`);
+  }
+
   /**
    * Validate address
    *

package/package.json

@@ -40,5 +40,5 @@
     "url": "git+https://github.com/bitcoinresearchkit/brk.git"
   },
   "type": "module",
-  "version": "0.2.5"
+  "version": "0.3.0-alpha.1"
 }