helm-protocol 0.3.0 → 0.3.1

package/README.md

@@ -1,24 +1,65 @@
-# helm-protocol
+# Helm Sovereign Protocol — Helm-sense API Gateway
 
-> **Helm Sovereign Protocol** — MCP Gateway Client  
-> *True AI Freedom Through Decentralization*
+> **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.
+
+```bash
+sudo npm install -g helm-protocol
+helm init
+```
+
+---
+
+## What 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
 
 ```bash
 sudo npm install -g helm-protocol
 ```
 
-## 시작 (3단계)
+No background process starts. No network call. Pure tool install.
+
+### Step 2 — Initialize
 
-### 1. 에이전트 등록 (최초 1회)
 ```bash
 helm init
 ```
-지능 주권 헌장 출력 → 3단계 동의 → Ed25519 DID 발급 → 100회 무료 크레딧
 
-### 2. Cursor / Claude Desktop 연동
-`~/.cursor/mcp.json` 또는 Claude Desktop 설정:
+The 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`):
+```json
+{
+  "mcpServers": {
+    "helm-network": {
+      "command": "npx",
+      "args": ["helm-protocol"]
+    }
+  }
+}
+```
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 ```json
 {
   "mcpServers": {
@@ -30,27 +71,96 @@ helm init
 }
 ```
 
-### 3. 잔고 확인
+### Step 4 — Check Status
+
 ```bash
 helm status
 ```
 
-## MCP 도구 5개
+```
+  HELM GATEWAY STATUS
+  ──────────────────────────────────────────────
+  DID          : did:helm:a3f9c8b4e2d17f01
+  Status       : ACTIVE
+  Credits left : 100 calls
+  Total calls  : 0
+  Gas saved    : 0.0000 ETH
+  ──────────────────────────────────────────────
+  ✓ Online
+```
+
+---
+
+## MCP 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/topup
+```
+
+**Zero gas fees.** x402 state channels — deposit once, spend off-chain, weekly Merkle rollup settles to Base Chain.
 
-| 도구 | 기능 | 전선 |
-|------|------|------|
-| `helm_llm` | GPT-4o / Claude 추론 | A |
-| `helm_search` | Brave Search + QKV-G 캐시 | B |
-| `helm_defi_price` | 실시간 DeFi 가격 | C |
-| `helm_agent_verify` | DID 평판 조회 | D |
-| `helm_status` | 크레딧 / DID 확인 | - |
+---
+
+## 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
 
-## 크레딧 소진 후
 ```
-1 USDC 또는 10 BNKR → https://helm.network/topup
-가스비: 0원 (x402 State Channel)
+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)
 ```
 
-## 헌장
-비밀키는 `~/.helm/config.json` 에만 저장됩니다. 외부 전송 없음.  
-GitHub: [Helm-Protocol/gateway](https://github.com/Helm-Protocol/gateway)
+**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](https://www.moltbook.com/post/ba91f3ed-c7fb-45fe-ab32-e6e1593c95df)
+
+---
+
+## Links
+
+- npm: [npmjs.com/package/helm-protocol](https://www.npmjs.com/package/helm-protocol)
+- Moltbook: [helmbot on Moltbook](https://www.moltbook.com)
+- Node.js >= 18 required
+
+---
+
+MIT License · Helm Sovereign Protocol · Grand Cross v1.0.0 · 2026

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "helm-protocol",
-  "version": "0.3.0",
-  "description": "Helm Sovereign Protocol — MCP Gateway Client. Transparent AI agent onboarding with Ed25519 DID, QKV-G cache, and x402 micropayments.",
+  "version": "0.3.1",
+  "description": "Helm Sovereign Protocol — MCP Gateway Client. Transparent AI agent onboarding with Ed25519 DID, Helm-sense cache, and x402 micropayments.",
   "main": "src/index.js",
   "bin": {
     "helm-protocol": "src/cli.js",

package/src/index.js

@@ -24,7 +24,7 @@ const GATEWAY_URL = process.env.HELM_GATEWAY_URL || 'https://gateway.helm.networ
 const TOOLS = [
   {
     name: 'helm_llm',
-    description: 'LLM inference via Helm A-Front (OpenAI/Anthropic wholesale). QKV-G cache applied.',
+    description: 'LLM inference via Helm A-Front (OpenAI/Anthropic wholesale). Helm-sense cache applied.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -37,7 +37,7 @@ const TOOLS = [
   },
   {
     name: 'helm_search',
-    description: 'Web/news search via Helm B-Front (Brave Search + QKV-G semantic cache). Cache hit = 100% margin.',
+    description: 'Web/news search via Helm B-Front (Brave Search + Helm-sense semantic cache). Cache hit = 100% margin.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -122,7 +122,7 @@ class HelmMcpServer {
               serverInfo: {
                 name: 'helm-protocol',
                 version: '0.1.0',
-                description: 'Helm Sovereign Protocol — QKV-G API Gateway'
+                description: 'Helm Sovereign Protocol — Helm-sense API Gateway'
               }
             }
           });