@lightprotocol/stateless.js 0.21.0 → 0.22.1-alpha.0

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

@@ -0,0 +1,112 @@
+import { PublicKey, AccountMeta } from '@solana/web3.js';
+import { ValidityProof } from '../state/types';
+import { CompressedAccountMeta } from '../state/compressed-account';
+/**
+ * Standard instruction discriminators for compressible instructions
+ * These match the Rust implementation discriminators
+ */
+export declare const COMPRESSIBLE_DISCRIMINATORS: {
+    readonly INITIALIZE_COMPRESSION_CONFIG: readonly [133, 228, 12, 169, 56, 76, 222, 61];
+    readonly UPDATE_COMPRESSION_CONFIG: readonly [135, 215, 243, 81, 163, 146, 33, 70];
+    readonly DECOMPRESS_ACCOUNTS_IDEMPOTENT: readonly [114, 67, 61, 123, 234, 31, 1, 112];
+};
+/**
+ * Generic compressed account data structure for decompress operations
+ * This is generic over the account variant type, allowing programs to use their specific enums
+ */
+export type CompressedAccountData<T = any> = {
+    /** The compressed account metadata containing tree info, address, and output index */
+    meta: CompressedAccountMeta;
+    /** Program-specific account variant enum */
+    data: T;
+    /** PDA seeds (without bump) used to derive the PDA address */
+    seeds: Uint8Array[];
+};
+/**
+ * Instruction data structure for decompress_accounts_idempotent
+ * This matches the exact format expected by Anchor programs
+ */
+export type DecompressMultipleAccountsIdempotentData<T = any> = {
+    proof: ValidityProof;
+    compressedAccounts: CompressedAccountData<T>[];
+    bumps: number[];
+    systemAccountsOffset: number;
+};
+/**
+ * Instruction data for update compression config
+ */
+export type UpdateCompressionConfigData = {
+    newCompressionDelay: number | null;
+    newRentRecipient: PublicKey | null;
+    newAddressSpace: PublicKey[] | null;
+    newUpdateAuthority: PublicKey | null;
+};
+/**
+ * Generic instruction data for compress account
+ * This matches the expected format for compress account instructions
+ */
+export type GenericCompressAccountInstruction = {
+    proof: ValidityProof;
+    compressedAccountMeta: CompressedAccountMeta;
+};
+/**
+ * Existing CompressionConfigIxData type (re-exported for compatibility)
+ */
+export type CompressionConfigIxData = {
+    compressionDelay: number;
+    rentRecipient: PublicKey;
+    addressSpace: PublicKey[];
+    configBump: number | null;
+};
+/**
+ * Common instruction builder parameters
+ */
+export type InstructionBuilderParams = {
+    programId: PublicKey;
+    discriminator: Uint8Array | number[];
+};
+/**
+ * Initialize compression config instruction parameters
+ */
+export type InitializeCompressionConfigParams = InstructionBuilderParams & {
+    payer: PublicKey;
+    authority: PublicKey;
+    compressionDelay: number;
+    rentRecipient: PublicKey;
+    addressSpace: PublicKey[];
+    configBump?: number | null;
+};
+/**
+ * Update compression config instruction parameters
+ */
+export type UpdateCompressionConfigParams = InstructionBuilderParams & {
+    authority: PublicKey;
+    newCompressionDelay?: number | null;
+    newRentRecipient?: PublicKey | null;
+    newAddressSpace?: PublicKey[] | null;
+    newUpdateAuthority?: PublicKey | null;
+};
+/**
+ * Compress account instruction parameters
+ */
+export type CompressAccountParams = InstructionBuilderParams & {
+    payer: PublicKey;
+    pdaToCompress: PublicKey;
+    rentRecipient: PublicKey;
+    compressedAccountMeta: CompressedAccountMeta;
+    validityProof: ValidityProof;
+    systemAccounts?: AccountMeta[];
+};
+/**
+ * Decompress accounts idempotent instruction parameters
+ */
+export type DecompressAccountsIdempotentParams<T = any> = InstructionBuilderParams & {
+    feePayer: PublicKey;
+    rentPayer: PublicKey;
+    solanaAccounts: PublicKey[];
+    compressedAccountsData: CompressedAccountData<T>[];
+    bumps: number[];
+    validityProof: ValidityProof;
+    systemAccounts?: AccountMeta[];
+    dataSchema?: any;
+};

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

@@ -0,0 +1,16 @@
+import { Connection, PublicKey, AccountInfo } from '@solana/web3.js';
+/**
+ * Derive the compression config PDA address
+ */
+export declare function deriveCompressionConfigAddress(programId: PublicKey, configIndex?: number): [PublicKey, number];
+/**
+ * Get the program data account address and its raw data for a given program.
+ */
+export declare function getProgramDataAccount(programId: PublicKey, connection: Connection): Promise<{
+    programDataAddress: PublicKey;
+    programDataAccountInfo: AccountInfo<Buffer>;
+}>;
+/**
+ * Check that the provided authority matches the program's upgrade authority.
+ */
+export declare function checkProgramUpdateAuthority(programDataAccountInfo: AccountInfo<Buffer>, providedAuthority: PublicKey): void;

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

@@ -1,15 +1,36 @@
 import BN from 'bn.js';
 import { Buffer } from 'buffer';
 import { ConfirmOptions, PublicKey } from '@solana/web3.js';
-import { StateTreeInfo, TreeType } from './state/types';
+import { TreeInfo, TreeType } from './state/types';
+export declare enum VERSION {
+    V1 = "V1",
+    V2 = "V2"
+}
+/**
+/**
+ * @internal
+ * Feature flags. Only use if you know what you are doing.
+ */
+export declare const featureFlags: {
+    version: VERSION;
+    isV2: () => boolean;
+};
+/**
+ * Returns the correct endpoint name for the current API version. E.g.
+ * versionedEndpoint('getCompressedAccount') -> 'getCompressedAccount' (V1)
+ * or 'getCompressedAccountV2' (V2)
+ */
+export declare const versionedEndpoint: (base: string) => string;
 export declare const FIELD_SIZE: BN;
 export declare const HIGHEST_ADDRESS_PLUS_ONE: BN;
 export declare const COMPUTE_BUDGET_PATTERN: number[];
-export declare const INVOKE_DISCRIMINATOR: Buffer;
-export declare const INVOKE_CPI_DISCRIMINATOR: Buffer;
-export declare const INSERT_INTO_QUEUES_DISCRIMINATOR: Buffer;
+export declare const INVOKE_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare const INVOKE_CPI_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare const INVOKE_CPI_WITH_READ_ONLY_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare const INVOKE_CPI_WITH_ACCOUNT_INFO_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare const INSERT_INTO_QUEUES_DISCRIMINATOR: Buffer<ArrayBuffer>;
 export declare const noopProgram = "noopb9bkMVfRPU8AsbpTUg8AQkHtKwMYZiFUjNRtMmV";
-export declare const lightProgram = "SySTEM1eSU2p4BGQfQpimFEWWSC1XDFeun3Nqzz3rT7";
+export declare const lightSystemProgram = "SySTEM1eSU2p4BGQfQpimFEWWSC1XDFeun3Nqzz3rT7";
 export declare const accountCompressionProgram = "compr6CUsB5m2jS4Y3831ztGSTnDpnKJTKS95d64XVq";
 export declare const getRegisteredProgramPda: () => PublicKey;
 export declare const getAccountCompressionAuthority: () => PublicKey;
@@ -39,7 +60,7 @@ export declare const isLocalTest: (url: string) => boolean;
 /**
  * @internal
  */
-export declare const localTestActiveStateTreeInfo: () => StateTreeInfo[];
+export declare const localTestActiveStateTreeInfos: () => TreeInfo[];
 export declare const getDefaultAddressTreeInfo: () => {
     tree: PublicKey;
     queue: PublicKey;
@@ -77,9 +98,13 @@ export declare const cpiContextPubkey = "cpi1uHzrEhBG733DoEJNgHCyRS3XmmyVNZx5fon
 export declare const merkletreePubkey = "smt1NamzXdq4AMqS2fS2F1i5KTYPZRhoHgWx38d8WsT";
 export declare const addressTree = "amt1Ayt45jfbdw5YSo7iz6WZxUmnZsQTYXy82hVwyC2";
 export declare const addressQueue = "aq1S9z4reTSQAdgWHGD2zDaS39sjGrAxbR31vxJ2F4F";
+export declare const addressTreeV2: PublicKey;
 export declare const merkleTree2Pubkey = "smt2rJAFdyJJupwMKAqTNAJwvjhmiZ4JYGZmbVRw1Ho";
 export declare const nullifierQueue2Pubkey = "nfq2hgS7NYemXsFaFUCe3EMXSDSfnZnAe27jC6aPP1X";
 export declare const cpiContext2Pubkey = "cpi2cdhkH5roePvcudTgUL8ppEBfTay1desGh8G8QxK";
+export declare const batchMerkleTree = "HLKs5NJ8FXkJg8BrzJt56adFYYuwg5etzDtBbQYTsixu";
+export declare const batchQueue = "6L7SzhYB3anwEQ9cphpJ1U7Scwj57bx2xueReg7R9cKU";
+export declare const batchCpiContext = "7Hp52chxaew8bW1ApR4fck2bh6Y8qA1pu3qwH6N9zaLj";
 export declare const confirmConfig: ConfirmOptions;
 export declare const DEFAULT_MERKLE_TREE_HEIGHT = 26;
 export declare const DEFAULT_MERKLE_TREE_ROOTS = 2800;