Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

核心概念

掌握四个概念即可开始构建。每个部分都定义了概念,展示了其工作原理,并提供了完整参考的链接。

USDT0 作为燃料

您使用 USDT0 支付交易费用,USDT0 是您已持有并进行交易的同一资产。无需为第二个代币注资或管理。

USDT0 既是原生燃料资产(18 位小数,通过 address(x).balance 读取),也是 ERC-20 代币(6 位小数,通过 USDT0.balanceOf(x) 读取)。两个接口操作的是同一个底层余额,协议会自动调和 12 位小数的精度差。

// SAFE: 两次读取都使用 Stable 的规范余额接口。
// 两者读取的是相同的余额:
uint256 native = address(user).balance;        // 18 decimals
uint256 erc20  = IERC20(USDT0).balanceOf(user); // 6 decimals

了解更多:USDT0 作为燃料 · Stable 上的 USDT0 行为

保障区块空间

Stable v1.8.0 在每个区块内为符合条件的优先级工作负载预留了燃料配额。正常流量在拥堵期间无法占用此企业级通道容量。

标准 EVM 交易继续使用默认的 Nonce 通道,NonceKey = 0。符合条件的优先级流使用 CustomTx 类型 0x3FNonceKey 并设置第 63 位。

治理配置了通道和配额。保障区块空间已在主网和测试网中上线,StableSystem.blockspaceLanes() 返回活动配置。

了解更多:保障区块空间

USDT 转账聚合器

大容量 USDT0 转账通过 MapReduce 启发式流水线进行批处理和并行验证。每个账户的失败是隔离的,因此一次错误的转账不会中止批处理。

调用方的转账 API 保持不变。您以常规方式提交转账,无需更改代码即可提高吞吐量。

了解更多:USDT 转账聚合器

EVM 兼容性

标准 EVM 工具无需更改即可工作。在 EVM 层面,有三种行为与以太坊不同(上面已经介绍了 USDT0 作为燃料是第四种)。

单槽最终性。 交易一旦包含在区块中即为最终交易。区块大约每 0.7 秒生成一次。

无优先级小费。 maxPriorityFeePerGas 始终被忽略。有效燃料价格是协议设置的基础费用。

import { ethers } from "ethers";
 
const block = await provider.getBlock("latest");
const baseFee = block.baseFeePerGas;
 
const tx = await wallet.sendTransaction({
  to: "0xRecipientAddress",
  value: ethers.parseEther("0.1"),
  maxFeePerGas: baseFee * 2n,        // 2x base fee as safety margin
  maxPriorityFeePerGas: 0n,          // always 0 on Stable
});
 
await tx.wait();
console.log("Included at gas price:", tx.gasPrice?.toString());
Included at gas price: 1000000000

双重作用的 USDT0,移植风险。 从以太坊移植的合约不应镜像原生余额,应拒绝 address(0) 转账,并且不应依赖 EXTCODEHASH 进行地址重用检测。

了解更多:与以太坊的区别 · Stable 上的合约 · USDT0 迁移清单

机密转账(计划中)

Stable 有一个计划中的零知识转账功能,可以隐藏金额,同时允许授权方进行审计。该功能尚未上线。

了解更多:机密转账

接下来去哪里

  • 快速入门:连接到测试网并发送第一笔交易。
  • USDT0 行为:将合约移植到 Stable 而不会遇到双重作用的陷阱。
  • 燃料定价:在 Stable 的费用模型上正确构建交易。
  • 生产就绪:在发布到主网之前验证集成。