SDK

TronSave 官方 SDK，用于在 TRON 上购买和管理能量与带宽 — 支持 TypeScript、Rust、Python、Java 和 PHP。

TronSave SDK 可让你与 TronSave API 交互，从而管理 TRON 区块链上的资源（能量和带宽）。每个 SDK 都提供强类型函数，用于预估成本、购买资源、延长订单以及跟踪订单状态，并能干净地集成到后端服务中。

更喜欢直接调用 HTTP API？请参阅 API 参考。各 SDK 封装了那里所记录的相同端点。

可用的 SDK

所有 SDK 均面向 v2 API。

语言	包	仓库	最新版本
TypeScript / JS	tronsave-sdk	npm	—
Rust	tronsave	crates.io	2.0.0
Python	tronsave	PyPI	2.0.0
Java	io.tronsave:sdk	Maven Central	2.0.0
PHP	tronsave/sdk	Packagist	2.0.0

安装

npm

npm install tronsave-sdk
# 或：yarn add tronsave-sdk

需要 Node.js v18.0.0+。

Rust

cargo add tronsave

或在 Cargo.toml 中：

[dependencies]
tronsave = "2.0.0"

Python

pip install tronsave

需要 Python 3.9+。

Java

Maven（pom.xml）：

<dependency>
    <groupId>io.tronsave</groupId>
    <artifactId>sdk</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle（build.gradle）：

implementation 'io.tronsave:sdk:2.0.0'

PHP

composer require tronsave/sdk

需要 PHP 8.1+。

基本用法

最快的入门方式是 API 密钥流程：创建一个 SDK 实例、预估成本，然后下单。从 TronSave 控制台 获取 API 密钥 — 详情请参阅 身份验证。

Node.js

import { TronsaveSDK } from "tronsave-sdk";

const main = async () => {
    const apiKey = "your_api_key";
    const sdk = new TronsaveSDK({ network: "testnet", apiKey });

    const userInfo = await sdk.getUserInfo();
    console.log(userInfo);

    // 示例：预估 32,000 ENERGY、租期 1 小时的成本
    const estimate = await sdk.estimateBuyResource({
        receiver: "TAk6jzZqHwNUkUcbvMyAE1YAoUPk7r2T6h",
        resourceType: "ENERGY",
        durationSec: 3600, // 1 小时
        resourceAmount: 32000,
    });
    console.log(estimate);
    if (estimate.estimateTrx > Number(userInfo.balance)) throw new Error("Insufficient balance");

    const { orderId } = await sdk.buyResource({
        receiver: "TAk6jzZqHwNUkUcbvMyAE1YAoUPk7r2T6h",
        resourceType: "ENERGY",
        durationSec: 3600,
        resourceAmount: 32000,
    });
    console.log(`Buy resource success -> orderId: ${orderId}`);

    // 等待约 5 秒让订单成交
    await new Promise((resolve) => setTimeout(resolve, 5000));

    const order = await sdk.getOrder(orderId);
    console.log(order.fulfilledPercent < 100 ? "Order is not filled" : "Order is filled");
};

main();

生产环境请设置 network: "mainnet"。上面的示例使用 "testnet"（Nile 测试网），其工作方式相同，但不消耗真实 TRX。请参阅 环境与网络。

功能

所有 SDK 均提供以下操作：

• Buy Resource — 购买能量或带宽。

• Estimate Buy Resource — 下单前预估购买成本。

• Extend Request — 延长现有的资源代理。

• Get Extendable Delegates — 列出可延长的委托人。

• Get User Info — 获取账户信息和余额。

• Get Order / Get Orders — 获取订单详情和订单历史。

• Get Order Book — 读取当前订单簿。