内容
<div align="center">
# Tael
### 自主AI代理的支付层
让AI代理使用Stellar上的USDC支付API、MCP工具、数据和数字服务。
</div>
---
## 概述
AI代理可以推理、规划、编写代码、浏览网页和自动化工作流程。
但它们仍然无法做一件事:
> **支付他们需要的服务。**
每个付费API都需要信用卡、账户、API密钥、计费逻辑、订阅或手动购买。
人类仍然参与其中。
**Tael改变了这一点。**
Tael是一个可编程的支付层,使自主AI代理能够使用**Stellar上的USDC**购买API、MCP工具、数据集和数字服务。
开发人员只需使用一个SDK命令即可包装任何API,并立即实现盈利。
代理发现工具,在用户定义的支出政策范围内自动支付,无需人工干预。
---
# 为什么选择Tael?
当今的AI生态系统存在三个主要问题。
### AI代理无法购买能力
当代理需要公司数据、OCR、翻译、搜索、天气、PDF或其他高级服务时,它会停止。
有人必须手动订阅或提供凭证。
---
### 开发人员必须构建计费基础设施
每个API开发人员都必须管理:
- 用户账户
- 身份验证
- 计费
- Stripe集成
- 使用情况跟踪
- 发票
- 支付失败
这造成了巨大的工程开销。
---
### API不是为自主软件设计的
传统的计费方式假设有一个人类客户。
AI代理需要:
- 机器原生支付
- 即时结算
- 微支付
- 可编程的支出限制
---
# 解决方案
Tael引入了一种机器原生的支付协议。
代理只需按需支付,而不是订阅。
```
代理
│
▼
调用工具
│
▼
HTTP 402 支付请求
│
▼
代理签名支付
│
▼
USDC在Stellar上结算
│
▼
工具执行
│
▼
返回响应
```
每个请求都变成:
```
请求
→ 支付
→ 验证
→ 执行
```
---
# 功能
## 对于AI代理
- 自主购买
- 按调用付费的API
- 智能支出政策
- 使用通行密钥保护的钱包
- 仅限USDC
- 无gas代币
- 微支付支持
- 自动重试
- 透明的收据
---
## 对于开发人员
使用一个命令包装现有的API。
```ts
import { tael } from "@tael/sdk";
export default tael({
price: "0.02",
handler: myApi,
});
```
就是这样。
无需计费。
无需Stripe。
无需客户账户。
无需发票。
每次调用您的API时,都会立即支付。
---
## 对于MCP服务器
现有的MCP服务器可以在无需修改的情况下被包装。
```
Claude
│
▼
Tael MCP包装器
│
▼
支付验证
│
▼
现有的MCP服务器
```
---
# 用户体验
## 用户
1. 创建代理钱包
2. 使用USDC充值
3. 设置支出规则
4. 请求代理执行任务
5. 接收结果和支出摘要
示例:
```
找到该产品的五大供应商
并撰写报告。
```
代理自动购买:
- 企业记录
- 实时定价
- PDF解析
- 翻译
总计:
```
花费:
$0.71
剩余:
$19.29
```
---
## 开发人员
1. 连接API
2. 设置定价
3. 添加Stellar钱包
4. 发布
每次成功的请求都会立即支付:
```
代理钱包
│
▼
开发人员钱包
```
无需订阅。
无需付款。
无需等待。
---
# 架构
```
+-----------------------+
| 用户钱包 |
| 通行密钥 + 政策 |
+-----------+-----------+
|
|
▼
+-----------------------+
| AI代理客户端 |
+-----------+-----------+
|
|
调用付费工具
|
▼
+-----------------------+
| Tael SDK包装器 |
+-----------+-----------+
|
HTTP 402 支付请求
|
▼
+--------------------------+
| x402 支付验证|
+------------+-------------+
|
Stellar结算
|
▼
开发人员接收USDC
|
▼
工具执行请求
```
---
# 技术栈
## 区块链
- Stellar
- Soroban
- USDC
- 赞助交易
---
## 支付
- Coinbase x402
- 微支付协议(MPP)
---
## 后端
- TypeScript
- Node.js
- Supabase
- PostgreSQL
---
## 前端
- Next.js
- React
- Tailwind CSS
---
## 身份验证
- WebAuthn
- 通行密钥
- 智能账户
---
# 为什么选择Stellar?
Tael依赖于极低的交易费用。
Stellar提供:
- 近乎零费用
- 快速确认
- 原生USDC
- 赞助交易
- 优秀的微支付经济效益
代理永远不需要拥有XLM。
他们只花费USDC。
---
# 安全
Tael是非托管的。
资金始终直接在以下账户之间转移:
```
代理钱包
│
▼
开发人员钱包
```
Tael从不持有用户资金。
每个代理都收到一个限定签名者,该签名者只能在钱包所有者定义的范围内花费。
示例政策:
```
每次调用最大金额:
$0.50
每日预算:
$5
允许类别:
✓ 研究
✓ 数据
✓ OCR
阻止:
✗ 赌博
✗ 未知商家
```
即使代理被泄露,也无法超过其链上策略。
---
# 路线图
> **构建状态:** monorepo基础已经完成 — SDK、x402、Stellar结算、HTTP API、
> 营销网站和产品**仪表板 + 共享UI**都已搭建并通过
> `lint · typecheck · test · build`检查。详见[`claude/roadmap.md`](./claude/roadmap.md)了解详细
> 的工程路线图和当前状态。
## 第一阶段 — 基础 ✅
- SDK ✅
- x402集成 ✅
- 钱包和结算 ✅ _(Stellar原生;稍后Soroban智能钱包)_
- HTTP API ✅
---
## 第二阶段 — 产品界面 ✅
- 仪表板 ✅
- 共享UI (`@tael/ui`) ✅
- 市场 _(UI已搭建;待上线)_
- 收入分析 _(UI已搭建;待上线)_
---
## 第三阶段 — 真实流程及其他
- 数据库 + 身份验证 (Drizzle, Better Auth + 通行密钥)
- MCP包装器 & 代理客户端
- 代理目录、发现、MPP会话
- Soroban合约、主网
---
# 愿景
互联网是为人类而建的。
下一个互联网将为自主软件而建。
就像Stripe成为在线业务的支付基础设施一样,Tael正在为AI代理构建支付基础设施。
我们设想一个未来,数百万自主代理在无需人类干预的情况下发现、购买和使用数字服务。
开发人员发布工具。
代理购买能力。
软件支付软件。
Tael使这成为可能。
---
# 仓库
Tael是一个Turborepo + pnpm monorepo。
```text
apps/
api/ # 后端API — Hono + tRPC模块化单体 (@tael/api)
web/ # 营销网站 — Next.js 15
dashboard/ # 产品仪表板 — Next.js 15 (钱包、市场、代理…)
packages/
config/ # 共享tsconfig / eslint / prettier / tailwind预设
types/ # 共享领域内核 — 值对象、zod模式、错误
payments/ # x402 / HTTP-402支付协议
stellar/ # USDC结算原生(Soroban-ready)
sdk/ # @tael/sdk — tael({ price, handler })包装器
ui/ # @tael/ui — 共享React组件(shadcn/ui)
```
**项目文档**
- **[`ARCHITECTURE.md`](./ARCHITECTURE.md)** — 完整的技术设计:文件夹原理、包边界、依赖图、DDD约定、CI/CD、发布工作流。
- **[`CONTRIBUTING.md`](./CONTRIBUTING.md)** — 本地设置、工作流程和约定。
## 本地开发
需要Node ≥ 22 和 pnpm ≥ 11 (`corepack enable`)。
```bash
pnpm install
cp .env.example .env
pnpm dev # 在监视模式下运行所有内容
pnpm --filter @tael/api dev # 或仅运行API → http://localhost:3001/health
pnpm --filter web dev # 或仅运行网站 → http://localhost:3000
pnpm --filter dashboard dev # 或仅运行仪表板 → http://localhost:3002
```
质量门控(与CI相同):`pnpm lint && pnpm typecheck && pnpm test && pnpm build`。
---
# 贡献
我们欢迎来自构建自主商务未来的开发人员贡献。开始使用
**[CONTRIBUTING.md](./CONTRIBUTING.md)**。
---
# 许可证
MIT
---
<div align="center">
**在Stellar上构建 ❤️**
让AI代理在经济上自主。
</div>