@lightprotocol/zk-compression-cli 0.27.1-alpha.5 → 0.27.1-alpha.6

package/dist/utils/initTestEnv.js

@@ -119,6 +119,7 @@ async function initTestEnv({ additionalPrograms, skipSystemAccounts, indexer = t
     });
     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 (indexer) {
         const config = (0, utils_1.getConfig)();
         config.indexerUrl = `http://127.0.0.1:${indexerPort}`;

package/dist/utils/process.d.ts

@@ -33,3 +33,13 @@ export declare function waitForServers(servers: {
     path: string;
 }[]): Promise<void>;
 export declare function confirmServerStability(url: string, attempts?: number): Promise<void>;
+/**
+ * Confirms that the Solana RPC is fully ready to process requests.
+ * This goes beyond HTTP availability and verifies the RPC can handle actual Solana requests.
+ *
+ * @param rpcUrl - The RPC endpoint URL
+ * @param maxAttempts - Maximum number of attempts (default: 30)
+ * @param delayMs - Delay between attempts in milliseconds (default: 500ms)
+ * @throws Error if RPC doesn't become ready within maxAttempts
+ */
+export declare function confirmRpcReadiness(rpcUrl: string, maxAttempts?: number, delayMs?: number): Promise<void>;

package/dist/utils/process.js

@@ -8,6 +8,7 @@ exports.execute = execute;
 exports.spawnBinary = spawnBinary;
 exports.waitForServers = waitForServers;
 exports.confirmServerStability = confirmServerStability;
+exports.confirmRpcReadiness = confirmRpcReadiness;
 const tslib_1 = require("tslib");
 const child_process_1 = require("child_process");
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -242,3 +243,50 @@ async function confirmServerStability(url, attempts = 20) {
         throw error;
     }
 }
+/**
+ * Confirms that the Solana RPC is fully ready to process requests.
+ * This goes beyond HTTP availability and verifies the RPC can handle actual Solana requests.
+ *
+ * @param rpcUrl - The RPC endpoint URL
+ * @param maxAttempts - Maximum number of attempts (default: 30)
+ * @param delayMs - Delay between attempts in milliseconds (default: 500ms)
+ * @throws Error if RPC doesn't become ready within maxAttempts
+ */
+async function confirmRpcReadiness(rpcUrl, maxAttempts = 30, delayMs = 500) {
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            const response = await axios_1.default.post(rpcUrl, {
+                jsonrpc: "2.0",
+                id: 1,
+                method: "getHealth",
+                params: [],
+            }, {
+                headers: { "Content-Type": "application/json" },
+                timeout: 3000,
+            });
+            if (response.data?.result === "ok") {
+                console.log(`RPC is ready after ${attempt} attempt${attempt > 1 ? "s" : ""}.`);
+                return;
+            }
+            // Response received but not "ok"
+            lastError = new Error(`RPC returned unexpected result: ${JSON.stringify(response.data)}`);
+        }
+        catch (error) {
+            lastError = error;
+            // Log connection errors only on later attempts to reduce noise
+            if (attempt > 5 && attempt % 5 === 0) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                console.log(`RPC not ready yet (attempt ${attempt}/${maxAttempts}): ${errorMsg}`);
+            }
+        }
+        // Don't sleep after the last attempt
+        if (attempt < maxAttempts) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+    // If we get here, all attempts failed
+    const errorMsg = lastError instanceof Error ? lastError.message : String(lastError);
+    const totalTime = Math.round((maxAttempts * delayMs) / 1000);
+    throw new Error(`RPC failed to become ready after ${maxAttempts} attempts (~${totalTime}s). Last error: ${errorMsg}`);
+}

package/oclif.manifest.json

@@ -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": {},
@@ -808,105 +906,7 @@
         "test-validator",
         "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"
-      ]
     }
   },
-  "version": "0.27.1-alpha.5"
+  "version": "0.27.1-alpha.6"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightprotocol/zk-compression-cli",
-  "version": "0.27.1-alpha.5",
+  "version": "0.27.1-alpha.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.22.1-alpha.3",
-    "@lightprotocol/stateless.js": "0.22.1-alpha.2"
+    "@lightprotocol/compressed-token": "0.22.1-alpha.4",
+    "@lightprotocol/stateless.js": "0.22.1-alpha.3"
   },
   "devDependencies": {
     "@eslint/js": "9.36.0",