Entwicklerdokumentation
TronWeb -Integration
Integrieren Sie TronEnergy Energy mithilfe von TronWeb in Node.js. Fertige Codebeispiele zum Kopieren und Einfügen.
API ZAHLUNGSADRESSE
TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
Senden Sie TRX an diese Adresse. Ihr Transaktions-Hash wird verwendet, um die Energiedelegierung zu beanspruchen.
Vollständige Node.js-Integration mit TronWeb . Jeder Schritt ist ein eigenständiger Codeblock, den Sie in Ihr Projekt kopieren können. Das vollständige Beispiel finden Sie unten.
Voraussetzungen: Node.js 18+,
tronweb installiert (npm install tronweb), eine mit Guthaben versehene Tron Wallet.
Der Fluss
Kein API Schlüssel. Keine Registrierung. Ihr Code sendet TRX on-chain an die TronEnergy -Zahlungsadresse, signiert eine Nachricht zum Eigentumsnachweis und beansprucht anschließend die Delegierung. Energy trifft in ca. 3 Sekunden ein. Danach sendet Ihr Code USDT mit der delegierten Energie.
Die Preisgestaltung ist linear: 16.250 Energy pro TRX . Mindestbestellmenge: 4 TRX (65.000 Energy – eine Standard USDT -Überweisung), maximal 1.000 TRX (16,25 Mio. Energy ). Die von Ihnen gesendete Menge bestimmt die Menge an zurückerhaltener Energy – es gibt keine Stufen oder Pakete. Für eine einzelne Standardüberweisung senden Sie 4 TRX. Für eine Überweisung auf ein neues Wallet senden Sie 8 TRX. Für Sammelüberweisungen senden Sie mehr TRX. Der unten stehende Code verwendet …
trxAmount Variable, damit Sie sie an einer Stelle ändern können.
Schritt für Schritt
1. Einrichtung
aufstellen
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. Senden Sie TRX
Zahlung senden
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. Die Delegation in Anspruch nehmen.
Delegation von Ansprüchen
// 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 senden
sende 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);
Fehlerbehandlung
Fehlerbehandlung
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;
}
}
Vollständiges Beispiel
Kopieren Sie dies in eine Datei, setzen Sie Ihre Umgebungsvariablen und führen Sie das Skript aus. Das Skript sendet TRX , signiert die Nachricht, beansprucht die Delegierung mit Wiederholungsversuchen und sendet anschließend 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);
Die Unterschrift muss immer enthalten sein. Es beweist, dass Sie die Wallet sind, die die TRX gesendet hat. Ohne diesen Nachweis lehnt die API die Anfrage ab.
missing_signatureDie