የትኛው tronpy ስሪት ያስፈልጋል?

tronpy 0.6.0 ወይም በኋላ። pip install tronpy ሊንስቲ। የተፈራረመው መታገሪያ ራሱ keccak256 TIP-191 ሃሽ ያሰላል ፣ ስለዚህ በማንኛውም tronpy ስሪት ላይ TronWeb-ተኳሳች ፊርማ ያመነጫል።

ለምን ከ priv.sign_msg() በተቃራኒ?

አንዳንድ tronpy ስሪቶች መልእክቱን ከ sha256 ጋር በመልካቱ ውስጥ ማጠናቀር signMessageV2 የሚጠቀመውን keccak256 TIP-191 መርሃ ግብር ፍርስራስ ይሆናል ፣ ይህም ማረጋገጫ ይውድቃል። ሃሽውን በግልጽ (ታይቶ ያለው) ማሰላሰል ፊርማውን በሁሉም ስሪቶች ላይ ትክክል ይቆየዋል።

Python (tronpy) በ Tron ኃይል ከURI: ኮድ ምሳሌዎች

ሙሉ Python ማዋቀር tronpy በመጠቀም። እያንዳንዱ ደረጃ ወደ ፕሮጀክቱ መቅዳት የሚችሉት ራሱን የቻለ ኮድ ብሎክ ነው። ሙሉ ጀርባ-ወደ-ጀርባ ምሳሌ ታች ነው።

ቅድመ-ሁኔታዎች: Python 3.8+፣ tronpy ተጫንቷል ((pip install tronpy)፣ የገንዘብ Tron ዋሌት።

ሂደቱ

API ቁልፍ አይ. ምዝገባ አይ. ኮዱ TRX በ TronEnergy ክፍያ አድራሻ ላይ-ሰንሰለት ይላከ፣ ባለቤትነትን የሚያረጋግጥ መልዕክት ይፈርማል፣ ከዚያም ስልጣንውን ይጠይቃል። ኃይል በግምት 3 ሰከንዶች ውስጥ ይደርሳል። ከዚያም ኮዱ ተዋወቀ ኃይል በ USDT ይላከ።

ዋጋ 線形: 16,250 ኃይል በ TRX። ትንሹ ትዕዛዝ 4 TRX (65,000 ኃይል — አንድ መደበኛ USDT ሽግግር)፣ ከፍተኛ 1,000 TRX (16.25M ኃይል)። ምንዛሬው ምንዛሬ ወደ ኃይል የሚመጣ ሆኖ ነጠብጣቦች ወይም ፓኬጆች የሉም። ላንዱ መደበኛ ሽግግር ለ 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።