DOCUMENTAÇÃO DO DESENVOLVEDOR
Integração TronWeb
Integre a delegação Energy TronEnergy usando TronWeb em Node.js. Exemplos de código prontos para copiar e colar.
ENDEREÇO DE PAGAMENTO API
TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
Envie TRX para este endereço. Seu hash de transação é usado para reivindicar a delegação de energia.
Integração completa do Node.js usando TronWeb . Cada etapa é um bloco de código independente que você pode copiar para o seu projeto. O exemplo completo, do início ao fim, está no final.
Pré-requisitos: Node.js 18+,
tronweb instalado (npm install tronweb), uma carteira Tron com fundos.
O Fluxo
Sem chave API . Sem cadastro. Seu código envia TRX on-chain para o endereço de pagamento TronEnergy , assina uma mensagem comprovando a propriedade e, em seguida, reivindica a delegação. Energy chega em aproximadamente 3 segundos. Depois, seu código envia USDT usando a energia delegada.
O preço é linear: 16.250 Energy por TRX . Pedido mínimo de 4 TRX (65.000 Energy — uma transferência padrão USDT ), máximo de 1.000 TRX (16,25 milhões Energy ). A quantidade enviada determina exatamente quanta Energy você recebe de volta — não há níveis ou pacotes. Para uma única transferência padrão, envie 4 TRX. Para uma transferência para uma nova carteira, envie 8 TRX. Para transferências em lote, envie mais TRX. O código abaixo usa um...
trxAmount variável para que você possa alterá-la em um único lugar.
Passo a passo
1. Configuração
configurar
const { TronWeb } = require('tronweb'); // destructured: the default import is broken in v6
const tronWeb = new TronWeb({
fullHost: 'https://api.trongrid.io',
privateKey: process.env.TRON_PRIVATE_KEY,
});
const API = 'https://api.tronnrg.com';
const ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx'; // API payment address
const USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
2. Enviar TRX
enviar pagamento
const TRX_AMOUNT = 4; // Linear: 16,250 energy per TRX. Min 4, max 1000.
// 4 → 65k (standard) · 8 → 130k (new wallet) · 40 → 650k (10 transfers)
const payment = await tronWeb.trx.sendTransaction(ADDR, TRX_AMOUNT * 1e6);
console.log('Payment tx:', payment.txid);
3. Reivindique a delegação
reivindicação de delegação
// Sign: proves you are the sender
const msg = `${payment.txid}:${tronWeb.defaultAddress.base58}`;
const sig = await tronWeb.trx.signMessageV2(msg);
const delegation = await fetch(`${API}/delegate`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
tx_hash: payment.txid,
delegate_to: tronWeb.defaultAddress.base58,
signature: sig,
}),
}).then(r => r.json());
if (delegation.error) {
throw new Error(delegation.message);
}
console.log('Energy delegated:', delegation.energy); // TRX_AMOUNT × 16,250
4. Enviar USDT
enviar ust
const contract = await tronWeb.contract().at(USDT);
const tx = await contract.transfer(
recipientAddress, Math.round(usdtAmount * 1e6)
).send({ feeLimit: 50_000_000 });
console.log('USDT sent:', tx);
Tratamento de erros
erros de tratamento
const result = await fetch(`${API}/delegate`, { ... })
.then(r => r.json());
if (result.error) {
switch (result.error) {
case 'payment_verification_failed':
// Payment not yet indexed on-chain. Wait 3s and retry.
break;
case 'hash_already_used':
// Already claimed. Don't retry.
break;
case 'signature_mismatch':
// Sender of TRX != signer of the message. Sign with the same key.
break;
case 'delegation_failed':
// Provider could not deliver. Retry or contact support with result.ref.
break;
}
}
Exemplo completo
Copie este código para um arquivo, configure suas variáveis de ambiente e execute-o. O script envia TRX , assina a mensagem, reivindica a delegação com nova tentativa e, em seguida, envia USDT .
delegate-energy.js
const { TronWeb } = require('tronweb'); // destructured: default import is broken in v6
const tronWeb = new TronWeb({
fullHost: 'https://api.trongrid.io',
privateKey: process.env.TRON_PRIVATE_KEY,
});
const API = 'https://api.tronnrg.com';
const ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';
const USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
async function claimWithRetry(txHash, delegateTo, signature, retries = 3) {
for (let i = 0; i < retries; i++) {
const res = await fetch(`${API}/delegate`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ tx_hash: txHash, delegate_to: delegateTo, signature }),
}).then(r => r.json());
if (!res.error) return res;
if (res.error !== 'payment_verification_failed') throw new Error(res.message);
await new Promise(r => setTimeout(r, 3000));
}
throw new Error('Transaction not found after retries');
}
async function main() {
const recipient = 'TRecipientWallet';
const trxAmount = 4; // min 4, max 1000 — you get trxAmount × 16,250 energy
// 1. Send TRX (linear pricing: 16,250 energy per TRX)
const payment = await tronWeb.trx.sendTransaction(ADDR, trxAmount * 1e6);
console.log('Payment:', payment.txid);
// 2. Claim delegation
// Sign: proves you are the sender
const message = `${payment.txid}:${recipient}`;
const signature = await tronWeb.trx.signMessageV2(message);
const result = await claimWithRetry(payment.txid, recipient, signature);
console.log('Delegated:', result.energy, 'energy');
console.log('Delegation tx:', result.delegations[0].tx); // verify on TronScan
console.log('Ref:', result.ref);
// 3. Send USDT
const contract = await tronWeb.contract().at(USDT);
const tx = await contract.transfer(recipient, 10 * 1e6).send();
console.log('USDT sent:', tx);
}
main().catch(console.error);
Inclua sempre a assinatura. Isso comprova que você é a carteira que enviou os TRX . Sem isso, a API rejeita a solicitação.
missing_signature.