Guias de TRON

Como comprar energia TRON em Java com o SDK da TronSave (2026)

Por TronSave Publicado 6 min de leitura
Nesta página

O jeito mais rápido de comprar energia TRON em Java é o SDK oficial da TronSave: adicione io.tronsave:sdk a partir do Maven Central, crie um cliente com a sua chave de API, estime o custo e faça o pedido. São quatro chamadas tipadas, sem HTTP cru. Este guia percorre a integração inteira, da instalação até o acompanhamento de um pedido preenchido.

Por que alugar energia a partir de código Java?

Serviços de backend que enviam USDT (TRC-20) em qualquer volume esbarram na mesma conta que todo mundo na TRON: cada transferência consome energia, e a energia que você não tem é paga queimando TRX pelas tarifas do protocolo (veja o modelo de recursos da TRON). Alugar a energia na hora certa, logo antes de um lote de pagamentos, normalmente custa uma fração do que se queimaria, e fazer isso pelo código significa que o serviço se recarrega sozinho, sem ninguém de olho num painel. Se quiser ver primeiro o nível da API, comece pelo nosso guia de automação com a API; este post mostra o mesmo fluxo com tipos Java em vez de endpoints crus.

O que é o SDK da TronSave para Java?

É o cliente oficial em Java, publicado no Maven Central como io.tronsave:sdk (versão 2.0.0, voltado para a API v2 atual e para Java 17+). Ao lado dele existem SDKs oficiais para TypeScript, Rust, Python e PHP, todos encapsulando os mesmos endpoints, segundo a documentação oficial dos SDKs.

O cliente Java é pequeno, mas pensado para produção: os resultados voltam como records tipados (EstimateBuyResource, Order, UserInfo), os erros formam uma hierarquia real de exceções (autenticação, validação, rate limit, rede, negócio) e o cliente traz um rate limiter embutido, além de timeout e retries configuráveis no builder.

O mercado de energia em que o seu código compra energia TRON em Java pelo SDK da TronSave
O SDK cria pedidos no mesmo mercado de energia usado pela interface web. Fonte: TronSave

Como instalar?

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'

Como obter uma chave de API?

Crie uma no painel da TronSave (veja a documentação de autenticação). No fluxo com chave de API, os pedidos são pagos com o seu saldo pré-pago na TronSave, o que é ideal para serviços de backend, já que a chave privada da sua conta TRON nunca passa pela integração. Desenvolva usando Network.TESTNET (a rede de testes Nile, sem TRX real) e depois troque o enum para Network.MAINNET para entrar em produção.

Como comprar energia TRON em Java, do início ao fim

import io.tronsave.sdk.Network;
import io.tronsave.sdk.TronsaveClient;
import io.tronsave.sdk.model.BuyResourceResult;
import io.tronsave.sdk.model.EstimateBuyResource;
import io.tronsave.sdk.model.Order;

import java.util.Map;

public class BuyEnergy {
    public static void main(String[] args) {
        TronsaveClient client = TronsaveClient.builder()
                .apiKey(System.getenv("TRONSAVE_API_KEY"))
                .network(Network.TESTNET)   // Network.MAINNET in production
                .build();

        Map<String, Object> request = Map.of(
                "receiver", "TAk6jzZqHwNUkUcbvMyAE1YAoUPk7r2T6h",
                "resourceType", "ENERGY",
                "resourceAmount", 65_000,
                "durationSec", 3_600);

        // 1. Estimate before you commit
        EstimateBuyResource estimate = client.estimateBuyResource(request);
        System.out.println("Estimated cost (TRX): " + estimate.estimateTrx());

        // 2. Place the order, paid from your TronSave balance
        BuyResourceResult result = client.buyResource(request);

        // 3. Track it until the delegation lands
        Order order = client.getOrder(result.orderId());
        System.out.println(order.status() + " — " + order.fulfilledPercent() + "% filled");
    }
}

Três pontos merecem atenção. A chamada de estimativa retorna o preço unitário e a liquidez disponível, além do total em TRX, então você pode condicionar a compra ao preço. A compra retorna um orderId na hora; o preenchimento é assíncrono, então consulte getOrder até que status e fulfilledPercent mostrem a delegação esperada. E os 65.000 de energia por uma hora do exemplo são dimensionados para uma única transferência de USDT; ajuste resourceAmount e durationSec ao seu lote.

O que mais o cliente faz?

Método O que faz
getUserInfo() Dados da conta e saldo pré-pago
estimateBuyResource(...) Calcula o preço de uma compra antes do pedido
buyResource(...) Compra energia ou largura de banda
getOrder(id) / getOrders(page, size) Detalhe e histórico de pedidos
getOrderBook(...) Lê a profundidade atual do mercado
getExtendableDelegates(...) / extendRequest(...) Lista e estende delegações ativas

O builder também aceita timeoutMs(...), maxRetries(...) e baseUrl(...) para ajustes finos.

Como o código de produção deve tratar erros?

Tudo o que o cliente lança estende TronsaveException, mas os subtipos merecem tratamentos diferentes. TronsaveValidationException significa que a própria requisição está errada (um endereço de destino malformado, um valor inválido), então tentar de novo não adianta; registre no log e corrija a entrada. TronsaveRateLimitException significa que você está chamando mais rápido do que a sua chave permite; espere um pouco e tente de novo (o cliente também tem um rate limiter interno que suaviza picos antes de chegarem à rede). TronsaveNetworkException cobre falhas de transporte passageiras, o caso natural para o maxRetries do builder. Falhas de autenticação geralmente indicam uma chave ausente ou revogada; confira se a variável de ambiente realmente chegou ao processo.

Dois hábitos valem a pena especialmente em serviços de pagamento: chame getUserInfo() na inicialização e dispare um alerta quando o saldo pré-pago ficar abaixo do custo estimado da próxima execução, e use estimateBuyResource como disjuntor: se o estimateTrx() cotado passar de um limite razoável, segure a execução em vez de comprar no meio de um pico de preço.

Perguntas frequentes

Qual versão do Java é necessária?
Java 17 ou mais recente: os modelos do SDK são records, um recurso do Java 16+, e o bytecode publicado tem como alvo o 17.

Posso testar sem gastar TRX real?
Sim. Network.TESTNET aponta o cliente para a rede de testes Nile, onde todo o fluxo funciona da mesma forma com fundos de teste.

A chave privada da minha conta TRON sai do meu servidor em algum momento?
No fluxo com chave de API mostrado aqui, ela nem participa: os pedidos são pagos com o seu saldo pré-pago na TronSave. Existe um fluxo separado com chave privada, se você preferir pagar direto de uma conta TRON; veja os exemplos de código oficiais.

Também posso comprar largura de banda?
Sim, com a mesma chamada buyResource usando "resourceType": "BANDWIDTH".

E outras linguagens?
Existem SDKs oficiais para TypeScript, Rust, Python e PHP. Temos guias passo a passo para TypeScript, Python, PHP e Rust.

Preciso usar o SDK para comprar energia TRON em Java?
Não. Ele encapsula a API HTTP v2 documentada, então você pode chamar os endpoints diretamente com qualquer cliente HTTP. O SDK só poupa você da parte trabalhosa das requisições, dos retries, do rate limiting e da tipagem das respostas, que é exatamente o código que você menos quer manter por conta própria num fluxo de pagamentos.

O SDK e a API da TronSave são operados pela TronSave, a editora deste blog. Teste na Nile antes de apontar qualquer integração para fundos da mainnet.

TronSave
TronSave

A equipe da TronSave desenvolve o mercado de energia e largura de banda da TRON em tronsave.io e escreve estes guias com base em testes reais na rede principal da TRON.

Artigos relacionados

Usamos o Google Analytics para saber quais guias ajudam os leitores. Ele só grava cookies se você permitir a análise. O blog não exibe anúncios. Privacidade