@lightprotocol/zk-compression-cli 0.28.0-beta.4 → 0.28.0-beta.6

package/dist/commands/create-token-pool/index.js

@@ -21,7 +21,7 @@ class RegisterMintCommand extends core_1.Command {
         try {
             const payer = (0, utils_1.defaultSolanaWalletKeypair)();
             const mintAddress = new web3_js_1.PublicKey(flags.mint);
-            const txId = await (0, compressed_token_1.createTokenPool)((0, utils_1.rpc)(), payer, mintAddress);
+            const txId = await (0, compressed_token_1.createSplInterface)((0, utils_1.rpc)(), payer, mintAddress);
             loader.stop(false);
             console.log("\x1b[1mMint public key:\x1b[0m ", mintAddress.toBase58());
             console.log("\x1b[1mMint tx:\x1b[0m ", (0, utils_1.generateSolanaTransactionURL)("tx", txId, "custom"));

package/dist/commands/test-validator/index.d.ts

@@ -6,6 +6,9 @@ declare class SetupCommand extends Command {
     static flags: {
         "skip-indexer": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         "skip-prover": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        forester: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        "forester-port": import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        "light-pda-program": import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         "skip-system-accounts": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         "relax-indexer-version-constraint": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         "indexer-db-url": import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -23,6 +26,8 @@ declare class SetupCommand extends Command {
         mainnet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         "skip-reset": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        "use-surfpool": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        "account-dir": import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     validatePrograms(programs: {
         address: string;

package/dist/commands/test-validator/index.js

@@ -34,6 +34,20 @@ class SetupCommand extends core_1.Command {
             description: "Runs a test validator without starting a new prover service.",
             default: false,
         }),
+        forester: core_1.Flags.boolean({
+            description: "Start the forester service for auto-compression of compressible accounts.",
+            default: false,
+        }),
+        "forester-port": core_1.Flags.integer({
+            description: "Port for the forester API server.",
+            required: false,
+            default: 8080,
+        }),
+        "light-pda-program": core_1.Flags.string({
+            description: "Light PDA programs to track. Format: 'program_id:discriminator_base58'. Can be specified multiple times.",
+            required: false,
+            multiple: true,
+        }),
         "skip-system-accounts": core_1.Flags.boolean({
             description: "Runs a test validator without initialized light system accounts.",
             default: false,
@@ -120,6 +134,17 @@ class SetupCommand extends core_1.Command {
             description: "Skip resetting the ledger.",
             default: false,
         }),
+        "use-surfpool": core_1.Flags.boolean({
+            description: "Use surfpool instead of solana-test-validator (default). Pass --no-use-surfpool to use solana-test-validator.",
+            default: true,
+            allowNo: true,
+        }),
+        "account-dir": core_1.Flags.string({
+            description: "Additional directory containing account JSON files to preload. Can be specified multiple times.",
+            required: false,
+            multiple: true,
+            summary: "Usage: --account-dir <path/to/accounts/>",
+        }),
     };
     validatePrograms(programs, upgradeablePrograms) {
         // Check for duplicate addresses among all provided programs
@@ -167,6 +192,7 @@ class SetupCommand extends core_1.Command {
             await (0, initTestEnv_1.stopTestEnv)({
                 indexer: !flags["skip-indexer"],
                 prover: !flags["skip-prover"],
+                forester: flags.forester,
             });
             this.log("\nTest validator stopped successfully \x1b[32m✔\x1b[0m");
         }
@@ -209,6 +235,9 @@ class SetupCommand extends core_1.Command {
                 indexerPort: flags["indexer-port"],
                 proverPort: flags["prover-port"],
                 prover: !flags["skip-prover"],
+                forester: flags.forester,
+                foresterPort: flags["forester-port"],
+                lightPdaPrograms: flags["light-pda-program"],
                 skipSystemAccounts: flags["skip-system-accounts"],
                 geyserConfig: flags["geyser-config"],
                 validatorArgs: flags["validator-args"],
@@ -219,6 +248,8 @@ class SetupCommand extends core_1.Command {
                         : undefined,
                 verbose: flags.verbose,
                 skipReset: flags["skip-reset"],
+                useSurfpool: flags["use-surfpool"],
+                additionalAccountDirs: flags["account-dir"],
             });
             this.log("\nSetup tasks completed successfully \x1b[32m✔\x1b[0m");
         }

package/dist/utils/constants.d.ts

@@ -10,12 +10,12 @@ export declare const DEFAULT_CONFIG: {
 };
 export declare const CARGO_GENERATE_TAG = "v0.18.4";
 export declare const SOLANA_VALIDATOR_PROCESS_NAME = "solana-test-validator";
+export declare const SURFPOOL_PROCESS_NAME = "surfpool";
 export declare const LIGHT_PROVER_PROCESS_NAME = "light-prover";
 export declare const INDEXER_PROCESS_NAME = "photon";
-export declare const PHOTON_VERSION = "0.51.2";
-export declare const USE_PHOTON_FROM_GIT = true;
-export declare const PHOTON_GIT_REPO = "https://github.com/lightprotocol/photon.git";
-export declare const PHOTON_GIT_COMMIT = "ac7df6c388db847b7693a7a1cb766a7c9d7809b5";
+export declare const FORESTER_PROCESS_NAME = "forester";
+export declare const SURFPOOL_VERSION = "1.0.1";
+export declare const SURFPOOL_RELEASE_TAG = "v1.0.1-light";
 export declare const LIGHT_PROTOCOL_PROGRAMS_DIR_ENV = "LIGHT_PROTOCOL_PROGRAMS_DIR";
 export declare const BASE_PATH = "../../bin/";
 export declare const PROGRAM_ID = "Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS";

package/dist/utils/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATELESS_JS_VERSION = exports.LIGHT_CLIENT_VERSION = exports.LIGHT_PROGRAM_TEST_VERSION = exports.LIGHT_COMPRESSED_ACCOUNT_VERSION = exports.LIGHT_SDK_TYPES_VERSION = exports.LIGHT_SDK_VERSION = exports.LIGHT_SDK_MACROS_VERSION = exports.LIGHT_MACROS_VERSION = exports.LIGHT_HASHER_VERSION = exports.SOLANA_CLI_VERSION = exports.LIGHT_CLI_VERSION = exports.TOKIO_VERSION = exports.COMPRESSED_PROGRAM_TEMPLATE_TAG = exports.ANCHOR_VERSION = exports.SOLANA_SDK_VERSION = exports.PROGRAM_ID = exports.BASE_PATH = exports.LIGHT_PROTOCOL_PROGRAMS_DIR_ENV = exports.PHOTON_GIT_COMMIT = exports.PHOTON_GIT_REPO = exports.USE_PHOTON_FROM_GIT = exports.PHOTON_VERSION = exports.INDEXER_PROCESS_NAME = exports.LIGHT_PROVER_PROCESS_NAME = exports.SOLANA_VALIDATOR_PROCESS_NAME = exports.CARGO_GENERATE_TAG = exports.DEFAULT_CONFIG = exports.CONFIG_FILE_NAME = exports.CONFIG_PATH = exports.LIGHT_COMPRESSED_TOKEN_TAG = exports.LIGHT_REGISTRY_TAG = exports.LIGHT_SYSTEM_PROGRAM_TAG = exports.LIGHT_ACCOUNT_COMPRESSION_TAG = exports.SPL_NOOP_PROGRAM_TAG = void 0;
+exports.STATELESS_JS_VERSION = exports.LIGHT_CLIENT_VERSION = exports.LIGHT_PROGRAM_TEST_VERSION = exports.LIGHT_COMPRESSED_ACCOUNT_VERSION = exports.LIGHT_SDK_TYPES_VERSION = exports.LIGHT_SDK_VERSION = exports.LIGHT_SDK_MACROS_VERSION = exports.LIGHT_MACROS_VERSION = exports.LIGHT_HASHER_VERSION = exports.SOLANA_CLI_VERSION = exports.LIGHT_CLI_VERSION = exports.TOKIO_VERSION = exports.COMPRESSED_PROGRAM_TEMPLATE_TAG = exports.ANCHOR_VERSION = exports.SOLANA_SDK_VERSION = exports.PROGRAM_ID = exports.BASE_PATH = exports.LIGHT_PROTOCOL_PROGRAMS_DIR_ENV = exports.SURFPOOL_RELEASE_TAG = exports.SURFPOOL_VERSION = exports.FORESTER_PROCESS_NAME = exports.INDEXER_PROCESS_NAME = exports.LIGHT_PROVER_PROCESS_NAME = exports.SURFPOOL_PROCESS_NAME = exports.SOLANA_VALIDATOR_PROCESS_NAME = exports.CARGO_GENERATE_TAG = exports.DEFAULT_CONFIG = exports.CONFIG_FILE_NAME = exports.CONFIG_PATH = exports.LIGHT_COMPRESSED_TOKEN_TAG = exports.LIGHT_REGISTRY_TAG = exports.LIGHT_SYSTEM_PROGRAM_TAG = exports.LIGHT_ACCOUNT_COMPRESSION_TAG = exports.SPL_NOOP_PROGRAM_TAG = void 0;
 exports.SPL_NOOP_PROGRAM_TAG = "spl-noop-v0.2.0";
 exports.LIGHT_ACCOUNT_COMPRESSION_TAG = "account-compression-v1.0.0";
 exports.LIGHT_SYSTEM_PROGRAM_TAG = "light-system-program-v1.0.0";
@@ -15,13 +15,14 @@ exports.DEFAULT_CONFIG = {
 // Fixed version because 11/11/23 release (v0.18.5) fails
 exports.CARGO_GENERATE_TAG = "v0.18.4";
 exports.SOLANA_VALIDATOR_PROCESS_NAME = "solana-test-validator";
+exports.SURFPOOL_PROCESS_NAME = "surfpool";
 exports.LIGHT_PROVER_PROCESS_NAME = "light-prover";
 exports.INDEXER_PROCESS_NAME = "photon";
-exports.PHOTON_VERSION = "0.51.2";
-// Set these to override Photon requirements with a specific git commit:
-exports.USE_PHOTON_FROM_GIT = true; // If true, will show git install command instead of crates.io.
-exports.PHOTON_GIT_REPO = "https://github.com/lightprotocol/photon.git";
-exports.PHOTON_GIT_COMMIT = "ac7df6c388db847b7693a7a1cb766a7c9d7809b5"; // If empty, will use main branch.
+exports.FORESTER_PROCESS_NAME = "forester";
+exports.SURFPOOL_VERSION = "1.0.1";
+exports.SURFPOOL_RELEASE_TAG = "v1.0.1-light";
+// PHOTON_VERSION, PHOTON_GIT_COMMIT, and PHOTON_GIT_REPO are auto-generated
+// from the external/photon submodule at build time. See photonVersion.generated.ts.
 exports.LIGHT_PROTOCOL_PROGRAMS_DIR_ENV = "LIGHT_PROTOCOL_PROGRAMS_DIR";
 exports.BASE_PATH = "../../bin/";
 exports.PROGRAM_ID = "Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS";

package/dist/utils/initTestEnv.d.ts

@@ -8,8 +8,9 @@ export declare const SYSTEM_PROGRAMS: Program[];
 export declare function stopTestEnv(options: {
     indexer: boolean;
     prover: boolean;
+    forester?: boolean;
 }): Promise<void>;
-export declare function initTestEnv({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, indexer, prover, rpcPort, indexerPort, proverPort, gossipHost, checkPhotonVersion, photonDatabaseUrl, limitLedgerSize, geyserConfig, validatorArgs, cloneNetwork, verbose, skipReset, }: {
+export declare function initTestEnv({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, indexer, prover, forester, rpcPort, indexerPort, proverPort, foresterPort, gossipHost, checkPhotonVersion, photonDatabaseUrl, limitLedgerSize, geyserConfig, validatorArgs, cloneNetwork, verbose, skipReset, useSurfpool, lightPdaPrograms, additionalAccountDirs, }: {
     additionalPrograms?: {
         address: string;
         path: string;
@@ -22,9 +23,11 @@ export declare function initTestEnv({ additionalPrograms, upgradeablePrograms, s
     skipSystemAccounts?: boolean;
     indexer: boolean;
     prover: boolean;
+    forester?: boolean;
     rpcPort?: number;
     indexerPort?: number;
     proverPort?: number;
+    foresterPort?: number;
     gossipHost?: string;
     checkPhotonVersion?: boolean;
     photonDatabaseUrl?: string;
@@ -34,6 +37,9 @@ export declare function initTestEnv({ additionalPrograms, upgradeablePrograms, s
     cloneNetwork?: "devnet" | "mainnet";
     verbose?: boolean;
     skipReset?: boolean;
+    useSurfpool?: boolean;
+    lightPdaPrograms?: string[];
+    additionalAccountDirs?: string[];
 }): Promise<void>;
 export declare function initTestEnvIfNeeded({ additionalPrograms, skipSystemAccounts, indexer, prover, geyserConfig, validatorArgs, }?: {
     additionalPrograms?: {
@@ -67,7 +73,23 @@ export declare function getSolanaArgs({ additionalPrograms, upgradeablePrograms,
     verbose?: boolean;
     skipReset?: boolean;
 }): Promise<Array<string>>;
-export declare function startTestValidator({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, limitLedgerSize, rpcPort, gossipHost, validatorArgs, geyserConfig, cloneNetwork, verbose, skipReset, }: {
+export declare function getSurfpoolArgs({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, rpcPort, gossipHost, downloadBinaries, additionalAccountDirs, }: {
+    additionalPrograms?: {
+        address: string;
+        path: string;
+    }[];
+    upgradeablePrograms?: {
+        address: string;
+        path: string;
+        upgradeAuthority: string;
+    }[];
+    skipSystemAccounts?: boolean;
+    rpcPort?: number;
+    gossipHost?: string;
+    downloadBinaries?: boolean;
+    additionalAccountDirs?: string[];
+}): Promise<Array<string>>;
+export declare function startTestValidator({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, limitLedgerSize, rpcPort, gossipHost, validatorArgs, geyserConfig, cloneNetwork, verbose, skipReset, useSurfpool, additionalAccountDirs, }: {
     additionalPrograms?: {
         address: string;
         path: string;
@@ -86,6 +108,8 @@ export declare function startTestValidator({ additionalPrograms, upgradeableProg
     cloneNetwork?: "devnet" | "mainnet";
     verbose?: boolean;
     skipReset?: boolean;
+    useSurfpool?: boolean;
+    additionalAccountDirs?: string[];
 }): Promise<void>;
-export declare function killTestValidator(): Promise<void>;
+export declare function killTestValidator(rpcPort?: number): Promise<void>;
 export {};

package/dist/utils/initTestEnv.js

@@ -7,17 +7,22 @@ exports.initTestEnvIfNeeded = initTestEnvIfNeeded;
 exports.programsDirPath = programsDirPath;
 exports.programFilePath = programFilePath;
 exports.getSolanaArgs = getSolanaArgs;
+exports.getSurfpoolArgs = getSurfpoolArgs;
 exports.startTestValidator = startTestValidator;
 exports.killTestValidator = killTestValidator;
 const tslib_1 = require("tslib");
 const utils_1 = require("./utils");
 const constants_1 = require("./constants");
+const fs_1 = tslib_1.__importDefault(require("fs"));
 const path_1 = tslib_1.__importDefault(require("path"));
+const os_1 = tslib_1.__importDefault(require("os"));
 const psp_utils_1 = require("../psp-utils");
 const process_1 = require("./process");
 const processProverServer_1 = require("./processProverServer");
 const processPhotonIndexer_1 = require("./processPhotonIndexer");
+const processForester_1 = require("./processForester");
 const web3_js_1 = require("@solana/web3.js");
+const child_process_1 = require("child_process");
 exports.SYSTEM_PROGRAMS = [
     {
         id: "noopb9bkMVfRPU8AsbpTUg8AQkHtKwMYZiFUjNRtMmV",
@@ -79,6 +84,7 @@ async function getProgramOwnedAccounts(programId, rpcUrl) {
 }
 async function stopTestEnv(options) {
     const processesToKill = [
+        { name: "forester", condition: options.forester ?? false, killFunction: processForester_1.killForester },
         { name: "photon", condition: options.indexer, killFunction: processPhotonIndexer_1.killIndexer },
         { name: "prover", condition: options.prover, killFunction: processProverServer_1.killProver },
         {
@@ -103,24 +109,50 @@ async function stopTestEnv(options) {
     await Promise.all(killPromises);
     console.log("All specified processes and validator stopped.");
 }
-async function initTestEnv({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, indexer = true, prover = true, rpcPort = 8899, indexerPort = 8784, proverPort = 3001, gossipHost = "127.0.0.1", checkPhotonVersion = true, photonDatabaseUrl, limitLedgerSize, geyserConfig, validatorArgs, cloneNetwork, verbose, skipReset, }) {
-    // We cannot await this promise directly because it will hang the process
-    startTestValidator({
-        additionalPrograms,
-        upgradeablePrograms,
-        skipSystemAccounts,
-        limitLedgerSize,
-        rpcPort,
-        gossipHost,
-        validatorArgs,
-        geyserConfig,
-        cloneNetwork,
-        verbose,
-        skipReset,
-    });
-    await (0, process_1.waitForServers)([{ port: rpcPort, path: "/health" }]);
-    await (0, process_1.confirmServerStability)(`http://127.0.0.1:${rpcPort}/health`);
-    await (0, process_1.confirmRpcReadiness)(`http://127.0.0.1:${rpcPort}`);
+async function initTestEnv({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, indexer = true, prover = true, forester = false, rpcPort = 8899, indexerPort = 8784, proverPort = 3001, foresterPort = 8080, gossipHost = "127.0.0.1", checkPhotonVersion = true, photonDatabaseUrl, limitLedgerSize, geyserConfig, validatorArgs, cloneNetwork, verbose, skipReset, useSurfpool, lightPdaPrograms, additionalAccountDirs, }) {
+    if (useSurfpool) {
+        // For surfpool we can await startTestValidator because spawnBinary returns
+        // immediately (surfpool starts in ~30ms). For solana-test-validator we must
+        // NOT await because the validator is a long-running process.
+        await startTestValidator({
+            additionalPrograms,
+            upgradeablePrograms,
+            skipSystemAccounts,
+            limitLedgerSize,
+            rpcPort,
+            gossipHost,
+            validatorArgs,
+            geyserConfig,
+            cloneNetwork,
+            verbose,
+            skipReset,
+            useSurfpool,
+            additionalAccountDirs,
+        });
+        // Surfpool only supports JSON-RPC POST, not GET /health.
+        await (0, process_1.confirmRpcReadiness)(`http://127.0.0.1:${rpcPort}`);
+    }
+    else {
+        // We cannot await this promise directly because it will hang the process
+        startTestValidator({
+            additionalPrograms,
+            upgradeablePrograms,
+            skipSystemAccounts,
+            limitLedgerSize,
+            rpcPort,
+            gossipHost,
+            validatorArgs,
+            geyserConfig,
+            cloneNetwork,
+            verbose,
+            skipReset,
+            useSurfpool,
+            additionalAccountDirs,
+        });
+        await (0, process_1.waitForServers)([{ port: rpcPort, path: "/health" }]);
+        await (0, process_1.confirmServerStability)(`http://127.0.0.1:${rpcPort}/health`);
+        await (0, process_1.confirmRpcReadiness)(`http://127.0.0.1:${rpcPort}`);
+    }
     if (prover) {
         const config = (0, utils_1.getConfig)();
         config.proverUrl = `http://127.0.0.1:${proverPort}`;
@@ -140,7 +172,56 @@ async function initTestEnv({ additionalPrograms, upgradeablePrograms, skipSystem
         const proverUrlForIndexer = prover
             ? `http://127.0.0.1:${proverPort}`
             : undefined;
-        await (0, processPhotonIndexer_1.startIndexer)(`http://127.0.0.1:${rpcPort}`, indexerPort, checkPhotonVersion, photonDatabaseUrl, proverUrlForIndexer);
+        // Surfpool's first available block may not be slot 0.
+        // Query the RPC so Photon starts from the correct slot.
+        let startSlot;
+        if (useSurfpool) {
+            const conn = new web3_js_1.Connection(`http://127.0.0.1:${rpcPort}`);
+            startSlot = await conn.getFirstAvailableBlock();
+        }
+        await (0, processPhotonIndexer_1.startIndexer)(`http://127.0.0.1:${rpcPort}`, indexerPort, checkPhotonVersion, photonDatabaseUrl, proverUrlForIndexer, startSlot);
+    }
+    if (forester) {
+        if (!indexer || !prover) {
+            throw new Error("Forester requires both indexer and prover to be running");
+        }
+        try {
+            const payer = (0, processForester_1.getPayerForForester)();
+            await (0, processForester_1.startForester)({
+                rpcUrl: `http://127.0.0.1:${rpcPort}`,
+                wsRpcUrl: `ws://127.0.0.1:${rpcPort + 1}`,
+                indexerUrl: `http://127.0.0.1:${indexerPort}`,
+                proverUrl: `http://127.0.0.1:${proverPort}`,
+                payer,
+                foresterPort,
+                lightPdaPrograms,
+            });
+        }
+        catch (error) {
+            console.error("Failed to start forester:", error);
+            throw error;
+        }
+    }
+    if (forester) {
+        if (!indexer || !prover) {
+            throw new Error("Forester requires both indexer and prover to be running");
+        }
+        try {
+            const payer = (0, processForester_1.getPayerForForester)();
+            await (0, processForester_1.startForester)({
+                rpcUrl: `http://127.0.0.1:${rpcPort}`,
+                wsRpcUrl: `ws://127.0.0.1:${rpcPort + 1}`,
+                indexerUrl: `http://127.0.0.1:${indexerPort}`,
+                proverUrl: `http://127.0.0.1:${proverPort}`,
+                payer,
+                foresterPort,
+                lightPdaPrograms,
+            });
+        }
+        catch (error) {
+            console.error("Failed to start forester:", error);
+            throw error;
+        }
     }
 }
 async function initTestEnvIfNeeded({ additionalPrograms, skipSystemAccounts, indexer = false, prover = false, geyserConfig, validatorArgs, } = {}) {
@@ -270,36 +351,172 @@ async function getSolanaArgs({ additionalPrograms, upgradeablePrograms, skipSyst
     }
     return solanaArgs;
 }
-async function startTestValidator({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, limitLedgerSize, rpcPort, gossipHost, validatorArgs, geyserConfig, cloneNetwork, verbose, skipReset, }) {
-    const command = "solana-test-validator";
-    const solanaArgs = await getSolanaArgs({
-        additionalPrograms,
-        upgradeablePrograms,
-        skipSystemAccounts,
-        limitLedgerSize,
-        rpcPort,
-        gossipHost,
-        cloneNetwork,
-        verbose,
-        skipReset,
+async function getSurfpoolArgs({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, rpcPort, gossipHost, downloadBinaries = true, additionalAccountDirs, }) {
+    const dirPath = programsDirPath();
+    const args = ["start", "--offline", "--no-tui", "--no-deploy", "--no-studio"];
+    args.push("--port", String(rpcPort));
+    args.push("--host", String(gossipHost));
+    // Load system programs
+    for (const program of exports.SYSTEM_PROGRAMS) {
+        const localFilePath = programFilePath(program.name);
+        if (program.name === "spl_noop.so" || downloadBinaries) {
+            await (0, psp_utils_1.downloadBinIfNotExists)({
+                localFilePath,
+                dirPath,
+                owner: "Lightprotocol",
+                repoName: "light-protocol",
+                remoteFileName: program.name,
+                tag: program.tag,
+            });
+        }
+        args.push("--bpf-program", program.id, localFilePath);
+    }
+    // Load additional programs
+    if (additionalPrograms) {
+        for (const program of additionalPrograms) {
+            args.push("--bpf-program", program.address, program.path);
+        }
+    }
+    // Load upgradeable programs with full BPF upgradeable loader account layout
+    if (upgradeablePrograms) {
+        for (const program of upgradeablePrograms) {
+            args.push("--upgradeable-program", program.address, program.path, program.upgradeAuthority);
+        }
+    }
+    // Load system accounts
+    if (!skipSystemAccounts) {
+        const accountsRelPath = "../../accounts";
+        const accountsPath = path_1.default.resolve(__dirname, accountsRelPath);
+        args.push("--account-dir", accountsPath);
+    }
+    // Load additional account directories
+    if (additionalAccountDirs) {
+        for (const accountDir of additionalAccountDirs) {
+            args.push("--account-dir", path_1.default.resolve(accountDir));
+        }
+    }
+    return args;
+}
+function getSurfpoolAssetName() {
+    const platform = process.platform; // "darwin" | "linux"
+    const arch = process.arch; // "arm64" | "x64"
+    return `surfpool-${platform}-${arch}.tar.gz`;
+}
+function getSurfpoolBinDir() {
+    return path_1.default.join(os_1.default.homedir(), ".config", "light", "bin");
+}
+function getSurfpoolBinaryPath() {
+    return path_1.default.join(getSurfpoolBinDir(), "surfpool");
+}
+function getInstalledSurfpoolVersion() {
+    const binaryPath = getSurfpoolBinaryPath();
+    if (!fs_1.default.existsSync(binaryPath)) {
+        return null;
+    }
+    try {
+        const output = (0, child_process_1.execSync)(`"${binaryPath}" --version`, {
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        const match = output.match(/(\d+\.\d+\.\d+)/);
+        return match ? match[1] : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function downloadSurfpoolBinary() {
+    const binPath = getSurfpoolBinaryPath();
+    const dirPath = getSurfpoolBinDir();
+    const assetName = getSurfpoolAssetName();
+    if (!fs_1.default.existsSync(dirPath)) {
+        fs_1.default.mkdirSync(dirPath, { recursive: true });
+    }
+    // Remove existing binary so downloadBinIfNotExists actually downloads
+    if (fs_1.default.existsSync(binPath)) {
+        fs_1.default.unlinkSync(binPath);
+    }
+    await (0, psp_utils_1.downloadBinIfNotExists)({
+        localFilePath: binPath,
+        dirPath,
+        owner: "Lightprotocol",
+        repoName: "surfpool",
+        remoteFileName: assetName,
+        tag: constants_1.SURFPOOL_RELEASE_TAG,
     });
-    await killTestValidator();
-    await new Promise((r) => setTimeout(r, 1000));
-    // Add geyser config if provided
-    if (geyserConfig) {
-        solanaArgs.push("--geyser-plugin-config", geyserConfig);
-    }
-    // Add custom validator args last
-    if (validatorArgs) {
-        solanaArgs.push(...validatorArgs.split(" "));
-    }
-    console.log("Starting test validator...");
-    // Use spawnBinary instead of executeCommand to properly detach the process.
-    // This ensures the validator survives when the CLI exits (executeCommand uses
-    // piped stdio which causes SIGPIPE when parent exits).
-    // Pass process.env directly to maintain same env behavior as before.
-    (0, process_1.spawnBinary)(command, solanaArgs, process.env);
 }
-async function killTestValidator() {
+async function ensureSurfpoolBinary() {
+    const binPath = getSurfpoolBinaryPath();
+    const installedVersion = getInstalledSurfpoolVersion();
+    if (installedVersion === constants_1.SURFPOOL_VERSION) {
+        return binPath;
+    }
+    if (installedVersion) {
+        console.log(`Surfpool version mismatch. Expected: ${constants_1.SURFPOOL_VERSION}, Found: ${installedVersion}. Downloading correct version...`);
+    }
+    else if (fs_1.default.existsSync(binPath)) {
+        console.log("Surfpool binary found but version could not be determined. Downloading latest version...");
+    }
+    await downloadSurfpoolBinary();
+    return binPath;
+}
+async function startTestValidator({ additionalPrograms, upgradeablePrograms, skipSystemAccounts, limitLedgerSize, rpcPort, gossipHost, validatorArgs, geyserConfig, cloneNetwork, verbose, skipReset, useSurfpool, additionalAccountDirs, }) {
+    if (useSurfpool) {
+        const command = await ensureSurfpoolBinary();
+        const surfpoolArgs = await getSurfpoolArgs({
+            additionalPrograms,
+            upgradeablePrograms,
+            skipSystemAccounts,
+            rpcPort,
+            gossipHost,
+            additionalAccountDirs,
+        });
+        await killTestValidator(rpcPort);
+        await new Promise((r) => setTimeout(r, 1000));
+        console.log("Starting surfpool...");
+        (0, process_1.spawnBinary)(command, surfpoolArgs, process.env);
+    }
+    else {
+        const command = "solana-test-validator";
+        const solanaArgs = await getSolanaArgs({
+            additionalPrograms,
+            upgradeablePrograms,
+            skipSystemAccounts,
+            limitLedgerSize,
+            rpcPort,
+            gossipHost,
+            cloneNetwork,
+            verbose,
+            skipReset,
+        });
+        await killTestValidator(rpcPort);
+        await new Promise((r) => setTimeout(r, 1000));
+        // Add geyser config if provided
+        if (geyserConfig) {
+            solanaArgs.push("--geyser-plugin-config", geyserConfig);
+        }
+        // Add custom validator args last
+        if (validatorArgs) {
+            solanaArgs.push(...validatorArgs.split(" "));
+        }
+        console.log("Starting test validator...");
+        // Use spawnBinary instead of executeCommand to properly detach the process.
+        // This ensures the validator survives when the CLI exits (executeCommand uses
+        // piped stdio which causes SIGPIPE when parent exits).
+        // Pass process.env directly to maintain same env behavior as before.
+        (0, process_1.spawnBinary)(command, solanaArgs, process.env);
+    }
+}
+async function killTestValidator(rpcPort = 8899) {
     await (0, process_1.killProcess)("solana-test-validator");
+    await (0, process_1.killProcess)("surfpool");
+    // Fallback: kill anything still listening on the RPC port.
+    // find-process name matching can miss processes depending on platform
+    // and how the binary path appears in the process table.
+    try {
+        await (0, process_1.killProcessByPort)(rpcPort);
+    }
+    catch {
+        // No process listening on the port, nothing to do.
+    }
 }

package/dist/utils/photonVersion.generated.d.ts

@@ -0,0 +1,3 @@
+export declare const PHOTON_VERSION = "0.51.2";
+export declare const PHOTON_GIT_COMMIT = "0df2397c2c7d8458f45df9279e999a730ba56482";
+export declare const PHOTON_GIT_REPO = "https://github.com/lightprotocol/photon.git";

package/dist/utils/photonVersion.generated.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHOTON_GIT_REPO = exports.PHOTON_GIT_COMMIT = exports.PHOTON_VERSION = void 0;
+// Auto-generated from external/photon submodule - do not edit manually
+exports.PHOTON_VERSION = "0.51.2";
+exports.PHOTON_GIT_COMMIT = "0df2397c2c7d8458f45df9279e999a730ba56482";
+exports.PHOTON_GIT_REPO = "https://github.com/lightprotocol/photon.git";

package/dist/utils/process.js

@@ -55,19 +55,17 @@ async function logProverFileContents() {
 }
 async function killProcess(processName) {
     const processList = await (0, find_process_1.default)("name", processName);
-    const targetProcesses = processList.filter((proc) => proc.name.includes(processName) || proc.cmd.includes(processName));
+    const targetProcesses = processList.filter((proc) => proc.pid !== process.pid &&
+        proc.pid !== process.ppid &&
+        (proc.name.includes(processName) || proc.cmd.includes(processName)));
     for (const proc of targetProcesses) {
         try {
             process.kill(proc.pid, "SIGKILL");
         }
         catch (error) {
-            console.error(`Failed to kill process ${proc.pid}: ${error}`);
+            // Process may have already exited between find and kill.
         }
     }
-    const remainingProcesses = await (0, find_process_1.default)("name", processName);
-    if (remainingProcesses.length > 0) {
-        console.warn(`Warning: ${remainingProcesses.length} processes still running after kill attempt`);
-    }
 }
 async function killProcessByPort(port) {
     if (port < 0) {
@@ -185,11 +183,28 @@ function spawnBinary(command, args = [], env) {
                 RUST_LOG: process.env.RUST_LOG || "debug",
             },
         });
+        // Close parent's copy of the file descriptors so the child owns them
+        // exclusively and node's event loop isn't held open.
+        fs_1.default.closeSync(out);
+        fs_1.default.closeSync(err);
+        // Allow node to exit without waiting for the detached child.
+        spawnedProcess.unref();
         spawnedProcess.on("close", async (code) => {
             console.log(`${binaryName} process exited with code ${code}`);
-            if (code !== 0 && binaryName.includes("prover")) {
-                console.error(`Prover process failed with exit code ${code}`);
-                await logProverFileContents();
+            if (code !== 0) {
+                console.error(`${binaryName} process failed with exit code ${code}`);
+                try {
+                    const contents = fs_1.default.readFileSync(logPath, "utf8");
+                    console.error(`--- ${binaryName}.log ---`);
+                    console.error(contents);
+                    console.error(`--- End of ${binaryName}.log ---`);
+                }
+                catch {
+                    // log file may not exist yet
+                }
+                if (binaryName.includes("prover")) {
+                    await logProverFileContents();
+                }
             }
         });
         return spawnedProcess;

package/dist/utils/processForester.d.ts

@@ -0,0 +1,23 @@
+export interface ForesterConfig {
+    rpcUrl: string;
+    wsRpcUrl: string;
+    indexerUrl: string;
+    proverUrl: string;
+    payer: string;
+    foresterPort: number;
+    lightPdaPrograms?: string[];
+}
+/**
+ * Starts the forester service for auto-compression of compressible accounts.
+ *
+ * @param config - Forester configuration
+ */
+export declare function startForester(config: ForesterConfig): Promise<undefined>;
+export declare function killForester(): Promise<void>;
+/**
+ * Gets the payer keypair as a JSON array string for forester.
+ * Reads from ~/.config/solana/id.json or SOLANA_PAYER environment variable.
+ *
+ * @returns JSON array string of the keypair bytes
+ */
+export declare function getPayerForForester(): string;

package/dist/utils/processForester.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startForester = startForester;
+exports.killForester = killForester;
+exports.getPayerForForester = getPayerForForester;
+const tslib_1 = require("tslib");
+const which_1 = tslib_1.__importDefault(require("which"));
+const process_1 = require("./process");
+const constants_1 = require("./constants");
+const node_child_process_1 = require("node:child_process");
+const util = tslib_1.__importStar(require("node:util"));
+const node_process_1 = require("node:process");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const execAsync = util.promisify(node_child_process_1.exec);
+async function isForesterInstalled() {
+    try {
+        const resolvedOrNull = which_1.default.sync("forester", { nothrow: true });
+        return resolvedOrNull !== null;
+    }
+    catch (error) {
+        return false;
+    }
+}
+function getForesterInstallMessage() {
+    return `\nForester not found. Please install it by running: "cargo install --git https://github.com/Lightprotocol/light-protocol forester --locked --force"`;
+}
+/**
+ * Starts the forester service for auto-compression of compressible accounts.
+ *
+ * @param config - Forester configuration
+ */
+async function startForester(config) {
+    await killForester();
+    if (!(await isForesterInstalled())) {
+        console.log(getForesterInstallMessage());
+        return (0, node_process_1.exit)(1);
+    }
+    console.log("Starting forester...");
+    const args = [
+        "start",
+        "--rpc-url",
+        config.rpcUrl,
+        "--ws-rpc-url",
+        config.wsRpcUrl,
+        "--indexer-url",
+        config.indexerUrl,
+        "--prover-url",
+        config.proverUrl,
+        "--payer",
+        config.payer,
+        "--api-server-port",
+        config.foresterPort.toString(),
+        "--enable-compressible",
+    ];
+    // Add light PDA programs if specified
+    if (config.lightPdaPrograms && config.lightPdaPrograms.length > 0) {
+        for (const program of config.lightPdaPrograms) {
+            args.push("--light-pda-program", program);
+        }
+    }
+    (0, process_1.spawnBinary)(constants_1.FORESTER_PROCESS_NAME, args);
+    await (0, process_1.waitForServers)([{ port: config.foresterPort, path: "/health" }]);
+    console.log("Forester started successfully!");
+}
+async function killForester() {
+    await (0, process_1.killProcess)(constants_1.FORESTER_PROCESS_NAME);
+}
+/**
+ * Gets the payer keypair as a JSON array string for forester.
+ * Reads from ~/.config/solana/id.json or SOLANA_PAYER environment variable.
+ *
+ * @returns JSON array string of the keypair bytes
+ */
+function getPayerForForester() {
+    // Check for SOLANA_PAYER environment variable first
+    if (process.env.SOLANA_PAYER) {
+        return process.env.SOLANA_PAYER;
+    }
+    // Default to standard Solana keypair location
+    const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+    const keypairPath = path.join(homeDir, ".config", "solana", "id.json");
+    if (fs.existsSync(keypairPath)) {
+        const keypairData = fs.readFileSync(keypairPath, "utf-8");
+        return keypairData.trim();
+    }
+    throw new Error("No payer keypair found. Set SOLANA_PAYER environment variable or create ~/.config/solana/id.json");
+}

package/dist/utils/processPhotonIndexer.d.ts

@@ -1,2 +1,2 @@
-export declare function startIndexer(rpcUrl: string, indexerPort: number, checkPhotonVersion?: boolean, photonDatabaseUrl?: string, proverUrl?: string): Promise<undefined>;
+export declare function startIndexer(rpcUrl: string, indexerPort: number, checkPhotonVersion?: boolean, photonDatabaseUrl?: string, proverUrl?: string, startSlot?: number): Promise<undefined>;
 export declare function killIndexer(): Promise<void>;

package/dist/utils/processPhotonIndexer.js

@@ -6,6 +6,7 @@ const tslib_1 = require("tslib");
 const which_1 = tslib_1.__importDefault(require("which"));
 const process_1 = require("./process");
 const constants_1 = require("./constants");
+const photonVersion_generated_1 = require("./photonVersion.generated");
 const node_child_process_1 = require("node:child_process");
 const util = tslib_1.__importStar(require("node:util"));
 const node_process_1 = require("node:process");
@@ -22,21 +23,13 @@ async function isExpectedPhotonVersion(requiredVersion) {
     }
 }
 function getPhotonInstallMessage() {
-    if (constants_1.USE_PHOTON_FROM_GIT && constants_1.PHOTON_GIT_COMMIT) {
-        return `\nPhoton indexer ${constants_1.PHOTON_VERSION} (commit ${constants_1.PHOTON_GIT_COMMIT}) not found. Please install it by running: "cargo install --git ${constants_1.PHOTON_GIT_REPO} --rev ${constants_1.PHOTON_GIT_COMMIT} --locked --force"`;
-    }
-    else if (constants_1.USE_PHOTON_FROM_GIT) {
-        return `\nPhoton indexer ${constants_1.PHOTON_VERSION} not found. Please install it by running: "cargo install --git ${constants_1.PHOTON_GIT_REPO} --locked --force"`;
-    }
-    else {
-        return `\nPhoton indexer ${constants_1.PHOTON_VERSION} not found. Please install it by running: "cargo install photon-indexer --version ${constants_1.PHOTON_VERSION} --locked --force"`;
-    }
+    return `\nPhoton indexer ${photonVersion_generated_1.PHOTON_VERSION} (commit ${photonVersion_generated_1.PHOTON_GIT_COMMIT}) not found. Please install it by running: "cargo install --git ${photonVersion_generated_1.PHOTON_GIT_REPO} --rev ${photonVersion_generated_1.PHOTON_GIT_COMMIT} --locked --force"`;
 }
-async function startIndexer(rpcUrl, indexerPort, checkPhotonVersion = true, photonDatabaseUrl, proverUrl) {
+async function startIndexer(rpcUrl, indexerPort, checkPhotonVersion = true, photonDatabaseUrl, proverUrl, startSlot) {
     await killIndexer();
     const resolvedOrNull = which_1.default.sync("photon", { nothrow: true });
     if (resolvedOrNull === null ||
-        (checkPhotonVersion && !(await isExpectedPhotonVersion(constants_1.PHOTON_VERSION)))) {
+        (checkPhotonVersion && !(await isExpectedPhotonVersion(photonVersion_generated_1.PHOTON_VERSION)))) {
         console.log(getPhotonInstallMessage());
         return (0, node_process_1.exit)(1);
     }
@@ -54,6 +47,9 @@ async function startIndexer(rpcUrl, indexerPort, checkPhotonVersion = true, phot
         if (proverUrl) {
             args.push("--prover-url", proverUrl);
         }
+        if (startSlot !== undefined) {
+            args.push("--start-slot", startSlot.toString());
+        }
         (0, process_1.spawnBinary)(constants_1.INDEXER_PROCESS_NAME, args);
         await (0, process_1.waitForServers)([{ port: indexerPort, path: "/getIndexerHealth" }]);
         console.log("Indexer started successfully!");

package/oclif.manifest.json

@@ -369,15 +369,23 @@
         "index.js"
       ]
     },
-    "decompress-sol": {
+    "decompress-spl": {
       "aliases": [],
       "args": {},
       "examples": [
-        "$ light decompress-sol --to PublicKey --amount 10"
+        "$ light decompress-spl --mint PublicKey --to PublicKey --amount 10"
       ],
       "flags": {
+        "mint": {
+          "description": "Specify the mint address.",
+          "name": "mint",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "to": {
-          "description": "Specify the recipient address.",
+          "description": "Specify the recipient address. (owner of destination token account)",
           "name": "to",
           "required": true,
           "hasDynamicHelp": false,
@@ -385,7 +393,7 @@
           "type": "option"
         },
         "amount": {
-          "description": "Amount to decompress, in lamports.",
+          "description": "Amount to decompress, in tokens.",
           "name": "amount",
           "required": true,
           "hasDynamicHelp": false,
@@ -395,38 +403,30 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "decompress-sol",
+      "id": "decompress-spl",
       "pluginAlias": "@lightprotocol/zk-compression-cli",
       "pluginName": "@lightprotocol/zk-compression-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Decompress SOL.",
+      "summary": "Decompress into SPL tokens.",
       "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "decompress-sol",
+        "decompress-spl",
         "index.js"
       ]
     },
-    "decompress-spl": {
+    "decompress-sol": {
       "aliases": [],
       "args": {},
       "examples": [
-        "$ light decompress-spl --mint PublicKey --to PublicKey --amount 10"
+        "$ light decompress-sol --to PublicKey --amount 10"
       ],
       "flags": {
-        "mint": {
-          "description": "Specify the mint address.",
-          "name": "mint",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "to": {
-          "description": "Specify the recipient address. (owner of destination token account)",
+          "description": "Specify the recipient address.",
           "name": "to",
           "required": true,
           "hasDynamicHelp": false,
@@ -434,7 +434,7 @@
           "type": "option"
         },
         "amount": {
-          "description": "Amount to decompress, in tokens.",
+          "description": "Amount to decompress, in lamports.",
           "name": "amount",
           "required": true,
           "hasDynamicHelp": false,
@@ -444,18 +444,18 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "decompress-spl",
+      "id": "decompress-sol",
       "pluginAlias": "@lightprotocol/zk-compression-cli",
       "pluginName": "@lightprotocol/zk-compression-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Decompress into SPL tokens.",
+      "summary": "Decompress SOL.",
       "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "decompress-spl",
+        "decompress-sol",
         "index.js"
       ]
     },
@@ -623,6 +623,104 @@
         "index.js"
       ]
     },
+    "token-balance": {
+      "aliases": [],
+      "args": {},
+      "examples": [
+        "$ light token-balance --mint=<ADDRESS> --owner=<ADDRESS>"
+      ],
+      "flags": {
+        "owner": {
+          "description": "Address of the compressed token owner.",
+          "name": "owner",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "mint": {
+          "description": "Mint address of the compressed token account.",
+          "name": "mint",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "token-balance",
+      "pluginAlias": "@lightprotocol/zk-compression-cli",
+      "pluginName": "@lightprotocol/zk-compression-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get balance",
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "token-balance",
+        "index.js"
+      ]
+    },
+    "transfer": {
+      "aliases": [],
+      "args": {},
+      "examples": [
+        "$ light transfer --mint PublicKey --to PublicKey --amount 1000"
+      ],
+      "flags": {
+        "mint": {
+          "description": "Mint to transfer",
+          "name": "mint",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "Recipient address",
+          "name": "to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "amount": {
+          "description": "Amount to send, in tokens",
+          "name": "amount",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fee-payer": {
+          "description": "Specify the fee-payer account. Defaults to the client keypair.",
+          "name": "fee-payer",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "transfer",
+      "pluginAlias": "@lightprotocol/zk-compression-cli",
+      "pluginName": "@lightprotocol/zk-compression-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Transfer tokens from one account to another.",
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "transfer",
+        "index.js"
+      ]
+    },
     "test-validator": {
       "aliases": [],
       "args": {},
@@ -650,6 +748,29 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "forester": {
+          "description": "Start the forester service for auto-compression of compressible accounts.",
+          "name": "forester",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "forester-port": {
+          "description": "Port for the forester API server.",
+          "name": "forester-port",
+          "required": false,
+          "default": 8080,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "light-pda-program": {
+          "description": "Light PDA programs to track. Format: 'program_id:discriminator_base58'. Can be specified multiple times.",
+          "name": "light-pda-program",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "skip-system-accounts": {
           "description": "Runs a test validator without initialized light system accounts.",
           "name": "skip-system-accounts",
@@ -801,122 +922,39 @@
           "name": "skip-reset",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "test-validator",
-      "pluginAlias": "@lightprotocol/zk-compression-cli",
-      "pluginName": "@lightprotocol/zk-compression-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "test-validator",
-        "index.js"
-      ]
-    },
-    "transfer": {
-      "aliases": [],
-      "args": {},
-      "examples": [
-        "$ light transfer --mint PublicKey --to PublicKey --amount 1000"
-      ],
-      "flags": {
-        "mint": {
-          "description": "Mint to transfer",
-          "name": "mint",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         },
-        "to": {
-          "description": "Recipient address",
-          "name": "to",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "amount": {
-          "description": "Amount to send, in tokens",
-          "name": "amount",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "use-surfpool": {
+          "description": "Use surfpool instead of solana-test-validator (default). Pass --no-use-surfpool to use solana-test-validator.",
+          "name": "use-surfpool",
+          "allowNo": true,
+          "type": "boolean"
         },
-        "fee-payer": {
-          "description": "Specify the fee-payer account. Defaults to the client keypair.",
-          "name": "fee-payer",
+        "account-dir": {
+          "description": "Additional directory containing account JSON files to preload. Can be specified multiple times.",
+          "name": "account-dir",
           "required": false,
+          "summary": "Usage: --account-dir <path/to/accounts/>",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "transfer",
-      "pluginAlias": "@lightprotocol/zk-compression-cli",
-      "pluginName": "@lightprotocol/zk-compression-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Transfer tokens from one account to another.",
-      "enableJsonFlag": false,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "transfer",
-        "index.js"
-      ]
-    },
-    "token-balance": {
-      "aliases": [],
-      "args": {},
-      "examples": [
-        "$ light token-balance --mint=<ADDRESS> --owner=<ADDRESS>"
-      ],
-      "flags": {
-        "owner": {
-          "description": "Address of the compressed token owner.",
-          "name": "owner",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "mint": {
-          "description": "Mint address of the compressed token account.",
-          "name": "mint",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "token-balance",
+      "id": "test-validator",
       "pluginAlias": "@lightprotocol/zk-compression-cli",
       "pluginName": "@lightprotocol/zk-compression-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get balance",
       "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "token-balance",
+        "test-validator",
         "index.js"
       ]
     }
   },
-  "version": "0.28.0-beta.4"
+  "version": "0.28.0-beta.6"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightprotocol/zk-compression-cli",
-  "version": "0.28.0-beta.4",
+  "version": "0.28.0-beta.6",
   "description": "ZK Compression: Secure Scaling on Solana",
   "maintainers": [
     {
@@ -49,8 +49,8 @@
     "tweetnacl": "^1.0.3",
     "wait-on": "^7.2.0",
     "which": "^5.0.0",
-    "@lightprotocol/compressed-token": "0.23.0-beta.4",
-    "@lightprotocol/stateless.js": "0.23.0-beta.4"
+    "@lightprotocol/compressed-token": "0.23.0-beta.6",
+    "@lightprotocol/stateless.js": "0.23.0-beta.6"
   },
   "devDependencies": {
     "@eslint/js": "9.36.0",
@@ -100,8 +100,9 @@
   "scripts": {
     "postinstall": "[ -d ./bin ] && find ./bin -type f -exec chmod +x {} + || echo 'No bin directory found, skipping chmod'",
     "sync-prover-version": "./scripts/syncProverVersion.sh",
-    "build": "shx rm -rf dist && pnpm sync-prover-version && pnpm tsc -p tsconfig.json && pnpm tsc -p tsconfig.test.json",
-    "build-release": "shx rm -rf dist && pnpm sync-prover-version && pnpm tsc -p tsconfig.json && pnpm tsc -p tsconfig.test.json",
+    "sync-photon-version": "./scripts/syncPhotonVersion.sh",
+    "build": "shx rm -rf dist && pnpm sync-prover-version && pnpm sync-photon-version && pnpm tsc -p tsconfig.json && pnpm tsc -p tsconfig.test.json",
+    "build-release": "shx rm -rf dist && pnpm sync-prover-version && pnpm sync-photon-version && pnpm tsc -p tsconfig.json && pnpm tsc -p tsconfig.test.json",
     "format": "pnpm prettier --write \"src/**/*.{ts,js}\" \"test/**/*.{ts,js}\" -w",
     "format:check": "pnpm prettier \"src/**/*{ts,js}\"  \"test/**/*.{ts,js}\" --check",
     "lint": "eslint .",