Blocks API

Endpoints for querying block data on RougeChain.

Get Blocks

GET /api/blocks?limit=50&from_height=0

Query Parameters

Parameter	Type	Default	Description
`page`	number	-	Page number (1-based); enables paginated mode
`per_page`	number	10	Blocks per page (used with `page`)
`limit`	number	50	Maximum blocks to return (max 100, up to 1000 for sync)
`from_height`	number	-	Start from this block height (used for P2P sync)

Response

{
  "blocks": [
    {
      "version": 1,
      "header": {
        "version": 1,
        "chain_id": "rougechain-devnet-1",
        "height": 42,
        "time": 1706745600000,
        "prev_hash": "abc123...",
        "tx_hash": "def456...",
        "proposer_pub_key": "ghi789..."
      },
      "txs": [...],
      "proposer_sig": "...",
      "hash": "xyz..."
    }
  ],
  "total_height": 12345,
  "page": 1,
  "total_pages": 1235
}

total_height is always present. page and total_pages are only returned in paginated mode (when page is supplied).

Block Fields

Field	Type	Description
`version`	number	Block format version
`header.chain_id`	string	Chain identifier
`header.height`	number	Block number
`header.time`	number	Timestamp (ms since epoch)
`header.prev_hash`	string	Hash of previous block
`header.tx_hash`	string	Merkle root of transactions
`header.proposer_pub_key`	string	Validator who proposed this block
`txs`	array	Transactions included in this block
`proposer_sig`	string	ML-DSA-65 signature by the proposer
`hash`	string	SHA-256 hash of this block

Block Summary

GET /api/blocks/summary

Returns time-bucketed block/transaction counts, suitable for charts and dashboards.

Query Parameters

Parameter	Type	Default	Description
`range`	string	`24h`	Time range: `1h`, `24h`, or `7d`

Response

{
  "success": true,
  "range": "24h",
  "intervalMs": 3600000,
  "startTime": 1706659200000,
  "endTime": 1706745600000,
  "points": [
    {
      "timestamp": 1706742000000,
      "blocks": 42,
      "transactions": 137
    }
  ]
}

Import Block (P2P)

Used by peer nodes to propagate blocks.

POST /api/blocks/import
Content-Type: application/json

See Peers API for details.

Block Verification

Every block is verified by receiving nodes:

Hash check — Recompute the block hash and compare
Signature check — Verify ML-DSA-65 signature against the proposer's public key
Height check — Must extend the current chain tip by exactly 1
Previous hash — Must reference the current tip's hash
Transaction validity — All transactions must have valid signatures and sufficient balances

RougeChain Documentation