#![deny(missing_docs)] mod common; mod events; mod methods; mod types; use super::util; use super::Abigen; use anyhow::{anyhow, Context as _, Result}; use ethers_core::{ abi::{parse_abi, Abi}, types::Address, }; use inflector::Inflector; use proc_macro2::{Ident, Literal, TokenStream}; use quote::quote; use std::collections::HashMap; use syn::{Path, Visibility}; /// Internal shared context for generating smart contract bindings. pub(crate) struct Context { /// The ABI string pre-parsing. abi_str: Literal, /// The parsed ABI. abi: Abi, /// Was the ABI in human readable format? human_readable: bool, /// The contract name as an identifier. contract_name: Ident, /// Manually specified method aliases. method_aliases: HashMap, /// Derives added to event structs and enums. event_derives: Vec, } impl Context { pub(crate) fn expand(args: Abigen) -> Result { let cx = Self::from_abigen(args)?; let name = &cx.contract_name; let name_mod = util::ident(&format!( "{}_mod", cx.contract_name.to_string().to_lowercase() )); let abi_name = super::util::safe_ident(&format!("{}_ABI", name.to_string().to_uppercase())); // 0. Imports let imports = common::imports(&name.to_string()); // 1. Declare Contract struct let struct_decl = common::struct_declaration(&cx, &abi_name); // 2. Declare events structs & impl FromTokens for each event let events_decl = cx.events_declaration()?; // 3. impl block for the event functions let contract_events = cx.events()?; // 4. impl block for the contract methods let contract_methods = cx.methods()?; Ok(quote! { // export all the created data types pub use #name_mod::*; #[allow(clippy::too_many_arguments)] mod #name_mod { #imports #struct_decl impl<'a, M: Middleware> #name { /// Creates a new contract instance with the specified `ethers` /// client at the given `Address`. The contract derefs to a `ethers::Contract` /// object pub fn new>(address: T, client: Arc) -> Self { let contract = Contract::new(address.into(), #abi_name.clone(), client); Self(contract) } // TODO: Implement deployment. #contract_methods #contract_events } #events_decl } }) } /// Create a context from the code generation arguments. fn from_abigen(args: Abigen) -> Result { // get the actual ABI string let abi_str = args.abi_source.get().context("failed to get ABI JSON")?; // parse it let (abi, human_readable): (Abi, _) = if let Ok(abi) = serde_json::from_str(&abi_str) { // normal abi format (abi, false) } else { // heuristic for parsing the human readable format // replace bad chars let abi_str = abi_str.replace('[', "").replace(']', "").replace(',', ""); // split lines and get only the non-empty things let split: Vec<&str> = abi_str .split('\n') .map(|x| x.trim()) .filter(|x| !x.is_empty()) .collect(); (parse_abi(&split)?, true) }; let contract_name = util::ident(&args.contract_name); // NOTE: We only check for duplicate signatures here, since if there are // duplicate aliases, the compiler will produce a warning because a // method will be re-defined. let mut method_aliases = HashMap::new(); for (signature, alias) in args.method_aliases.into_iter() { let alias = syn::parse_str(&alias)?; if method_aliases.insert(signature.clone(), alias).is_some() { return Err(anyhow!( "duplicate method signature '{}' in method aliases", signature, )); } } let event_derives = args .event_derives .iter() .map(|derive| syn::parse_str::(derive)) .collect::, _>>() .context("failed to parse event derives")?; Ok(Context { abi, human_readable, abi_str: Literal::string(&abi_str), contract_name, method_aliases, event_derives, }) } }