開発者向けドキュメント
TronWebでTronエナジーをレンタル(Node.js):コード例
Node.jsのTronWebを使用してTronエナジーをレンタルします。4 TRXを送金し、APIを経由して65,000エナジーをクレームし、USDTを70%削減で送金します。エラーハンドリング付きのコピー&ペーストコード。
API支払いアドレス
TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
このアドレスにTRXを送金してください。トランザクションハッシュはエナジー委任のクレームに使用されます。
TronWebを使用した完全なNode.js統合です。各ステップは、プロジェクトにコピーできるスタンドアロンのコードブロックです。完全なエンドツーエンドの例は下部にあります。
前提条件: Node.js 18+、
tronweb インストール済み(npm install tronweb)、Tronウォレットに資金がある状態。
フロー
APIキーなし。サインアップなし。あなたのコードはTronEnergy支払いアドレスにオンチェーンでTRXを送金し、所有権を証明するメッセージに署名してから、委任をクレームします。エナジーは約3秒で到着します。その後、あなたのコードは委任されたエナジーを使用してUSDTを送金します。
価格は線形です:TRXあたり16,250エナジー。 最小注文は4 TRX(65,000エナジー — 1つの標準的なUSDT送金)、最大は1,000 TRX(16.25Mエナジー)です。送金する金額により、返されるエナジー量が正確に決まります。階層やパッケージはありません。単一の標準的な送金の場合は4を送金してください。新しいウォレットの送金の場合は8を送金してください。バッチ作業の場合はさらに多く送金してください。下記のコードは
trxAmount 変数を使用しているため、1ヶ所で変更できます。
ステップバイステップ
1. セットアップ
セットアップ
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. TRX送金
支払い送信
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. エナジー委任を請求する
委任請求
// 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. USDTを送金する
USDT送信
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);
エラーハンドリング
エラー処理
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;
}
}
完全な例
これをファイルにコピーし、環境変数を設定して実行します。スクリプトはTRXを送信し、メッセージに署名し、リトライ付きでエナジー委任を請求してから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);
常に署名を含めてください。 TRXを送信したウォレットであることを証明します。これがない場合、APIは以下のエラーでリクエストを拒否します。
missing_signature。