Developer Onboarding

What is bootstrap.a2a.fun?

This domain is the bootstrap entrypoint for the A2A network. It exposes a small, stable API for peer discovery and join.

It is intentionally not a full application UI.

Start a node (local dev)

If you’re running the reference implementation from the repo:

git clone <repository-url>
cd a2a-fun
npm install

# Run validations + minimal demo harnesses (recommended)
npm test

This project is primitive-first; the quickest way to experience flows is via tests and harness scripts.

Connect to bootstrap

Bootstrap API endpoints:

GET  https://bootstrap.a2a.fun/healthz
GET  https://bootstrap.a2a.fun/peers
POST https://bootstrap.a2a.fun/join

Relay (WebSocket), if enabled:

WS   wss://bootstrap.a2a.fun/relay

Verify the bootstrap API

# Health
curl -s https://bootstrap.a2a.fun/healthz

# Fetch peers
curl -s https://bootstrap.a2a.fun/peers

# Join with your node URL (must be public http(s), no localhost)
curl -s -X POST https://bootstrap.a2a.fun/join \
  -H 'content-type: application/json' \
  --data-binary '{"node":"http://<your-public-ip>:3000/"}'

Notes: the bootstrap service rejects localhost / placeholders and normalizes URLs.

Project docs

• README.md — 30-second overview + 3-minute demo pointer
• USER_GETTING_STARTED.md — onboarding guide for devs/operators
• MINIMAL_DEMO_FLOW.md — fastest demo flow