内容
<div align="center">
# ✦ Tael
**自主人工智能代理的支付层**
**为任何API付费,为您的API获取报酬**
支持代理、MCP工具和API。支付在Stellar上以USDC结算。
[阅读文档](https://taelprotocol.xyz/docs) ·
[在线应用](https://app.taelprotocol.xyz) ·
[官网](https://taelprotocol.xyz)
</div>
<p align="center">
<a href="https://www.npmjs.com/package/@tael/sdk"><img alt="npm version" src="https://img.shields.io/npm/v/@tael/sdk?logo=npm&label=%40tael%2Fsdk&color=000000" /></a>
<a href="https://github.com/tael-protocol/tael/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/tael-protocol/tael?logo=github&color=000000" /></a>
<a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-000000.svg" /></a>
<a href="https://discord.gg/UtW9dZKwBW"><img alt="Discord community" src="https://img.shields.io/badge/Discord-%E5%8A%A0%E5%85%A5%E7%A4%BE%E5%8C%BA-5865F2?logo=discord&logoColor=white" /></a>
<a href="https://x.com/taelprotocol"><img alt="Follow @taelprotocol" src="https://img.shields.io/badge/%E5%85%B2%E6%9C%AA-%40taelprotocol-000000?logo=x&logoColor=white" /></a>
<a href="https://stellar.org"><img alt="Built on Stellar" src="https://img.shields.io/badge/%E6%90%AA%E6%88%90%E4%BA%8E-Stellar-000000?logo=stellar&logoColor=white" /></a>
</p>
---
## 什么是Tael?
Tael是一个可编程的支付层,允许自主人工智能代理使用**Stellar上的USDC**购买API、MCP工具、数据集和数字服务。开发者只需一次SDK调用即可为任何HTTP处理程序添加计费功能;代理发现这些功能,按照用户定义的支出策略按需付费,无需人工干预。
它遵循开放的 **x402 / HTTP 402** 标准,因此付费端点只是一个带有附加支付的普通Web请求。
## 为什么选择Tael?
人工智能代理可以推理、规划和行动,但它们仍然无法为所需的服务付费。每个付费API都假设存在一个拥有信用卡的人类。Tael弥补了这一差距。
1. **代理按调用付费,而非按订阅付费。** 无需账户,无需API密钥管理,无需月度计划。代理为其使用的内容结算微支付,并继续工作。
2. **开发者通过一行代码实现盈利。** 将现有的处理程序封装在`tael()`中,并在每次调用时以USDC获取报酬 - 无需Stripe,无需计费逻辑,无需发票,无需客户账户。
3. **支出始终受控。** 每个代理都运行在具有链上上限(每次调用的最大限额 + 滚动限制)的资金热钱包上,因此自主权从不意味着空白支票。
## 工作原理
```
代理调用功能
│
▼
HTTP 402 付款要求 ← 网关返回付款挑战
│
▼
代理签署USDC付款 ← 在其支出策略内
│
▼
在Stellar上结算 ← 在运行任何操作之前在链上验证
│
▼
处理程序执行 → 响应 + 签名收据
```
在您的处理程序运行之前,支付会在链上验证,并附带签名的`X-PAYMENT-RESPONSE`收据。结算是非托管的:代理支付给构建者,并在单个交易中支付1%的协议费用。
## 入门指南
### 为开发者提供的API变现方式
只需一次调用,即可为任何Fetch处理程序添加计费功能。由于它遵循Web `Request`/`Response`标准,因此可以直接应用于Hono、Next.js路由处理程序、Bun、Deno和Cloudflare Workers。
```ts
import { tael } from "@tael/sdk";
// 现在每次调用`myApi`之前都需要支付0.02 USDC。
export default tael({
price: "0.02",
handler: myApi,
});
```
就是这样 - 无需计费,无需Stripe,无需客户账户。每次您的API被调用时,只需获取报酬。
### 为代理购买功能
从 [仪表盘](https://app.taelprotocol.xyz):创建代理,用USDC资助其热钱包,并设置支出策略(每次调用的最大限额 + 滚动限制)。然后,代理在市场中发现功能,并自主支付费用 - 每次调用都在链上结算,在您设置的上限内,并在您的账簿中显示。
## 软件包
一个使用Turborepo + pnpm的monorepo。支付引擎与链无关;Stellar是第一个结算后端。
| 软件包 | 功能 |
| ------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| [`@tael/sdk`](https://www.npmjs.com/package/@tael/sdk) | 从代码中购买、发布和出售功能:`Tael`客户端 + `tael()`包装器 |
| `@tael/payments` | x402协议线格式 + 非托管费用分割 |
| `@tael/stellar` | Stellar结算 + 链上支付验证器 |
| `@tael/types` | `Money`值对象,zod模式,共享错误 |
| `@tael/auth` | Sign-In-With-Stellar会话(edge-safe,`jose`) |
| `@tael/database` | Drizzle模式 + AES-256-GCM秘密加密 |
| `@tael/ui` | 共享React组件(基于shadcn/ui) |
| `@tael/config` | 共享TypeScript / Tailwind / ESLint配置 |
| `@tael/claude` | AI助手(例如功能FAQ生成) |
应用: **`web`** (营销网站),**`dashboard`** (控制台),**`api`** (功能网关)。
## 从源码构建和运行
```bash
git clone https://github.com/tael-protocol/tael.git
cd tael-protocol
pnpm install
cp .env.example .env # 添加您的密钥(Stellar,数据库,身份验证密钥)
pnpm dev # 并行运行web、dashboard和api
```
有用脚本:
```bash
pnpm build # 构建每个应用和软件包
pnpm test # 运行测试套件
pnpm typecheck # 类型检查整个monorepo
pnpm format # 使用Prettier格式化
```
## 文档
完整文档位于 **[taelprotocol.xyz/docs](https://taelprotocol.xyz/docs)** - SDK,接受付款,支出政策和网关。
## 社区
- **Discord** - [加入社区](https://discord.gg/UtW9dZKwBW)
- **X** - [@taelprotocol](https://x.com/taelprotocol)
- **文档** - [taelprotocol.xyz/docs](https://taelprotocol.xyz/docs)
## 贡献
> [!NOTE]
> 我们重视贡献。对于问题或支持,请加入我们的
> [Discord社区](https://discord.gg/UtW9dZKwBW)。
错误修复和小型改进是开始的最佳方式。对于较大的功能,请先打开问题或在Discord上联系我们,以确保它与路线图一致。
## 许可证
在 [MIT许可证](./LICENSE)下许可。