shinjuku-shielded 0.3.52 → 0.3.54

package/README.md

@@ -1,88 +1,74 @@
 # shinjuku-shielded
 
-The Shinjuku Shielded wallet: a self-custody command-line wallet for the
-Shinjuku Shielded private x402 facilitator on Solana. Its `mcp` command runs a
-local MCP server (stdio) that lets an agent pay x402 URLs from your shielded
-USDC balance, under caps that you set at launch.
+The Shinjuku Shielded wallet: a self-custody wallet that pays x402 URLs
+privately from a shielded USDC balance on Solana. Its `mcp` command runs a
+local MCP server (stdio) for your agent. Your keys never leave your machine.
 
-This package holds one wallet release, unchanged. The `shinjukuRelease` and
-`shinjukuSha256` fields in `package.json` name that release. Compare the hash
-with the Releases table in
-[ShinjukuStaition/shinjuku-shielded](https://github.com/ShinjukuStaition/shinjuku-shielded#releases).
-Each version holds one served wallet release, byte for byte: `shinjukuRelease` and `shinjukuSha256` in package.json name it, and its SHA-256 is in the Releases table of ShinjukuStaition/shinjuku-shielded. From 0.1.1 on, versions are published from GitHub Actions with npm provenance.
-
-Needs Node.js 22 or later. The package has no install scripts.
-
-## Run
+## Set up
 
 ```sh
-npx -y shinjuku-shielded@<version> help
-npx -y shinjuku-shielded@<version> help mcp
+npx -y shinjuku-shielded setup
 ```
 
-Or install it once: `npm install -g shinjuku-shielded`. This gives the
-commands `shinjuku-shielded` and `shinjuku-wallet`.
+Setup makes the wallet on this machine, a private passphrase file, and the
+checked proof tools (about 191 MB), and writes `config.json`. It also writes
+a recovery file: copy it to two offline places, then delete it from this
+machine. `--add-to claude-code` (or `claude-desktop`, `cursor`) also adds the
+server to that host's config.
 
-Pin the version in your agent config, so that each start runs the same file.
-
-## Add the MCP server
-
-Set up the wallet first (passphrase, deposit, `rpc.txt`, `proof-tools.json`).
-The full setup guide is
-[ShinjukuStaition/shinjuku-mcp](https://github.com/ShinjukuStaition/shinjuku-mcp).
-`--max-payment` and `--max-session` are optional caps, in atomic USDC units
-(50000 = 0.05 USDC); without them there is no limit. An MCP host starts the server from its own folder: use
-absolute paths.
+## Add it to your agent host
 
 Claude Code:
 
 ```sh
-claude mcp add shinjuku-pay -- npx -y shinjuku-shielded@<version> mcp \
-  --max-payment 50000 --max-session 200000 --tor \
-  --pool 45mhosfA2MuygZWeqYRVcEZX2Q3gA8KR8FwP6AZkK1zR \
-  --passphrase-file /home/you/shinjuku/passphrase.txt \
-  --rpc-file /home/you/shinjuku/rpc.txt \
-  --proof-tools /home/you/shinjuku/proof-tools.json \
-  --program 8PYPw3FSFTMbvSneXdcoH6jNoN4VD23nHwPY2A2riUy1 \
-  --memo-service https://pay.shinjukustaition.com
+claude mcp add --scope user shinjuku-shielded -- npx -y shinjuku-shielded mcp
 ```
 
-Claude Desktop (`claude_desktop_config.json`) and Cursor (`.cursor/mcp.json`
-or `~/.cursor/mcp.json`) use the same JSON:
+Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
 
 ```json
-{
-  "mcpServers": {
-    "shinjuku-pay": {
-      "command": "npx",
-      "args": [
-        "-y", "shinjuku-shielded@<version>", "mcp",
-        "--max-payment", "50000", "--max-session", "200000", "--tor",
-        "--pool", "45mhosfA2MuygZWeqYRVcEZX2Q3gA8KR8FwP6AZkK1zR",
-        "--passphrase-file", "/home/you/shinjuku/passphrase.txt",
-        "--rpc-file", "/home/you/shinjuku/rpc.txt",
-        "--proof-tools", "/home/you/shinjuku/proof-tools.json",
-        "--program", "8PYPw3FSFTMbvSneXdcoH6jNoN4VD23nHwPY2A2riUy1",
-        "--memo-service", "https://pay.shinjukustaition.com"
-      ],
-      "env": { "SHIELDED_WALLET_HOME": "/home/you/.shielded-wallet" }
-    }
-  }
-}
+{ "mcpServers": { "shinjuku-shielded": { "command": "npx", "args": ["-y", "shinjuku-shielded", "mcp"] } } }
 ```
 
-On Windows, write paths as `C:/Users/you/...`. If the host cannot find
-`npx`, use `"command": "cmd", "args": ["/c", "npx", ...]`.
+On native Windows, if the host cannot find `npx`, use `"command": "cmd"` and
+put `"/c", "npx"` at the start of `args`. To pin the version, write
+`shinjuku-shielded@0.3.54`.
+
+## Add funds
+
+Ask your agent "Add 0.50 USDC to my shielded balance". It calls
+`wallet_add_funds` and gives a one-time address. Send USDC on Solana to it
+from any wallet or exchange. Cents work (from 0.01 USDC), and you need no
+SOL. The USDC becomes private by itself while the MCP server runs.
 
-`node_modules/.bin` and the global npm folder must not be writable by other
-users: the MCP server holds your wallet keys.
+## Pay
 
-## Proof tools
+Spending limits are optional and off by default: only the balance bounds a
+payment. To set them, give setup `--max-payment`, `--max-session`, or
+`--max-cumulative`, in USDC (`0.05` = 5 cents).
 
-The proof tools are not in this package. Download them separately and check
-their hashes, as `https://shinjukustaition.com/skill.md` section 7b tells you.
-The provers are Linux programs: use Linux, or WSL on Windows. macOS is not
-supported for proofs.
+`x402_discover` finds sellers in public x402 listings, `x402_preview` shows
+the price, and `x402_pay` pays.
+
+## Needs
+
+- Node.js 22.21 or later, or Node.js 24 or later (a `--tor` run needs `NODE_USE_ENV_PROXY`, which Node.js 23 does not have).
+- Linux, or Windows with WSL. macOS is not supported: the provers are Linux
+  programs.
+
+The package has no install scripts. `node_modules/.bin` and the global npm
+folder must not be writable by other users: the MCP server holds your wallet
+keys.
+
+This package holds one wallet release, unchanged. The `shinjukuRelease` and
+`shinjukuSha256` fields in `package.json` name that release. Compare the hash
+with the Releases table in
+[ShinjukuStaition/shinjuku-shielded](https://github.com/ShinjukuStaition/shinjuku-shielded#releases).
+From 0.1.1 on, versions are published from GitHub Actions with npm
+provenance.
+
+The full guide is
+[ShinjukuStaition/shinjuku-mcp](https://github.com/ShinjukuStaition/shinjuku-mcp).
 
 ## License
 

package/manifest.json

@@ -1,9 +1,9 @@
 {
   "schema": "carbon-shielded-wallet/bundle-manifest/v1",
   "file": "shinjuku-wallet.mjs",
-  "sha256": "dfff21825cc4452582636aa8ccf6fe96823b1f335bdb0514c723f9a5ae6f02dd",
-  "bytes": 11614411,
-  "sourceCommit": "86a54eb7c5ee61c37ab4053b7282e6e5124e1b6f",
+  "sha256": "285d2c1db3cfd9d8a5df47acc2c70e7e65816539c3f2ad216ede6a16358d762b",
+  "bytes": 12117554,
+  "sourceCommit": "9df252eb8f4e71413bfcb8ff3ad289a96079e147",
   "sourceDirty": false,
   "installRecordMatchesLockfile": true,
   "releaseRule": "valid only when two fresh npm ci --ignore-scripts builds on different OSes give the same sha256; installRecordMatchesLockfile true means every entry npm installed equals its package-lock.json entry and every entry not marked optional, devOptional included, is installed: an optional entry (a package for another platform) may be absent",
@@ -1281,5 +1281,6 @@
       "name": "@noble/hashes",
       "version": "1.8.0"
     }
-  ]
+  ],
+  "publishedAt": "2026-10-21T20:41:22.351Z"
 }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "shinjuku-shielded",
-  "version": "0.3.52",
+  "version": "0.3.54",
   "mcpName": "io.github.ShinjukuStaition/shinjuku-mcp",
   "description": "Shinjuku Shielded, the private x402 facilitator on Solana: the self-custody wallet CLI and its MCP server. Shield, pay, and unshield USDC from any MCP agent, under caps you set.",
-  "shinjukuRelease": "dfff2182",
-  "shinjukuSha256": "dfff21825cc4452582636aa8ccf6fe96823b1f335bdb0514c723f9a5ae6f02dd",
+  "shinjukuRelease": "285d2c1d",
+  "shinjukuSha256": "285d2c1db3cfd9d8a5df47acc2c70e7e65816539c3f2ad216ede6a16358d762b",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "Shinjuku Shielded",
   "homepage": "https://github.com/ShinjukuStaition/shinjuku-mcp#readme",
@@ -36,7 +36,7 @@
     "manifest.json"
   ],
   "engines": {
-    "node": ">=22"
+    "node": "^22.21.0 || >=24.0.0"
   },
   "publishConfig": {
     "access": "public",