@lightprotocol/stateless.js 0.18.0 → 0.20.0

package/dist/cjs/browser/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;

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

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

package/dist/cjs/browser/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 { ActiveTreeBundle } from '../../state/types';
 export interface TestRpcConfig {
     /**
      * Address of the state tree to index. Default: public default test state
@@ -74,6 +75,7 @@ export declare class TestRpc extends Connection implements CompressionApiInterfa
     lightWasm: LightWasm;
     depth: number;
     log: boolean;
+    activeStateTreeInfo: ActiveTreeBundle[] | null;
     /**
      * Establish a Compression-compatible JSON RPC mock-connection
      *
@@ -87,6 +89,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: ActiveTreeBundle[]): void;
+    /**
+     * Returns local test state trees.
+     */
+    getCachedActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
+    /**
+     * Returns local test state trees.
+     */
+    getLatestActiveStateTreeInfo(): Promise<ActiveTreeBundle[]>;
     /**
      * Fetch the compressed account for the specified account hash
      */

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

@@ -0,0 +1,76 @@
+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
+ *
+ * @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 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, newCpiContextAddresses, payer, authority, }: {
+    connection: Connection;
+    tableAddress: PublicKey;
+    newStateTreeAddresses: PublicKey[];
+    newQueueAddresses: PublicKey[];
+    newCpiContextAddresses: PublicKey[];
+    payer: Keypair;
+    authority: Keypair;
+}): Promise<{
+    tableAddress: PublicKey;
+    txId: string;
+}>;
+/**
+ * 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 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
+ */
+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;
+}>;
+/**
+ *  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<ActiveTreeBundle[]>;

package/dist/cjs/browser/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/cjs/node/constants.d.ts

@@ -1,6 +1,7 @@
 import BN from 'bn.js';
 import { Buffer } from 'buffer';
 import { ConfirmOptions, PublicKey } from '@solana/web3.js';
+import { ActiveTreeBundle } from './state/types';
 export declare const FIELD_SIZE: BN;
 export declare const HIGHEST_ADDRESS_PLUS_ONE: BN;
 export declare const INVOKE_DISCRIMINATOR: Buffer;
@@ -17,6 +18,29 @@ export declare const defaultStaticAccountsStruct: () => {
     accountCompressionAuthority: PublicKey;
     cpiSignatureAccount: null;
 };
+export type StateTreeLUTPair = {
+    stateTreeLookupTable: PublicKey;
+    nullifyTable: PublicKey;
+};
+/**
+ * Returns the Default Public State Tree LUTs for Devnet and Mainnet-Beta.
+ */
+export declare const defaultStateTreeLookupTables: () => {
+    mainnet: StateTreeLUTPair[];
+    devnet: StateTreeLUTPair[];
+};
+/**
+ * @internal
+ */
+export declare const isLocalTest: (url: string) => boolean;
+/**
+ * @internal
+ */
+export declare const localTestActiveStateTreeInfo: () => ActiveTreeBundle[];
+/**
+ * Use only with Localnet testing.
+ * For public networks, fetch via {@link defaultStateTreeLookupTables} and {@link getLightStateTreeInfo}.
+ */
 export declare const defaultTestStateTreeAccounts: () => {
     nullifierQueue: PublicKey;
     merkleTree: PublicKey;
@@ -24,10 +48,25 @@ export declare const defaultTestStateTreeAccounts: () => {
     addressTree: PublicKey;
     addressQueue: PublicKey;
 };
+/**
+ * @internal testing only
+ */
+export declare const defaultTestStateTreeAccounts2: () => {
+    nullifierQueue2: PublicKey;
+    merkleTree2: PublicKey;
+};
+export declare const stateTreeLookupTableMainnet = "7i86eQs3GSqHjN47WdWLTCGMW6gde1q96G2EVnUyK2st";
+export declare const nullifiedStateTreeLookupTableMainnet = "H9QD4u1fG7KmkAzn2tDXhheushxFe1EcrjGGyEFXeMqT";
+export declare const stateTreeLookupTableDevnet = "8n8rH2bFRVA6cSGNDpgqcKHCndbFCT1bXxAQG89ejVsh";
+export declare const nullifiedStateTreeLookupTableDevnet = "5dhaJLBjnVBQFErr8oiCJmcVsx3Zj6xDekGB2zULPsnP";
 export declare const nullifierQueuePubkey = "nfq1NvQDJ2GEgnS8zt9prAe8rjjpAW1zFkrvZoBR148";
+export declare const cpiContextPubkey = "cpi1uHzrEhBG733DoEJNgHCyRS3XmmyVNZx5fonubE4";
 export declare const merkletreePubkey = "smt1NamzXdq4AMqS2fS2F1i5KTYPZRhoHgWx38d8WsT";
 export declare const addressTree = "amt1Ayt45jfbdw5YSo7iz6WZxUmnZsQTYXy82hVwyC2";
 export declare const addressQueue = "aq1S9z4reTSQAdgWHGD2zDaS39sjGrAxbR31vxJ2F4F";
+export declare const merkleTree2Pubkey = "smt2rJAFdyJJupwMKAqTNAJwvjhmiZ4JYGZmbVRw1Ho";
+export declare const nullifierQueue2Pubkey = "nfq2hgS7NYemXsFaFUCe3EMXSDSfnZnAe27jC6aPP1X";
+export declare const cpiContext2Pubkey = "cpi2cdhkH5roePvcudTgUL8ppEBfTay1desGh8G8QxK";
 export declare const confirmConfig: ConfirmOptions;
 export declare const DEFAULT_MERKLE_TREE_HEIGHT = 26;
 export declare const DEFAULT_MERKLE_TREE_ROOTS = 2800;

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

@@ -1009,6 +1009,10 @@ export type LightSystemProgram = {
         {
             code: 6037;
             name: 'InvalidAddressTreeHeight';
+        },
+        {
+            code: 6038;
+            name: 'InvalidStateTreeHeight';
         }
     ];
 };