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

Stable Enterprise SDK

@stablechain/enterprise 是 Stable 企业交易轨道的服务器端 TypeScript 客户端。它签署并中继两种特权交易：免 Gas 费交易，即您为用户的 Gas 费买单；以及有保证区块空间交易，它们落在预留的企业通道中。您可以在一个客户端上启用任一或两种轨道。

import { createStableEnterprise, stable } from "@stablechain/enterprise";
import { privateKeyToAccount } from "viem/accounts";
 
const enterprise = createStableEnterprise({
  chain: stable,
  gasWaiver: { account: privateKeyToAccount("0xYOUR_WAIVER_KEY") },
});
 
const { txHash } = await enterprise.gasWaiver.send(user, { to: token, data });
txHash: 0x8f3a...2d41

此调用返回 H_inner，即用户交易的哈希，而不是承载它的封装交易。

SDK 的功能

SDK 提供了三个功能，每个模块一个。每个功能都是可选的，可以独立配置，并且每个功能都有自己的签名账户，因此您可以使用单独的密钥。

  • 免 Gas 中继 (gasWaiver)：构建、签署和中继免 Gas 费交易。一个白名单的豁免账户封装用户的零 Gas 交易，以便用户在不持有任何 USDT0 的情况下进行交易。请参阅免 Gas 费。
  • 有保证的区块空间 (guaranteedBlock)：通过企业 RPC 网关中继交易，使其落在预留的企业通道区块空间中。与免 Gas 费不同，签名者支付自己的 Gas 费。请参阅有保证的区块空间。
  • 有保证的中继交易 (guaranteedWaiver)：两者结合。通过有保证的区块空间路由的免 Gas 费交易，因此用户不需要余额，并且交易仍落在企业通道中。

每个功能都提供相同的四种方法：send 和 sendBatch 用于 SDK 签名的托管路径，以及 relay 和 relayBatch 用于用户在其他地方签名并仅向您提供已签名十六进制的非托管路径。

SDK 在 npm 上发布为 @stablechain/enterprise，当前版本为 1.0.0，并且需要 viem >= 2.0.0 作为对等依赖项。

访问

企业版 SDK 可在 Stable 主网和 Stable 测试网上使用。将 stable 用于主网，或将 stableTestnet 用于测试网，作为客户端的 chain；两者都由包重新导出。

这两个轨道都是受限的。免 Gas 费需要治理注册的豁免密钥，而保证区块空间需要企业 RPC 网关 API 密钥。要进行集成，请联系 Stable 以获取访问权限。Stable 会提供您需要的豁免密钥和网关端点。

仅限服务器端

豁免密钥是经过白名单的、经过治理注册的账户：任何持有它的人都可以根据您的策略赞助 Gas 费。企业 RPC 网关 URL 嵌入了您的 API 密钥。请将两者都视为秘密。为了使豁免密钥脱离进程，请使用 AWS KMS 等托管签名器对其进行备份。请参阅签名密钥和托管。

何时使用它

当您操作后端并希望为用户提供 Gas 费或保证您自己的流量包含在内时，请使用企业版 SDK。对于日常转账、桥接、兑换以及来自后端或浏览器的金库收益，请改用通用的 Stable SDK。

从这里开始

下一步建议