TronEnergy API-তে কোনো প্রমাণীকরণের প্রয়োজন আছে?

কোনো API কী বা সাইন-আপ প্রয়োজন নেই। আপনি প্রতিটি অনুরোধকে একটি বার্তায় স্বাক্ষর করে প্রমাণীকরণ করেন যা প্রমাণ করে যে আপনি পেমেন্ট প্রেরক। কোনো প্রমাণপত্র, কোনো API কী নেই।

ডেলিগেশন প্রবাহ কীভাবে কাজ করে?

পেমেন্ট ঠিকানায় TRX পাঠান। বার্তা {tx_hash}:{delegate_to} স্বাক্ষর করুন যাতে প্রমাণ হয় আপনি প্রেরক। POST /delegate কল করুন tx_hash, delegate_to এবং স্বাক্ষর সহ। এনার্জি ~৩ সেকেন্ডে পৌঁছায়।

Tron Energy Rental API রেফারেন্স: REST এন্ডপয়েন্ট এবং ইন্টিগ্রেশন

বেস URL: https://api.tronnrg.com প্রমাণীকরণ: কোনো প্রয়োজন নেই। সমস্ত এন্ডপয়েন্ট পাবলিক। রেট সীমা: প্রতি IP এ 20 অনুরোধ/সেকেন্ড পেমেন্ট ঠিকানা: TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx (শুধুমাত্র API, ম্যানুয়াল ভাড়ার জন্য নয়)

এটি কীভাবে কাজ করে

তিনটি ধাপ। কোনো API কী নেই, কোনো সাইন-আপ নেই, কোনো ওয়ালেট সংযোগ নেই। মালিকানা ক্রিপ্টোগ্রাফিক্যালি প্রমাণিত।

TRX পাঠান — পেমেন্ট অ্যাড্রেসে 4 TRX (বা তার বেশি) পাঠান। 4 TRX = 65,000 এনার্জি। 8 TRX = 130,000। লিনিয়ার।
স্বাক্ষর করুন — বার্তায় স্বাক্ষর করুন {tx_hash}:{delegate_to} যে ওয়ালেট TRX পাঠিয়েছে তা ব্যবহার করে। এটি প্রমাণ করে যে আপনি ডেলিগেশন অনুমোদন করেছেন।
দাবি করুন — POST /delegate সহ tx_hash, delegate_to, এবং signature। এনার্জি ~3 সেকেন্ডে আসে।

পেমেন্ট অ্যাড্রেস

TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx

শুধুমাত্র API পেমেন্ট অ্যাড্রেস। এই অ্যাড্রেসটি API এর মাধ্যমে প্রোগ্রামেটিক ইন্টিগ্রেশনের জন্য। ম্যানুয়াল এনার্জি ভাড়ার জন্য এটি ব্যবহার করবেন না। ম্যানুয়াল ভাড়ার অ্যাড্রেস ভিন্ন এবং এ উপলব্ধ।tronnrg.com.

এই অ্যাড্রেসে TRX পাঠান। আপনার পেমেন্টের লেনদেন হ্যাশ ডেলিগেশন ট্রিগার করার জন্য আপনার টোকেন। প্রতিটি হ্যাশ শুধুমাত্র একবার ব্যবহার করা যায়।

প্রেরিত TRX	ডেলিগেটকৃত এনার্জি	ব্যবহারের ক্ষেত্র
4 TRX	65,000	বিদ্যমান ওয়ালেটে স্ট্যান্ডার্ড USDT ট্রান্সফার (ন্যূনতম অর্ডার)
8 TRX	130,000	প্রথমবারের প্রাপকের কাছে USDT ট্রান্সফার
16 TRX	260,000	এক অর্ডারে চারটি স্ট্যান্ডার্ড ট্রান্সফার
40 TRX	650,000	দশটি স্ট্যান্ডার্ড ট্রান্সফার
100 TRX	1,625,000	~25টি স্ট্যান্ডার্ড ট্রান্সফার — ছোট প্ল্যাটফর্মের জন্য সাধারণ
1,000 TRX	16,250,000	সর্বোচ্চ অর্ডার, ~250টি স্ট্যান্ডার্ড ট্রান্সফার
এর মধ্যে যেকোনো পরিমাণ	`trx × 16,250`	সম্পূর্ণ লিনিয়ার। কোনো স্তর, কোনো প্যাকেজ, কোনো ছাড় নেই।

সূত্র: energy = trxSent × 16,250. সীমা: ন্যূনতম 4 TRX (65,000 এনার্জি), সর্বোচ্চ 1,000 TRX (16,250,000 এনার্জি)। উভয়ই API স্তরে প্রয়োগ করা হয় — ন্যূনতমের নিচে পরিমাণ below_minimum সহ প্রত্যাখ্যাত এবং রিফান্ড করা হয়; সর্বোচ্চের উপরে পরিমাণ ডেলিগেশনের আগে প্রত্যাখ্যাত করা হয়।

POST /delegate

POST/delegate

একটি এনার্জি ডেলিগেশন দাবি করুন। আপনাকে ইতিমধ্যে পেমেন্ট অ্যাড্রেসে অন-চেইন TRX পাঠাতে হবে। ট্রানজ্যাকশন হ্যাশ, প্রাপকের অ্যাড্রেস এবং আপনি প্রেরক তা প্রমাণ করে এমন একটি স্বাক্ষর পাস করুন।

প্যারামিটার	ধরন		বর্ণনা
tx_hash	string	প্রয়োজনীয়	TRX পেমেন্টের 64-ক্যারেক্টার হেক্স হ্যাশ
delegate_to	string	প্রয়োজনীয়	এনার্জি গ্রহণের জন্য ট্রন অ্যাড্রেস
signature	string	প্রয়োজনীয়	tronWeb.trx.signMessageV2() এর `tronWeb.trx.signMessageV2()`। প্রমাণ করে আপনি পেমেন্ট প্রেরক।

curl -X POST https://api.tronnrg.com/delegate \
  -H "Content-Type: application/json" \
  -d '{"tx_hash":"TX_HASH","delegate_to":"TWallet","signature":"SIG"}'

const result = await fetch('https://api.tronnrg.com/delegate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    tx_hash: 'YOUR_TX_HASH',
    delegate_to: 'TWalletAddress',
    signature: 'YOUR_SIGNATURE',
  }),
}).then(r => r.json());

if (result.error) {
  console.error(result.error, result.message);
} else {
  console.log('Delegated:', result.energy, 'energy');
  console.log('Ref:', result.ref);
}

import requests

response = requests.post('https://api.tronnrg.com/delegate', json={
    'tx_hash': 'YOUR_TX_HASH',
    'delegate_to': 'TWalletAddress',
    'signature': 'YOUR_SIGNATURE',
})
result = response.json()

if 'error' in result:
    print(f"Error: {result['error']} - {result['message']}")
else:
    print(f"Delegated: {result['energy']} energy")
print(f"Delegation tx: {result['delegations'][0]['tx']}")
print(f"Ref: {result['ref']}")

$ch = curl_init('https://api.tronnrg.com/delegate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'tx_hash' => 'YOUR_TX_HASH',
        'delegate_to' => 'TWalletAddress',
        'signature' => 'YOUR_SIGNATURE',
    ]),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (isset($result['error'])) {
    echo "Error: " . $result['message'];
} else {
    echo "Delegated: " . $result['energy'] . " energy";
}

var client = new HttpClient();
var content = new StringContent(
    JsonSerializer.Serialize(new {
        tx_hash = "YOUR_TX_HASH",
        delegate_to = "TWalletAddress",
        signature = "YOUR_SIGNATURE"
    }),
    Encoding.UTF8, "application/json"
);

var response = await client.PostAsync("https://api.tronnrg.com/delegate", content);
var json = await response.Content.ReadAsStringAsync();
var result = JsonSerializer.Deserialize<JsonElement>(json);

if (result.TryGetProperty("error", out var err))
    Console.WriteLine($"Error: {err}");
else
    Console.WriteLine($"Delegated: {result.GetProperty("energy")} energy");

প্রতিক্রিয়া ২০০
{
  "ref": "nrg_d_42",
  "delegate_to": "TWalletAddress",
  "energy": 65000,
  "cost": 4,
  "status": "delegated",
  "delegations": [
    { "tx": "a1b2c3d4e5f6...your delegation tx hash", "energy": 65000 }
  ]
}

ফিল্ড	ধরন	বর্ণনা
ref	string	TronNRG রেফারেন্স আইডি। সাপোর্ট কোয়েরির জন্য এটি লগ করুন।
energy	number	মোট এনার্জি ডেলিগেট করা হয়েছে
cost	number	চার্জ করা TRX
status	string	সফল হলে "delegated"
delegations	array	অন-চেইন ডেলিগেশন ট্রানজ্যাকশন হ্যাশ। প্রতিটি `tx` যাচাইযোগ্য TronScan এ। এটি আপনার রসিদ।

GET /health

GET/health

মনিটরিং এবং আপটাইম টুলসের জন্য লাইভনেস চেক। API প্রসেস আপ থাকলে 200 OK রিটার্ন করে। আপস্ট্রিম নোড বা প্রোভাইডার চেক করে না।

প্রতিক্রিয়া ২০০

{ "status": "ok" }

এরর কোড

প্রতিটি এরর রেসপন্সের error আছে (স্থিতিশীল, মেশিন-পড়ার যোগ্য) এবং message (মানব-পড়ার যোগ্য)। সবসময় আপনার কোডে error এ সুইচ করুন।

কোড	HTTP	অর্থ
`invalid_tx_hash`	400	64-ক্যারেক্টার হেক্স স্ট্রিং নয়
`invalid_address`	400	বৈধ ট্রন অ্যাড্রেস নয়
`missing_signature`	400	কোন স্বাক্ষর প্রদান করা হয়নি
`invalid_signature`	401	স্বাক্ষর যাচাই করা যায়নি
`signature_mismatch`	403	স্বাক্ষরকারী অ্যাড্রেস পেমেন্ট প্রেরকের সাথে মেলে না
`hash_already_used`	409	ট্রানজ্যাকশন হ্যাশ ইতিমধ্যে দাবি করা হয়েছে
`payment_verification_failed`	404 / 400	পেমেন্টের অন-চেইন যাচাইকরণ ব্যর্থ হয়েছে। নির্দিষ্ট কারণের জন্য `message` ফিল্ড পড়ুন: tx এখনও পাওয়া যায়নি (404, কয়েক সেকেন্ডে পুনরায় চেষ্টা করুন), ভুল প্রাপক, TRX ট্রান্সফার নয়, বা 4 TRX মিনিমামের নিচে।
`delegation_failed`	400 / 500	প্রোভাইডার এনার্জি ডেলিভার করতে পারেনি। যদি পেমেন্ট যাচাইয়ের পরে ব্যর্থতা ঘটে তবে একটি রিফান্ড স্বয়ংক্রিয়ভাবে কিউতে যোগ করা হয়। এটি ঘটলে `refund` অবজেক্ট চেক করুন।
`rate_limited`	429	এই আইপি থেকে প্রতি সেকেন্ডে খুব বেশি অনুরোধ পাঠানো হয়েছে। সীমা হল ২০/সেক।
`server_error`	500	অপ্রত্যাশিত অভ্যন্তরীণ ত্রুটি। কয়েক সেকেন্ড পরে আবার চেষ্টা করুন।

const result = await fetch('https://api.tronnrg.com/delegate', { ... })
  .then(r => r.json());

if (result.error) {
  switch (result.error) {
    case 'payment_verification_failed':
      // Most common cause: tx not yet indexed. Wait 3s and retry.
      // Read result.message for the specific cause.
      break;
    case 'hash_already_used':
      // Already claimed. Don't retry.
      break;
    case 'signature_mismatch':
      // Signer != payment sender. Sign with the same key that sent TRX.
      break;
    case 'delegation_failed':
      // Refund queued automatically if payment was verified.
      if (result.refund) console.log('Refund queued:', result.refund);
      break;
  }
}

result = requests.post('https://api.tronnrg.com/delegate', json=data).json()

if 'error' in result:
    if result['error'] == 'payment_verification_failed':
        # Most common cause: tx not yet indexed. Wait 3s and retry.
        pass
    elif result['error'] == 'hash_already_used':
        # Already claimed. Don't retry.
        pass
    elif result['error'] == 'signature_mismatch':
        # Signer != payment sender. Sign with the same key.
        pass
    elif result['error'] == 'delegation_failed':
        # Refund queued automatically if payment was verified.
        pass

if (isset($result['error'])) {
    switch ($result['error']) {
        case 'payment_verification_failed':
            // Most common cause: tx not yet indexed. Wait 3s and retry.
            break;
        case 'hash_already_used':
            // Already claimed. Don't retry.
            break;
        case 'signature_mismatch':
            // Signer != payment sender. Sign with the same key.
            break;
        case 'delegation_failed':
            // Refund queued automatically if payment was verified.
            break;
    }
}

রিফান্ড

আপনার পেমেন্ট যাচাই করার পরে যদি ডেলিগেশন ব্যর্থ হয়, তাহলে একটি TRX রিফান্ড স্বয়ংক্রিয়ভাবে সারিবদ্ধ হয় এবং প্রেরক ঠিকানায় অন-চেইনে ফেরত পাঠানো হয়। ত্রুটি প্রতিক্রিয়ায় রিফান্ড অবজেক্ট খুঁজুন।

রিফান্ড সহ ত্রুটি
{
  "error": "delegation_failed",
  "message": "Energy delegation failed. Your payment will be refunded.",
  "ref": "nrg_d_43",
  "refund": {
    "type": "queued",
    "to": "TSenderAddress",
    "amount": 4
  }
}

সম্পূর্ণ উদাহরণ

সম্পূর্ণ এন্ড-টু-এন্ড প্রবাহ: TRX পাঠান, স্বাক্ষর করুন, পুনরায় চেষ্টা সহ দাবি করুন। অনুলিপি এবং চালান করুন।

const API  = 'https://api.tronnrg.com';
const ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';

async function rentEnergy(delegateTo, trxAmount = 4) {
  // 1. Send TRX to the payment address
  const payment = await tronWeb.trx.sendTransaction(ADDR, trxAmount * 1e6);

  // 2. Sign: proves you are the sender
  const message = `${payment.txid}:${delegateTo}`;
  const signature = await tronWeb.trx.signMessageV2(message);

  // 3. Claim delegation (retry if tx not indexed yet)
  let result;
  for (let i = 0; i < 3; i++) {
    result = await fetch(`${API}/delegate`, {
      method:  'POST',
      headers: { 'Content-Type': 'application/json' },
      body:    JSON.stringify({
        tx_hash:     payment.txid,
        delegate_to: delegateTo,
        signature,
      }),
    }).then(r => r.json());

    if (!result.error) break;
    if (result.error !== 'payment_verification_failed') throw new Error(result.message);
    await new Promise(r => setTimeout(r, 3000));
  }

  if (result.error) throw new Error(result.message);
  return result;
}

// Usage — send any amount between 4 and 1,000 TRX
const result = await rentEnergy('TWalletThatNeedsEnergy', 4);  // 4 TRX → 65k energy
// rentEnergy(addr, 8)    // → 130,000 energy (new-wallet transfer)
// rentEnergy(addr, 40)   // → 650,000 energy (10 transfers)
// rentEnergy(addr, 1000) // → 16,250,000 energy (max)
console.log(result.energy);              // trxAmount × 16,250
console.log(result.delegations[0].tx);  // on-chain tx hash
console.log(result.ref);                 // "nrg_d_42"

import requests
import time

API  = 'https://api.tronnrg.com'
ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx'

def rent_energy(delegate_to, trx_amount=4):
    # 1. Send TRX to ADDR (via your Tron library)
    tx_hash = send_trx(ADDR, trx_amount)  # your TRX send function

    # 2. Sign: proves you are the sender
    message = f'{tx_hash}:{delegate_to}'
    signature = tron.trx.sign_message_v2(message)

    # 3. Claim delegation (retry if tx not indexed yet)
    for attempt in range(3):
        result = requests.post(f'{API}/delegate', json={
            'tx_hash':     tx_hash,
            'delegate_to': delegate_to,
            'signature':   signature,
        }).json()

        if 'error' not in result:
            return result
        if result['error'] != 'payment_verification_failed':
            raise Exception(result['message'])
        time.sleep(3)

    raise Exception('Transaction not found after retries')

# Usage
result = rent_energy('TWalletThatNeedsEnergy', 4)
print(f"Delegated: {result['energy']} energy")
print(f"Delegation tx: {result['delegations'][0]['tx']}")
print(f"Ref: {result['ref']}")

<?php
$api  = 'https://api.tronnrg.com';
$addr = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';

function rentEnergy($api, $txHash, $delegateTo, $signature) {
    // 1. Send TRX to $addr (via iexbase/tron-api)
    // $payment = $tron->sendTrx($addr, 4);
    // $txHash = $payment['txid'];

    // 3. Claim delegation (retry if tx not indexed yet)
    for ($i = 0; $i < 3; $i++) {
        $ch = curl_init("${api}/delegate");
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
            CURLOPT_POSTFIELDS     => json_encode([
                'tx_hash'     => $txHash,
                'delegate_to' => $delegateTo,
                'signature'   => $signature,
            ]),
        ]);
        $result = json_decode(curl_exec($ch), true);
        curl_close($ch);

        if (!isset($result['error'])) return $result;
        if ($result['error'] !== 'payment_verification_failed')
            throw new Exception($result['message']);
        sleep(3);
    }
    throw new Exception('Transaction not found after retries');
}

// Usage
$result = rentEnergy($api, $txHash, 'TWalletThatNeedsEnergy');
echo "Delegated: " . $result['energy'] . " energy\n";
echo "Delegation tx: " . $result['delegations'][0]['tx'] . "\n";
echo "Ref: " . $result['ref'] . "\n";

# 1. Send TRX to TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
#    Pricing is linear at 16,250 energy per TRX.
#    Min 4 TRX (65,000 energy), max 1,000 TRX (16.25M energy).
#    (use your wallet or tronweb CLI)

# 2. Sign the message {tx_hash}:{delegate_to} (proves you are the sender)
#    (use tronWeb.trx.signMessageV2 in your code)

# 3. Claim delegation with tx hash + signature
curl -X POST https://api.tronnrg.com/delegate \
  -H "Content-Type: application/json" \
  -d '{
    "tx_hash":     "YOUR_PAYMENT_TX_HASH",
    "delegate_to": "TWalletThatNeedsEnergy",
    "signature":   "YOUR_SIGNATURE"
  }'

# Response includes delegations[].tx — the on-chain hash you can verify on TronScan