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

  • 0xE
  • 发布于 2025-03-26 10:28
  • 阅读 536

本文介绍了通过 Solana Web3.js 和 Anchor 从前端读取账户数据的三种方法:自家 Anchor 程序用 fetch、跨程序读取需 IDL、任意账户用 Web3.js 自定义反序列化,强调了序列化与 IDL 的作用,为 Solana dApp 开发提供指导。

本文展示如何通过 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&lt;Initialize>) -> Result&lt;()> {
        Ok(())
    }

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

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

#[derive(Accounts)]
pub struct Initialize&lt;'info> {
    #[account(
        init,
        payer = signer,
        space = size_of::&lt;MyStorage>() + 8,
        seeds = [],
        bump
    )]
    pub my_storage: Account&lt;'info, MyStorage>,
    #[account(mut)]
    pub signer: Signer&lt;'info>,
    pub system_program: Program&lt;'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&lt;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:

剩余50%的内容订阅专栏后可查看

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

0 条评论

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