> For the complete documentation index, see [llms.txt](https://docs.tronsave.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tronsave.io/chinese/developers/sdk.md).

# SDK

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

{% hint style="info" %}
更喜欢直接调用 HTTP API？请参阅 [API 参考](/chinese/developers/api-reference.md)。各 SDK 封装了那里所记录的相同端点。
{% endhint %}

## 可用的 SDK

所有 SDK 均面向 **v2 API**。

| 语言              | 包                 | 仓库                                                                     | 最新版本  |
| --------------- | ----------------- | ---------------------------------------------------------------------- | ----- |
| TypeScript / JS | `tronsave-sdk`    | [npm](https://www.npmjs.com/package/tronsave-sdk)                      | —     |
| Rust            | `tronsave`        | [crates.io](https://crates.io/crates/tronsave)                         | 2.0.0 |
| Python          | `tronsave`        | [PyPI](https://pypi.org/project/tronsave/)                             | 2.0.0 |
| Java            | `io.tronsave:sdk` | [Maven Central](https://central.sonatype.com/artifact/io.tronsave/sdk) | 2.0.0 |
| PHP             | `tronsave/sdk`    | [Packagist](https://packagist.org/packages/tronsave/sdk)               | 2.0.0 |

## 安装

{% tabs %}
{% tab title="npm" %}

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

需要 **Node.js v18.0.0+**。
{% endtab %}

{% tab title="Rust" %}

```bash
cargo add tronsave
```

或在 `Cargo.toml` 中：

```toml
[dependencies]
tronsave = "2.0.0"
```

{% endtab %}

{% tab title="Python" %}

```bash
pip install tronsave
```

需要 **Python 3.9+**。
{% endtab %}

{% tab title="Java" %}
Maven（`pom.xml`）：

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

Gradle（`build.gradle`）：

```groovy
implementation 'io.tronsave:sdk:2.0.0'
```

{% endtab %}

{% tab title="PHP" %}

```bash
composer require tronsave/sdk
```

需要 **PHP 8.1+**。
{% endtab %}
{% endtabs %}

## 基本用法

最快的入门方式是 API 密钥流程：创建一个 SDK 实例、预估成本，然后下单。从 [TronSave 控制台](https://tronsave.io/market) 获取 API 密钥 — 详情请参阅 [身份验证](/chinese/developers/authentication.md)。

{% tabs %}
{% tab title="Node.js" %}

```javascript
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();
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
生产环境请设置 `network: "mainnet"`。上面的示例使用 `"testnet"`（Nile 测试网），其工作方式相同，但不消耗真实 TRX。请参阅 [环境与网络](/chinese/developers/environments.md)。
{% endhint %}

## 功能

所有 SDK 均提供以下操作：

* **Buy Resource** — 购买能量或带宽。
* **Estimate Buy Resource** — 下单前预估购买成本。
* **Extend Request** — 延长现有的资源代理。
* **Get Extendable Delegates** — 列出可延长的委托人。
* **Get User Info** — 获取账户信息和余额。
* **Get Order / Get Orders** — 获取订单详情和订单历史。
* **Get Order Book** — 读取当前订单簿。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tronsave.io/chinese/developers/sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.