Create Address Lookup Table

Summary

The mplx toolbox lut create command creates a new Solana Address Lookup Table (LUT) and, when addresses are provided, extends it in the same transaction.

• Derives the LUT address from the authority and a recent slot.
• Accepts an optional comma-separated list of public keys as initial entries.
• Defaults the authority to the current identity unless --authority is passed.
• Returns the LUT address and the transaction signature on success.

Quick Reference

The table below summarizes the command's syntax and defaults.

Basic Usage

Run the command with no arguments to create an empty LUT, or pass a comma-separated list of public keys to seed it.

# Create an empty LUT
mplx toolbox lut create

# Create a LUT with initial addresses
mplx toolbox lut create "<pubkey1>,<pubkey2>"

Arguments

The single positional argument is an optional comma-separated list of public keys.

• addresses (optional): Comma-separated list of public keys to include in the LUT.

Flags

Optional flags override the recent slot and authority defaults.

• --recentSlot <number>: Recent slot used to derive the LUT PDA. Defaults to the latest slot.
• --authority <pubkey>: Authority public key for the LUT. Defaults to the current identity.

Examples

These examples show empty, seeded, and custom-authority LUT creation.

mplx toolbox lut create
mplx toolbox lut create "11111111111111111111111111111111,TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
mplx toolbox lut create "11111111111111111111111111111111" --authority <authority-pubkey>

Output

On success the command prints the new LUT address and the transaction signature.

--------------------------------
Address Lookup Table Created
LUT Address: <lut_address>
Signature: <transaction_signature>
--------------------------------

Notes

• The LUT address is a PDA derived from the authority and recent slot.
• Use toolbox lut fetch to read back the contents.
• To remove a LUT, deactivate it first with toolbox lut deactivate, then close it with toolbox lut close.