@lightprotocol/stateless.js 0.17.2-alpha.2 → 0.19.0

package/dist/cjs/node/instruction/pack-compressed-accounts.d.ts

@@ -6,7 +6,22 @@ import { CompressedAccountWithMerkleContext } from '../state/compressed-account'
  * present
  * */
 export declare function getIndexOrAdd(accountsArray: PublicKey[], key: PublicKey): number;
-/** @internal */
+/**
+ * @internal
+ * Pads output state trees with the 0th state tree of the input state.
+ *
+ * @param outputStateMerkleTrees            Optional output state trees to be
+ *                                          inserted into the output state.
+ *                                          Defaults to the 0th state tree of
+ *                                          the input state. Gets padded to the
+ *                                          length of outputCompressedAccounts.
+ * @param numberOfOutputCompressedAccounts  The number of output compressed
+ *                                          accounts.
+ * @param inputCompressedAccountsWithMerkleContext The input compressed accounts
+ *                                          with merkle context.
+ *
+ * @returns Padded output state trees.
+ */
 export declare function padOutputStateMerkleTrees(outputStateMerkleTrees: PublicKey[] | PublicKey | undefined, numberOfOutputCompressedAccounts: number, inputCompressedAccountsWithMerkleContext: CompressedAccountWithMerkleContext[]): PublicKey[];
 export declare function toAccountMetas(remainingAccounts: PublicKey[]): AccountMeta[];
 /**
@@ -14,6 +29,7 @@ export declare function toAccountMetas(remainingAccounts: PublicKey[]): AccountM
  *
  * Replaces PublicKey with index pointer to remaining accounts.
  *
+ *
  * @param inputCompressedAccounts           Ix input state to be consumed
  * @param inputStateRootIndices             The recent state root indices of the
  *                                          input state. The expiry is tied to

package/dist/cjs/node/rpc.d.ts

@@ -3,6 +3,8 @@ import { Buffer } from 'buffer';
 import { CompressedProofWithContext, CompressedTransaction, CompressionApiInterface, GetCompressedTokenAccountsByOwnerOrDelegateOptions, HexInputsForProver, ParsedTokenAccount, SignatureWithMetadata, LatestNonVotingSignatures, LatestNonVotingSignaturesPaginated, WithContext, GetCompressedAccountsByOwnerConfig, WithCursor, AddressWithTree, HashWithTree, CompressedMintTokenHolders, TokenBalance, PaginatedOptions } from './rpc-interface';
 import { MerkleContextWithMerkleProof, BN254, CompressedAccountWithMerkleContext, CompressedProof } from './state';
 import BN from 'bn.js';
+import { LightWasm } from './test-helpers';
+import { ActiveStateTreeAddresses } from './utils/get-light-state-tree-info';
 /** @internal */
 export declare function parseAccountData({ discriminator, data, dataHash, }: {
     discriminator: BN;
@@ -60,23 +62,57 @@ export type NonInclusionJsonStruct = {
 };
 export declare function convertMerkleProofsWithContextToHex(merkleProofsWithContext: MerkleContextWithMerkleProof[]): HexInputsForProver[];
 export declare function convertNonInclusionMerkleProofInputsToHex(nonInclusionMerkleProofInputs: MerkleContextWithNewAddressProof[]): NonInclusionJsonStruct[];
-import { LightWasm } from './test-helpers';
 export declare function getPublicInputHash(accountProofs: MerkleContextWithMerkleProof[], accountHashes: BN254[], newAddressProofs: MerkleContextWithNewAddressProof[], lightWasm: LightWasm): BN;
+/**
+ * Get the queue for a given tree
+ *
+ * @param info - The active state tree addresses
+ * @param tree - The tree to get the queue for
+ * @returns The queue for the given tree, or undefined if not found
+ */
+export declare function getQueueForTree(info: ActiveStateTreeAddresses, tree: PublicKey): PublicKey;
+/**
+ * Get the tree for a given queue
+ *
+ * @param info - The active state tree addresses
+ * @param queue - The queue to get the tree for
+ * @returns The tree for the given queue, or undefined if not found
+ */
+export declare function getTreeForQueue(info: ActiveStateTreeAddresses, queue: PublicKey): PublicKey;
+/**
+ * Get a random tree and queue from the active state tree addresses.
+ *
+ * Prevents write lock contention on state trees.
+ *
+ * @param info - The active state tree addresses
+ * @returns A random tree and queue
+ */
+export declare function pickRandomTreeAndQueue(info: ActiveStateTreeAddresses): {
+    tree: PublicKey;
+    queue: PublicKey;
+};
 /**
  *
  */
 export declare class Rpc extends Connection implements CompressionApiInterface {
     compressionApiEndpoint: string;
     proverEndpoint: string;
+    activeStateTreeInfo: ActiveStateTreeAddresses | null;
+    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
+    constructor(endpoint: string, compressionApiEndpoint: string, proverEndpoint: string, config?: ConnectionConfig);
     /**
-     * Establish a Compression-compatible JSON RPC connection
-     *
-     * @param endpoint                      Endpoint to the solana cluster
-     * @param compressionApiEndpoint        Endpoint to the compression server
-     * @param proverEndpoint                Endpoint to the prover server.
-     * @param connectionConfig              Optional connection config
+     * Manually set state tree addresses
      */
-    constructor(endpoint: string, compressionApiEndpoint: string, proverEndpoint: string, config?: ConnectionConfig);
+    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    /**
+     * Get the active state tree addresses from the cluster.
+     * If not already cached, fetches from the cluster.
+     */
+    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    /**
+     * Fetch the latest state tree addresses from the cluster.
+     */
+    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
     /**
      * Fetch the compressed account for the specified account address or hash
      */
@@ -226,6 +262,10 @@ export declare class Rpc extends Connection implements CompressionApiInterface {
      */
     getValidityProofDirect(hashes?: BN254[], newAddresses?: BN254[]): Promise<CompressedProofWithContext>;
     /**
+     * @deprecated use {@link getValidityProofV0} instead.
+     *
+     *
+     *
      * Fetch the latest validity proof for (1) compressed accounts specified by
      * an array of account hashes. (2) new unique addresses specified by an
      * array of addresses.

package/dist/cjs/node/test-helpers/index.d.ts

@@ -1,2 +1,3 @@
 export * from './merkle-tree';
 export * from './test-rpc';
+export * from './test-utils';

package/dist/cjs/node/test-helpers/test-rpc/test-rpc.d.ts

@@ -4,6 +4,7 @@ import { AddressWithTree, CompressedMintTokenHolders, CompressedTransaction, Get
 import { CompressedProofWithContext, CompressionApiInterface, GetCompressedTokenAccountsByOwnerOrDelegateOptions, ParsedTokenAccount, TokenBalance } from '../../rpc-interface';
 import { BN254, CompressedAccountWithMerkleContext, MerkleContextWithMerkleProof } from '../../state';
 import { MerkleContextWithNewAddressProof } from '../../rpc';
+import { ActiveStateTreeAddresses } from '../../utils/get-light-state-tree-info';
 export interface TestRpcConfig {
     /**
      * Address of the state tree to index. Default: public default test state
@@ -74,6 +75,8 @@ export declare class TestRpc extends Connection implements CompressionApiInterfa
     lightWasm: LightWasm;
     depth: number;
     log: boolean;
+    activeStateTreeInfo: ActiveStateTreeAddresses | null;
+    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
     /**
      * Establish a Compression-compatible JSON RPC mock-connection
      *
@@ -87,6 +90,18 @@ export declare class TestRpc extends Connection implements CompressionApiInterfa
      * @param testRpcConfig             Config for the mock rpc
      */
     constructor(endpoint: string, hasher: LightWasm, compressionApiEndpoint: string, proverEndpoint: string, connectionConfig?: ConnectionConfig, testRpcConfig?: TestRpcConfig);
+    /**
+     * Manually set state tree addresses
+     */
+    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    /**
+     * Returns local test state trees.
+     */
+    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    /**
+     * Returns local test state trees.
+     */
+    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
     /**
      * Fetch the compressed account for the specified account hash
      */

package/dist/cjs/node/utils/get-light-state-tree-info.d.ts

@@ -0,0 +1,74 @@
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+/**
+ * Create two lookup tables storing all public state tree and queue addresses
+ * returns lookup table addresses and txId
+ *
+ * @internal
+ * @param connection - Connection to the Solana network
+ * @param payer - Keypair of the payer
+ * @param authority - Keypair of the authority
+ * @param recentSlot - Slot of the recent block
+ */
+export declare function createStateTreeLookupTable({ connection, payer, authority, recentSlot, }: {
+    connection: Connection;
+    payer: Keypair;
+    authority: Keypair;
+    recentSlot: number;
+}): Promise<{
+    address: PublicKey;
+    txId: string;
+}>;
+/**
+ * Extend state tree lookup table with new state tree and queue addresses
+ * @internal
+ * @param connection - Connection to the Solana network
+ * @param tableAddress - Address of the lookup table to extend
+ * @param newStateTreeAddresses - Addresses of the new state trees to add
+ * @param newQueueAddresses - Addresses of the new queues to add
+ * @param payer - Keypair of the payer
+ * @param authority - Keypair of the authority
+ */
+export declare function extendStateTreeLookupTable({ connection, tableAddress, newStateTreeAddresses, newQueueAddresses, payer, authority, }: {
+    connection: Connection;
+    tableAddress: PublicKey;
+    newStateTreeAddresses: PublicKey[];
+    newQueueAddresses: PublicKey[];
+    payer: Keypair;
+    authority: Keypair;
+}): Promise<{
+    tableAddress: PublicKey;
+    txId: string;
+}>;
+/**
+ * Adds full state tree address to lookup table. Acts as nullifier
+ * @internal
+ * @param connection - Connection to the Solana network
+ * @param stateTreeAddress - Address of the state tree to nullify
+ * @param nullifyTableAddress - Address nullifier lookup table to store address in
+ * @param stateTreeLookupTableAddress - lookup table storing all state tree addresses
+ * @param payer - Keypair of the payer
+ * @param authority - Keypair of the authority
+ */
+export declare function nullifyLookupTable({ connection, fullStateTreeAddress, nullifyTableAddress, stateTreeLookupTableAddress, payer, authority, }: {
+    connection: Connection;
+    fullStateTreeAddress: PublicKey;
+    nullifyTableAddress: PublicKey;
+    stateTreeLookupTableAddress: PublicKey;
+    payer: Keypair;
+    authority: Keypair;
+}): Promise<{
+    txId: string;
+}>;
+export type ActiveStateTreeAddresses = {
+    activeStateTrees: PublicKey[];
+    activeQueues: PublicKey[];
+};
+/**
+ *  Get most recent , active state tree data
+ * we store in lookup table for each public state tree
+ */
+export declare function getLightStateTreeInfo({ connection, stateTreeLookupTableAddress, nullifyTableAddress, }: {
+    connection: Connection;
+    stateTreeLookupTableAddress: PublicKey;
+    nullifyTableAddress: PublicKey;
+}): Promise<ActiveStateTreeAddresses>;

package/dist/cjs/node/utils/index.d.ts

@@ -5,6 +5,6 @@ export * from './parse-validity-proof';
 export * from './pipe';
 export * from './send-and-confirm';
 export * from './sleep';
-export * from './test-utils';
 export * from './validation';
 export * from './calculate-compute-unit-price';
+export * from './get-light-state-tree-info';

package/dist/types/index.d.ts

@@ -193,36 +193,6 @@ declare function buildAndSignTx(instructions: TransactionInstruction[], payer: S
 
 declare function sleep(ms: number): Promise<void>;
 
-declare const ALICE: Keypair;
-declare const BOB: Keypair;
-declare const CHARLIE: Keypair;
-declare const DAVE: Keypair;
-/**
- * Deep comparison of two objects. Handles BN comparison correctly.
- *
- * @param ref - The reference object to compare.
- * @param val - The value object to compare.
- * @returns True if the objects are deeply equal, false otherwise.
- */
-declare function deepEqual(ref: any, val: any): boolean;
-/**
- * Create a new account and airdrop lamports to it
- *
- * @param rpc       connection to use
- * @param lamports  amount of lamports to airdrop
- * @param counter   counter to use for generating the keypair.
- *                  If undefined or >255, generates random keypair.
- */
-declare function newAccountWithLamports(rpc: Rpc, lamports?: number, counter?: number | undefined): Promise<Signer>;
-declare function getConnection(): Connection;
-/**
- * For use in tests.
- * Generate a unique keypair by passing in a counter <255. If no counter
- * is supplied, it uses and increments a global counter.
- * if counter > 255, generates random keypair
- */
-declare function getTestKeypair(counter?: number | undefined): Keypair;
-
 declare const validateSufficientBalance: (balance: BN) => void;
 declare const validateSameOwner: (compressedAccounts: CompressedAccount[] | CompressedAccountWithMerkleContext[]) => void;
 
@@ -234,6 +204,80 @@ declare const validateSameOwner: (compressedAccounts: CompressedAccount[] | Comp
  */
 declare function calculateComputeUnitPrice(targetLamports: number, computeUnits: number): number;
 
+/**
+ * Create two lookup tables storing all public state tree and queue addresses
+ * returns lookup table addresses and txId
+ *
+ * @internal
+ * @param connection - Connection to the Solana network
+ * @param payer - Keypair of the payer
+ * @param authority - Keypair of the authority
+ * @param recentSlot - Slot of the recent block
+ */
+declare function createStateTreeLookupTable({ connection, payer, authority, recentSlot, }: {
+    connection: Connection;
+    payer: Keypair;
+    authority: Keypair;
+    recentSlot: number;
+}): Promise<{
+    address: PublicKey;
+    txId: string;
+}>;
+/**
+ * Extend state tree lookup table with new state tree and queue addresses
+ * @internal
+ * @param connection - Connection to the Solana network
+ * @param tableAddress - Address of the lookup table to extend
+ * @param newStateTreeAddresses - Addresses of the new state trees to add
+ * @param newQueueAddresses - Addresses of the new queues to add
+ * @param payer - Keypair of the payer
+ * @param authority - Keypair of the authority
+ */
+declare function extendStateTreeLookupTable({ connection, tableAddress, newStateTreeAddresses, newQueueAddresses, payer, authority, }: {
+    connection: Connection;
+    tableAddress: PublicKey;
+    newStateTreeAddresses: PublicKey[];
+    newQueueAddresses: PublicKey[];
+    payer: Keypair;
+    authority: Keypair;
+}): Promise<{
+    tableAddress: PublicKey;
+    txId: string;
+}>;
+/**
+ * Adds full state tree address to lookup table. Acts as nullifier
+ * @internal
+ * @param connection - Connection to the Solana network
+ * @param stateTreeAddress - Address of the state tree to nullify
+ * @param nullifyTableAddress - Address nullifier lookup table to store address in
+ * @param stateTreeLookupTableAddress - lookup table storing all state tree addresses
+ * @param payer - Keypair of the payer
+ * @param authority - Keypair of the authority
+ */
+declare function nullifyLookupTable({ connection, fullStateTreeAddress, nullifyTableAddress, stateTreeLookupTableAddress, payer, authority, }: {
+    connection: Connection;
+    fullStateTreeAddress: PublicKey;
+    nullifyTableAddress: PublicKey;
+    stateTreeLookupTableAddress: PublicKey;
+    payer: Keypair;
+    authority: Keypair;
+}): Promise<{
+    txId: string;
+}>;
+type ActiveStateTreeAddresses = {
+    activeStateTrees: PublicKey[];
+    activeQueues: PublicKey[];
+};
+/**
+ *  Get most recent , active state tree data
+ * we store in lookup table for each public state tree
+ */
+declare function getLightStateTreeInfo({ connection, stateTreeLookupTableAddress, nullifyTableAddress, }: {
+    connection: Connection;
+    stateTreeLookupTableAddress: PublicKey;
+    nullifyTableAddress: PublicKey;
+}): Promise<ActiveStateTreeAddresses>;
+
 interface PackedCompressedAccountWithMerkleContext {
     compressedAccount: CompressedAccount;
     merkleContext: PackedMerkleContext;
@@ -1594,6 +1638,8 @@ declare class TestRpc extends Connection implements CompressionApiInterface {
     lightWasm: LightWasm;
     depth: number;
     log: boolean;
+    activeStateTreeInfo: ActiveStateTreeAddresses | null;
+    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
     /**
      * Establish a Compression-compatible JSON RPC mock-connection
      *
@@ -1607,6 +1653,18 @@ declare class TestRpc extends Connection implements CompressionApiInterface {
      * @param testRpcConfig             Config for the mock rpc
      */
     constructor(endpoint: string, hasher: LightWasm, compressionApiEndpoint: string, proverEndpoint: string, connectionConfig?: ConnectionConfig, testRpcConfig?: TestRpcConfig);
+    /**
+     * Manually set state tree addresses
+     */
+    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    /**
+     * Returns local test state trees.
+     */
+    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    /**
+     * Returns local test state trees.
+     */
+    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
     /**
      * Fetch the compressed account for the specified account hash
      */
@@ -1988,6 +2046,36 @@ declare function getCompressedTokenAccountsByOwnerTest(rpc: Rpc, owner: PublicKe
 declare function getCompressedTokenAccountsByDelegateTest(rpc: Rpc, delegate: PublicKey, mint: PublicKey): Promise<WithCursor<ParsedTokenAccount[]>>;
 declare function getCompressedTokenAccountByHashTest(rpc: Rpc, hash: BN): Promise<ParsedTokenAccount>;
 
+declare const ALICE: Keypair;
+declare const BOB: Keypair;
+declare const CHARLIE: Keypair;
+declare const DAVE: Keypair;
+/**
+ * Deep comparison of two objects. Handles BN comparison correctly.
+ *
+ * @param ref - The reference object to compare.
+ * @param val - The value object to compare.
+ * @returns True if the objects are deeply equal, false otherwise.
+ */
+declare function deepEqual(ref: any, val: any): boolean;
+/**
+ * Create a new account and airdrop lamports to it
+ *
+ * @param rpc       connection to use
+ * @param lamports  amount of lamports to airdrop
+ * @param counter   counter to use for generating the keypair.
+ *                  If undefined or >255, generates random keypair.
+ */
+declare function newAccountWithLamports(rpc: Rpc, lamports?: number, counter?: number | undefined): Promise<Signer>;
+declare function getConnection(): Connection;
+/**
+ * For use in tests.
+ * Generate a unique keypair by passing in a counter <255. If no counter
+ * is supplied, it uses and increments a global counter.
+ * if counter > 255, generates random keypair
+ */
+declare function getTestKeypair(counter?: number | undefined): Keypair;
+
 /** @internal */
 declare function parseAccountData({ discriminator, data, dataHash, }: {
     discriminator: BN;
@@ -2045,23 +2133,57 @@ type NonInclusionJsonStruct = {
 };
 declare function convertMerkleProofsWithContextToHex(merkleProofsWithContext: MerkleContextWithMerkleProof[]): HexInputsForProver[];
 declare function convertNonInclusionMerkleProofInputsToHex(nonInclusionMerkleProofInputs: MerkleContextWithNewAddressProof[]): NonInclusionJsonStruct[];
-
 declare function getPublicInputHash(accountProofs: MerkleContextWithMerkleProof[], accountHashes: BN254[], newAddressProofs: MerkleContextWithNewAddressProof[], lightWasm: LightWasm): BN;
+/**
+ * Get the queue for a given tree
+ *
+ * @param info - The active state tree addresses
+ * @param tree - The tree to get the queue for
+ * @returns The queue for the given tree, or undefined if not found
+ */
+declare function getQueueForTree(info: ActiveStateTreeAddresses, tree: PublicKey): PublicKey;
+/**
+ * Get the tree for a given queue
+ *
+ * @param info - The active state tree addresses
+ * @param queue - The queue to get the tree for
+ * @returns The tree for the given queue, or undefined if not found
+ */
+declare function getTreeForQueue(info: ActiveStateTreeAddresses, queue: PublicKey): PublicKey;
+/**
+ * Get a random tree and queue from the active state tree addresses.
+ *
+ * Prevents write lock contention on state trees.
+ *
+ * @param info - The active state tree addresses
+ * @returns A random tree and queue
+ */
+declare function pickRandomTreeAndQueue(info: ActiveStateTreeAddresses): {
+    tree: PublicKey;
+    queue: PublicKey;
+};
 /**
  *
  */
 declare class Rpc extends Connection implements CompressionApiInterface {
     compressionApiEndpoint: string;
     proverEndpoint: string;
+    activeStateTreeInfo: ActiveStateTreeAddresses | null;
+    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
+    constructor(endpoint: string, compressionApiEndpoint: string, proverEndpoint: string, config?: ConnectionConfig);
     /**
-     * Establish a Compression-compatible JSON RPC connection
-     *
-     * @param endpoint                      Endpoint to the solana cluster
-     * @param compressionApiEndpoint        Endpoint to the compression server
-     * @param proverEndpoint                Endpoint to the prover server.
-     * @param connectionConfig              Optional connection config
+     * Manually set state tree addresses
      */
-    constructor(endpoint: string, compressionApiEndpoint: string, proverEndpoint: string, config?: ConnectionConfig);
+    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    /**
+     * Get the active state tree addresses from the cluster.
+     * If not already cached, fetches from the cluster.
+     */
+    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    /**
+     * Fetch the latest state tree addresses from the cluster.
+     */
+    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
     /**
      * Fetch the compressed account for the specified account address or hash
      */
@@ -2211,6 +2333,10 @@ declare class Rpc extends Connection implements CompressionApiInterface {
      */
     getValidityProofDirect(hashes?: BN254[], newAddresses?: BN254[]): Promise<CompressedProofWithContext>;
     /**
+     * @deprecated use {@link getValidityProofV0} instead.
+     *
+     *
+     *
      * Fetch the latest validity proof for (1) compressed accounts specified by
      * an array of account hashes. (2) new unique addresses specified by an
      * array of addresses.
@@ -2352,7 +2478,22 @@ declare function transfer(rpc: Rpc, payer: Signer, lamports: number | BN, owner:
  * present
  * */
 declare function getIndexOrAdd(accountsArray: PublicKey[], key: PublicKey): number;
-/** @internal */
+/**
+ * @internal
+ * Pads output state trees with the 0th state tree of the input state.
+ *
+ * @param outputStateMerkleTrees            Optional output state trees to be
+ *                                          inserted into the output state.
+ *                                          Defaults to the 0th state tree of
+ *                                          the input state. Gets padded to the
+ *                                          length of outputCompressedAccounts.
+ * @param numberOfOutputCompressedAccounts  The number of output compressed
+ *                                          accounts.
+ * @param inputCompressedAccountsWithMerkleContext The input compressed accounts
+ *                                          with merkle context.
+ *
+ * @returns Padded output state trees.
+ */
 declare function padOutputStateMerkleTrees(outputStateMerkleTrees: PublicKey[] | PublicKey | undefined, numberOfOutputCompressedAccounts: number, inputCompressedAccountsWithMerkleContext: CompressedAccountWithMerkleContext[]): PublicKey[];
 declare function toAccountMetas(remainingAccounts: PublicKey[]): AccountMeta[];
 /**
@@ -2360,6 +2501,7 @@ declare function toAccountMetas(remainingAccounts: PublicKey[]): AccountMeta[];
  *
  * Replaces PublicKey with index pointer to remaining accounts.
  *
+ *
  * @param inputCompressedAccounts           Ix input state to be consumed
  * @param inputStateRootIndices             The recent state root indices of the
  *                                          input state. The expiry is tied to
@@ -2613,6 +2755,21 @@ declare const defaultStaticAccountsStruct: () => {
     accountCompressionAuthority: PublicKey;
     cpiSignatureAccount: null;
 };
+declare const defaultStateTreeLookupTables: () => {
+    mainnet: {
+        stateTreeLookupTable: PublicKey;
+        nullifyTable: PublicKey;
+    };
+    devnet: {
+        stateTreeLookupTable: PublicKey;
+        nullifyTable: PublicKey;
+    };
+};
+declare const isLocalTest: (url: string) => boolean;
+declare const localTestActiveStateTreeInfo: () => {
+    activeStateTrees: PublicKey[];
+    activeQueues: PublicKey[];
+};
 declare const defaultTestStateTreeAccounts: () => {
     nullifierQueue: PublicKey;
     merkleTree: PublicKey;
@@ -2620,10 +2777,20 @@ declare const defaultTestStateTreeAccounts: () => {
     addressTree: PublicKey;
     addressQueue: PublicKey;
 };
+declare const defaultTestStateTreeAccounts2: () => {
+    nullifierQueue2: PublicKey;
+    merkleTree2: PublicKey;
+};
+declare const stateTreeLookupTableMainnet = "ABwZ1gQYCrj74azGZvtSk6eBQ9PD7Ch1FCcETcjr9QcC";
+declare const nullifiedStateTreeLookupTableMainnet = "9cnE7YBEUQXDf7gbapCCnRR7cERYqac6ip1g1cfdF2nb";
+declare const stateTreeLookupTableDevnet = "zpuJRGT84P9nMzTwpBihvWrRwazj8caUJTya8JAVQnv";
+declare const nullifiedStateTreeLookupTableDevnet = "3rsYNhcaosPZcMrSiQubjbE3rTLuAYJQvSe78NCruqCB";
 declare const nullifierQueuePubkey = "nfq1NvQDJ2GEgnS8zt9prAe8rjjpAW1zFkrvZoBR148";
 declare const merkletreePubkey = "smt1NamzXdq4AMqS2fS2F1i5KTYPZRhoHgWx38d8WsT";
 declare const addressTree = "amt1Ayt45jfbdw5YSo7iz6WZxUmnZsQTYXy82hVwyC2";
 declare const addressQueue = "aq1S9z4reTSQAdgWHGD2zDaS39sjGrAxbR31vxJ2F4F";
+declare const merkleTree2Pubkey = "smt2rJAFdyJJupwMKAqTNAJwvjhmiZ4JYGZmbVRw1Ho";
+declare const nullifierQueue2Pubkey = "nfq2hgS7NYemXsFaFUCe3EMXSDSfnZnAe27jC6aPP1X";
 declare const confirmConfig: ConfirmOptions;
 declare const DEFAULT_MERKLE_TREE_HEIGHT = 26;
 declare const DEFAULT_MERKLE_TREE_ROOTS = 2800;
@@ -3745,9 +3912,13 @@ type LightSystemProgram = {
         {
             code: 6037;
             name: 'InvalidAddressTreeHeight';
+        },
+        {
+            code: 6038;
+            name: 'InvalidStateTreeHeight';
         }
     ];
 };
 declare const IDL: LightSystemProgram;
 
-export { ADDRESS_QUEUE_ROLLOVER_FEE, ADDRESS_TREE_NETWORK_FEE, ALICE, AccountProofResult, type AddressWithTree, type BN254, BOB, BalanceResult, CHARLIE, type ClientSubscriptionId, type CompressedAccount, type CompressedAccountData, CompressedAccountLayout, CompressedAccountResult, type CompressedAccountWithMerkleContext, CompressedAccountsByOwnerResult, type CompressedMintTokenHolders, CompressedMintTokenHoldersResult, type CompressedProof, type CompressedProofWithContext, CompressedTokenAccountResult, CompressedTokenAccountsByOwnerOrDelegateResult, type CompressedTransaction, CompressedTransactionResult, type CompressionApiInterface, CreateUtxoError, CreateUtxoErrorCode, DAVE, DEFAULT_MERKLE_TREE_HEIGHT, DEFAULT_MERKLE_TREE_ROOTS, DEFAULT_ZERO, type EventWithParsedTokenTlvData, FIELD_SIZE, type GetCompressedAccountConfig, type GetCompressedAccountsByOwnerConfig, type GetCompressedAccountsConfig, type GetCompressedAccountsFilter, type GetCompressedTokenAccountsByOwnerOrDelegateOptions, HIGHEST_ADDRESS_PLUS_ONE, HashError, HashErrorCode, type HashWithTree, HealthResult, type HexBatchInputsForProver, type HexInputsForProver, IDL, INVOKE_DISCRIMINATOR, IndexedArray, IndexedElement, IndexedElementBundle, type InputTokenDataWithContext, type InstructionDataInvoke, InstructionDataInvokeLayout, type LatestNonVotingSignatures, type LatestNonVotingSignaturesPaginated, LatestNonVotingSignaturesResult, LatestNonVotingSignaturesResultPaginated, LightSystemProgram$1 as LightSystemProgram, type LightSystemProgram as LightSystemProgramIDL, type LightWasm, LookupTableError, LookupTableErrorCode, MerkeProofResult, type MerkleContext, MerkleContextLayout, type MerkleContextWithMerkleProof, type MerkleContextWithNewAddressProof, MerkleTree, MerkleTreeError, MerkleTreeErrorCode, type MerkleTreeSequenceNumber, MultipleCompressedAccountsResult, MultipleMerkleProofsResult, NativeBalanceResult, type NewAddressParams, NewAddressParamsLayout, type NewAddressParamsPacked, NewAddressProofResult, type NonInclusionJsonStruct, type NonInclusionMerkleProofInputs, type OutputCompressedAccountWithPackedContext, type PackedCompressedAccountWithMerkleContext, type PackedMerkleContext, type PaginatedOptions, type ParsedTokenAccount, ProofError, ProofErrorCode, type PublicTransactionEvent, PublicTransactionEventLayout, type QueueIndex, Rpc, RpcError, RpcErrorCode, type RpcResult, type RpcResultError, type RpcResultSuccess, STATE_MERKLE_TREE_NETWORK_FEE, STATE_MERKLE_TREE_ROLLOVER_FEE, SelectInUtxosError, SelectInUtxosErrorCode, SignatureListResult, SignatureListWithCursorResult, type SignatureWithMetadata, SlotResult, TRANSACTION_MERKLE_TREE_ROLLOVER_THRESHOLD, TestRpc, type TestRpcConfig, type TokenBalance, TokenBalanceListResult, TokenBalanceListResultV2, TokenBalanceResult, type TokenData$1 as TokenData, TokenDataLayout, TokenDataResult, UTXO_MERGE_MAXIMUM, UTXO_MERGE_THRESHOLD, UtilsError, UtilsErrorCode, UtxoError, UtxoErrorCode, ValidityProofResult, type WithContext, type WithCursor, type WithRpcContext, accountCompressionProgram, addressQueue, addressTree, airdropSol, bn, bufToDecStr, buildAndSignTx, buildTx, byteArrayToKeypair, calculateComputeUnitPrice, checkValidityProofShape, compress, confirmConfig, confirmTransaction, confirmTx, convertMerkleProofsWithContextToHex, convertNonInclusionMerkleProofInputsToHex, createAccount, createAccountWithLamports, createBN254, createCompressedAccount, createCompressedAccountWithMerkleContext, createMerkleContext, createRpc, createRpcResult, decodeInstructionDataInvoke, decodePublicTransactionEvent, decompress, dedupeSigner, deepEqual, defaultStaticAccounts, defaultStaticAccountsStruct, defaultTestStateTreeAccounts, deriveAddress, deriveAddressSeed, encodeBN254toBase58, encodeInstructionDataInvoke, encodePublicTransactionEvent, getAccountCompressionAuthority, getCompressedTokenAccountByHashTest, getCompressedTokenAccounts, getCompressedTokenAccountsByDelegateTest, getCompressedTokenAccountsByOwnerTest, getConnection, getIndexOrAdd, getParsedEvents, getPublicInputHash, getRegisteredProgramPda, getTestKeypair, getTestRpc, hashToBn254FieldSizeBe, hashvToBn254FieldSizeBe, invokeAccountsLayout, type invokeAccountsLayoutParams, jsonRpcResult, jsonRpcResultAndContext, lightProgram, merkletreePubkey, negateAndCompressProof, newAccountWithLamports, noopProgram, nullifierQueuePubkey, packCompressedAccounts, packNewAddressParams, padOutputStateMerkleTrees, parseAccountData, parseEvents, parsePublicTransactionEventWithIdl, parseTokenLayoutWithIdl, pipe, placeholderValidityProof, proofFromJsonStruct, proverRequest, pushUniqueItems, rpcRequest, selectMinCompressedSolAccountsForTransfer, sendAndConfirmTx, sleep, sumUpLamports, toAccountMetas, toArray, toCamelCase, toHex, toUnixTimestamp, transfer, validateSameOwner, validateSufficientBalance };
+export { ADDRESS_QUEUE_ROLLOVER_FEE, ADDRESS_TREE_NETWORK_FEE, ALICE, AccountProofResult, type ActiveStateTreeAddresses, type AddressWithTree, type BN254, BOB, BalanceResult, CHARLIE, type ClientSubscriptionId, type CompressedAccount, type CompressedAccountData, CompressedAccountLayout, CompressedAccountResult, type CompressedAccountWithMerkleContext, CompressedAccountsByOwnerResult, type CompressedMintTokenHolders, CompressedMintTokenHoldersResult, type CompressedProof, type CompressedProofWithContext, CompressedTokenAccountResult, CompressedTokenAccountsByOwnerOrDelegateResult, type CompressedTransaction, CompressedTransactionResult, type CompressionApiInterface, CreateUtxoError, CreateUtxoErrorCode, DAVE, DEFAULT_MERKLE_TREE_HEIGHT, DEFAULT_MERKLE_TREE_ROOTS, DEFAULT_ZERO, type EventWithParsedTokenTlvData, FIELD_SIZE, type GetCompressedAccountConfig, type GetCompressedAccountsByOwnerConfig, type GetCompressedAccountsConfig, type GetCompressedAccountsFilter, type GetCompressedTokenAccountsByOwnerOrDelegateOptions, HIGHEST_ADDRESS_PLUS_ONE, HashError, HashErrorCode, type HashWithTree, HealthResult, type HexBatchInputsForProver, type HexInputsForProver, IDL, INVOKE_DISCRIMINATOR, IndexedArray, IndexedElement, IndexedElementBundle, type InputTokenDataWithContext, type InstructionDataInvoke, InstructionDataInvokeLayout, type LatestNonVotingSignatures, type LatestNonVotingSignaturesPaginated, LatestNonVotingSignaturesResult, LatestNonVotingSignaturesResultPaginated, LightSystemProgram$1 as LightSystemProgram, type LightSystemProgram as LightSystemProgramIDL, type LightWasm, LookupTableError, LookupTableErrorCode, MerkeProofResult, type MerkleContext, MerkleContextLayout, type MerkleContextWithMerkleProof, type MerkleContextWithNewAddressProof, MerkleTree, MerkleTreeError, MerkleTreeErrorCode, type MerkleTreeSequenceNumber, MultipleCompressedAccountsResult, MultipleMerkleProofsResult, NativeBalanceResult, type NewAddressParams, NewAddressParamsLayout, type NewAddressParamsPacked, NewAddressProofResult, type NonInclusionJsonStruct, type NonInclusionMerkleProofInputs, type OutputCompressedAccountWithPackedContext, type PackedCompressedAccountWithMerkleContext, type PackedMerkleContext, type PaginatedOptions, type ParsedTokenAccount, ProofError, ProofErrorCode, type PublicTransactionEvent, PublicTransactionEventLayout, type QueueIndex, Rpc, RpcError, RpcErrorCode, type RpcResult, type RpcResultError, type RpcResultSuccess, STATE_MERKLE_TREE_NETWORK_FEE, STATE_MERKLE_TREE_ROLLOVER_FEE, SelectInUtxosError, SelectInUtxosErrorCode, SignatureListResult, SignatureListWithCursorResult, type SignatureWithMetadata, SlotResult, TRANSACTION_MERKLE_TREE_ROLLOVER_THRESHOLD, TestRpc, type TestRpcConfig, type TokenBalance, TokenBalanceListResult, TokenBalanceListResultV2, TokenBalanceResult, type TokenData$1 as TokenData, TokenDataLayout, TokenDataResult, UTXO_MERGE_MAXIMUM, UTXO_MERGE_THRESHOLD, UtilsError, UtilsErrorCode, UtxoError, UtxoErrorCode, ValidityProofResult, type WithContext, type WithCursor, type WithRpcContext, accountCompressionProgram, addressQueue, addressTree, airdropSol, bn, bufToDecStr, buildAndSignTx, buildTx, byteArrayToKeypair, calculateComputeUnitPrice, checkValidityProofShape, compress, confirmConfig, confirmTransaction, confirmTx, convertMerkleProofsWithContextToHex, convertNonInclusionMerkleProofInputsToHex, createAccount, createAccountWithLamports, createBN254, createCompressedAccount, createCompressedAccountWithMerkleContext, createMerkleContext, createRpc, createRpcResult, createStateTreeLookupTable, decodeInstructionDataInvoke, decodePublicTransactionEvent, decompress, dedupeSigner, deepEqual, defaultStateTreeLookupTables, defaultStaticAccounts, defaultStaticAccountsStruct, defaultTestStateTreeAccounts, defaultTestStateTreeAccounts2, deriveAddress, deriveAddressSeed, encodeBN254toBase58, encodeInstructionDataInvoke, encodePublicTransactionEvent, extendStateTreeLookupTable, getAccountCompressionAuthority, getCompressedTokenAccountByHashTest, getCompressedTokenAccounts, getCompressedTokenAccountsByDelegateTest, getCompressedTokenAccountsByOwnerTest, getConnection, getIndexOrAdd, getLightStateTreeInfo, getParsedEvents, getPublicInputHash, getQueueForTree, getRegisteredProgramPda, getTestKeypair, getTestRpc, getTreeForQueue, hashToBn254FieldSizeBe, hashvToBn254FieldSizeBe, invokeAccountsLayout, type invokeAccountsLayoutParams, isLocalTest, jsonRpcResult, jsonRpcResultAndContext, lightProgram, localTestActiveStateTreeInfo, merkleTree2Pubkey, merkletreePubkey, negateAndCompressProof, newAccountWithLamports, noopProgram, nullifiedStateTreeLookupTableDevnet, nullifiedStateTreeLookupTableMainnet, nullifierQueue2Pubkey, nullifierQueuePubkey, nullifyLookupTable, packCompressedAccounts, packNewAddressParams, padOutputStateMerkleTrees, parseAccountData, parseEvents, parsePublicTransactionEventWithIdl, parseTokenLayoutWithIdl, pickRandomTreeAndQueue, pipe, placeholderValidityProof, proofFromJsonStruct, proverRequest, pushUniqueItems, rpcRequest, selectMinCompressedSolAccountsForTransfer, sendAndConfirmTx, sleep, stateTreeLookupTableDevnet, stateTreeLookupTableMainnet, sumUpLamports, toAccountMetas, toArray, toCamelCase, toHex, toUnixTimestamp, transfer, validateSameOwner, validateSufficientBalance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightprotocol/stateless.js",
-  "version": "0.17.2-alpha.2",
+  "version": "0.19.0",
   "description": "JavaScript API for Light & ZK Compression",
   "sideEffects": false,
   "main": "dist/cjs/node/index.cjs",
@@ -102,8 +102,9 @@
     "test:e2e:compress": "pnpm test-validator && vitest run tests/e2e/compress.test.ts --reporter=verbose",
     "test:e2e:test-rpc": "pnpm test-validator && vitest run tests/e2e/test-rpc.test.ts",
     "test:e2e:rpc-interop": "pnpm test-validator && vitest run tests/e2e/rpc-interop.test.ts",
+    "test:e2e:rpc-multi-trees": "pnpm test-validator && vitest run tests/e2e/rpc-multi-trees.test.ts",
     "test:e2e:browser": "pnpm playwright test",
-    "test:e2e:all": "pnpm test-validator && vitest run tests/e2e/test-rpc.test.ts && vitest run tests/e2e/compress.test.ts && vitest run tests/e2e/transfer.test.ts && vitest run tests/e2e/rpc-interop.test.ts",
+    "test:e2e:all": "pnpm test-validator && vitest run tests/e2e/test-rpc.test.ts && vitest run tests/e2e/compress.test.ts && vitest run tests/e2e/transfer.test.ts && vitest run tests/e2e/rpc-interop.test.ts && vitest run tests/e2e/rpc-multi-trees.test.ts && vitest run tests/e2e/layout.test.ts",
     "test:index": "vitest run tests/e2e/program.test.ts",
     "test:e2e:layout": "vitest run tests/e2e/layout.test.ts --reporter=verbose",
     "test:verbose": "vitest run --reporter=verbose",