API-и TronEnergy аутентификасионро талаб мекунад?

Калиди API ё сабти ном зарур нест. Шумо ҳар як сўрӯҳро бо имзои паёме, ки исбот мекунад, ки шумо фиристиндаи пардохт ҳастед, аутентификасён мекунед. Махфияни идентификасион нест, калидҳои API нест.

Раванди ифзоиши энергия чӣ гуна кор мекунад?

TRX ба нишонии пардохт фиристед. Паёмро имзо кунед {tx_hash}:{delegate_to} то исбот кунед, ки шумо фиристиндаҳастед. POST /delegate ро бо tx_hash, delegate_to ва имзо зерин даъво кунед. Энергия дар тақрибан 3 сония фиристода мешавад.

Агар ифзоиши энергия пас аз пардохт нокам шавад чи мешавад?

Ба артишот TRX ба таври худкор дар очереди фиристодан ва ба нишонии фиристиндаи он-чейн бармегардад.

Тозахона API барои иҷораи Energy: Нуқтаҳои охири REST ва Мувофиқсозӣ

URL-и асосӣ: https://api.tronnrg.com Санҷиш: Гуноҳе лозим нест. Ҳама нуқтаҳои охири одӣ. Маҳдудияти нарх: 20 дархост/сонияи барои ҳар IP Адреси пардохт: 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
delegate_to	string	лозим	Суроғаи Tron барои қабули энергия
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");

Посухи 200
{
  "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

Тафтиши зиндаӣ барои асбобҳои назорат ва мониторинг. Ҷавобаш аст 200 OK вақте ки раванди API кор мекунад. Узлҳои берунӣ ё фарохимҳо танакку карда намешавад.

Посухи 200

{ "status": "ok" }

Кодҳои хатогӣ

Ҳар як ҷавоби хатогӣ error (устуворӣ дошта, қоиди маъна) ва message (қоидаи давонӣ) дорад. Ҳамеша дар кодатон error -ро фаъол кунед.

Код	HTTP	Маъно
`invalid_tx_hash`	400	Натавонист хэши шаснавҳарфӣ бошед
`invalid_address`	400	Суроғаи Tron дуруст нест
`missing_signature`	400	Имза дода нашуда
`invalid_signature`	401	Имзаро намоҳиш додан ғайриимкон буд
`signature_mismatch`	403	Суроғаи имзакунанда бо фарситандаи пардохт мувофиқат надорад
`hash_already_used`	409	Хэши транзаксия аллакай дархост шуд
`payment_verification_failed`	404 / 400	Таҳқиқи дар занҷира пардохт нокомол шуд. Барои маълумоти бештар ба қсми `message` нигаред: транзаксия ҳанӯз пайдо нашуда (404, баъд аз чанд сония кӯшиш кунед), қабулкунандаи нодуруст, интиқолаҷи TRX нест, ё зери ҳадди куминии 4 TRX.
`delegation_failed`	400 / 500	Фарохим энергия фиристода натавонист. Агар хатогӣ пас аз тасдиқи пардохт рух доди, баргузорӣ авто сатри анҷом дода мешавад. Дар ин ҳолат ба шейе `refund` назар кунед.
`rate_limited`	429	Бисёр сўрӯҳҳои дархост аз ин IP дар як сония. Ҳудди аккал 20/сон.
`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