mirror of
https://github.com/hanzoai/bootnode.git
synced 2026-10-25 02:31:30 +00:00
zeekay
73a3d23053
- Add k8s configs for production deployment - Use shared postgres/datastore in hanzo namespace - Fix image registry to ghcr.io/hanzoai/bootnode - Add deploy script with shared infra support - Simplify compose.yml for local development
55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# Hanzo Nodes API
|
|
|
|
Multi-chain blockchain infrastructure platform providing RPC, APIs, WebSockets, Webhooks, and ERC-4337 bundling.
|
|
|
|
## Features
|
|
|
|
- **Multi-Chain RPC**: 100+ EVM chains with load balancing
|
|
- **Token API**: ERC-20 balances, transfers, prices
|
|
- **NFT API**: ERC-721/1155 ownership, metadata, transfers
|
|
- **Wallet API**: Portfolio tracking, activity history
|
|
- **WebSocket Subscriptions**: Real-time blockchain events
|
|
- **Webhooks**: Event notifications with delivery tracking
|
|
- **ERC-4337 Bundler**: Account abstraction with gasless transactions
|
|
- **Gas API**: Real-time gas estimates and EIP-1559 data
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Start dependencies
|
|
docker compose up -d postgres redis clickhouse
|
|
|
|
# Run API locally
|
|
uv run uvicorn bootnode.main:app --reload
|
|
|
|
# Or with Docker
|
|
docker compose up -d
|
|
```
|
|
|
|
## API Endpoints
|
|
|
|
- `GET /health` - Health check
|
|
- `POST /v1/rpc/{chain}/{network}` - JSON-RPC proxy
|
|
- `GET /v1/tokens/{chain}/balance/{address}` - Token balances
|
|
- `GET /v1/nfts/{chain}/owner/{address}` - NFT ownership
|
|
- `POST /v1/webhooks` - Create webhook
|
|
- `WS /v1/ws/{chain}/{network}` - WebSocket subscriptions
|
|
|
|
## Environment Variables
|
|
|
|
```bash
|
|
DATABASE_URL=postgresql+asyncpg://...
|
|
REDIS_URL=redis://...
|
|
DATASTORE_URL=clickhouse://...
|
|
JWT_SECRET=...
|
|
```
|
|
|
|
## Documentation
|
|
|
|
- API Docs: http://localhost:8000/docs
|
|
- ReDoc: http://localhost:8000/redoc
|
|
|
|
## License
|
|
|
|
BSD-3-Clause
|