零拷贝｜Anchor 中文文档

学习如何在 Solana 程序中使用 Anchor 的零拷贝反序列化功能来处理大型账户数据。

使用方法

零拷贝是一种反序列化功能，允许程序直接从内存中读取账户数据而无需复制。这在处理大型账户时特别有用。

要使用零拷贝，请将 bytemuck crate 添加到你的依赖项中。添加 min_const_generics 功能以允许在你的零拷贝类型中使用任意大小的数组。

Cargo.toml

[dependencies] bytemuck = { version = "1.20.0", features = ["min_const_generics"] } anchor-lang = "0.30.1"

定义零拷贝账户

要定义使用零拷贝的账户类型，请使用 #[account(zero_copy)] 注解结构体。

 #[account(zero_copy)] pub struct Data {  // 10240 字节 - 8 字节账户标识符  pub data: [u8; 10232], }

#[account(zero_copy)] 属性自动实现了零拷贝反序列化所需的几个特性：

 #[derive(Copy, Clone)] #[derive(bytemuck::Zeroable)] #[derive(bytemuck::Pod)] #[repr(C)] struct Data {  // --snip-- }

使用 AccountLoader 处理零拷贝账户

要反序列化一个零拷贝账户，请使用 AccountLoader<'info, T>，其中 T 是使用 #[account(zero_copy)] 属性定义的零拷贝账户类型。

例如：

#[derive(Accounts)] pub struct InstructionAccounts<'info> {    pub zero_copy_account: AccountLoader<'info, Data>, }

初始化零拷贝账户

init 约束可以与 AccountLoader 类型一起使用来创建零拷贝账户。

#[derive(Accounts)] pub struct Initialize<'info> {  #[account(    init,  // 10240 字节是使用 init 约束分配的最大空间  space = 8 + 10232,  payer = payer,  )]  pub data_account: AccountLoader<'info, Data>,  #[account(mut)]  pub payer: Signer<'info>,  pub system_program: Program<'info, System>, }

由于 CPI 限制，init 约束最多只能分配 10240 字节。在底层，init 约束会调用 SystemProgram 创建账户。

首次初始化零拷贝账户时，使用 load_init 获取账户数据的可变引用。load_init 方法还会设置账户标识符。

pub fn initialize(ctx: Context<Initialize>) -> Result<()> {    let account = &mut ctx.accounts.data_account.load_init()?;  account.data = [1; 10232];  Ok(()) }

对于需要超过 10240 字节的账户，请使用 zero 约束而不是 init。zero 约束通过检查账户标识符是否已设置来验证账户是否未初始化。

#[derive(Accounts)] pub struct Initialize<'info> {    #[account(zero)]  pub data_account: AccountLoader<'info, Data>, }

使用 zero 约束时，你需要先在单独的指令中通过直接调用 System Program 来创建账户。这允许你创建最大为 Solana 最大账户大小 10MB (10_485_760 字节) 的账户，绕过了 CPI 的限制。

和之前一样，使用 load_init 获取账户数据的可变引用并设置账户标识符。由于 8 字节保留给账户标识符，最大数据大小为 10_485_752 字节 (10MB - 8 字节)。

pub fn initialize(ctx: Context<Initialize>) -> Result<()> {    let account = &mut ctx.accounts.data_account.load_init()?;  account.data = [1; 10_485_752];  Ok(()) }

更新零拷贝账户

当你需要可变访问来更新现有的零拷贝账户时，使用 load_mut:

#[derive(Accounts)] pub struct Update<'info> {   #[account(mut)]  pub data_account: AccountLoader<'info, Data>, }

pub fn update(ctx: Context<Update>) -> Result<()> {    let account = &mut ctx.accounts.data_account.load_mut()?;  account.data = [2; 10232];  Ok(()) }

读取零拷贝账户

使用 load 仅读取账户数据。

#[derive(Accounts)] pub struct ReadOnly<'info> {  pub data_account: AccountLoader<'info, Data>, }

pub fn read_only(ctx: Context<ReadOnly>) -> Result<()> {    let account = &ctx.accounts.data_account.load()?;  msg!("前 10 字节: {:?}", &account.data[..10]);  Ok(()) }

示例

以下示例展示了在 Anchor 中初始化零拷贝账户的两种方法：

使用 init 约束在单个指令中初始化账户
使用 zero 约束初始化数据大于 10240 字节的账户

零拷贝

lib.rs

use anchor_lang::prelude::*;   declare_id!("8B7XpDXjPWodpDUWDSzv4q9k73jB5WdNQXZxNBj1hqw1");   #[program] pub mod zero_copy {  use super::*;  pub fn initialize(ctx: Context<Initialize>) -> Result<()> {  let account = &mut ctx.accounts.data_account.load_init()?;  account.data = [1; 10232];  Ok(())  }    pub fn update(ctx: Context<Update>) -> Result<()> {  let account = &mut ctx.accounts.data_account.load_mut()?;  account.data = [2; 10232];  Ok(())  } }   #[derive(Accounts)] pub struct Initialize<'info> {  #[account(  init,  // 10240 字节是使用 init 约束分配的最大空间  space = 8 + 10232,  payer = payer,  )]  pub data_account: AccountLoader<'info, Data>,  #[account(mut)]  pub payer: Signer<'info>,  pub system_program: Program<'info, System>, }   #[derive(Accounts)] pub struct Update<'info> {  #[account(mut)]  pub data_account: AccountLoader<'info, Data>, }   #[account(zero_copy)] pub struct Data {  // 10240 字节 - 8 字节账户标识符  pub data: [u8; 10232], }

初始化大型账户

当初始化一个需要超过 10,240 字节空间的账户时，你必须将初始化过程分为两步：

在单独的指令中调用 System Program 创建账户
在你的程序指令中初始化账户数据

注意，Solana 的最大账户大小为 10MB (10_485_760 字节)，8 字节保留给账户标识符。

lib.rs

use anchor_lang::prelude::*;   declare_id!("CZgWhy3FYPFgKE5v9atSGaiQzbSB7cM38ofwX1XxeCFH");   #[program] pub mod zero_copy_two {  use super::*;  pub fn initialize(ctx: Context<Initialize>) -> Result<()> {  let account = &mut ctx.accounts.data_account.load_init()?;  account.data = [1; 10_485_752];  Ok(())  } }   #[derive(Accounts)] pub struct Initialize<'info> {  #[account(zero)]  pub data_account: AccountLoader<'info, Data>, }   #[account(zero_copy)] pub struct Data {  // 10240 字节 - 8 字节账户标识符  pub data: [u8; 10_485_752], }

零拷贝

On this page