डेवलपर दस्तावेज़
TronWeb एकीकरण
Node.js में TronWeb का उपयोग करके TronEnergy Energy प्रतिनिधिमंडल को एकीकृत करें। तैयार कोड उदाहरणों को कॉपी-पेस्ट करें।
API भुगतान पता
TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
इस पते पर TRX भेजें। आपके लेनदेन के हैश का उपयोग ऊर्जा प्रतिनिधिमंडल का दावा करने के लिए किया जाता है।
TronWeb का उपयोग करके Node.js का पूर्ण एकीकरण। प्रत्येक चरण एक स्वतंत्र कोड ब्लॉक है जिसे आप अपने प्रोजेक्ट में कॉपी कर सकते हैं। संपूर्ण उदाहरण नीचे दिया गया है।
पूर्वापेक्षाएँ: Node.js 18+
tronweb स्थापित (npm install tronweb), एक फंडेड Tron वॉलेट।
प्रवाह
कोई API कुंजी नहीं। कोई साइन-अप नहीं। आपका कोड TronEnergy भुगतान पते पर ऑन-चेन TRX भेजता है, स्वामित्व साबित करने वाले संदेश पर हस्ताक्षर करता है, और फिर डेलीगेशन का दावा करता है। Energy लगभग 3 सेकंड में पहुँच जाती है। फिर आपका कोड डेलीगेटेड ऊर्जा का उपयोग करके USDT भेजता है।
मूल्य निर्धारण रैखिक है: 16,250 Energy प्रति TRX । न्यूनतम ऑर्डर 4 TRX (65,000 Energy - एक मानक USDT ट्रांसफर), अधिकतम 1,000 TRX (16.25 मिलियन Energy )। आपके द्वारा भेजी गई राशि से ही यह निर्धारित होता है कि आपको कितनी Energy वापस मिलेगी - इसमें कोई टियर या पैकेज नहीं हैं। एक मानक ट्रांसफर के लिए, 4 भेजें। नए वॉलेट में ट्रांसफर के लिए, 8 भेजें। बैच ट्रांसफर के लिए, अधिक भेजें। नीचे दिया गया कोड एक
trxAmount वेरिएबल ताकि आप इसे एक ही जगह पर बदल सकें।
क्रमशः
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 भेजें
यूएसडीटी भेजें
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.