shinjuku-shielded 0.3.51 → 0.3.53

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.53`.
+
+## 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-total` (atomic USDC: `50000` = 0.05 USDC).
 
-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 or later.
+- 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": "22fd74c53ae9aa03fb33a848794e41f62e92c1d20e95697cc9d3233ca76c2432",
-  "bytes": 11593541,
-  "sourceCommit": "f28317a1ed02d0eb6ec766b432d23a3da0162d7b",
+  "sha256": "667ac38b9b42b60853ea07024e81b1074105b3dbfba4346d61d86ef3aabef1b3",
+  "bytes": 11939765,
+  "sourceCommit": "af521c1215bc2a8eed393eea425f908067808e8c",
   "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",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "shinjuku-shielded",
-  "version": "0.3.51",
+  "version": "0.3.53",
   "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": "22fd74c5",
-  "shinjukuSha256": "22fd74c53ae9aa03fb33a848794e41f62e92c1d20e95697cc9d3233ca76c2432",
+  "shinjukuRelease": "667ac38b",
+  "shinjukuSha256": "667ac38b9b42b60853ea07024e81b1074105b3dbfba4346d61d86ef3aabef1b3",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "Shinjuku Shielded",
   "homepage": "https://github.com/ShinjukuStaition/shinjuku-mcp#readme",