brk-client 0.3.0-beta.5 → 0.3.0-beta.7

package/index.js

@@ -379,7 +379,7 @@ Matches mempool.space/bitcoin-cli behavior.
  * @property {(VSize|null)=} adjustedVsize - Adjusted virtual size (accounting for sigops)
  */
 /**
- * Data range with output format for API query parameters
+ * Range parameters with output format for API query parameters.
  *
  * @typedef {Object} DataRangeFormat
  * @property {(RangeIndex|null)=} start - Inclusive start: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `from`, `f`, `s`
@@ -789,7 +789,7 @@ Matches mempool.space/bitcoin-cli behavior.
 /**
  * URL-friendly mining 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"|"braiinssolo"|"solopool")} 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"|"noderunners")} PoolSlug
  */
 /**
  * Mining pool slug + block height path parameters
@@ -845,6 +845,31 @@ Matches mempool.space/bitcoin-cli behavior.
  *
  * @typedef {number} RawLockTime
  */
+/**
+ * Response body for `GET /api/v1/tx/:txid/rbf`. Both fields are null
+ * when the tx has no known RBF history within the mempool monitor's
+ * graveyard retention window.
+ *
+ * @typedef {Object} RbfResponse
+ * @property {(ReplacementNode|null)=} replacements
+ * @property {?Txid[]=} replaces
+ */
+/**
+ * Transaction summary carried inside an RBF replacement node. Shape
+ * matches mempool.space's `/api/v1/tx/:txid/rbf` and
+ * `/api/v1/replacements` responses.
+ *
+ * @typedef {Object} RbfTx
+ * @property {Txid} txid
+ * @property {Sats} fee
+ * @property {VSize} vsize
+ * @property {Sats} value - Sum of output amounts.
+ * @property {FeeRate} rate
+ * @property {Timestamp} time
+ * @property {boolean} rbf - BIP-125 signaling: at least one input has sequence < 0xffffffff-1.
+ * @property {?boolean=} fullRbf - Only populated on the root `tx` of an RBF response. `true` iff
+this tx displaced at least one non-signaling predecessor.
+ */
 /**
  * Recommended fee rates in sat/vB
  *
@@ -855,6 +880,19 @@ Matches mempool.space/bitcoin-cli behavior.
  * @property {FeeRate} economyFee - Fee rate for economical confirmation
  * @property {FeeRate} minimumFee - Minimum relay fee rate
  */
+/**
+ * One node in an RBF replacement tree. The node's `tx` replaced each
+ * entry in `replaces`, recursively.
+ *
+ * @typedef {Object} ReplacementNode
+ * @property {RbfTx} tx
+ * @property {Timestamp} time - First-seen timestamp, duplicated here to match mempool.space's
+on-the-wire shape.
+ * @property {boolean} fullRbf - Any predecessor in this subtree was non-signaling.
+ * @property {?number=} interval - Seconds between this node's `time` and the successor that
+replaced it. Omitted on the root of an RBF response.
+ * @property {ReplacementNode[]} replaces
+ */
 /**
  * Block reward statistics over a range of blocks
  *
@@ -1060,7 +1098,7 @@ Matches mempool.space/bitcoin-cli behavior.
  * @property {(TxOut|null)=} prevout - Information about the previous output being spent
  * @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 {Witness} witness - Witness data (stack items, present for SegWit inputs; hex-encoded on the wire)
  * @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 (for P2SH-wrapped SegWit: scriptsig + witness both present)
@@ -1240,6 +1278,17 @@ Matches mempool.space/bitcoin-cli behavior.
  *
  * @typedef {number} Weight
  */
+/**
+ * Transaction witness: a stack of byte arrays, one per witness item.
+ *
+ * Wraps `bitcoin::Witness` (single-buffer layout with offsets, much
+ * more compact than `Vec<Vec<u8>>`). Serializes as a JSON array of
+ * hex strings - the format used by Bitcoin Core REST and mempool.space
+ * and matching brk's `script_sig: ScriptBuf` (bytes internally, hex
+ * on the wire).
+ *
+ * @typedef {string[]} Witness
+ */
 /** @typedef {number} Year1 */
 /** @typedef {number} Year10 */
 
@@ -6365,6 +6414,7 @@ function createTransferPattern(client, acc) {
  * @property {BlocksDominancePattern} est3lar
  * @property {BlocksDominancePattern} braiinssolo
  * @property {BlocksDominancePattern} solopool
+ * @property {BlocksDominancePattern} noderunners
  */
 
 /**
@@ -7222,7 +7272,7 @@ function createTransferPattern(client, acc) {
  * @extends BrkClientBase
  */
 class BrkClient extends BrkClientBase {
-  VERSION = "v0.3.0-beta.5";
+  VERSION = "v0.3.0-beta.7";
 
   INDEXES = /** @type {const} */ ([
     "minute10",
@@ -7424,7 +7474,8 @@ class BrkClient extends BrkClientBase {
     "redrockpool": "RedRock Pool",
     "est3lar": "Est3lar",
     "braiinssolo": "Braiins Solo",
-    "solopool": "SoloPool.com"
+    "solopool": "SoloPool.com",
+    "noderunners": "Noderunners"
   });
 
   TERM_NAMES = /** @type {const} */ ({
@@ -9501,6 +9552,7 @@ class BrkClient extends BrkClientBase {
           est3lar: createBlocksDominancePattern(this, 'est3lar'),
           braiinssolo: createBlocksDominancePattern(this, 'braiinssolo'),
           solopool: createBlocksDominancePattern(this, 'solopool'),
+          noderunners: createBlocksDominancePattern(this, 'noderunners'),
         },
       },
       prices: {
@@ -11599,6 +11651,24 @@ class BrkClient extends BrkClientBase {
     return this.getJson(path, { signal, onUpdate });
   }
 
+  /**
+   * RBF replacement history
+   *
+   * Returns the RBF replacement tree for a transaction, if any. Both `replacements` and `replaces` are null when the tx has no known RBF history within the mempool monitor's retention window.
+   *
+   * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-transaction-rbf-history)*
+   *
+   * Endpoint: `GET /api/v1/tx/{txid}/rbf`
+   *
+   * @param {Txid} txid
+   * @param {{ signal?: AbortSignal, onUpdate?: (value: RbfResponse) => void }} [options]
+   * @returns {Promise<RbfResponse>}
+   */
+  async getTxRbf(txid, { signal, onUpdate } = {}) {
+    const path = `/api/v1/tx/${txid}/rbf`;
+    return this.getJson(path, { signal, onUpdate });
+  }
+
   /**
    * Validate address
    *

package/package.json

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