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 SDK

@stablechain/sdk 是 Stable 的官方 TypeScript 客户端。它将 viem 封装成一个小的、类型化的 API，用于您最常进行的操作：转移 USDT0、跨链桥接、兑换代币以及在 Stable 上赚取收益。路由、批准、小数位数和链切换都为您处理。

import { createStable, Network } from "@stablechain/sdk";
import { privateKeyToAccount } from "viem/accounts";
 
const stable = createStable({
  network: Network.Mainnet,
  account: privateKeyToAccount("0x..."),
});
 
const { txHash } = await stable.transfer({
  from: "0xYourAddress",
  to: "0xRecipient",
  amount: 10,
});
txHash: 0x8f3a...2d41

SDK 功能

  • transfer：发送原生 USDT0 或 Stable 上的任何 ERC-20。Gas 费会自动以 USDT0 支付。
  • quoteBridge / bridge：通过 LI.FI 进行跨链传输，LI.FI 会为您选择桥接路线。批准和链切换在内部处理。
  • quoteSwap / swap：通过 LI.FI 进行同链代币兑换，ERC-20 批准在内部处理。
  • earn：将 USDT0 存入 Morpho V2 金库以赚取收益，提现或赎回，并领取 Merkl 激励奖励。批准和适配器解除分配都为您处理。
  • createStableReader：一个只读客户端，用于获取金库年化收益率 (APY)、您的头寸、收益预测和即时提现可用性检查。无需签名器。

SDK 发布在 npm 上，名称为 @stablechain/sdk，并要求 viem >= 2.0.0 作为对等依赖项。

何时使用（以及何时不使用）

当您需要一个类型化、规范化的客户端来隐藏路由和批准样板文件时，请使用 SDK。当您需要直接控制交易构造、自定义 Gas 策略或转账/桥接/兑换之外的合同调用时，请降级到原始 viem 或 ethers。

从此处开始

  • 快速入门：安装 SDK 并在测试网上运行您的第一个转账、桥接和兑换。
  • 使用 SDK 赚取收益：存款到金库，查看您的 APY 和头寸，提款并领取奖励。
  • SDK 参考：所有方法、配置选项、枚举和错误类。
  • 与 viem 配合使用：服务器端账户、浏览器钱包和自带 WalletClient。
  • 与 wagmi 配合使用：使用 useWalletClient 和 hooks 将 SDK 连接到 React 应用程序。

下一步建议