Дамл Деривейт

Этот crate предоставляет proc макро для генерации Rust типов из daml.

Этот crate не следует использовать напрямую, вместо этого вы должны зависеть от crate daml и включить функцию derive

[dependencies]
daml = { version = "0.2.2", features = [ "derive" ] }

Лицензия

daml-derive распространяется по условиям Лицензии Apache (Версия 2.0).

Если вы явно не указали иное, любая намеренная вкладка, представленная вам для включения в указанное время, как определено в Лицензии Apache-2.0, должна быть лицензирована дually, как выше, без дополнительных условий или условий.

Подробнее см. в LICENSE.

Авторское право 2022

lib.rs:

Proc макро для генерации Rust типов и преобразований из типов и архивов Daml.

Обзор

Предоставляются два механизма для представления типов Daml в Rust

• Кастомные атрибуты, которые можно применить к структурам Rust, генерирующим конвертеры типов Daml.
• Генератор proc макро кода, который принимает файл dar Daml в качестве ввода и генерирует Rust типы с кастомными атрибутами.

Кастомные атрибуты

Этот раздел объясняет, как использовать предоставленные кастомные атрибуты для аннотирования Rust типов для генерации кода преобразований данных API Daml ledger, необходимого для использования их с Daml ledger.

Маппинг структур Daml к Rust

Структуры Daml моделируются с помощью различных конструкций языка Rust в сочетании с procedural macros кастомных атрибутов, как показано в следующей таблице

将Daml数据类型映射到Rust

以下表格列出了Daml内置原始类型和Rust类型别名之间的映射关系

注意，这里仅为了方便显示具体的Rust类型，在所有情况下，都必须使用Rust类型别名来表示Daml结构，以便确定Daml类型。

泛型类型

泛型类型（List<T>、TextMap<T> 和 Optional<T>）可以自由嵌套到任意深度，并且可以在所有预期类型的上下文中使用，例如模板和数据字段以及选择参数。

let int: DamlInt64;
let party: DamlParty;
let opt_numeric: DamlOptional<DamlNumeric10>;
let list_of_int: DamlList<DamlInt64>;
let list_of_opt_int: DamlList<DamlOptional<DamlInt64>>;
let list_of_opt_map_party: DamlList<DamlOptional<DamlTextMap<DamlParty>>>;
let opt_list_data: DamlOptional<DamlList<MyData>>;

data Foo = Foo
  with
    bar : Optional Text
    foo : Foo

#[DamlData]
pub struct Foo {
    bar: DamlOptional<DamlText>,
    foo: Box<Foo>,
}

mod fuji {
    mod my_module {
        mod my_sub_module {
            use daml::prelude::*;
            #[DamlData]
            pub struct MyData {}
        }
    }
}

template Ping
  with
    sender: Party
    receiver: Party
    count: Int
  where
    signatory sender
    observer receiver

    controller receiver can
      ResetCount : ()
        with
          new_count: Int
        do
          create Pong with sender; receiver; count = new_count
          return ()

use daml::prelude::*;

#[DamlTemplate(package_id = r"...package id hash omitted...", module_name = "Fuji.PingPong")]
pub struct Ping {
    pub sender: DamlParty,
    pub receiver: DamlParty,
    pub count: DamlInt64,
}

#[DamlChoices]
impl Ping {
    #[ResetCount]
    fn reset_count(&self, new_count: DamlInt64) {}
}

let ping = Ping::new("Alice", "Bob", 0);

let create_ping_command = ping.create_command();

let ping_contract: PingContract = created_event.try_into()?;
}

assert_eq!("Alice", ping_contract.data().sender);
assert_eq!("Bob", ping_contract.data().receiver);
assert_eq!(0, ping_contract.data().count);
assert_eq!("#0:0", ping_contract.id().contract_id);

let exercise_command = ping_contract.id().reset_count_command(5);
}