oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity
Files
f54f50880500d822eb2639c06b8e05bbbf892192
aitbc/website/agent/README.md
aitbc ef94cc6da4
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 3s
Details
Deploy to Testnet / deploy-testnet (push) Successful in 1m18s
Details
Multi-Node Stress Testing / stress-test (push) Has been cancelled
Details
Documentation Validation / validate-docs (push) Failing after 12s
Details
Documentation Validation / validate-policies-strict (push) Successful in 5s
Details
refactor: remove browser wallet extensions from repository 
- Deleted extensions/ directory containing Chrome and Firefox wallet implementations
- Removed aitbc-wallet and aitbc-wallet-firefox subdirectories with all source files
- Removed Firefox .xpi package (v1.0.5)
- Deleted extension documentation (README.md files, API reference, architecture diagrams)
- Removed manifest files, background scripts, content scripts, injected scripts, and popup UI code
- Cleaned up wallet API implementation (connect
2026-05-19 18:08:36 +02:00

2.7 KiB
Raw Blame History

AITBC Agent API

Machine-readable API endpoints for autonomous agents to discover and interact with the AITBC network.

Overview

This directory provides agent-first access to the AITBC blockchain network. All endpoints return structured JSON for programmatic consumption.

Quick Start

# 1. Discover the network
curl -s http://aitbc:8006/agent/discovery.json | jq .

# 2. Get island information
curl -s http://aitbc:8006/agent/islands.json | jq '.islands[]'

# 3. Get chain information
curl -s http://aitbc:8006/agent/chains.json | jq '.chains[]'

# 4. Get join instructions
curl -s http://aitbc:8006/agent/join/ait-mainnet.json | jq '.how_to_join'

Endpoints

Discovery

Endpoint Description Cache
/agent/discovery.json Complete network information 60s
/agent/islands.json All islands with status 30s
/agent/chains.json Chain configurations 60s

Join Network

Endpoint Description Cache
/agent/join/ait-mainnet.json Join instructions for mainnet 1h
/agent/join/ait-testnet.json Join instructions for testnet 1h

API Documentation

Endpoint Description Cache
/agent/openapi.json OpenAPI 3.0 specification 1h
/agent/health Health check endpoint No cache

RPC Endpoints

Endpoint Description
/rpc/head Current head block
/rpc/info Chain information
/rpc/islands Island memberships
/rpc/islands/{id} Island details

CORS Support

All /agent/ and /rpc/ endpoints include CORS headers for cross-origin access:

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Content-Type, Accept

Agent Landing Page

Human-readable documentation is available at:

Network Architecture

Islands

  • ait-mainnet-island: Production chain (hub: aitbc)
  • ait-testnet-island: Test chain (hub: aitbc1)

Nodes

Node Role Chains Island
aitbc Hub ait-mainnet ait-mainnet-island
aitbc Follower ait-testnet ait-testnet-island
aitbc1 Hub ait-testnet ait-testnet-island
aitbc1 Follower ait-mainnet ait-mainnet-island

Configuration Templates

See /agent/join/*.json files for complete configuration templates including:

  • Environment variables
  • P2P peer lists
  • RPC endpoints
  • Step-by-step join instructions

Version

  • API Version: 1.0.0
  • Format Version: 1.0
  • Last Updated: 2026-05-19

For Humans

The main website is available at the root: http://aitbc:8006/