shinjuku-shield 0.3.80 → 0.3.82
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +46 -13
- package/manifest.json +4 -4
- package/package.json +3 -3
- package/shinjuku-wallet.mjs +5637 -2498
package/README.md
CHANGED
|
@@ -1,13 +1,18 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Shinjuku Shield
|
|
2
2
|
|
|
3
|
-
The Shinjuku
|
|
4
|
-
privately from a shielded USDC balance on Solana.
|
|
5
|
-
|
|
3
|
+
The Shinjuku Shield wallet: a self-custody wallet that pays x402 URLs
|
|
4
|
+
privately from a shielded USDC balance on Solana. It also pays for AI
|
|
5
|
+
answers privately, in a terminal chat or for your agent app. Its `mcp`
|
|
6
|
+
command runs a local MCP server (stdio) for your agent. Your keys never
|
|
7
|
+
leave your machine.
|
|
8
|
+
|
|
9
|
+
This is version 0.3.82. The npm packages `shinjuku-shield` and
|
|
10
|
+
`shinjuku-shielded` hold the same files; `shinjuku` is the short command.
|
|
6
11
|
|
|
7
12
|
## Set up
|
|
8
13
|
|
|
9
14
|
```sh
|
|
10
|
-
npx -y --no-audit --no-fund shinjuku-
|
|
15
|
+
npx -y --no-audit --no-fund shinjuku-shield@0.3.82 setup
|
|
11
16
|
```
|
|
12
17
|
|
|
13
18
|
Setup makes the wallet on this machine, a private passphrase file, and the
|
|
@@ -16,30 +21,40 @@ a recovery file: copy it to two offline places, then delete it from this
|
|
|
16
21
|
machine. `--add-to claude-code` (or `claude-desktop`, `cursor`) also adds the
|
|
17
22
|
server to that host's config.
|
|
18
23
|
|
|
24
|
+
## The `shinjuku` command
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
npm install -g shinjuku@0.3.82
|
|
28
|
+
shinjuku help
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Every wallet command works after `shinjuku`, for example `shinjuku balance`,
|
|
32
|
+
`shinjuku chat` or `shinjuku infer start`.
|
|
33
|
+
|
|
19
34
|
## Add it to your agent host
|
|
20
35
|
|
|
21
36
|
Claude Code:
|
|
22
37
|
|
|
23
38
|
```sh
|
|
24
|
-
claude mcp add --scope user shinjuku-shielded -- npx -y --no-audit --no-fund shinjuku-
|
|
39
|
+
claude mcp add --scope user shinjuku-shielded -- npx -y --no-audit --no-fund shinjuku-shield@0.3.82 mcp
|
|
25
40
|
```
|
|
26
41
|
|
|
27
42
|
Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
|
|
28
43
|
|
|
29
44
|
```json
|
|
30
|
-
{ "mcpServers": { "shinjuku-shielded": { "command": "npx", "args": ["-y", "--no-audit", "--no-fund", "shinjuku-
|
|
45
|
+
{ "mcpServers": { "shinjuku-shielded": { "command": "npx", "args": ["-y", "--no-audit", "--no-fund", "shinjuku-shield@0.3.82", "mcp"] } } }
|
|
31
46
|
```
|
|
32
47
|
|
|
33
48
|
On native Windows, if the host cannot find `npx`, use `"command": "cmd"` and
|
|
34
|
-
put `"/c", "npx"` at the start of `args`.
|
|
35
|
-
`shinjuku-shielded
|
|
49
|
+
put `"/c", "npx"` at the start of `args`. The server keeps the name
|
|
50
|
+
`shinjuku-shielded` in host configs.
|
|
36
51
|
|
|
37
52
|
## Add funds
|
|
38
53
|
|
|
39
54
|
Ask your agent "Add 0.50 USDC to my shielded balance". It calls
|
|
40
55
|
`wallet_add_funds` and gives a one-time address. Send USDC on Solana to it
|
|
41
56
|
from any wallet or exchange. Cents work (from 0.01 USDC), and you need no
|
|
42
|
-
SOL. The USDC becomes private by itself
|
|
57
|
+
SOL. The USDC becomes private by itself.
|
|
43
58
|
|
|
44
59
|
## Pay
|
|
45
60
|
|
|
@@ -50,11 +65,30 @@ payment. To set them, give setup `--max-payment`, `--max-session`, or
|
|
|
50
65
|
`x402_discover` finds sellers in public x402 listings, `x402_preview` shows
|
|
51
66
|
the price, and `x402_pay` pays.
|
|
52
67
|
|
|
68
|
+
## Private AI
|
|
69
|
+
|
|
70
|
+
Each answer is paid from your shielded balance, through Tor: the AI
|
|
71
|
+
provider sees your words, not your IP address, and the chain does not show
|
|
72
|
+
which wallet paid. The wallet keeps no copy of a conversation.
|
|
73
|
+
|
|
74
|
+
- `shinjuku chat`: a chat in this terminal. Each answer has a cap (0.05 USDC
|
|
75
|
+
by default) and each chat has a cap (1 USDC by default).
|
|
76
|
+
- `shinjuku infer start`: a local AI address for an agent app that speaks
|
|
77
|
+
the OpenAI API. It prints the `base_url` (`http://127.0.0.1:11402/v1`) and
|
|
78
|
+
an api key. It keeps running in the background after the terminal closes;
|
|
79
|
+
`shinjuku infer status` shows it, and `shinjuku infer stop` stops it. Your
|
|
80
|
+
agent can also start it with the MCP tool `inference_server`. It serves
|
|
81
|
+
the OpenAI Chat Completions API (`/v1/chat/completions`, streaming too)
|
|
82
|
+
and `/v1/models`. Apps that use the OpenAI Responses API
|
|
83
|
+
(`/v1/responses`) do not work with it yet.
|
|
84
|
+
- `inference_chat` (MCP): one answer for your agent.
|
|
85
|
+
|
|
53
86
|
## Needs
|
|
54
87
|
|
|
55
88
|
- 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).
|
|
56
89
|
- Linux, or Windows with WSL. macOS is not supported: the provers are Linux
|
|
57
90
|
programs.
|
|
91
|
+
- Tor, for private AI (and for `--tor`).
|
|
58
92
|
|
|
59
93
|
The package has no install scripts. `node_modules/.bin` and the global npm
|
|
60
94
|
folder must not be writable by other users: the MCP server holds your wallet
|
|
@@ -64,15 +98,14 @@ This package holds one wallet release, unchanged. The `shinjukuRelease` and
|
|
|
64
98
|
`shinjukuSha256` fields in `package.json` name that release. Compare the hash
|
|
65
99
|
with the Releases table in
|
|
66
100
|
[ShinjukuStaition/shinjuku-shielded](https://github.com/ShinjukuStaition/shinjuku-shielded#releases).
|
|
67
|
-
|
|
68
|
-
provenance.
|
|
101
|
+
Versions are published from GitHub Actions with npm provenance.
|
|
69
102
|
|
|
70
103
|
The full guide is
|
|
71
104
|
[ShinjukuStaition/shinjuku-mcp](https://github.com/ShinjukuStaition/shinjuku-mcp).
|
|
72
105
|
|
|
73
106
|
## License
|
|
74
107
|
|
|
75
|
-
`LICENSE.txt` (Shinjuku Shielded wallet, all rights reserved) and
|
|
108
|
+
`LICENSE.txt` (the Shinjuku Shielded wallet license, all rights reserved) and
|
|
76
109
|
`THIRD_PARTY_NOTICES.txt` (the open-source packages inside the file) ship
|
|
77
110
|
unchanged from the release. `manifest.json` names the source commit and every
|
|
78
111
|
bundled package.
|
package/manifest.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema": "carbon-shielded-wallet/bundle-manifest/v1",
|
|
3
3
|
"file": "shinjuku-wallet.mjs",
|
|
4
|
-
"sha256": "
|
|
5
|
-
"bytes":
|
|
6
|
-
"sourceCommit": "
|
|
4
|
+
"sha256": "eaf7063ed1fe0dbcbf1c1f689e1ce60018401d669fe8bad7a7d4483cb875da0a",
|
|
5
|
+
"bytes": 12477292,
|
|
6
|
+
"sourceCommit": "9e701778bde2c7c186ff3ca9b631773c3abc02b2",
|
|
7
7
|
"sourceDirty": false,
|
|
8
8
|
"installRecordMatchesLockfile": true,
|
|
9
9
|
"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",
|
|
@@ -1282,5 +1282,5 @@
|
|
|
1282
1282
|
"version": "1.8.0"
|
|
1283
1283
|
}
|
|
1284
1284
|
],
|
|
1285
|
-
"publishedAt": "2026-10-
|
|
1285
|
+
"publishedAt": "2026-10-23T17:26:04.670Z"
|
|
1286
1286
|
}
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "shinjuku-shield",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.82",
|
|
4
4
|
"mcpName": "io.github.ShinjukuStaition/shinjuku-mcp",
|
|
5
5
|
"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.",
|
|
6
|
-
"shinjukuRelease": "
|
|
7
|
-
"shinjukuSha256": "
|
|
6
|
+
"shinjukuRelease": "eaf7063e",
|
|
7
|
+
"shinjukuSha256": "eaf7063ed1fe0dbcbf1c1f689e1ce60018401d669fe8bad7a7d4483cb875da0a",
|
|
8
8
|
"license": "SEE LICENSE IN LICENSE.txt",
|
|
9
9
|
"author": "Shinjuku Shielded",
|
|
10
10
|
"homepage": "https://github.com/ShinjukuStaition/shinjuku-mcp#readme",
|