Skip to content

Commit 16cf23d

Browse files
committed
feat: v0.5.0 - web dashboard, /deposits API, fix BTC error:null bug
- Add index.html web dashboard with dark/light theme - Real-time deposit ledger per address with tx_hash dedup - CAIP-2 chain badges, truncated hashes, Inter+JetBrainsMono fonts - Move-to-top animation on new deposits, modal add/delete UX - Add /deposits API endpoint reading JSON Lines output file - Add / route serving the dashboard HTML (zero CORS issues) - Add output_path to ApiState for deposit file tracking - Add Deserialize derive to DepositResult for JSON parsing - Fix critical BTC bug: treat 'error: null' as success (JSON-RPC spec) - Show error codes in RPC retry messages (-8, -32602, etc.) - Add /deposits endpoint to README API docs - Update output format docs with tx_hash field
1 parent e5a6823 commit 16cf23d

6 files changed

Lines changed: 494 additions & 7 deletions

File tree

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "rustplorer"
3-
version = "0.4.0"
3+
version = "0.5.0"
44
edition = "2021"
55
description = "High-performance multi-chain deposit detector using public RPC endpoints"
66
license = "MIT OR Apache-2.0"

README.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -236,19 +236,23 @@ rustplorer -a addresses.txt --watch --interval 30 --api-port 3000
236236

237237
## HTTP API
238238

239-
Start an HTTP server to manage target addresses dynamically:
239+
Start an HTTP server to manage target addresses dynamically and visualize deposits:
240240

241241
```bash
242-
rustplorer -a addresses.txt --api-port 3000
242+
rustplorer -a addresses.txt --api-port 3000 -o deposits.jsonl
243243
```
244244

245+
Open `http://localhost:3000` in your browser for the real-time deposit dashboard with dark/light theme, address management, and live deposit ledger.
246+
245247
### Endpoints
246248

247249
| Method | Path | Description |
248250
|--------|------|-------------|
251+
| `GET` | `/` | Web UI dashboard for managing addresses and viewing deposits |
249252
| `GET` | `/addresses` | List all tracked addresses |
250253
| `POST` | `/addresses` | Add a new address |
251254
| `DELETE` | `/addresses` | Remove an address |
255+
| `GET` | `/deposits` | List all detected deposits (JSON Lines from output file) |
252256

253257
### Examples
254258

@@ -275,8 +279,13 @@ curl -X DELETE http://localhost:3000/addresses \
275279
curl -X DELETE http://localhost:3000/addresses \
276280
-H "Content-Type: application/json" \
277281
-d '{"addresses": ["0xAAA...", "0xBBB..."]}'
282+
283+
# View detected deposits
284+
curl http://localhost:3000/deposits
278285
```
279286

287+
> **Note:** The `/deposits` endpoint and web dashboard require an output file (`-o deposits.jsonl`). The daemon writes each new deposit as a JSON Line, which the dashboard polls every 5 seconds.
288+
280289
## CLI Address Management
281290

282291
Directly add or remove addresses from the command line. Flags can be repeated for batches:

0 commit comments

Comments
 (0)