필요한 tronpy 버전은 무엇입니까?

tronpy 0.6.0 이상이 필요합니다. pip install tronpy로 설치하세요. 서명 도우미는 keccak256 TIP-191 해시를 자체적으로 계산하므로 모든 tronpy 버전에서 TronWeb 호환 서명을 생성합니다.

priv.sign_msg()를 사용하지 않는 이유는?

일부 tronpy 버전은 signMessageV2가 사용하는 keccak256 TIP-191 스킴 대신 sha256으로 메시지를 해시하므로 검증에 실패합니다. 명시적으로 해시를 계산하면(표시된 대로) 모든 버전에서 서명이 올바르게 유지됩니다.

Python(tronpy)으로 Tron 에너지 임대하기: 코드 예제

tronpy를 사용한 완전한 Python 통합입니다. 각 단계는 프로젝트에 복사할 수 있는 독립적인 코드 블록입니다. 전체 엔드투엔드 예제는 하단에 있습니다.

필수 조건: Python 3.8+, tronpy 설치됨(pip install tronpy), 자금이 조성된 Tron 지갑.

프로세스

API 키 없음. 가입 없음. 코드가 TronEnergy 결제 주소로 TRX를 온체인으로 전송하고, 소유권을 증명하는 메시지에 서명한 뒤 위임을 요청합니다. 에너지는 약 3초 내에 도착합니다. 그 다음 코드가 위임된 에너지를 사용하여 USDT를 전송합니다.

가격은 선형입니다: TRX당 에너지 16,250. 최소 주문은 4 TRX(65,000 에너지 — 하나의 표준 USDT 전송), 최대 1,000 TRX(1625만 에너지)입니다. 전송하는 금액이 정확히 돌아오는 에너지의 양을 결정합니다 — 계층이나 패키지는 없습니다. 단일 표준 전송의 경우 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.