Uniswap V2 addLiquidityETH调用金额不足问题排查

问题背景 #

• 调用Uniswap Protocol的addLiquidityETH函数此前可正常运行，当前始终返回insufficient amount（金额不足）报错
• 已完成的排查动作：
  • 确认账户持有足额待支出代币
  • 已完成交易对代币、资金池、LP代币的approve花费授权
  • 将MetaMask发起成功交易的参数硬编码到代码中调用仍失败，相同参数在MetaMask端直接发起可正常执行
  • 对比代码传入的代币金额、代币路径与MetaMask交易的calldata完全一致，未找到差异点
• 已知前提：调用的交易对包含WETH

代码问题定位 #

你的代码存在4个明确问题，按影响优先级排序：

1. 缺失交易value参数（核心根因）
   addLiquidityETH是payable类型函数，调用时必须在交易参数中传入value字段，值为你实际要注入的ETH数量（单位wei，函数会自动将这部分ETH兑换为WETH注入资金池）。你当前构造交易的transaction_args仅配置了gasPrice和nonce，value默认为0，相当于告诉合约你要转入0个ETH参与做市，合约校验时必然返回金额不足。这也是你用MetaMask相同参数能交易成功、代码调用失败的核心原因——MetaMask构造交易时会自动把你输入的ETH数额填入value字段，你复制参数时漏掉了这个字段。
2. deadline时间戳计算错误
   Uniswap V2路由要求deadline参数为秒级Unix时间戳，你代码中用trunc(deadline.timestamp()*100)生成的是放大100倍的错误值，相当于把交易有效期设到了几十年后，虽然这个问题一般触发EXPIRED报错，但极端情况下也会干扰合约金额校验逻辑。正确写法是直接取int(deadline.timestamp())即可，一般交易有效期设60-300秒足够，不需要设太长。
3. 代币金额转换逻辑存在兼容缺陷
   你代码中所有代币金额都用Web3.toWei(amount, 'ether')做单位转换，这个方法默认按18位小数计算，如果你做市的ERC20代币不是18位小数（比如USDC、USDT是6位），转换出来的最小单位金额会和实际预期差多个数量级，直接触发金额不足。需要先读取对应ERC20合约的decimals()返回值，按实际小数位做金额转换。
4. getAmountsIn返回值映射错误
   你实现的getAmountsIn方法返回值顺序写反了：getAmountsIn(amountOut, path)的返回数组顺序和path顺序一一对应，比如path为[WETH, 目标代币]时，result[0]是需要的WETH输入量，result[1]是你填入的目标代币输出量，你当前把两个值的映射颠倒，会导致滑点计算出来的最小代币、最小WETH数值完全错误，哪怕其他参数正确也可能因为滑点阈值设置过高触发报错。

注：你提到的给LP代币做授权属于多余操作，addLiquidityETH是路由合约给你铸造LP代币，不需要你授权LP代币的花费权限，仅需要给你注入的ERC20代币做足够额度的授权即可。

addLiquidityETH 标准调用流程 #

• 环境校验：确认RPC节点连接正常，账户私钥导入正确，配置的chainId与目标网络一致
• 余额校验：链上实时查询地址余额，确认ERC20代币余额≥计划注入的代币数量，ETH余额≥计划注入的ETH数量+预估gas费
• 授权校验：调用待注入ERC20代币的approve方法，给Uniswap路由合约授权≥计划注入代币数量的花费额度，等待授权交易上链确认成功后再进行下一步
• 参数计算：
  • 读取交易对资金池的当前储备量，按恒定乘积公式计算注入指定数量ERC20时，需要匹配注入的ETH数量
  • 结合设置的滑点容忍度，计算amountTokenMin（可接受的最小注入代币数）、amountETHMin（可接受的最小注入ETH数）
  • 计算秒级deadline：当前Unix时间戳+交易有效时长（推荐60-300秒）
• 构造交易：
  • 传入正确的合约参数：代币地址、计划注入的代币数量（最小单位）、amountTokenMin、amountETHMin、LP接收地址、deadline
  • 交易参数必须包含：nonce、gasPrice、gasLimit、value（值为实际注入的ETH数量，单位wei）、chainId
• 签名广播：用私钥签名交易后广播到链上，等待交易上链后校验receipt的status字段为1，确认LP代币到账即完成操作

调用前必过校验项 #

• 所有合约地址、钱包地址都转换为checksum格式，避免大小写错误
• 所有代币金额转换时使用对应代币的实际decimals，不默认使用18位换算
• 链上查询路由合约的ERC20 allowance额度，确认额度≥计划注入的代币数量，不要仅本地确认发送过授权交易，必须确认授权交易已上链生效
• 交易nonce取链上pending状态的最新值，避免nonce重复、跳号
• value字段数值与计划注入的ETH数量完全一致，不能为0
• deadline为秒级Unix时间戳，且数值大于当前链上时间
• 所有金额参数满足：amountTokenDesired≥amountTokenMin>0，实际发送的ETH数量≥amountETHMin>0
• 滑点阈值设置合理，避免因为池内价格波动导致实际可成交数量低于最小值触发报错

核心代码修正片段 #

# ========== 1. 金额转换修正 ==========
# 先获取ERC20代币的实际小数位
# token_contract = w3.eth.contract(token_address, abi=ERC20_STANDARD_ABI)
# token_decimals = token_contract.functions.decimals().call()
# ERC20金额按实际小数位转换为最小单位
# token_amount = int(token_amount * (10 ** token_decimals))
# token_amount_min = int(token_amount_min * (10 ** token_decimals))
# ETH为18位小数，正常用wei转换即可
amount_eth_desired = Web3.toWei(amount_eth_desired, 'ether') # 实际要注入的ETH数量
amount_weth_min = Web3.toWei(amount_weth_min, 'ether')

# ========== 2. deadline修正 ==========
deadline = datetime.now() + timedelta(seconds=self.web3_options["transaction_deadline"])
timestamp_deadline = int(deadline.timestamp()) # 秒级时间戳，不要乘100

# ========== 3. 交易参数补全value和chainId ==========
transaction_args = {
    'gasPrice': w3.toWei(self.web3_options["gas_price"], 'gwei'), 
    'nonce': nonce,
    'value': amount_eth_desired, # 之前缺失的核心字段
    'chainId': w3.eth.chain_id, # 增加chainId避免交易重放
    'gas': 300000 # 建议手动设置合理gasLimit，避免estimateGas偏差
}

# ========== 4. 构造交易 ==========
tx = contract.functions.addLiquidityETH(
    token_address, 
    token_amount, 
    token_amount_min, 
    amount_weth_min,
    account_address, 
    timestamp_deadline
).buildTransaction(transaction_args)

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