sui coin 的一些概念和实践

jinglin
更新于 11小时前
阅读 62

suicoin的一些概念和实践.1.货币具有如下特征，suicoin实现对应的特征1.1货币的特征发币权限控制发布权限一般来说,我们需要控制货币的发行量,一般限制特定的人或组织才能发型货币.若货币无限制发型,货币就没有价值sui使用Treasury

# sui coin 的一些概念和实践.

# 1. 货币具有如下特征， sui coin 实现对应的特征

## 1.1 货币的特征

*  发币权限

* 控制发布权限
     * 一般来说,我们需要控制货币的发行量, 一般限制特定的人或组织才能发型货币.
       * 若货币无限制发型, 货币就没有价值
   * sui 使用TreasuryCap 对象的所有权来控制货币的发行权
   * 共享发币权限---faucet
     * 这种情况只用作测试 本文不做讨论。

*  货币的总供应量
   * sui 采用 Supply
     * 能增加发行量， 提供新的余额Balance  ， increase_supply
     * 能回收货币余额，减少货币供应  decrease_supply

*  coin货币的余额(balance) , 也就是:面值几块钱
   * 数字货币,余额可以变动
   * 可以3块的货币,拆成 2.5元  和0.5元 两个coin

*  coin 货币有特征, 人民币之所以是人民币,不是美元,是因为人民币有独特的图形 
   * 对应  CoinMetadata

## 1.2 Sui Coin相关对象类型关系图

![image.png](https://img.learnblockchain.cn/attachments/2024/11/yjdzTtN46738bfd37224f.png)
	- create_currency 是货币创建的函数, 返回一个TreasuryCap 对象和一个CoinMetadata对象
	- CoinMetadata 表示货币的小数位,名称,图标.
	- TreasuryCap 持有一个Supply对象,这个Supply是实现货币增长和减少的关键对象.
	- Supply 能提供货币余额 Balance, 同时增加总货币供应量.
	- Coin 表示可以保存在链上的货币
	- Balance 可以转换成Coin 存储到链上,转移给某个用户
	- Coin也可以转换成Balance  余额,Balance没有key能力, 但是具有store能力,可以作为其他对象的字段.
	- Coin 和Balance 可以通过join(两个币合成一个),split( 一个币分成2个)

## 1.3 CoinMetadata ,

可以认为是一种货币的展现形式, 例如没有,就是这个样子的.

通过这个数据结构,告诉我的货币是美元,就能展现成美元的形式.

![image.png](https://img.learnblockchain.cn/attachments/2024/11/rbh1lsTs6738bfea9e938.png)
如果我的货币是人民币,应该展现成这个样子

或者日元:

![image.png](https://img.learnblockchain.cn/attachments/2024/11/Nq1eGwNq6738c01eef263.png)

![img](images/OIP-C.jpeg)

## 1.4 我们定义的货币Coin , 和CoinMetadata 是怎么关联上的呢**?

- 是根据他们的**泛型参数T**  关联的

```cpp
/// A coin of type `T` worth `value`. Transferable and storable
public struct Coin<phantom T> has key, store {
    id: UID,
    balance: Balance<T>,
}

/// Each Coin type T created through `create_currency` function will have a
/// unique instance of CoinMetadata<T> that stores the metadata for this coin type.
public struct CoinMetadata<phantom T> has key, store {
    id: UID,
    /// Number of decimal places the coin uses.
    /// A coin with `value ` N and `decimals` D should be shown as N / 10^D
    /// E.g., a coin with `value` 7002 and decimals 3 should be displayed as 7.002
    /// This is metadata for display usage only.
    decimals: u8,
    /// Name for the token
    name: string::String,
    /// Symbol for the token
    symbol: ascii::String,
    /// Description of the token
    description: string::String,
    /// URL for the token logo
    icon_url: Option<Url>,
}

```

# 2. 货币的诞生：

## 2.1 货币诞生相关函数的启发

参看 0x2:sui::coin 的创建货币的代码,需要一个otw对象.

![image.png](https://img.learnblockchain.cn/attachments/2024/11/aUWMpczS6738c043026dc.png)

货币诞生需要这个泛型参数witness丢想是一个One Time Witness struct 对象

- 这个结构体只能在模块同名大写, 并且由系统控制只构造一次

例如  0x2::sui::SUI
  0X433 :: rmb::RMB

- 不能通过编码构造这个对象

- 避免通过升级package,增加一个函数 来构造otw 对象

这个例子中 witness 对象 只会在是一个OTW 对象,这个对象在模块初始化的时候构建,传入这个函数之后,在这个函数结束后销毁,因为它是移动所有权传递(没有copy ability), 同时具有drop ability.

这个方法执行的结果,会让这个货币相关查到Coin,CoinMetadata ,TreasuryCap  ,Supply,Balance 这一系列对象,都有个类型参数`type-arg`是`witness`参数的类型.

## 2.2  示例:发行一种日元

```ts
module coin_jp::jp{
    public struct JP has drop{ }
    const JpUrl:vector<u8> = b"https://tse4-mm.cn.bing.net/th/id/OIP-C.XVkbV--98d7_YfeLR2a_fAHaHa";

fun init( jp :JP , ctx : &mut TxContext)
    {
        let (treasuryCap,coinMetadata) = sui::coin::create_currency(
                jp, 
                0, 
                b"YEN",
                b"YEN of Japan", 
                b"Japanese money",
                option::some(sui::url::new_unsafe_from_bytes(JpUrl)),
                ctx);

transfer::public_transfer(treasuryCap,ctx.sender());
        transfer::public_freeze_object(coinMetadata);
    }
}
```

- 注意模块名jp和 struct JP 的对应关系,OTW 结构体是模块名的大写. 这个结构体JP ,就是一个OTW 结构体, 
- init函数传入的jp对象,是package在部署的时候自动构造出来的对象.
- 以后无法通过升级package来重新构建一个JP 类型的对象.这就保证了铸币能力 TreasuryCap.total_supply的唯一性.

这个定义,等于设置了一个日元的外观定义(CoinMetadata), 日元的增发权限 TreasuryCap ,   以后发行的日元,余额, 都有特性花纹:

```
coin_jp::jp::JP
```

这个coin_jp是地址,当move package应该在发布的时候,确定其地址取值.

## 2.3  新建货币流程

![image.png](https://img.learnblockchain.cn/attachments/2024/11/DJiTjM8t6738c052b75c1.png)

发布这个合约就是诞生了一种货币,我们其实只是定义了一种铸币权(包括货币增加 减少的能力), 和货币的样式 CoinMetadata, (方便在suiscan上浏览它)

# 3.货币的增发

增加货币（mint）流程

![image.png](https://img.learnblockchain.cn/attachments/2024/11/CWGVOiuX6738c07dc460a.png)
	1. 客户端发起mint_and_transfer 的rpc调用 。 客户端需要拥有访问TreasuryCap对象的权利 （增发货币的权力）
	1. TreasuryCap 调用mint 方法还增加货币
	1. Treasury 调用它的total_supply对象的increase_supply 方法
	1. Supply 在balance 模块，能构建同一模块的Balance对象
	1. Supply获得Balance对象
	1. 返回Balance对象给TreasuryCap对象
	1. TreasuryCap对象，用Balance对象来构造 coin模块中的Coin对象
	1. 返回Coin对象
	1. 通过public_transfer方法，讲Coin存到链上，归属给mint_and_transfer 参数中的地址。#

# 4. 发布合约，增发货币的调用脚本：

## 4.1 发布合约 脚本

```bash
sui client publish --skip-fetch-latest-git-deps --skip-dependency-verification
```

```
查看输出结果中的 0x2::coin::TreasuryCap 对象
 │ ObjectID: 0x8e1bebaac6dd33bf486fb294981f13fb6946051f465db0c25401b61b01f7421e                                     │
│  │ Sender: 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38                                       │
│  │ Owner: Account Address ( 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38 )                    │
│  │ ObjectType: 0x2::coin::TreasuryCap<0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4::jp::JP>   │
│  │ Version: 236167313                                                                                               │
│  │ Digest: BnpekhzZQWQnR77hpGMZyhafRrMe57AyJainuFX8xEjg

```

相关对象标识, 为后续增发提供变量.

| 对象名                        | export name | 对象值                                                       |
| ----------------------------- | ----------- | ------------------------------------------------------------ |
| package地址                   | PKG         | 0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4 |
| 0x2::coin::TreasuryCap 对象id | JP_CAP      | 0x8e1bebaac6dd33bf486fb294981f13fb6946051f465db0c25401b61b01f7421e |

## 4.2 调用合约 增发货币

```bash

# 根据前面的package地址和
export  PKG=0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4
export JP_CAP=0x8e1bebaac6dd33bf486fb294981f13fb6946051f465db0c25401b61b01f7421e

# 获取当前激活的地址
export C_ADDR=`sui client active-address`

# 执行铸币,transfer给本地址
sui client call --package 0x2 --module coin --function mint_and_transfer --type-args $PKG::jp::JP  --args $JP_CAP   8800000   $C_ADDR

```

查看输出结果,有创建的0x2::coin::Coin 对象.0x95245c704b124aa96f49ab1cdd459c7219d1dc1165faaeae80a514524e8308e2

```
 Created Objects:                                                                                                   │
│  ┌──                                                                                                               │
│  │ ObjectID: 0x95245c704b124aa96f49ab1cdd459c7219d1dc1165faaeae80a514524e8308e2                                    │
│  │ Sender: 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38                                      │
│  │ Owner: Account Address ( 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38 )                   │
│  │ ObjectType: 0x2::coin::Coin<0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4::jp::JP>         │
│  │ Version: 236167314                                                                                              │
│  │ Digest: Gh2shitikPnbxxffpPj5mnWwrUCNJChEPyCNaBB2YHMV

```

## 4.3  使用命令查看余额

```
# 查看获得货币
sui client balance $C_ADDR

```

```
ljl@ljl-i5-14400:~/work/sui/move-cn/letsmove/mover/nextuser/code$ sui client balance
[warn] Client/Server api version mismatch, client api version : 1.37.1, server api version : 1.37.2
╭──────────────────────────────────────────────╮
│ Balance of coins owned by this address       │
├──────────────────────────────────────────────┤
│ ╭──────────────────────────────────────────╮ │
│ │ coin          balance (raw)  balance     │ │
│ ├──────────────────────────────────────────┤ │
│ │ Sui           3637300968     3.63 SUI    │ │
│ │ YEN of Japan  8800000        8.80M YEN   │ │
│ ╰──────────────────────────────────────────╯ │
```

## 4.4  sui scan上查看coin对象

https://suiscan.xyz/testnet/object/0x95245c704b124aa96f49ab1cdd459c7219d1dc1165faaeae80a514524e8308e2

![image.png](https://img.learnblockchain.cn/attachments/2024/11/wyA3d7cs6738c096e06f9.png)

1 . 能看到这个泛型的T 参数是模型名jp和结构体名JP的相似性

2. owner是铸币时传递的地址
3. 显示了货币的余额与图标

# 5. 附录:

最近在参加HOH 共学活动,

💧 [HOH水分子公众号](https://mp.weixin.qq.com/s/d0brr-ao6cZ5t8Z5OO1Mog)

🌊 [HOH水分子X账号](https://x.com/0xHOH)

📹 [课程B站账号](https://space.bilibili.com/3493269495352098)

💻 Github仓库 https://github.com/move-cn/letsmove

sui coin 的一些概念和实践.

1. 货币具有如下特征， sui coin 实现对应的特征

1.1 货币的特征

发币权限
- 控制发布权限
  - 一般来说,我们需要控制货币的发行量, 一般限制特定的人或组织才能发型货币.
  - 若货币无限制发型, 货币就没有价值
- sui 使用TreasuryCap 对象的所有权来控制货币的发行权
- 共享发币权限---faucet
  - 这种情况只用作测试本文不做讨论。
货币的总供应量
- sui 采用 Supply
  - 能增加发行量，提供新的余额Balance ， increase_supply
  - 能回收货币余额，减少货币供应 decrease_supply
coin货币的余额(balance) , 也就是:面值几块钱
- 数字货币,余额可以变动
- 可以3块的货币,拆成 2.5元和0.5元两个coin
coin 货币有特征, 人民币之所以是人民币,不是美元,是因为人民币有独特的图形
- 对应 CoinMetadata

1.2 Sui Coin相关对象类型关系图

create_currency 是货币创建的函数, 返回一个TreasuryCap 对象和一个CoinMetadata对象
CoinMetadata 表示货币的小数位,名称,图标.
TreasuryCap 持有一个Supply对象,这个Supply是实现货币增长和减少的关键对象.
Supply 能提供货币余额 Balance, 同时增加总货币供应量.
Coin 表示可以保存在链上的货币
Balance 可以转换成Coin 存储到链上,转移给某个用户
Coin也可以转换成Balance 余额,Balance没有key能力, 但是具有store能力,可以作为其他对象的字段.
Coin 和Balance 可以通过join(两个币合成一个),split( 一个币分成2个)

1.3 CoinMetadata ,

可以认为是一种货币的展现形式, 例如没有,就是这个样子的.

通过这个数据结构,告诉我的货币是美元,就能展现成美元的形式.

如果我的货币是人民币,应该展现成这个样子

或者日元:

1.4 我们定义的货币Coin , 和CoinMetadata 是怎么关联上的呢**?

是根据他们的泛型参数T 关联的

/// A coin of type `T` worth `value`. Transferable and storable
public struct Coin&lt;phantom T> has key, store {
    id: UID,
    balance: Balance&lt;T>,
}

/// Each Coin type T created through `create_currency` function will have a
/// unique instance of CoinMetadata&lt;T> that stores the metadata for this coin type.
public struct CoinMetadata&lt;phantom T> has key, store {
    id: UID,
    /// Number of decimal places the coin uses.
    /// A coin with `value ` N and `decimals` D should be shown as N / 10^D
    /// E.g., a coin with `value` 7002 and decimals 3 should be displayed as 7.002
    /// This is metadata for display usage only.
    decimals: u8,
    /// Name for the token
    name: string::String,
    /// Symbol for the token
    symbol: ascii::String,
    /// Description of the token
    description: string::String,
    /// URL for the token logo
    icon_url: Option&lt;Url>,
}

2. 货币的诞生：

2.1 货币诞生相关函数的启发

参看 0x2:sui::coin 的创建货币的代码,需要一个otw对象.

货币诞生需要这个泛型参数witness丢想是一个One Time Witness struct 对象

这个结构体只能在模块同名大写, 并且由系统控制只构造一次

例如 0x2::sui::SUI 0X433 :: rmb::RMB
不能通过编码构造这个对象
避免通过升级package,增加一个函数来构造otw 对象

这个例子中 witness 对象只会在是一个OTW 对象,这个对象在模块初始化的时候构建,传入这个函数之后,在这个函数结束后销毁,因为它是移动所有权传递(没有copy ability), 同时具有drop ability.

这个方法执行的结果,会让这个货币相关查到Coin,CoinMetadata ,TreasuryCap ,Supply,Balance 这一系列对象,都有个类型参数type-arg是witness参数的类型.

2.2 示例:发行一种日元

module coin_jp::jp{
    public struct JP has drop{ }
    const JpUrl:vector&lt;u8> = b"https://tse4-mm.cn.bing.net/th/id/OIP-C.XVkbV--98d7_YfeLR2a_fAHaHa";

    fun init( jp :JP , ctx : &mut TxContext)
    {
        let (treasuryCap,coinMetadata) = sui::coin::create_currency(
                jp, 
                0, 
                b"YEN",
                b"YEN of Japan", 
                b"Japanese money",
                option::some(sui::url::new_unsafe_from_bytes(JpUrl)),
                ctx);

        transfer::public_transfer(treasuryCap,ctx.sender());
        transfer::public_freeze_object(coinMetadata);
    }
}

注意模块名jp和 struct JP 的对应关系,OTW 结构体是模块名的大写. 这个结构体JP ,就是一个OTW 结构体,
init函数传入的jp对象,是package在部署的时候自动构造出来的对象.
以后无法通过升级package来重新构建一个JP 类型的对象.这就保证了铸币能力 TreasuryCap.total_supply的唯一性.

这个定义,等于设置了一个日元的外观定义(CoinMetadata), 日元的增发权限 TreasuryCap , 以后发行的日元,余额, 都有特性花纹:

coin_jp::jp::JP

这个coin_jp是地址,当move package应该在发布的时候,确定其地址取值.

2.3 新建货币流程

发布这个合约就是诞生了一种货币,我们其实只是定义了一种铸币权(包括货币增加减少的能力), 和货币的样式 CoinMetadata, (方便在suiscan上浏览它)

3.货币的增发

增加货币（mint）流程

客户端发起mint_and_transfer 的rpc调用。客户端需要拥有访问TreasuryCap对象的权利（增发货币的权力）
TreasuryCap 调用mint 方法还增加货币
Treasury 调用它的total_supply对象的increase_supply 方法
Supply 在balance 模块，能构建同一模块的Balance对象
Supply获得Balance对象
返回Balance对象给TreasuryCap对象
TreasuryCap对象，用Balance对象来构造 coin模块中的Coin对象
返回Coin对象
通过public_transfer方法，讲Coin存到链上，归属给mint_and_transfer 参数中的地址。#

4. 发布合约，增发货币的调用脚本：

4.1 发布合约脚本

sui client publish --skip-fetch-latest-git-deps --skip-dependency-verification

查看输出结果中的 0x2::coin::TreasuryCap 对象
 │ ObjectID: 0x8e1bebaac6dd33bf486fb294981f13fb6946051f465db0c25401b61b01f7421e                                     │
│  │ Sender: 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38                                       │
│  │ Owner: Account Address ( 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38 )                    │
│  │ ObjectType: 0x2::coin::TreasuryCap&lt;0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4::jp::JP>   │
│  │ Version: 236167313                                                                                               │
│  │ Digest: BnpekhzZQWQnR77hpGMZyhafRrMe57AyJainuFX8xEjg

相关对象标识, 为后续增发提供变量.

对象名	export name	对象值
package地址	PKG	0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4
0x2::coin::TreasuryCap 对象id	JP_CAP	0x8e1bebaac6dd33bf486fb294981f13fb6946051f465db0c25401b61b01f7421e

4.2 调用合约增发货币


# 根据前面的package地址和
export  PKG=0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4
export JP_CAP=0x8e1bebaac6dd33bf486fb294981f13fb6946051f465db0c25401b61b01f7421e

# 获取当前激活的地址
export C_ADDR=`sui client active-address`

# 执行铸币,transfer给本地址
sui client call --package 0x2 --module coin --function mint_and_transfer --type-args $PKG::jp::JP  --args $JP_CAP   8800000   $C_ADDR

查看输出结果,有创建的0x2::coin::Coin 对象.0x95245c704b124aa96f49ab1cdd459c7219d1dc1165faaeae80a514524e8308e2

 Created Objects:                                                                                                   │
│  ┌──                                                                                                               │
│  │ ObjectID: 0x95245c704b124aa96f49ab1cdd459c7219d1dc1165faaeae80a514524e8308e2                                    │
│  │ Sender: 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38                                      │
│  │ Owner: Account Address ( 0x540105a7d2f5f54a812c630f2996f1790ed0e60d1f9a870ce397f03e4cec9b38 )                   │
│  │ ObjectType: 0x2::coin::Coin&lt;0x65a0995fd59c97b94fd975a3fb42c745cdff54711c1caae2934858e6eb99adb4::jp::JP>         │
│  │ Version: 236167314                                                                                              │
│  │ Digest: Gh2shitikPnbxxffpPj5mnWwrUCNJChEPyCNaBB2YHMV

4.3 使用命令查看余额

# 查看获得货币
sui client balance $C_ADDR

ljl@ljl-i5-14400:~/work/sui/move-cn/letsmove/mover/nextuser/code$ sui client balance
[warn] Client/Server api version mismatch, client api version : 1.37.1, server api version : 1.37.2
╭──────────────────────────────────────────────╮
│ Balance of coins owned by this address       │
├──────────────────────────────────────────────┤
│ ╭──────────────────────────────────────────╮ │
│ │ coin          balance (raw)  balance     │ │
│ ├──────────────────────────────────────────┤ │
│ │ Sui           3637300968     3.63 SUI    │ │
│ │ YEN of Japan  8800000        8.80M YEN   │ │
│ ╰──────────────────────────────────────────╯ │

4.4 sui scan上查看coin对象

https://suiscan.xyz/testnet/object/0x95245c704b124aa96f49ab1cdd459c7219d1dc1165faaeae80a514524e8308e2

1 . 能看到这个泛型的T 参数是模型名jp和结构体名JP的相似性

owner是铸币时传递的地址
显示了货币的余额与图标

5. 附录:

最近在参加HOH 共学活动,

💧 HOH水分子公众号

🌊 HOH水分子X账号

📹 课程B站账号

💻 Github仓库 https://github.com/move-cn/letsmove

原创
学分: 0
分类: Sui
标签: coin Sui Sui Move

本文参与登链社区写作激励计划，好文好收益，欢迎正在阅读的你也加入。

sui coin 的一些概念和实践

sui coin 的一些概念和实践.

1. 货币具有如下特征， sui coin 实现对应的特征

1.1 货币的特征

1.2 Sui Coin相关对象类型关系图

1.3 CoinMetadata ,

1.4 我们定义的货币Coin , 和CoinMetadata 是怎么关联上的呢**?

2. 货币的诞生：

2.1 货币诞生相关函数的启发

2.2 示例:发行一种日元

2.3 新建货币流程

3.货币的增发

4. 发布合约，增发货币的调用脚本：

4.1 发布合约脚本

4.2 调用合约增发货币

4.3 使用命令查看余额

4.4 sui scan上查看coin对象

5. 附录:

0 条评论

文章目录

sui coin 的一些概念和实践

sui coin 的一些概念和实践.

1. 货币具有如下特征， sui coin 实现对应的特征

1.1 货币的特征

1.2 Sui Coin相关对象类型关系图

1.3 CoinMetadata ,

1.4 我们定义的货币Coin , 和CoinMetadata 是怎么关联上的呢**?

2. 货币的诞生：

2.1 货币诞生相关函数的启发

2.2 示例:发行一种日元

2.3 新建货币流程

3.货币的增发

4. 发布合约，增发货币的调用脚本：

4.1 发布合约 脚本

4.2 调用合约 增发货币

4.3 使用命令查看余额

4.4 sui scan上查看coin对象

5. 附录:

0 条评论

文章目录

4.1 发布合约脚本

4.2 调用合约增发货币