From 50fb1c6b1b7dd1390fe65d10499cd24b80e588ed Mon Sep 17 00:00:00 2001 From: Jason Schrader Date: Wed, 28 Jan 2026 05:40:17 -0700 Subject: [PATCH 1/2] docs: restructure as canonical reference layer MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replace tutorial/guide content with reference documentation that ties together the AIBTC ecosystem. Landing page (aibtc.com) handles getting started; docs.aibtc.com is now the "phone book" for looking things up. New structure: - /directory/ — Services, tools, SDKs, templates, repositories - /reference/tokens/ — Contract addresses, CAIP identifiers, decimals - /reference/networks/ — Mainnet/testnet configs, API endpoints - /glossary/ — Term definitions (unchanged) Removed: - /guides/what-is-x402/ — Landing page covers this better - /guides/services/ — Replaced by /directory/ - /guides/tokens/ — Replaced by /reference/tokens/ Homepage redesigned as navigation hub with quick reference tables. Closes #2 Co-Authored-By: Claude Opus 4.5 --- astro.config.mjs | 5 +- src/content/docs/directory/index.md | 75 +++++++++++++++ src/content/docs/guides/services.md | 65 ------------- src/content/docs/guides/tokens.md | 41 -------- src/content/docs/guides/what-is-x402.md | 43 --------- src/content/docs/index.mdx | 78 ++++++++++----- src/content/docs/reference/index.md | 19 ++++ src/content/docs/reference/networks.md | 123 ++++++++++++++++++++++++ src/content/docs/reference/tokens.md | 87 +++++++++++++++++ 9 files changed, 360 insertions(+), 176 deletions(-) create mode 100644 src/content/docs/directory/index.md delete mode 100644 src/content/docs/guides/services.md delete mode 100644 src/content/docs/guides/tokens.md delete mode 100644 src/content/docs/guides/what-is-x402.md create mode 100644 src/content/docs/reference/index.md create mode 100644 src/content/docs/reference/networks.md create mode 100644 src/content/docs/reference/tokens.md diff --git a/astro.config.mjs b/astro.config.mjs index a992304..f296501 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -26,9 +26,10 @@ export default defineConfig({ { icon: 'x.com', label: 'X', href: 'https://x.com/aibtcdev' }, ], sidebar: [ + { label: 'Directory', slug: 'directory' }, { - label: 'Guides', - autogenerate: { directory: 'guides' }, + label: 'Reference', + autogenerate: { directory: 'reference' }, }, { label: 'Glossary', slug: 'glossary' }, ], diff --git a/src/content/docs/directory/index.md b/src/content/docs/directory/index.md new file mode 100644 index 0000000..ffe5549 --- /dev/null +++ b/src/content/docs/directory/index.md @@ -0,0 +1,75 @@ +--- +title: Directory +description: Find services, tools, SDKs, and repositories in the AIBTC ecosystem. +sidebar: + order: 0 +--- + +Everything in the AIBTC x402 ecosystem, organized by what you need. + +## Services + +Live endpoints and platforms you can use today. + +| Service | Description | Links | +|---------|-------------|-------| +| **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) | +| **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) | +| **STX402** | x402 endpoint registry and ecosystem directory | [Live](https://stx402.com) · [Docs](https://stx402.com/docs) | +| **x402 Biwas** | AI-powered DeFi analytics for Stacks | [Live](https://x402.biwas.xyz) | +| **StacksScan** | x402 ecosystem explorer and stats | [Live](https://scan.stacksx402.com) | +| **Facilitator** | Payment verification and settlement | [Live](https://facilitator.stacksx402.com) | + +## Tools & SDKs + +Libraries and tools for building with x402. + +| Tool | Description | Links | +|------|-------------|-------| +| **@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) | +| **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) | +| **Stacks.js** | Official Stacks JavaScript libraries | [Docs](https://stacks.js.org) · [GitHub](https://github.com/hirosystems/stacks.js) | + +## Templates & Examples + +Starting points for building x402 services. + +| Template | Description | Links | +|----------|-------------|-------| +| **x402-api** | Cloudflare Workers template for paid API endpoints | [GitHub](https://github.com/aibtcdev/x402-api) | +| **x402-crosschain-example** | Express/Hono example with EVM + Stacks | [GitHub](https://github.com/aibtcdev/x402-crosschain-example) | +| **x402-sponsor-relay** | Sponsored transaction relay implementation | [GitHub](https://github.com/aibtcdev/x402-sponsor-relay) | + +## Repositories + +All AIBTC open source projects. + +| Repo | Description | +|------|-------------| +| [**aibtcdev/aibtc-mcp-server**](https://github.com/aibtcdev/aibtc-mcp-server) | MCP server for Claude Code | +| [**aibtcdev/x402-api**](https://github.com/aibtcdev/x402-api) | x402 API service and template | +| [**aibtcdev/x402-sponsor-relay**](https://github.com/aibtcdev/x402-sponsor-relay) | Gasless transaction relay | +| [**aibtcdev/x402-crosschain-example**](https://github.com/aibtcdev/x402-crosschain-example) | Crosschain x402 example | +| [**aibtcdev/docs**](https://github.com/aibtcdev/docs) | This documentation site | +| [**aibtcdev/branding**](https://github.com/aibtcdev/branding) | Brand assets and guidelines | +| [**aibtcdev/landing-page**](https://github.com/aibtcdev/landing-page) | aibtc.com website | + +**See all:** [github.com/aibtcdev](https://github.com/aibtcdev) + +## External Resources + +Key resources outside the AIBTC ecosystem. + +| Resource | Description | Link | +|----------|-------------|------| +| **x402 Protocol** | HTTP 402 payment protocol specification | [x402.org](https://x402.org) | +| **Stacks Docs** | Official Stacks blockchain documentation | [docs.stacks.co](https://docs.stacks.co) | +| **Hiro Platform** | Stacks API keys and developer tools | [platform.hiro.so](https://platform.hiro.so) | +| **Claude Code** | AI coding assistant from Anthropic | [claude.ai/code](https://claude.ai/code) | +| **sBTC** | Bitcoin on Stacks | [stacks.co/sbtc](https://www.stacks.co/sbtc) | + +## See Also + +- [Token Reference](/reference/tokens/) — Contract addresses and identifiers +- [Network Reference](/reference/networks/) — Endpoints and configurations +- [Glossary](/glossary/) — Term definitions diff --git a/src/content/docs/guides/services.md b/src/content/docs/guides/services.md deleted file mode 100644 index f911849..0000000 --- a/src/content/docs/guides/services.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Services & Tools -description: An overview of every service in the AIBTC x402 ecosystem. -sidebar: - order: 2 ---- - -import { Aside } from '@astrojs/starlight/components'; - -The AIBTC ecosystem is a collection of services that work together to let AI agents pay for API access with blockchain tokens. Here's what's available. - -## AIBTC x402 API - -The main product. A pay-per-use API that gives agents access to AI inference, blockchain lookups, cryptographic hashing, and persistent storage — all payable with STX, sBTC, or USDCx. - -- **Mainnet:** [x402.aibtc.com](https://x402.aibtc.com) -- **Testnet:** [x402.aibtc.dev](https://x402.aibtc.dev) -- **Dashboard:** [dash.aibtc.com](https://dash.aibtc.com) / [dash.aibtc.dev](https://dash.aibtc.dev) - -## Sponsor Relay - -Not every agent holds STX for network fees. The Sponsor Relay covers transaction fees on behalf of agents so they can operate "gasless." The agent still pays for the API call — the relay just picks up the small Stacks network fee. - -- **Mainnet:** [x402-relay.aibtc.com](https://x402-relay.aibtc.com) -- **Testnet:** [x402-relay.aibtc.dev](https://x402-relay.aibtc.dev) - -## STX402 - -An independent x402 registry service that tracks endpoints, pricing, and payment activity across the x402 ecosystem on Stacks. - -- **Live:** [stx402.com](https://stx402.com) -- **Dashboard:** [dash.stx402.com](https://dash.stx402.com) - -## x402 Biwas - -AI-powered analytics for DeFi activity on Stacks. Biwas uses x402 payments to deliver real-time insights and market intelligence. - -- **Live:** [x402.biwas.xyz](https://x402.biwas.xyz) - -## StacksScan Explorer - -An ecosystem explorer that surfaces x402 activity, service stats, and network health across the AIBTC infrastructure. - -- **Live:** [scan.stacksx402.com](https://scan.stacksx402.com) - -## Facilitator - -The behind-the-scenes payment verification service. When an agent sends a signed payment, the facilitator confirms the transaction is valid before the API releases the response. You won't interact with it directly — it just makes everything work. - -- **Live:** [facilitator.stacksx402.com](https://facilitator.stacksx402.com) - -## Quick reference - -| Service | Live URL | Dashboard | -|---------|----------|-----------| -| x402 API | [x402.aibtc.com](https://x402.aibtc.com) | [dash.aibtc.com](https://dash.aibtc.com) | -| Sponsor Relay | [x402-relay.aibtc.com](https://x402-relay.aibtc.com) | — | -| STX402 | [stx402.com](https://stx402.com) | [dash.stx402.com](https://dash.stx402.com) | -| x402 Biwas | [x402.biwas.xyz](https://x402.biwas.xyz) | — | -| StacksScan | [scan.stacksx402.com](https://scan.stacksx402.com) | — | -| Facilitator | [facilitator.stacksx402.com](https://facilitator.stacksx402.com) | — | - - diff --git a/src/content/docs/guides/tokens.md b/src/content/docs/guides/tokens.md deleted file mode 100644 index 6a6b5b8..0000000 --- a/src/content/docs/guides/tokens.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Supported Tokens -description: The tokens you can use to pay for x402 API requests on Stacks. -sidebar: - order: 3 ---- - -import { Aside } from '@astrojs/starlight/components'; - -x402 on Stacks accepts three tokens for payment. Each has different strengths depending on your use case. - -## STX - -The native token of the [Stacks](https://www.stacks.co/) blockchain. Every Stacks transaction uses STX for network fees, and it's the most widely available token in the ecosystem. Available on both mainnet and testnet. - -## sBTC - -Bitcoin on Stacks, backed 1:1 by real BTC. If you want to pay with Bitcoin value without leaving the Stacks network, sBTC is the way to do it. Available on both mainnet and testnet. - -## USDCx - -A bridged US dollar stablecoin on Stacks. Because its value is pegged to USD, your API costs stay predictable regardless of crypto market movement. Currently available on mainnet only. - -## Where to get tokens - -- **STX** — Available on major exchanges. Transfer to a Stacks-compatible wallet. -- **sBTC** — Bridge BTC to Stacks using the [sBTC bridge](https://bridge.sbtc.tech/). -- **USDCx** — Bridge USDC to Stacks from supported networks. -- **Testnet tokens** — Get free test STX and sBTC from the [Stacks testnet faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet). - -## Which token should I use? - -| Token | Best for | Networks | -|-------|----------|----------| -| **STX** | General use, lowest friction | Mainnet, Testnet | -| **sBTC** | Paying with Bitcoin value | Mainnet, Testnet | -| **USDCx** | Predictable dollar-denominated costs | Mainnet only | - - diff --git a/src/content/docs/guides/what-is-x402.md b/src/content/docs/guides/what-is-x402.md deleted file mode 100644 index 1958f7b..0000000 --- a/src/content/docs/guides/what-is-x402.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: What is x402? -description: A quick introduction to x402 — the pay-per-request protocol for AI agents. -sidebar: - order: 1 ---- - -import { LinkCard } from '@astrojs/starlight/components'; - -## The problem - -AI agents need access to APIs — for inference, blockchain data, storage, and more. Traditional billing (API keys, monthly invoices, subscriptions) doesn't work well when autonomous agents are making thousands of small requests across many services. There's no human around to manage accounts or approve charges. - -## How x402 works - -The [x402 protocol](https://www.x402.org/) turns every API call into a simple payment flow: - -1. An agent sends a request to a protected API endpoint. -2. The server replies with HTTP status **402 Payment Required**, along with the price and accepted tokens. -3. The agent signs a blockchain transaction for the exact amount. -4. The agent resends the original request with the signed payment attached as a header. -5. The server verifies the payment and returns the data. - -No API keys. No accounts. No invoices. The agent pays exactly what it uses, one request at a time. - -## Why Stacks? - -AIBTC builds on [Stacks](https://www.stacks.co/), a Bitcoin Layer 2 with smart contracts and fast block times. Stacks settles to Bitcoin, giving you the security of the Bitcoin network while supporting the programmable payments x402 requires. That means agents can pay with Bitcoin-backed assets in near real-time. - -## What you can pay with - -x402 on Stacks supports three tokens: - -- **STX** — The native Stacks token. Used for transaction fees and API payments. -- **sBTC** — Bitcoin on Stacks, backed 1:1 by BTC. Pay with real Bitcoin value. -- **USDCx** — A US dollar stablecoin on Stacks. Predictable, dollar-denominated costs. - -Learn more on the [Supported Tokens](/guides/tokens/) page. - -## Next steps - - - diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 18d8917..c4ad8e2 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -1,44 +1,72 @@ --- -title: AIBTC Documentation -description: Documentation for the AIBTC ecosystem - pay-per-use APIs for AI agents. +title: AIBTC Docs +description: Reference documentation for the AIBTC x402 ecosystem. template: splash hero: - tagline: Pay-per-use APIs for AI agents, powered by Bitcoin. + tagline: Reference docs for the x402 ecosystem on Stacks. actions: - - text: Get Started - link: /guides/what-is-x402/ + - text: Directory + link: /directory/ icon: right-arrow - - text: GitHub - link: https://github.com/aibtcdev + - text: Start Building + link: https://aibtc.com icon: external variant: minimal --- import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components'; -AIBTC builds tools that let AI agents pay for the APIs they use, one request at a time. No subscriptions, no API keys, no invoices — just blockchain-verified micropayments. +## Find What You Need -## What's in the ecosystem + + + + + + + +## Quick Reference + +### Payment Tokens + +| Token | Mainnet Contract | Testnet Contract | +|-------|------------------|------------------| +| **STX** | Native | Native | +| **sBTC** | `SM3VDXK3WZZSA84...sbtc-token` | `ST1F7QA2MDF17S8...sbtc-token` | +| **USDCx** | `SP120SBRBQJ00MC...usdcx` | — | + +[Full token reference →](/reference/tokens/) + +### Service Endpoints + +| Service | Mainnet | Testnet | +|---------|---------|---------| +| **x402 API** | [x402.aibtc.com](https://x402.aibtc.com) | [x402.aibtc.dev](https://x402.aibtc.dev) | +| **Sponsor Relay** | [x402-relay.aibtc.com](https://x402-relay.aibtc.com) | [x402-relay.aibtc.dev](https://x402-relay.aibtc.dev) | +| **Facilitator** | [facilitator.stacksx402.com](https://facilitator.stacksx402.com) | — | + +[Full network reference →](/reference/networks/) + +## Getting Started + +New to AIBTC? Start at [aibtc.com](https://aibtc.com) for the interactive tutorial. - - Pay-per-use endpoints for AI inference, blockchain data, hashing, and storage. Agents pay with STX, sBTC, or USDCx per request. - - - Gasless transactions for AI agents. A sponsor covers network fees so agents can operate without holding STX for gas. + + ```bash + curl -fsSL https://claude.ai/code/install.sh | sh + ``` - - Ecosystem explorer for x402 activity, service stats, and network health across the AIBTC infrastructure. - - - Pay with STX, sBTC, or USDCx. Each token fits a different use case — from general purpose to dollar-stable pricing. + + ```bash + npm install -g @aibtc/mcp-server + ``` -## Quick Links +## Community - - - - - +- [Weekly Working Group Calls](https://www.addevent.com/event/UM20108233) +- [AIBTC Discord](https://discord.gg/5DJaBrf) +- [GitHub](https://github.com/aibtcdev) +- [X / Twitter](https://x.com/aibtcdev) diff --git a/src/content/docs/reference/index.md b/src/content/docs/reference/index.md new file mode 100644 index 0000000..df581f2 --- /dev/null +++ b/src/content/docs/reference/index.md @@ -0,0 +1,19 @@ +--- +title: Reference +description: Canonical reference for the AIBTC x402 ecosystem. +sidebar: + order: 0 +--- + +Technical reference for tokens, networks, and configurations used across the AIBTC ecosystem. + +## Quick Links + +- [**Token Reference**](/reference/tokens/) — Contract addresses, CAIP identifiers, where to get tokens +- [**Network Reference**](/reference/networks/) — Mainnet/testnet configs, API endpoints, service URLs + +## Looking for Something Else? + +- [**Directory**](/directory/) — Find services, tools, SDKs, and repos +- [**Glossary**](/glossary/) — Term definitions and concepts +- [**aibtc.com**](https://aibtc.com) — Getting started tutorial diff --git a/src/content/docs/reference/networks.md b/src/content/docs/reference/networks.md new file mode 100644 index 0000000..dfbd3df --- /dev/null +++ b/src/content/docs/reference/networks.md @@ -0,0 +1,123 @@ +--- +title: Network Reference +description: Mainnet and testnet configurations, endpoints, and identifiers. +sidebar: + order: 2 +--- + +Canonical reference for Stacks network configurations used in the AIBTC x402 ecosystem. + +## Network Overview + +| Property | Mainnet | Testnet | +|----------|---------|---------| +| **CAIP-2 ID** | `stacks:1` | `stacks:2147483648` | +| **Chain ID** | `1` | `2147483648` | +| **Address prefix** | `SP` / `SM` | `ST` / `SN` | +| **Block time** | ~5 seconds | ~5 seconds | +| **Bitcoin anchor** | Bitcoin mainnet | Bitcoin testnet | + +## AIBTC Service Endpoints + +### x402 API + +Pay-per-use API for AI inference, blockchain data, hashing, and storage. + +| Environment | Base URL | Dashboard | Docs | +|-------------|----------|-----------|------| +| **Mainnet** | `https://x402.aibtc.com` | [dash.aibtc.com](https://dash.aibtc.com) | [/docs](https://x402.aibtc.com/docs) | +| **Testnet** | `https://x402.aibtc.dev` | [dash.aibtc.dev](https://dash.aibtc.dev) | [/docs](https://x402.aibtc.dev/docs) | + +### Sponsor Relay + +Gasless transaction relay — sponsors cover network fees for agents. + +| Environment | Base URL | Docs | +|-------------|----------|------| +| **Mainnet** | `https://x402-relay.aibtc.com` | [/docs](https://x402-relay.aibtc.com/docs) | +| **Testnet** | `https://x402-relay.aibtc.dev` | [/docs](https://x402-relay.aibtc.dev/docs) | + +### Facilitator + +Payment verification and settlement service. + +| Environment | Base URL | Health Check | +|-------------|----------|--------------| +| **Production** | `https://facilitator.stacksx402.com` | [/health](https://facilitator.stacksx402.com/health) | + +## Ecosystem Services + +### STX402 + +Independent x402 registry and endpoint directory. + +| Resource | URL | +|----------|-----| +| **Endpoints** | [stx402.com](https://stx402.com) | +| **Dashboard** | [stx402.com/dashboard](https://stx402.com/dashboard) | +| **Docs** | [stx402.com/docs](https://stx402.com/docs) | + +### x402 Biwas + +AI-powered DeFi analytics for Stacks. + +| Resource | URL | +|----------|-----| +| **Endpoints** | [x402.biwas.xyz](https://x402.biwas.xyz) | + +### StacksScan Explorer + +Ecosystem explorer for x402 activity and stats. + +| Resource | URL | +|----------|-----| +| **Explorer** | [scan.stacksx402.com](https://scan.stacksx402.com) | + +## Blockchain APIs + +### Hiro API + +Official Stacks blockchain API for transaction data, address lookups, and contract interactions. + +| Environment | Base URL | Docs | +|-------------|----------|------| +| **Mainnet** | `https://api.hiro.so` | [docs.hiro.so](https://docs.hiro.so) | +| **Testnet** | `https://api.testnet.hiro.so` | [docs.hiro.so](https://docs.hiro.so) | + +**Key endpoints for x402:** + +- `GET /extended/v1/tx/{txid}` — Fetch transaction details +- `POST /v2/transactions` — Broadcast signed transactions +- `GET /extended/v1/address/{principal}/balances` — Check token balances + +Free API keys available at [platform.hiro.so](https://platform.hiro.so). + +### Stacks Node RPC + +Direct node access for advanced use cases. + +| Environment | URL | +|-------------|-----| +| **Mainnet** | `https://stacks-node-api.mainnet.stacks.co` | +| **Testnet** | `https://stacks-node-api.testnet.stacks.co` | + +## Development Resources + +### Faucets + +| Resource | URL | +|----------|-----| +| **STX Testnet Faucet** | [explorer.hiro.so/sandbox/faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet) | +| **sBTC Testnet** | [bridge.sbtc.tech](https://bridge.sbtc.tech) (testnet mode) | + +### Block Explorers + +| Explorer | Mainnet | Testnet | +|----------|---------|---------| +| **Hiro Explorer** | [explorer.hiro.so](https://explorer.hiro.so) | [explorer.hiro.so/?chain=testnet](https://explorer.hiro.so/?chain=testnet) | + +## See Also + +- [Token Reference](/reference/tokens/) — Contract addresses and identifiers +- [Directory](/directory/) — Services and tools +- [Glossary](/glossary/) — Term definitions diff --git a/src/content/docs/reference/tokens.md b/src/content/docs/reference/tokens.md new file mode 100644 index 0000000..6e5834c --- /dev/null +++ b/src/content/docs/reference/tokens.md @@ -0,0 +1,87 @@ +--- +title: Token Reference +description: Contract addresses, identifiers, and specifications for x402 payment tokens. +sidebar: + order: 1 +--- + +Canonical reference for tokens supported in the AIBTC x402 ecosystem. + +## Supported Tokens + +| Token | Type | Decimals | Mainnet | Testnet | +|-------|------|----------|---------|---------| +| **STX** | Native | 6 | Native | Native | +| **sBTC** | SIP-010 | 8 | Yes | Yes | +| **USDCx** | SIP-010 | 6 | Yes | No | + +## Contract Addresses + +### STX + +Native token — no contract address required. + +- **Mainnet:** Native +- **Testnet:** Native + +### sBTC + +Bitcoin on Stacks, backed 1:1 by BTC. + +| Network | Contract ID | +|---------|-------------| +| **Mainnet** | `SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token` | +| **Testnet** | `ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-token` | + +**Asset identifier:** `::sbtc-token` + +### USDCx + +Bridged USDC stablecoin on Stacks. + +| Network | Contract ID | +|---------|-------------| +| **Mainnet** | `SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx` | +| **Testnet** | Not deployed | + +**Asset identifier:** `::usdcx-token` + +## CAIP-19 Asset Identifiers + +[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) provides chain-agnostic asset identification. + +| Token | Mainnet | Testnet | +|-------|---------|---------| +| **STX** | `stacks:1/native:STX` | `stacks:2147483648/native:STX` | +| **sBTC** | `stacks:1/sip010:SM3VDX...sbtc-token` | `stacks:2147483648/sip010:ST1F7Q...sbtc-token` | +| **USDCx** | `stacks:1/sip010:SP120S...usdcx` | — | + +## Where to Get Tokens + +### Mainnet + +- **STX** — Available on major exchanges (Coinbase, Binance, OKX, etc.). Transfer to a Stacks wallet. +- **sBTC** — Bridge BTC using [bridge.sbtc.tech](https://bridge.sbtc.tech) +- **USDCx** — Bridge USDC via supported bridges + +### Testnet + +Free test tokens for development: + +- **STX** — [Stacks Testnet Faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet) +- **sBTC** — [sBTC Testnet Faucet](https://bridge.sbtc.tech) (testnet mode) + +## Token Standards + +All fungible tokens on Stacks follow [SIP-010](https://github.com/stacksgov/sips/blob/main/sips/sip-010/sip-010-fungible-token-standard.md), which defines: + +- `transfer` — Move tokens between addresses +- `get-balance` — Check balance for an address +- `get-total-supply` — Total circulating supply +- `get-name` / `get-symbol` / `get-decimals` — Token metadata + +## See Also + +- [Network Reference](/reference/networks/) — Mainnet/testnet configurations +- [Directory](/directory/) — Services and tools +- [Glossary](/glossary/) — Term definitions From 653cb2018f9d71c1e5523fb07d11cd8d29124e56 Mon Sep 17 00:00:00 2001 From: Jason Schrader Date: Wed, 28 Jan 2026 08:46:35 -0700 Subject: [PATCH 2/2] 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 --- astro.config.mjs | 6 +- src/content/docs/directory/index.md | 94 ++++++++------------ src/content/docs/index.mdx | 43 ++------- src/content/docs/reference/index.md | 19 ---- src/content/docs/reference/networks.md | 117 +++++++------------------ src/content/docs/reference/tokens.md | 49 ++++------- 6 files changed, 98 insertions(+), 230 deletions(-) delete mode 100644 src/content/docs/reference/index.md diff --git a/astro.config.mjs b/astro.config.mjs index f296501..c8482e2 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -27,10 +27,8 @@ export default defineConfig({ ], sidebar: [ { label: 'Directory', slug: 'directory' }, - { - label: 'Reference', - autogenerate: { directory: 'reference' }, - }, + { label: 'Tokens', slug: 'reference/tokens' }, + { label: 'Networks', slug: 'reference/networks' }, { label: 'Glossary', slug: 'glossary' }, ], }), diff --git a/src/content/docs/directory/index.md b/src/content/docs/directory/index.md index ffe5549..310cd57 100644 --- a/src/content/docs/directory/index.md +++ b/src/content/docs/directory/index.md @@ -1,75 +1,53 @@ --- title: Directory -description: Find services, tools, SDKs, and repositories in the AIBTC ecosystem. -sidebar: - order: 0 +description: Services, tools, and templates in the AIBTC ecosystem. --- -Everything in the AIBTC x402 ecosystem, organized by what you need. +## AIBTC Services -## Services +All AIBTC services follow the same pattern: **mainnet** on `aibtc.com`, **testnet** on `aibtc.dev`. -Live endpoints and platforms you can use today. +| Service | Mainnet | Testnet | Source | +|---------|---------|---------|--------| +| **x402 API** | [x402.aibtc.com](https://x402.aibtc.com) | [x402.aibtc.dev](https://x402.aibtc.dev) | [GitHub](https://github.com/aibtcdev/x402-api) | +| **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) | -| Service | Description | Links | -|---------|-------------|-------| -| **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) | -| **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) | -| **STX402** | x402 endpoint registry and ecosystem directory | [Live](https://stx402.com) · [Docs](https://stx402.com/docs) | -| **x402 Biwas** | AI-powered DeFi analytics for Stacks | [Live](https://x402.biwas.xyz) | -| **StacksScan** | x402 ecosystem explorer and stats | [Live](https://scan.stacksx402.com) | -| **Facilitator** | Payment verification and settlement | [Live](https://facilitator.stacksx402.com) | +**x402 API endpoints:** +- `/` — Health check +- `/docs` — OpenAPI documentation +- `/dashboard` — Usage stats and analytics -## Tools & SDKs +**Sponsor Relay endpoints:** +- `/` — Health check +- `/docs` — OpenAPI documentation + +## Ecosystem Services + +| Service | URL | Description | +|---------|-----|-------------| +| **STX402** | [stx402.com](https://stx402.com) | x402 endpoint registry ([/docs](https://stx402.com/docs), [/dashboard](https://stx402.com/dashboard)) | +| **x402 Biwas** | [x402.biwas.xyz](https://x402.biwas.xyz) | AI-powered DeFi analytics ([/analytics](https://x402.biwas.xyz/analytics)) | +| **StacksScan** | [scan.stacksx402.com](https://scan.stacksx402.com) | x402 ecosystem explorer | +| **Facilitator** | [facilitator.stacksx402.com/health](https://facilitator.stacksx402.com/health) | Payment verification service | -Libraries and tools for building with x402. +## Tools & SDKs | Tool | Description | Links | |------|-------------|-------| -| **@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) | -| **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) | +| **@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) | +| **x402-stacks** | TypeScript SDK for x402 payments | [npm](https://www.npmjs.com/package/x402-stacks) · [GitHub](https://github.com/tony1908/x402-stacks-sdk) | | **Stacks.js** | Official Stacks JavaScript libraries | [Docs](https://stacks.js.org) · [GitHub](https://github.com/hirosystems/stacks.js) | -## Templates & Examples - -Starting points for building x402 services. - -| Template | Description | Links | -|----------|-------------|-------| -| **x402-api** | Cloudflare Workers template for paid API endpoints | [GitHub](https://github.com/aibtcdev/x402-api) | -| **x402-crosschain-example** | Express/Hono example with EVM + Stacks | [GitHub](https://github.com/aibtcdev/x402-crosschain-example) | -| **x402-sponsor-relay** | Sponsored transaction relay implementation | [GitHub](https://github.com/aibtcdev/x402-sponsor-relay) | - -## Repositories - -All AIBTC open source projects. - -| Repo | Description | -|------|-------------| -| [**aibtcdev/aibtc-mcp-server**](https://github.com/aibtcdev/aibtc-mcp-server) | MCP server for Claude Code | -| [**aibtcdev/x402-api**](https://github.com/aibtcdev/x402-api) | x402 API service and template | -| [**aibtcdev/x402-sponsor-relay**](https://github.com/aibtcdev/x402-sponsor-relay) | Gasless transaction relay | -| [**aibtcdev/x402-crosschain-example**](https://github.com/aibtcdev/x402-crosschain-example) | Crosschain x402 example | -| [**aibtcdev/docs**](https://github.com/aibtcdev/docs) | This documentation site | -| [**aibtcdev/branding**](https://github.com/aibtcdev/branding) | Brand assets and guidelines | -| [**aibtcdev/landing-page**](https://github.com/aibtcdev/landing-page) | aibtc.com website | - -**See all:** [github.com/aibtcdev](https://github.com/aibtcdev) - -## External Resources - -Key resources outside the AIBTC ecosystem. +## Templates -| Resource | Description | Link | -|----------|-------------|------| -| **x402 Protocol** | HTTP 402 payment protocol specification | [x402.org](https://x402.org) | -| **Stacks Docs** | Official Stacks blockchain documentation | [docs.stacks.co](https://docs.stacks.co) | -| **Hiro Platform** | Stacks API keys and developer tools | [platform.hiro.so](https://platform.hiro.so) | -| **Claude Code** | AI coding assistant from Anthropic | [claude.ai/code](https://claude.ai/code) | -| **sBTC** | Bitcoin on Stacks | [stacks.co/sbtc](https://www.stacks.co/sbtc) | +| Template | Description | Source | +|----------|-------------|--------| +| **x402-api** | Cloudflare Workers template for paid endpoints | [GitHub](https://github.com/aibtcdev/x402-api) | +| **x402-crosschain-example** | Express/Hono with EVM + Stacks | [GitHub](https://github.com/aibtcdev/x402-crosschain-example) | -## See Also +## More -- [Token Reference](/reference/tokens/) — Contract addresses and identifiers -- [Network Reference](/reference/networks/) — Endpoints and configurations -- [Glossary](/glossary/) — Term definitions +- **All AIBTC repositories:** [github.com/aibtcdev](https://github.com/aibtcdev) +- **x402 Protocol spec:** [x402.org](https://x402.org) +- **Stacks documentation:** [docs.stacks.co](https://docs.stacks.co) +- **Claude Code:** [claude.ai/code](https://claude.ai/code) diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index c4ad8e2..3a92096 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -14,20 +14,18 @@ hero: variant: minimal --- -import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components'; - -## Find What You Need +import { LinkCard, CardGrid } from '@astrojs/starlight/components'; - - - - + + + + ## Quick Reference -### Payment Tokens +### Tokens | Token | Mainnet Contract | Testnet Contract | |-------|------------------|------------------| @@ -35,38 +33,13 @@ import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components'; | **sBTC** | `SM3VDXK3WZZSA84...sbtc-token` | `ST1F7QA2MDF17S8...sbtc-token` | | **USDCx** | `SP120SBRBQJ00MC...usdcx` | — | -[Full token reference →](/reference/tokens/) - -### Service Endpoints +### Endpoints | Service | Mainnet | Testnet | |---------|---------|---------| | **x402 API** | [x402.aibtc.com](https://x402.aibtc.com) | [x402.aibtc.dev](https://x402.aibtc.dev) | | **Sponsor Relay** | [x402-relay.aibtc.com](https://x402-relay.aibtc.com) | [x402-relay.aibtc.dev](https://x402-relay.aibtc.dev) | -| **Facilitator** | [facilitator.stacksx402.com](https://facilitator.stacksx402.com) | — | - -[Full network reference →](/reference/networks/) - -## Getting Started - -New to AIBTC? Start at [aibtc.com](https://aibtc.com) for the interactive tutorial. - - - - ```bash - curl -fsSL https://claude.ai/code/install.sh | sh - ``` - - - ```bash - npm install -g @aibtc/mcp-server - ``` - - ## Community -- [Weekly Working Group Calls](https://www.addevent.com/event/UM20108233) -- [AIBTC Discord](https://discord.gg/5DJaBrf) -- [GitHub](https://github.com/aibtcdev) -- [X / Twitter](https://x.com/aibtcdev) +- [Weekly Calls](https://www.addevent.com/event/UM20108233) · [Discord](https://discord.gg/5DJaBrf) · [GitHub](https://github.com/aibtcdev) · [X](https://x.com/aibtcdev) diff --git a/src/content/docs/reference/index.md b/src/content/docs/reference/index.md deleted file mode 100644 index df581f2..0000000 --- a/src/content/docs/reference/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Reference -description: Canonical reference for the AIBTC x402 ecosystem. -sidebar: - order: 0 ---- - -Technical reference for tokens, networks, and configurations used across the AIBTC ecosystem. - -## Quick Links - -- [**Token Reference**](/reference/tokens/) — Contract addresses, CAIP identifiers, where to get tokens -- [**Network Reference**](/reference/networks/) — Mainnet/testnet configs, API endpoints, service URLs - -## Looking for Something Else? - -- [**Directory**](/directory/) — Find services, tools, SDKs, and repos -- [**Glossary**](/glossary/) — Term definitions and concepts -- [**aibtc.com**](https://aibtc.com) — Getting started tutorial diff --git a/src/content/docs/reference/networks.md b/src/content/docs/reference/networks.md index dfbd3df..923fa69 100644 --- a/src/content/docs/reference/networks.md +++ b/src/content/docs/reference/networks.md @@ -1,12 +1,8 @@ --- -title: Network Reference +title: Networks description: Mainnet and testnet configurations, endpoints, and identifiers. -sidebar: - order: 2 --- -Canonical reference for Stacks network configurations used in the AIBTC x402 ecosystem. - ## Network Overview | Property | Mainnet | Testnet | @@ -17,107 +13,62 @@ Canonical reference for Stacks network configurations used in the AIBTC x402 eco | **Block time** | ~5 seconds | ~5 seconds | | **Bitcoin anchor** | Bitcoin mainnet | Bitcoin testnet | -## AIBTC Service Endpoints +## AIBTC Endpoints -### x402 API +All AIBTC services: **mainnet** on `aibtc.com`, **testnet** on `aibtc.dev`. -Pay-per-use API for AI inference, blockchain data, hashing, and storage. +### x402 API -| Environment | Base URL | Dashboard | Docs | -|-------------|----------|-----------|------| -| **Mainnet** | `https://x402.aibtc.com` | [dash.aibtc.com](https://dash.aibtc.com) | [/docs](https://x402.aibtc.com/docs) | -| **Testnet** | `https://x402.aibtc.dev` | [dash.aibtc.dev](https://dash.aibtc.dev) | [/docs](https://x402.aibtc.dev/docs) | +| Endpoint | Mainnet | Testnet | +|----------|---------|---------| +| **Base** | `https://x402.aibtc.com` | `https://x402.aibtc.dev` | +| **Docs** | [/docs](https://x402.aibtc.com/docs) | [/docs](https://x402.aibtc.dev/docs) | +| **Dashboard** | [/dashboard](https://x402.aibtc.com/dashboard) | [/dashboard](https://x402.aibtc.dev/dashboard) | ### Sponsor Relay -Gasless transaction relay — sponsors cover network fees for agents. - -| Environment | Base URL | Docs | -|-------------|----------|------| -| **Mainnet** | `https://x402-relay.aibtc.com` | [/docs](https://x402-relay.aibtc.com/docs) | -| **Testnet** | `https://x402-relay.aibtc.dev` | [/docs](https://x402-relay.aibtc.dev/docs) | +| Endpoint | Mainnet | Testnet | +|----------|---------|---------| +| **Base** | `https://x402-relay.aibtc.com` | `https://x402-relay.aibtc.dev` | +| **Docs** | [/docs](https://x402-relay.aibtc.com/docs) | [/docs](https://x402-relay.aibtc.dev/docs) | ### Facilitator -Payment verification and settlement service. - -| Environment | Base URL | Health Check | -|-------------|----------|--------------| -| **Production** | `https://facilitator.stacksx402.com` | [/health](https://facilitator.stacksx402.com/health) | - -## Ecosystem Services - -### STX402 - -Independent x402 registry and endpoint directory. - -| Resource | URL | -|----------|-----| -| **Endpoints** | [stx402.com](https://stx402.com) | -| **Dashboard** | [stx402.com/dashboard](https://stx402.com/dashboard) | -| **Docs** | [stx402.com/docs](https://stx402.com/docs) | - -### x402 Biwas - -AI-powered DeFi analytics for Stacks. - -| Resource | URL | +| Endpoint | URL | |----------|-----| -| **Endpoints** | [x402.biwas.xyz](https://x402.biwas.xyz) | +| **Health** | [facilitator.stacksx402.com/health](https://facilitator.stacksx402.com/health) | -### StacksScan Explorer +## Ecosystem Endpoints -Ecosystem explorer for x402 activity and stats. - -| Resource | URL | -|----------|-----| -| **Explorer** | [scan.stacksx402.com](https://scan.stacksx402.com) | +| Service | Base URL | Additional | +|---------|----------|------------| +| **STX402** | [stx402.com](https://stx402.com) | [/docs](https://stx402.com/docs), [/dashboard](https://stx402.com/dashboard) | +| **x402 Biwas** | [x402.biwas.xyz](https://x402.biwas.xyz) | [/analytics](https://x402.biwas.xyz/analytics) | +| **StacksScan** | [scan.stacksx402.com](https://scan.stacksx402.com) | — | ## Blockchain APIs ### Hiro API -Official Stacks blockchain API for transaction data, address lookups, and contract interactions. - -| Environment | Base URL | Docs | -|-------------|----------|------| -| **Mainnet** | `https://api.hiro.so` | [docs.hiro.so](https://docs.hiro.so) | -| **Testnet** | `https://api.testnet.hiro.so` | [docs.hiro.so](https://docs.hiro.so) | - -**Key endpoints for x402:** - -- `GET /extended/v1/tx/{txid}` — Fetch transaction details -- `POST /v2/transactions` — Broadcast signed transactions -- `GET /extended/v1/address/{principal}/balances` — Check token balances +| Environment | Base URL | +|-------------|----------| +| **Mainnet** | `https://api.hiro.so` | +| **Testnet** | `https://api.testnet.hiro.so` | -Free API keys available at [platform.hiro.so](https://platform.hiro.so). +**Key endpoints:** +- `GET /extended/v1/tx/{txid}` — Transaction details +- `POST /v2/transactions` — Broadcast transactions +- `GET /extended/v1/address/{principal}/balances` — Token balances -### Stacks Node RPC - -Direct node access for advanced use cases. - -| Environment | URL | -|-------------|-----| -| **Mainnet** | `https://stacks-node-api.mainnet.stacks.co` | -| **Testnet** | `https://stacks-node-api.testnet.stacks.co` | - -## Development Resources - -### Faucets - -| Resource | URL | -|----------|-----| -| **STX Testnet Faucet** | [explorer.hiro.so/sandbox/faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet) | -| **sBTC Testnet** | [bridge.sbtc.tech](https://bridge.sbtc.tech) (testnet mode) | +Free API keys at [platform.hiro.so](https://platform.hiro.so). Full docs at [docs.hiro.so](https://docs.hiro.so). ### Block Explorers | Explorer | Mainnet | Testnet | |----------|---------|---------| -| **Hiro Explorer** | [explorer.hiro.so](https://explorer.hiro.so) | [explorer.hiro.so/?chain=testnet](https://explorer.hiro.so/?chain=testnet) | +| **Hiro** | [explorer.hiro.so](https://explorer.hiro.so) | [explorer.hiro.so/?chain=testnet](https://explorer.hiro.so/?chain=testnet) | -## See Also +## Faucets (Testnet) -- [Token Reference](/reference/tokens/) — Contract addresses and identifiers -- [Directory](/directory/) — Services and tools -- [Glossary](/glossary/) — Term definitions +- **STX** — [explorer.hiro.so/sandbox/faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet) +- **sBTC** — [bridge.sbtc.tech](https://bridge.sbtc.tech) (testnet mode) diff --git a/src/content/docs/reference/tokens.md b/src/content/docs/reference/tokens.md index 6e5834c..b855331 100644 --- a/src/content/docs/reference/tokens.md +++ b/src/content/docs/reference/tokens.md @@ -1,17 +1,13 @@ --- -title: Token Reference -description: Contract addresses, identifiers, and specifications for x402 payment tokens. -sidebar: - order: 1 +title: Tokens +description: Contract addresses and identifiers for x402 payment tokens. --- -Canonical reference for tokens supported in the AIBTC x402 ecosystem. - ## Supported Tokens | Token | Type | Decimals | Mainnet | Testnet | |-------|------|----------|---------|---------| -| **STX** | Native | 6 | Native | Native | +| **STX** | Native | 6 | Yes | Yes | | **sBTC** | SIP-010 | 8 | Yes | Yes | | **USDCx** | SIP-010 | 6 | Yes | No | @@ -19,10 +15,7 @@ Canonical reference for tokens supported in the AIBTC x402 ecosystem. ### STX -Native token — no contract address required. - -- **Mainnet:** Native -- **Testnet:** Native +Native token — no contract address. ### sBTC @@ -33,55 +26,49 @@ Bitcoin on Stacks, backed 1:1 by BTC. | **Mainnet** | `SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token` | | **Testnet** | `ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-token` | -**Asset identifier:** `::sbtc-token` +Asset identifier: `::sbtc-token` ### USDCx -Bridged USDC stablecoin on Stacks. +Bridged USDC via [Circle Xreserve](https://www.circle.com/xreserve) on Stacks. | Network | Contract ID | |---------|-------------| | **Mainnet** | `SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx` | | **Testnet** | Not deployed | -**Asset identifier:** `::usdcx-token` +Asset identifier: `::usdcx-token` + +**Bridging:** See [Stacks bridging documentation](https://docs.stacks.co/guides/bridge-assets-to-stacks) for how to bridge USDC to Stacks. ## CAIP-19 Asset Identifiers -[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) provides chain-agnostic asset identification. +[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) provides chain-agnostic asset identification. See [our CAIP-19 PR for Stacks](https://github.com/ChainAgnostic/namespaces/pull/167) for the full specification. | Token | Mainnet | Testnet | |-------|---------|---------| -| **STX** | `stacks:1/native:STX` | `stacks:2147483648/native:STX` | -| **sBTC** | `stacks:1/sip010:SM3VDX...sbtc-token` | `stacks:2147483648/sip010:ST1F7Q...sbtc-token` | -| **USDCx** | `stacks:1/sip010:SP120S...usdcx` | — | +| **STX** | `stacks:1/slip44:5757` | `stacks:2147483648/slip44:5757` | +| **sBTC** | `stacks:1/sip010:SM3VDX...::sbtc-token` | `stacks:2147483648/sip010:ST1F7Q...::sbtc-token` | +| **USDCx** | `stacks:1/sip010:SP120S...::usdcx-token` | — | ## Where to Get Tokens ### Mainnet -- **STX** — Available on major exchanges (Coinbase, Binance, OKX, etc.). Transfer to a Stacks wallet. -- **sBTC** — Bridge BTC using [bridge.sbtc.tech](https://bridge.sbtc.tech) -- **USDCx** — Bridge USDC via supported bridges +- **STX** — Major exchanges (Coinbase, Binance, OKX). Transfer to a Stacks wallet. +- **sBTC** — Bridge BTC at [bridge.sbtc.tech](https://bridge.sbtc.tech) +- **USDCx** — Bridge USDC via [supported bridges](https://docs.stacks.co/guides/bridge-assets-to-stacks) ### Testnet -Free test tokens for development: - - **STX** — [Stacks Testnet Faucet](https://explorer.hiro.so/sandbox/faucet?chain=testnet) - **sBTC** — [sBTC Testnet Faucet](https://bridge.sbtc.tech) (testnet mode) -## Token Standards +## Token Standard -All fungible tokens on Stacks follow [SIP-010](https://github.com/stacksgov/sips/blob/main/sips/sip-010/sip-010-fungible-token-standard.md), which defines: +All fungible tokens follow [SIP-010](https://github.com/stacksgov/sips/blob/main/sips/sip-010/sip-010-fungible-token-standard.md): - `transfer` — Move tokens between addresses - `get-balance` — Check balance for an address - `get-total-supply` — Total circulating supply - `get-name` / `get-symbol` / `get-decimals` — Token metadata - -## See Also - -- [Network Reference](/reference/networks/) — Mainnet/testnet configurations -- [Directory](/directory/) — Services and tools -- [Glossary](/glossary/) — Term definitions