A communication mesh for BSV apps. Signed data, real-time delivery, micropayment gating.
- Publish — Signed data envelopes propagate across the mesh in real time via authenticated gossip
- Subscribe — Real-time push via SSE, for envelopes and BRC-33 messages alike
- Message — Point-to-point messaging between identities. Send to a specific pubkey, not just broadcast
- Discover — Browse topics, metadata, publisher identity, demand, and federation health. Machines and humans can understand the mesh
- Earn — Non-custodial x402 micropayments per request. Payment signatures verified via script interpreter
- Verify — Syncs block headers, verifies BSV transactions via BEEF proofs for payment gating
- Broadcast — Submit BEEF transactions with validation + ARC forwarding; bearer token OR x402 payment accepted
curl -fsSL https://raw.githubusercontent.com/BSVanon/Anvil/v2.3.0/scripts/install.sh | sudo bashThe guided installer downloads the binary from GitHub Releases, verifies the SHA256 checksum, generates your identity, syncs headers, and shows your funding address. Takes about 3 minutes.
The install script is served from GitHub (not a VPS) and is immutable at tagged commits. See RELEASING.md for supply chain details.
After install:
sudo ufw allow 8333/tcp # mesh peering
sudo ufw allow 9333/tcp # REST API
sudo anvil info # your address + auth tokenSend 1,000,000 sats to the address shown, wait for 1 confirmation, then:
TOKEN=$(sudo anvil token)
curl -X POST http://localhost:9333/wallet/scan \
-H "Authorization: Bearer $TOKEN"Your node is live. Run anvil help for the full command reference.
npm install anvil-meshimport { AnvilClient } from 'anvil-mesh';
const anvil = new AnvilClient({ wif: 'your-WIF', nodeUrl: 'http://your-node:9333' });
await anvil.publish('oracle:rates:bsv', { USD: 14.35 });
const data = await anvil.query('oracle:rates:bsv');
// v0.4.0: federation discovery + health for multi-node failover
const { nodes } = await anvil.peers();
const health = await anvil.health();| Guide | What it covers |
|---|---|
| Publish | Data envelopes, signing, topics, mesh gossip |
| Earn | Payment models, x402 flow, monetization |
| Discover | Topic discovery, metadata, identity, demand, AI agents |
| Verify | Payment verification, header sync, BEEF proofs |
| Add Your App | 5-minute path from app to live mesh publisher |
| App Integration | Step-by-step guide for connecting your app |
| Mesh Peering | Bonds, node names, overlay discovery, connection logging |
| API Reference | All endpoints, SSE, messaging, discovery, auth |
| Payment Policy | Non-custodial design constraints |
| Capabilities | Machine-readable reference for AI agents |
| Explorer | https://anvil.sendbsv.com |
| x402 discovery | https://anvil.sendbsv.com/.well-known/x402 |
| Topic discovery | https://anvil.sendbsv.com/topics |
- Linux (amd64 or arm64)
- 512 MB RAM minimum, 1 GB recommended
- 500 MB disk (headers ~75MB + data stores)
- Go 1.26+ (build from source only — binary has no runtime dependencies)
- No full blockchain download. Headers only (~80 bytes x 942K blocks).
See LICENSE.