Skip to content

Commit 653cb20

Browse files
whoabuddyclaude
whoabuddy
and
claude
committed
docs: flatten navigation and refine content
Address review feedback: - Flatten sidebar to one level (no nested Reference group) - Remove redundant reference index page Directory improvements: - AIBTC services pattern: mainnet on aibtc.com, testnet on aibtc.dev - Fix endpoint paths: /docs, /dashboard at base route (not subdomains) - Add Facilitator /health, Biwas /analytics endpoints - Remove redundant repos section (link to github org instead) - Remove redundant external resources (fold key links into More section) Token reference: - Add Circle Xreserve mention for USDCx - Link to Stacks bridging docs - Link to our CAIP-19 PR (ChainAgnostic/namespaces#167) Network reference: - Fix dashboard/docs paths (at base route, not subdomains) Homepage: - Cleaner quick reference tables - Condensed community links Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 50fb1c6 commit 653cb20

6 files changed

Lines changed: 98 additions & 230 deletions

File tree

‎astro.config.mjs‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,8 @@ export default defineConfig({
2727
],
2828
sidebar: [
2929
{ label: 'Directory', slug: 'directory' },
30-
{
31-
label: 'Reference',
32-
autogenerate: { directory: 'reference' },
33-
},
30+
{ label: 'Tokens', slug: 'reference/tokens' },
31+
{ label: 'Networks', slug: 'reference/networks' },
3432
{ label: 'Glossary', slug: 'glossary' },
3533
],
3634
}),

‎src/content/docs/directory/index.md‎

Lines changed: 36 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -1,75 +1,53 @@
11
---
22
title: Directory
3-
description: Find services, tools, SDKs, and repositories in the AIBTC ecosystem.
4-
sidebar:
5-
order: 0
3+
description: Services, tools, and templates in the AIBTC ecosystem.
64
---
75

8-
Everything in the AIBTC x402 ecosystem, organized by what you need.
6+
## AIBTC Services
97

10-
## Services
8+
All AIBTC services follow the same pattern: **mainnet** on `aibtc.com`, **testnet** on `aibtc.dev`.
119

12-
Live endpoints and platforms you can use today.
10+
| Service | Mainnet | Testnet | Source |
11+
|---------|---------|---------|--------|
12+
| **x402 API** | [x402.aibtc.com](https://x402.aibtc.com) | [x402.aibtc.dev](https://x402.aibtc.dev) | [GitHub](https://github.com/aibtcdev/x402-api) |
13+
| **Sponsor Relay** | [x402-relay.aibtc.com](https://x402-relay.aibtc.com) | [x402-relay.aibtc.dev](https://x402-relay.aibtc.dev) | [GitHub](https://github.com/aibtcdev/x402-sponsor-relay) |
1314

14-
| Service | Description | Links |
15-
|---------|-------------|-------|
16-
| **x402 API** | Pay-per-use AI inference, blockchain data, hashing, storage | [Mainnet](https://x402.aibtc.com) · [Testnet](https://x402.aibtc.dev) · [Docs](https://x402.aibtc.com/docs) |
17-
| **Sponsor Relay** | Gasless transactions — sponsor covers network fees | [Mainnet](https://x402-relay.aibtc.com) · [Testnet](https://x402-relay.aibtc.dev) · [Docs](https://x402-relay.aibtc.com/docs) |
18-
| **STX402** | x402 endpoint registry and ecosystem directory | [Live](https://stx402.com) · [Docs](https://stx402.com/docs) |
19-
| **x402 Biwas** | AI-powered DeFi analytics for Stacks | [Live](https://x402.biwas.xyz) |
20-
| **StacksScan** | x402 ecosystem explorer and stats | [Live](https://scan.stacksx402.com) |
21-
| **Facilitator** | Payment verification and settlement | [Live](https://facilitator.stacksx402.com) |
15+
**x402 API endpoints:**
16+
- `/` — Health check
17+
- `/docs` — OpenAPI documentation
18+
- `/dashboard` — Usage stats and analytics
2219

23-
## Tools & SDKs
20+
**Sponsor Relay endpoints:**
21+
- `/` — Health check
22+
- `/docs` — OpenAPI documentation
23+
24+
## Ecosystem Services
25+
26+
| Service | URL | Description |
27+
|---------|-----|-------------|
28+
| **STX402** | [stx402.com](https://stx402.com) | x402 endpoint registry ([/docs](https://stx402.com/docs), [/dashboard](https://stx402.com/dashboard)) |
29+
| **x402 Biwas** | [x402.biwas.xyz](https://x402.biwas.xyz) | AI-powered DeFi analytics ([/analytics](https://x402.biwas.xyz/analytics)) |
30+
| **StacksScan** | [scan.stacksx402.com](https://scan.stacksx402.com) | x402 ecosystem explorer |
31+
| **Facilitator** | [facilitator.stacksx402.com/health](https://facilitator.stacksx402.com/health) | Payment verification service |
2432

25-
Libraries and tools for building with x402.
33+
## Tools & SDKs
2634

2735
| Tool | Description | Links |
2836
|------|-------------|-------|
29-
| **@aibtc/mcp-server** | MCP server for Claude Code — blockchain tools for AI agents | [npm](https://www.npmjs.com/package/@aibtc/mcp-server) · [GitHub](https://github.com/aibtcdev/aibtc-mcp-server) |
30-
| **x402-stacks** | TypeScript SDK for x402 payments on Stacks | [npm](https://www.npmjs.com/package/x402-stacks) · [GitHub](https://github.com/tony1908/x402-stacks-sdk) |
37+
| **@aibtc/mcp-server** | MCP server for Claude Code — Stacks blockchain tools | [npm](https://www.npmjs.com/package/@aibtc/mcp-server) · [GitHub](https://github.com/aibtcdev/aibtc-mcp-server) |
38+
| **x402-stacks** | TypeScript SDK for x402 payments | [npm](https://www.npmjs.com/package/x402-stacks) · [GitHub](https://github.com/tony1908/x402-stacks-sdk) |
3139
| **Stacks.js** | Official Stacks JavaScript libraries | [Docs](https://stacks.js.org) · [GitHub](https://github.com/hirosystems/stacks.js) |
3240

33-
## Templates & Examples
34-
35-
Starting points for building x402 services.
36-
37-
| Template | Description | Links |
38-
|----------|-------------|-------|
39-
| **x402-api** | Cloudflare Workers template for paid API endpoints | [GitHub](https://github.com/aibtcdev/x402-api) |
40-
| **x402-crosschain-example** | Express/Hono example with EVM + Stacks | [GitHub](https://github.com/aibtcdev/x402-crosschain-example) |
41-
| **x402-sponsor-relay** | Sponsored transaction relay implementation | [GitHub](https://github.com/aibtcdev/x402-sponsor-relay) |
42-
43-
## Repositories
44-
45-
All AIBTC open source projects.
46-
47-
| Repo | Description |
48-
|------|-------------|
49-
| [**aibtcdev/aibtc-mcp-server**](https://github.com/aibtcdev/aibtc-mcp-server) | MCP server for Claude Code |
50-
| [**aibtcdev/x402-api**](https://github.com/aibtcdev/x402-api) | x402 API service and template |
51-
| [**aibtcdev/x402-sponsor-relay**](https://github.com/aibtcdev/x402-sponsor-relay) | Gasless transaction relay |
52-
| [**aibtcdev/x402-crosschain-example**](https://github.com/aibtcdev/x402-crosschain-example) | Crosschain x402 example |
53-
| [**aibtcdev/docs**](https://github.com/aibtcdev/docs) | This documentation site |
54-
| [**aibtcdev/branding**](https://github.com/aibtcdev/branding) | Brand assets and guidelines |
55-
| [**aibtcdev/landing-page**](https://github.com/aibtcdev/landing-page) | aibtc.com website |
56-
57-
**See all:** [github.com/aibtcdev](https://github.com/aibtcdev)
58-
59-
## External Resources
60-
61-
Key resources outside the AIBTC ecosystem.
41+
## Templates
6242

63-
| Resource | Description | Link |
64-
|----------|-------------|------|
65-
| **x402 Protocol** | HTTP 402 payment protocol specification | [x402.org](https://x402.org) |
66-
| **Stacks Docs** | Official Stacks blockchain documentation | [docs.stacks.co](https://docs.stacks.co) |
67-
| **Hiro Platform** | Stacks API keys and developer tools | [platform.hiro.so](https://platform.hiro.so) |
68-
| **Claude Code** | AI coding assistant from Anthropic | [claude.ai/code](https://claude.ai/code) |
69-
| **sBTC** | Bitcoin on Stacks | [stacks.co/sbtc](https://www.stacks.co/sbtc) |
43+
| Template | Description | Source |
44+
|----------|-------------|--------|
45+
| **x402-api** | Cloudflare Workers template for paid endpoints | [GitHub](https://github.com/aibtcdev/x402-api) |
46+
| **x402-crosschain-example** | Express/Hono with EVM + Stacks | [GitHub](https://github.com/aibtcdev/x402-crosschain-example) |
7047

71-
## See Also
48+
## More
7249

73-
- [Token Reference](/reference/tokens/) — Contract addresses and identifiers
74-
- [Network Reference](/reference/networks/) — Endpoints and configurations
75-
- [Glossary](/glossary/) — Term definitions
50+
- **All AIBTC repositories:** [github.com/aibtcdev](https://github.com/aibtcdev)
51+
- **x402 Protocol spec:** [x402.org](https://x402.org)
52+
- **Stacks documentation:** [docs.stacks.co](https://docs.stacks.co)
53+
- **Claude Code:** [claude.ai/code](https://claude.ai/code)

‎src/content/docs/index.mdx‎

Lines changed: 8 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -14,59 +14,32 @@ hero:
1414
variant: minimal
1515
---
1616

17-
import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
18-
19-
## Find What You Need
17+
import { LinkCard, CardGrid } from '@astrojs/starlight/components';
2018

2119
<CardGrid>
22-
<LinkCard title="Directory" href="/directory/" description="Services, tools, SDKs, templates, and repositories." />
23-
<LinkCard title="Token Reference" href="/reference/tokens/" description="Contract addresses, CAIP identifiers, where to get tokens." />
24-
<LinkCard title="Network Reference" href="/reference/networks/" description="Mainnet/testnet configs, API endpoints, service URLs." />
25-
<LinkCard title="Glossary" href="/glossary/" description="Term definitions and concepts." />
20+
<LinkCard title="Directory" href="/directory/" description="Services, tools, SDKs, and templates." />
21+
<LinkCard title="Tokens" href="/reference/tokens/" description="Contract addresses and identifiers." />
22+
<LinkCard title="Networks" href="/reference/networks/" description="Endpoints and configurations." />
23+
<LinkCard title="Glossary" href="/glossary/" description="Term definitions." />
2624
</CardGrid>
2725

2826
## Quick Reference
2927

30-
### Payment Tokens
28+
### Tokens
3129

3230
| Token | Mainnet Contract | Testnet Contract |
3331
|-------|------------------|------------------|
3432
| **STX** | Native | Native |
3533
| **sBTC** | `SM3VDXK3WZZSA84...sbtc-token` | `ST1F7QA2MDF17S8...sbtc-token` |
3634
| **USDCx** | `SP120SBRBQJ00MC...usdcx` | — |
3735

38-
[Full token reference →](/reference/tokens/)
39-
40-
### Service Endpoints
36+
### Endpoints
4137

4238
| Service | Mainnet | Testnet |
4339
|---------|---------|---------|
4440
| **x402 API** | [x402.aibtc.com](https://x402.aibtc.com) | [x402.aibtc.dev](https://x402.aibtc.dev) |
4541
| **Sponsor Relay** | [x402-relay.aibtc.com](https://x402-relay.aibtc.com) | [x402-relay.aibtc.dev](https://x402-relay.aibtc.dev) |
46-
| **Facilitator** | [facilitator.stacksx402.com](https://facilitator.stacksx402.com) | — |
47-
48-
[Full network reference →](/reference/networks/)
49-
50-
## Getting Started
51-
52-
New to AIBTC? Start at [aibtc.com](https://aibtc.com) for the interactive tutorial.
53-
54-
<CardGrid>
55-
<Card title="Install Claude Code" icon="laptop">
56-
```bash
57-
curl -fsSL https://claude.ai/code/install.sh | sh
58-
```
59-
</Card>
60-
<Card title="Add Stacks Tools" icon="puzzle">
61-
```bash
62-
npm install -g @aibtc/mcp-server
63-
```
64-
</Card>
65-
</CardGrid>
6642

6743
## Community
6844

69-
- [Weekly Working Group Calls](https://www.addevent.com/event/UM20108233)
70-
- [AIBTC Discord](https://discord.gg/5DJaBrf)
71-
- [GitHub](https://github.com/aibtcdev)
72-
- [X / Twitter](https://x.com/aibtcdev)
45+
- [Weekly Calls](https://www.addevent.com/event/UM20108233) · [Discord](https://discord.gg/5DJaBrf) · [GitHub](https://github.com/aibtcdev) · [X](https://x.com/aibtcdev)

‎src/content/docs/reference/index.md‎

Lines changed: 0 additions & 19 deletions
This file was deleted.

‎src/content/docs/reference/networks.md‎

Lines changed: 34 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,8 @@
11
---
2-
title: Network Reference
2+
title: Networks
33
description: Mainnet and testnet configurations, endpoints, and identifiers.
4-
sidebar:
5-
order: 2
64
---
75

8-
Canonical reference for Stacks network configurations used in the AIBTC x402 ecosystem.
9-
106
## Network Overview
117

128
| Property | Mainnet | Testnet |
@@ -17,107 +13,62 @@ Canonical reference for Stacks network configurations used in the AIBTC x402 eco
1713
| **Block time** | ~5 seconds | ~5 seconds |
1814
| **Bitcoin anchor** | Bitcoin mainnet | Bitcoin testnet |
1915

20-
## AIBTC Service Endpoints
16+
## AIBTC Endpoints
2117

22-
### x402 API
18+
All AIBTC services: **mainnet** on `aibtc.com`, **testnet** on `aibtc.dev`.
2319

24-
Pay-per-use API for AI inference, blockchain data, hashing, and storage.
20+
### x402 API
2521

26-
| Environment | Base URL | Dashboard | Docs |
27-
|-------------|----------|-----------|------|
28-
| **Mainnet** | `https://x402.aibtc.com` | [dash.aibtc.com](https://dash.aibtc.com) | [/docs](https://x402.aibtc.com/docs) |
29-
| **Testnet** | `https://x402.aibtc.dev` | [dash.aibtc.dev](https://dash.aibtc.dev) | [/docs](https://x402.aibtc.dev/docs) |
22+
| Endpoint | Mainnet | Testnet |
23+
|----------|---------|---------|
24+
| **Base** | `https://x402.aibtc.com` | `https://x402.aibtc.dev` |
25+
| **Docs** | [/docs](https://x402.aibtc.com/docs) | [/docs](https://x402.aibtc.dev/docs) |
26+
| **Dashboard** | [/dashboard](https://x402.aibtc.com/dashboard) | [/dashboard](https://x402.aibtc.dev/dashboard) |
3027

3128
### Sponsor Relay
3229

33-
Gasless transaction relay — sponsors cover network fees for agents.
34-
35-
| Environment | Base URL | Docs |
36-
|-------------|----------|------|
37-
| **Mainnet** | `https://x402-relay.aibtc.com` | [/docs](https://x402-relay.aibtc.com/docs) |
38-
| **Testnet** | `https://x402-relay.aibtc.dev` | [/docs](https://x402-relay.aibtc.dev/docs) |
30+
| Endpoint | Mainnet | Testnet |
31+
|----------|---------|---------|
32+
| **Base** | `https://x402-relay.aibtc.com` | `https://x402-relay.aibtc.dev` |
33+
| **Docs** | [/docs](https://x402-relay.aibtc.com/docs) | [/docs](https://x402-relay.aibtc.dev/docs) |
3934

4035
### Facilitator
4136

42-
Payment verification and settlement service.
43-
44-
| Environment | Base URL | Health Check |
45-
|-------------|----------|--------------|
46-
| **Production** | `https://facilitator.stacksx402.com` | [/health](https://facilitator.stacksx402.com/health) |
47-
48-
## Ecosystem Services
49-
50-
### STX402
51-
52-
Independent x402 registry and endpoint directory.
53-
54-
| Resource | URL |
55-
|----------|-----|
56-
| **Endpoints** | [stx402.com](https://stx402.com) |
57-
| **Dashboard** | [stx402.com/dashboard](https://stx402.com/dashboard) |
58-
| **Docs** | [stx402.com/docs](https://stx402.com/docs) |
59-
60-
### x402 Biwas
61-
62-
AI-powered DeFi analytics for Stacks.
63-
64-
| Resource | URL |
37+
| Endpoint | URL |
6538
|----------|-----|
66-
| **Endpoints** | [x402.biwas.xyz](https://x402.biwas.xyz) |
39+
| **Health** | [facilitator.stacksx402.com/health](https://facilitator.stacksx402.com/health) |
6740

68-
### StacksScan Explorer
41+
## Ecosystem Endpoints
6942

70-
Ecosystem explorer for x402 activity and stats.
71-
72-
| Resource | URL |
73-
|----------|-----|
74-
| **Explorer** | [scan.stacksx402.com](https://scan.stacksx402.com) |
43+
| Service | Base URL | Additional |
44+
|---------|----------|------------|
45+
| **STX402** | [stx402.com](https://stx402.com) | [/docs](https://stx402.com/docs), [/dashboard](https://stx402.com/dashboard) |
46+
| **x402 Biwas** | [x402.biwas.xyz](https://x402.biwas.xyz) | [/analytics](https://x402.biwas.xyz/analytics) |
47+
| **StacksScan** | [scan.stacksx402.com](https://scan.stacksx402.com) | — |
7548

7649
## Blockchain APIs
7750

7851
### Hiro API
7952

80-
Official Stacks blockchain API for transaction data, address lookups, and contract interactions.
81-
82-
| Environment | Base URL | Docs |
83-
|-------------|----------|------|
84-
| **Mainnet** | `https://api.hiro.so` | [docs.hiro.so](https://docs.hiro.so) |
85-
| **Testnet** | `https://api.testnet.hiro.so` | [docs.hiro.so](https://docs.hiro.so) |
86-
87-
**Key endpoints for x402:**
88-
89-
- `GET /extended/v1/tx/{txid}` — Fetch transaction details
90-
- `POST /v2/transactions` — Broadcast signed transactions
91-
- `GET /extended/v1/address/{principal}/balances` — Check token balances
53+
| Environment | Base URL |
54+
|-------------|----------|
55+
| **Mainnet** | `https://api.hiro.so` |
56+
| **Testnet** | `https://api.testnet.hiro.so` |
9257

93-
Free API keys available at [platform.hiro.so](https://platform.hiro.so).
58+
**Key endpoints:**
59+
- `GET /extended/v1/tx/{txid}` — Transaction details
60+
- `POST /v2/transactions` — Broadcast transactions
61+
- `GET /extended/v1/address/{principal}/balances` — Token balances
9462

95-
### Stacks Node RPC
96-
97-
Direct node access for advanced use cases.
98-
99-
| Environment | URL |
100-
|-------------|-----|
101-
| **Mainnet** | `https://stacks-node-api.mainnet.stacks.co` |
102-
| **Testnet** | `https://stacks-node-api.testnet.stacks.co` |
103-
104-
## Development Resources
105-
106-
### Faucets
107-
108-
| Resource | URL |
109-
|----------|-----|
110-
| **STX Testnet Faucet** | [explorer.hiro.so/sandbox/faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet) |
111-
| **sBTC Testnet** | [bridge.sbtc.tech](https://bridge.sbtc.tech) (testnet mode) |
63+
Free API keys at [platform.hiro.so](https://platform.hiro.so). Full docs at [docs.hiro.so](https://docs.hiro.so).
11264

11365
### Block Explorers
11466

11567
| Explorer | Mainnet | Testnet |
11668
|----------|---------|---------|
117-
| **Hiro Explorer** | [explorer.hiro.so](https://explorer.hiro.so) | [explorer.hiro.so/?chain=testnet](https://explorer.hiro.so/?chain=testnet) |
69+
| **Hiro** | [explorer.hiro.so](https://explorer.hiro.so) | [explorer.hiro.so/?chain=testnet](https://explorer.hiro.so/?chain=testnet) |
11870

119-
## See Also
71+
## Faucets (Testnet)
12072

121-
- [Token Reference](/reference/tokens/) — Contract addresses and identifiers
122-
- [Directory](/directory/) — Services and tools
123-
- [Glossary](/glossary/) — Term definitions
73+
- **STX** — [explorer.hiro.so/sandbox/faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet)
74+
- **sBTC** — [bridge.sbtc.tech](https://bridge.sbtc.tech) (testnet mode)

0 commit comments

Comments
 (0)