token

Token1 合约

Token1 是一个基于 WASM 的简单代币合约实现，采用多 Object 存储方式，每个用户拥有独立的余额 Object。

实现特点

1. 多 Object 存储

   • 每个用户拥有独立的余额 Object
   • 默认 Object 存储代币基本信息
   • 用户余额存储在各自的 Object 中

2. 状态存储结构

   • 基本信息存储在默认 Object 中
   • 每个用户有独立的余额 Object
   • 使用 Object 的原生 owner 管理所有权

3. 安全性

   • 依赖 Object 的原生 owner 机制
   • 用户只能操作自己的余额 Object
   • 严格的权限控制（mint/burn 仅限所有者）

主要功能

1. 初始化合约

func InitializeToken(ctx core.Context, name string, symbol string, decimals uint8, totalSupply uint64) core.ObjectID

• 初始化代币基本信息
• 创建所有者的余额 Object
• 分配初始供应量给创建者

2. 查询功能

func GetTokenInfo(ctx core.Context) (string, string, uint8, uint64)
func GetOwner(ctx core.Context) core.Address
func BalanceOf(ctx core.Context, owner core.Address) uint64

• 获取代币基本信息
• 查询合约所有者
• 查询账户余额

3. 转账功能

func Transfer(ctx core.Context, to core.Address, amount uint64) bool

• 创建接收者的余额 Object（如果不存在）
• 在发送者和接收者的 Object 中更新余额
• 包含余额检查和错误处理

4. 铸造功能

func Mint(ctx core.Context, to core.Address, amount uint64) bool

• 仅限合约所有者调用
• 增加总供应量
• 铸造新代币给指定地址

5. 销毁功能

func Burn(ctx core.Context, amount uint64) bool

• 仅限合约所有者调用
• 减少总供应量
• 从所有者账户销毁代币

与 Token2 的主要区别

1. 存储方式

   • Token1: 使用多个 Object 存储状态
   • Token2: 使用单一 Object 存储所有状态

2. 所有权管理

   • Token1: 依赖 Object 的原生 owner
   • Token2: 使用自定义 owner 字段

3. 性能特点

   • Token1: 支持并行转账（不同用户的转账可以并行执行）
   • Token2: 所有操作都需要串行执行（因为共享同一个 Object）

4. 功能限制

   • Token1: 无法实现 approve 功能（因为用户无法操作他人的 Object）
   • Token2: 可以实现 approve 功能（因为所有状态在同一个 Object 中）

5. 状态访问

   • Token1: 需要获取多个 Object
   • Token2: 只需访问单一 Object

使用示例

// 初始化代币
InitializeToken(ctx, "MyToken", "MTK", 18, 1000000)

// 查询代币信息
name, symbol, decimals, totalSupply := GetTokenInfo(ctx)

// 查询余额
balance := BalanceOf(ctx, userAddress)

// 转账
Transfer(ctx, recipientAddress, 100)

// 铸造新代币（仅限所有者）
Mint(ctx, recipientAddress, 1000)

// 销毁代币（仅限所有者）
Burn(ctx, 500)

注意事项

1. 合约所有者通过 Object 的原生 owner 管理
2. 接收代币时会自动创建新的余额 Object
3. 所有操作都包含适当的错误处理和状态回滚机制
4. 合约事件记录所有重要操作
5. 不同用户的转账可以并行执行，提高性能
6. 由于 Object 权限限制，无法实现 approve 功能