地址查找表

地址查找表通常称为 “查找表” 或简称 “ALT”，允许开发人员创建相关地址的集合，以便在单个交易中有效地加载更多地址。

由于 Solana 区块链上的每笔交易都需要列出作为交易一部分进行交互的每个地址，这种列表实际上限制每笔交易 32 个地址。使用地址查找表的话，可以将限制提高到每笔交易 256 个地址。

压缩链上地址

将所有地址存储在链上地址查找表后，通过表中的 1 字节索引（而不是完整的 32 字节地址）在交易中引用每个地址。这种查找方法有效地将 32 字节地址 “压缩” 为 1 字节索引值。

版本化交易

在交易中使用地址查找表时，开发人员必须使用 Versioned Transaction format 引入的 v0 版本交易。

如何创建地址查找表

使用 @solana/web3.js 库创建新的查找表与legacy 交易类似，但有一些差异。

使用 @solana/web3.js 库的 createLookupTable 函数来构造创建新查找表所需的指令，并确定其地址：

const web3 = require("@solana/web3.js");

// 连接 RPC
const connection = new web3.Connection(web3.clusterApiUrl("devnet"));
// 获取slot
const slot = await connection.getSlot();

// 假设：
// `payer` 是一个有效的有足够的 SOL 来支付执行费用的 `Keypair`
const [lookupTableInst, lookupTableAddress] =
  web3.AddressLookupTableProgram.createLookupTable({
    authority: payer.publicKey,
    payer: payer.publicKey,
    recentSlot: slot,
  });

console.log("lookup table address:", lookupTableAddress.toBase58());

// 在链上创建地址查找表：
// 在交易中发送 `lookupTableInst` 指令

INFO

注意：地址查找表可以使用 v0 或 legacy 交易创建。但在使用 v0 版本交易时，Solana 运行时只能检索和处理查找表中的其他地址。

将地址添加到查找表

将地址添加到查找表称为 “extending”。使用 @solana/web3.js 库 的 extendLookupTable 方法创建新的扩展指令：

// 通过 “extend” 指令将地址添加到 “lookupTableAddress” 表
const extendInstruction = web3.AddressLookupTableProgram.extendLookupTable({
  payer: payer.publicKey,
  authority: payer.publicKey,
  lookupTable: lookupTableAddress,
  addresses: [
    payer.publicKey,
    web3.SystemProgram.programId,
    // 添加更多地址
  ],
});

// 在交易中将此 `extendInstruction` 发送到 rpc
// 将 `addresses` 列表插入到地址为 `lookupTableAddress` 的查找表中

INFO

注意：由于与 legacy 交易具有相同的内存限制，用于扩展地址查找表的交易也有每次可添加的地址数量的限制。因此，需要使用多个交易来扩展具有更多地址（~20）的任何表，这些地址可以适应单个交易的内存限制。

将这些地址插入表中并存储在链上，就能在交易中使用地址查找表。在交易中最多使用 256 个地址。

获取地址查找表

与从集群请求另一个帐户（或 PDA）类似，使用 getAddressLookupTable 方法获取完整的地址查找表：

// 定义要获取的查找表的 `PublicKey`
const lookupTableAddress = new web3.PublicKey("");

// 从链上获取表
const lookupTableAccount = (
  await connection.getAddressLookupTable(lookupTableAddress)
).value;

// `lookupTableAccount` 是一个 `AddressLookupTableAccount` 对象

console.log("Table address from cluster:", lookupTableAccount.key.toBase58());

lookupTableAccount 是一个 AddressLookupTableAccount 对象，可以解析它以读取查找表中链上存储的所有地址的列表：

// 循环解析地址查找表中的地址
for (let i = 0; i < lookupTableAccount.state.addresses.length; i++) {
  const address = lookupTableAccount.state.addresses[i];
  console.log(i, address.toBase58());
}

如何在交易中使用地址查找表

创建查找表并将地址存储在链上（通过扩展查找表）后，创建 v0 交易以利用链上查找功能。

就像 legacy 交易一样，创建在链上执行的所有交易指令。然后，将这些指令数组提供给 v0 交易中使用的消息。

INFO

注意：v0 交易的指令的构造方法就是构造指令的常见方法和函数, 涉及地址查找表的指令无需更改。

// 假设：
// - `arrayOfInstructions` 已被创建为 `TransactionInstruction` 的 `array`
// - 使用上面获得的 `lookupTableAccount`

// 构造一个v0 兼容交易`消息`
const messageV0 = new web3.TransactionMessage({
  payerKey: payer.publicKey,
  recentBlockhash: blockhash,
  instructions: arrayOfInstructions, // 注意这是一个指令数组
}).compileToV0Message([lookupTableAccount]);

// 根据 v0 消息创建 v0 交易
const transactionV0 = new web3.VersionedTransaction(messageV0);

// 使用名为“payer”的文件系统钱包签署 v0 交易
transactionV0.sign([payer]);

// 发送并确认交易
//（注意：这里没有签名者数组；请参阅下面的注释...）
const txid = await web3.sendAndConfirmTransaction(connection, transactionV0);

console.log(
  `Transaction: https://explorer.solana.com/tx/${txid}?cluster=devnet`
);

INFO

注意：将 VersionedTransaction 发送到集群时，必须在调用 sendAndConfirmTransaction 方法之前对其进行签名。传递签名者数组（和 legacy 交易一样）将触发错误！