MATIC Mumbai测试网Web3调用已部署智能合约报错：unknown account

你遇到的ValueError: {'code': -32000, 'message': 'unknown account'}错误，根源是执行写入交易（set方法）时，Web3无法找到用于发起交易的账户：

• 只读操作（比如get方法）不需要签名，所以能正常返回结果；
• 写入交易需要签名，而你连接的Mumbai公共节点（比如Alchemy/Infura）不会托管你的私钥，transact()默认尝试使用节点本地账户，自然找不到，就报了这个错。

解决步骤 #

1. 安全管理钱包私钥 #

绝对不要直接把私钥硬编码在代码里，建议用环境变量读取：

import os
# 从系统环境变量读取私钥
private_key = os.environ.get("MUMBAI_WALLET_PRIVATE_KEY")
if not private_key:
    raise Exception("请先设置MUMBAI_WALLET_PRIVATE_KEY环境变量")

2. 生成账户对象并验证状态 #

用私钥生成账户，同时检查账户余额是否足够支付Gas：

account = w3.eth.account.from_key(private_key)
print(f"当前使用账户: {account.address}")
# 转换为MATIC单位显示余额
balance = w3.from_wei(w3.eth.get_balance(account.address), 'ether')
print(f"账户测试MATIC余额: {balance}")

3. 构建并签名交易 #

替换原代码中transact()的逻辑，改为手动构建交易并签名（公共节点不支持自动签名）：

if gas_estimate < 100000:
    print('Sending transaction to set(3)\n')
    # 组装交易参数
    tx_params = {
        'from': account.address,
        'gas': gas_estimate,
        'gasPrice': w3.eth.gas_price,
        'nonce': w3.eth.get_transaction_count(account.address),
        'chainId': 80001  # Mumbai测试网固定链ID
    }
    # 生成合约交易数据
    tx = c.functions.set(3).build_transaction(tx_params)
    # 用私钥签名交易
    signed_tx = w3.eth.account.sign_transaction(tx, private_key)
    # 发送签名后的原始交易
    tx_hash = w3.eth.send_raw_transaction(signed_tx.rawTransaction)
    receipt = w3.eth.wait_for_transaction_receipt(tx_hash)
    print(f"交易已上链，哈希: {tx_hash.hex()}")
    print("Transaction receipt mined:")
    pprintpp.pprint(receipt)
else:
    print("Gas cost exceeds 100000")

额外注意事项 #

• 确保账户有足够的Mumbai测试MATIC，没有的话去对应水龙头领取；
• 若遇到nonce冲突，可改用w3.eth.get_transaction_count(account.address, 'pending')获取待确认状态的nonce；
• 私钥务必妥善保管，不要泄露或提交到代码仓库。

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