brk-client 0.3.0-alpha.2 → 0.3.0-alpha.4

package/index.js

@@ -139,6 +139,9 @@
  * @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
+ * @property {?number=} firstSeen - Timestamp when the block was first seen (always null, not yet supported)
+ * @property {string[]} orphans - Orphaned blocks (always empty)
+ * @property {Dollars} price - USD price at block height
  */
 /**
  * A single block fees data point.
@@ -176,15 +179,15 @@
  * @property {Height} height - Block height
  * @property {number} version - Block version
  * @property {Timestamp} timestamp - Block timestamp (Unix time)
+ * @property {number} bits - Compact target (bits)
+ * @property {number} nonce - Nonce
+ * @property {number} difficulty - Block difficulty
+ * @property {string} merkleRoot - Merkle root of the transaction tree
  * @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
@@ -194,15 +197,15 @@
  * @property {Height} height - Block height
  * @property {number} version - Block version
  * @property {Timestamp} timestamp - Block timestamp (Unix time)
+ * @property {number} bits - Compact target (bits)
+ * @property {number} nonce - Nonce
+ * @property {number} difficulty - Block difficulty
+ * @property {string} merkleRoot - Merkle root of the transaction tree
  * @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
  */
 /**
@@ -212,7 +215,7 @@
  * @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)
+ * @property {?string[]=} minerNames - Miner name tags found in coinbase scriptsig
  */
 /**
  * A single block rewards data point.
@@ -671,7 +674,7 @@
 /**
  * Type (P2PKH, P2WPKH, P2SH, P2TR, etc.)
  *
- * @typedef {("p2pk65"|"p2pk33"|"p2pkh"|"p2ms"|"p2sh"|"opreturn"|"p2wpkh"|"p2wsh"|"p2tr"|"p2a"|"empty"|"unknown")} OutputType
+ * @typedef {("p2pk65"|"p2pk33"|"p2pkh"|"p2ms"|"p2sh"|"op_return"|"v0_p2wpkh"|"v0_p2wsh"|"v1_p2tr"|"p2a"|"empty"|"unknown")} OutputType
  */
 /** @typedef {TypeIndex} P2AAddrIndex */
 /** @typedef {U8x2} P2ABytes */
@@ -1001,7 +1004,7 @@
  * @typedef {Object} Transaction
  * @property {(TxIndex|null)=} index - Internal transaction index (brk-specific, not in mempool.space)
  * @property {Txid} txid - Transaction ID
- * @property {TxVersion} version - Transaction version
+ * @property {TxVersionRaw} version - Transaction version (raw i32 from Bitcoin protocol, may contain non-standard values in coinbase txs)
  * @property {RawLockTime} locktime - Transaction lock time
  * @property {TxIn[]} vin - Transaction inputs
  * @property {TxOut[]} vout - Transaction outputs
@@ -1021,7 +1024,7 @@
  *
  * @typedef {Object} TxIn
  * @property {Txid} txid - Transaction ID of the output being spent
- * @property {Vout} vout - Output index being spent
+ * @property {Vout} vout - Output index being spent (u16: coinbase is 65535, mempool.space uses u32: 4294967295)
  * @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
@@ -1064,6 +1067,13 @@
  *
  * @typedef {number} TxVersion
  */
+/**
+ * Raw transaction version (i32) from Bitcoin protocol.
+ * Unlike TxVersion (u8, indexed), this preserves non-standard values
+ * used in coinbase txs for miner signaling/branding.
+ *
+ * @typedef {number} TxVersionRaw
+ */
 /**
  * Transaction ID (hash)
  *
@@ -6563,7 +6573,7 @@ function createTransferPattern(client, acc) {
  * @extends BrkClientBase
  */
 class BrkClient extends BrkClientBase {
-  VERSION = "v0.3.0-alpha.2";
+  VERSION = "v0.3.0-alpha.4";
 
   INDEXES = /** @type {const} */ ([
     "minute10",

package/package.json

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