Web3.py调用requestL2Transaction时参数类型不匹配求助

问题场景 #

使用Python的Web3模块与以太坊智能合约交互时，调用requestL2Transaction函数，传入参数看似符合ABI定义，但始终收到「参数类型不匹配」错误。

合约ABI函数签名：

requestL2Transaction(address,uint256,bytes,uint256,uint256,bytes[],address)

调用代码 #

contract_address = "<contract_address>"
abi = <abi> # 合约实际ABI
function_name = "requestL2Transaction"
blockchain = "ethereum"
wallet = <wallet> # 钱包实例

# 函数参数
_contractL2 = "0x..."
_l2Value = 10000000000000000
_calldata = b''
_l2GasLimit = 1100000
_gasPricePerPubdata = 800
_factoryDeps = []
_refundRecipient = "0x..."

interact_with_contract(wallet, contract_address, abi, function_name, blockchain, None, 
                        _contractL2=_contractL2, _l2Value=_l2Value, _calldata=_calldata, 
                        _l2GasLimit=_l2GasLimit, _gasPricePerPubdata=_gasPricePerPubdata, _factoryDeps=_factoryDeps, _refundRecipient=_refundRecipient)

自定义交互函数代码 #

async def interact_with_contract(self, wallet, contract_address, abi, function_name, blockchain, msg_value=None, *args, **kwargs):
    contract = self.web3.eth.contract(address=contract_address, abi=abi)
    function = contract.functions[function_name]
    try:
        function_call = function(*args, **kwargs)
    except Exception as e:
        # 异常处理
        # ...
        return

    # 其他操作
    # ...

报错信息 #

ERROR - 构建函数调用时出错：无法识别名为requestL2Transaction的目标函数，位置参数类型为``，关键字参数类型为{'_l2GasLimit': 'int', '_refundRecipient': 'address', '_gasPricePerPubdata': 'int', '_contractL2': 'address', '_calldata': 'bytes', '_factoryDeps': '(bytes)', '_l2Value': 'int'}。
找到1个名为requestL2Transaction的函数：['requestL2Transaction(address,uint256,bytes,uint256,uint256,bytes[],address)']
函数调用失败，原因是没有匹配的参数类型。

问题分析与解决方案 #

核心问题1：关键字参数名与ABI参数名不匹配 #

你传入的关键字参数带下划线前缀（如_contractL2、_l2Value），但合约ABI中的函数参数名大概率不带下划线前缀。Web3.py通过关键字参数名匹配ABI参数，名称不一致会直接导致类型匹配失败。

解决方法：
查看合约ABI中requestL2Transaction的参数名称，将调用时的关键字参数名改为与ABI完全一致的名称。例如ABI参数名为contractL2，则调用时使用contractL2=_contractL2。

核心问题2：bytes[]类型参数的识别问题 #

报错显示_factoryDeps被识别为单个bytes类型，但ABI要求是bytes[]（字节数组）。即使传入空列表，也需要确保Web3.py正确识别其为数组类型。

解决方法：

• 若factoryDeps确实为空，保持传入空列表即可，但重点先解决参数名匹配问题；
• 若仍有识别问题，可使用Web3.py编码工具显式声明类型：

  from web3 import Web3
  _factoryDeps = Web3.eth.codec.decode_parameter('bytes[]', '0x')  # 解码生成空字节数组
  

额外检查点 #

• 确认所有数值类型参数（如_l2Value、_l2GasLimit）是整数类型，而非字符串；
• _calldata确保是bytes类型（当前传入b''是正确的）；
• 地址参数（_contractL2、_refundRecipient）确保是合法的以太坊地址格式（0x开头，42位十六进制字符）。

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