multiversx_sc_derive/
lib.rs

1// ensure we don't run out of macro stack
2#![recursion_limit = "1024"]
3// TODO: remove once minimum version is 1.87+
4#![allow(unknown_lints)]
5#![allow(clippy::collapsible_if)]
6#![allow(clippy::manual_is_multiple_of)]
7
8#[macro_use]
9extern crate syn;
10
11#[macro_use]
12extern crate quote;
13
14mod contract_impl;
15mod format;
16mod generate;
17mod macro_contract;
18mod macro_module;
19mod macro_proxy;
20mod managed_vec_item_derive;
21mod model;
22mod parse;
23mod preprocessing;
24mod type_abi_derive;
25mod validate;
26
27#[proc_macro_attribute]
28pub fn contract(
29    args: proc_macro::TokenStream,
30    input: proc_macro::TokenStream,
31) -> proc_macro::TokenStream {
32    macro_contract::process_contract(args, input)
33}
34
35#[proc_macro_attribute]
36pub fn module(
37    args: proc_macro::TokenStream,
38    input: proc_macro::TokenStream,
39) -> proc_macro::TokenStream {
40    macro_module::process_module(args, input)
41}
42
43#[proc_macro_attribute]
44pub fn proxy(
45    args: proc_macro::TokenStream,
46    input: proc_macro::TokenStream,
47) -> proc_macro::TokenStream {
48    macro_proxy::process_proxy(args, input)
49}
50
51#[deprecated(
52    since = "0.54.4",
53    note = "Replace with attribute #[type_abi], which should be placed before all derives. More about this: https://docs.multiversx.com/developers/transactions/tx-migration/#replace-derivetypeabi-with-type_abi"
54)]
55#[proc_macro_derive(TypeAbi)]
56pub fn type_abi_derive(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
57    type_abi_derive::type_abi_derive(input).into()
58}
59
60#[proc_macro_attribute]
61pub fn type_abi(
62    args: proc_macro::TokenStream,
63    input: proc_macro::TokenStream,
64) -> proc_macro::TokenStream {
65    assert!(args.is_empty(), "#[type_abi] attribute takes no args");
66    type_abi_derive::type_abi_full(input).into()
67}
68
69#[proc_macro_derive(ManagedVecItem)]
70pub fn managed_vec_item_derive(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
71    let ast = syn::parse(input).unwrap();
72    managed_vec_item_derive::managed_vec_item_derive(&ast)
73}
74
75#[proc_macro]
76pub fn format_receiver_args(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
77    format::format_receiver_args_macro(input.into()).into()
78}
79
80#[proc_macro]
81pub fn semver_tuple(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
82    format::semver_tuple(input.into()).into()
83}
84
85#[proc_macro]
86pub fn const_managed_decimal(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
87    let input = parse_macro_input!(input as syn::LitStr);
88    let (raw_int, decimals) = format::extract_number_type(input);
89
90    let expanded = quote! {
91        multiversx_sc::types::ManagedDecimal::<<Self as ContractBase>::Api, multiversx_sc::types::ConstDecimals<#decimals>>::const_decimals_from_raw(multiversx_sc::types::BigUint::from(#raw_int))
92    };
93
94    proc_macro::TokenStream::from(expanded)
95}
96
97#[proc_macro]
98pub fn managed_decimal(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
99    let input = parse_macro_input!(input as syn::LitStr);
100    let (raw_int, decimals) = format::extract_number_data(input);
101
102    let expanded = quote! {
103        multiversx_sc::types::ManagedDecimal::<<Self as ContractBase>::Api, usize>::from_raw_units(multiversx_sc::types::BigUint::from(#raw_int), #decimals)
104    };
105
106    proc_macro::TokenStream::from(expanded)
107}
108
109#[proc_macro]
110pub fn debug_const_managed_decimal(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
111    let input = parse_macro_input!(input as syn::LitStr);
112    let (raw_int, decimals) = format::extract_number_type(input);
113
114    let expanded = quote! {
115        multiversx_sc::types::ManagedDecimal::<multiversx_sc_scenario::imports::StaticApi, multiversx_sc::types::ConstDecimals<#decimals>>::const_decimals_from_raw(multiversx_sc::types::BigUint::from(#raw_int))
116    };
117
118    proc_macro::TokenStream::from(expanded)
119}
120
121#[proc_macro]
122pub fn debug_managed_decimal(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
123    let input = parse_macro_input!(input as syn::LitStr);
124    let (raw_int, decimals) = format::extract_number_data(input);
125
126    let expanded = quote! {
127        multiversx_sc::types::ManagedDecimal::<multiversx_sc_scenario::imports::StaticApi, usize>::from_raw_units(multiversx_sc::types::BigUint::from(#raw_int), #decimals)
128    };
129
130    proc_macro::TokenStream::from(expanded)
131}