如何用abigen以通用方式内联加载ABI实现合约实例化工具函数？

问题原因分析 #

1. 第一个错误（use of undeclared type CONTRACT）：
   abigen!是编译期宏，它在编译阶段就需要确定ABI文件的路径，无法接受运行时动态生成的字符串（比如format!的结果）。宏的执行时机早于代码运行，所以只能传入编译期可见的字面量路径。

2. 第二个错误（返回类型不匹配）：
   函数内通过abigen!生成的CONTRACT类型是局部编译期生成的专属类型，编译器无法在函数签名中提前识别该类型，而且不同ABI生成的合约类型完全不同，无法用单一类型作为返回值。

解决方案：使用通用动态合约类型 #

如果要实现通用的合约实例化工具函数，推荐使用ethers库提供的Contract通用结构体（注意不是abigen!生成的专属合约类型），它支持动态加载ABI，无需编译期生成强类型，完美适配你的需求。

完整代码示例

use ethers::{
    abi::Abi,
    contract::Contract,
    providers::{Http, Provider},
    types::Address,
};
use eyre::Result;
use std::fs;
use std::sync::Arc;

fn instantiate_contract(
    contract_address_str: &str,
    abi_file: &str,
    client: Provider<Http>,
) -> Result<Contract<Provider<Http>>> {
    // 解析合约地址
    let contract_address: Address = contract_address_str.parse()?;
    
    // 读取并解析ABI文件
    let abi_content = fs::read_to_string(format!("./abis/{}", abi_file))?;
    let abi: Abi = serde_json::from_str(&abi_content)?;
    
    // 创建通用合约实例
    let contract = Contract::new(contract_address, abi, Arc::new(client));
    Ok(contract)
}

方案说明

• 这个Contract是ethers提供的动态合约类型，能处理任意ABI的合约，无需提前通过abigen!生成强类型。
• 调用合约方法时，使用动态调用语法，比如：

  // 调用合约的balanceOf方法
  let balance = contract.method::<u128>("balanceOf", vec![user_address])?.call().await?;
  

备选方案：强类型合约的代码复用（适合固定合约场景） #

如果必须使用abigen!生成的强类型合约（比如需要类型安全的方法调用），可以提前为所有需要的ABI生成合约类型，再通过Trait抽象共同行为：

代码示例

use ethers::{contract::abigen, providers::{Http, Provider}, types::Address};
use eyre::Result;
use std::sync::Arc;

// 提前为每个ABI生成强类型合约
abigen!(AAVE2, "./abis/AAVE2.json");
abigen!(UniswapV3, "./abis/UniswapV3.json");

// 定义Trait抽象合约的通用构造逻辑
trait ContractInstance {
    fn new_instance(address: &str, client: Provider<Http>) -> Result<Self>
    where
        Self: Sized;
}

impl ContractInstance for AAVE2<Provider<Http>> {
    fn new_instance(address: &str, client: Provider<Http>) -> Result<Self> {
        let addr: Address = address.parse()?;
        Ok(Self::new(addr, Arc::new(client)))
    }
}

impl ContractInstance for UniswapV3<Provider<Http>> {
    fn new_instance(address: &str, client: Provider<Http>) -> Result<Self> {
        let addr: Address = address.parse()?;
        Ok(Self::new(addr, Arc::new(client)))
    }
}

// 使用示例
fn main() -> Result<()> {
    let client = Provider::<Http>::try_from("https://mainnet.infura.io/v3/your-api-key")?;
    let aave_contract = AAVE2::new_instance("0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9", client.clone())?;
    Ok(())
}

方案说明

• 此方案适合合约数量固定的场景，提前生成所有需要的强类型，通过Trait复用实例化逻辑。
• 缺点是无法动态支持任意新的ABI，每次新增合约都需要添加对应的abigen!和ContractInstance实现。

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