feat!: add blobstream rpc methods and explorer UI

[Ferret-san]

Overview

Built out a full blobstream + demo stack and refreshed the explorer UI to a glassy, Celestia‑toned map with a fiber bridge and paginated columns. The RPC service now implements blobstream tuple roots/proofs, the CLI has deploy + demo commands, the relayer and mock contracts are integrated, and the UI runs via Bun/Elysia with click‑to‑inspect modals.
Key changes (highlights)

• Blobstream RPC implementation + validation and proof/root handling in src/rpc/blobstream.rs, wired into src/main.rs and src/rpc/mod.rs, with coverage in tests/compat_blobstream.rs, tests/compat_report.rs, and tests/process_server.rs.
• CLI and orchestration: localestia blobstream deploy and localestia demo added in src/cli.rs, relayer moved to src/relayer.rs, binary wrapper in src/bin/blobstream_relayer.rs.
• Mock contract + tooling: Foundry setup and mock contract in contracts/, deploy script in contracts/scripts/deploy_mock_blobstream.sh, plus scripts/setup_anvil.sh.
• Explorer UI: Bun + Elysia server with map view, fiber video bridge, and paginated columns + modal JSON inspector in ui/src/index.ts and ui/package.json.
• Added dependencies for CLI and UI (clap, ethers, redis) in Cargo.toml and ui/package.json.
  Docs updated
• README.md now documents blobstream RPC methods, CLI deploy/demo commands, demo UI usage, and relayer usage. It also reflects the current explorer (map + fiber stream + paginated columns + modal).
  How to use the new features (as documented)
• Deploy mock contract: localestia blobstream deploy --eth-rpc-url http://127.0.0.1:8545/ --private-key 0x...
• Run demo stack: localestia demo --relayer-interval-ms 1000 --ui-port 3030
• Run UI manually: cd ui && bun install && CELESTIA_HTTP_URL=... ETH_RPC_URL=... BLOBSTREAM_CONTRACT_ADDRESS=... bun src/index.ts
  Files of interest
• src/rpc/blobstream.rs
• src/cli.rs
• src/relayer.rs
• src/bin/blobstream_relayer.rs
• tests/compat_blobstream.rs
• contracts/src/MockBlobstream.sol
• contracts/scripts/deploy_mock_blobstream.sh
• ui/src/index.ts
• README.md

[nuke-web3]

should this be in .gitignore ?

[nuke-web3]

figure contracts/out should be in .gitignore too?

[Ferret-san]

oops, yes they should!

…

On Tue, Feb 24, 2026 at 17:55 Nuke 🌄 ***@***.***> wrote: ***@***.**** commented on this pull request. ------------------------------ On contracts/out/IBlobstreamX.sol/IBlobstreamX.json <#9 (comment)>: figure contracts/out should be in .gitignore too? — Reply to this email directly, view it on GitHub <#9 (review)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AHTVH2R4SWLRDMTQDYBLUMT4NTJFJAVCNFSM6AAAAACV6SGTMGVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMZTQNJQHE2DONBTGE> . You are receiving this because you authored the thread.Message ID: ***@***.***>