SDK

Official TronSave SDKs for buying and managing Energy and Bandwidth on TRON — available for TypeScript, Rust, Python, Java, and PHP.

The TronSave SDKs let you interact with the TronSave API to manage resources (Energy and Bandwidth) on the TRON blockchain. Each SDK exposes strongly-typed functions for estimating costs, buying resources, extending orders, and tracking order status, and integrates cleanly into backend services.

Prefer to call the HTTP API directly? See the API Reference. The SDKs wrap the same endpoints documented there.

Available SDKs

All SDKs target the v2 API.

Language	Package	Registry	Latest
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

Install

npm

npm install tronsave-sdk
# or: yarn add tronsave-sdk

Requires Node.js v18.0.0+.

Rust

cargo add tronsave

Or in Cargo.toml:

[dependencies]
tronsave = "2.0.0"

Python

pip install tronsave

Requires 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

Requires PHP 8.1+.

Basic usage

The fastest way to get started is the API Key flow: create an SDK instance, estimate the cost, then place an order. Get an API key from the TronSave dashboard — see Authentication.

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);

    // Example: estimate cost for 32,000 ENERGY for 1 hour
    const estimate = await sdk.estimateBuyResource({
        receiver: "TAk6jzZqHwNUkUcbvMyAE1YAoUPk7r2T6h",
        resourceType: "ENERGY",
        durationSec: 3600, // 1 hour
        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}`);

    // Wait ~5s for the order to be filled
    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();

Set network: "mainnet" for production. The example uses "testnet" (Nile), where everything works the same way but uses no real TRX. See Environments & Networks.

Features

All SDKs provide the following operations:

• Buy Resource — buy Energy or Bandwidth.

• Estimate Buy Resource — estimate the cost of a purchase before ordering.

• Extend Request — extend an existing resource delegation.

• Get Extendable Delegates — list delegates that can be extended.

• Get User Info — fetch account information and balance.

• Get Order / Get Orders — fetch order details and order history.

• Get Order Book — read the current order book.