发布日期：2025-01-04 10:07    点击次数：174

Web3.js API 示例 ​Web3 API 参考指南 ​@solana/web3.js 库是一个涵盖 Solana JSON RPC API的包。你可以在这里找到 @solana/web3.js 库的完整文档。通用 ​连接 ​源文档Connection连接 用于与 Solana JSON RPC 交互。你可以使用 Connection 来确认交易、获取账户信息等。你可以通过定义 JSON RPC 集群端点和所需的确认级别来创建连接。完成后，你可以使用这个连接对象与任何 Solana JSON RPC API 进行交互。示例用法 ​上面的示例仅展示了 Connection 的一些方法。请参阅源生成文档以获取完整列表。交易 ​源文档Transaction交易用于与 Solana 区块链上的程序交互。这些交易由 TransactionInstructions 构成，包含所有可能交互的账户以及任何所需的数据或程序地址。每个 TransactionInstruction 包含键、数据和 programId。你可以在单个交易中进行多个指令，同时与多个程序交互。示例用法 ​密钥对 ​源文档Keypair密钥对 用于在 Solana 上创建一个具有公钥和私钥的账户。你可以生成一个新的密钥对，从种子生成，或从私钥创建。示例用法 ​使用 generate 可以生成一个用于在 Solana 上作为账户的随机密钥对。使用 fromSeed，你可以使用确定性构造函数生成一个密钥对。fromSecret 则从一个秘密的 Uint8Array 创建一个密钥对。你可以看到，生成的密钥对和 fromSecret 密钥对的公钥是相同的，因为生成的密钥对的私钥被用在 fromSecret 中。警告：除非你正在创建一个高熵种子，否则不要使用 fromSeed。不要共享你的种子。像对待私钥一样对待你的种子。公钥 ​源文档PublicKey公钥 在 @solana/web3.js 中的交易、密钥对和程序中使用。列出交易中的每个账户时，以及作为 Solana 上的通用标识符时，需要 publickey。可以使用 base58 编码字符串、缓冲区、Uint8Array、数字和数字数组来创建 公钥。示例用法 ​系统程序 ​源文档SystemProgram系统程序 允许创建账户、分配账户数据、将账户分配给程序、处理 nonce 账户以及转移 lamports。你可以使用 SystemInstruction 类来帮助解码和读取单个指令。示例用法 ​Secp256k1程序 ​源文档Secp256k1程序 用于验证 Secp256k1 签名，这些签名被比特币和以太坊使用。示例用法 ​消息 ​源文档Message消息 是构建交易的另一种方式。你可以使用交易的一部分账户、头、指令和 recentBlockhash 来构建消息。一个交易是一个消息加上执行交易所需的签名列表。示例用法 ​结构体 ​源文档Struct结构体 类用于在 JavaScript 中创建与 Rust 兼容的结构体。该类仅兼容 Borsh 编码的 Rust 结构体。示例用法 ​Rust中的结构体:使用web3js:枚举 ​源文档Enum枚举 类用于在 JavaScript 中表示与 Rust 兼容的枚举。枚举在日志中将只是一个字符串表示，但当与 结构体 一起使用时，可以正确编码/解码。该类仅兼容 Borsh 编码的 Rust 枚举。示例用法 ​Rust:Web3:Nonce账户 ​源文档如果交易的 recentBlockhash 字段太旧，通常会被拒绝。为了提供某些托管服务，使用了 NonceAccount Nonce账户。使用 Nonce 账户在链上捕获的 recentBlockhash 的交易只要 Nonce 账户不被推进就不会过期。你可以先创建一个普通账户，然后使用 SystemProgram 将其变为 Nonce 账户来创建一个 nonce 账户。示例用法 ​上面的示例展示了如何使用 SystemProgram.createNonceAccount 创建一个 NonceAccount，以及如何从 accountInfo 中检索 Nonce账户。使用 nonce，你可以离线创建带有 nonce 的交易以取代 recentBlockhash。投票账户 ​源文档Vote Account投票账户 对象提供了解码网络上本地投票账户程序的投票账户的功能。示例用法 ​质押 ​质押程序 ​源文档StakeProgram质押程序 便于质押 SOL 并将其委托给网络上的任何验证节点。你可以使用 质押程序 创建一个质押账户，质押一些 SOL，授权账户提取你的质押，停用你的质押并提取你的资金。StakeInstruction 类用于解码和读取调用 质押程序 的交易中的更多指令。示例用法 ​授权者 ​源文档Authorized授权者是一个对象，用于在 Solana 内部创建一个授权账户进行质押时使用。你可以分别指定质押者和提取者，允许不同的账户提取，而不是质押者。你可以在 质押程序 下找到更多 授权者对象的用法。锁定 ​源文档Lockup锁定 与 StakeProgram 一起使用来创建一个账户。用于确定质押将被锁定或无法提取的时间。如果 epoch 和 Unix 时间戳都设置为 0，则该账户的锁定将被禁用。示例用法 ​上面的代码创建了一个 createStakeAccountInstruction，用于在创建 质押程序 的账户时使用。epoch 和 Unix 时间戳都设置为 0，禁用该账户的锁定。有关更多信息，请参阅 质押程序 。