git.delta.rocks / unique-network / refs/commits / 9ec63641102a

difftreelog

source

crates/evm-coder-macros/src/solidity_interface.rs18.1 KiBsourcehistory
1#![allow(dead_code)]23use quote::quote;4use darling::{FromMeta, ToTokens};5use inflector::cases;6use std::fmt::Write;7use syn::{8	Expr, FnArg, GenericArgument, Generics, Ident, ImplItem, ImplItemMethod, ItemImpl, Lit, Meta,9	NestedMeta, PatType, Path, PathArguments, ReturnType, Type, spanned::Spanned,10};1112use crate::{13	fn_selector_str, parse_ident_from_pat, parse_ident_from_path, parse_path, parse_path_segment,14	parse_result_ok, pascal_ident_to_call, pascal_ident_to_snake_call, snake_ident_to_pascal,15	snake_ident_to_screaming,16};1718struct Is {19	name: Ident,20	pascal_call_name: Ident,21	snake_call_name: Ident,22}23impl Is {24	fn try_from(path: &Path) -> syn::Result<Self> {25		let name = parse_ident_from_path(path, false)?.clone();26		Ok(Self {27			pascal_call_name: pascal_ident_to_call(&name),28			snake_call_name: pascal_ident_to_snake_call(&name),29			name,30		})31	}3233	fn expand_call_def(&self) -> proc_macro2::TokenStream {34		let name = &self.name;35		let pascal_call_name = &self.pascal_call_name;36		quote! {37			#name(#pascal_call_name)38		}39	}4041	fn expand_interface_id(&self) -> proc_macro2::TokenStream {42		let pascal_call_name = &self.pascal_call_name;43		quote! {44			interface_id ^= #pascal_call_name::interface_id();45		}46	}4748	fn expand_supports_interface(&self) -> proc_macro2::TokenStream {49		let pascal_call_name = &self.pascal_call_name;50		quote! {51			#pascal_call_name::supports_interface(interface_id)52		}53	}5455	fn expand_variant_call(&self) -> proc_macro2::TokenStream {56		let name = &self.name;57		let pascal_call_name = &self.pascal_call_name;58		quote! {59			InternalCall::#name(call) => return <Self as ::evm_coder::Callable<#pascal_call_name>>::call(self, Msg {60				call,61				caller: c.caller,62				value: c.value,63			})64		}65	}6667	fn expand_parse(&self) -> proc_macro2::TokenStream {68		let name = &self.name;69		let pascal_call_name = &self.pascal_call_name;70		quote! {71			if let Some(parsed_call) = #pascal_call_name::parse(method_id, reader)? {72				return Ok(Some(Self::#name(parsed_call)))73			}74		}75	}7677	fn expand_generator(&self) -> proc_macro2::TokenStream {78		let pascal_call_name = &self.pascal_call_name;79		quote! {80			#pascal_call_name::generate_solidity_interface(tc, is_impl);81		}82	}8384	fn expand_event_generator(&self) -> proc_macro2::TokenStream {85		let name = &self.name;86		quote! {87			#name::generate_solidity_interface(tc, is_impl);88		}89	}90}9192#[derive(Default)]93struct IsList(Vec<Is>);94impl FromMeta for IsList {95	fn from_list(items: &[NestedMeta]) -> darling::Result<Self> {96		let mut out = Vec::new();97		for item in items {98			match item {99				NestedMeta::Meta(Meta::Path(path)) => out.push(Is::try_from(path)?),100				_ => return Err(syn::Error::new(item.span(), "expected path").into()),101			}102		}103		Ok(Self(out))104	}105}106107#[derive(FromMeta)]108pub struct InterfaceInfo {109	name: Ident,110	#[darling(default)]111	is: IsList,112	#[darling(default)]113	inline_is: IsList,114	#[darling(default)]115	events: IsList,116}117118#[derive(FromMeta)]119struct MethodInfo {120	#[darling(default)]121	rename_selector: Option<String>,122}123124enum AbiType {125	// type126	Plain(Ident),127	// (type1,type2)128	Tuple(Vec<AbiType>),129	// type[]130	Vec(Box<AbiType>),131	// type[20]132	Array(Box<AbiType>, usize),133}134impl AbiType {135	fn try_from(value: &Type) -> syn::Result<Self> {136		let value = Self::try_maybe_special_from(value)?;137		if value.is_special() {138			return Err(syn::Error::new(value.span(), "unexpected special type"));139		}140		Ok(value)141	}142	fn try_maybe_special_from(value: &Type) -> syn::Result<Self> {143		match value {144			Type::Array(arr) => {145				let wrapped = AbiType::try_from(&arr.elem)?;146				match &arr.len {147					Expr::Lit(l) => match &l.lit {148						Lit::Int(i) => {149							let num = i.base10_parse::<usize>()?;150							Ok(AbiType::Array(Box::new(wrapped), num as usize))151						}152						_ => Err(syn::Error::new(arr.len.span(), "should be int literal")),153					},154					_ => Err(syn::Error::new(arr.len.span(), "should be literal")),155				}156			}157			Type::Path(_) => {158				let path = parse_path(value)?;159				let segment = parse_path_segment(path)?;160				if segment.ident == "Vec" {161					let args = match &segment.arguments {162						PathArguments::AngleBracketed(e) => e,163						_ => {164							return Err(syn::Error::new(165								segment.arguments.span(),166								"missing Vec generic",167							))168						}169					};170					let args = &args.args;171					if args.len() != 1 {172						return Err(syn::Error::new(173							args.span(),174							"expected only one generic for vec",175						));176					}177					let arg = args.first().unwrap();178179					let ty = match arg {180						GenericArgument::Type(ty) => ty,181						_ => {182							return Err(syn::Error::new(183								arg.span(),184								"expected first generic to be type",185							))186						}187					};188189					let wrapped = AbiType::try_from(ty)?;190					Ok(Self::Vec(Box::new(wrapped)))191				} else {192					if !segment.arguments.is_empty() {193						return Err(syn::Error::new(194							segment.arguments.span(),195							"unexpected generic arguments for non-vec type",196						));197					}198					Ok(Self::Plain(segment.ident.clone()))199				}200			}201			Type::Tuple(t) => {202				let mut out = Vec::with_capacity(t.elems.len());203				for el in t.elems.iter() {204					out.push(AbiType::try_from(el)?)205				}206				Ok(Self::Tuple(out))207			}208			_ => Err(syn::Error::new(209				value.span(),210				"unexpected type, only arrays, plain types and tuples are supported",211			)),212		}213	}214	fn is_value(&self) -> bool {215		match self {216			Self::Plain(v) if v == "value" => true,217			_ => false,218		}219	}220	fn is_caller(&self) -> bool {221		match self {222			Self::Plain(v) if v == "caller" => true,223			_ => false,224		}225	}226	fn is_special(&self) -> bool {227		self.is_caller() || self.is_value()228	}229	fn selector_ty_buf(&self, buf: &mut String) -> std::fmt::Result {230		match self {231			AbiType::Plain(t) => {232				write!(buf, "{}", t)233			}234			AbiType::Tuple(t) => {235				write!(buf, "(")?;236				for (i, t) in t.iter().enumerate() {237					if i != 0 {238						write!(buf, ",")?;239					}240					t.selector_ty_buf(buf)?;241				}242				write!(buf, ")")243			}244			AbiType::Vec(v) => {245				v.selector_ty_buf(buf)?;246				write!(buf, "[]")247			}248			AbiType::Array(v, len) => {249				v.selector_ty_buf(buf)?;250				write!(buf, "[{}]", len)251			}252		}253	}254	fn selector_ty(&self) -> String {255		let mut out = String::new();256		self.selector_ty_buf(&mut out).expect("no fmt error");257		out258	}259}260impl ToTokens for AbiType {261	fn to_tokens(&self, tokens: &mut proc_macro2::TokenStream) {262		match self {263			AbiType::Plain(t) => tokens.extend(quote! {#t}),264			AbiType::Tuple(t) => {265				tokens.extend(quote! {(266					#(#t),*267				)});268			}269			AbiType::Vec(v) => tokens.extend(quote! {Vec<#v>}),270			AbiType::Array(v, l) => tokens.extend(quote! {[#v; #l]}),271		}272	}273}274275struct MethodArg {276	name: Ident,277	camel_name: String,278	ty: AbiType,279}280impl MethodArg {281	fn try_from(value: &PatType) -> syn::Result<Self> {282		let name = parse_ident_from_pat(&value.pat)?.clone();283		Ok(Self {284			camel_name: cases::camelcase::to_camel_case(&name.to_string()),285			name,286			ty: AbiType::try_maybe_special_from(&value.ty)?,287		})288	}289	fn is_value(&self) -> bool {290		self.ty.is_value()291	}292	fn is_caller(&self) -> bool {293		self.ty.is_caller()294	}295	fn is_special(&self) -> bool {296		self.ty.is_special()297	}298	fn selector_ty(&self) -> String {299		assert!(!self.is_special());300		self.ty.selector_ty()301	}302303	fn expand_call_def(&self) -> proc_macro2::TokenStream {304		assert!(!self.is_special());305		let name = &self.name;306		let ty = &self.ty;307308		quote! {309			#name: #ty310		}311	}312313	fn expand_parse(&self) -> proc_macro2::TokenStream {314		assert!(!self.is_special());315		let name = &self.name;316		quote! {317			#name: reader.abi_read()?318		}319	}320321	fn expand_call_arg(&self) -> proc_macro2::TokenStream {322		if self.is_value() {323			quote! {324				c.value.clone()325			}326		} else if self.is_caller() {327			quote! {328				c.caller.clone()329			}330		} else {331			let name = &self.name;332			quote! {333				#name334			}335		}336	}337338	fn expand_solidity_argument(&self) -> proc_macro2::TokenStream {339		let camel_name = &self.camel_name.to_string();340		let ty = &self.ty;341		quote! {342			<NamedArgument<#ty>>::new(#camel_name)343		}344	}345}346347#[derive(PartialEq)]348enum Mutability {349	Mutable,350	View,351	Pure,352}353354struct Method {355	name: Ident,356	camel_name: String,357	pascal_name: Ident,358	screaming_name: Ident,359	selector_str: String,360	selector: u32,361	args: Vec<MethodArg>,362	has_normal_args: bool,363	mutability: Mutability,364	result: Type,365}366impl Method {367	fn try_from(value: &ImplItemMethod) -> syn::Result<Self> {368		let mut info = MethodInfo {369			rename_selector: None,370		};371		for attr in &value.attrs {372			let ident = parse_ident_from_path(&attr.path, false)?;373			if ident == "solidity" {374				let args = attr.parse_meta().unwrap();375				info = MethodInfo::from_meta(&args).unwrap();376			} else if ident == "doc" {377				// TODO: Add docs to evm interfaces378			}379		}380		let ident = &value.sig.ident;381		let ident_str = ident.to_string();382		if !cases::snakecase::is_snake_case(&ident_str) {383			return Err(syn::Error::new(ident.span(), "method name should be snake_cased\nif alternative solidity name needs to be set - use #[solidity] attribute"));384		}385386		let mut mutability = Mutability::Pure;387388		if let Some(FnArg::Receiver(receiver)) = value389			.sig390			.inputs391			.iter()392			.find(|arg| matches!(arg, FnArg::Receiver(_)))393		{394			if receiver.reference.is_none() {395				return Err(syn::Error::new(396					receiver.span(),397					"receiver should be by ref",398				));399			}400			if receiver.mutability.is_some() {401				mutability = Mutability::Mutable;402			} else {403				mutability = Mutability::View;404			}405		}406		let mut args = Vec::new();407		for typ in value408			.sig409			.inputs410			.iter()411			.filter(|arg| matches!(arg, FnArg::Typed(_)))412		{413			let typ = match typ {414				FnArg::Typed(typ) => typ,415				_ => unreachable!(),416			};417			args.push(MethodArg::try_from(typ)?);418		}419420		if mutability != Mutability::Mutable && args.iter().any(|arg| arg.is_value()) {421			return Err(syn::Error::new(422				args.iter().find(|arg| arg.is_value()).unwrap().ty.span(),423				"payable function should be mutable",424			));425		}426427		let result = match &value.sig.output {428			ReturnType::Type(_, ty) => ty,429			_ => return Err(syn::Error::new(value.sig.output.span(), "interface method should return Result<value>\nif there is no value to return - specify void (which is alias to unit)")),430		};431		let result = parse_result_ok(result)?;432433		let camel_name = info434			.rename_selector435			.unwrap_or_else(|| cases::camelcase::to_camel_case(&ident.to_string()));436		let mut selector_str = camel_name.clone();437		selector_str.push('(');438		let mut has_normal_args = false;439		for (i, arg) in args.iter().filter(|arg| !arg.is_special()).enumerate() {440			if i != 0 {441				selector_str.push(',');442			}443			write!(selector_str, "{}", arg.selector_ty()).unwrap();444			has_normal_args = true;445		}446		selector_str.push(')');447		let selector = fn_selector_str(&selector_str);448449		Ok(Self {450			name: ident.clone(),451			camel_name,452			pascal_name: snake_ident_to_pascal(ident),453			screaming_name: snake_ident_to_screaming(ident),454			selector_str,455			selector,456			args,457			has_normal_args,458			mutability,459			result: result.clone(),460		})461	}462	fn expand_call_def(&self) -> proc_macro2::TokenStream {463		let defs = self464			.args465			.iter()466			.filter(|a| !a.is_special())467			.map(|a| a.expand_call_def());468		let pascal_name = &self.pascal_name;469470		if self.has_normal_args {471			quote! {472				#pascal_name {473					#(474						#defs,475					)*476				}477			}478		} else {479			quote! {#pascal_name}480		}481	}482483	fn expand_const(&self) -> proc_macro2::TokenStream {484		let screaming_name = &self.screaming_name;485		let selector = self.selector;486		let selector_str = &self.selector_str;487		quote! {488			#[doc = #selector_str]489			const #screaming_name: u32 = #selector;490		}491	}492493	fn expand_interface_id(&self) -> proc_macro2::TokenStream {494		let screaming_name = &self.screaming_name;495		quote! {496			interface_id ^= Self::#screaming_name;497		}498	}499500	fn expand_parse(&self) -> proc_macro2::TokenStream {501		let pascal_name = &self.pascal_name;502		let screaming_name = &self.screaming_name;503		if self.has_normal_args {504			let parsers = self505				.args506				.iter()507				.filter(|a| !a.is_special())508				.map(|a| a.expand_parse());509			quote! {510				Self::#screaming_name => return Ok(Some(Self::#pascal_name {511					#(512						#parsers,513					)*514				}))515			}516		} else {517			quote! { Self::#screaming_name => return Ok(Some(Self::#pascal_name)) }518		}519	}520521	fn expand_variant_call(&self) -> proc_macro2::TokenStream {522		let pascal_name = &self.pascal_name;523		let name = &self.name;524525		let matcher = if self.has_normal_args {526			let names = self527				.args528				.iter()529				.filter(|a| !a.is_special())530				.map(|a| &a.name);531532			quote! {{533				#(534					#names,535				)*536			}}537		} else {538			quote! {}539		};540541		let receiver = match self.mutability {542			Mutability::Mutable | Mutability::View => quote! {self.},543			Mutability::Pure => quote! {Self::},544		};545		let args = self.args.iter().map(|a| a.expand_call_arg());546547		quote! {548			InternalCall::#pascal_name #matcher => {549				let result = #receiver #name(550					#(551						#args,552					)*553				)?;554				(&result).abi_write(&mut writer);555			}556		}557	}558559	fn expand_solidity_function(&self) -> proc_macro2::TokenStream {560		let camel_name = &self.camel_name;561		let mutability = match self.mutability {562			Mutability::Mutable => quote! {SolidityMutability::Mutable},563			Mutability::View => quote! { SolidityMutability::View },564			Mutability::Pure => quote! {SolidityMutability::Pure},565		};566		let result = &self.result;567568		let args = self569			.args570			.iter()571			.filter(|a| !a.is_special())572			.map(MethodArg::expand_solidity_argument);573		let selector = format!("{} {:0>8x}", self.selector_str, self.selector);574575		quote! {576			SolidityFunction {577				selector: #selector,578				name: #camel_name,579				mutability: #mutability,580				args: (581					#(582						#args,583					)*584				),585				result: <UnnamedArgument<#result>>::default(),586			}587		}588	}589}590591pub struct SolidityInterface {592	generics: Generics,593	name: Box<syn::Type>,594	info: InterfaceInfo,595	methods: Vec<Method>,596}597impl SolidityInterface {598	pub fn try_from(info: InterfaceInfo, value: &ItemImpl) -> syn::Result<Self> {599		let mut methods = Vec::new();600601		for item in &value.items {602			if let ImplItem::Method(method) = item {603				methods.push(Method::try_from(method)?)604			}605		}606		Ok(Self {607			generics: value.generics.clone(),608			name: value.self_ty.clone(),609			info,610			methods,611		})612	}613	pub fn expand(self) -> proc_macro2::TokenStream {614		let name = self.name;615616		let solidity_name = self.info.name.to_string();617		let call_name = pascal_ident_to_call(&self.info.name);618		let generics = self.generics;619620		let call_sub = self621			.info622			.inline_is623			.0624			.iter()625			.chain(self.info.is.0.iter())626			.map(Is::expand_call_def);627		let call_parse = self628			.info629			.inline_is630			.0631			.iter()632			.chain(self.info.is.0.iter())633			.map(Is::expand_parse);634		let call_variants = self635			.info636			.inline_is637			.0638			.iter()639			.chain(self.info.is.0.iter())640			.map(Is::expand_variant_call);641642		let inline_interface_id = self.info.inline_is.0.iter().map(Is::expand_interface_id);643		let supports_interface = self.info.is.0.iter().map(Is::expand_supports_interface);644645		let calls = self.methods.iter().map(Method::expand_call_def);646		let consts = self.methods.iter().map(Method::expand_const);647		let interface_id = self.methods.iter().map(Method::expand_interface_id);648		let parsers = self.methods.iter().map(Method::expand_parse);649		let call_variants_this = self.methods.iter().map(Method::expand_variant_call);650		let solidity_functions = self.methods.iter().map(Method::expand_solidity_function);651652		// TODO: Inline inline_is653		let solidity_is = self654			.info655			.is656			.0657			.iter()658			.chain(self.info.inline_is.0.iter())659			.map(|is| is.name.to_string());660		let solidity_events_is = self.info.events.0.iter().map(|is| is.name.to_string());661		let solidity_generators = self662			.info663			.is664			.0665			.iter()666			.chain(self.info.inline_is.0.iter())667			.map(Is::expand_generator);668		let solidity_event_generators = self.info.events.0.iter().map(Is::expand_event_generator);669670		// let methods = self.methods.iter().map(Method::solidity_def);671672		quote! {673			#[derive(Debug)]674			pub enum #call_name {675				#(676					#calls,677				)*678				#(679					#call_sub,680				)*681			}682			impl #call_name {683				#(684					#consts685				)*686				pub const fn interface_id() -> u32 {687					let mut interface_id = 0;688					#(#interface_id)*689					#(#inline_interface_id)*690					interface_id691				}692				pub fn supports_interface(interface_id: u32) -> bool {693					interface_id != 0xffffff && (694						interface_id == Self::interface_id()695						#(696							|| #supports_interface697						)*698					)699				}700				pub fn generate_solidity_interface(tc: &evm_coder::solidity::TypeCollector, is_impl: bool) {701					use evm_coder::solidity::*;702					use core::fmt::Write;703					let interface = SolidityInterface {704						name: #solidity_name,705						is: &["Dummy", #(706							#solidity_is,707						)* #(708							#solidity_events_is,709						)* ],710						functions: (#(711							#solidity_functions,712						)*),713					};714					if is_impl {715						tc.collect("// Common stubs holder\ncontract Dummy {\n\tuint8 dummy;\n\tstring stub_error = \"this contract is implemented in native\";\n}\n".into());716					} else {717						tc.collect("// Common stubs holder\ninterface Dummy {\n}\n".into());718					}719					#(720						#solidity_generators721					)*722					#(723						#solidity_event_generators724					)*725726					let mut out = string::new();727					// In solidity interface usage (is) should be preceeded by interface definition728					// This comment helps to sort it in a set729					if #solidity_name.starts_with("Inline") {730						out.push_str("// Inline\n");731					}732					let _ = interface.format(is_impl, &mut out, tc);733					tc.collect(out);734				}735			}736			impl ::evm_coder::Call for #call_name {737				fn parse(method_id: u32, reader: &mut ::evm_coder::abi::AbiReader) -> ::evm_coder::execution::Result<Option<Self>> {738					use ::evm_coder::abi::AbiRead;739					match method_id {740						#(741							#parsers,742						)*743						_ => {},744					}745					#(746						#call_parse747					)else*748					return Ok(None);749				}750			}751			impl #generics ::evm_coder::Callable<#call_name> for #name {752				#[allow(unreachable_code)] // In case of no inner calls753				fn call(&mut self, c: Msg<#call_name>) -> Result<::evm_coder::abi::AbiWriter> {754					use ::evm_coder::abi::AbiWrite;755					type InternalCall = #call_name;756					match c.call {757						#(758							#call_variants,759						)*760						_ => {},761					}762					let mut writer = ::evm_coder::abi::AbiWriter::default();763					match c.call {764						#(765							#call_variants_this,766						)*767						_ => unreachable!()768					}769					Ok(writer)770				}771			}772		}773	}774}