ar-io/ar-io-node r62

Release 62

on GitHub

This is an optional release that introduces the CDB64-based historical root TX index, a new lookup source for resolving data items to their root transactions. The CDB64 format provides fast O(1) lookups from pre-generated index files, enabling efficient root TX resolution for historical data without database queries. Pre-generated CDB64 index files will be made available in the coming weeks.

Added

• CDB64-Based Historical Root TX Index: New lookup source for root transaction IDs using the compact CDB64 file format
  • Enable by adding 'cdb' to ROOT_TX_LOOKUP_ORDER (e.g., db,cdb,gateways,graphql)
  • Reads from data/cdb64-root-tx-index directory (configurable via CDB64_ROOT_TX_INDEX_DATA_PATH in Docker)
  • Multi-file directory support with runtime file watching (new .cdb files automatically loaded without restart)
  • File watching can be disabled via CDB64_ROOT_TX_INDEX_WATCH=false
  • CLI tools for index generation and data extraction:
    • SQLite to CDB64 export (tools/export-sqlite-to-cdb64)
    • CSV to CDB64 generation with RFC 4180 support (tools/generate-cdb64-root-tx-index)
    • Rust-backed CDB64 generation for high-throughput (tools/generate-cdb64-root-tx-index-rs)
    • CDB64 to CSV export (tools/export-cdb64-root-tx-index)
  • Binary compatibility with Rust cdb64-rs for cross-language interoperability
  • CDB64 file format specification documentation (docs/cdb64-format.md)

Fixed

• Expose ROOT_TX_LOOKUP_ORDER environment variable in docker-compose.yaml (was missing from previous releases)

Docker Images