小试牛刀-Anchor安装和基础测试

news2024/11/20 17:25:17

一、编写目的

二、安装步骤

2.1 安装Rust

设置rustup镜像

安装Rust

2.2 安装node.js

2.3 安装Solana-CLI

2.4 安装Anchor CLI

三、Program测试

四、可能出现的问题

Welcome to Code Block's blog

本篇文章主要介绍了

[Anchor安装和基础测试]
博主广交技术好友，喜欢的可以关注一下

一、编写目的

Anchor是一个SOL链的开发框架,可以很方便的完成链上程序(Program)的编写,并且可以进行快速的前端测试。但安装时需要很多步骤,并且在测试时也有些错误需要注意。在这里对步骤和相关版本进行记录,作为记录和过程分享。

二、安装步骤

测试使用版本
RustUp	1.27.1
Node.js	v18.20.4
solana-cli	2.0.16
anchor-cli	0.30.1

2.1 安装Rust

编写Program链上程序需要使用rust语言,所以需要先进行Rust语言环境安装,使用以下命令完成安装:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

这里的安装速度可能会很慢,所以可以使用国内的镜像库:

设置rustup镜像

# 临时替换
export RUSTUP_UPDATE_ROOT=https://mirrors.aliyun.com/rustup/rustup
export RUSTUP_DIST_SERVER=https://mirrors.aliyun.com/rustup

# 永久替换

# bash用户
echo 'export RUSTUP_UPDATE_ROOT=https://mirrors.aliyun.com/rustup/rustup' >> ~/.bash_profile
echo 'export RUSTUP_DIST_SERVER=https://mirrors.aliyun.com/rustup' >> ~/.bash_profile
source ~/.bash_profile

# zsh用户
echo 'export RUSTUP_UPDATE_ROOT=https://mirrors.aliyun.com/rustup/rustup' >> ~/.zshrc
echo 'export RUSTUP_DIST_SERVER=https://mirrors.aliyun.com/rustup' >> ~/.zshrc
source ~/.zshrc

安装Rust

# 使用阿里云安装脚本
curl --proto '=https' --tlsv1.2 -sSf https://mirrors.aliyun.com/repo/rust/rustup-init.sh | sh

页面出现

Rust is installed now. Great!

表示安装成功!

2.2 安装node.js

安装node.js是为了使用其中的yarn命令,这里可以在Node.js — Run JavaScript Everywhere
官网进行下载压缩包,解压后通过软链接的方式使node命令生效.

2.3 安装Solana-CLI

安装solana的客户端程序,以完成solana相关命令的使用.使用以下命令进行安装:

sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

安装完成后会输出以下内容(这里的export命令可能会不同):

Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:
 
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

运行export命令即可完成安装.

打印版本号:

solana --version

输出:

solana-cli 1.18.22 (src:9efdd74b; feat:4215500110, client:Agave)

2.4 安装Anchor CLI

Anchor使用AVM管理工具进行管理,所以先使用以下命令进行AVM安装:

cargo install --git https://github.com/coral-xyz/anchor avm --force

安装完成后同样使用avm --version命令进行测试输出版本.

使用以下命令安装和使用anchor的最新版本:

avm install latest
avm use latest

安装完成后使用 anchor --version命令进行版本打印以进行打印版本测试.

三、Program测试

使用以下命令创建一个测试项目

anchor init test-program

创建完成后,创建一个新的项目文件夹,使用vscode打开该文件夹,文件的目录如下:

这里的programs/test-program/src/libs.rs为要编写program合约代码,初始化内容如下:

use anchor_lang::prelude::*;
#定义program地址,部署的地址
declare_id!("EFEJVy8RKikt28Xf7APGsrJLvkeKuBMGQ9yY3iTNCSFG");
#标记为program程序入口
#[program]
pub mod test_program {
    use super::*;

    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        msg!("Greetings from: {:?}", ctx.program_id);
        Ok(())
    }
}
#标记为传递的Accounts结构体
#[derive(Accounts)]
pub struct Initialize {}

这里功能为调用initialize方法,并输出当前program_id.即:

EFEJVy8RKikt28Xf7APGsrJLvkeKuBMGQ9yY3iTNCSFG

tests/test-program.ts文件夹内为测试文件,内容如下:

import * as anchor from "@coral-xyz/anchor";
import { Program } from "@coral-xyz/anchor";
import { TestProgram } from "../target/types/test_program";

describe("test-program", () => {
  // Configure the client to use the local cluster.
  anchor.setProvider(anchor.AnchorProvider.env());

  const program = anchor.workspace.TestProgram as Program<TestProgram>;

  it("Is initialized!", async () => {
    // Add your test here.
    const tx = await program.methods.initialize().rpc();
    console.log("Your transaction signature", tx);
  });
});

在文件夹内使用anchor test进行测试,这里会自动调用(anchor build)进行program部署并在测试环境下发送一个方法请求(模拟请求链上程序),获得一个打印输出:

要查看具体的链上调用成功的信息(tx),可以使用以下内容获取具体的transaction信息:

const logs =
      await anchor.AnchorProvider.env().connection.getParsedTransaction(tx, {
        commitment: "confirmed",
      });
console.log("Solana Logs", logs);