Skip to content
Back to search

cryptoslip-sdk

Official Zero-DOM TypeScript SDK (@cryptoslip/sdk) and PocketSlip MCP Server (@cryptoslip/mcp) for CryptoSLIP Protocol V3.2 on Base (8453)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/naraprotocol--cryptoslip-sdk/badge.svg)](/listings/naraprotocol--cryptoslip-sdk)

HTML

<a href="/listings/naraprotocol--cryptoslip-sdk"><img src="/api/listings/naraprotocol--cryptoslip-sdk/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

From npm (or Direct Signed GitHub Release Tarball)

# Standard SDK install
npm install @cryptoslip/sdk viem

# Run the pinned, Sigstore-verified PocketSlip MCP server
CRYPTOSLIP_URL="<YOUR_SLIP_URL>" npx @cryptoslip/mcp@1.0.3

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 71 lines
  1. # CryptoSLIP TypeScript SDK (`v1.0.1`) & PocketSlip MCP (`v1.0.3`)
  2. [![CI](https://github.com/NARAProtocol/cryptoslip-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/NARAProtocol/cryptoslip-sdk/actions/workflows/ci.yml)
  3. [![npm @cryptoslip/sdk](https://img.shields.io/npm/v/@cryptoslip/sdk?label=%40cryptoslip%2Fsdk)](https://www.npmjs.com/package/@cryptoslip/sdk)
  4. [![npm @cryptoslip/mcp](https://img.shields.io/npm/v/@cryptoslip/mcp?label=%40cryptoslip%2Fmcp)](https://www.npmjs.com/package/@cryptoslip/mcp)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
  6. [![Network: Base 8453](https://img.shields.io/badge/Base_Mainnet-8453-0052FF.svg)](https://basescan.org/address/0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB#code)
  7. Official **Zero-DOM TypeScript 6 SDK (`@cryptoslip/sdk`)** and **Bounded Agent MCP Server (`@cryptoslip/mcp`)** for **CryptoSLIP Protocol V3.2** on **Base Mainnet (`8453`)** — live at [https://slip.naraprotocol.io](https://slip.naraprotocol.io), ENS [https://cryptoslip.eth.limo](https://cryptoslip.eth.limo), and Telegram Mini App [@cryptoslip_bot/SLIP](https://t.me/cryptoslip_bot/SLIP).
  8. ---
  9. ## Packages
  10. | Package | Path | Description |
  11. | :--- | :--- | :--- |
  12. | **`@cryptoslip/sdk`** | [`packages/sdk`](./packages/sdk) | 13 tree-shakeable zero-DOM subpaths (`Node 22+`, Cloudflare Workers, Deno, Bun, Browsers): 1-tx `Multicall3` batch payouts (`1..500` items in `<50ms` offline signing), zero-key `withCryptoSlip()` HTTP `402` Hono/Fetch/Express middleware + `verifyPartnerWebhookSignature()`, `0%` 1st `Keep in Slips` (`1:1` non-commingled wallet privacy), sub-200ms `Multicall3` deterministic lineage scanner (`@cryptoslip/sdk/recovery`), Circle `TokenPaymasterV08` `USDC` network fee UserOps, VOPRF encrypted voice notes, verifiable EIP-712 receipts, and `BoundedAgentPolicy` spend firewall. |
  13. | **`@cryptoslip/mcp`** | [`packages/mcp`](./packages/mcp) | `PocketSlip` Model Context Protocol (`stdio`) server (`@cryptoslip/mcp@1.0.3`, Sigstore OIDC provenance) & OpenClaw skill ([`skills/cryptoslip/SKILL.md`](./skills/cryptoslip/SKILL.md)). Provisions AI agents with a bounded `#` slip URL (`<1s` boot `Keep` rotation invalidating the `.env` link at `0%` fee, two-slot crash-safe `pendingTransition` journal, and stateless container recovery via `CRYPTOSLIP_OPERATOR_KEY`) instead of a raw wallet private key, exposing 7 policy-guarded tools. |
  14. ---
  15. ## Quick Install
  16. ### From npm (or Direct Signed GitHub Release Tarball)
  17. ```bash
  18. # Standard SDK install
  19. npm install @cryptoslip/sdk viem
  20. # Run the pinned, Sigstore-verified PocketSlip MCP server
  21. CRYPTOSLIP_URL="<YOUR_SLIP_URL>" npx @cryptoslip/mcp@1.0.3
  22. ```
  23. ---
  24. ## Why Builders & AI Agents Integrate CryptoSLIP
  25. 1. **1-Tx `Multicall3` Partner Dispenser (`1..500` Links, Zero `ERC20.approve`):** Mint up to 500 revocable DM links or irrevocable `No take-back` (`cancelLockedUntil = 9_999_999_999`) bounties in a single Base transaction via EIP-3009 `ReceiveWithAuthorization` + `MintPermit`, while preserving `slip.creator == partnerWallet` (`0%` creator reclaim on unopened DM links + `0.25%` lifetime on-chain `referrerOf` revenue share).
  26. 2. **`0%` 1st `Keep in Slips` (`1:1` Non-Commingled Wallet Privacy):** Recipients and agents rotate `claimSigner` on-chain at `0%` protocol fee (`nonces(slipId): 0 -> 1`), keeping funds in isolated `1:1` positions rather than exposing their primary wallet balance or trade history.
  27. 3. **Zero-Key HTTP `402` Tollbooth (`withCryptoSlip`) & Signed Webhooks:** Gate Hono, Fetch, or Express APIs directly into a watch-only multisig Safe with synchronous `SlipReplayGuard`, stateless `X-Payment-Refund-Slip` overcharge refunds, and `HMAC-SHA256` `verifyPartnerWebhookSignature()` (`slip.claimed`, `slip.kept`, `checkout.paid`).
  28. 4. **Bounded `PocketSlip` Agent Wallets (`@cryptoslip/mcp`):** Never hand an LLM or untrusted sub-agent your main wallet private key. Hand it a `$5.00 USDC` slip URL; on startup, `PocketSlipVault` rotates the key on-chain in `<1s` and enforces out-of-context `BoundedAgentPolicy` per-call/daily USD caps, sliding-window rate limits, and output secret scrubbing.
  29. ---
  30. ## Canonical Base Mainnet (`8453`) Verified Contracts
  31. | Contract | Address | Notes |
  32. | :--- | :--- | :--- |
  33. | **`CryptoSlipVaultV32` (`v33`)** | [`0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB`](https://basescan.org/address/0x3f80aa68Fb4834d6E119EE1cf932C14419Cf63EB#code) | Active micro-minimum vault (`0.10 USDC`, `100 sats cbBTC`, `1e-6 ETH / NARA`) |
  34. | **`CryptoSlipNFTV32` (`v33`)** | [`0x356a701DABDeabe61F7Fc79D730617CEcbd7B94f`](https://basescan.org/address/0x356a701DABDeabe61F7Fc79D730617CEcbd7B94f#code) | Synchronized 1-of-1 position NFT |
  35. | **`CryptoSlipTradeRouterV32` (`v33`)** | [`0x2069CA17D45d3421D28f15F20262575333CECF51`](https://basescan.org/address/0x2069CA17D45d3421D28f15F20262575333CECF51#code) | Slip-to-slip & swap-and-pay router |
  36. | **`NARALiquidityHookV5`** | [`0x07d8F2Dfd121B10dE3176DeAb6A8C0eaa2646aCC`](https://basescan.org/address/0x07d8F2Dfd121B10dE3176DeAb6A8C0eaa2646aCC#code) | Canonical Uniswap V4 Hook for `100%` of `NARA` swap legs |
  37. | **Base Builder Code (`ERC-8021`)** | `bc_ea68lz8s` | Appended automatically as Schema 0 calldata suffix |
  38. ---
  39. ## Local Verification
  40. ```bash
  41. cd packages/sdk && npm install && npm run typecheck && npm run lint && npm test && npm run build
  42. cd ../mcp && npm install && npm run typecheck && npm run lint && npm test && npm run build
  43. ```
  44. ## Security & Disclosure
  45. - Claim keys (`_k<64hex>`), voice keys (`&vk=`), and seals travel **strictly inside `#` URL fragments** — never inside HTTP query strings or server logs.
  46. - Report vulnerabilities via [`https://slip.naraprotocol.io/.well-known/security.txt`](https://slip.naraprotocol.io/.well-known/security.txt) (`security@naraprotocol.io`).
  47. ## License
  48. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.