导航

从 0 开始上手 Solana 智能合约

0 条评论 , 0 次修正，178 次阅读，最后更新于 2024年07月26日

Solana CLI 基础知识

Solana CLI 是一个命令行界面工具，提供了一系列用于与 Solana Cluster 交互的命令。

在本课程中，我们将介绍一些最常见的命令，但你始终可以通过运行 solana --help 查看所有可能的 Solana CLI 命令列表。

Solana CLI 配置

Solana CLI 存储了一些配置设置，这些设置会影响某些命令的行为。你可以使用以下命令查看当前的配置：

solana config get

solana config get 命令将返回以下信息：

  • Config File - Solana CLI 文件在计算机上的位置
  • RPC URL - 你使用的节点，将你连接到 localhost、Devnet 或 Mainnet
  • WebSocket URL - 用于监听你所针对的 Cluster 事件的 WebSocket（在设置 RPC URL 时计算）
  • Keypair Path - 运行 Solana CLI 子命令时使用的密钥对路径
  • Commitment - 提供网络确认（confirmation）的度量，并描述区块在某一时刻已最终确认（finalized）的程度

你可以随时使用 solana config set 命令，后跟你想要更新的设置，更改 Solana CLI 的配置。

最常见的更改将是针对的 Cluster。使用 solana config set --url 命令更改 RPC URL。

solana config set --url localhost

solana config set --url devnet

solana config set --url mainnet-beta

类似地，你可以使用 solana config set --keypair 命令更改 Keypair Path。然后，当运行命令时，Solana CLI 将使用指定路径上的密钥对。

solana config set --keypair ~/<FILE_PATH>

测试验证节点

通常，为了进行测试和调试，你会发现运行本地验证节点比部署到 Devnet 更有帮助。

你可以使用 solana-test-validator 命令运行本地测试验证器。此命令创建一个持续运行的进程，需要在其自己的命令行窗口中运行。

流式程序日志

通常，同时打开一个新控制台并运行 solana logs 命令，可以帮助你观察测试验证节点相关的日志。这将创建另一个持续运行的进程，会流式传输与你配置的 Cluster 相关的日志。

如果 CLI 配置指向 localhost，则日志将始终与你创建的测试验证器相关联，但你也可以从其他 Cluster（如 Devnet 和 Mainnet Beta）中流式传输日志。当从其他 Cluster 流式传输日志时，你需要在命令中包含一个程序 ID，以限制你看到的日志仅为特定程序的日志。

密钥对

你可以使用 solana-keygen new --outfile 命令生成新的密钥对，后跟存储密钥对的文件路径。

solana-keygen new --outfile ~/<FILE_PATH>

有时，你可能需要检查配置指向的是哪个密钥对。要查看在 solana config 中设置的当前密钥对的 publickey，请使用 solana address 命令。

solana address

要查看在 solana config 中设置的当前密钥对的 SOL 余额，请使用 solana balance 命令。

solana balance

要在 Devnet 或 localhost 上空投 SOL，请使用 solana airdrop 命令。请注意，在 Devnet 上，每次空投限制为 5 SOL。

solana airdrop 5

在本地环境中开发和测试程序时，你可能会遇到以下原因导致的错误：

  • 使用错误的密钥对
  • 没有足够的 SOL 来部署程序或执行交易
  • 指向错误的 Cluster

到目前为止，我们介绍的 CLI 命令应该可以帮助你迅速解决这些问题。

在本地环境中开发 Solana 程序

尽管 Solana Playground 非常有帮助，但很难超越你自己的本地开发环境的灵活性。随着你构建更复杂的程序，你可能最终会将它们与在本地环境中同样在开发中的一个或多个客户端集成。当你在本地编写、构建和部署程序时，程序和客户端之间的测试通常更简单。

创建新项目

要创建一个用于编写 Solana 程序的新 Rust 包，你可以使用 cargo new --lib 命令，后跟你想要创建的新目录的名称。

cargo new --lib <PROJECT_DIRECTORY_NAME>

此命令将创建一个新目录，其名称为你在命令末尾指定的名称。这个新目录将包含一个描述该包的 Cargo.toml 清单文件（manifest file）。

清单文件包含元数据，如名称、版本和依赖项（crates）。要编写 Solana 程序，你需要更新 Cargo.toml 文件，将 solana-program 添加为依赖项。你可能还需要添加下面显示的 [lib] 和 crate-type 行。

[package]
name = "<PROJECT_DIRECTORY_NAME>"
version = "0.1.0"
edition = "2021"

[features]
no-entrypoint = []

[dependencies]
solana-program = "~1.8.14"

[lib]
crate-type = ["cdylib", "lib"]

在这一点上，你可以开始在 src 文件夹中编写程序。

构建和部署

当需要构建 Solana 程序时，可以使用 cargo build-bpf 命令。

cargo build-bpf

该命令的输出将包含部署程序的说明，看起来类似于：

To deploy this program:
  $ solana program deploy /Users/James/Dev/Work/solana-hello-world-local/target/deploy/solana_hello_world_local.so
The program address will default to this keypair (override with --program-id):
  /Users/James/Dev/Work/solana-hello-world-local/target/deploy/solana_hello_world_local-keypair.json

当你准备部署程序时，使用 cargo build-bpf 输出的 solana program deploy 命令。这将把你的程序部署到你 CLI 配置中指定的 Cluster。

solana program deploy <PATH>

实验

让我们通过构建和部署我们在Hello World 课程中创建的 "Hello World!" 程序来进行实践。

我们将全部在本地进行，包括部署到本地测试验证节点。在开始之前，请确保你已安装了 Rust 和 Solana CLI。如果尚未设置，请参考概述中的说明。

1. 创建一个新的 Rust 项目

让我们从创建一个新的 Rust 项目开始。运行下面的 cargo new --lib 命令。随意用你自己的目录名称替换。

cargo new --lib solana-hello-world-local

记得更新 Cargo.toml 文件，将 solana-program 添加为依赖项，并确保 crate-type 行已经存在。

[package]
name = "solana-hello-world-local"
version = "0.1.0"
edition = "2021"

[dependencies]
solana-program = "~1.8.14"

[lib]
crate-type = ["cdylib", "lib"]

2. 编写程序

接下来，使用下面的“Hello World!”程序更新 lib.rs。当调用程序时，该程序将简单地打印“Hello, world!”到程序日志。

use solana_program::{
    account_info::AccountInfo,
    entrypoint,
    entrypoint::ProgramResult,
    pubkey::Pubkey,
    msg
};

entrypoint!(process_instruction);

pub fn process_instruction(
    program_id: &Pubkey,
    accounts: &[AccountInfo],
    instruction_data: &[u8]
) -> ProgramResult{
    msg!("Hello, world!");

    Ok(())
}

3. 运行本地测试验证节点

在编写好程序之后，让我们确保我们的 Solana CLI 配置指向 localhost，使用 solana config set --url 命令。

solana config set --url localhost

接下来，使用 solana config get 命令检查 Solana CLI 配置是否已更新。

solana config get

最后，在一个单独的终端窗口中运行本地测试验证器。运行 solana-test-validator 命令。只有当我们的 RPC URL 设置为 localhost 时，才需要执行此操作。

solana-test-validator

4. 构建和部署

现在我们准备好构建和部署我们的程序了。通过运行 cargo build-bpf 命令来构建程序。

cargo build-bpf

现在让我们部署程序。运行 cargo build-bpf 输出的 solana program deploy 命令。

solana program deploy <PATH>

solana program deploy 将输出程序的 Program ID。你现在可以在Solana Explorer上查找已部署的程序（对于 localhost，请选择“Custom RPC URL”作为 Cluster）。

5. 查看程序日志

在调用我们的程序之前，打开一个单独的终端，并运行 solana logs 命令。这将允许我们在终端中查看程序的日志。

solana logs <PROGRAM_ID>

在测试验证节点仍在运行的情况下，尝试使用此客户端脚本调用程序。

在 index.ts 中用刚刚部署的程序的程序 ID 替换原有的程序 ID，然后运行 npm install，接着运行 npm start。这将返回一个 Solana Explorer URL。将该 URL 复制到浏览器中以在 Solana Explorer 上查找交易，并检查是否将“Hello, world!”打印到程序日志中。或者，你也可以在运行 solana logs 命令的终端中查看程序日志。

恭喜！你刚刚从本地开发环境中创建并部署了你的第一个 Solana 程序。

挑战

尝试创建一个新程序，将自己的消息打印到程序日志中。这次将程序部署到 Devnet，而不是 localhost。

记得使用 solana config set --url 命令将 RPC URL 更新到 Devnet。

你可以使用与实验相同的客户端脚本调用程序，只要将 connection 和 Solana Explorer URL 都更新为指向 Devnet 而不是 localhost。

let connection = new web3.Connection(web3.clusterApiUrl("devnet"));

console.log(
    `Transaction: https://explorer.solana.com/tx/${transactionSignature}?cluster=devnet`
);

你还可以打开一个单独的命令行窗口，并使用 solana logs | grep "<PROGRAM_ID> invoke" -A <NUMBER_OF_LINES_TO_RETURN>。在 Devnet 上使用 solana logs 时，必须指定程序 ID。否则，solana logs 命令将从 Devnet 返回一系列恒定的日志流。例如，你可以执行以下操作来监视对 Token 程序的调用，并显示每次调用的前 5 行日志：

solana logs | grep "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA invoke" -A 5
本页贡献者:
发表评论