@tokamak-private-dapps/private-state-cli 2.2.1 → 2.3.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 2.3.0 - 2026-05-20
+
+- Added `help observer` to print the deployed public observer URL for the private-state monitoring
+  surface.
+- Documented the deployed public observer in the monitoring audit packet and observability matrix.
+
 ## 2.2.1 - 2026-05-18
 
 - Added `channel recover-workspace --source rpc --output-raw` to append raw JSON-RPC request and response history

package/commands/system.mjs

@@ -1,6 +1,7 @@
 import {
   assertDoctorArgs,
   assertGuideArgs,
+  assertObserverArgs,
   assertInstallZkEvmArgs,
   assertSetRpcArgs,
   assertTransactionFeesArgs,
@@ -8,6 +9,7 @@ import {
   assertUpdateArgs,
   handleDoctor,
   handleGuide,
+  handleObserver,
   handleInstallZkEvm,
   handleSetRpc,
   handleTransactionFees,
@@ -41,6 +43,10 @@ export const systemCommands = Object.freeze({
     assertGuideArgs(args);
     await handleGuide({ args });
   },
+  "help-observer": async (args) => {
+    assertObserverArgs(args);
+    handleObserver();
+  },
   "help-transaction-fees": async (args) => {
     assertTransactionFeesArgs(args);
     const { network, provider, rpcUrl } = loadExplicitCommandRuntime(args);

package/lib/private-state-cli-command-registry.mjs

@@ -329,6 +329,17 @@ export const PRIVATE_STATE_CLI_COMMANDS = Object.freeze([
     usage: "optional --network, --channel-name, --account, and --wallet",
     help: ["Does not accept --rpc-url and never writes RPC configuration"],
   },
+  {
+    id: "help-observer",
+    display: "help observer",
+    description: "Show the deployed public observer URL.",
+    fields: [],
+    usage: "no options",
+    help: [
+      "Prints the deployed observer URL so terminals can present it as a clickable link",
+      "The observer is a public monitoring surface; it is not a wallet, key manager, or disclosure authority",
+    ],
+  },
   {
     id: "help-transaction-fees",
     display: "help transaction-fees",

package/lib/runtime.mjs

@@ -137,6 +137,7 @@ const PRIVATE_STATE_UNINSTALL_CONFIRMATION =
 const ACTION_IMPACT_CONFIRMATION =
   "I understand the public and private impact of this action";
 const PRIVATE_STATE_CLI_PACKAGE_NAME = privateStateCliPackageJson.name;
+const PRIVATE_STATE_OBSERVER_URL = "https://project-scw1r.vercel.app";
 const GROTH16_PACKAGE_NAME = "@tokamak-private-dapps/groth16";
 const TOKAMAK_ZKEVM_CLI_PACKAGE_NAME = "@tokamak-zk-evm/cli";
 const WALLET_BACKUP_EXPORT_FORMAT = "tokamak-private-state-wallet-backup-export";
@@ -3078,6 +3079,18 @@ async function handleDoctor({ args }) {
   }
 }
 
+function handleObserver() {
+  printJson({
+    action: "observer",
+    url: PRIVATE_STATE_OBSERVER_URL,
+    scope: "Public monitoring observer for Tokamak Private App Channels and the private-state DApp.",
+    notes: [
+      "The observer helps users and reviewers inspect public monitoring surfaces.",
+      "The observer does not receive wallet secrets, spending keys, viewing keys, or private note plaintext.",
+    ],
+  });
+}
+
 function handleInvestigator() {
   const htmlPath = resolveInvestigatorIndexPath();
   const fileUrl = pathToFileURL(htmlPath).href;
@@ -10255,6 +10268,10 @@ function assertGuideArgs(args) {
   assertAllowedCommandSchema(args, "help-guide");
 }
 
+function assertObserverArgs(args) {
+  assertAllowedCommandSchema(args, "help-observer");
+}
+
 function assertTransactionFeesArgs(args) {
   assertAllowedCommandSchema(args, "help-transaction-fees");
 }
@@ -11206,6 +11223,7 @@ function loadWalletCommandRuntime(args, { prepareArtifacts = false } = {}) {
 const HUMAN_RESULT_RENDERERS = Object.freeze({
   guide: printGuideHumanResult,
   investigator: printInvestigatorHumanResult,
+  observer: printObserverHumanResult,
   "transaction-fees": printTransactionFeesHumanResult,
   update: printUpdateHumanResult,
 });
@@ -11288,6 +11306,24 @@ function printInvestigatorHumanResult(result) {
   console.log(lines.join("\n"));
 }
 
+function printObserverHumanResult(result) {
+  const lines = [
+    "Private-State Public Observer",
+    `URL: ${formatHumanValue(result.url)}`,
+  ];
+  if (result.scope) {
+    lines.push(`Scope: ${formatHumanValue(result.scope)}`);
+  }
+  if (Array.isArray(result.notes) && result.notes.length > 0) {
+    lines.push(
+      "",
+      "Notes",
+      ...result.notes.map((note) => `- ${note}`),
+    );
+  }
+  console.log(lines.join("\n"));
+}
+
 function printTransactionFeesHumanResult(report) {
   const lines = [
     "Transaction Fees",
@@ -11700,6 +11736,7 @@ export {
   assertUpdateArgs,
   assertDoctorArgs,
   assertGuideArgs,
+  assertObserverArgs,
   assertTransactionFeesArgs,
   assertInvestigatorArgs,
   assertAccountGetL1AddressArgs,
@@ -11733,6 +11770,7 @@ export {
   handleUpdate,
   handleDoctor,
   handleGuide,
+  handleObserver,
   handleTransactionFees,
   handleInvestigator,
   handleAccountGetL1Address,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokamak-private-dapps/private-state-cli",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Command-line client for the Tokamak private-state DApp.",
   "license": "MIT OR Apache-2.0",
   "author": "Tokamak Network",