ڈیولپر دستاویزات
Python کے ساتھ Tron Energy کرائے پر لیں (tronpy): کوڈ کی مثالیں
tronpy استعمال کرتے ہوئے Python میں Tron Energy کرائے پر لیں۔ مکمل انضمام کی مثال: 4 TRX ادا کریں، توانائی کی ڈیلیگیشن کا دعویٰ کریں، اور Tron نیٹ ورک پر USDT ٹرانسفر بھیجیں۔
API ادائیگی کا پتہ
TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
اس پتے پر TRX بھیجیں۔ آپ کا tx ہیش توانائی کی ڈیلیگیشن کا دعویٰ کرنے کے لیے استعمال ہوتا ہے۔
tronpy استعمال کرتے ہوئے مکمل Python انضمام۔ ہر مرحلہ ایک الگ کوڈ بلاک ہے جو آپ اپنے پروجیکٹ میں کاپی کر سکتے ہیں۔ مکمل end-to-end مثال نیچے ہے۔
ضروری چیزیں: Python 3.8+،
tronpy نصب ہے ((pip install tronpy)، ایک مالی Tron والٹ۔
بہاؤ
کوئی API کلید نہیں۔ کوئی سائن اپ نہیں۔ آپ کا کوڈ TronEnergy ادائیگی کے پتے پر on-chain TRX بھیجتا ہے، مالکانہ حق کو ثابت کرنے والا پیغام پر دستخط کرتا ہے، پھر ڈیلیگیشن کا دعویٰ کرتا ہے۔ توانائی تقریباً 3 سیکنڈ میں آتی ہے۔ پھر آپ کا کوڈ منتقل کی گئی توانائی کا استعمال کرتے ہوئے USDT بھیجتا ہے۔
قیمت لکیری ہے: فی TRX 16,250 Energy۔ کم سے کم آرڈر 4 TRX (65,000 Energy — ایک معیاری USDT ٹرانسفر)، زیادہ سے زیادہ 1,000 TRX (16.25M Energy)۔ آپ جو رقم بھیجتے ہیں وہ بالکل یہ طے کرتی ہے کہ کتنی Energy واپس آتی ہے — کوئی درجہ یا پیکیج نہیں۔ ایک معیاری ٹرانسفر کے لیے 4 بھیجیں۔ نیا والٹ ٹرانسفر کے لیے 8 بھیجیں۔ بیچ کے کام کے لیے زیادہ بھیجیں۔ نیچے کا کوڈ ایک
TRX_AMOUNT متغیر استعمال کرتا ہے تاکہ آپ اسے ایک جگہ تبدیل کر سکیں۔
مرحلہ وار
1. سیٹ اپ
سیٹ اپ
import os, requests
from tronpy import Tron
from tronpy.keys import PrivateKey, keccak256
from coincurve import PrivateKey as CCKey # tronpy already depends on coincurve
client = Tron() # mainnet — pass HTTPProvider(api_key=...) to avoid rate limits
priv = PrivateKey(bytes.fromhex(os.environ['TRON_PRIVATE_KEY']))
sender = priv.public_key.to_base58check_address()
API = 'https://api.tronnrg.com'
ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx' # API payment address
USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
2. TRX بھیجیں
ادائیگی بھیجیں
TRX_AMOUNT = 4 # Linear: 16,250 energy per TRX. Min 4, max 1000.
# 4 → 65k (standard) · 8 → 130k (new wallet) · 40 → 650k (10 transfers)
payment = (
client.trx.transfer(sender, ADDR, TRX_AMOUNT * 1_000_000)
.build().sign(priv).broadcast()
)
print('Payment tx:', payment.txid)
3. ڈیلیگیشن کا دعویٰ کریں
ڈیلیگیشن حاصل کریں
# Sign: proves you are the sender. Must equal TronWeb signMessageV2 exactly:
# keccak256("\x19TRON Signed Message:\n" + len + msg), secp256k1, v = rec + 27.
def sign_message_v2(message, priv):
msg = message.encode()
prefix = b"\x19TRON Signed Message:\n" + str(len(msg)).encode()
digest = keccak256(prefix + msg)
raw = CCKey(priv.to_bytes()).sign_recoverable(digest, hasher=None)
return '0x' + (raw[:64] + bytes([raw[64] + 27])).hex()
msg = f"{payment.txid}:{sender}"
sig = sign_message_v2(msg, priv)
delegation = requests.post(f"{API}/delegate", json={
'tx_hash': payment.txid,
'delegate_to': sender,
'signature': sig,
}).json()
if delegation.get('error'):
raise Exception(delegation['message'])
print('Energy delegated:', delegation['energy']) # TRX_AMOUNT × 16,250
4. USDT بھیجیں
USDT بھیجیں
recipient = 'TRecipientWallet'
contract = client.get_contract(USDT)
tx = (
contract.functions.transfer(recipient, 10 * 1_000_000)
.with_owner(sender).fee_limit(50_000_000)
.build().sign(priv).broadcast()
)
print('USDT sent:', tx.txid)
خرابی کی سنبھال
خرابیوں کو سنبھالنا
result = requests.post(f"{API}/delegate", json=payload).json()
if result.get('error'):
err = result['error']
if err == 'payment_verification_failed':
pass # Payment not yet indexed on-chain. Wait 3s and retry.
elif err == 'hash_already_used':
pass # Already claimed. Do not retry.
elif err == 'signature_mismatch':
pass # Sender of TRX != signer of the message. Sign with the same key.
elif err == 'delegation_failed':
pass # Provider could not deliver. Retry or contact support with result['ref'].
مکمل مثال
یہ کوڈ کسی فائل میں ڈالیں، اپنی TRON_PRIVATE_KEY ماحول کی متغیر سیٹ کریں، اور اسے چلائیں۔ یہ اسکرپٹ TRX بھیجتی ہے، پیغام پر دستخط کرتی ہے، دوبارہ کوشش کے ساتھ ڈیلیگیشن کا دعویٰ کرتی ہے، پھر USDT بھیجتی ہے۔
delegate_energy.py
import os, time, requests
from tronpy import Tron
from tronpy.keys import PrivateKey, keccak256
from coincurve import PrivateKey as CCKey
client = Tron() # mainnet — pass HTTPProvider(api_key=...) to avoid rate limits
priv = PrivateKey(bytes.fromhex(os.environ['TRON_PRIVATE_KEY']))
sender = priv.public_key.to_base58check_address()
API = 'https://api.tronnrg.com'
ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx'
USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
# Signature must match TronWeb signMessageV2 byte-for-byte.
def sign_message_v2(message, priv):
msg = message.encode()
prefix = b"\x19TRON Signed Message:\n" + str(len(msg)).encode()
digest = keccak256(prefix + msg)
raw = CCKey(priv.to_bytes()).sign_recoverable(digest, hasher=None)
return '0x' + (raw[:64] + bytes([raw[64] + 27])).hex()
def claim_with_retry(tx_hash, delegate_to, signature, retries=3):
for _ in range(retries):
res = requests.post(f"{API}/delegate", json={
'tx_hash': tx_hash, 'delegate_to': delegate_to, 'signature': signature,
}).json()
if not res.get('error'):
return res
if res['error'] != 'payment_verification_failed':
raise Exception(res['message'])
time.sleep(3)
raise Exception('Transaction not found after retries')
def main():
recipient = 'TRecipientWallet'
trx_amount = 4 # min 4, max 1000 — you get trx_amount × 16,250 energy
# 1. Send TRX (linear pricing: 16,250 energy per TRX)
payment = (
client.trx.transfer(sender, ADDR, trx_amount * 1_000_000)
.build().sign(priv).broadcast()
)
print('Payment:', payment.txid)
# 2. Claim delegation (the signature proves you sent the TRX)
signature = sign_message_v2(f"{payment.txid}:{recipient}", priv)
result = claim_with_retry(payment.txid, recipient, signature)
print('Delegated:', result['energy'], 'energy')
print('Delegation tx:', result['delegations'][0]['tx']) # verify on TronScan
print('Ref:', result['ref'])
# 3. Send USDT using the delegated energy
contract = client.get_contract(USDT)
tx = (
contract.functions.transfer(recipient, 10 * 1_000_000)
.with_owner(sender).fee_limit(50_000_000)
.build().sign(priv).broadcast()
)
print('USDT sent:', tx.txid)
if __name__ == '__main__':
main()
ہمیشہ دستخط شامل کریں۔ یہ ثابت کرتا ہے کہ آپ وہ والٹ ہیں جس نے TRX بھیجا۔ اس کے بغیر، API درخواست کو مسترد کرتا ہے
missing_signature۔