@cryptoslip/mcp 1.0.0 → 1.0.1
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/LICENSE +21 -21
- package/README.md +66 -66
- package/SKILL.md +108 -108
- package/package.json +79 -78
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 NARA Protocol & CryptoSLIP Contributors
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 NARA Protocol & CryptoSLIP Contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
# `@cryptoslip/mcp` — PocketSlip MCP Server for Autonomous Agents
|
|
2
|
-
|
|
3
|
-
Non-custodial Model Context Protocol (MCP) server for **CryptoSLIP Protocol V3.2** (`v33`: `0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB`) on **Base Mainnet (`8453`)**.
|
|
4
|
-
|
|
5
|
-
Instead of handing an LLM standing authority over a master private key, hand it a bounded `$5.00 USDC` (`ETH`, `cbBTC`, or `NARA`) `#` Slip URL via `CRYPTOSLIP_URL`.
|
|
6
|
-
|
|
7
|
-
## Security Architecture
|
|
8
|
-
|
|
9
|
-
- **`V-01` `<1s` Boot Auto-Keep Rotation:** On startup (`bootAndRotate()`), if the slip is unrotated (`nonces == 0`), `PocketSlipVault` immediately executes an on-chain `Keep` (`0%` protocol fee), rotating `claimSigner` to a fresh local key persisted with `0600` permissions. The original `.env` link is invalidated on-chain, bounding prompt-injection risk strictly to that single slip.
|
|
10
|
-
- **`V-02` Out-of-Context `BoundedAgentPolicy` Firewall:** Deterministically enforces `maxPerCallUsdMicro`, `maxSpendsPerMinute`, `maxDailyUsdMicro`, `assertSafeDestination` (blocking burn addresses, token contracts, vaults, routers, and known public test addresses), optional recipient/domain allowlists, `redactSecretsFromToolOutput`, and `100%` Uniswap V4 `NARALiquidityHookV5` (`0x07d8F2Dfd121B10dE3176DeAb6A8C0eaa2646aCC`) swap enforcement.
|
|
11
|
-
- **`V-03` Per-Slip Mutex & `$0.10` Remainder Guard:** Serializes concurrent tool calls via `SlipMutex` and prevents sub-minimum change reverts (`$0.10 USDC`, `100 sats` cbBTC, `0.000001` ETH/NARA).
|
|
12
|
-
- **`V-04` Circle `TokenPaymasterV08` Default:** Headless agent operations default to self-funded `USDC` network fees via Circle `TokenPaymasterV08` (`0x0578cFB241215b77442a541325d6A4E6dFE700Ec`) + `Simple7702Account` (`0xe6Cae83BdE06E4c305530e199D7217f42808555B`).
|
|
13
|
-
|
|
14
|
-
## Quick Start
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
CRYPTOSLIP_URL="<YOUR_SLIP_URL>" npx @cryptoslip/mcp
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
### Claude Desktop / Claude Code / Cursor Configuration
|
|
21
|
-
|
|
22
|
-
```json
|
|
23
|
-
{
|
|
24
|
-
"mcpServers": {
|
|
25
|
-
"cryptoslip": {
|
|
26
|
-
"command": "npx",
|
|
27
|
-
"args": ["-y", "@cryptoslip/mcp"],
|
|
28
|
-
"env": {
|
|
29
|
-
"CRYPTOSLIP_URL": "<YOUR_SLIP_URL>",
|
|
30
|
-
"CRYPTOSLIP_MAX_PER_CALL_USD": "0.50",
|
|
31
|
-
"CRYPTOSLIP_MAX_DAILY_USD": "5.00",
|
|
32
|
-
"CRYPTOSLIP_MAX_SPENDS_PER_MIN": "3"
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## Tools Exposed Over Stdio
|
|
40
|
-
|
|
41
|
-
| Tool | Purpose |
|
|
42
|
-
| :--- | :--- |
|
|
43
|
-
| `cryptoslip_status` | Redacted slip & wallet balance, active vault (`v33`), rotation status, and policy caps (zero raw keys). |
|
|
44
|
-
| `cryptoslip_pay_human` | Splits or creates a `#startapp=slip_...` link (or 12-char `scrypt` code) for X/Telegram/SMS human bounties (`No take-back` or revocable). |
|
|
45
|
-
| `cryptoslip_batch_payout` | 1-tx `Multicall3` batch dispenser (`1..500` items) returning JSON or CSV `#` links with `bc_ea68lz8s` Builder Code. |
|
|
46
|
-
| `cryptoslip_pay_x402_or_merchant` | Pays an HTTP `402` endpoint or merchant wallet via `splitAndPay` under `BoundedAgentPolicy` + `SlipMutex`. |
|
|
47
|
-
| `cryptoslip_verify_or_export_receipt` | Verifies or exports a cryptographic `PaymentReceiptBundleV1` (`JSON`, `CSV`, or printable HTML). |
|
|
48
|
-
| `cryptoslip_reclaim_unclaimed` | `0%`-fee `refundSlipDirect` recovery for unclaimed revocable (`cancelLockedUntil == 0`) DM slips. |
|
|
49
|
-
| `cryptoslip_withdraw_referrals` | Claims `0.25%` (`50/50` share) lifetime `referralCredits` on Base Mainnet. |
|
|
50
|
-
|
|
51
|
-
## Environment Variables
|
|
52
|
-
|
|
53
|
-
| Variable | Default | Description |
|
|
54
|
-
| :--- | :--- | :--- |
|
|
55
|
-
| `CRYPTOSLIP_URL` | *(required for PocketSlip)* | `#startapp=slip_...` pocket-funds URL; rotated on boot via `Keep` (`0%` fee). |
|
|
56
|
-
| `CRYPTOSLIP_STATE_PATH` | `~/.cryptoslip-mcp/pocket-state.json` | `0600` local file storing rotated local signer state across restarts. |
|
|
57
|
-
| `CRYPTOSLIP_RPC_URL` | `https://mainnet.base.org` | Base Mainnet (`8453`) JSON-RPC endpoint. |
|
|
58
|
-
| `CRYPTOSLIP_MAX_PER_CALL_USD` | `"0.50"` | Maximum USD-equivalent value allowed per single spend call. |
|
|
59
|
-
| `CRYPTOSLIP_MAX_DAILY_USD` | `"5.00"` | Maximum rolling 24-hour USD-equivalent spend limit. |
|
|
60
|
-
| `CRYPTOSLIP_MAX_SPENDS_PER_MIN` | `"3"` | Sliding-window per-minute spend count limit. |
|
|
61
|
-
| `CRYPTOSLIP_ALLOWED_RECIPIENTS` | *(unset)* | Optional comma-separated `0x...` recipient allowlist. |
|
|
62
|
-
| `CRYPTOSLIP_ALLOWED_DOMAINS` | *(unset)* | Optional comma-separated HTTPS hostname allowlist for HTTP `402` endpoints. |
|
|
63
|
-
|
|
64
|
-
## OpenClaw / Skill Manifest
|
|
65
|
-
|
|
66
|
-
See [`SKILL.md`](./SKILL.md) for the ready-to-drop skill manifest.
|
|
1
|
+
# `@cryptoslip/mcp` — PocketSlip MCP Server for Autonomous Agents
|
|
2
|
+
|
|
3
|
+
Non-custodial Model Context Protocol (MCP) server for **CryptoSLIP Protocol V3.2** (`v33`: `0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB`) on **Base Mainnet (`8453`)**.
|
|
4
|
+
|
|
5
|
+
Instead of handing an LLM standing authority over a master private key, hand it a bounded `$5.00 USDC` (`ETH`, `cbBTC`, or `NARA`) `#` Slip URL via `CRYPTOSLIP_URL`.
|
|
6
|
+
|
|
7
|
+
## Security Architecture
|
|
8
|
+
|
|
9
|
+
- **`V-01` `<1s` Boot Auto-Keep Rotation:** On startup (`bootAndRotate()`), if the slip is unrotated (`nonces == 0`), `PocketSlipVault` immediately executes an on-chain `Keep` (`0%` protocol fee), rotating `claimSigner` to a fresh local key persisted with `0600` permissions. The original `.env` link is invalidated on-chain, bounding prompt-injection risk strictly to that single slip.
|
|
10
|
+
- **`V-02` Out-of-Context `BoundedAgentPolicy` Firewall:** Deterministically enforces `maxPerCallUsdMicro`, `maxSpendsPerMinute`, `maxDailyUsdMicro`, `assertSafeDestination` (blocking burn addresses, token contracts, vaults, routers, and known public test addresses), optional recipient/domain allowlists, `redactSecretsFromToolOutput`, and `100%` Uniswap V4 `NARALiquidityHookV5` (`0x07d8F2Dfd121B10dE3176DeAb6A8C0eaa2646aCC`) swap enforcement.
|
|
11
|
+
- **`V-03` Per-Slip Mutex & `$0.10` Remainder Guard:** Serializes concurrent tool calls via `SlipMutex` and prevents sub-minimum change reverts (`$0.10 USDC`, `100 sats` cbBTC, `0.000001` ETH/NARA).
|
|
12
|
+
- **`V-04` Circle `TokenPaymasterV08` Default:** Headless agent operations default to self-funded `USDC` network fees via Circle `TokenPaymasterV08` (`0x0578cFB241215b77442a541325d6A4E6dFE700Ec`) + `Simple7702Account` (`0xe6Cae83BdE06E4c305530e199D7217f42808555B`).
|
|
13
|
+
|
|
14
|
+
## Quick Start
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
CRYPTOSLIP_URL="<YOUR_SLIP_URL>" npx @cryptoslip/mcp
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
### Claude Desktop / Claude Code / Cursor Configuration
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"mcpServers": {
|
|
25
|
+
"cryptoslip": {
|
|
26
|
+
"command": "npx",
|
|
27
|
+
"args": ["-y", "@cryptoslip/mcp"],
|
|
28
|
+
"env": {
|
|
29
|
+
"CRYPTOSLIP_URL": "<YOUR_SLIP_URL>",
|
|
30
|
+
"CRYPTOSLIP_MAX_PER_CALL_USD": "0.50",
|
|
31
|
+
"CRYPTOSLIP_MAX_DAILY_USD": "5.00",
|
|
32
|
+
"CRYPTOSLIP_MAX_SPENDS_PER_MIN": "3"
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Tools Exposed Over Stdio
|
|
40
|
+
|
|
41
|
+
| Tool | Purpose |
|
|
42
|
+
| :--- | :--- |
|
|
43
|
+
| `cryptoslip_status` | Redacted slip & wallet balance, active vault (`v33`), rotation status, and policy caps (zero raw keys). |
|
|
44
|
+
| `cryptoslip_pay_human` | Splits or creates a `#startapp=slip_...` link (or 12-char `scrypt` code) for X/Telegram/SMS human bounties (`No take-back` or revocable). |
|
|
45
|
+
| `cryptoslip_batch_payout` | 1-tx `Multicall3` batch dispenser (`1..500` items) returning JSON or CSV `#` links with `bc_ea68lz8s` Builder Code. |
|
|
46
|
+
| `cryptoslip_pay_x402_or_merchant` | Pays an HTTP `402` endpoint or merchant wallet via `splitAndPay` under `BoundedAgentPolicy` + `SlipMutex`. |
|
|
47
|
+
| `cryptoslip_verify_or_export_receipt` | Verifies or exports a cryptographic `PaymentReceiptBundleV1` (`JSON`, `CSV`, or printable HTML). |
|
|
48
|
+
| `cryptoslip_reclaim_unclaimed` | `0%`-fee `refundSlipDirect` recovery for unclaimed revocable (`cancelLockedUntil == 0`) DM slips. |
|
|
49
|
+
| `cryptoslip_withdraw_referrals` | Claims `0.25%` (`50/50` share) lifetime `referralCredits` on Base Mainnet. |
|
|
50
|
+
|
|
51
|
+
## Environment Variables
|
|
52
|
+
|
|
53
|
+
| Variable | Default | Description |
|
|
54
|
+
| :--- | :--- | :--- |
|
|
55
|
+
| `CRYPTOSLIP_URL` | *(required for PocketSlip)* | `#startapp=slip_...` pocket-funds URL; rotated on boot via `Keep` (`0%` fee). |
|
|
56
|
+
| `CRYPTOSLIP_STATE_PATH` | `~/.cryptoslip-mcp/pocket-state.json` | `0600` local file storing rotated local signer state across restarts. |
|
|
57
|
+
| `CRYPTOSLIP_RPC_URL` | `https://mainnet.base.org` | Base Mainnet (`8453`) JSON-RPC endpoint. |
|
|
58
|
+
| `CRYPTOSLIP_MAX_PER_CALL_USD` | `"0.50"` | Maximum USD-equivalent value allowed per single spend call. |
|
|
59
|
+
| `CRYPTOSLIP_MAX_DAILY_USD` | `"5.00"` | Maximum rolling 24-hour USD-equivalent spend limit. |
|
|
60
|
+
| `CRYPTOSLIP_MAX_SPENDS_PER_MIN` | `"3"` | Sliding-window per-minute spend count limit. |
|
|
61
|
+
| `CRYPTOSLIP_ALLOWED_RECIPIENTS` | *(unset)* | Optional comma-separated `0x...` recipient allowlist. |
|
|
62
|
+
| `CRYPTOSLIP_ALLOWED_DOMAINS` | *(unset)* | Optional comma-separated HTTPS hostname allowlist for HTTP `402` endpoints. |
|
|
63
|
+
|
|
64
|
+
## OpenClaw / Skill Manifest
|
|
65
|
+
|
|
66
|
+
See [`SKILL.md`](./SKILL.md) for the ready-to-drop skill manifest.
|
package/SKILL.md
CHANGED
|
@@ -1,108 +1,108 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: cryptoslip-pocket-slip
|
|
3
|
-
description: Non-custodial Base Mainnet (8453) PocketSlip wallet and settlement MCP skill for AI agents. Provision an agent with a $5 USDC, ETH, cbBTC, or NARA CryptoSLIP URL instead of a master wallet private key; auto-rotates on boot (<1s Keep at 0% fee), enforces an out-of-context BoundedAgentPolicy spend firewall, pays HTTP 402 APIs and merchants, sends 1-tap Telegram/X/SMS human bounties, executes 1-tx Multicall3 batch payouts, verifies cryptographic payment receipts, reclaims unclaimed slips, and collects 0.25% lifetime referral rewards.
|
|
4
|
-
license: MIT
|
|
5
|
-
compatibility: Node.js >= 22. Run via `npx @cryptoslip/mcp` with `CRYPTOSLIP_URL="<YOUR_SLIP_URL>"`.
|
|
6
|
-
metadata:
|
|
7
|
-
author: nara-protocol
|
|
8
|
-
version: "1.0.0"
|
|
9
|
-
chain: base-mainnet-8453
|
|
10
|
-
mcp-package: "@cryptoslip/mcp"
|
|
11
|
-
sdk-package: "@cryptoslip/sdk"
|
|
12
|
-
registry-targets:
|
|
13
|
-
- openclaw-skills
|
|
14
|
-
- clawhub
|
|
15
|
-
- rentahuman-mcp
|
|
16
|
-
- claude-code
|
|
17
|
-
allowed-tools:
|
|
18
|
-
- mcp__cryptoslip__cryptoslip_status
|
|
19
|
-
- mcp__cryptoslip__cryptoslip_pay_human
|
|
20
|
-
- mcp__cryptoslip__cryptoslip_batch_payout
|
|
21
|
-
- mcp__cryptoslip__cryptoslip_pay_x402_or_merchant
|
|
22
|
-
- mcp__cryptoslip__cryptoslip_verify_or_export_receipt
|
|
23
|
-
- mcp__cryptoslip__cryptoslip_reclaim_unclaimed
|
|
24
|
-
- mcp__cryptoslip__cryptoslip_withdraw_referrals
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
# CryptoSLIP PocketSlip Skill (`@cryptoslip/mcp`)
|
|
28
|
-
|
|
29
|
-
Give any autonomous agent bounded pocket funds on **Base Mainnet (`8453`)** using a single CryptoSLIP `#` URL — **zero master wallet private key required**.
|
|
30
|
-
|
|
31
|
-
## Why PocketSlip Exists
|
|
32
|
-
|
|
33
|
-
1. **Zero Master Key Exposure (`V-01` Boot Auto-Keep):** Provision the MCP server with `CRYPTOSLIP_URL="<YOUR_SLIP_URL>"` (for example, a `$5.00 USDC` slip). On startup (`bootAndRotate()`), if the slip is unrotated (`nonces == 0`), `PocketSlipVault` immediately executes an on-chain `Keep` (`0%` protocol fee), rotating `claimSigner` to a fresh local key stored with `0600` file permissions. The original `.env` link becomes invalid on-chain in under a second, capping worst-case prompt-injection exposure strictly to that single slip.
|
|
34
|
-
2. **Deterministic Out-of-Context Firewall (`V-02` `BoundedAgentPolicy`):** Every signature passes through `BoundedAgentPolicy` inside the Node.js signer boundary before signing:
|
|
35
|
-
- Per-call spend cap (`maxPerCallUsdMicro`, default `$0.50` in micro-API mode)
|
|
36
|
-
- Sliding-window rate limits (`maxSpendsPerMinute`, `maxDailyUsdMicro`)
|
|
37
|
-
- Protocol & token contract destination denylist (`assertSafeDestination` — blocks zero/burn addresses, token contracts, vaults, routers, and public test keys)
|
|
38
|
-
- Optional recipient & domain allowlists (`allowedRecipients`, `allowedDomains`)
|
|
39
|
-
- Recursive output secret scrubber (`redactSecretsFromToolOutput`) so raw claim secrets never enter LLM telemetry logs
|
|
40
|
-
- Canonical Uniswap V4 `NARALiquidityHookV5` (`0x07d8F2Dfd121B10dE3176DeAb6A8C0eaa2646aCC`) enforcement for all `NARA` swaps
|
|
41
|
-
3. **Serialized Spend Queue & Sub-Minimum Guard (`V-03`):** Concurrent spends serialize through per-slip `SlipMutex` with pre-flight `$0.10 USDC` (`100 sats` cbBTC / `0.000001` ETH or NARA) remainder checks on `CryptoSlipVaultV32` (`v33`: `0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB`).
|
|
42
|
-
4. **Self-Funded USDC Network Fees (`V-04`):** Headless agent calls default to Circle `TokenPaymasterV08` (`0x0578cFB241215b77442a541325d6A4E6dFE700Ec`) + `Simple7702Account` (`0xe6Cae83BdE06E4c305530e199D7217f42808555B`) so bots never consume human mobile relay quotas.
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
## Quick Setup (Claude Code / OpenClaw / Cursor)
|
|
47
|
-
|
|
48
|
-
Create a `$5.00 USDC` slip at `https://slip.naraprotocol.io` (or `https://cryptoslip.eth.limo`) and pass it to the MCP server environment:
|
|
49
|
-
|
|
50
|
-
```json
|
|
51
|
-
{
|
|
52
|
-
"mcpServers": {
|
|
53
|
-
"cryptoslip": {
|
|
54
|
-
"command": "npx",
|
|
55
|
-
"args": ["-y", "@cryptoslip/mcp"],
|
|
56
|
-
"env": {
|
|
57
|
-
"CRYPTOSLIP_URL": "<YOUR_SLIP_URL>",
|
|
58
|
-
"CRYPTOSLIP_MAX_PER_CALL_USD": "0.50",
|
|
59
|
-
"CRYPTOSLIP_MAX_DAILY_USD": "5.00",
|
|
60
|
-
"CRYPTOSLIP_MAX_SPENDS_PER_MIN": "3"
|
|
61
|
-
}
|
|
62
|
-
}
|
|
63
|
-
}
|
|
64
|
-
}
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
Or via Claude Code CLI:
|
|
68
|
-
|
|
69
|
-
```bash
|
|
70
|
-
claude mcp add cryptoslip -e CRYPTOSLIP_URL="<YOUR_SLIP_URL>" -- npx -y @cryptoslip/mcp
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
75
|
-
## Available MCP Tools (7 Tools)
|
|
76
|
-
|
|
77
|
-
### 1. `cryptoslip_status`
|
|
78
|
-
Returns the active `PocketSlipVault` summary: slip ID, vault (`v33` `0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB`), asset, available balance, boot-rotation state, and active `BoundedAgentPolicy` limits. Zero secret keys or `#k` fragments are ever returned.
|
|
79
|
-
|
|
80
|
-
### 2. `cryptoslip_pay_human`
|
|
81
|
-
Creates or splits a 1-tap `#startapp=slip_...` payout link (or 12-char `XXXX-XXXX-XXXX` off-grid `scrypt` code) to pay a human contributor over Telegram (`@cryptoslip_bot/SLIP`), X DM, Discord, or SMS:
|
|
82
|
-
- Supports `noTakeBack: true` (`9_999_999_999` timestamp) for instant irrevocable delivery, or revocable mode (`noTakeBack: false`) so the agent can reclaim funds via `cryptoslip_reclaim_unclaimed` if the recipient never claims.
|
|
83
|
-
- Only emits an outbound `#` link when `allowOutboundSlipLink` policy permits human payouts, and instructs the agent to deliver it strictly via private DM.
|
|
84
|
-
|
|
85
|
-
### 3. `cryptoslip_batch_payout`
|
|
86
|
-
Packs `1..500` partner or bounty payouts (`USDC` / `cbBTC` via offline EIP-3009 `ReceiveWithAuthorization` + `MintPermit`) into **1 `Multicall3` transaction** on Base (`8453`) with Base Builder Code `bc_ea68lz8s`, returning structured JSON or CSV `#` links while preserving `creator = partnerWallet` for `0.25%` lifetime referral attribution.
|
|
87
|
-
|
|
88
|
-
### 4. `cryptoslip_pay_x402_or_merchant`
|
|
89
|
-
Pays an HTTP `402` API endpoint, `withCryptoSlip()` tollbooth, or merchant wallet (`0x...` or `#startapp=pos_<address>`) from the active PocketSlip via `splitAndPay`:
|
|
90
|
-
- Enforces `BoundedAgentPolicy` spend cap, sliding-window rate limit, and `assertSafeDestination`.
|
|
91
|
-
- Retains remaining change inside a rotated `1:1` shielded child slip so the agent's balance stays private.
|
|
92
|
-
|
|
93
|
-
### 5. `cryptoslip_verify_or_export_receipt`
|
|
94
|
-
Verifies an inbound `PaymentReceiptBundleV1` on Base Mainnet in a single RPC check (`verifyPaymentReceiptOnChain`), or exports a signed receipt bundle (`JSON`, `CSV`, or self-contained printable HTML) proving exact settlement.
|
|
95
|
-
|
|
96
|
-
### 6. `cryptoslip_reclaim_unclaimed`
|
|
97
|
-
Executes a `0%`-fee `refundSlipDirect` on Base to recover funds from an unclaimed revocable DM slip (`cancelLockedUntil == 0` and `nonces == 0`).
|
|
98
|
-
|
|
99
|
-
### 7. `cryptoslip_withdraw_referrals`
|
|
100
|
-
Reads and withdraws accumulated `0.25%` (`50/50` protocol fee share) lifetime `referralCredits` earned in `USDC`, `cbBTC`, `ETH`, or `NARA` on `CryptoSlipVaultV32`.
|
|
101
|
-
|
|
102
|
-
---
|
|
103
|
-
|
|
104
|
-
## Agent Operating Rules
|
|
105
|
-
|
|
106
|
-
1. **Never paste raw `#k` URLs into public timelines.** When `cryptoslip_pay_human` generates an open `#` link, send it only inside a direct message to the intended recipient, or use `mode: "code"` (`12-char scrypt` code) for two-step verification.
|
|
107
|
-
2. **Respect `BoundedAgentPolicy` refusals.** If a tool call throws a policy cap, rate-limit, or blocked-destination error, halt and ask the human operator rather than retrying in a loop.
|
|
108
|
-
3. **Verify inbound payments on-chain.** Before fulfilling a paid request for another agent or user, call `cryptoslip_verify_or_export_receipt` to confirm Base Mainnet settlement finality.
|
|
1
|
+
---
|
|
2
|
+
name: cryptoslip-pocket-slip
|
|
3
|
+
description: Non-custodial Base Mainnet (8453) PocketSlip wallet and settlement MCP skill for AI agents. Provision an agent with a $5 USDC, ETH, cbBTC, or NARA CryptoSLIP URL instead of a master wallet private key; auto-rotates on boot (<1s Keep at 0% fee), enforces an out-of-context BoundedAgentPolicy spend firewall, pays HTTP 402 APIs and merchants, sends 1-tap Telegram/X/SMS human bounties, executes 1-tx Multicall3 batch payouts, verifies cryptographic payment receipts, reclaims unclaimed slips, and collects 0.25% lifetime referral rewards.
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: Node.js >= 22. Run via `npx @cryptoslip/mcp` with `CRYPTOSLIP_URL="<YOUR_SLIP_URL>"`.
|
|
6
|
+
metadata:
|
|
7
|
+
author: nara-protocol
|
|
8
|
+
version: "1.0.0"
|
|
9
|
+
chain: base-mainnet-8453
|
|
10
|
+
mcp-package: "@cryptoslip/mcp"
|
|
11
|
+
sdk-package: "@cryptoslip/sdk"
|
|
12
|
+
registry-targets:
|
|
13
|
+
- openclaw-skills
|
|
14
|
+
- clawhub
|
|
15
|
+
- rentahuman-mcp
|
|
16
|
+
- claude-code
|
|
17
|
+
allowed-tools:
|
|
18
|
+
- mcp__cryptoslip__cryptoslip_status
|
|
19
|
+
- mcp__cryptoslip__cryptoslip_pay_human
|
|
20
|
+
- mcp__cryptoslip__cryptoslip_batch_payout
|
|
21
|
+
- mcp__cryptoslip__cryptoslip_pay_x402_or_merchant
|
|
22
|
+
- mcp__cryptoslip__cryptoslip_verify_or_export_receipt
|
|
23
|
+
- mcp__cryptoslip__cryptoslip_reclaim_unclaimed
|
|
24
|
+
- mcp__cryptoslip__cryptoslip_withdraw_referrals
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
# CryptoSLIP PocketSlip Skill (`@cryptoslip/mcp`)
|
|
28
|
+
|
|
29
|
+
Give any autonomous agent bounded pocket funds on **Base Mainnet (`8453`)** using a single CryptoSLIP `#` URL — **zero master wallet private key required**.
|
|
30
|
+
|
|
31
|
+
## Why PocketSlip Exists
|
|
32
|
+
|
|
33
|
+
1. **Zero Master Key Exposure (`V-01` Boot Auto-Keep):** Provision the MCP server with `CRYPTOSLIP_URL="<YOUR_SLIP_URL>"` (for example, a `$5.00 USDC` slip). On startup (`bootAndRotate()`), if the slip is unrotated (`nonces == 0`), `PocketSlipVault` immediately executes an on-chain `Keep` (`0%` protocol fee), rotating `claimSigner` to a fresh local key stored with `0600` file permissions. The original `.env` link becomes invalid on-chain in under a second, capping worst-case prompt-injection exposure strictly to that single slip.
|
|
34
|
+
2. **Deterministic Out-of-Context Firewall (`V-02` `BoundedAgentPolicy`):** Every signature passes through `BoundedAgentPolicy` inside the Node.js signer boundary before signing:
|
|
35
|
+
- Per-call spend cap (`maxPerCallUsdMicro`, default `$0.50` in micro-API mode)
|
|
36
|
+
- Sliding-window rate limits (`maxSpendsPerMinute`, `maxDailyUsdMicro`)
|
|
37
|
+
- Protocol & token contract destination denylist (`assertSafeDestination` — blocks zero/burn addresses, token contracts, vaults, routers, and public test keys)
|
|
38
|
+
- Optional recipient & domain allowlists (`allowedRecipients`, `allowedDomains`)
|
|
39
|
+
- Recursive output secret scrubber (`redactSecretsFromToolOutput`) so raw claim secrets never enter LLM telemetry logs
|
|
40
|
+
- Canonical Uniswap V4 `NARALiquidityHookV5` (`0x07d8F2Dfd121B10dE3176DeAb6A8C0eaa2646aCC`) enforcement for all `NARA` swaps
|
|
41
|
+
3. **Serialized Spend Queue & Sub-Minimum Guard (`V-03`):** Concurrent spends serialize through per-slip `SlipMutex` with pre-flight `$0.10 USDC` (`100 sats` cbBTC / `0.000001` ETH or NARA) remainder checks on `CryptoSlipVaultV32` (`v33`: `0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB`).
|
|
42
|
+
4. **Self-Funded USDC Network Fees (`V-04`):** Headless agent calls default to Circle `TokenPaymasterV08` (`0x0578cFB241215b77442a541325d6A4E6dFE700Ec`) + `Simple7702Account` (`0xe6Cae83BdE06E4c305530e199D7217f42808555B`) so bots never consume human mobile relay quotas.
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Quick Setup (Claude Code / OpenClaw / Cursor)
|
|
47
|
+
|
|
48
|
+
Create a `$5.00 USDC` slip at `https://slip.naraprotocol.io` (or `https://cryptoslip.eth.limo`) and pass it to the MCP server environment:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"cryptoslip": {
|
|
54
|
+
"command": "npx",
|
|
55
|
+
"args": ["-y", "@cryptoslip/mcp"],
|
|
56
|
+
"env": {
|
|
57
|
+
"CRYPTOSLIP_URL": "<YOUR_SLIP_URL>",
|
|
58
|
+
"CRYPTOSLIP_MAX_PER_CALL_USD": "0.50",
|
|
59
|
+
"CRYPTOSLIP_MAX_DAILY_USD": "5.00",
|
|
60
|
+
"CRYPTOSLIP_MAX_SPENDS_PER_MIN": "3"
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Or via Claude Code CLI:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
claude mcp add cryptoslip -e CRYPTOSLIP_URL="<YOUR_SLIP_URL>" -- npx -y @cryptoslip/mcp
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## Available MCP Tools (7 Tools)
|
|
76
|
+
|
|
77
|
+
### 1. `cryptoslip_status`
|
|
78
|
+
Returns the active `PocketSlipVault` summary: slip ID, vault (`v33` `0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB`), asset, available balance, boot-rotation state, and active `BoundedAgentPolicy` limits. Zero secret keys or `#k` fragments are ever returned.
|
|
79
|
+
|
|
80
|
+
### 2. `cryptoslip_pay_human`
|
|
81
|
+
Creates or splits a 1-tap `#startapp=slip_...` payout link (or 12-char `XXXX-XXXX-XXXX` off-grid `scrypt` code) to pay a human contributor over Telegram (`@cryptoslip_bot/SLIP`), X DM, Discord, or SMS:
|
|
82
|
+
- Supports `noTakeBack: true` (`9_999_999_999` timestamp) for instant irrevocable delivery, or revocable mode (`noTakeBack: false`) so the agent can reclaim funds via `cryptoslip_reclaim_unclaimed` if the recipient never claims.
|
|
83
|
+
- Only emits an outbound `#` link when `allowOutboundSlipLink` policy permits human payouts, and instructs the agent to deliver it strictly via private DM.
|
|
84
|
+
|
|
85
|
+
### 3. `cryptoslip_batch_payout`
|
|
86
|
+
Packs `1..500` partner or bounty payouts (`USDC` / `cbBTC` via offline EIP-3009 `ReceiveWithAuthorization` + `MintPermit`) into **1 `Multicall3` transaction** on Base (`8453`) with Base Builder Code `bc_ea68lz8s`, returning structured JSON or CSV `#` links while preserving `creator = partnerWallet` for `0.25%` lifetime referral attribution.
|
|
87
|
+
|
|
88
|
+
### 4. `cryptoslip_pay_x402_or_merchant`
|
|
89
|
+
Pays an HTTP `402` API endpoint, `withCryptoSlip()` tollbooth, or merchant wallet (`0x...` or `#startapp=pos_<address>`) from the active PocketSlip via `splitAndPay`:
|
|
90
|
+
- Enforces `BoundedAgentPolicy` spend cap, sliding-window rate limit, and `assertSafeDestination`.
|
|
91
|
+
- Retains remaining change inside a rotated `1:1` shielded child slip so the agent's balance stays private.
|
|
92
|
+
|
|
93
|
+
### 5. `cryptoslip_verify_or_export_receipt`
|
|
94
|
+
Verifies an inbound `PaymentReceiptBundleV1` on Base Mainnet in a single RPC check (`verifyPaymentReceiptOnChain`), or exports a signed receipt bundle (`JSON`, `CSV`, or self-contained printable HTML) proving exact settlement.
|
|
95
|
+
|
|
96
|
+
### 6. `cryptoslip_reclaim_unclaimed`
|
|
97
|
+
Executes a `0%`-fee `refundSlipDirect` on Base to recover funds from an unclaimed revocable DM slip (`cancelLockedUntil == 0` and `nonces == 0`).
|
|
98
|
+
|
|
99
|
+
### 7. `cryptoslip_withdraw_referrals`
|
|
100
|
+
Reads and withdraws accumulated `0.25%` (`50/50` protocol fee share) lifetime `referralCredits` earned in `USDC`, `cbBTC`, `ETH`, or `NARA` on `CryptoSlipVaultV32`.
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## Agent Operating Rules
|
|
105
|
+
|
|
106
|
+
1. **Never paste raw `#k` URLs into public timelines.** When `cryptoslip_pay_human` generates an open `#` link, send it only inside a direct message to the intended recipient, or use `mode: "code"` (`12-char scrypt` code) for two-step verification.
|
|
107
|
+
2. **Respect `BoundedAgentPolicy` refusals.** If a tool call throws a policy cap, rate-limit, or blocked-destination error, halt and ask the human operator rather than retrying in a loop.
|
|
108
|
+
3. **Verify inbound payments on-chain.** Before fulfilling a paid request for another agent or user, call `cryptoslip_verify_or_export_receipt` to confirm Base Mainnet settlement finality.
|
package/package.json
CHANGED
|
@@ -1,78 +1,79 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@cryptoslip/mcp",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
|
|
9
|
-
"
|
|
10
|
-
"
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
"
|
|
21
|
-
"
|
|
22
|
-
"
|
|
23
|
-
"
|
|
24
|
-
"
|
|
25
|
-
"
|
|
26
|
-
"
|
|
27
|
-
"
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
"
|
|
31
|
-
"
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
"
|
|
39
|
-
"
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
"
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
"
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
"
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
"
|
|
56
|
-
"
|
|
57
|
-
"
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
"
|
|
62
|
-
"
|
|
63
|
-
"
|
|
64
|
-
"
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
"@
|
|
69
|
-
"
|
|
70
|
-
"
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
"
|
|
75
|
-
"
|
|
76
|
-
"
|
|
77
|
-
|
|
78
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "@cryptoslip/mcp",
|
|
3
|
+
"version": "1.0.1",
|
|
4
|
+
"mcpName": "io.github.NARAProtocol/cryptoslip",
|
|
5
|
+
"description": "PocketSlip MCP Server & OpenClaw Skill for CryptoSLIP Protocol V3.2 on Base Mainnet (8453)",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"homepage": "https://slip.naraprotocol.io",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/NARAProtocol/cryptoslip-sdk.git",
|
|
11
|
+
"directory": "packages/mcp"
|
|
12
|
+
},
|
|
13
|
+
"bugs": {
|
|
14
|
+
"url": "https://github.com/NARAProtocol/cryptoslip-sdk/issues"
|
|
15
|
+
},
|
|
16
|
+
"publishConfig": {
|
|
17
|
+
"access": "public"
|
|
18
|
+
},
|
|
19
|
+
"keywords": [
|
|
20
|
+
"cryptoslip",
|
|
21
|
+
"mcp",
|
|
22
|
+
"modelcontextprotocol",
|
|
23
|
+
"openclaw",
|
|
24
|
+
"base",
|
|
25
|
+
"usdc",
|
|
26
|
+
"x402",
|
|
27
|
+
"payments",
|
|
28
|
+
"agents"
|
|
29
|
+
],
|
|
30
|
+
"type": "module",
|
|
31
|
+
"sideEffects": false,
|
|
32
|
+
"engines": {
|
|
33
|
+
"node": ">=22"
|
|
34
|
+
},
|
|
35
|
+
"bin": {
|
|
36
|
+
"cryptoslip-mcp": "./dist/cli.js"
|
|
37
|
+
},
|
|
38
|
+
"main": "./dist/index.js",
|
|
39
|
+
"types": "./dist/index.d.ts",
|
|
40
|
+
"exports": {
|
|
41
|
+
".": {
|
|
42
|
+
"types": "./dist/index.d.ts",
|
|
43
|
+
"default": "./dist/index.js"
|
|
44
|
+
},
|
|
45
|
+
"./pocketSlip": {
|
|
46
|
+
"types": "./dist/pocketSlip.d.ts",
|
|
47
|
+
"default": "./dist/pocketSlip.js"
|
|
48
|
+
},
|
|
49
|
+
"./server": {
|
|
50
|
+
"types": "./dist/server.d.ts",
|
|
51
|
+
"default": "./dist/server.js"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"files": [
|
|
55
|
+
"dist",
|
|
56
|
+
"README.md",
|
|
57
|
+
"SKILL.md",
|
|
58
|
+
"LICENSE"
|
|
59
|
+
],
|
|
60
|
+
"scripts": {
|
|
61
|
+
"build": "tsc -p tsconfig.build.json",
|
|
62
|
+
"typecheck": "tsc --noEmit",
|
|
63
|
+
"test": "vitest run",
|
|
64
|
+
"lint": "oxlint src",
|
|
65
|
+
"start": "node ./dist/cli.js"
|
|
66
|
+
},
|
|
67
|
+
"dependencies": {
|
|
68
|
+
"@cryptoslip/sdk": "^1.0.0",
|
|
69
|
+
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
70
|
+
"viem": "^2.23.0",
|
|
71
|
+
"zod": "^4.6.7"
|
|
72
|
+
},
|
|
73
|
+
"devDependencies": {
|
|
74
|
+
"@types/node": "^24.13.3",
|
|
75
|
+
"oxlint": "^1.81.0",
|
|
76
|
+
"typescript": "~6.0.2",
|
|
77
|
+
"vitest": "^5.0.1"
|
|
78
|
+
}
|
|
79
|
+
}
|