Release Nakamoto beta

.env

@@ -178,4 +178,4 @@ STACKS_NODE_TYPE=L1
 # IBD_MODE_UNTIL_BLOCK=
 
 # Folder with events to be imported by the event-replay.
-STACKS_EVENTS_DIR=./eventssds
+STACKS_EVENTS_DIR=./events

.github/workflows/ci.yml

@@ -855,7 +855,6 @@ jobs:
       - lint
       - lint-docs
       - test
-      - test-2_5
       - test-bns
       - test-rosetta
       - test-rosetta-cli-construction

.vscode/launch.json

@@ -55,6 +55,7 @@
       "skipFiles": [
         "<node_internals>/**"
       ],
+      "runtimeVersion": "20",
       "runtimeArgs": ["-r", "ts-node/register/transpile-only", "-r", "tsconfig-paths/register"],
       "args": ["${workspaceFolder}/src/index.ts"],
       "outputCapture": "std",

CHANGELOG.md

@@ -1,3 +1,40 @@
+## [7.9.0-nakamoto.9](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.9.0-nakamoto.8...v7.9.0-nakamoto.9) (2024-03-21)
+
+
+### Bug Fixes
+
+* event-replay readiness for nakamoto & fix for [#1879](https://github.com/hirosystems/stacks-blockchain-api/issues/1879) ([#1903](https://github.com/hirosystems/stacks-blockchain-api/issues/1903)) ([1572e73](https://github.com/hirosystems/stacks-blockchain-api/commit/1572e737337680510850b23662e1f36c57ebc198))
+
+## [7.9.0-nakamoto.8](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.9.0-nakamoto.7...v7.9.0-nakamoto.8) (2024-03-20)
+
+
+### Features
+
+* ingest signer_bitvec ([#1900](https://github.com/hirosystems/stacks-blockchain-api/issues/1900)) ([aa1750f](https://github.com/hirosystems/stacks-blockchain-api/commit/aa1750f7ebbdfe4c2a84583f98c3ff465236f8aa))
+
+## [7.9.0-nakamoto.7](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.9.0-nakamoto.6...v7.9.0-nakamoto.7) (2024-03-20)
+
+
+### Features
+
+* pox stacker & signer cycle details ([#1873](https://github.com/hirosystems/stacks-blockchain-api/issues/1873)) ([d2c2805](https://github.com/hirosystems/stacks-blockchain-api/commit/d2c28059cfca99cd9b9a35cb8c96074a60fedd35))
+
+## [7.9.0-nakamoto.6](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.9.0-nakamoto.5...v7.9.0-nakamoto.6) (2024-03-15)
+
+
+### Features
+
+* nakamoto block timestamps ([#1886](https://github.com/hirosystems/stacks-blockchain-api/issues/1886)) ([f547832](https://github.com/hirosystems/stacks-blockchain-api/commit/f5478329d7267a65b5f3c557b197feadff298afb))
+
+## [7.9.0-nakamoto.5](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.9.0-nakamoto.4...v7.9.0-nakamoto.5) (2024-02-20)
+
+
+### Bug Fixes
+
+* report placeholder in prom metrics for invalid request paths ([#1867](https://github.com/hirosystems/stacks-blockchain-api/issues/1867)) ([7921488](https://github.com/hirosystems/stacks-blockchain-api/commit/79214883a5c58724ddc3e7d7b57381317cb6e27d))
+* **rosetta:** use /v2/fees/transaction for fee estimation ([b287b7b](https://github.com/hirosystems/stacks-blockchain-api/commit/b287b7bb3426719553e9ffa3b88178fb24207a6b))
+* sql transactional consistency bug with fetching chaintip in various areas ([#1853](https://github.com/hirosystems/stacks-blockchain-api/issues/1853)) ([07339c0](https://github.com/hirosystems/stacks-blockchain-api/commit/07339c08f3f42bc7b08c2e830939bfadcd308cb0))
+
 ## [7.8.2](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.8.1...v7.8.2) (2024-02-19)
 
 

client/src/generated/models/RosettaOptions.ts

@@ -2,7 +2,7 @@
 /* eslint-disable */
 /**
  * Stacks Blockchain API
- * Welcome to the API reference overview for the <a href=\"https://docs.hiro.so/get-started/stacks-blockchain-api\">Stacks Blockchain API</a>.  <a href=\"https://hirosystems.github.io/stacks-blockchain-api/collection.json\" download=\"stacks-api-collection.json\">Download Postman collection</a> 
+ * Welcome to the API reference overview for the [Stacks Blockchain API](https://docs.hiro.so/get-started/stacks-blockchain-api).  [Download Postman collection](https://hirosystems.github.io/stacks-blockchain-api/collection.json) 
  *
  * The version of the OpenAPI document: STACKS_API_VERSION
  * 
@@ -139,6 +139,12 @@ export interface RosettaOptions {
      * @memberof RosettaOptions
      */
     pox_addr?: string;
+    /**
+     * The hex-encoded signer key (buff 33) for PoX.
+     * @type {string}
+     * @memberof RosettaOptions
+     */
+    signer_key?: string;
 }
 
 export function RosettaOptionsFromJSON(json: any): RosettaOptions {
@@ -171,6 +177,7 @@ export function RosettaOptionsFromJSONTyped(json: any, ignoreDiscriminator: bool
         'burn_block_height': !exists(json, 'burn_block_height') ? undefined : json['burn_block_height'],
         'delegate_to': !exists(json, 'delegate_to') ? undefined : json['delegate_to'],
         'pox_addr': !exists(json, 'pox_addr') ? undefined : json['pox_addr'],
+        'signer_key': !exists(json, 'signer_key') ? undefined : json['signer_key'],
     };
 }
 
@@ -203,6 +210,7 @@ export function RosettaOptionsToJSON(value?: RosettaOptions | null): any {
         'burn_block_height': value.burn_block_height,
         'delegate_to': value.delegate_to,
         'pox_addr': value.pox_addr,
+        'signer_key': value.signer_key,
     };
 }
 

docker/docker-compose.dev.stacks-blockchain.yml

@@ -1,17 +1,17 @@
 version: '3.7'
 services:
   stacks-blockchain:
-    image: "hirosystems/stacks-api-e2e:stacks3.0-800259e"
+    image: 'hirosystems/stacks-api-e2e:stacks3.0-457f270'
     restart: on-failure
     environment:
       STACKS_EVENT_OBSERVER: host.docker.internal:3700
       BLOCKSTACK_USE_TEST_GENESIS_CHAINSTATE: 1
       NOP_BLOCKSTACK_DEBUG: 1
     ports:
-      - "20443:20443"
-      - "20444:20444"
+      - '20443:20443'
+      - '20444:20444'
     volumes:
       - ../stacks-blockchain/:/app/config
       - ../stacks-blockchain/.chaindata:/tmp/stacks-blockchain-data
     extra_hosts:
-      - "host.docker.internal:host-gateway" # fixes `host.docker.internal` on linux hosts
+      - 'host.docker.internal:host-gateway' # fixes `host.docker.internal` on linux hosts

docker/docker-compose.dev.stacks-krypton.yml

@@ -1,16 +1,16 @@
 version: '3.7'
 services:
   stacks-blockchain:
-    image: "hirosystems/stacks-api-e2e:stacks3.0-800259e"
+    image: 'hirosystems/stacks-api-e2e:stacks3.0-457f270'
     ports:
-      - "18443:18443" # bitcoin regtest JSON-RPC interface
-      - "18444:18444" # bitcoin regtest p2p
-      - "20443:20443" # stacks-node RPC interface
-      - "20444:20444" # stacks-node p2p
+      - '18443:18443' # bitcoin regtest JSON-RPC interface
+      - '18444:18444' # bitcoin regtest p2p
+      - '20443:20443' # stacks-node RPC interface
+      - '20444:20444' # stacks-node p2p
     environment:
       MINE_INTERVAL: 0.1s
       STACKS_EVENT_OBSERVER: host.docker.internal:3700
       # STACKS_LOG_TRACE: 1
       # STACKS_LOG_DEBUG: 1
     extra_hosts:
-      - "host.docker.internal:host-gateway" # fixes `host.docker.internal` on linux hosts
+      - 'host.docker.internal:host-gateway' # fixes `host.docker.internal` on linux hosts

docs/api/stacking/get-pox-cycle-signer-stackers.example.json

@@ -0,0 +1,12 @@
+{
+  "limit": 20,
+  "offset": 0,
+  "total": 1,
+  "results": [
+    {
+      "pox_address": "15Z2sAvjgVDpcBh4vx9g2XKU8FVHYcXNaj",
+      "stacked_amount": "686251350000000000",
+      "stacker_address": "STRYYQQ9M8KAF4NS7WNZQYY59X93XEKR31JP64CP"
+    }
+  ]
+}

docs/api/stacking/get-pox-cycle-signer-stackers.schema.json

@@ -0,0 +1,29 @@
+{
+  "description": "GET request that returns stackers for a signer in a PoX cycle",
+  "additionalProperties": false,
+  "title": "PoxCycleSignerStackersListResponse",
+  "type": "object",
+  "required": ["results", "limit", "offset", "total"],
+  "properties": {
+    "limit": {
+      "type": "integer",
+      "maximum": 200,
+      "description": "The number of stackers to return"
+    },
+    "offset": {
+      "type": "integer",
+      "description": "The number to stackers to skip (starting at `0`)",
+      "default": 0
+    },
+    "total": {
+      "type": "integer",
+      "description": "The total number of stackers"
+    },
+    "results": {
+      "type": "array",
+      "items": {
+        "$ref": "../../entities/stacking/stacker.schema.json"
+      }
+    }
+  }
+}

docs/api/stacking/get-pox-cycle-signers.example.json

@@ -0,0 +1,28 @@
+{
+  "limit": 20,
+  "offset": 0,
+  "total": 3,
+  "results": [
+    {
+      "signing_key": "0x038e3c4529395611be9abf6fa3b6987e81d402385e3d605a073f42f407565a4a3d",
+      "stacked_amount": "686251350000000000",
+      "stacked_amount_percent": 50,
+      "weight": 5,
+      "weight_percent": 55.55555555555556
+    },
+    {
+      "signing_key": "0x029874497a7952483aa23890e9d0898696f33864d3df90939930a1f45421fe3b09",
+      "stacked_amount": "457500900000000000",
+      "stacked_amount_percent": 33.333333333333336,
+      "weight": 3,
+      "weight_percent": 33.33333333333333
+    },
+    {
+      "signing_key": "0x02dcde79b38787b72d8e5e0af81cffa802f0a3c8452d6b46e08859165f49a72736",
+      "stacked_amount": "228750450000000000",
+      "stacked_amount_percent": 16.666666666666668,
+      "weight": 1,
+      "weight_percent": 11.11111111111111
+    }
+  ]
+}

docs/api/stacking/get-pox-cycle-signers.schema.json

@@ -0,0 +1,29 @@
+{
+  "description": "GET request that returns signers for a PoX cycle",
+  "additionalProperties": false,
+  "title": "PoxCycleSignersListResponse",
+  "type": "object",
+  "required": ["results", "limit", "offset", "total"],
+  "properties": {
+    "limit": {
+      "type": "integer",
+      "maximum": 200,
+      "description": "The number of signers to return"
+    },
+    "offset": {
+      "type": "integer",
+      "description": "The number to signers to skip (starting at `0`)",
+      "default": 0
+    },
+    "total": {
+      "type": "integer",
+      "description": "The total number of signers"
+    },
+    "results": {
+      "type": "array",
+      "items": {
+        "$ref": "../../entities/stacking/signer.schema.json"
+      }
+    }
+  }
+}

docs/api/stacking/get-pox-cycles.example.json

@@ -0,0 +1,31 @@
+{
+  "limit": 20,
+  "offset": 0,
+  "total": 3,
+  "results": [
+    {
+      "block_height": 50,
+      "cycle_number": 14,
+      "index_block_hash": "0xf5be33abc4e508bdaf2191e88339372edcb3358c44e2a31e1b9b44f2880dde09",
+      "total_signers": 3,
+      "total_stacked_amount": "1372502700000000000",
+      "total_weight": 9
+    },
+    {
+      "block_height": 22,
+      "cycle_number": 13,
+      "index_block_hash": "0x5077c7d971dd83cd3ba19dca579e3cc8dcf17913186b66093c94520e50d3b7b2",
+      "total_signers": 3,
+      "total_stacked_amount": "1372502700000000000",
+      "total_weight": 9
+    },
+    {
+      "block_height": 13,
+      "cycle_number": 12,
+      "index_block_hash": "0x62d06851fe03f17cb45a488ae70bd8e0c5c308c523f37814ad4df36bd2108713",
+      "total_signers": 3,
+      "total_stacked_amount": "1372502700000000000",
+      "total_weight": 9
+    }
+  ]
+}

docs/api/stacking/get-pox-cycles.schema.json

@@ -0,0 +1,29 @@
+{
+  "description": "GET request that returns PoX cycles",
+  "additionalProperties": false,
+  "title": "PoxCycleListResponse",
+  "type": "object",
+  "required": ["results", "limit", "offset", "total"],
+  "properties": {
+    "limit": {
+      "type": "integer",
+      "maximum": 200,
+      "description": "The number of cycles to return"
+    },
+    "offset": {
+      "type": "integer",
+      "description": "The number to cycles to skip (starting at `0`)",
+      "default": 0
+    },
+    "total": {
+      "type": "integer",
+      "description": "The total number of cycles"
+    },
+    "results": {
+      "type": "array",
+      "items": {
+        "$ref": "../../entities/stacking/pox-cycle.schema.json"
+      }
+    }
+  }
+}

docs/entities/blocks/block.schema.json

@@ -7,6 +7,8 @@
     "canonical",
     "height",
     "hash",
+    "block_time",
+    "block_time_iso",
     "index_block_hash",
     "parent_block_hash",
     "txs",
@@ -39,6 +41,14 @@
       "type": "string",
       "description": "Hash representing the block"
     },
+    "block_time": {
+      "type": "number",
+      "description": "Unix timestamp (in seconds) indicating when this block was mined."
+    },
+    "block_time_iso": {
+      "type": "string",
+      "description": "An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) indicating when this block was mined."
+    },
     "index_block_hash": {
       "type": "string",
       "description": "The only hash that can uniquely identify an anchored block or an unconfirmed state trie"

docs/entities/rosetta/rosetta-construction-options.schema.json

@@ -83,6 +83,10 @@
     "pox_addr": {
       "type": "string",
       "description": "The reward address for stacking transaction. It should be a valid Bitcoin address"
+    },
+    "signer_key": {
+      "type": "string",
+      "description": "The hex-encoded signer key (buff 33) for PoX."
     }
   }
 }

docs/entities/stacking/pox-cycle.example.json

@@ -0,0 +1,8 @@
+{
+  "block_height": 50,
+  "cycle_number": 14,
+  "index_block_hash": "0xf5be33abc4e508bdaf2191e88339372edcb3358c44e2a31e1b9b44f2880dde09",
+  "total_signers": 3,
+  "total_stacked_amount": "1372502700000000000",
+  "total_weight": 9
+}

docs/entities/stacking/pox-cycle.schema.json

@@ -0,0 +1,33 @@
+{
+  "title": "PoxCycle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "block_height",
+    "index_block_hash",
+    "cycle_number",
+    "total_weight",
+    "total_stacked_amount",
+    "total_signers"
+  ],
+  "properties": {
+    "block_height": {
+      "type": "integer"
+    },
+    "index_block_hash": {
+      "type": "string"
+    },
+    "cycle_number": {
+      "type": "integer"
+    },
+    "total_weight": {
+      "type": "integer"
+    },
+    "total_stacked_amount": {
+      "type": "string"
+    },
+    "total_signers": {
+      "type": "integer"
+    }
+  }
+}

docs/entities/stacking/signer.example.json

@@ -0,0 +1,7 @@
+{
+  "signing_key": "0x038e3c4529395611be9abf6fa3b6987e81d402385e3d605a073f42f407565a4a3d",
+  "stacked_amount": "686251350000000000",
+  "stacked_amount_percent": 50,
+  "weight": 5,
+  "weight_percent": 55.55555555555556
+}