tx3_lang/
analyzing.rs

1//! Semantic analysis of the Tx3 language.
2//!
3//! This module takes an AST and performs semantic analysis on it. It checks for
4//! duplicate definitions, unknown symbols, and other semantic errors.
5
6use std::{collections::HashMap, rc::Rc};
7use thiserror::Error;
8
9use crate::ast::*;
10
11#[derive(Debug, thiserror::Error, miette::Diagnostic)]
12#[error("not in scope: {name}")]
13#[diagnostic(code(tx3::not_in_scope))]
14pub struct NotInScopeError {
15    pub name: String,
16
17    #[source_code]
18    src: Option<String>,
19
20    #[label]
21    span: Span,
22}
23
24#[derive(Debug, thiserror::Error, miette::Diagnostic)]
25#[error("invalid symbol, expected {expected}, got {got}")]
26#[diagnostic(code(tx3::invalid_symbol))]
27pub struct InvalidSymbolError {
28    pub expected: &'static str,
29    pub got: String,
30
31    #[source_code]
32    src: Option<String>,
33
34    #[label]
35    span: Span,
36}
37
38#[derive(Error, Debug, miette::Diagnostic)]
39pub enum Error {
40    #[error("duplicate definition: {0}")]
41    #[diagnostic(code(tx3::duplicate_definition))]
42    DuplicateDefinition(String),
43
44    #[error(transparent)]
45    #[diagnostic(transparent)]
46    NotInScope(#[from] NotInScopeError),
47
48    #[error("needs parent scope")]
49    #[diagnostic(code(tx3::needs_parent_scope))]
50    NeedsParentScope,
51
52    #[error(transparent)]
53    #[diagnostic(transparent)]
54    InvalidSymbol(#[from] InvalidSymbolError),
55}
56
57impl Error {
58    pub fn span(&self) -> &Span {
59        match self {
60            Self::NotInScope(x) => &x.span,
61            Self::InvalidSymbol(x) => &x.span,
62            _ => &Span::DUMMY,
63        }
64    }
65
66    pub fn src(&self) -> Option<&str> {
67        match self {
68            Self::NotInScope(x) => x.src.as_deref(),
69            _ => None,
70        }
71    }
72
73    pub fn not_in_scope(name: String, ast: &impl crate::parsing::AstNode) -> Self {
74        Self::NotInScope(NotInScopeError {
75            name,
76            src: None,
77            span: ast.span().clone(),
78        })
79    }
80
81    pub fn invalid_symbol(
82        expected: &'static str,
83        got: &Symbol,
84        ast: &impl crate::parsing::AstNode,
85    ) -> Self {
86        Self::InvalidSymbol(InvalidSymbolError {
87            expected,
88            got: format!("{:?}", got),
89            src: None,
90            span: ast.span().clone(),
91        })
92    }
93}
94
95#[derive(Debug, Default)]
96pub struct AnalyzeReport {
97    pub errors: Vec<Error>,
98}
99
100impl AnalyzeReport {
101    pub fn is_empty(&self) -> bool {
102        self.errors.is_empty()
103    }
104
105    pub fn ok(self) -> Result<(), Self> {
106        if self.is_empty() {
107            Ok(())
108        } else {
109            Err(self)
110        }
111    }
112}
113
114impl std::error::Error for AnalyzeReport {}
115
116impl std::fmt::Display for AnalyzeReport {
117    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
118        write!(f, "AnalyzeReport {{ errors: {:?} }}", self.errors)
119    }
120}
121
122impl std::ops::Add for Error {
123    type Output = AnalyzeReport;
124
125    fn add(self, other: Self) -> Self::Output {
126        Self::Output {
127            errors: vec![self, other],
128        }
129    }
130}
131
132impl From<Error> for AnalyzeReport {
133    fn from(error: Error) -> Self {
134        Self {
135            errors: vec![error],
136        }
137    }
138}
139
140impl From<Vec<Error>> for AnalyzeReport {
141    fn from(errors: Vec<Error>) -> Self {
142        Self { errors }
143    }
144}
145
146impl std::ops::Add for AnalyzeReport {
147    type Output = AnalyzeReport;
148
149    fn add(self, other: Self) -> Self::Output {
150        [self, other].into_iter().collect()
151    }
152}
153
154impl FromIterator<Error> for AnalyzeReport {
155    fn from_iter<T: IntoIterator<Item = Error>>(iter: T) -> Self {
156        Self {
157            errors: iter.into_iter().collect(),
158        }
159    }
160}
161
162impl FromIterator<AnalyzeReport> for AnalyzeReport {
163    fn from_iter<T: IntoIterator<Item = AnalyzeReport>>(iter: T) -> Self {
164        Self {
165            errors: iter.into_iter().flat_map(|r| r.errors).collect(),
166        }
167    }
168}
169
170macro_rules! bail_report {
171    ($($args:expr),*) => {
172        { return AnalyzeReport::from(vec![$($args),*]); }
173    };
174}
175
176impl Scope {
177    pub fn new(parent: Option<Rc<Scope>>) -> Self {
178        Self {
179            symbols: HashMap::new(),
180            parent,
181        }
182    }
183
184    pub fn track_type_def(&mut self, type_: &TypeDef) {
185        self.symbols
186            .insert(type_.name.clone(), Symbol::TypeDef(Box::new(type_.clone())));
187    }
188
189    pub fn track_variant_case(&mut self, case: &VariantCase) {
190        self.symbols.insert(
191            case.name.clone(),
192            Symbol::VariantCase(Box::new(case.clone())),
193        );
194    }
195
196    pub fn track_record_field(&mut self, field: &RecordField) {
197        self.symbols.insert(
198            field.name.clone(),
199            Symbol::RecordField(Box::new(field.clone())),
200        );
201    }
202
203    pub fn track_party_def(&mut self, party: &PartyDef) {
204        self.symbols.insert(
205            party.name.clone(),
206            Symbol::PartyDef(Box::new(party.clone())),
207        );
208    }
209
210    pub fn track_policy_def(&mut self, policy: &PolicyDef) {
211        self.symbols.insert(
212            policy.name.clone(),
213            Symbol::PolicyDef(Box::new(policy.clone())),
214        );
215    }
216
217    pub fn track_asset_def(&mut self, asset: &AssetDef) {
218        self.symbols.insert(
219            asset.name.clone(),
220            Symbol::AssetDef(Box::new(asset.clone())),
221        );
222    }
223
224    pub fn track_param_var(&mut self, param: &str, ty: Type) {
225        self.symbols.insert(
226            param.to_string(),
227            Symbol::ParamVar(param.to_string(), Box::new(ty)),
228        );
229    }
230
231    pub fn track_input(&mut self, name: &str, ty: Type) {
232        self.symbols.insert(
233            name.to_string(),
234            Symbol::Input(name.to_string(), Box::new(ty)),
235        );
236    }
237
238    pub fn track_record_fields_for_type(&mut self, r#type: &Type) {
239        let schema = resolve_type_schema(r#type);
240
241        for (name, r#type) in schema {
242            self.track_record_field(&RecordField {
243                name,
244                r#type,
245                span: Span::DUMMY,
246            });
247        }
248    }
249
250    pub fn resolve(&self, name: &str) -> Option<Symbol> {
251        if let Some(symbol) = self.symbols.get(name) {
252            Some(symbol.clone())
253        } else if let Some(parent) = &self.parent {
254            parent.resolve(name)
255        } else {
256            None
257        }
258    }
259}
260
261fn resolve_type_schema(ty: &Type) -> Vec<(String, Type)> {
262    match ty {
263        Type::AnyAsset => {
264            vec![
265                ("amount".to_string(), Type::Int),
266                ("policy".to_string(), Type::Bytes),
267                ("asset_name".to_string(), Type::Bytes),
268            ]
269        }
270        Type::UtxoRef => {
271            vec![
272                ("tx_hash".to_string(), Type::Bytes),
273                ("output_index".to_string(), Type::Int),
274            ]
275        }
276        Type::Custom(identifier) => {
277            let def = identifier.symbol.as_ref().and_then(|s| s.as_type_def());
278
279            match def {
280                Some(ty) if ty.cases.len() == 1 => ty.cases[0]
281                    .fields
282                    .iter()
283                    .map(|f| (f.name.clone(), f.r#type.clone()))
284                    .collect(),
285                _ => vec![],
286            }
287        }
288        _ => vec![],
289    }
290}
291
292/// A trait for types that can be semantically analyzed.
293///
294/// Types implementing this trait can validate their semantic correctness and
295/// resolve symbol references within a given scope.
296pub trait Analyzable {
297    /// Performs semantic analysis on the type.
298    ///
299    /// # Arguments
300    /// * `parent` - Optional parent scope containing symbol definitions
301    ///
302    /// # Returns
303    /// * `AnalyzeReport` of the analysis. Empty if no errors are found.
304    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport;
305
306    /// Returns true if all of the symbols have been resolved .
307    fn is_resolved(&self) -> bool;
308}
309
310impl<T: Analyzable> Analyzable for Option<T> {
311    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
312        if let Some(item) = self {
313            item.analyze(parent)
314        } else {
315            AnalyzeReport::default()
316        }
317    }
318
319    fn is_resolved(&self) -> bool {
320        self.as_ref().map_or(true, |x| x.is_resolved())
321    }
322}
323
324impl<T: Analyzable> Analyzable for Box<T> {
325    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
326        self.as_mut().analyze(parent)
327    }
328
329    fn is_resolved(&self) -> bool {
330        self.as_ref().is_resolved()
331    }
332}
333
334impl<T: Analyzable> Analyzable for Vec<T> {
335    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
336        self.iter_mut()
337            .map(|item| item.analyze(parent.clone()))
338            .collect()
339    }
340
341    fn is_resolved(&self) -> bool {
342        self.iter().all(|x| x.is_resolved())
343    }
344}
345
346impl Analyzable for PolicyField {
347    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
348        match self {
349            PolicyField::Hash(x) => x.analyze(parent),
350            PolicyField::Script(x) => x.analyze(parent),
351            PolicyField::Ref(x) => x.analyze(parent),
352        }
353    }
354
355    fn is_resolved(&self) -> bool {
356        match self {
357            PolicyField::Hash(x) => x.is_resolved(),
358            PolicyField::Script(x) => x.is_resolved(),
359            PolicyField::Ref(x) => x.is_resolved(),
360        }
361    }
362}
363impl Analyzable for PolicyConstructor {
364    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
365        self.fields.analyze(parent)
366    }
367
368    fn is_resolved(&self) -> bool {
369        self.fields.is_resolved()
370    }
371}
372
373impl Analyzable for PolicyDef {
374    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
375        match &mut self.value {
376            PolicyValue::Constructor(x) => x.analyze(parent),
377            PolicyValue::Assign(_) => AnalyzeReport::default(),
378        }
379    }
380
381    fn is_resolved(&self) -> bool {
382        match &self.value {
383            PolicyValue::Constructor(x) => x.is_resolved(),
384            PolicyValue::Assign(_) => true,
385        }
386    }
387}
388
389impl Analyzable for DataBinaryOp {
390    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
391        let left = self.left.analyze(parent.clone());
392        let right = self.right.analyze(parent.clone());
393
394        left + right
395    }
396
397    fn is_resolved(&self) -> bool {
398        self.left.is_resolved() && self.right.is_resolved()
399    }
400}
401
402impl Analyzable for RecordConstructorField {
403    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
404        let name = self.name.analyze(parent.clone());
405        let value = self.value.analyze(parent.clone());
406
407        name + value
408    }
409
410    fn is_resolved(&self) -> bool {
411        self.name.is_resolved() && self.value.is_resolved()
412    }
413}
414
415impl Analyzable for VariantCaseConstructor {
416    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
417        let name = self.name.analyze(parent.clone());
418
419        let mut scope = Scope::new(parent);
420
421        let case = match &self.name.symbol {
422            Some(Symbol::VariantCase(x)) => x,
423            Some(x) => bail_report!(Error::invalid_symbol("VariantCase", x, &self.name)),
424            None => bail_report!(Error::not_in_scope(self.name.value.clone(), &self.name)),
425        };
426
427        for field in case.fields.iter() {
428            scope.track_record_field(field);
429        }
430
431        self.scope = Some(Rc::new(scope));
432
433        let fields = self.fields.analyze(self.scope.clone());
434
435        let spread = self.spread.analyze(self.scope.clone());
436
437        name + fields + spread
438    }
439
440    fn is_resolved(&self) -> bool {
441        self.name.is_resolved() && self.fields.is_resolved() && self.spread.is_resolved()
442    }
443}
444
445impl Analyzable for DatumConstructor {
446    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
447        let r#type = self.r#type.analyze(parent.clone());
448
449        let mut scope = Scope::new(parent);
450
451        let type_def = match &self.r#type.symbol {
452            Some(Symbol::TypeDef(x)) => x,
453            Some(x) => bail_report!(Error::invalid_symbol("TypeDef", x, &self.r#type)),
454            _ => unreachable!(),
455        };
456
457        for case in type_def.cases.iter() {
458            scope.track_variant_case(case);
459        }
460
461        self.scope = Some(Rc::new(scope));
462
463        let case = self.case.analyze(self.scope.clone());
464
465        r#type + case
466    }
467
468    fn is_resolved(&self) -> bool {
469        self.r#type.is_resolved() && self.case.is_resolved()
470    }
471}
472
473impl Analyzable for DataExpr {
474    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
475        match self {
476            DataExpr::Constructor(x) => x.analyze(parent),
477            DataExpr::Identifier(x) => x.analyze(parent),
478            DataExpr::PropertyAccess(x) => x.analyze(parent),
479            DataExpr::BinaryOp(x) => x.analyze(parent),
480            _ => AnalyzeReport::default(),
481        }
482    }
483
484    fn is_resolved(&self) -> bool {
485        match self {
486            DataExpr::Constructor(x) => x.is_resolved(),
487            DataExpr::Identifier(x) => x.is_resolved(),
488            DataExpr::PropertyAccess(x) => x.is_resolved(),
489            DataExpr::BinaryOp(x) => x.is_resolved(),
490            _ => true,
491        }
492    }
493}
494
495impl Analyzable for AssetBinaryOp {
496    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
497        let left = self.left.analyze(parent.clone());
498        let right = self.right.analyze(parent.clone());
499
500        left + right
501    }
502
503    fn is_resolved(&self) -> bool {
504        self.left.is_resolved() && self.right.is_resolved()
505    }
506}
507
508impl Analyzable for StaticAssetConstructor {
509    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
510        let amount = self.amount.analyze(parent.clone());
511        let r#type = self.r#type.analyze(parent.clone());
512
513        amount + r#type
514    }
515
516    fn is_resolved(&self) -> bool {
517        self.amount.is_resolved() && self.r#type.is_resolved()
518    }
519}
520
521impl Analyzable for AnyAssetConstructor {
522    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
523        let policy = self.policy.analyze(parent.clone());
524        let asset_name = self.asset_name.analyze(parent.clone());
525        let amount = self.amount.analyze(parent.clone());
526
527        policy + asset_name + amount
528    }
529
530    fn is_resolved(&self) -> bool {
531        self.policy.is_resolved() && self.asset_name.is_resolved() && self.amount.is_resolved()
532    }
533}
534
535impl Analyzable for PropertyAccess {
536    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
537        let object = self.object.analyze(parent.clone());
538
539        let mut scope = Scope::new(parent);
540
541        if let Some(ty) = self.object.symbol.as_ref().and_then(|s| s.target_type()) {
542            scope.track_record_fields_for_type(&ty);
543        }
544
545        self.scope = Some(Rc::new(scope));
546
547        let path = self.path.analyze(self.scope.clone());
548
549        object + path
550    }
551
552    fn is_resolved(&self) -> bool {
553        self.object.is_resolved() && self.path.is_resolved()
554    }
555}
556
557impl Analyzable for AssetExpr {
558    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
559        match self {
560            AssetExpr::Identifier(x) => x.analyze(parent),
561            AssetExpr::StaticConstructor(x) => x.analyze(parent),
562            AssetExpr::AnyConstructor(x) => x.analyze(parent),
563            AssetExpr::BinaryOp(x) => x.analyze(parent),
564            AssetExpr::PropertyAccess(x) => x.analyze(parent),
565        }
566    }
567
568    fn is_resolved(&self) -> bool {
569        match self {
570            AssetExpr::Identifier(x) => x.is_resolved(),
571            AssetExpr::StaticConstructor(x) => x.is_resolved(),
572            AssetExpr::AnyConstructor(x) => x.is_resolved(),
573            AssetExpr::BinaryOp(x) => x.is_resolved(),
574            AssetExpr::PropertyAccess(x) => x.is_resolved(),
575        }
576    }
577}
578
579impl Analyzable for AddressExpr {
580    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
581        match self {
582            AddressExpr::Identifier(x) => x.analyze(parent),
583            _ => AnalyzeReport::default(),
584        }
585    }
586
587    fn is_resolved(&self) -> bool {
588        match self {
589            AddressExpr::Identifier(x) => x.is_resolved(),
590            _ => true,
591        }
592    }
593}
594impl Analyzable for Identifier {
595    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
596        let symbol = parent.and_then(|p| p.resolve(&self.value));
597
598        if symbol.is_none() {
599            bail_report!(Error::not_in_scope(self.value.clone(), self));
600        }
601
602        self.symbol = symbol;
603
604        AnalyzeReport::default()
605    }
606
607    fn is_resolved(&self) -> bool {
608        self.symbol.is_some()
609    }
610}
611
612impl Analyzable for Type {
613    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
614        match self {
615            Type::Custom(x) => x.analyze(parent),
616            _ => AnalyzeReport::default(),
617        }
618    }
619
620    fn is_resolved(&self) -> bool {
621        match self {
622            Type::Custom(x) => x.is_resolved(),
623            _ => true,
624        }
625    }
626}
627
628impl Analyzable for InputBlockField {
629    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
630        match self {
631            InputBlockField::From(x) => x.analyze(parent),
632            InputBlockField::DatumIs(x) => x.analyze(parent),
633            InputBlockField::MinAmount(x) => x.analyze(parent),
634            InputBlockField::Redeemer(x) => x.analyze(parent),
635            InputBlockField::Ref(x) => x.analyze(parent),
636        }
637    }
638
639    fn is_resolved(&self) -> bool {
640        match self {
641            InputBlockField::From(x) => x.is_resolved(),
642            InputBlockField::DatumIs(x) => x.is_resolved(),
643            InputBlockField::MinAmount(x) => x.is_resolved(),
644            InputBlockField::Redeemer(x) => x.is_resolved(),
645            InputBlockField::Ref(x) => x.is_resolved(),
646        }
647    }
648}
649
650impl Analyzable for InputBlock {
651    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
652        self.fields.analyze(parent)
653    }
654
655    fn is_resolved(&self) -> bool {
656        self.fields.is_resolved()
657    }
658}
659
660impl Analyzable for OutputBlockField {
661    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
662        match self {
663            OutputBlockField::To(x) => x.analyze(parent),
664            OutputBlockField::Amount(x) => x.analyze(parent),
665            OutputBlockField::Datum(x) => x.analyze(parent),
666        }
667    }
668
669    fn is_resolved(&self) -> bool {
670        match self {
671            OutputBlockField::To(x) => x.is_resolved(),
672            OutputBlockField::Amount(x) => x.is_resolved(),
673            OutputBlockField::Datum(x) => x.is_resolved(),
674        }
675    }
676}
677
678impl Analyzable for OutputBlock {
679    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
680        self.fields.analyze(parent)
681    }
682
683    fn is_resolved(&self) -> bool {
684        self.fields.is_resolved()
685    }
686}
687
688impl Analyzable for RecordField {
689    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
690        self.r#type.analyze(parent)
691    }
692
693    fn is_resolved(&self) -> bool {
694        self.r#type.is_resolved()
695    }
696}
697
698impl Analyzable for VariantCase {
699    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
700        self.fields.analyze(parent)
701    }
702
703    fn is_resolved(&self) -> bool {
704        self.fields.is_resolved()
705    }
706}
707
708impl Analyzable for TypeDef {
709    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
710        self.cases.analyze(parent)
711    }
712
713    fn is_resolved(&self) -> bool {
714        self.cases.is_resolved()
715    }
716}
717
718impl Analyzable for MintBlockField {
719    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
720        match self {
721            MintBlockField::Amount(x) => x.analyze(parent),
722            MintBlockField::Redeemer(x) => x.analyze(parent),
723        }
724    }
725
726    fn is_resolved(&self) -> bool {
727        match self {
728            MintBlockField::Amount(x) => x.is_resolved(),
729            MintBlockField::Redeemer(x) => x.is_resolved(),
730        }
731    }
732}
733
734impl Analyzable for MintBlock {
735    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
736        self.fields.analyze(parent)
737    }
738
739    fn is_resolved(&self) -> bool {
740        self.fields.is_resolved()
741    }
742}
743
744impl Analyzable for ChainSpecificBlock {
745    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
746        match self {
747            ChainSpecificBlock::Cardano(x) => x.analyze(parent),
748        }
749    }
750
751    fn is_resolved(&self) -> bool {
752        match self {
753            ChainSpecificBlock::Cardano(x) => x.is_resolved(),
754        }
755    }
756}
757
758impl Analyzable for TxDef {
759    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
760        // analyze static types before anything else
761
762        let params = self
763            .parameters
764            .parameters
765            .iter_mut()
766            .map(|param| param.r#type.analyze(parent.clone()))
767            .collect::<AnalyzeReport>();
768
769        let input_types = self
770            .inputs
771            .iter_mut()
772            .flat_map(|input| input.fields.iter_mut())
773            .map(|field| match field {
774                InputBlockField::DatumIs(x) => x.analyze(parent.clone()),
775                _ => AnalyzeReport::default(),
776            })
777            .collect::<AnalyzeReport>();
778
779        // create the new scope and populate its symbols
780
781        let mut scope = Scope::new(parent.clone());
782
783        scope.symbols.insert("fees".to_string(), Symbol::Fees);
784
785        for param in self.parameters.parameters.iter() {
786            scope.track_param_var(&param.name, param.r#type.clone());
787        }
788
789        for input in self.inputs.iter() {
790            scope.track_input(
791                &input.name,
792                input.datum_is().cloned().unwrap_or(Type::Undefined),
793            );
794        }
795
796        // enter the new scope and analyze the rest of the program
797
798        self.scope = Some(Rc::new(scope));
799
800        let inputs = self.inputs.analyze(self.scope.clone());
801
802        let outputs = self.outputs.analyze(self.scope.clone());
803
804        let mint = self.mint.analyze(self.scope.clone());
805
806        let adhoc = self.adhoc.analyze(self.scope.clone());
807
808        params + input_types + inputs + outputs + mint + adhoc
809    }
810
811    fn is_resolved(&self) -> bool {
812        self.inputs.is_resolved()
813            && self.outputs.is_resolved()
814            && self.mint.is_resolved()
815            && self.adhoc.is_resolved()
816    }
817}
818
819static ADA: std::sync::LazyLock<AssetDef> = std::sync::LazyLock::new(|| AssetDef {
820    name: "Ada".to_string(),
821    policy: None,
822    asset_name: None,
823    span: Span::DUMMY,
824});
825
826impl Analyzable for Program {
827    fn analyze(&mut self, parent: Option<Rc<Scope>>) -> AnalyzeReport {
828        let mut scope = Scope::new(parent);
829
830        for party in self.parties.iter() {
831            scope.track_party_def(party);
832        }
833
834        for policy in self.policies.iter() {
835            scope.track_policy_def(policy);
836        }
837
838        scope.track_asset_def(&ADA);
839
840        for asset in self.assets.iter() {
841            scope.track_asset_def(asset);
842        }
843
844        for type_def in self.types.iter() {
845            scope.track_type_def(type_def);
846        }
847
848        self.scope = Some(Rc::new(scope));
849
850        // TODO: Add parties
851        // let parties = self.parties.analyze(self.scope.clone());
852
853        let policies = self.policies.analyze(self.scope.clone());
854
855        // TODO: Add assets
856        // let assets = self.assets.analyze(self.scope.clone());
857
858        let types = self.types.analyze(self.scope.clone());
859
860        let txs = self.txs.analyze(self.scope.clone());
861
862        policies + types + txs
863    }
864
865    fn is_resolved(&self) -> bool {
866        self.policies.is_resolved() && self.types.is_resolved() && self.txs.is_resolved()
867    }
868}
869
870/// Performs semantic analysis on a Tx3 program AST.
871///
872/// This function validates the entire program structure, checking for:
873/// - Duplicate definitions
874/// - Unknown symbol references
875/// - Type correctness
876/// - Other semantic constraints
877///
878/// # Arguments
879/// * `ast` - Mutable reference to the program AST to analyze
880///
881/// # Returns
882/// * `AnalyzeReport` of the analysis. Empty if no errors are found.
883pub fn analyze(ast: &mut Program) -> AnalyzeReport {
884    ast.analyze(None)
885}
tx3_lang/analyzing.rs

tx3_lang/
analyzing.rs
