必要な tronpy バージョンは？

tronpy 0.6.0 以降が必要です。pip install tronpy でインストールしてください。署名ヘルパーは keccak256 TIP-191 ハッシュを自身で計算するため、任意の tronpy バージョンで TronWeb 互換の署名を生成します。

priv.sign_msg() を使わないのはなぜですか？

一部の tronpy バージョンは signMessageV2 が使用する keccak256 TIP-191 方式ではなく sha256 でメッセージをハッシュ化するため、署名検証に失敗します。ハッシュを明示的に計算することで（上記のように）、バージョン間で署名が正しく保たれます。

Pythonでトロンエナジーをレンタルする（tronpy）：コード例

tronpyを使用した完全なPython統合です。各ステップはあなたのプロジェクトにコピーできるスタンドアロンコードブロックです。完全なエンドツーエンドの例は下部にあります。

前提条件： Python 3.8以上、tronpy インストール済み（pip install tronpy）、資金のあるトロンウォレット。

フロー

APIキーなし。サインアップなし。あなたのコードはTRXをオンチェーンでTronEnergyの支払いアドレスに送信し、所有権を証明するメッセージに署名し、その後エナジー委任を請求します。エナジーは約3秒で到着します。その後、あなたのコードは委任されたエナジーを使用してUSDTを送金します。

料金は線形です：1 TRXあたり16,250エナジー。 最小注文は4 TRX（65,000エナジー—標準的なUSDT送金1回分）で、最大は1,000 TRX（16.25M エナジー）です。送信する金額によって、正確にいくら返されるエナジーが決まります—ティアやパッケージはありません。単一の標準送金の場合は4を送信します。新しいウォレット送金の場合は8を送信します。バッチ作業の場合はさらに多く送信します。下記のコードはTRX_AMOUNT 変数を使用しているため、1か所で変更できます。

ステップバイステップ

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。