在本节中,您将使用 Anchor 框架构建、部署和测试一个简单的 Solana 程序(智能合约)。一步一步跟着我来,将完成第一个程序部署到 Solana 区块链上。
目录
本节的目的是让您熟悉 Solana Playground。本指南介绍了程序派生地址 (PDA) 和跨程序调用 (CPI) 部分中的更详细示例。有关更多详细信息,请参阅 Solana 上的程序页面。
1.创建 Anchor 项目
首先,在新的浏览器选项卡中打开 https://beta.solpg.io。
单击左侧面板上的 “Create a new project” 按钮。
输入项目名称,选择 Anchor 作为框架,然后单击 “Create” 按钮。
您将在 src/lib.rs
文件中看到一个使用程序代码创建的新项目。
这个基本的 Solana 程序会创建一个新帐户并在其中存储一个数字。该程序包含一个指令 (initialize
),该指令将 u64
数字作为输入,创建一个新帐户,并将该数字保存在该帐户的数据中。当您调用该指令时,它还会将一条消息记录到事务的程序日志中。
(我把它的内容贴下来:)
use anchor_lang::prelude::*;
// This is your program's public key and it will update
// automatically when you build the project.
declare_id!("11111111111111111111111111111111");
#[program]
mod hello_anchor {
use super::*;
pub fn initialize(ctx: Context<Initialize>, data: u64) -> Result<()> {
ctx.accounts.new_account.data = data;
msg!("Changed data to: {}!", data); // Message will show up in the tx logs
Ok(())
}
}
#[derive(Accounts)]
pub struct Initialize<'info> {
// We must specify the space in order to initialize an account.
// First 8 bytes are default account discriminator,
// next 8 bytes come from NewAccount.data being type u64.
// (u64 = 64 bits unsigned integer = 8 bytes)
#[account(init, payer = signer, space = 8 + 8)]
pub new_account: Account<'info, NewAccount>,
#[account(mut)]
pub signer: Signer<'info>,
pub system_program: Program<'info, System>,
}
#[account]
pub struct NewAccount {
data: u64
}
解释:
declare_id!macro 指定程序的链上地址。Solana Playground 会在您下一步构建程序时自动更新此地址。
declare_id!("11111111111111111111111111111111");
#[program]
属性对包含表示程序指令的函数的模块进行注释。
#[program]
mod hello_anchor {
use super::*;
pub fn initialize(ctx: Context<Initialize>, data: u64) -> Result<()> {
ctx.accounts.new_account.data = data;
msg!("Changed data to: {}!", data); // Message will show up in the tx logs
Ok(())
}
}
在此示例中,initialize
指令采用两个参数:
1.ctx: Context<Initialize>
- 将此指令所需的帐户传递给函数,如 Initialize
结构中所指定。
2.data: u64
- 调用指令时必须提供的自定义参数。
函数体将 new_account 的 data
字段设置为提供的 data
参数,然后将消息打印到程序日志中。
#[derive(Accounts)]
pub struct Initialize<'info> {
#[account(init, payer = signer, space = 8 + 8)]
pub new_account: Account<'info, NewAccount>,
#[account(mut)]
pub signer: Signer<'info>,
pub system_program: Program<'info, System>,
}
该 #[derive(Accounts)]
属性定义了一个结构体,该结构体指定特定指令所需的账户,其中每个字段代表一个单独的账户。
Anchor通过字段类型(例如Signer<'info>)和约束(例如#[account(mut)])自动处理与帐户验证相关的常见安全检查。
(简单来说,就是有个结构体,能创建账户,并且里面能校验)
#[account]
属性定义了一个结构体,该结构体表示此程序创建和拥有的账户的数据类型。
#[account]
pub struct NewAccount {
data: u64
}
2.构建和部署程序
要构建程序,只需在终端中运行 build
即可。
(构建成功)
Solana Playground 更新了 declare_id 年的地址 !()
.此地址代表您的程序的链上地址(程序 ID)。
(如图所示!)
构建程序后,在终端中运行 deploy
,将程序部署到网络(默认为 devnet)。程序部署需要将 SOL 分配给存储程序的链上账户。
(进度条在动!)
(部署完成,会弹出一个链接,点开后看到部署详情)
在部署之前,请确保您有足够的 SOL。您可以通过在 Playground 终端中运行 solana airdrop 5
或使用 空投。
您还可以使用左侧面板上的 Build (构建
) 和 Deploy (部署)
按钮。
3.测试程序
起始代码包括一个位于 tests/anchor.test.ts
中的测试文件。此文件演示如何从客户端调用程序上的 initialize
指令。
(我把它贴下来:)
// No imports needed: web3, anchor, pg and more are globally available
describe("Test", () => {
it("initialize", async () => {
// Generate keypair for the new account
const newAccountKp = new web3.Keypair();
// Send transaction
const data = new BN(42);
const txHash = await pg.program.methods
.initialize(data)
.accounts({
newAccount: newAccountKp.publicKey,
signer: pg.wallet.publicKey,
systemProgram: web3.SystemProgram.programId,
})
.signers([newAccountKp])
.rpc();
console.log(`Use 'solana confirm -v ${txHash}' to see the logs`);
// Confirm transaction
await pg.connection.confirmTransaction(txHash);
// Fetch the created account
const newAccount = await pg.program.account.newAccount.fetch(
newAccountKp.publicKey
);
console.log("On-chain data is:", newAccount.data.toString());
// Check whether the data on-chain is equal to local 'data'
assert(data.eq(newAccount.data));
});
});
部署程序后,要运行测试文件,请在终端中运行 test
。
(结果如下:)
查找确认测试成功通过的输出。
还可以使用 Test (测试
) 左侧面板上的按钮。
然后,您可以通过运行 solana confirm -v
来查看交易日志 命令并从测试输出中指定交易哈希(签名):
solana confirm -v [TxHash]
您还可以查看交易详情 SolanaFM 或 Solana Explorer 通过搜索交易签名(哈希)进行搜索。
请记住在用于匹配 Solana Playground 的 Explorer 上更新集群(网络)连接。Solana Playground 默认使用 devnet 集群。
4.关闭程序
最后,关闭程序可以完全恢复分配给链上程序的 SOL。
您可以通过运行以下命令并指定在 declare_id 中找到的程序地址来关闭程序 !()
:
solana program close [ProgramID]
(余额已经恢复!)
Congratulations!
恭喜你!刚刚使用 Anchor 框架构建并部署了您的第一个 Solana 程序。
参考:链接