环境配置

进行Move开发必备的安装项包括Git,Sui CLI以及一个IDE，VSCode或者RustRover都可以，其他的工具都比较常见，下面仅展示Sui CLI的安装过程

Sui CLI的安装

Sui CLI可以用于编译、部署和测试Move智能合约，但它不仅仅是Move编译器，它可以管理Move合约的编译、发布、交互等操作，并执行其他与Sui节点交互的命令。这套工具是Sui生态系统中的官方CLI工具，提供了一个集成的开发环境。

Sui CLI可以使用Homebrew或是Chocolatey，本文使用最简单的二进制文件进行安装

Step1 在Github中找到安装包

在sui-cli的github地址中找到对应系统的最新的release版本(文件后缀为.tgz）下载后使用windows系统自带解压的功能，将文件解压到你需要的路径中，解压结束后的文件有以下几个exe程序组成

Step2 添加sui到环境变量

下面是Windows系统和Mac系统的环境变量配置的方式

Windows 系统

1. 打开系统环境变量：
   • 右键点击“此电脑”或“计算机”，选择“属性”。
   • 点击“高级系统设置”，然后点击“环境变量”按钮。
2. 在系统变量中添加sui的安装路径
   • 在“环境变量”窗口中，找到系统变量部分，选择 Path 变量，然后点击“编辑”。
   • 在“编辑环境变量”窗口中，点击“新建”，然后输入 D:\Program Files\sui-cli（你的 Sui CLI 文件夹路径）。
   • 确保路径输入正确，点击“确定”保存设置，直到所有窗口关闭。
3. 在命令行中使用sui --version,以测试是否正确安装

Mac系统

1. 打开配置文件，用文本编辑器打开nano ~/.bashrc
2. 在打开的文本编辑器中输入export PATH="path-to-sui"（你的 Sui CLI 文件夹路径）
3. 保存并退出使用
   1. 按下 Ctrl+O 保存文件，然后按下 Enter 确认文件名。
   2. 按下 Ctrl+X 退出编辑器。
4. 使配置生效，输入source ~/.bashrc
5. 关闭当前终端，打开一个新终端输入sui --version查看配置是否生效

创建第一个Move项目——Hello World！

在需要创立项目的目录下打开cmd命令行，输入sui move new hello_move,这个命令创建一个新的Sui Move项目文件夹，随后在vscode中打开该项目

此时move代码为灰白色，我们需要vscode的拓展中安装move syntax，来获得高亮的、可调试的move代码

在source文件夹下的hello_move.move文件中复制以下的hello word代码

module hello_move::hello {
    use std::ascii::{String, string};
    use sui::object::{Self,UID};
    use sui::transfer::transfer;
    use sui::tx_context::{TxContext, sender};

    public struct Hello has key{
        id:UID,
        say: String
    }

    fun init(ctx: &mut TxContext) {
        let hello_move = Hello {
            id:object::new(ctx),
            say: string(b"move"),
        };
        transfer(hello_move, sender(ctx));
    }
}

这个代码定义了一个简单的模块 hello_move::hello，可以用来初始化一个“Hello”对象，并将其转移给当前交易的发送者

• use std::ascii::{String, string};等行代码是导入必要的库和模块

• 之后，程序定义了一个名为 Hello 的结构体，具有 key 特性。这是一个 Move 中的自定义对象，表示它可以用作链上资源

• init是一个公开函数，用于初始化 Hello 结构体对象并将其转移给交易发送者

  • ctx: &mut TxContext：ctx 是一个可变引用类型的交易上下文，它用于获取创建对象所需的上下文信息

    • TxContext 是一个结构体，它包含了有关交易的上下文信息
    • ctx 是 TxContext 类型的一个变量，表示当前交易的上下文
    • &mut表示一个可变引用（mutable reference）,在sui中&表示一个 不可变引用

  • let hello_move= Hello{}的部分创建了一个新的 Hello 对象

    • 字段 id 通过 object::new(ctx) 函数生成
      • object::new 表示调用 object 模块中的 new 函数。new 函数接收一个 TxContext 参数，根据交易上下文生成一个独特的 ID，确保不同的对象不会拥有相同的 ID。
    • say 字段则通过 string(b"move") 设置成 "move"。

• transfer 函数将 hello_move 对象转移给交易的发送者，sender(ctx) 返回的是交易的发送者地址。

补充知识：TxContext是什么

在 Sui 区块链中，TxContext 是一个重要的结构体，它包含了与当前交易相关的一些关键数据和操作，可以帮助智能合约安全地创建对象、获取交易发送者地址等。

TxContext 可以理解为是交易的“环境记录”，用来存储和追踪有关交易的一些重要信息。在一个智能合约（比如 Move 合约）运行时，TxContext 就像是一个助手，帮我们处理和保存交易过程中所需要的各种数据和上下文。

TxContext通常包括了：

• 谁发起了这笔交易：
  交易的发送者是谁（也就是账户地址）？通过 TxContext，合约可以获取到发起交易的用户地址，这样合约就可以知道该把资产或信息分配给谁。

• 生成独一无二的 ID：
  在区块链上，每一个资产或对象都需要一个独特的“身份证”（ID），以保证它是唯一的。TxContext 提供了生成这些独特 ID 的工具，以确保即使很多用户同时创建同种类型的资产，它们之间也不会混淆。

• 交易的其他信息：
  TxContext 还会包含一些额外的交易信息，比如交易的时间、交易的标识等。这些信息虽然不是直接操作资产时必须的，但在一些复杂的合约逻辑中可能会有帮助，比如记录操作历史等。

部署合约到Sui测试网

接着我们就可以把刚刚编写的合约发布到链上啦

1. 发布上链需要一定的gas，可以通过sui client faucet获取测试用的sui代币
2. 使用sui move build 编译move合约
   • 成功后，console会显示编译成功信息，并返回字节码文件
3. 使用命令sui client publish部署合约
   • 在第一个选项中默认空格则发布到测试网中
   • 第二个选项选择0，使用ed25519密钥对方案
   • 部署成功后，积累下返回的Transaction Hush

在Sui Explorer中查看发布的合约

区块链浏览器可以帮助我们查看链上交易、账户和智能合约的状态。Sui浏览器地址为 https://suivision.xyz/ ,

首页默认显示Sui主网，我们需要切换到刚刚部署的testnet上

通过过浏览器，我们可以查看到刚刚部署的合约啦！

遇到的问题

在部署时遇到了严重的卡顿，使用了以下方式解决

1. 设置代理(以下是cmd命令，powshell则用$env:HTTPS_PROXY = "http://127.0.0.1:7897

   set HTTPS_PROXY=http://127.0.0.1:7897
   set HTTP_PROXY=http://127.0.0.1:7897

2. 把Move.toml中依赖项的下载源从github换成gitee

使用了以上步骤后还是遇到同样的问题，在文件资源管理器中打开了一个新终端执行命令设置代理，并把VPN开至全局模式后成功部署