NYARAKA ZA WATENGENEZAJI
Kukodisha Nishati ya Tron na Python (tronpy): Mifano ya Msimbo
Kukodisha Nishati ya Tron kwa kutumia tronpy katika Python. Mfano kamili wa ujumuishaji: lipa TRX 4, dai haki ya kukodisha nishati, na tuma uhamisho wa USDT kwenye mtandao wa Tron.
ANWANI YA MALIPO YA API
TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
Tuma TRX kwenye anwani hii. Hash yako ya tx inatumika kuomba kukodisha nishati.
Ujumuishaji kamili wa Python kwa kutumia tronpy. Kila hatua ni kitalu kinachoweza kuwa kwa kurejelea katika mradi wako. Mfano kamili wa mwisho hadi mwanzo uko chini.
Mahitaji: Python 3.8+,
tronpy iliyosakinishwa (pip install tronpy), pochi ya Tron iliyo na fedha.
Mtiririko
Hakuna funguo la API. Hakuna kusajili. Msimbo wako unatuma TRX kwenye mlangoni wa blokcheni kwenye anwani ya malipo ya TronEnergy, inasaini ujumbe unathibitisha umiliki, kisha inaida kukodisha nishati. Nishati ifika kwa takriban sekunde 3. Kisha msimbo wako unatuma USDT kwa kutumia nishati iliyokodishwa.
Bei ni ya moja kwa moja: Nishati 16,250 kwa TRX. Agizo la chini zaidi TRX 4 (Nishati 65,000 — uhamisho mmoja wa kawaida wa USDT), kiwango cha juu zaidi TRX 1,000 (Nishati 16.25M). Kiasi unachokituma huamua haswa ni nishati ngapi itarudi — hakuna safu au vifurushi. Kwa uhamisho mmoja wa kawaida, tuma 4. Kwa uhamisho wa pochi mpya, tuma 8. Kwa kazi ya kuchanganya, tuma zaidi. Msimbo chini hutumia
TRX_AMOUNT kigezo kwa hivyo unaweza kubadilisha katika mahali pamoja.
Hatua kwa Hatua
1. Sanidi
kuandaa
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. Tuma TRX
kutuma malipo
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. Dai Ombi la Kukodisha Nishati
kukuza ridhaa
# 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. Tuma USDT
kutuma 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)
Kushughulikia Hitilafu
kushughulikia makosa
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'].
Mfano Kamili
Nakili hii kwenye faili, weka vigezo vya mazingira vya TRON_PRIVATE_KEY, na ueneze. Hati hiyo inatuma TRX, inasainisha ujumbe, inaidai kukodisha nishati na majaribio, kisha inatuma 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()
Kamata kila wakati inasainisha. Inathibitisha kuwa wewe ndio pochi iliyotuma TRX. Bila hiyo, API inakataa ombi na
missing_signature.