TL;DR

Solana 有多个可供使用的链上程序。使用这些程序的指令的时候，传入的数据需要满足程序自定义的格式。

概述

指令

在前面的章节中，我们使用 SystemProgram.transfer() 函数来创建和发送 Solana 指令。

然而，在使用非原生程序（non-native programs）时，您需要更结构化的创建与相应程序相匹配的指令。

通过 @solana/web3.js，您可以使用 TransactionInstruction 构造函数创建非原生指令。该构造函数使用的参数数据类型为 TransactionInstructionCtorFields。

export type TransactionInstructionCtorFields = {
  keys: Array<AccountMeta>;
  programId: PublicKey;
  data?: Buffer;
};

可以参考上一章所描述的交易包含指令，根据上面的定义，传递给 TransactionInstruction 构造函数的对象需要：

• AccountMeta 类型的账户数组
• 被调用程序的公钥
• 可选的 Buffer ，包含要传递给程序的数据。

我们现在将忽略 data 字段，并将在以后的课程中重新讨论它。

programId 字段很容易理解：它是与程序关联的公钥。您需要在调用该程序之前知道这一点，就像您向某人发送 SOL，需要提前知道这个人的公钥。

keys 数组需要更多解释。该数组中的每个对象代表一个在交易执行期间将被读取或写入的帐户。这意味着您需要了解正在调用的程序的行为，并确保提供数组中所有必要的帐户。

根据 AccountMeta 的定义，

export type AccountMeta = {
  pubkey: PublicKey;
  isSigner: boolean;
  isWritable: boolean;
};

keys 数组中的每个对象必须包含以下内容：

• pubkey - 帐户的公钥
• isSigner - 一个布尔值，表示该帐户是否是交易的签名者
• isWritable - 一个布尔值，表示在交易执行期间是否写入帐户

将所有这些放在一起，我们最终可能会得到如下所示的结果，其中先暂时忽略 data 字段：

const instruction = new web3.TransactionInstruction({
  keys: [
    {
      pubkey: programDataAccount,
      isSigner: false,
      isWritable: true,
    },
  ],
  programId,
});

const transaction = new web3.Transaction().add(instruction)

const signature = await web3.sendAndConfirmTransaction(
  connection,
  transaction,
  [payer],
);

console.log(`✅ Success! Transaction signature is: ${signature}`);

Solana 浏览器

区块链上的所有交易都可以在 Solana Explorer 上公开查看。例如，您可以获取上例中 sendAndConfirmTransaction() 返回的签名，在 Solana Explorer 中搜索该签名，然后查看：

• 交易时什么时候发生
• 它包含在哪个区块中
• 交易费
• 还有更多！

实验 - 为 ping 计数器程序写交易

我们将创建一个脚本来 ping 一个链上程序，每次 ping 时都会使计数器加一。该程序存在于 Solana Devnet 上，地址为 ChT1B39WKLS8qUrkLvFDXMhEJ4F1XZzwUNHUt4AU9aVa。该程序将其计数的数据存储在地址为 Ah9K7dQ8EHaZqcAsgBW8w37yN2eAy3koFmUn4x3CJtod 帐户，这个账户存储着计数器。

1. 基础脚手架

我们首先使用在介绍写入数据的文件夹和 .env 文件。

创建一个名为 send-ping-transaction.ts 的文件：

import * as web3 from "@solana/web3.js";
import "dotenv/config"
import base58 from "bs58";
import { getKeypairFromEnvironment, requestAndConfirmAirdropIfRequired } from "@solana-developers/helpers";

const payer = getKeypairFromEnvironment('SECRET_KEY')
const connection = new web3.Connection(web3.clusterApiUrl('devnet'))

const newBalance = await requestAndConfirmAirdropIfRequired(
  connection,
  payer.publicKey,
  1 * LAMPORTS_PER_SOL,
  0.5 * LAMPORTS_PER_SOL,
);

如果需要，这将连接到 Solana 并空投一些 Lamports。

2. Ping 程序

现在我们来谈谈 Ping 程序！为此，我们需要：

1. 创建交易
2. 创建指令
3. 添加指令到交易中
4. 发送交易。

请记住，这里最具挑战性的部分是在指令中包含正确的信息。我们知道我们正在调用的程序的地址 PING_PROGRAM_ADDRESS。我们还知道该程序将数据写入一个单独的帐户 PING_PROGRAM_DATA_ADDRESS，我们也知道该帐户的地址。让我们将这两个地址作为常量添加到文件顶部：

const PING_PROGRAM_ADDRESS = new web3.PublicKey('ChT1B39WKLS8qUrkLvFDXMhEJ4F1XZzwUNHUt4AU9aVa')
const PING_PROGRAM_DATA_ADDRESS =  new web3.PublicKey('Ah9K7dQ8EHaZqcAsgBW8w37yN2eAy3koFmUn4x3CJtod')

现在让我们创建一个新交易，然后为程序帐户初始化一个 PublicKey，并为数据帐户初始化另一个。

const transaction = new web3.Transaction()
const programId = new web3.PublicKey(PING_PROGRAM_ADDRESS)
const pingProgramDataId = new web3.PublicKey(PING_PROGRAM_DATA_ADDRESS)

接下来，让我们创建指令。请记住，该指令需要包含 Ping 程序的公钥，还需要包含一个数组 kyes，其中包含将读取或写入的所有帐户。在此示例程序中，仅需要上面引用的数据帐户。

const transaction = new web3.Transaction()

const programId = new web3.PublicKey(PING_PROGRAM_ADDRESS)
const pingProgramDataId = new web3.PublicKey(PING_PROGRAM_DATA_ADDRESS)

const instruction = new web3.TransactionInstruction({
  keys: [
    {
      pubkey: pingProgramDataId,
      isSigner: false,
      isWritable: true
    },
  ],
  programId
})

接下来，让我们将指令添加到我们创建的交易中。然后，通过传入连接、交易和付款人来调用 sendAndConfirmTransaction()。最后，让我们 log 该函数调用的结果，以便我们可以在 Solana Explorer 上查找它。

transaction.add(instruction)

const signature = await web3.sendAndConfirmTransaction(
  connection,
  transaction,
  [payer]
)

console.log(`✅ Transaction completed! Signature is ${signature}`)

3. 运行 ping 客户端并检查 Solana 浏览器

现在再次运行代码。

npx esrun send-ping-transaction.ts

这可能需要等待一会儿，现在代码应该可以运行，并且您应该看到一个长字符串打印到控制台，如下所示：

✅ Transaction completed! Signature is 55S47uwMJprFMLhRSewkoUuzUs5V6BpNfRx21MpngRUQG3AswCzCSxvQmS3WEPWDJM7bhHm3bYBrqRshj672cUSG

复制交易签名。打开浏览器并转到 https://explorer.solana.com/?cluster=devnet（URL 末尾的查询参数将确保您将在 Devnet 而不是 Mainnet 上查找交易）。将签名粘贴到 Solana Devnet 浏览器顶部的搜索栏中，然后按 Enter 键。您应该看到有关交易的所有详细信息。如果您一直滚动到底部，那么您将看到 Program Logs，其中显示程序已被 ping 的次数，包括您的 ping。

滚动浏览器并查看您所看到的内容：

• Account Input(s) 将包括：
  • 您 Fee Payer 地址，因交易而被扣除一部分 lamports
  • ping 程序的程序地址 Ah9K7dQ8EHaZqcAsgBW8w37yN2eAy3koFmUn4x3CJtod
  • ping 程序的数据地址 ChT1B39WKLS8qUrkLvFDXMhEJ4F1XZzwUNHUt4AU9aVa
• Instructions 部分将包含一条指令，其指令的 Instruction Data (Hex) 显示 No data，ping 程序是一个非常简单的程序，因此它不需要传入任何数据。
• Program Instruction Logs 显示来自 ping 程序的日志。

如果您希望将来能够更轻松地在 Solana Explorer 中查看交易，只需将 console.log 更改为以下内容即可：

console.log(`You can view your transaction on the Solana Explorer at:\nhttps://explorer.solana.com/tx/${signature}?cluster=devnet`)

就像这样，您可以调用 Solana 网络上的程序并将数据写入链！

在接下来的几节课程中，您将学习如何

1. 使用浏览器安全地发起交易，而不是通过运行脚本
2. 将自定义数据添加到您的指令中
3. 反序列化链上数据

挑战

继续从头开始创建一个脚本，该脚本将允许您将 SOL 从 Devnet 上的一个帐户转移到另一个帐户。请务必打印出交易签名，以便您可以在 Solana Explorer 上查看它。

如果您遇到困难，请随时查看解决方案代码。

完成实验了吗？

将您的代码推送到 GitHub 并告诉我们您对本课程的看法！---

description: "本课程是 Solana Development Course(https://www.soldev.app/course) 中文翻译版" image: "https://ipfs.decert.me/bafkreidu54hnl4fcpdlfqcqpcd5blzmr3qfdhatadpqvqtmb6a4dhbofmy" sidebar_label: "为自定义链上程序创建交易"

title: 使用自定义的链上程序 objectives:

• 为自定义的链上程序创建交易

---

TL;DR

Solana 有多个可供使用的链上程序。使用这些程序的指令的时候，传入的数据需要满足程序自定义的格式。

概述

指令

在前面的章节中，我们使用 SystemProgram.transfer() 函数来创建和发送 Solana 指令。

然而，在使用非原生程序（non-native programs）时，您需要更结构化的创建与相应程序相匹配的指令。

通过 @solana/web3.js，您可以使用 TransactionInstruction 构造函数创建非原生指令。该构造函数使用的参数数据类型为 TransactionInstructionCtorFields。

export type TransactionInstructionCtorFields = {
  keys: Array<AccountMeta>;
  programId: PublicKey;
  data?: Buffer;
};

可以参考上一章所描述的交易包含指令，根据上面的定义，传递给 TransactionInstruction 构造函数的对象需要：

• AccountMeta 类型的账户数组
• 被调用程序的公钥
• 可选的 Buffer ，包含要传递给程序的数据。

我们现在将忽略 data 字段，并将在以后的课程中重新讨论它。

programId 字段很容易理解：它是与程序关联的公钥。您需要在调用该程序之前知道这一点，就像您向某人发送 SOL，需要提前知道这个人的公钥。

keys 数组需要更多解释。该数组中的每个对象代表一个在交易执行期间将被读取或写入的帐户。这意味着您需要了解正在调用的程序的行为，并确保提供数组中所有必要的帐户。

根据 AccountMeta 的定义，

export type AccountMeta = {
  pubkey: PublicKey;
  isSigner: boolean;
  isWritable: boolean;
};

keys 数组中的每个对象必须包含以下内容：

• pubkey - 帐户的公钥
• isSigner - 一个布尔值，表示该帐户是否是交易的签名者
• isWritable - 一个布尔值，表示在交易执行期间是否写入帐户

将所有这些放在一起，我们最终可能会得到如下所示的结果，其中先暂时忽略 data 字段：

const instruction = new web3.TransactionInstruction({
  keys: [
    {
      pubkey: programDataAccount,
      isSigner: false,
      isWritable: true,
    },
  ],
  programId,
});

const transaction = new web3.Transaction().add(instruction)

const signature = await web3.sendAndConfirmTransaction(
  connection,
  transaction,
  [payer],
);

console.log(`✅ Success! Transaction signature is: ${signature}`);

Solana 浏览器

区块链上的所有交易都可以在 Solana Explorer 上公开查看。例如，您可以获取上例中 sendAndConfirmTransaction() 返回的签名，在 Solana Explorer 中搜索该签名，然后查看：

• 交易时什么时候发生
• 它包含在哪个区块中
• 交易费
• 还有更多！

实验 - 为 ping 计数器程序写交易

我们将创建一个脚本来 ping 一个链上程序，每次 ping 时都会使计数器加一。该程序存在于 Solana Devnet 上，地址为 ChT1B39WKLS8qUrkLvFDXMhEJ4F1XZzwUNHUt4AU9aVa。该程序将其计数的数据存储在地址为 Ah9K7dQ8EHaZqcAsgBW8w37yN2eAy3koFmUn4x3CJtod 帐户，这个账户存储着计数器。

1. 基础脚手架

我们首先使用在介绍写入数据的文件夹和 .env 文件。

创建一个名为 send-ping-transaction.ts 的文件：

import * as web3 from "@solana/web3.js";
import "dotenv/config"
import base58 from "bs58";
import { getKeypairFromEnvironment, requestAndConfirmAirdropIfRequired } from "@solana-developers/helpers";

const payer = getKeypairFromEnvironment('SECRET_KEY')
const connection = new web3.Connection(web3.clusterApiUrl('devnet'))

const newBalance = await requestAndConfirmAirdropIfRequired(
  connection,
  payer.publicKey,
  1 * LAMPORTS_PER_SOL,
  0.5 * LAMPORTS_PER_SOL,
);

如果需要，这将连接到 Solana 并空投一些 Lamports。

2. Ping 程序

现在我们来谈谈 Ping 程序！为此，我们需要：

1. 创建交易
2. 创建指令
3. 添加指令到交易中
4. 发送交易。

请记住，这里最具挑战性的部分是在指令中包含正确的信息。我们知道我们正在调用的程序的地址 PING_PROGRAM_ADDRESS。我们还知道该程序将数据写入一个单独的帐户 PING_PROGRAM_DATA_ADDRESS，我们也知道该帐户的地址。让我们将这两个地址作为常量添加到文件顶部：

const PING_PROGRAM_ADDRESS = new web3.PublicKey('ChT1B39WKLS8qUrkLvFDXMhEJ4F1XZzwUNHUt4AU9aVa')
const PING_PROGRAM_DATA_ADDRESS =  new web3.PublicKey('Ah9K7dQ8EHaZqcAsgBW8w37yN2eAy3koFmUn4x3CJtod')

现在让我们创建一个新交易，然后为程序帐户初始化一个 PublicKey，并为数据帐户初始化另一个。

const transaction = new web3.Transaction()
const programId = new web3.PublicKey(PING_PROGRAM_ADDRESS)
const pingProgramDataId = new web3.PublicKey(PING_PROGRAM_DATA_ADDRESS)

接下来，让我们创建指令。请记住，该指令需要包含 Ping 程序的公钥，还需要包含一个数组 kyes，其中包含将读取或写入的所有帐户。在此示例程序中，仅需要上面引用的数据帐户。

const transaction = new web3.Transaction()

const programId = new web3.PublicKey(PING_PROGRAM_ADDRESS)
const pingProgramDataId = new web3.PublicKey(PING_PROGRAM_DATA_ADDRESS)

const instruction = new web3.TransactionInstruction({
  keys: [
    {
      pubkey: pingProgramDataId,
      isSigner: false,
      isWritable: true
    },
  ],
  programId
})

接下来，让我们将指令添加到我们创建的交易中。然后，通过传入连接、交易和付款人来调用 sendAndConfirmTransaction()。最后，让我们 log 该函数调用的结果，以便我们可以在 Solana Explorer 上查找它。

transaction.add(instruction)

const signature = await web3.sendAndConfirmTransaction(
  connection,
  transaction,
  [payer]
)

console.log(`✅ Transaction completed! Signature is ${signature}`)

3. 运行 ping 客户端并检查 Solana 浏览器

现在再次运行代码。

npx esrun send-ping-transaction.ts

这可能需要等待一会儿，现在代码应该可以运行，并且您应该看到一个长字符串打印到控制台，如下所示：

✅ Transaction completed! Signature is 55S47uwMJprFMLhRSewkoUuzUs5V6BpNfRx21MpngRUQG3AswCzCSxvQmS3WEPWDJM7bhHm3bYBrqRshj672cUSG

复制交易签名。打开浏览器并转到 https://explorer.solana.com/?cluster=devnet（URL 末尾的查询参数将确保您将在 Devnet 而不是 Mainnet 上查找交易）。将签名粘贴到 Solana Devnet 浏览器顶部的搜索栏中，然后按 Enter 键。您应该看到有关交易的所有详细信息。如果您一直滚动到底部，那么您将看到 Program Logs，其中显示程序已被 ping 的次数，包括您的 ping。

滚动浏览器并查看您所看到的内容：

• Account Input(s) 将包括：
  • 您 Fee Payer 地址，因交易而被扣除一部分 lamports
  • ping 程序的程序地址 Ah9K7dQ8EHaZqcAsgBW8w37yN2eAy3koFmUn4x3CJtod
  • ping 程序的数据地址 ChT1B39WKLS8qUrkLvFDXMhEJ4F1XZzwUNHUt4AU9aVa
• Instructions 部分将包含一条指令，其指令的 Instruction Data (Hex) 显示 No data，ping 程序是一个非常简单的程序，因此它不需要传入任何数据。
• Program Instruction Logs 显示来自 ping 程序的日志。

如果您希望将来能够更轻松地在 Solana Explorer 中查看交易，只需将 console.log 更改为以下内容即可：

console.log(`You can view your transaction on the Solana Explorer at:\nhttps://explorer.solana.com/tx/${signature}?cluster=devnet`)

就像这样，您可以调用 Solana 网络上的程序并将数据写入链！

在接下来的几节课程中，您将学习如何

1. 使用浏览器安全地发起交易，而不是通过运行脚本
2. 将自定义数据添加到您的指令中
3. 反序列化链上数据

挑战

继续从头开始创建一个脚本，该脚本将允许您将 SOL 从 Devnet 上的一个帐户转移到另一个帐户。请务必打印出交易签名，以便您可以在 Solana Explorer 上查看它。

如果您遇到困难，请随时查看解决方案代码。

完成实验了吗？

将您的代码推送到 GitHub 并告诉我们您对本课程的看法！