@supercuts-walrus/sdk 0.1.3 → 0.1.5

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.
Files changed (2) hide show
  1. package/README.md +20 -5
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -22,10 +22,12 @@ blocked build makes `pnpm exec` refuse to run.
22
22
  ```sh
23
23
  mkdir my-buyer && cd my-buyer && pnpm init
24
24
  printf 'allowBuilds:\n blake-hash: true\n' > pnpm-workspace.yaml
25
- pnpm add @supercuts-walrus/sdk@0.1.3
25
+ pnpm add @supercuts-walrus/sdk@0.1.5 @supercuts-walrus/backend@0.1.5
26
26
  ```
27
27
 
28
- With npm, run `npm install @supercuts-walrus/sdk@0.1.3` instead; npm needs no build approval.
28
+ Add the backend explicitly. It provides the `supercuts`, `supercuts-embedding-adapter`, and
29
+ `supercuts-memory-worker` commands, and pnpm only links commands from direct dependencies. With npm, run
30
+ `npm install @supercuts-walrus/sdk@0.1.5 @supercuts-walrus/backend@0.1.5` instead; npm needs no build approval.
29
31
 
30
32
  **2. Store credentials in owner-only files.** Never paste them into an agent.
31
33
 
@@ -70,9 +72,22 @@ pnpm exec supercuts policy approve-seller --home ./buyer --capability-id market-
70
72
  pnpm exec supercuts onboarding doctor --home ./buyer
71
73
  ```
72
74
 
73
- The npm package has everything public x402 payments need. Shielded payments additionally require the
74
- hash-pinned proving artifacts. Until those are installed, the doctor reports `shielded-proofs` as
75
- `unavailable`.
75
+ The npm package has everything public x402 payments need. For shielded (private) payments, install
76
+ the hash-pinned v2 proving keys once per machine (about 370 MB):
77
+
78
+ ```sh
79
+ pnpm exec supercuts proofs install
80
+ pnpm exec supercuts proofs status
81
+ ```
82
+
83
+ The command downloads every file from the pinned `proofs-v2` release, checks each SHA-256 against the
84
+ index shipped in the package, and only then installs them in `~/.supercuts/proofs/v2` (override with
85
+ `SUPERCUTS_PROOFS_DIR`). Until then the doctor reports `shielded-proofs` as `unavailable`. Proofs use
86
+ the bundled SnarkJS; set `SUPERCUTS_RAPIDSNARK` to a RapidSnark binary for faster proving.
87
+
88
+ When the owner stores a privacy rule for a seller (`supercuts policy add --home ./buyer --capability-id <id>`), that Walrus Memory
89
+ outranks an agent's `requestedRail: "x402"`: the deal settles through the shielded pool instead, and
90
+ the evidence shows `memoryInfluence.changedRail` with reason `MEMORY_PRIVACY_OVERRODE_RAIL`.
76
91
 
77
92
  **5. Run a deal.**
78
93
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@supercuts-walrus/sdk",
3
- "version": "0.1.3",
3
+ "version": "0.1.5",
4
4
  "description": "Typed, role-scoped TypeScript SDK for Supercuts",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -20,7 +20,7 @@
20
20
  "node": ">=22.13"
21
21
  },
22
22
  "dependencies": {
23
- "@supercuts-walrus/backend": "0.1.3"
23
+ "@supercuts-walrus/backend": "0.1.5"
24
24
  },
25
25
  "devDependencies": {
26
26
  "@types/node": "^22.10.0",