feat: support tenure-height in block messages (#661)

Author: zone117x

components/chainhook-cli/src/service/tests/helpers/mock_stacks_node.rs

@@ -261,6 +261,7 @@ pub fn create_stacks_new_block(
         events,
         matured_miner_rewards: vec![],
         block_time: Some(12345),
+        tenure_height: Some(1122),
         signer_bitvec: Some("000800000001ff".to_owned()),
         signer_signature: Some(vec!["1234".to_owned(), "2345".to_owned()]),
         cycle_number: Some(1),

components/chainhook-sdk/src/chainhooks/tests/fixtures/stacks/testnet/occurrence.json

@@ -16,6 +16,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -103,6 +104,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -189,6 +191,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -276,6 +279,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -362,6 +366,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -450,6 +455,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -537,6 +543,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -624,6 +631,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -712,6 +720,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -799,6 +808,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -886,6 +896,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -973,6 +984,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -1060,6 +1072,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,
@@ -1157,6 +1170,7 @@
         "pox_cycle_position": 1033,
         "stacks_block_hash": "0x",
         "block_time": null,
+        "tenure_height": null,
         "cycle_number": null,
         "reward_set": null,
         "signer_bitvec": null,

components/chainhook-sdk/src/indexer/stacks/mod.rs

@@ -36,6 +36,9 @@ pub struct NewBlock {
     pub events: Vec<NewEvent>,
     pub matured_miner_rewards: Vec<MaturedMinerReward>,
 
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub tenure_height: Option<u64>,
+
     #[serde(skip_serializing_if = "Option::is_none")]
     pub block_time: Option<u64>,
 
@@ -464,6 +467,7 @@ pub fn standardize_stacks_block(
             stacks_block_hash: block.block_hash.clone(),
 
             block_time: block.block_time,
+            tenure_height: block.tenure_height,
             // TODO: decode `signer_bitvec` into an easy to use bit string representation (e.g. "01010101")
             signer_bitvec: block.signer_bitvec.clone(),
             signer_signature: block.signer_signature.clone(),

components/chainhook-sdk/src/indexer/tests/helpers/stacks_blocks.rs

@@ -73,6 +73,7 @@ pub fn generate_test_stacks_block(
             confirm_microblock_identifier,
             stacks_block_hash: String::new(),
             block_time: Some(12345),
+            tenure_height: Some(1122),
             signer_bitvec: Some("1010101010101".to_owned()),
             signer_signature: Some(vec!["1234".to_owned(), "2345".to_owned()]),
             cycle_number: Some(1),

components/chainhook-types-js/src/index.ts

@@ -696,6 +696,7 @@ export interface StacksBlockMetadata {
   pox_cycle_length: number;
 
   block_time?: number | null;
+  tenure_height?: number | null;
   signer_bitvec?: string | null;
   signer_signature?: string[] | null;
   cycle_number?: number | null;

components/chainhook-types-rs/src/rosetta.rs

@@ -123,6 +123,9 @@ pub struct StacksBlockMetadata {
     // Available starting in epoch3, only included in blocks where the pox cycle rewards are first calculated
     pub cycle_number: Option<u64>,
     pub reward_set: Option<StacksBlockMetadataRewardSet>,
+
+    // Available in /new_block messages sent from stacks-core v3.0 and newer
+    pub tenure_height: Option<u64>,
 }
 
 #[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]

components/client/typescript/src/schemas/stacks/payload.ts

@@ -67,6 +67,8 @@ export const StacksEventMetadataSchema = Type.Object({
   pox_cycle_position: Type.Integer(),
   stacks_block_hash: Type.String(),
 
+  tenure_height: Nullable(Type.Integer()),
+
   // Fields included in Nakamoto block headers
   block_time: Nullable(Type.Integer()),
   signer_bitvec: Nullable(Type.String()),