Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1,535 changes: 1,535 additions & 0 deletions bun.lock

Large diffs are not rendered by default.

16 changes: 8 additions & 8 deletions docs/pages/cn/explanation/build-overview.mdx
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
---
source_path: explanation/build-overview.mdx
source_sha: 4b19d1f913597181cd62426d9b82ef8e91c4fae3
source_sha: 31130e61141a3d529f2c5ec7281240aa4a155e00
title: "概览"
description: "在 Stable 上推出产品:钱包和账户、支付、智能合约和 AI 代理。从快速入门开始,或者直接跳转到您需要的功能。"
description: "在 Stable 上发货:钱包和账户、支付、智能合约和 AI 代理。从快速入门开始,或者直接跳到你所需的功能。"
diataxis: "explanation"
---

# 概览

Stable 新手?请先运行[快速入门](/cn/tutorial/quick-start)。它只需五分钟,并会发送一笔测试网交易,以便标签页的其余部分可以连接到它
Stable 新手?请先运行[快速入门](/cn/tutorial/quick-start)。它只需五分钟,并发送一个测试网交易,以便其余的选项卡可以插入

## 探索

- [**账户**](/cn/explanation/accounts-overview):创建钱包,使用 EIP-7702 授权 EOA,并为用户和代理限定会话密钥。
- [**账户**](/cn/explanation/accounts-overview):创建钱包,使用 EIP-7702 委托 EOA,并为用户和代理限定会话密钥。
- [**支付**](/cn/explanation/payments-overview):发送 USDT0,构建 P2P 和订阅流程,使用 ERC-3009 结算发票,并使用 x402 为 API 定价。
- [**合约**](/cn/explanation/contracts-overview):部署、验证和索引 Solidity 合约,并调用 Bank / Distribution / Staking 预编译
- [**合约**](/cn/explanation/contracts-overview):部署、验证和索引 Solidity 合约,并调用银行/分发/质押预编译
- [**AI 和代理**](/cn/explanation/agent-settlement):将 MCP 服务器连接到 AI 客户端,并公开代理可以通过提示调用的 x402 付费工具。

## 从这里开始

- [**快速入门**](/cn/tutorial/quick-start):连接到测试网,为钱包注资,并发送您的第一笔 USDT0 交易。
- [**发送您的第一笔 USDT0**](/cn/tutorial/send-usdt0):相同余额上的原生和 ERC-20 传输,附带 TypeScript 示例。
- [**快速入门**](/cn/tutorial/quick-start):连接到测试网,资助钱包,并发送您的第一个 USDT0 交易。
- [**发送您的第一个 USDT0**](/cn/tutorial/send-usdt0):相同余额上的原生和 ERC-20 传输,带有 TypeScript 示例。
- [**部署智能合约**](/cn/tutorial/smart-contract):搭建 Foundry,配置 Stable,并部署 Counter 合约。
- [**Stable SDK**](/cn/explanation/sdk-overview):使用类型化的 TypeScript 客户端在 Stable 上进行转账、桥接和兑换
- [**工具和 SDK**](/cn/explanation/tools-overview):使用类型化的 TypeScript SDK、服务 API 和 MCP 服务器
72 changes: 42 additions & 30 deletions docs/pages/cn/explanation/gas-waiver.mdx
Original file line number Diff line number Diff line change
@@ -1,61 +1,73 @@
---
source_path: explanation/gas-waiver.mdx
source_sha: a03f510da6c1fe5ab2d31b55c8827b59792af6e0
title: "免除Gas费"
description: "Gas费免除机制允许应用程序为用户支付Gas费。经治理批准的豁免提交封装交易,以零Gas费运行已签名负载。"
source_sha: 73109dcf0f466171e6c0807bb89627d896c640e0
title: "Gas 费用减免"
description: "Gas 费用减免允许应用程序为用户支付 Gas 费。经治理批准的减免会提交封装交易,以零 Gas 价格运行签名负载。"
diataxis: "explanation"
---

# 免除Gas费
# Gas 费用减免

经治理批准的地址(称为**豁免者**)提交一个封装交易,其中包含用户签名的负载,并以 `gasPrice = 0` 执行。用户不持有任何 USDT0 且不支付任何 Gas 费。Stable 运营着一个这样的豁免服务;合作伙伴也可以通过验证者治理注册他们自己的豁免地址
经治理批准的地址(称为**减免者**)提交一个封装交易,该交易携带着用户签名的负载,并以 `gasPrice = 0` 执行它。用户无需持有 USDT0,也无需支付 Gas 费。Stable 提供一个这样的减免服务作为托管服务;合作伙伴也可以通过验证者治理注册自己的减免地址

## 工作原理

Gas费免除机制采用封装交易模式
Gas 费用减免使用封装交易模式

1. **用户签署一个 `InnerTx`**,其中 `gasPrice = 0`。用户的签名端到端保留;豁免者不能在不使其失效的情况下修改负载
2. **豁免者将 `InnerTx` 封装到 `WrapperTx` 中**,发送到协议标记地址 (`0x000000000000000000000000000000000000f333`),其中 `value = 0``gasPrice = 0`,并将已签名的 `InnerTx` 作为其数据负载。
3. **验证者检测到标记**,检查豁免者的授权和策略约束,并以用户的身份(`from`、`nonce`、调用语义)执行内部交易
1. **用户签署一个 `InnerTx`**,`gasPrice = 0`。用户的签名在端到端过程中保持不变;减免者无法修改负载而不使其失效
2. **减免者将 `InnerTx` 封装到 `WrapperTx` 中**,发送到协议标记地址 (`0x000000000000000000000000000000000000f333`),`value = 0``gasPrice = 0`,并将已签名的 `InnerTx` 作为其数据负载。
3. **验证者检测到标记**,检查减免者的授权和策略约束,并在用户身份(`from`、`nonce`、调用语义)下执行内部交易

Gas 费用核算在豁免机制内部处理。用户不支付任何费用;封装者不支付任何费用;验证者根据每个豁免者的策略承担成本
Gas 核算在减免机制内部处理。用户无需支付任何费用;封装者无需支付任何费用;验证者根据每个减免策略承担成本

## 授权和策略

豁免者由验证者治理控制,而不是应用程序逻辑。治理提供:
减免由验证者治理控制,而非应用程序逻辑。治理提供:

- **可审查的注册**:每个豁免地址都在链上注册并且在状态中可见
- **撤销**:验证者可以随时移除行为不当的豁免者
- **通过 `AllowedTarget` 进行范围访问**:每个豁免者都绑定到一组特定的目标合约和方法选择器。如果内部 `to` 地址和方法选择器超出该范围,协议将拒绝任何封装。
- **可审查的注册**:每个减免地址都在链上注册,并在状态中可见
- **撤销**:验证者可以随时移除行为不当的减免者
- **通过 `AllowedTarget` 进行范围访问**:每个减免都绑定到一组特定的目标合约和方法选择器。如果内部 `to` 地址和方法选择器超出该范围,协议将拒绝任何封装。

有效的封装交易满足以下所有条件
有效的封装交易必须满足以下所有条件

- `WrapperTx.to == 0x000000000000000000000000000000000000f333`(标记地址)。
- `WrapperTx.from` 是通过治理在链上注册的豁免者
- `WrapperTx.gasPrice == 0` `InnerTx.gasPrice == 0`。
- `WrapperTx.from` 是通过治理在链上注册的减免者
- `WrapperTx.gasPrice == 0` `InnerTx.gasPrice == 0`。
- `WrapperTx.value == 0`。
- `InnerTx.to` 和提取的方法选择器由豁免者的 `AllowedTarget` 策略允许。
- `InnerTx.to` 和提取的方法选择器被减免者的 `AllowedTarget` 策略允许。

如果任何条件失败,验证者将拒绝封装而不执行内部交易
如果任何条件失败,验证者将拒绝封装,而不执行内部交易

## 安全模型

- **用户签名完整性**:用户签署 `InnerTx`。豁免者不能在不使签名失效的情况下修改负载。合作伙伴仍有责任确保用户只签署预期的负载。
- **链上授权**:授权存在于链上。只有治理注册的豁免地址才能提交有效的封装,无论请求源自何处。
- **服务可用性边界**:当合作伙伴通过 Stable 托管的豁免服务器路由时,提交的可用性取决于服务。协议级别的授权保证不受影响。
- **用户签名完整性**:用户签署 `InnerTx`。减免者不能修改负载而不使其签名失效。合作伙伴仍有责任确保用户只签署预期的负载。
- **链上授权**:授权存在于链上。只有治理注册的减免地址才能生成有效的封装提交,无论请求源自何处。
- **服务可用性边界**:当合作伙伴通过 Stable 的托管减免服务器进行路由时,提交的可用性取决于服务。协议级别的授权保证不受影响。

## 何时使用Gas费免除机制
## 何时使用 Gas 费用减免

Gas费免除机制适用于任何用户不需要持有 USDT0 支付 Gas 费的场景
Gas 费用减免适用于最终用户无需持有 USDT0 以支付 Gas 的任何流程

- 消费者应用程序引导新用户,这些用户尚未持有稳定币余额
- 代理驱动的流程,其中代理的钱包支付 Gas 费。
- 消费者应用程序为尚未拥有稳定币余额的用户提供入职服务
- 代理驱动的流程,其中代理的钱包提供 Gas 费。
- 企业支付轨道,其中运营商承担网络成本。

对于用户持有 USDT0 但希望将多个调用捆绑到一个签名交易的流程,请参阅[EIP-7702 委托](/cn/reference/eip-7702-api)代替。
对于用户持有 USDT0 但希望将多个调用捆绑到一个签名交易中的流程,请参阅 [EIP-7702 委托](/cn/reference/eip-7702-api)。

## 选择集成路径

所有三种路径都会产生相同的链上结果。它们在谁持有减免密钥以及你需要构建多少方面有所不同。

| 路径 | 谁持有减免密钥 | 使用场景 |
| :--- | :--- | :--- |
| [托管减免服务器](/cn/how-to/integrate-gas-waiver) | Stable,你使用 API 密钥进行身份验证 | 你想要最短的路径,并且可以依赖 Stable 的服务进行提交。 |
| [企业 SDK](/cn/how-to/relay-with-gas-waiver) | 你,通过治理注册 | 你用 TypeScript 运行自己的减免服务,并希望一次调用即可构建、签名和广播。 |
| [自托管封装器](/cn/how-to/self-hosted-gas-waiver) | 你,通过治理注册 | 你自己构建封装交易,使用 SDK 不涵盖的语言。 |

托管服务器为你注册并操作减免,因此你无需构建 `WrapperTx`。自托管路径都需要一个经过治理注册的减免地址,而 `@stablechain/enterprise` 是该模型的类型化客户端。

## 下一步建议

- [**启用免 Gas 费交易**](/cn/how-to/integrate-gas-waiver):通过 API 密钥提交和 NDJSON 响应集成托管的豁免服务器 API
- [**Gas 费免除协议**](/cn/reference/gas-waiver-api):阅读完整的协议规范:标记路由、封装格式、治理控制。
- [**USDT0 作为 Gas**](/cn/explanation/usdt-as-gas-token):了解豁免涵盖的 Gas 令牌
- [**启用无 Gas 交易**](/cn/how-to/integrate-gas-waiver):将托管减免服务器 API 与 API 密钥提交和 NDJSON 响应集成
- [**Gas 费用减免协议**](/cn/reference/gas-waiver-api):阅读完整的协议规范:标记路由、封装格式、治理控制。
- [**USDT0 作为 Gas**](/cn/explanation/usdt-as-gas-token):了解减免所涵盖的 Gas 代币
41 changes: 41 additions & 0 deletions docs/pages/cn/explanation/tools-overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
source_path: explanation/tools-overview.mdx
source_sha: 6eecb794f859527309d0c200ea29e33c6223cb74
title: "工具和SDK"
description: "选择合适的Stable工具:类型化的TypeScript SDK、Gas豁免和EIP-7702服务API,以及面向AI客户端的MCP服务器。"
diataxis: "explanation"
---

# 工具和SDK

您通过Stable调用的所有内容都在这里。要在Stable上构建产品?从 [Stable SDK](/cn/explanation/sdk-overview) 开始,当您需要SDK未封装的轨道时,可以使用服务API。赞助Gas或从后端中继交易?从 [Enterprise SDK](/cn/explanation/enterprise-sdk) 开始。将Stable连接到AI编辑器或代理?请访问 [使用AI开发](/cn/how-to/develop-with-ai)。

## 使用SDK进行构建

- [**Stable SDK**](/cn/explanation/sdk-overview):`@stablechain/sdk`,用于转账、跨链桥、交换和金库收益的类型化TypeScript客户端。它封装了viem,并处理路由、批准、小数和链切换。
- [**SDK快速入门**](/cn/tutorial/sdk-quickstart):安装软件包,在测试网上发送您的第一笔USDT0转账,并预览主网跨链桥报价。
- [**SDK参考**](/cn/reference/sdk):`createStable`、`createStableReader`、转账、跨链桥、交换和赚取方法、枚举和错误类。
- [**Enterprise SDK**](/cn/explanation/enterprise-sdk):`@stablechain/enterprise`,用于免Gas交易和预留企业专用区块空间的服务器端客户端。
- [**Enterprise SDK参考**](/cn/reference/enterprise-sdk):`createStableEnterprise`,包括两个轨道、构建辅助函数和错误类。

## 将SDK与您的技术栈一起使用

- [**viem**](/cn/how-to/sdk-with-viem):三种签名方式:私钥账户、浏览器传输或预构建的viem WalletClient。
- [**wagmi**](/cn/how-to/sdk-with-wagmi):使用`useWalletClient`、`useAccount`和`useChainId`将SDK连接到React应用程序。
- [**赚取收益**](/cn/how-to/earn-yield):将USDT0存入Morpho金库,读取APY和仓位,提款并领取Merkl奖励。

## 服务API

- [**Gas豁免协议**](/cn/reference/gas-waiver-api):交易格式、标记路由、治理控制以及您发布已签名`InnerTx`有效载荷的Waiver Server API。
- [**EIP-7702**](/cn/reference/eip-7702-api):委托交易格式和RPC行为,用于将EOA的账户代码指向智能合约。

## AI和代理工具

- [**使用AI开发**](/cn/how-to/develop-with-ai):将Docs MCP和Runtime MCP服务器添加到任何兼容MCP的客户端,以及适用于不带MCP的工具的纯文本文档。
- [**使用MCP服务器支付**](/cn/how-to/pay-with-mcp):将x402付费API公开为MCP工具,以便AI客户端通过提示调用和支付它们。

## 接下来去哪里

- [**快速入门**](/cn/tutorial/quick-start):连接到测试网,为钱包充值,并发送您的第一笔USDT0交易。
- [**JSON-RPC API**](/cn/reference/json-rpc-api):`eth`、`net`、`web3`和`debug`命名空间支持的方法。
- [**构建**](/cn/explanation/build-overview):账户、支付、合约和代理,按您正在发布的内容进行组织。
Loading