写入网络

在上一节中,您学习了如何从 Solana 网络读取数据。现在,您将学习如何向其写入数据。向 Solana 网络写入数据涉及发送包含一个或多个指令的交易。

程序(智能合约)定义了每个指令的业务逻辑。当您提交交易时,Solana 运行时会按顺序并原子性地执行每个指令(这意味着要么所有指令成功,要么整个交易失败)。

本节涵盖以下示例:

  1. 在账户之间转移 SOL
  2. 创建新代币

这些示例展示了如何构建和发送交易以调用 Solana 程序。有关更多详细信息,请参阅 交易和指令Solana 上的费用 页面。

转移 SOL

在此示例中,您将学习如何在两个账户之间转移 SOL。

在 Solana 上,每个账户都有一个特定的程序作为其所有者。只有程序所有者可以扣除账户的 SOL(lamport)余额。

System Program 是所有“钱包”账户的 所有者。要转移 SOL,您必须调用 System Program 的 transfer 指令。

Transfer SOL
import {
LAMPORTS_PER_SOL,
SystemProgram,
Transaction,
sendAndConfirmTransaction,
Keypair,
Connection
} from "@solana/web3.js";
const connection = new Connection("http://localhost:8899", "confirmed");
const sender = new Keypair();
const receiver = new Keypair();
const signature = await connection.requestAirdrop(
sender.publicKey,
LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");
const transferInstruction = SystemProgram.transfer({
fromPubkey: sender.publicKey,
toPubkey: receiver.publicKey,
lamports: 0.01 * LAMPORTS_PER_SOL
});
const transaction = new Transaction().add(transferInstruction);
const transactionSignature = await sendAndConfirmTransaction(
connection,
transaction,
[sender]
);
console.log("Transaction Signature:", `${transactionSignature}`);
const senderBalance = await connection.getBalance(sender.publicKey);
const receiverBalance = await connection.getBalance(receiver.publicKey);
console.log("Sender Balance:", `${senderBalance}`);
console.log("Receiver Balance:", `${receiverBalance}`);
Console
Click to execute the code.

创建一个 Connection 来处理发送交易和获取账户数据。

在此示例中,我们连接到运行在 localhost:8899 上的本地测试验证器。

Connection
const connection = new Connection("http://localhost:8899", "confirmed");

生成新的 keypair,用作发送方和接收方账户。

一个 Keypair 包括:

  • 一个作为账户地址的公钥
  • 一个用于签署交易的私钥
Generate Keypairs
const sender = new Keypair();
const receiver = new Keypair();

在我们可以转账 SOL 之前,发送方账户需要有一些 SOL 余额。

在非主网的网络上,你可以使用 requestAirdrop 方法获取用于测试的 SOL。

Airdrop
const signature = await connection.requestAirdrop(
sender.publicKey,
LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

SystemProgram.transfer() 方法创建一个指令,用于将 SOL 从 fromPubkey 账户转移到 toPubkey 账户,转移的金额为指定的 lamports

Transfer Instruction
const transferInstruction = SystemProgram.transfer({
fromPubkey: sender.publicKey,
toPubkey: receiver.publicKey,
lamports: 0.01 * LAMPORTS_PER_SOL
});

创建一个交易并将指令添加到交易中。

在此示例中,我们创建了一个包含单个指令的交易。然而,您可以向一个交易中添加多个指令。

Transaction
const transaction = new Transaction().add(transferInstruction);

签署并发送 交易 到网络。

发送者 的 keypair 需要包含在签名者数组中,以授权从其账户转移 SOL。

Send Transaction
const transactionSignature = await sendAndConfirmTransaction(
connection,
transaction,
[sender]
);

交易签名是一个唯一标识符,可用于在 Solana Explorer 上查询交易。

创建一个 Connection 来处理发送交易和获取账户数据。

在此示例中,我们连接到运行在 localhost:8899 上的本地测试验证器。

Connection
const connection = new Connection("http://localhost:8899", "confirmed");

生成新的 keypair,用作发送方和接收方账户。

一个 Keypair 包括:

  • 一个作为账户地址的公钥
  • 一个用于签署交易的私钥
Generate Keypairs
const sender = new Keypair();
const receiver = new Keypair();

在我们可以转账 SOL 之前,发送方账户需要有一些 SOL 余额。

在非主网的网络上,你可以使用 requestAirdrop 方法获取用于测试的 SOL。

Airdrop
const signature = await connection.requestAirdrop(
sender.publicKey,
LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

SystemProgram.transfer() 方法创建一个指令,用于将 SOL 从 fromPubkey 账户转移到 toPubkey 账户,转移的金额为指定的 lamports

Transfer Instruction
const transferInstruction = SystemProgram.transfer({
fromPubkey: sender.publicKey,
toPubkey: receiver.publicKey,
lamports: 0.01 * LAMPORTS_PER_SOL
});

创建一个交易并将指令添加到交易中。

在此示例中,我们创建了一个包含单个指令的交易。然而,您可以向一个交易中添加多个指令。

Transaction
const transaction = new Transaction().add(transferInstruction);

签署并发送 交易 到网络。

发送者 的 keypair 需要包含在签名者数组中,以授权从其账户转移 SOL。

Send Transaction
const transactionSignature = await sendAndConfirmTransaction(
connection,
transaction,
[sender]
);

交易签名是一个唯一标识符,可用于在 Solana Explorer 上查询交易。

Transfer SOL
import {
LAMPORTS_PER_SOL,
SystemProgram,
Transaction,
sendAndConfirmTransaction,
Keypair,
Connection
} from "@solana/web3.js";
const connection = new Connection("http://localhost:8899", "confirmed");

创建一个代币

在此示例中,您将学习如何使用 Token Extensions Program 在 Solana 上创建一个新代币。这需要两个指令:

  1. 调用 System Program 创建一个新账户。
  2. 调用 Token Extensions Program 将该账户初始化为一个 Mint。
Create Mint Account
import {
Connection,
Keypair,
SystemProgram,
Transaction,
sendAndConfirmTransaction,
LAMPORTS_PER_SOL
} from "@solana/web3.js";
import {
MINT_SIZE,
TOKEN_2022_PROGRAM_ID,
createInitializeMint2Instruction,
getMinimumBalanceForRentExemptMint,
getMint
} from "@solana/spl-token";
const connection = new Connection("http://localhost:8899", "confirmed");
const wallet = new Keypair();
// Fund the wallet with SOL
const signature = await connection.requestAirdrop(
wallet.publicKey,
LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");
// Generate keypair to use as address of mint account
const mint = new Keypair();
// Calculate lamports required for rent exemption
const rentExemptionLamports =
await getMinimumBalanceForRentExemptMint(connection);
// Instruction to create new account with space for new mint account
const createAccountInstruction = SystemProgram.createAccount({
fromPubkey: wallet.publicKey,
newAccountPubkey: mint.publicKey,
space: MINT_SIZE,
lamports: rentExemptionLamports,
programId: TOKEN_2022_PROGRAM_ID
});
// Instruction to initialize mint account
const initializeMintInstruction = createInitializeMint2Instruction(
mint.publicKey,
2, // decimals
wallet.publicKey, // mint authority
wallet.publicKey, // freeze authority
TOKEN_2022_PROGRAM_ID
);
// Build transaction with instructions to create new account and initialize mint account
const transaction = new Transaction().add(
createAccountInstruction,
initializeMintInstruction
);
const transactionSignature = await sendAndConfirmTransaction(
connection,
transaction,
[
wallet, // payer
mint // mint address keypair
]
);
console.log("Transaction Signature:", `${transactionSignature}`);
const mintData = await getMint(
connection,
mint.publicKey,
"confirmed",
TOKEN_2022_PROGRAM_ID
);
);
Console
Click to execute the code.

为 mint account 生成一个 keypair。

此 keypair 的公钥将用作 mint account 的地址。

Mint Keypair
const mint = new Keypair();

计算 mint account 所需的最小 lamports。

getMinimumBalanceForRentExemptMint 函数精确计算出为 mint account 数据分配的 SOL(以 lamports 为单位)的数量。

Rent Exemption
const rentExemptionLamports =
await getMinimumBalanceForRentExemptMint(connection);

第一个指令调用 System Program 的 createAccount 指令以:

  1. 分配所需字节数 用于存储 mint 数据
  2. 从钱包转移 lamports 以资助新账户
  3. 将账户的所有权 分配给 Token Extensions Program (TOKEN_2022_PROGRAM_ID)
Create Account Instruction
const createAccountInstruction = SystemProgram.createAccount({
fromPubkey: wallet.publicKey,
newAccountPubkey: mint.publicKey,
space: MINT_SIZE,
lamports: rentExemptionLamports,
programId: TOKEN_2022_PROGRAM_ID
});

第二个指令调用 Token Extensions ProgramcreateInitializeMint2Instruction 指令,以以下数据初始化 mint account:

  • 2 位小数
  • 钱包 作为 mint authority 和 freeze authority
Initialize Mint Instruction
const initializeMintInstruction = createInitializeMint2Instruction(
mint.publicKey,
2,
wallet.publicKey,
wallet.publicKey,
TOKEN_2022_PROGRAM_ID
);

将两个指令添加到一个交易中。

通过将两个指令合并到一个交易中,可以确保账户创建和初始化是原子性操作。要么两个指令都成功,要么都失败。

这种方法在构建更复杂的 Solana 交易时很常见,因为它保证了所有指令一起执行。

Transaction
const transaction = new Transaction().add(
createAccountInstruction,
initializeMintInstruction
);

签署并发送交易。需要两个签名:

  • Wallet 作为交易费用和账户创建的付款方进行签名
  • Mint 签名以授权其地址用于新账户
Send Transaction
const transactionSignature = await sendAndConfirmTransaction(
connection,
transaction,
[
wallet,
mint
]
);

返回的交易签名可用于在 Solana Explorer 上检查交易。

为 mint account 生成一个 keypair。

此 keypair 的公钥将用作 mint account 的地址。

Mint Keypair
const mint = new Keypair();

计算 mint account 所需的最小 lamports。

getMinimumBalanceForRentExemptMint 函数精确计算出为 mint account 数据分配的 SOL(以 lamports 为单位)的数量。

Rent Exemption
const rentExemptionLamports =
await getMinimumBalanceForRentExemptMint(connection);

第一个指令调用 System Program 的 createAccount 指令以:

  1. 分配所需字节数 用于存储 mint 数据
  2. 从钱包转移 lamports 以资助新账户
  3. 将账户的所有权 分配给 Token Extensions Program (TOKEN_2022_PROGRAM_ID)
Create Account Instruction
const createAccountInstruction = SystemProgram.createAccount({
fromPubkey: wallet.publicKey,
newAccountPubkey: mint.publicKey,
space: MINT_SIZE,
lamports: rentExemptionLamports,
programId: TOKEN_2022_PROGRAM_ID
});

第二个指令调用 Token Extensions ProgramcreateInitializeMint2Instruction 指令,以以下数据初始化 mint account:

  • 2 位小数
  • 钱包 作为 mint authority 和 freeze authority
Initialize Mint Instruction
const initializeMintInstruction = createInitializeMint2Instruction(
mint.publicKey,
2,
wallet.publicKey,
wallet.publicKey,
TOKEN_2022_PROGRAM_ID
);

将两个指令添加到一个交易中。

通过将两个指令合并到一个交易中,可以确保账户创建和初始化是原子性操作。要么两个指令都成功,要么都失败。

这种方法在构建更复杂的 Solana 交易时很常见,因为它保证了所有指令一起执行。

Transaction
const transaction = new Transaction().add(
createAccountInstruction,
initializeMintInstruction
);

签署并发送交易。需要两个签名:

  • Wallet 作为交易费用和账户创建的付款方进行签名
  • Mint 签名以授权其地址用于新账户
Send Transaction
const transactionSignature = await sendAndConfirmTransaction(
connection,
transaction,
[
wallet,
mint
]
);

返回的交易签名可用于在 Solana Explorer 上检查交易。

Create Mint Account
import {
Connection,
Keypair,
SystemProgram,
Transaction,
sendAndConfirmTransaction,
LAMPORTS_PER_SOL
} from "@solana/web3.js";
import {
MINT_SIZE,
TOKEN_2022_PROGRAM_ID,
createInitializeMint2Instruction,
getMinimumBalanceForRentExemptMint,
getMint
} from "@solana/spl-token";
const connection = new Connection("http://localhost:8899", "confirmed");
const wallet = new Keypair();
const signature = await connection.requestAirdrop(
wallet.publicKey,
LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");
const mint = new Keypair();

Is this page helpful?

Table of Contents

Edit Page