Coin 资源和 create_currency 方法

现在，我们知道了泛型和见证模式是如何工作的，让我们再来看看 Coin 资源和 create_currency 方法。

Coin 资源

现在我们了解了泛型是如何工作的，我们可以重新审视一下 "sui::coin "中的 "Coin "资源。它被定义为以下内容。

#![allow(unused)]
fn main() {
public struct Coin<phantom T> has key, store {
        id: UID,
        balance: Balance<T>
    }
}

Coin资源类型是一个结构，有一个通用类型T和两个字段，id和balance 。id是sui::object::UID类型，我们之前已经看到过了。

balance是sui::balance::Balance类型，并且定义为：

#![allow(unused)]
fn main() {
public struct Balance<phantom T> has store {
    value: u64
}
}

回顾我们关于phantom讨论，T类型在Coin中只作为Balance的另一个phantom类型的参数，而在Balance中，它没有用于任何字段，因此T是一个phantom类型参数。

Coin<T>服务于可转移的资产表示，即一定数量的同质化代币类型T，可以在地址之间转移或被智能合约函数调用消耗。

create_currency 方法

让我们看看 coin::create_currency 在其源代码中实际做了什么：

#![allow(unused)]
fn main() {
    public fun create_currency<T: drop>(
        witness: T,
        decimals: u8,
        symbol: vector<u8>,
        name: vector<u8>,
        description: vector<u8>,
        icon_url: Option<Url>,
        ctx: &mut TxContext
    ): (TreasuryCap<T>, CoinMetadata<T>) {
        // Make sure there's only one instance of the type T
        assert!(sui::types::is_one_time_witness(&witness), EBadWitness);

        // Emit Currency metadata as an event.
        event::emit(CurrencyCreated<T> {
            decimals
        });

        (
            TreasuryCap {
                id: object::new(ctx),
                total_supply: balance::create_supply(witness)
            },
            CoinMetadata {
                id: object::new(ctx),
                decimals,
                name: string::utf8(name),
                symbol: ascii::string(symbol),
                description: string::utf8(description),
                icon_url
            }
        )
    }
}

该语句使用Sui框架中的sui::types::is_one_time_witness 方法检查传入的witness资源是否是一次性见证。

该方法创建并返回两个对象，一个是TreasuryCap资源，另一个是CoinMetadata资源。

TreasuryCap

TreasuryCap是一种资产，通过一次性见证模式保证是一个单体对象：

#![allow(unused)]
fn main() {
    /// Capability allowing the bearer to mint and burn
    /// coins of type `T`. Transferable
public struct TreasuryCap<phantom T> has key, store {
            id: UID,
            total_supply: Supply<T>
        }
}

它包装了一个类型为balance::Supply的singtleton字段total_supply：

#![allow(unused)]
fn main() {
/// A Supply of T. Used for minting and burning.
    /// Wrapped into a `TreasuryCap` in the `Coin` module.
    struct Supply<phantom T> has store {
        value: u64
    }
}

Supple<T>跟踪当前正在流通的T类型的同质化代币的发行总量。你可以看到为什么这个字段必须是一个单体，因为为一个代币类型拥有多个supply实例是没有意义的。

CoinMetadata

这是一个存储已创建的同质化代币的元数据的资源。它包括以下字段。

• decimals: 自定义同质化代币的精度
• name：自定义同质化代币的名称
• symbol：自定义同质化代币的代币符号
• description: 自定义同质化代币的描述
• icon_url: 自定义同质化代币的图标文件的网址

CoinMetadata中包含的信息可以被认为是Sui的基本和轻量级的同质化代币标准，可以被钱包和浏览器用来显示使用sui::coin模块创建同质化代币。