mnemospark 0.1.18 → 0.1.19
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 +134 -1
- package/dist/cli.js +1067 -773
- package/dist/cli.js.map +1 -1
- package/dist/index.js +1000 -706
- package/dist/index.js.map +1 -1
- package/openclaw.plugin.json +2 -2
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,3 +1,136 @@
|
|
|
1
1
|
# mnemospark
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Wallet and go. 💙**
|
|
4
|
+
_No forms. No email. Just Base. 💙_
|
|
5
|
+
|
|
6
|
+
mnemospark is an agentic service layer for OpenClaw and a standalone x402 payment and wallet-proof verification backend. It provides encrypted, authenticated, and fully autonomous access to cloud infrastructure and proprietary data, paid via x402 with USDC on Base. No human onboarding. No API keys. The blockchain transaction is the record.
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## What is mnemospark?
|
|
11
|
+
|
|
12
|
+
mnemospark connects OpenClaw agents to cloud workflows with wallet-native auth + payment rails.
|
|
13
|
+
|
|
14
|
+
- **Wallet-proof authentication** for storage/API actions
|
|
15
|
+
- **x402-native payments** with USDC on Base
|
|
16
|
+
- **Agent-first flow** (quote → pay → provision)
|
|
17
|
+
- **Encrypted payload support** and structured request signing
|
|
18
|
+
- **Built for automation** (cron-friendly, idempotent-friendly workflows)
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Quick Start
|
|
23
|
+
|
|
24
|
+
### 1) Install the plugin in OpenClaw
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
openclaw plugins install mnemospark
|
|
28
|
+
openclaw gateway start
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
> Plugin registration is done by `openclaw plugins install mnemospark`.
|
|
32
|
+
|
|
33
|
+
### 2) (Optional) Initialize wallet helpers
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
npx mnemospark install --standard
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
This creates/reuses local wallet helper files under `~/.openclaw/mnemospark/`.
|
|
40
|
+
|
|
41
|
+
### 3) Restart gateway after updates
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
openclaw gateway restart
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### 4) Use slash commands in OpenClaw chat
|
|
48
|
+
|
|
49
|
+
- `/mnemospark-wallet` → wallet status/export/help
|
|
50
|
+
- `/mnemospark-cloud help` → storage command guide
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Core Commands
|
|
55
|
+
|
|
56
|
+
Use via `/mnemospark-cloud ...` in OpenClaw chat.
|
|
57
|
+
|
|
58
|
+
### Get a storage quote
|
|
59
|
+
|
|
60
|
+
```text
|
|
61
|
+
/mnemospark-cloud price-storage --wallet-address <addr> --object-id <id> --object-id-hash <sha256> --gb <gb> --provider <provider> --region <region>
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Upload using quote
|
|
65
|
+
|
|
66
|
+
```text
|
|
67
|
+
/mnemospark-cloud upload --quote-id <quote-id> --wallet-address <addr> --object-id <id> --object-id-hash <sha256>
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### List objects
|
|
71
|
+
|
|
72
|
+
```text
|
|
73
|
+
/mnemospark-cloud ls --wallet-address <addr> --object-key <object-key>
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Download object
|
|
77
|
+
|
|
78
|
+
```text
|
|
79
|
+
/mnemospark-cloud download --wallet-address <addr> --object-key <object-key>
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Delete object
|
|
83
|
+
|
|
84
|
+
```text
|
|
85
|
+
/mnemospark-cloud delete --wallet-address <addr> --object-key <object-key>
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Payment Model (x402 + Base)
|
|
91
|
+
|
|
92
|
+
mnemospark follows a quote-and-pay execution model:
|
|
93
|
+
|
|
94
|
+
1. Agent requests a quote.
|
|
95
|
+
2. Agent provides wallet-proof + payment authorization.
|
|
96
|
+
3. Backend verifies payment/auth context.
|
|
97
|
+
4. Storage action executes.
|
|
98
|
+
|
|
99
|
+
The blockchain transaction is the payment record.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Security Model
|
|
104
|
+
|
|
105
|
+
- Wallet-signed request authentication
|
|
106
|
+
- Encrypted payload flow (AES-256-GCM request contract)
|
|
107
|
+
- Idempotency-aware upload/payment handling
|
|
108
|
+
- Structured auth/payment event logging for traceability
|
|
109
|
+
|
|
110
|
+
> Keep wallet private keys secure. Anyone with the key can control wallet-authorized actions.
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## Typical Workflow
|
|
115
|
+
|
|
116
|
+
1. Install plugin
|
|
117
|
+
2. Fund Base wallet with USDC
|
|
118
|
+
3. Request quote
|
|
119
|
+
4. Execute upload
|
|
120
|
+
5. Confirm/list/download/delete as needed
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## Troubleshooting
|
|
125
|
+
|
|
126
|
+
- **Missing wallet/auth errors**: verify wallet key is present and request signature headers are generated.
|
|
127
|
+
- **402 payment required**: expected in challenge flow; ensure client retries with payment authorization.
|
|
128
|
+
- **Upload/storage backend errors**: verify cloud permissions (e.g., bucket access + IAM role rights).
|
|
129
|
+
- **Command not recognized**: confirm plugin installed and gateway restarted.
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## Repos
|
|
134
|
+
|
|
135
|
+
- Plugin: `pawlsclick/mnemospark`
|
|
136
|
+
- Backend: `pawlsclick/mnemospark-backend`
|