Table Lookup Management

Table Lookup Manager — is the module responsible for automatic management of Address Lookup Tables (ALT) of the user. It works in conjunction with Pools Loader and provides full automation when adding new pools to the system.

---

1

Tracking new pools

Table Lookup Manager constantly monitors changes in the list of active pools received via Pools Loader. As soon as the system receives a new pool — the module responds automatically.

2

Obtaining accounts required for the swap

For each new pool Table Lookup Manager determines all accounts, that are required to execute a swap in this pool. This forms a complete list of required accounts for the specific pool.

3

Automatic addition to Lookup Table

After obtaining the list of accounts Table Lookup Manager:

1. Checks which of them are not yet in the user's Lookup Table.

2. Adds missing accounts to the table automatically.

3. The updated table instantly becomes available to all strategies (Backrun, Transaction Spam, etc.) that use these accounts when composing transactions.

---

Why are Lookup Tables needed?

In Solana a transaction is limited to 1232 bytes. Each address we add to a transaction takes up 32 bytes. If you want to send a transaction with a large number of pools or accounts (for example, for arbitrage between multiple pools), all addresses will physically not fit into the transaction.

Solution: Lookup Tables allow storing addresses separately. In the transaction, instead of the full address, an index (1 byte) to the address from the table is passed. Thus we:

• Reduce the transaction size and packet weight → speed up submission.

• Can include a large number of pools and accounts for complex strategies (for example, finding the best profit among many pools), not just two hypothetical pools.

Additionally: detailed documentation on Address Lookup Tables can be read in the official Solana documentation here.

Can you add other people's tables?

Yes, this can be configured in system.toml in the [TABLE_LOOKUP_STORAGE].

• CUSTOM_TABLE_ADDRESSES block — allows connecting pre-created tables. The system will automatically use all addresses from these tables together with the Table Lookup Manager.

Important: Table Lookup Manager continues to operate and automatically adds new accounts from pools that are not in the tables. Thus, you can use both your own and others' ALTs, and they will all be immediately available to strategies.

How to manage your tables: delete / close?

ALTs can be managed via the CLI to reclaim the rent funds allocated when creating and extending tables.

​CLI utilities:​

• Fetch Tables — shows all ALTs of your wallet and from system.toml.

• Deactivate Tables — deactivates selected tables.

• Close Tables — closes deactivated tables and returns the rent (~0.0583 SOL for a full table of 256 addresses).