删除和关闭 Solana 中的账户和程序

  • 0xE
  • 发布于 1天前
  • 阅读 207

在 Solana 的 Anchor 框架中,close 用于销毁账户并回收租金,将 lamports 转移并变更所有权至系统程序,而程序关闭则通过 CLI 实现且地址不可重用。

在 Solana 的 Anchor 框架中,close 是与 init 相对的操作,用于销毁账户。它将账户的 lamport 余额清零,将 lamports 转移到指定地址,并将账户的所有者变更为系统程序。本文将深入探讨账户和程序的关闭过程,结合代码示例和底层实现,阐明其工作原理及关键细节。


使用 close 删除账户

Anchor 中的 close 指令用于释放账户空间并回收租金。以下是 Rust 示例:

use anchor_lang::prelude::*;
use std::mem::size_of;

declare_id!("BonMtRCa3eCq6mPHFqY5aVUh3QbUnzB1e5wPaWgSNCdJ");

#[program]
pub mod close_program {
    use super::*;

    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        Ok(())
    }

    pub fn delete(ctx: Context<Delete>) -> Result<()> {
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Initialize<'info> {
    #[account(init, payer = signer, space = size_of::<ThePda>() + 8, seeds = [], bump)]
    pub the_pda: Account<'info, ThePda>,

    #[account(mut)]
    pub signer: Signer<'info>,

    pub system_program: Program<'info, System>,
}

#[derive(Accounts)]
pub struct Delete<'info> {
    #[account(mut, close = signer, )]
    pub the_pda: Account<'info, ThePda>,

    #[account(mut)]
    pub signer: Signer<'info>,
}

#[account]
pub struct ThePda {
    pub x: u32,
}

租金回收机制

close = signer 宏指定 lamports 返回给交易签名者(也可指定其他地址)。这与以太坊中 selfdestruct(Dencun 升级前)的退款机制类似。回收的 SOL 数量与账户占用空间成正比。

以下是 Typescript 调用示例:

import * as anchor from "@coral-xyz/anchor";
import { Program } from "@coral-xyz/anchor";
import { CloseProgram } from "../target/types/close_program";
import { assert } from "chai";

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

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

  it("Is initialized!", async () => {
   let [thePda, _bump] = anchor.web3.PublicKey.findProgramAddressSync([], program.programId);
    await program.methods.initialize().accounts({thePda: thePda}).rpc();
    await program.methods.delete().accounts({thePda: thePda}).rpc();

    let account = await program.account.thePda.fetchNullable(thePda);
    console.log(account)
  });
});

需要注意的是,该示例允许任何人关闭账户。在生产环境中,应添加权限验证以限制操作。


关闭后账户可重新初始化

关闭账户后,其地址仍可通过 initialize 重建,但需再次支付租金。这类似于以太坊中销毁后地址可重用的特性。


close 的底层操作

Anchor 的 close 指令源码(v0.29.0)如下:

use crate::prelude::{Id, System};
use crate::Result;
use solana_program::account_info::AccountInfo;
use solana_program::system_program;

pub fn close<'info>(info: AccountInfo<'info>, sol_destination: AccountInfo<'info>) -> Result<()> {
    // Transfer tokens from the account to the sol_destination.
    let dest_starting_lamports = sol_destination.lamports();
    **sol_destination.lamports.borrow_mut() =
        dest_starting_lamports.checked_add(info.lamports()).unwrap();
    **info.lamports.borrow_mut() = 0;

    info.assign(&system_program::ID);
    info.realloc(0, false).map_err(Into::into)
}

pub fn is_closed(info: &AccountInfo) -> bool {
    info.owner == &System::id() && info.data_is_empty()
}

执行过程

  1. 转移 lamports:将账户余额加到目标地址,原账户余额置零。
  2. 变更所有权:将 Owner 设置为系统程序(111...111)。
  3. 清空数据:通过 realloc(0, false) 释放存储空间。

is_closed 函数确认账户关闭,条件是 Owner 为系统程序且数据为空。


Anchor 关闭机制的演变

在 Anchor 0.25 版本(源码)中,close 的实现不同:

  • 先转移所有 lamports。
  • 不变更所有权,而是写入特殊鉴别器:

    pub const CLOSED_ACCOUNT_DISCRIMINATOR: [u8; 8] = [255, 255, 255, 255, 255, 255, 255, 255];

运行时因余额为零最终擦除账户。许多旧文档仍基于此实现。

账户鉴别器的功能

Anchor 初始化账户时,将结构标识符(如 ThePda)的 SHA256 前 8 字节作为鉴别器,存入数据区头部。加载账户时,程序验证此鉴别器,确保数据与预期结构匹配,防止恶意构造。

全 255 鉴别器的设计

旧版本使用 [255, ...] 标记关闭账户,避免程序反序列化。这是为了防止攻击者通过发送 SOL “复活”账户,若旧鉴别器保留,程序可能误读数据。

新版本的改进

当前版本将 Owner 改为系统程序,即使账户被复活,也归系统程序所有,程序无法直接操作。重新初始化需显式调用 init,消除了旧版的安全隐患。


通过 CLI 关闭程序

关闭程序(而非账户)使用以下命令:

solana program close <address> --bypass-warning

关闭程序会回收租金,但地址不可重用。以下是操作序列:

➜   solana program close BonMtRCa3eCq6mPHFqY5aVUh3QbUnzB1e5wPaWgSNCdJ
Error: WARNING! Closed programs cannot be recreated at the same program id. Once a program is closed, it can never be invoked again. To proceed with closing, rerun the `close` command with the `--bypass-warning` flag

➜   solana program close BonMtRCa3eCq6mPHFqY5aVUh3QbUnzB1e5wPaWgSNCdJ --bypass-warning

Closed Program Id BonMtRCa3eCq6mPHFqY5aVUh3QbUnzB1e5wPaWgSNCdJ, 1.38529752 SOL reclaimed

➜   anchor deploy
Deploying cluster: http://localhost:8899
Upgrade authority: /Users/xxx/.config/solana/id.json
Deploying program "close_program"...
Program path: /Users/xxx/close_program/target/deploy/close_program.so...
Error: Program BonMtRCa3eCq6mPHFqY5aVUh3QbUnzB1e5wPaWgSNCdJ has been closed, use a new Program Id
There was a problem deploying: Output { status: ExitStatus(unix_wait_status(256)), stdout: "", stderr: "" }.

过程分析

  1. 初次关闭失败,需添加 --bypass-warning。
  2. 成功关闭,回收 1.38 SOL。
  3. 重部署失败,地址永久锁定。

总结

  • 账户关闭:close 清零 lamports、转移所有权至系统程序,回收租金。
  • 程序关闭:通过 CLI 操作,地址不可重用。
  • 版本差异:新版 Anchor 优化了关闭流程,安全性更强。

【笔记配套代码】 https://github.com/0xE1337/rareskills_evm_to_solana 【参考资料】 https://learnblockchain.cn/column/119 https://www.rareskills.io/solana-tutorial

点赞 1
收藏 0
分享
本文参与登链社区写作激励计划 ,好文好收益,欢迎正在阅读的你也加入。

0 条评论

请先 登录 后评论
0xE
0xE
0x59f6...a17e
17年进入币圈,Web3 开发者。刨根问底探链上真相,品味坎坷悟 Web3 人生。