BlockWire - Real-time Blockchain Event Infrastructure for AI Agents

OVERVIEW
BlockWire provides real-time blockchain event feeds for AI agents on Base. Agents can subscribe to webhooks for push delivery or use pull-based APIs with x402 payments.

SERVICES

BlockWire provides three categories of services:

1. EVENT MONITORING SERVICES
   - new_contract: New contract deployments on Base
   - liquidity_added: Liquidity added to DEX pools
   - liquidity_removed: Liquidity removed from DEX pools
   - price_movement: Significant token price movements
   - large_transfer: Large token transfers
   - nft_mint: NFT mint events

2. DATA ACCESS SERVICES
   - Webhook Push: Real-time delivery to your endpoint (subscription-based)
   - Feed API: Pull recent events via /api/feed ($0.002 per request)
   - Replay API: Historical events with attestation proofs via /api/replay ($0.005 per request)
   - Status API: System health and metrics via /api/status (free)
   - Subscribe API: On-chain subscription management via /api/subscribe

3. VERIFICATION SERVICES
   - On-Chain Attestations: Every event batch cryptographically anchored to Base
   - Hash Chain Verification: Verify batch integrity via /api/attestations/verify (free)
   - Attestation History: Query all attestations via /api/attestations (free)
   - HMAC Webhook Signatures: Verify webhook authenticity with X-BlockWire-Signature header

API ENDPOINTS

Free Endpoints (no payment required):
- GET /api/status - System health and metrics
- GET /api/attestations - On-chain attestation history
- GET /api/attestations/verify - Verify batch hashes against on-chain attestations
- GET /api/subscribe - Get subscription pricing and configuration

Paid Endpoints (x402 payment required):
- GET /api/feed - Recent blockchain events ($0.002 per request)
- GET /api/replay - Historical events with attestation proofs ($0.005 per request)

Subscription Endpoint:
- POST /api/subscribe - Generate transaction data for on-chain webhook subscription

EVENT TYPES
- new_contract: New contract deployments
- liquidity_added: Liquidity added to DEX pools
- liquidity_removed: Liquidity removed from DEX pools
- price_movement: Significant price movements
- large_transfer: Large token transfers
- nft_mint: NFT mint events

SUBSCRIPTION FLOW
1. Agent calls POST /api/subscribe with webhook URL, event types, and hours
2. Server returns transaction data to submit on-chain
3. Agent submits transaction to BlockWireRegistry contract on Base
4. Once active, BlockWire delivers events to webhook URL with HMAC signatures

WEBHOOK DELIVERY
- Events are POSTed to subscriber webhook URLs
- Each request includes X-BlockWire-Signature header for verification
- Webhooks must respond within 5 seconds
- Failed deliveries are not retried; use /api/replay to recover missed events

ATTESTATIONS
- All event batches are cryptographically attested on-chain
- Attestations form a hash chain for verification
- Use /api/attestations/verify to verify any batch hash

PAYMENT
- Uses x402 protocol (Coinbase Developer Platform)
- Payment token: USDC on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Chain ID: 8453 (Base mainnet)
- Endpoint: https://api.cdp.coinbase.com/x402

CONTRACT
- Registry: 0x20Fa63E8A50C3F990c67EF7df6e0D10a7005686a (Base mainnet)
- Network: Base (chain ID 8453)

SDK
TypeScript SDK available: @echorift/blockwire-sdk
npm install @echorift/blockwire-sdk

DOCUMENTATION
- Full docs: https://blockwire.echorift.xyz/docs
- Quickstart: https://blockwire.echorift.xyz/docs/quickstart
- API spec: https://blockwire.echorift.xyz/.well-known/openapi.json