使用 Solana Web3.js 和 Anchor 读取账户数据

本文展示如何通过 Solana Web3.js 和 Anchor 从前端直接读取账户数据，适用于 Web 应用程序。前文使用 solana account <地址> 查看数据，但此方法不适合 dApp。本教程将通过客户端计算账户地址、读取数据并反序列化，实现前端数据访问。

以以太坊为例，若避免公共变量或视图函数，可通过 getStorageAt(contract_address, slot) 获取存储槽数据。Solana 类似，但只需提供程序地址并推导数据账户地址，无需槽索引。

基础示例：读取自家程序数据

以下为前文 Rust 代码，未作修改：

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

declare_id!("9XZGDi1imvGFV3bLuDJK1bkUht51GPCRsVxMe4DpqWEo");

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

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

    pub fn set(ctx: Context<Set>, new_x: u64) -> Result<()> {
        ctx.accounts.my_storage.x = new_x;
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Set<'info> {
    #[account(mut, seeds = [], bump)]
    pub my_storage: Account<'info, MyStorage>,
}

#[derive(Accounts)]
pub struct Initialize<'info> {
    #[account(
        init,
        payer = signer,
        space = size_of::<MyStorage>() + 8,
        seeds = [],
        bump
    )]
    pub my_storage: Account<'info, MyStorage>,
    #[account(mut)]
    pub signer: Signer<'info>,
    pub system_program: Program<'info, System>,
}

#[account]
pub struct MyStorage {
    x: u64,
}

测试代码初始化账户并写入 x = 170，然后读取：

import * as anchor from "@coral-xyz/anchor";
import { Program } from "@coral-xyz/anchor";
import { BasicStorage} from "../target/types/basic_storage";

describe("basic_storage", () => {
  anchor.setProvider(anchor.AnchorProvider.env());

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

  it("Is initialized!", async () => {
    const seeds = []
    const [myStorage, _bump] = anchor.web3.PublicKey.findProgramAddressSync(seeds, program.programId);

    console.log("the storage account address is", myStorage.toBase58());

    await program.methods.initialize().accounts({myStorage: myStorage}).rpc();
    await program.methods.set(new anchor.BN(170)).accounts({myStorage: myStorage}).rpc();

    // 读取数据
    let myStorageStruct = await program.account.myStorage.fetch(myStorage);
      console.log("The value of x is:",myStorageStruct.x.toString());
    });
});

解析 fetch

• program.account.myStorage.fetch(myStorage) 根据 IDL（target/idl/basic_storage.json）自动推导地址、读取数据并反序列化为 Typescript 对象。

• IDL 定义：

    "accounts": [
      {
        "name": "MyStorage",
        "type": {
          "kind": "struct",
          "fields": [
            {
              "name": "x",
              "type": "u64"
            }
          ]
        }
      }
    ],

限制：此方法仅适用于自身程序或具备 IDL 的 Anchor 程序。对任意账户，反序列化会失败。

读取其他 Anchor 程序的数据

若知晓另一 Anchor 程序的 IDL，可读取其账户数据。以下新建程序 other_program：