概述
需要提取与钱包关联的所有交易吗？想查看与糖果机关联的所有铸币交易？或者查看NFT的交易历史？Solana的 getSignaturesForAddress 方法是一个多功能工具，使获取交易历史变得轻而易举。
喜欢视频教程吗？跟随 Noah 学习如何使用 Solana web3.js 在 15 分钟内获取 Solana 交易日志。
你将做什么
在本指南中，你将深入了解 Solana 交易的精彩世界！你将构建一个简单的脚本，可以查询一个地址（钱包、程序 ID、代币铸币等），并找到与之关联的所有交易历史。
你需要的条件
Nodejs（版本 16.15 或更高）
已安装 Yarn
Solana web3
在 Solana 上的基本交易经验。为了复习你的知识，请阅读我们的初学者指南 如何在 Solana 上发送交易
JavaScript 的知识
让我们开始吧！
设置你的环境
在终端中创建一个新的项目目录和文件 log.js：
mkdir get_sol_tx
cd get_sol_tx
echo > log.js
安装 Solana web3 依赖项：
yarn init -y
yarn add @solana/web3.js@1
或者
npm init -y
npm install --save @solana/web3.js@1
在你选择的代码编辑器中打开 log.js，并在第 1 行引入 @solana/web3.js 并将其存储在一个常量 solanaWeb3 中：
**
const solanaWeb3 = require('@solana/web3.js');
声明一个你想要搜索的地址：
const searchAddress = 'YOUR_ADDRESS_HERE'; // 示例 'vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg'
注意：这可以是 Solana 上的任意有效地址（例如，钱包地址、铸币地址、程序地址）。如果你还没有地址，可以使用 'vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg' 作为示例。
好吧，我们准备开始了！
建立与 QuickNode RPC 的连接
要在 Solana 上构建，你需要一个 API 端点来连接网络。你可以使用公共节点或自己部署和管理基础设施；然而，如果你希望响应时间快 8 倍，你可以将繁重的工作留给我们。
我们将启动我们的节点在 Solana Devnet 下，但你可以启动符合你需求的节点。复制 HTTP 提供程序链接：
返回 log.js，创建一个常量 endpoint并将其分配给你的 QuickNode url。在下一行，将此常量作为参数传递给 Connection 函数，并将其存储在另一个常量叫 solanaConnection 中：
const endpoint = 'https://example.solana-devnet.quiknode.pro/000000/';
const solanaConnection = new solanaWeb3.Connection(endpoint);
太好了！你准备好构建你的搜索功能了。
创建交易查询
getSignaturesForAddress 方法将会在这里做大量的繁重工作。它的工作原理如下：
它将接受两个参数：
要搜索的地址（必需）：你想要查询的 公钥
选项（可选）：包含 3 个可选条目的对象：
before：在特定交易签名之前开始向后搜索
after：在特定交易签名之后开始向前搜索
limit：返回的最大交易数量 (请注意，最大和默认值为1,000)
它将返回一个 Promise，包含一个 ConfirmedSignatureInfo 的数组，这是一个包含关键交易信息的对象：
signature（交易 ID），
slot 和 blockTime（查看交易处理的时间），
err（如果有错误），以及
memo（如果与交易相关的任何备注）
定义一个新的 async 函数 getTransactions，该函数接受两个参数：address 和 numTx。
在我们的函数内部，调用 getSignaturesForAddress 方法，在 solanaConnection 的新实例上，并将输出保存到变量 transactionList：
const getTransactions = async(address, numTx) => {
const pubKey = new solanaWeb3.PublicKey(address);
let transactionList = await solanaConnection.getSignaturesForAddress(pubKey, {limit:numTx});
}
这应该会给我们一个满足搜索条件的所有交易历史的数组。让我们以易于阅读的方式记录结果。
在 getTransactions 内部，创建一个 forEach 循环以记录每笔交易的信息：
const getTransactions = async(address, numTx) => {
const pubKey = new solanaWeb3.PublicKey(address);
let transactionList = await solanaConnection.getSignaturesForAddress(pubKey, {limit:numTx});
transactionList.forEach((transaction, i) => {
const date = new Date(transaction.blockTime*1000);
console.log(`交易编号: ${i+1}`);
console.log(`签名: ${transaction.signature}`);
console.log(`时间: ${date}`);
console.log(`状态: ${transaction.confirmationStatus}`);
console.log(("-").repeat(20));
})
}
运行你的代码！
如果一切设置正确，你应该可以调用你的函数并看到一些结果！将以下内容添加到 log.js 的末尾：
getTransactions(searchAddress,3);
现在在你的终端中输入：
node log.js
你应该看到类似这样的内容：
哇！好简单，对吧？随便测试几种不同的钱包、NFT 代币地址和糖果机 ID。你可以看到，这个方法应该会产生类似的结果，这使得它在许多不同应用中非常方便。
恭喜！你成功地获取了交易……你可以到此为止，但如果你想看看我们还可以用交易签名做些什么，请继续阅读！ 👇
解析交易
所以我们获得了一些关于交易历史的有用基本信息，但每笔交易做了什么呢？我们可以使用 Solana 的 getParsedTransaction 方法来提供更多详细信息。
getParsedTransaction 方法将接受一个已确认或已完成的交易签名，并返回一个 ParsedTransactionWithMeta 对象：
export type ParsedTransactionWithMeta = {
/** 交易被处理时的插槽 */
slot: number;
/** 交易的详细信息 */
transaction: ParsedTransaction;
/** 交易产生的元数据 */
meta: ParsedTransactionMeta | null;
/** 处理交易时的 Unix 时间戳 */
blockTime?: number | null;
/** 交易消息的版本 */
version?: TransactionVersion;
};
这里有很多信息，我们在这个初级指南中不会进行详细说明，但我们确实想给出一个如何与这些对象互动的示例。
在你的 getTransactions 函数中，我们将声明两个新变量：signatureList 和 transactionDetails。我们将通过映射我们的 transactionList 来生成签名列表，并通过调用这些签名到 getParsedTransactions 来生成每笔交易的详细信息：
const getTransactions = async(address, numTx) => {
const pubKey = new solanaWeb3.PublicKey(address);
let transactionList = await solanaConnection.getSignaturesForAddress(pubKey, {limit:numTx});
//添加此代码
let signatureList = transactionList.map(transaction=>transaction.signature);
let transactionDetails = await solanaConnection.getParsedTransactions(signatureList, {maxSupportedTransactionVersion:0});
//--新代码结束
transactionList.forEach((transaction, i) => {
const date = new Date(transaction.blockTime*1000);
console.log(`交易编号: ${i+1}`);
console.log(`签名: ${transaction.signature}`);
console.log(`时间: ${date}`);
console.log(`状态: ${transaction.confirmationStatus}`);
console.log(("-").repeat(20));
})
}
当我们的 Promise 返回时，transactionDetails 将生成一个 ParsedTransactionWithMeta 对象的数组。让我们尝试查找一些有用的信息。
假设我们有兴趣找出针对特定交易我们交互的所有程序或智能合约。在我们原来的 forEach 循环中，在 date 声明后，创建一个新变量，transactionInstructions：
const transactionInstructions = transactionDetails[i].transaction.message.instructions;
这将利用我们的索引 i 来查找与循环中正在查询的相同交易的详细交易信息。由于每笔交易可以有多个指令或程序迭代，我们需要另一个循环来获取交易中的每个程序交互。在我们的循环中，在 确认状态 日志后，添加以下内容：
transactionInstructions.forEach((instruction, n)=>{
console.log(`---指令 ${n+1}: ${instruction.programId.toString()}`);
})
我们在这里要做的是，对于每笔交易，查看每个交易指令并记录程序名称（如果存在）和程序 ID。
最终的函数应该如下所示：
const getTransactions = async(address, numTx) => {
const pubKey = new solanaWeb3.PublicKey(address);
let transactionList = await solanaConnection.getSignaturesForAddress(pubKey, {limit:numTx});
let signatureList = transactionList.map(transaction=>transaction.signature);
let transactionDetails = await solanaConnection.getParsedTransactions(signatureList, {maxSupportedTransactionVersion:0});
transactionList.forEach((transaction, i) => {
const date = new Date(transaction.blockTime*1000);
const transactionInstructions = transactionDetails[i].transaction.message.instructions;
console.log(`交易编号: ${i+1}`);
console.log(`签名: ${transaction.signature}`);
console.log(`时间: ${date}`);
console.log(`状态: ${transaction.confirmationStatus}`);
transactionInstructions.forEach((instruction, n)=>{
console.log(`---指令 ${n+1}: ${instruction.programId.toString()}`);
})
console.log(("-").repeat(20));
})
}
现在，再次运行你的脚本。在你的终端中输入：
node log.js
你应该看到类似这样的内容：
干得好！我们的交易结果现在包括了我们交互的不同程序的详细信息！
如果愿意，你可以通过 这里 在 Solana explorer 上比较你的结果（确保在页面右上角更改以搜索相同的网络）。
结束
干得好！你现在已经深入了解 Solana 交易的精彩世界！
我们将在未来的指南中进一步介绍这些内容；但如果你渴望继续探索，请尝试通过运行一些类似查询来对你的 transactionDetails 数组进行实验，查看：
transactionDetails[i].meta
transactionDetails[i].transaction.message.accountKeys
要将这些概念付诸实践，请查看我们其他 Solana 教程 这里。
订阅我们的 新闻通讯 以获取更多关于 Solana 的文章和指南。如果你有任何反馈，欢迎通过 Twitter 与我们联系。你也可以在我们的 Discord 社区服务器与我们聊天，这里有一些你见过的最酷的开发者 :)
原文链接： quicknode.com/guides/sol...
登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～