Skip to content

Add /api/v1/address/{addr}/txs (transaction history) #7

@Bortlesboat

Description

@Bortlesboat

Summary

Add transaction history for addresses. Currently we have balance + UTXOs via `scantxoutset`, but no tx history.

Challenge

Bitcoin Core doesn't index by address natively. Options:

  1. Electrs/Fulcrum integration — external indexer, most complete
  2. scanblocks RPC (Bitcoin Core 26+) — scan blocks for address matches, slow but no deps
  3. listtransactions — only for wallet addresses

Proposed approach

Start with option 2 (scanblocks) for a dependency-free version, with optional Electrs backend for power users.

Acceptance criteria

  • `GET /api/v1/address/{addr}/txs` returns paginated tx list
  • Works without Electrs (basic mode)
  • Optional Electrs integration for full history
  • Tests

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesthelp wantedExtra attention is neededhrf-roadmapHRF Bitcoin Development Fund roadmap and proof sprint

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions