use super::{ definitions::Definitions, error::Error, parameter::Parameter, schema::{Annotated, Schema}, }; use crate::module::{CheckedModule, CheckedModules}; use std::rc::Rc; use aiken_lang::{ ast::{TypedArg, TypedFunction, TypedValidator}, gen_uplc::CodeGenerator, }; use miette::NamedSource; use serde; use uplc::{ ast::{Constant, DeBruijn, Program, Term}, PlutusData, }; #[derive(Debug, PartialEq, Clone, serde::Serialize, serde::Deserialize)] pub struct Validator { pub title: String, #[serde(skip_serializing_if = "Option::is_none")] pub description: Option, #[serde(skip_serializing_if = "Option::is_none")] pub datum: Option, pub redeemer: Parameter, #[serde(skip_serializing_if = "Vec::is_empty")] #[serde(default)] pub parameters: Vec, #[serde(flatten)] pub program: Program, #[serde(skip_serializing_if = "Definitions::is_empty")] #[serde(default)] pub definitions: Definitions>, } impl Validator { pub fn from_checked_module( modules: &CheckedModules, generator: &mut CodeGenerator, module: &CheckedModule, def: &TypedValidator, ) -> Vec> { let program = generator.generate(def).try_into().unwrap(); let is_multi_validator = def.other_fun.is_some(); let mut validators = vec![Validator::create_validator_blueprint( modules, module, &program, &def.params, &def.fun, is_multi_validator, )]; if let Some(ref other_func) = def.other_fun { validators.push(Validator::create_validator_blueprint( modules, module, &program, &def.params, other_func, is_multi_validator, )); } validators } fn create_validator_blueprint( modules: &CheckedModules, module: &CheckedModule, program: &Program, params: &[TypedArg], func: &TypedFunction, is_multi_validator: bool, ) -> Result { let mut args = func.arguments.iter().rev(); let (_, redeemer, datum) = (args.next(), args.next().unwrap(), args.next()); let mut arguments = Vec::with_capacity(params.len() + func.arguments.len()); arguments.extend(params.to_vec()); arguments.extend(func.arguments.clone()); let mut definitions = Definitions::new(); let parameters = params .iter() .map(|param| { Annotated::from_type(modules.into(), ¶m.tipo, &mut definitions) .map(|schema| Parameter { title: Some(param.arg_name.get_label()), schema, }) .map_err(|error| Error::Schema { error, location: param.location, source_code: NamedSource::new( module.input_path.display().to_string(), module.code.clone(), ), }) }) .collect::>()?; Ok(Validator { title: format!("{}.{}", &module.name, &func.name), description: func.doc.clone(), parameters, datum: datum .map(|datum| { Annotated::from_type(modules.into(), &datum.tipo, &mut definitions).map_err( |error| Error::Schema { error, location: datum.location, source_code: NamedSource::new( module.input_path.display().to_string(), module.code.clone(), ), }, ) }) .transpose()? .map(|schema| Parameter { title: datum.map(|datum| datum.arg_name.get_label()), schema, }), redeemer: Annotated::from_type(modules.into(), &redeemer.tipo, &mut definitions) .map_err(|error| Error::Schema { error, location: redeemer.location, source_code: NamedSource::new( module.input_path.display().to_string(), module.code.clone(), ), }) .map(|schema| Parameter { title: Some(redeemer.arg_name.get_label()), schema: match datum { Some(..) if is_multi_validator => Annotated::as_wrapped_redeemer( &mut definitions, schema, redeemer.tipo.clone(), ), _ => schema, }, })?, program: program.clone(), definitions, }) } } impl Validator { pub fn apply( self, definitions: &Definitions>, arg: &Term, ) -> Result { match self.parameters.split_first() { None => Err(Error::NoParametersToApply), Some((head, tail)) => { head.validate(definitions, arg)?; Ok(Self { program: self.program.apply_term(arg), parameters: tail.to_vec(), ..self }) } } } pub fn ask_next_parameter( &self, definitions: &Definitions>, ask: F, ) -> Result, Error> where F: Fn(&Annotated, &Definitions>) -> Result, { match self.parameters.split_first() { None => Err(Error::NoParametersToApply), Some((head, _)) => { let schema = definitions .lookup(&head.schema) .map(|s| { Ok(Annotated { title: s.title.clone().or_else(|| head.title.clone()), description: s.description.clone(), annotated: s.annotated.clone(), }) }) .unwrap_or_else(|| { Err(Error::UnresolvedSchemaReference { reference: head.schema.clone(), }) })?; let data = ask(&schema, definitions)?; Ok(Term::Constant(Rc::new(Constant::Data(data.clone())))) } } } } #[cfg(test)] mod tests { use std::collections::HashMap; use aiken_lang::{self, builtins}; use uplc::ast as uplc_ast; use crate::tests::TestProject; use super::{ super::{ definitions::{Definitions, Reference}, error::Error, schema::{Annotated, Constructor, Data, Declaration, Items, Schema}, }, *, }; macro_rules! assert_validator { ($code:expr) => { let mut project = TestProject::new(); let modules = CheckedModules::singleton(project.check(project.parse(indoc::indoc! { $code }))); let mut generator = modules.new_generator( &project.functions, &project.data_types, &project.module_types, true, ); let (validator, def) = modules .validators() .next() .expect("source code did no yield any validator"); let validators = Validator::from_checked_module(&modules, &mut generator, validator, def); if validators.len() > 1 { panic!("Multi-validator given to test bench. Don't do that.") } let validator = validators .get(0) .unwrap() .as_ref() .expect("Failed to create validator blueprint"); insta::with_settings!({ description => concat!("Code:\n\n", indoc::indoc! { $code }), omit_expression => true }, { insta::assert_json_snapshot!(validator); }); }; } fn fixture_definitions() -> Definitions> { let mut definitions = Definitions::new(); // #/definitions/Int // // { // "dataType": "integer" // } definitions .register::<_, Error>(&builtins::int(), &HashMap::new(), |_| { Ok(Schema::Data(Data::Integer).into()) }) .unwrap(); // #/definitions/ByteArray // // { // "dataType": "bytes" // } definitions .register::<_, Error>(&builtins::byte_array(), &HashMap::new(), |_| { Ok(Schema::Data(Data::Bytes).into()) }) .unwrap(); // #/definitions/Bool // // { // "anyOf": [ // { // "dataType": "constructor", // "index": 0, // "fields": [] // }, // { // "dataType": "constructor", // "index": 1, // "fields": [] // }, // ] // } definitions.insert( &Reference::new("Bool"), Schema::Data(Data::AnyOf(vec![ // False Constructor { index: 0, fields: vec![], } .into(), // True Constructor { index: 1, fields: vec![], } .into(), ])) .into(), ); definitions } #[test] fn mint_basic() { assert_validator!( r#" validator { fn mint(redeemer: Data, ctx: Data) { True } } // "# ); } #[test] fn mint_parameterized() { assert_validator!( r#" validator(utxo_ref: Int) { fn mint(redeemer: Data, ctx: Data) { True } } // "# ); } #[test] fn simplified_hydra() { assert_validator!( r#" /// On-chain state type State { /// The contestation period as a number of seconds contestationPeriod: ContestationPeriod, /// List of public key hashes of all participants parties: List, utxoHash: Hash, } /// A Hash digest for a given algorithm. type Hash = ByteArray type Blake2b_256 { Blake2b_256 } /// Whatever type ContestationPeriod { /// A positive, non-zero number of seconds. ContestationPeriod(Int) } type Party = ByteArray type Input { CollectCom Close /// Abort a transaction Abort } validator { fn simplified_hydra(datum: State, redeemer: Input, ctx: Data) { True } } "# ); } #[test] fn tuples() { assert_validator!( r#" validator { fn tuples(datum: (Int, ByteArray), redeemer: (Int, Int, Int), ctx: Void) { True } } "# ); } #[test] fn generics() { assert_validator!( r#" type Either { Left(left) Right(right) } type Interval { Finite(a) Infinite } validator { fn generics(redeemer: Either>, ctx: Void) { True } } "# ); } #[test] fn list_2_tuples_as_map() { assert_validator!( r#" type Dict { inner: List<(ByteArray, value)> } type UUID { UUID } validator { fn list_2_tuples_as_map(redeemer: Dict, ctx: Void) { True } } "# ); } #[test] fn opaque_singleton_variants() { assert_validator!( r#" pub opaque type Dict { inner: List<(ByteArray, value)> } type UUID { UUID } validator { fn opaque_singleton_variants(redeemer: Dict, ctx: Void) { True } } "# ); } #[test] fn nested_data() { assert_validator!( r#" pub type Foo { foo: Data } validator { fn nested_data(datum: Foo, redeemer: Int, ctx: Void) { True } } "# ); } #[test] fn recursive_types() { assert_validator!( r#" pub type Expr { Val(Int) Sum(Expr, Expr) Mul(Expr, Expr) } validator { fn recursive_types(redeemer: Expr, ctx: Void) { True } } "# ); } #[test] fn recursive_generic_types() { assert_validator!( r#" pub type LinkedList { Cons(a, LinkedList) Nil } pub type Foo { Foo { foo: LinkedList, } Bar { bar: Int, baz: (ByteArray, List>) } } validator { fn recursive_generic_types(datum: Foo, redeemer: LinkedList, ctx: Void) { True } } "# ); } #[test] fn validate_arguments_integer() { let definitions = fixture_definitions(); let term = Term::data(uplc_ast::Data::integer(42.into())); let param = Parameter { title: None, schema: Reference::new("Int"), }; assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_bytestring() { let definitions = fixture_definitions(); let term = Term::data(uplc_ast::Data::bytestring(vec![102, 111, 111])); let param = Parameter { title: None, schema: Reference::new("ByteArray"), }; assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_list_inline() { let schema = Reference::new("List$Int"); // #/definitions/List$Int // // { // "dataType": "list", // "items": { "dataType": "integer" } // } let mut definitions = fixture_definitions(); definitions.insert( &schema, Schema::Data(Data::List(Items::One(Declaration::Inline(Box::new( Data::Integer, ))))) .into(), ); let term = Term::data(uplc_ast::Data::list(vec![ uplc_ast::Data::integer(42.into()), uplc_ast::Data::integer(14.into()), ])); let param: Parameter = schema.into(); assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_list_ref() { let schema = Reference::new("List$ByteArray"); // #/definitions/List$ByteArray // // { // "dataType": "list", // "items": { "$ref": "#/definitions/ByteArray" } // } let mut definitions = fixture_definitions(); definitions.insert( &schema, Schema::Data(Data::List(Items::One(Declaration::Referenced( Reference::new("ByteArray"), )))) .into(), ); let term = Term::data(uplc_ast::Data::list(vec![uplc_ast::Data::bytestring( vec![102, 111, 111], )])); let param: Parameter = schema.into(); assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_tuple() { let schema = Reference::new("Tuple$Int_ByteArray"); // #/definitions/Tuple$Int_ByteArray // // { // "dataType": "list", // "items": [ // { "$ref": "#/definitions/Int" } // { "$ref": "#/definitions/ByteArray" } // ] // } let mut definitions = fixture_definitions(); definitions.insert( &schema, Schema::Data(Data::List(Items::Many(vec![ Declaration::Referenced(Reference::new("Int")), Declaration::Referenced(Reference::new("ByteArray")), ]))) .into(), ); let term = Term::data(uplc_ast::Data::list(vec![ uplc_ast::Data::integer(42.into()), uplc_ast::Data::bytestring(vec![102, 111, 111]), ])); let param: Parameter = schema.into(); assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_dict() { let schema = Reference::new("Dict$ByteArray_Int"); // #/definitions/Dict$Int_ByteArray // // { // "dataType": "map", // "keys": { "dataType": "bytes" }, // "values": { "dataType": "integer" } // } let mut definitions = fixture_definitions(); definitions.insert( &Reference::new("Dict$ByteArray_Int"), Schema::Data(Data::Map( Declaration::Inline(Box::new(Data::Bytes)), Declaration::Inline(Box::new(Data::Integer)), )) .into(), ); let term = Term::data(uplc_ast::Data::map(vec![( uplc_ast::Data::bytestring(vec![102, 111, 111]), uplc_ast::Data::integer(42.into()), )])); let param: Parameter = schema.into(); assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_constr_nullary() { let schema = Reference::new("Bool"); let definitions = fixture_definitions(); let term = Term::data(uplc_ast::Data::constr(1, vec![])); let param: Parameter = schema.into(); assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_constr_n_ary() { let schema = Reference::new("Foo"); // #/definitions/Foo // // { // "anyOf": [ // { // "dataType": "constructor", // "index": 0, // "fields": [{ // "$ref": "#/definitions/Bool // }] // }, // ] // } let mut definitions = fixture_definitions(); definitions.insert( &schema, Schema::Data(Data::AnyOf(vec![Constructor { index: 0, fields: vec![Declaration::Referenced(Reference::new("Bool")).into()], } .into()])) .into(), ); let term = Term::data(uplc_ast::Data::constr( 0, vec![uplc_ast::Data::constr(0, vec![])], )); let param: Parameter = schema.into(); assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } #[test] fn validate_arguments_constr_recursive() { let schema = Reference::new("LinkedList$Int"); // #/definitions/LinkedList$Int // // { // "anyOf": [ // { // "dataType": "constructor", // "index": 0, // "fields": [] // }, // { // "dataType": "constructor", // "index": 1, // "fields": [{ // "$ref": "#/definitions/Int // "$ref": "#/definitions/LinkedList$Int // }] // }, // ] // } let mut definitions = fixture_definitions(); definitions.insert( &schema, Schema::Data(Data::AnyOf(vec![ // Empty Constructor { index: 0, fields: vec![], } .into(), // Node Constructor { index: 1, fields: vec![ Declaration::Referenced(Reference::new("Int")).into(), Declaration::Referenced(Reference::new("LinkedList$Int")).into(), ], } .into(), ])) .into(), ); let term = Term::data(uplc_ast::Data::constr( 1, vec![ uplc_ast::Data::integer(14.into()), uplc_ast::Data::constr( 1, vec![ uplc_ast::Data::integer(42.into()), uplc_ast::Data::constr(0, vec![]), ], ), ], )); let param: Parameter = schema.into(); assert!(matches!(param.validate(&definitions, &term), Ok { .. })) } }