TypeScript SDK: SmoothSend 无 Gas 交易

目的

指导在 Aptos 上使用 SmoothSend 实现无 Gas 交易赞助。用户通过钱包签署交易，但无需支付 Gas 费用——您从预充值积分中按交易付费。可作为 AptosWalletAdapterProvider 的即插即用 transactionSubmitter。

付费商业服务： 测试网免费；主网采用积分制计费。当前费率请参阅 定价页面。

务必遵守

1. 1. 使用 @smoothsend/sdk——SmoothSend 集成的官方 npm 包。
2. 在 AptosWalletAdapterProvider 中将 SmoothSendTransactionSubmitter 作为 transactionSubmitter 传入——这将使所有 signAndSubmitTransaction 调用实现无 Gas。
3. 将 API 密钥存储在环境变量中——使用 NEXTPUBLICSMOOTHSENDAPIKEY 或 VITESMOOTHSENDAPI_KEY（切勿硬编码）。
4. 使用测试网进行开发——测试网始终免费，无需积分。
5. 处理 402（积分不足）错误——API 在积分耗尽时返回 402；显示用户友好提示信息并提供计费链接。

严禁事项

1. 1. 不要在仅服务端应用中向客户端暴露 API 密钥——前端请使用 NEXTPUBLIC 或 VITE_ 前缀的环境变量。
2. 不要跳过 transactionSubmitter——没有它，用户将自行支付 Gas；提供者将回退到正常提交方式。
3. 不要将 Script Composer 用于任意交易——Script Composer 仅用于稳定币转账（USDC、USDT 等）；其他所有交易请使用 Wallet Adapter。

方法一：Wallet Adapter（推荐——适用于任何交易）

适用于兑换、NFT 铸造、合约调用等任何交易类型。

安装

bash
npm install @smoothsend/sdk @aptos-labs/wallet-adapter-react

提供者设置（3 行代码）

tsx
import { SmoothSendTransactionSubmitter } from @smoothsend/sdk;
import { AptosWalletAdapterProvider } from @aptos-labs/wallet-adapter-react;
import { Network } from @aptos-labs/ts-sdk;

const smoothSend = new SmoothSendTransactionSubmitter({
apiKey: process.env.NEXTPUBLICSMOOTHSENDAPIKEY!,
network: mainnet // 或 testnet（始终免费）
});

export function Providers({ children }: { children: React.ReactNode }) {
return (
autoConnect={true}
dappConfig={{
network: Network.MAINNET,
transactionSubmitter: smoothSend
}}
onError={(error) => console.error(钱包错误:, error)}
>
{children}

);
}

此后，每次 signAndSubmitTransaction 调用均为无 Gas。无需其他代码更改。

方法二：Script Composer（代币内扣费——仅限稳定币）

适用于 USDC、USDT、WBTC、USDe、USD1 转账。费用（约 $0.01）从发送的代币中扣除——无需 APT 或 SmoothSend 积分。

typescript
import { ScriptComposerClient } from @smoothsend/sdk;

const client = new ScriptComposerClient({
apiKey: process.env.NEXTPUBLICSMOOTHSENDAPIKEY!,
network: mainnet
});

// USDC 主网资产地址
const USDC_ASSET = 0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b;

const build = await client.buildTransfer({
sender: walletAddress,
recipient: 0xRecipient...,
amount: 1000000, // 1 USDC（6 位小数）
assetType: USDC_ASSET,
decimals: 6,
symbol: USDC
});

// 使用钱包签名，然后提交 build.signedTransaction

错误处理

tsx
try {
const response = await signAndSubmitTransaction(payload);
await aptos.waitForTransaction({ transactionHash: response.hash });
} catch (error: any) {
if (error?.status === 402 || error?.message?.includes(积分不足)) {
// 积分耗尽——显示升级提示
toast.error(服务暂时不可用，请稍后重试。);
window.open(https://dashboard.smoothsend.xyz/billing, _blank);
} else {
throw error;
}
}

定价

当前费率请参阅 SmoothSend 定价页面。测试网免费；主网使用积分包。

常见错误

参考资料

• - SmoothSend 文档：https://docs.smoothsend.xyz
• 定价页面：https://docs.smoothsend.xyz/pricing
• 控制台：https://dashboard.smoothsend.xyz
• npm：https://www.npmjs.com/package/@smoothsend/sdk
• MCP（AI 上下文）：npx @smoothsend/mcp——用于 getdocs、estimatecredits、getcodesnippet 的工具
• 相关技能：ts-sdk-wallet-adapter、ts-sdk-transactions