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

最新推荐文章于 2025-04-03 13:29:09 发布

GTokenTool发币平台

最新推荐文章于 2025-04-03 13:29:09 发布

阅读量462

点赞数 22

文章标签：区块链

本文链接：https://blog.youkuaiyun.com/2408_87746709/article/details/146949121

版权

在 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()
}

执行过程

转移 lamports：将账户余额加到目标地址，原账户余额置零。
变更所有权：将 Owner 设置为系统程序（111...111）。
清空数据：通过 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: "" }.

过程分析