@lightprotocol/stateless.js 0.19.0 → 0.20.1

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

@@ -4,7 +4,7 @@ import { CompressedProofWithContext, CompressedTransaction, CompressionApiInterf
 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';
+import { ActiveTreeBundle } from './state/types';
 /** @internal */
 export declare function parseAccountData({ discriminator, data, dataHash, }: {
     discriminator: BN;
@@ -70,7 +70,7 @@ export declare function getPublicInputHash(accountProofs: MerkleContextWithMerkl
  * @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;
+export declare function getQueueForTree(info: ActiveTreeBundle[], tree: PublicKey): PublicKey;
 /**
  * Get the tree for a given queue
  *
@@ -78,7 +78,7 @@ export declare function getQueueForTree(info: ActiveStateTreeAddresses, tree: Pu
  * @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;
+export declare function getTreeForQueue(info: ActiveTreeBundle[], queue: PublicKey): PublicKey;
 /**
  * Get a random tree and queue from the active state tree addresses.
  *
@@ -87,7 +87,7 @@ export declare function getTreeForQueue(info: ActiveStateTreeAddresses, queue: P
  * @param info - The active state tree addresses
  * @returns A random tree and queue
  */
-export declare function pickRandomTreeAndQueue(info: ActiveStateTreeAddresses): {
+export declare function pickRandomTreeAndQueue(info: ActiveTreeBundle[]): {
     tree: PublicKey;
     queue: PublicKey;
 };
@@ -97,22 +97,21 @@ export declare function pickRandomTreeAndQueue(info: ActiveStateTreeAddresses):
 export declare class Rpc extends Connection implements CompressionApiInterface {
     compressionApiEndpoint: string;
     proverEndpoint: string;
-    activeStateTreeInfo: ActiveStateTreeAddresses | null;
-    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
+    activeStateTreeInfo: ActiveTreeBundle[] | null;
     constructor(endpoint: string, compressionApiEndpoint: string, proverEndpoint: string, config?: ConnectionConfig);
     /**
      * Manually set state tree addresses
      */
-    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    setStateTreeInfo(info: ActiveTreeBundle[]): void;
     /**
      * Get the active state tree addresses from the cluster.
      * If not already cached, fetches from the cluster.
      */
-    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getCachedActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Fetch the latest state tree addresses from the cluster.
      */
-    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getLatestActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Fetch the compressed account for the specified account address or hash
      */

package/dist/cjs/node/state/types.d.ts

@@ -2,6 +2,30 @@ import BN from 'bn.js';
 import { PublicKey } from '@solana/web3.js';
 import { Buffer } from 'buffer';
 import { NewAddressParamsPacked } from '../utils';
+export declare enum TreeType {
+    /**
+     * v1 state merkle tree
+     */
+    State = 0,
+    /**
+     * v1 address merkle tree
+     */
+    Address = 1,
+    /**
+     * v2 state merkle tree
+     */
+    BatchedState = 2,
+    /**
+     * v2 address merkle tree
+     */
+    BatchedAddress = 3
+}
+export type ActiveTreeBundle = {
+    tree: PublicKey;
+    queue: PublicKey | null;
+    cpiContext: PublicKey | null;
+    treeType: TreeType;
+};
 export interface PackedCompressedAccountWithMerkleContext {
     compressedAccount: CompressedAccount;
     merkleContext: PackedMerkleContext;
@@ -73,6 +97,21 @@ export interface InstructionDataInvoke {
     compressOrDecompressLamports: BN | null;
     isCompress: boolean;
 }
+export interface InstructionDataInvokeCpi {
+    proof: CompressedProof | null;
+    inputCompressedAccountsWithMerkleContext: PackedCompressedAccountWithMerkleContext[];
+    outputCompressedAccounts: OutputCompressedAccountWithPackedContext[];
+    relayFee: BN | null;
+    newAddressParams: NewAddressParamsPacked[];
+    compressOrDecompressLamports: BN | null;
+    isCompress: boolean;
+    compressedCpiContext: CompressedCpiContext | null;
+}
+export interface CompressedCpiContext {
+    set_context: boolean;
+    first_set_context: boolean;
+    cpi_context_account_index: number;
+}
 export interface CompressedProof {
     a: number[];
     b: number[];

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

@@ -1,6 +1,7 @@
-import { ParsedTransactionWithMeta } from '@solana/web3.js';
+import { ParsedTransactionWithMeta, PublicKey } from '@solana/web3.js';
 import { Rpc } from '../../rpc';
 import { PublicTransactionEvent } from '../../state';
+import { Buffer } from 'buffer';
 type Deserializer<T> = (data: Buffer, tx: ParsedTransactionWithMeta) => T;
 /**
  * @internal
@@ -10,4 +11,5 @@ type Deserializer<T> = (data: Buffer, tx: ParsedTransactionWithMeta) => T;
 export declare function getParsedEvents(rpc: Rpc): Promise<PublicTransactionEvent[]>;
 export declare const parseEvents: <T>(indexerEventsTransactions: (ParsedTransactionWithMeta | null)[], deserializeFn: Deserializer<T>) => NonNullable<T>[];
 export declare const parsePublicTransactionEventWithIdl: (data: Buffer) => PublicTransactionEvent | null;
+export declare function parseLightTransaction(dataVec: Uint8Array[], accountKeys: PublicKey[][]): PublicTransactionEvent | null | undefined;
 export {};

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

@@ -4,7 +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';
+import { ActiveTreeBundle } from '../../state/types';
 export interface TestRpcConfig {
     /**
      * Address of the state tree to index. Default: public default test state
@@ -75,8 +75,7 @@ export declare class TestRpc extends Connection implements CompressionApiInterfa
     lightWasm: LightWasm;
     depth: number;
     log: boolean;
-    activeStateTreeInfo: ActiveStateTreeAddresses | null;
-    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
+    activeStateTreeInfo: ActiveTreeBundle[] | null;
     /**
      * Establish a Compression-compatible JSON RPC mock-connection
      *
@@ -93,15 +92,15 @@ export declare class TestRpc extends Connection implements CompressionApiInterfa
     /**
      * Manually set state tree addresses
      */
-    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    setStateTreeInfo(info: ActiveTreeBundle[]): void;
     /**
      * Returns local test state trees.
      */
-    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getCachedActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Returns local test state trees.
      */
-    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getLatestActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Fetch the compressed account for the specified account hash
      */

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

@@ -1,4 +1,5 @@
 import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+import { ActiveTreeBundle } from '../state/types';
 /**
  * Create two lookup tables storing all public state tree and queue addresses
  * returns lookup table addresses and txId
@@ -25,14 +26,16 @@ export declare function createStateTreeLookupTable({ connection, payer, authorit
  * @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 newCpiContextAddresses - Addresses of the new cpi contexts to add
  * @param payer - Keypair of the payer
  * @param authority - Keypair of the authority
  */
-export declare function extendStateTreeLookupTable({ connection, tableAddress, newStateTreeAddresses, newQueueAddresses, payer, authority, }: {
+export declare function extendStateTreeLookupTable({ connection, tableAddress, newStateTreeAddresses, newQueueAddresses, newCpiContextAddresses, payer, authority, }: {
     connection: Connection;
     tableAddress: PublicKey;
     newStateTreeAddresses: PublicKey[];
     newQueueAddresses: PublicKey[];
+    newCpiContextAddresses: PublicKey[];
     payer: Keypair;
     authority: Keypair;
 }): Promise<{
@@ -40,12 +43,15 @@ export declare function extendStateTreeLookupTable({ connection, tableAddress, n
     txId: string;
 }>;
 /**
- * Adds full state tree address to lookup table. Acts as nullifier
+ * Adds state tree address to lookup table. Acts as nullifier lookup for rolled
+ * over state trees.
  * @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 nullifyTableAddress - Address of the 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
  */
@@ -59,10 +65,6 @@ export declare function nullifyLookupTable({ connection, fullStateTreeAddress, n
 }): 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
@@ -71,4 +73,4 @@ export declare function getLightStateTreeInfo({ connection, stateTreeLookupTable
     connection: Connection;
     stateTreeLookupTableAddress: PublicKey;
     nullifyTableAddress: PublicKey;
-}): Promise<ActiveStateTreeAddresses>;
+}): Promise<ActiveTreeBundle[]>;

package/dist/types/index.d.ts

@@ -230,14 +230,16 @@ declare function createStateTreeLookupTable({ connection, payer, authority, rece
  * @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 newCpiContextAddresses - Addresses of the new cpi contexts to add
  * @param payer - Keypair of the payer
  * @param authority - Keypair of the authority
  */
-declare function extendStateTreeLookupTable({ connection, tableAddress, newStateTreeAddresses, newQueueAddresses, payer, authority, }: {
+declare function extendStateTreeLookupTable({ connection, tableAddress, newStateTreeAddresses, newQueueAddresses, newCpiContextAddresses, payer, authority, }: {
     connection: Connection;
     tableAddress: PublicKey;
     newStateTreeAddresses: PublicKey[];
     newQueueAddresses: PublicKey[];
+    newCpiContextAddresses: PublicKey[];
     payer: Keypair;
     authority: Keypair;
 }): Promise<{
@@ -245,12 +247,15 @@ declare function extendStateTreeLookupTable({ connection, tableAddress, newState
     txId: string;
 }>;
 /**
- * Adds full state tree address to lookup table. Acts as nullifier
+ * Adds state tree address to lookup table. Acts as nullifier lookup for rolled
+ * over state trees.
  * @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 nullifyTableAddress - Address of the 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
  */
@@ -264,10 +269,6 @@ declare function nullifyLookupTable({ connection, fullStateTreeAddress, nullifyT
 }): 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
@@ -276,8 +277,32 @@ declare function getLightStateTreeInfo({ connection, stateTreeLookupTableAddress
     connection: Connection;
     stateTreeLookupTableAddress: PublicKey;
     nullifyTableAddress: PublicKey;
-}): Promise<ActiveStateTreeAddresses>;
+}): Promise<ActiveTreeBundle[]>;
 
+declare enum TreeType {
+    /**
+     * v1 state merkle tree
+     */
+    State = 0,
+    /**
+     * v1 address merkle tree
+     */
+    Address = 1,
+    /**
+     * v2 state merkle tree
+     */
+    BatchedState = 2,
+    /**
+     * v2 address merkle tree
+     */
+    BatchedAddress = 3
+}
+type ActiveTreeBundle = {
+    tree: PublicKey;
+    queue: PublicKey | null;
+    cpiContext: PublicKey | null;
+    treeType: TreeType;
+};
 interface PackedCompressedAccountWithMerkleContext {
     compressedAccount: CompressedAccount;
     merkleContext: PackedMerkleContext;
@@ -349,6 +374,21 @@ interface InstructionDataInvoke {
     compressOrDecompressLamports: BN | null;
     isCompress: boolean;
 }
+interface InstructionDataInvokeCpi {
+    proof: CompressedProof | null;
+    inputCompressedAccountsWithMerkleContext: PackedCompressedAccountWithMerkleContext[];
+    outputCompressedAccounts: OutputCompressedAccountWithPackedContext[];
+    relayFee: BN | null;
+    newAddressParams: NewAddressParamsPacked[];
+    compressOrDecompressLamports: BN | null;
+    isCompress: boolean;
+    compressedCpiContext: CompressedCpiContext | null;
+}
+interface CompressedCpiContext {
+    set_context: boolean;
+    first_set_context: boolean;
+    cpi_context_account_index: number;
+}
 interface CompressedProof {
     a: number[];
     b: number[];
@@ -1052,9 +1092,9 @@ declare const NewAddressProofResult: Struct<{
  */
 declare const ValidityProofResult: Struct<{
     compressedProof: {
+        c: number[];
         a: number[];
         b: number[];
-        c: number[];
     };
     leafIndices: number[];
     leaves: BN[];
@@ -1063,9 +1103,9 @@ declare const ValidityProofResult: Struct<{
     merkleTrees: PublicKey[];
 }, {
     compressedProof: Struct<{
+        c: number[];
         a: number[];
         b: number[];
-        c: number[];
     }, {
         a: Struct<number[], Struct<number, null>>;
         b: Struct<number[], Struct<number, null>>;
@@ -1638,8 +1678,7 @@ declare class TestRpc extends Connection implements CompressionApiInterface {
     lightWasm: LightWasm;
     depth: number;
     log: boolean;
-    activeStateTreeInfo: ActiveStateTreeAddresses | null;
-    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
+    activeStateTreeInfo: ActiveTreeBundle[] | null;
     /**
      * Establish a Compression-compatible JSON RPC mock-connection
      *
@@ -1656,15 +1695,15 @@ declare class TestRpc extends Connection implements CompressionApiInterface {
     /**
      * Manually set state tree addresses
      */
-    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    setStateTreeInfo(info: ActiveTreeBundle[]): void;
     /**
      * Returns local test state trees.
      */
-    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getCachedActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Returns local test state trees.
      */
-    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getLatestActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Fetch the compressed account for the specified account hash
      */
@@ -2002,7 +2041,7 @@ declare class MerkleTree {
     static deserialize(data: any, hashFunction: (left: string, right: string) => string): any;
 }
 
-type Deserializer<T> = (data: Buffer, tx: ParsedTransactionWithMeta) => T;
+type Deserializer<T> = (data: Buffer$1, tx: ParsedTransactionWithMeta) => T;
 /**
  * @internal
  * Returns newest first.
@@ -2010,7 +2049,8 @@ type Deserializer<T> = (data: Buffer, tx: ParsedTransactionWithMeta) => T;
  * */
 declare function getParsedEvents(rpc: Rpc): Promise<PublicTransactionEvent[]>;
 declare const parseEvents: <T>(indexerEventsTransactions: (ParsedTransactionWithMeta | null)[], deserializeFn: Deserializer<T>) => NonNullable<T>[];
-declare const parsePublicTransactionEventWithIdl: (data: Buffer) => PublicTransactionEvent | null;
+declare const parsePublicTransactionEventWithIdl: (data: Buffer$1) => PublicTransactionEvent | null;
+declare function parseLightTransaction(dataVec: Uint8Array[], accountKeys: PublicKey[][]): PublicTransactionEvent | null | undefined;
 
 type TokenData = {
     mint: PublicKey;
@@ -2141,7 +2181,7 @@ declare function getPublicInputHash(accountProofs: MerkleContextWithMerkleProof[
  * @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;
+declare function getQueueForTree(info: ActiveTreeBundle[], tree: PublicKey): PublicKey;
 /**
  * Get the tree for a given queue
  *
@@ -2149,7 +2189,7 @@ declare function getQueueForTree(info: ActiveStateTreeAddresses, tree: PublicKey
  * @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;
+declare function getTreeForQueue(info: ActiveTreeBundle[], queue: PublicKey): PublicKey;
 /**
  * Get a random tree and queue from the active state tree addresses.
  *
@@ -2158,7 +2198,7 @@ declare function getTreeForQueue(info: ActiveStateTreeAddresses, queue: PublicKe
  * @param info - The active state tree addresses
  * @returns A random tree and queue
  */
-declare function pickRandomTreeAndQueue(info: ActiveStateTreeAddresses): {
+declare function pickRandomTreeAndQueue(info: ActiveTreeBundle[]): {
     tree: PublicKey;
     queue: PublicKey;
 };
@@ -2168,22 +2208,21 @@ declare function pickRandomTreeAndQueue(info: ActiveStateTreeAddresses): {
 declare class Rpc extends Connection implements CompressionApiInterface {
     compressionApiEndpoint: string;
     proverEndpoint: string;
-    activeStateTreeInfo: ActiveStateTreeAddresses | null;
-    fetchStateTreePromise: Promise<ActiveStateTreeAddresses> | null;
+    activeStateTreeInfo: ActiveTreeBundle[] | null;
     constructor(endpoint: string, compressionApiEndpoint: string, proverEndpoint: string, config?: ConnectionConfig);
     /**
      * Manually set state tree addresses
      */
-    setStateTreeInfo(info: ActiveStateTreeAddresses): void;
+    setStateTreeInfo(info: ActiveTreeBundle[]): void;
     /**
      * Get the active state tree addresses from the cluster.
      * If not already cached, fetches from the cluster.
      */
-    getCachedActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getCachedActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Fetch the latest state tree addresses from the cluster.
      */
-    getLatestActiveStateTreeInfo(): Promise<ActiveStateTreeAddresses>;
+    getLatestActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Fetch the compressed account for the specified account address or hash
      */
@@ -2722,7 +2761,9 @@ declare const MerkleContextLayout: buffer_layout.Layout<unknown>;
 declare const NewAddressParamsLayout: buffer_layout.Layout<unknown>;
 declare const InstructionDataInvokeLayout: Layout<InstructionDataInvoke>;
 declare function encodeInstructionDataInvoke(data: InstructionDataInvoke): Buffer$1;
+declare const InstructionDataInvokeCpiLayout: Layout<InstructionDataInvokeCpi>;
 declare function decodeInstructionDataInvoke(buffer: Buffer$1): InstructionDataInvoke;
+declare function decodeInstructionDataInvokeCpi(buffer: Buffer$1): InstructionDataInvokeCpi;
 type invokeAccountsLayoutParams = {
     feePayer: PublicKey;
     authority: PublicKey;
@@ -2738,10 +2779,27 @@ declare const invokeAccountsLayout: (accounts: invokeAccountsLayoutParams) => Ac
 declare const PublicTransactionEventLayout: Layout<PublicTransactionEvent>;
 declare function encodePublicTransactionEvent(data: PublicTransactionEvent): Buffer$1;
 declare function decodePublicTransactionEvent(buffer: Buffer$1): PublicTransactionEvent;
+declare const AppendNullifyCreateAddressInputsMetaLayout: buffer_layout.Layout<unknown>;
+declare const AppendLeavesInputLayout: buffer_layout.Layout<unknown>;
+declare const InsertNullifierInputLayout: buffer_layout.Layout<unknown>;
+declare const InsertAddressInputLayout: buffer_layout.Layout<unknown>;
+declare const MerkleTreeSequenceNumberLayout: buffer_layout.Layout<unknown>;
+declare function deserializeAppendNullifyCreateAddressInputsIndexer(buffer: Buffer$1): {
+    meta: unknown;
+    leaves: unknown[];
+    nullifiers: unknown[];
+    addresses: unknown[];
+    sequence_numbers: unknown[];
+    output_leaf_indices: number[];
+};
+declare function convertToPublicTransactionEvent(decoded: any, remainingAccounts: PublicKey[], invokeData: InstructionDataInvoke): PublicTransactionEvent;
 
 declare const FIELD_SIZE: BN;
 declare const HIGHEST_ADDRESS_PLUS_ONE: BN;
+declare const COMPUTE_BUDGET_PATTERN: number[];
 declare const INVOKE_DISCRIMINATOR: Buffer$1;
+declare const INVOKE_CPI_DISCRIMINATOR: Buffer$1;
+declare const INSERT_INTO_QUEUES_DISCRIMINATOR: Buffer$1;
 declare const noopProgram = "noopb9bkMVfRPU8AsbpTUg8AQkHtKwMYZiFUjNRtMmV";
 declare const lightProgram = "SySTEM1eSU2p4BGQfQpimFEWWSC1XDFeun3Nqzz3rT7";
 declare const accountCompressionProgram = "compr6CUsB5m2jS4Y3831ztGSTnDpnKJTKS95d64XVq";
@@ -2755,21 +2813,29 @@ declare const defaultStaticAccountsStruct: () => {
     accountCompressionAuthority: PublicKey;
     cpiSignatureAccount: null;
 };
+type StateTreeLUTPair = {
+    stateTreeLookupTable: PublicKey;
+    nullifyTable: PublicKey;
+};
+/**
+ * Returns the Default Public State Tree LUTs for Devnet and Mainnet-Beta.
+ */
 declare const defaultStateTreeLookupTables: () => {
-    mainnet: {
-        stateTreeLookupTable: PublicKey;
-        nullifyTable: PublicKey;
-    };
-    devnet: {
-        stateTreeLookupTable: PublicKey;
-        nullifyTable: PublicKey;
-    };
+    mainnet: StateTreeLUTPair[];
+    devnet: StateTreeLUTPair[];
 };
+/**
+ * @internal
+ */
 declare const isLocalTest: (url: string) => boolean;
-declare const localTestActiveStateTreeInfo: () => {
-    activeStateTrees: PublicKey[];
-    activeQueues: PublicKey[];
-};
+/**
+ * @internal
+ */
+declare const localTestActiveStateTreeInfo: () => ActiveTreeBundle[];
+/**
+ * Use only with Localnet testing.
+ * For public networks, fetch via {@link defaultStateTreeLookupTables} and {@link getLightStateTreeInfo}.
+ */
 declare const defaultTestStateTreeAccounts: () => {
     nullifierQueue: PublicKey;
     merkleTree: PublicKey;
@@ -2777,20 +2843,25 @@ declare const defaultTestStateTreeAccounts: () => {
     addressTree: PublicKey;
     addressQueue: PublicKey;
 };
+/**
+ * @internal testing only
+ */
 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 stateTreeLookupTableMainnet = "7i86eQs3GSqHjN47WdWLTCGMW6gde1q96G2EVnUyK2st";
+declare const nullifiedStateTreeLookupTableMainnet = "H9QD4u1fG7KmkAzn2tDXhheushxFe1EcrjGGyEFXeMqT";
+declare const stateTreeLookupTableDevnet = "8n8rH2bFRVA6cSGNDpgqcKHCndbFCT1bXxAQG89ejVsh";
+declare const nullifiedStateTreeLookupTableDevnet = "5dhaJLBjnVBQFErr8oiCJmcVsx3Zj6xDekGB2zULPsnP";
 declare const nullifierQueuePubkey = "nfq1NvQDJ2GEgnS8zt9prAe8rjjpAW1zFkrvZoBR148";
+declare const cpiContextPubkey = "cpi1uHzrEhBG733DoEJNgHCyRS3XmmyVNZx5fonubE4";
 declare const merkletreePubkey = "smt1NamzXdq4AMqS2fS2F1i5KTYPZRhoHgWx38d8WsT";
 declare const addressTree = "amt1Ayt45jfbdw5YSo7iz6WZxUmnZsQTYXy82hVwyC2";
 declare const addressQueue = "aq1S9z4reTSQAdgWHGD2zDaS39sjGrAxbR31vxJ2F4F";
 declare const merkleTree2Pubkey = "smt2rJAFdyJJupwMKAqTNAJwvjhmiZ4JYGZmbVRw1Ho";
 declare const nullifierQueue2Pubkey = "nfq2hgS7NYemXsFaFUCe3EMXSDSfnZnAe27jC6aPP1X";
+declare const cpiContext2Pubkey = "cpi2cdhkH5roePvcudTgUL8ppEBfTay1desGh8G8QxK";
 declare const confirmConfig: ConfirmOptions;
 declare const DEFAULT_MERKLE_TREE_HEIGHT = 26;
 declare const DEFAULT_MERKLE_TREE_ROOTS = 2800;
@@ -3921,4 +3992,6 @@ type LightSystemProgram = {
 };
 declare const IDL: LightSystemProgram;
 
-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 };
+declare const logger: any;
+
+export { ADDRESS_QUEUE_ROLLOVER_FEE, ADDRESS_TREE_NETWORK_FEE, ALICE, AccountProofResult, type ActiveTreeBundle, type AddressWithTree, AppendLeavesInputLayout, AppendNullifyCreateAddressInputsMetaLayout, type BN254, BOB, BalanceResult, CHARLIE, COMPUTE_BUDGET_PATTERN, type ClientSubscriptionId, type CompressedAccount, type CompressedAccountData, CompressedAccountLayout, CompressedAccountResult, type CompressedAccountWithMerkleContext, CompressedAccountsByOwnerResult, type CompressedCpiContext, 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, INSERT_INTO_QUEUES_DISCRIMINATOR, INVOKE_CPI_DISCRIMINATOR, INVOKE_DISCRIMINATOR, IndexedArray, IndexedElement, IndexedElementBundle, type InputTokenDataWithContext, InsertAddressInputLayout, InsertNullifierInputLayout, type InstructionDataInvoke, type InstructionDataInvokeCpi, InstructionDataInvokeCpiLayout, 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, MerkleTreeSequenceNumberLayout, 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, type StateTreeLUTPair, TRANSACTION_MERKLE_TREE_ROLLOVER_THRESHOLD, TestRpc, type TestRpcConfig, type TokenBalance, TokenBalanceListResult, TokenBalanceListResultV2, TokenBalanceResult, type TokenData$1 as TokenData, TokenDataLayout, TokenDataResult, TreeType, 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, convertToPublicTransactionEvent, cpiContext2Pubkey, cpiContextPubkey, createAccount, createAccountWithLamports, createBN254, createCompressedAccount, createCompressedAccountWithMerkleContext, createMerkleContext, createRpc, createRpcResult, createStateTreeLookupTable, decodeInstructionDataInvoke, decodeInstructionDataInvokeCpi, decodePublicTransactionEvent, decompress, dedupeSigner, deepEqual, defaultStateTreeLookupTables, defaultStaticAccounts, defaultStaticAccountsStruct, defaultTestStateTreeAccounts, defaultTestStateTreeAccounts2, deriveAddress, deriveAddressSeed, deserializeAppendNullifyCreateAddressInputsIndexer, 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, logger, merkleTree2Pubkey, merkletreePubkey, negateAndCompressProof, newAccountWithLamports, noopProgram, nullifiedStateTreeLookupTableDevnet, nullifiedStateTreeLookupTableMainnet, nullifierQueue2Pubkey, nullifierQueuePubkey, nullifyLookupTable, packCompressedAccounts, packNewAddressParams, padOutputStateMerkleTrees, parseAccountData, parseEvents, parseLightTransaction, 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.19.0",
+  "version": "0.20.1",
   "description": "JavaScript API for Light & ZK Compression",
   "sideEffects": false,
   "main": "dist/cjs/node/index.cjs",
@@ -45,10 +45,12 @@
     "buffer": "6.0.3",
     "buffer-layout": "^1.2.2",
     "camelcase": "^8.0.0",
+    "json-bigint": "^1.0.0",
     "superstruct": "2.0.2"
   },
   "devDependencies": {
     "@coral-xyz/anchor": "0.29.0",
+    "@coral-xyz/borsh": "^0.29.0",
     "@esbuild-plugins/node-globals-polyfill": "^0.2.3",
     "@lightprotocol/hasher.rs": "0.2.1",
     "@playwright/test": "^1.47.1",
@@ -80,6 +82,7 @@
     "tweetnacl": "1.0.3",
     "typescript": "^5.6.2",
     "vitest": "^2.1.1",
+    "winston": "^3.17.0",
     "@lightprotocol/programs": "0.3.0"
   },
   "nx": {
@@ -97,6 +100,7 @@
     "test": "pnpm test:unit:all && pnpm test:e2e:all",
     "test-all": "vitest run",
     "test:unit:all": "vitest run tests/unit --reporter=verbose",
+    "test:conversions": "vitest run tests/unit/utils/conversion.test.ts --reporter=verbose",
     "test-validator": "./../../cli/test_bin/run test-validator --prover-run-mode rpc",
     "test:e2e:transfer": "pnpm test-validator && vitest run tests/e2e/transfer.test.ts --reporter=verbose",
     "test:e2e:compress": "pnpm test-validator && vitest run tests/e2e/compress.test.ts --reporter=verbose",
@@ -104,9 +108,10 @@
     "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 && vitest run tests/e2e/rpc-multi-trees.test.ts && vitest run tests/e2e/layout.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 && vitest run tests/e2e/safe-conversion.test.ts",
     "test:index": "vitest run tests/e2e/program.test.ts",
     "test:e2e:layout": "vitest run tests/e2e/layout.test.ts --reporter=verbose",
+    "test:e2e:safe-conversion": "vitest run tests/e2e/safe-conversion.test.ts --reporter=verbose",
     "test:verbose": "vitest run --reporter=verbose",
     "test:testnet": "vitest run tests/e2e/testnet.test.ts --reporter=verbose",
     "pull-idls": "../../scripts/push-stateless-js-idls.sh && ../../scripts/push-compressed-token-idl.sh",