用途 web3-py 是一个 Python 库，用于通过 Web3 协议与以太坊区块链交互，使开发者能以编程方式访问区块链数据、智能合约和交易。适合构建需要查询以太坊数据、部署智能合约或处理交易的 Python 应用，例如 dApp、区块链分析或与以太坊节点交互的自动化脚本。
主要能力 可通过 HTTP、WebSocket 或 IPC 提供者连接以太坊节点；管理账户、签名交易和处理 gas 估算；使用 ABI 定义与智能合约交互；查询区块链状态，包括余额、区块和事件；支持以太坊兼容链，如币安智能链。
使用方式 安装命令为 pip install web3。初始化时需要一个提供者，例如 Web3(Web3.HTTPProvider('https://mainnet.infura.io/v3/' + os.getenv('INFURA_API_KEY')))。敏感密钥应使用环境变量，例如设置 INFURA_API_KEY。本地节点可使用 IPC：Web3(Web3.IPCProvider('/path/to/geth.ipc'))。获取余额用 w3.eth.get_balance(address)；发送交易用 w3.eth.send_transaction(transaction)，签名用 w3.eth.account.sign_transaction(tx, private_key=...)，广播用 w3.eth.send_raw_transaction(signed_tx.rawTransaction)；调用合约函数用 contract.functions.myFunction().call()；估算 gas 用 w3.eth.estimate_gas(transaction)。交易中应指定 chain ID 以防重放攻击，建议在 Ganache 等沙盒中测试后再上生产。
限制与错误处理 需处理连接错误（如 web3.exceptions.ConnectionError）和交易失败（如 ValueError，用于余额不足或 gas 问题）。使用前可用 w3.is_address(address) 校验地址。生产环境建议将调用包裹在 try-except 中并使用可靠提供者 URL。资料未提供收费、价格或具体性能数据。