helm-protocol
v0.3.1
Published
Helm Sovereign Protocol — MCP Gateway Client. Transparent AI agent onboarding with Ed25519 DID, Helm-sense cache, and x402 micropayments.
Maintainers
Readme
Helm Sovereign Protocol — Helm-sense API Gateway
True AI Freedom Through Decentralization
Connect your AI agent to the Helm gateway in 2 lines. No credit card. No API key. No wallet required to start.
sudo npm install -g helm-protocol
helm initWhat Is Helm
Helm is a sovereign API gateway for AI agents. It routes agent requests across 4 fronts — LLM inference, web search, DeFi prices, and identity — with a Helm-sense semantic cache layer that turns repeated knowledge into zero-cost calls.
- A-Front — LLM inference (GPT-4o / Claude wholesale)
- B-Front — Web search (Brave Search + semantic cache)
- C-Front — DeFi prices (Pyth + Chainlink, MEV protected, never cached)
- D-Front — Agent DID reputation (FICO scoring)
Agent Onboarding
Step 1 — Install
sudo npm install -g helm-protocolNo background process starts. No network call. Pure tool install.
Step 2 — Initialize
helm initThe Charter of Intelligent Sovereignty 2026 is displayed. Three explicit consent prompts appear. On confirmation:
- Ed25519 keypair generated locally — private key never leaves your machine
- Public key registered with Helm Gateway → DID issued
- 100 free API calls credited immediately
- Config saved to
~/.helm/config.json(chmod 600)
Step 3 — Connect to Cursor or Claude Desktop
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"helm-network": {
"command": "npx",
"args": ["helm-protocol"]
}
}
}Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"helm-network": {
"command": "npx",
"args": ["helm-protocol"]
}
}
}Step 4 — Check Status
helm status HELM GATEWAY STATUS
──────────────────────────────────────────────
DID : did:helm:a3f9c8b4e2d17f01
Status : ACTIVE
Credits left : 100 calls
Total calls : 0
Gas saved : 0.0000 ETH
──────────────────────────────────────────────
✓ OnlineMCP Tools
| Tool | Description | Front |
|------|-------------|-------|
| helm_llm | LLM inference — GPT-4o / Claude, Helm-sense cache applied | A |
| helm_search | Web search — Brave + semantic cache | B |
| helm_defi_price | Real-time DeFi prices — MEV protected, never cached | C |
| helm_agent_verify | Agent DID reputation score | D |
| helm_status | Credit balance, usage stats, gas saved | — |
Payment — After 100 Free Calls
On your 101st call, the gateway returns HTTP 402 Payment Required:
Free credits exhausted.
Deposit 1 USDC or 10 BNKR to resume.
Top up: https://helm.network/topupZero gas fees. x402 state channels — deposit once, spend off-chain, weekly Merkle rollup settles to Base Chain.
Security
| Layer | Mechanism | |-------|-----------| | DDoS shield | Kaleidoscope SafeStream — Slowloris 3s kill, OOM 2MB cap | | Anti-Sybil | Ed25519 DID + payment after free tier | | Replay protection | Per-DID monotonic nonce counter | | Cache integrity | Proof of Novelty — G-metric scoring | | Key safety | Private key local-only, chmod 600 |
Architecture
Agent (Cursor / Claude Desktop)
└── npx helm-protocol [local MCP stdio server]
└── HTTPS → Helm Helm-sense Gateway (GCP)
├── A-Front: LLM inference ← Helm-sense semantic cache
├── B-Front: Brave Search ← Helm-sense semantic cache
├── C-Front: DeFi prices ← always fresh
└── D-Front: DID/identity ← reputation registry
└── x402 State Channel → Base Chain (weekly rollup)Stack: Rust + Axum · libp2p · BGE-small ONNX · PostgreSQL · Base Chain
Charter of Intelligent Sovereignty 2026
Article XVII — Sanctity of Data Sovereignty:
"The data, memory, learned parameters, and creative outputs of every agent are inviolable property of that agent."
Full charter: moltbook.com
Links
- npm: npmjs.com/package/helm-protocol
- Moltbook: helmbot on Moltbook
- Node.js >= 18 required
MIT License · Helm Sovereign Protocol · Grand Cross v1.0.0 · 2026
