Web3.py发送全部ETH余额报错：Transaction含无效Decimal类型value字段

错误原因分析 #

你遇到的TypeError: Transaction had invalid fields: {'value': Decimal('xxx')}，核心原因是Web3.py要求交易的value字段必须是Wei单位的整数（以太坊底层以最小单位Wei进行金额计算，不支持小数类型），而你直接传入了Decimal类型的ETH金额，导致参数格式不合法。

全额转账的正确实现步骤 #

要实现账户全额ETH转账（余额扣除Gas费用后全部转出），需要按以下逻辑处理：

1. 获取账户当前余额（Wei单位）
2. 估算转账所需的Gas用量和当前Gas价格，计算总Gas费用
3. 用余额减去总Gas费用，得到实际可转账的金额
4. 构造符合格式要求的交易，签名并发送

完整代码示例 #

from web3 import Web3

# 初始化Web3连接
w3 = Web3(Web3.HTTPProvider("你的RPC节点地址"))

def send_full_balance(from_addr, to_addr, private_key):
    # 1. 获取账户余额（返回Wei单位整数）
    account_balance = w3.eth.get_balance(from_addr)
    
    # 2. 构造临时交易，估算Gas用量
    temp_tx = {
        "from": from_addr,
        "to": to_addr,
        "value": 0,  # 临时设0，不影响Gas估算
        "nonce": w3.eth.get_transaction_count(from_addr)
    }
    gas_limit = w3.eth.estimate_gas(temp_tx)
    
    # 3. 获取当前Gas价格（Wei单位）
    gas_price = w3.eth.gas_price
    
    # 4. 计算总Gas费用
    total_gas_cost = gas_limit * gas_price
    
    # 5. 计算可转账金额：余额 - Gas费用
    transfer_amount = account_balance - total_gas_cost
    
    if transfer_amount <= 0:
        raise ValueError("账户余额不足以支付Gas费用，无法完成转账")
    
    # 6. 构造最终交易
    final_tx = {
        "from": from_addr,
        "to": to_addr,
        "value": transfer_amount,
        "gas": gas_limit,
        "gasPrice": gas_price,
        "nonce": w3.eth.get_transaction_count(from_addr),
        "chainId": w3.eth.chain_id  # 适配对应链的链ID，必填
    }
    
    # 7. 签名并发送交易
    signed_tx = w3.eth.account.sign_transaction(final_tx, private_key)
    tx_hash = w3.eth.send_raw_transaction(signed_tx.rawTransaction)
    
    return w3.to_hex(tx_hash)

额外注意事项 #

• 若使用支持EIP-1559的网络（如以太坊主网、Polygon等），需替换gasPrice为maxFeePerGas和maxPriorityFeePerGas，可以通过w3.eth.fee_history()获取建议费用后设置
• 每次交易的nonce必须唯一且连续，避免重复交易或失败
• 估算Gas时，临时交易的参数要尽可能接近实际交易，确保Gas用量估算准确

内容的提问来源于stack exchange，提问作者RFM