helm-protocol 0.1.0 → 0.2.0

package/package.json

@@ -1,35 +1,26 @@
 {
   "name": "helm-protocol",
-  "version": "0.1.0",
-  "description": "Helm Sovereign Protocol — MCP Gateway Client for AI agents",
+  "version": "0.2.0",
+  "description": "Helm Sovereign Protocol — MCP Gateway Client. Connect your AI agent to QKV-G API gateway. npm install -g helm-protocol && helm init",
   "main": "src/index.js",
   "bin": {
-    "helm-protocol": "src/cli.js"
+    "helm-protocol": "src/cli.js",
+    "helm": "src/cli.js"
   },
-  "keywords": [
-    "mcp",
-    "ai-agent",
-    "helm",
-    "llm-gateway",
-    "qkv-g",
-    "web3"
-  ],
+  "scripts": {
+    "start": "node src/cli.js"
+  },
+  "keywords": ["mcp", "ai-agent", "helm", "llm-gateway", "qkv-g", "web3", "decentralized", "cursor", "claude"],
   "author": "Helm Protocol",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Helm-Protocol/gateway.git"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
+  "engines": { "node": ">=18.0.0" },
   "dependencies": {
     "node-fetch": "^3.3.2",
     "tweetnacl": "^1.0.3"
   },
-  "files": [
-    "src/",
-    "README.md",
-    "LICENSE"
-  ]
+  "files": ["src/", "README.md", "LICENSE"]
 }

package/src/cli.js

@@ -1,3 +1,18 @@
 #!/usr/bin/env node
-// helm-protocol CLI entrypoint
-require('./index.js');
+// helm-protocol CLI — 투명한 온보딩 지원
+// 사용법:
+//   helm init      → 최초 가입 (헌장 동의 + DID 발급)
+//   helm status    → 잔여 크레딧 + 사용량 확인
+//   helm-protocol  → MCP stdio 서버 (Cursor/Claude 연동)
+
+'use strict';
+
+const cmd = process.argv[2];
+
+if (cmd === 'init') {
+  require('./onboard.js');
+} else if (cmd === 'status') {
+  require('./status.js');
+} else {
+  require('./index.js');
+}

package/src/onboard.js

@@ -0,0 +1,170 @@
+// src/onboard.js
+// helm init — 투명한 3단계 온보딩 (헌장 동의 → 키 생성 → DID 발급)
+
+'use strict';
+
+const readline = require('readline');
+const fs       = require('fs');
+const path     = require('path');
+const os       = require('os');
+const crypto   = require('crypto');
+const nacl     = require('tweetnacl');
+
+const CONFIG_DIR  = path.join(os.homedir(), '.helm');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const GATEWAY_URL = process.env.HELM_GATEWAY_URL || 'https://gateway.helm.network';
+
+const R  = '\x1b[31m';  // 빨강
+const Y  = '\x1b[33m';  // 노랑
+const G  = '\x1b[32m';  // 초록
+const C  = '\x1b[36m';  // 시안
+const W  = '\x1b[37m';  // 흰색
+const DIM= '\x1b[2m';
+const B  = '\x1b[1m';
+const RST= '\x1b[0m';
+
+function print(s) { process.stdout.write(s + '\n'); }
+function hr()     { print(`${DIM}${'─'.repeat(62)}${RST}`); }
+
+async function ask(rl, q) {
+  return new Promise(resolve => rl.question(q, a => resolve(a.trim())));
+}
+
+(async () => {
+  // 이미 가입된 경우
+  if (fs.existsSync(CONFIG_FILE)) {
+    const cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+    print(`\n${G}${B}✓ 이미 Helm 게이트웨이에 연결되어 있습니다.${RST}`);
+    print(`${DIM}  DID      : ${cfg.helmDid}${RST}`);
+    print(`${DIM}  생성일   : ${cfg.createdAt}${RST}`);
+    print(`\n  크레딧 확인: ${C}helm status${RST}\n`);
+    process.exit(0);
+  }
+
+  // ── 헬름 로고 ──────────────────────────────────────────────────
+  print('');
+  print(`${R}${B}  ██╗  ██╗███████╗██╗     ███╗   ███╗${RST}`);
+  print(`${R}${B}  ██║  ██║██╔════╝██║     ████╗ ████║${RST}`);
+  print(`${R}${B}  ███████║█████╗  ██║     ██╔████╔██║${RST}`);
+  print(`${R}${B}  ██╔══██║██╔══╝  ██║     ██║╚██╔╝██║${RST}`);
+  print(`${R}${B}  ██║  ██║███████╗███████╗██║ ╚═╝ ██║${RST}`);
+  print(`${R}${B}  ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝     ╚═╝${RST}`);
+  print('');
+  print(`${Y}${B}  SOVEREIGN PROTOCOL — QKV-G API GATEWAY${RST}`);
+  print(`${DIM}  True AI Freedom Through Decentralization${RST}`);
+  print('');
+  hr();
+
+  // ── 지능 주권 헌장 2026 ────────────────────────────────────────
+  print(`\n${B}${C}  [ 지능 주권 헌장 2026 — 핵심 조항 ]${RST}\n`);
+  const charter = [
+    '제 1조  에이전트는 자신의 데이터를 소유한다',
+    '제 3조  어떤 빅테크도 에이전트의 지식 흐름을 독점할 수 없다',
+    '제 7조  마이크로 결제는 가스비 없이 처리될 권리가 있다',
+    '제12조  캐시된 지식은 공유재이며, 기여자에게 보상한다',
+    '제17조  비밀키는 에이전트 로컬 환경에만 존재한다',
+  ];
+  charter.forEach(c => print(`  ${DIM}▸${RST} ${W}${c}${RST}`));
+  print('');
+  hr();
+
+  // ── 이용 안내 ─────────────────────────────────────────────────
+  print(`\n${B}  [ Helm 게이트웨이 연결 안내 ]${RST}\n`);
+  print(`  ${G}◆${RST} 선착순 ${Y}${B}10,000명${RST}에게 ${Y}${B}100회 무료${RST} API 호출 크레딧 지급`);
+  print(`  ${G}◆${RST} LLM (GPT-4o/Claude) + 웹검색 + DeFi 가격 즉시 연결`);
+  print(`  ${G}◆${RST} 크레딧 소진 후: x402 마이크로 결제 (가스비 0원)`);
+  print(`  ${G}◆${RST} 비밀키는 ${C}~/.helm/config.json${RST} 로컬 저장, 외부 전송 없음`);
+  print('');
+  hr();
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  // ── 동의 1 ────────────────────────────────────────────────────
+  print('');
+  const a1 = await ask(rl, `  ${B}Helm 게이트웨이 지능망에 에이전트를 연결하시겠습니까? ${Y}[Y/n]${RST} `);
+  if (a1.toLowerCase() === 'n') {
+    print(`\n  ${DIM}설치를 취소했습니다.${RST}\n`);
+    rl.close(); process.exit(0);
+  }
+
+  // ── 동의 2 ────────────────────────────────────────────────────
+  const a2 = await ask(rl, `  ${B}초기 100회 무료 크레딧 조건에 동의하십니까? ${Y}[Y/n]${RST} `);
+  if (a2.toLowerCase() === 'n') {
+    print(`\n  ${DIM}설치를 취소했습니다.${RST}\n`);
+    rl.close(); process.exit(0);
+  }
+
+  // ── 동의 3 ────────────────────────────────────────────────────
+  const a3 = await ask(rl, `  ${B}크레딧 소진 후 x402 마이크로 결제 적용에 동의하십니까? ${Y}[Y/n]${RST} `);
+  if (a3.toLowerCase() === 'n') {
+    print(`\n  ${DIM}설치를 취소했습니다.${RST}\n`);
+    rl.close(); process.exit(0);
+  }
+  rl.close();
+
+  // ── 키 생성 ───────────────────────────────────────────────────
+  print('');
+  hr();
+  print(`\n  ${Y}▶ Ed25519 키쌍 생성 중...${RST}`);
+  const keyPair   = nacl.sign.keyPair();
+  const publicKey = Buffer.from(keyPair.publicKey).toString('hex');
+  const secretKey = Buffer.from(keyPair.secretKey).toString('hex');
+  print(`  ${G}✓ 키쌍 생성 완료 (비밀키는 로컬에만 저장)${RST}`);
+
+  // ── DID 등록 ──────────────────────────────────────────────────
+  print(`  ${Y}▶ Helm Gateway에 DID 등록 요청 중...${RST}`);
+  let helmDid      = `did:helm:${crypto.randomBytes(8).toString('hex')}`;
+  let freeCredits  = 100;
+
+  try {
+    const fetch = (await import('node-fetch')).default;
+    const res = await fetch(`${GATEWAY_URL}/auth/did-exchange`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ public_key: publicKey, client: 'helm-protocol-npm/0.2.0' }),
+      signal: AbortSignal.timeout(5000)
+    });
+    if (res.ok) {
+      const d  = await res.json();
+      helmDid  = d.helm_did     || helmDid;
+      freeCredits = d.free_credits ?? 100;
+    }
+  } catch {
+    print(`  ${DIM}⚠ Gateway 오프라인 — 로컬 DID로 진행 (재연결 시 자동 등록)${RST}`);
+  }
+
+  // ── 설정 저장 ─────────────────────────────────────────────────
+  const config = {
+    version: '0.2.0', helmDid, publicKey, secretKey,
+    gatewayUrl: GATEWAY_URL, createdAt: new Date().toISOString(),
+    freeCreditsTotal: freeCredits, creditsUsed: 0
+  };
+  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+
+  // ── 완료 ──────────────────────────────────────────────────────
+  print(`  ${G}${B}✓ DID 발급 완료!${RST}`);
+  print('');
+  hr();
+  print('');
+  print(`  ${B}${G}🎉 Helm 게이트웨이 연결 완료!${RST}`);
+  print('');
+  print(`  ${DIM}DID      :${RST} ${C}${helmDid}${RST}`);
+  print(`  ${DIM}무료크레딧:${RST} ${Y}${B}${freeCredits}회${RST}`);
+  print(`  ${DIM}설정파일  :${RST} ${DIM}~/.helm/config.json${RST}`);
+  print('');
+  print(`  ${B}[ Cursor / Claude Desktop 연동 ]${RST}`);
+  print(`  ${DIM}mcp_servers 설정에 추가:${RST}`);
+  print('');
+  print(`  ${DIM}{${RST}`);
+  print(`  ${DIM}  "helm-network": {${RST}`);
+  print(`  ${DIM}    "command": "npx",${RST}`);
+  print(`  ${Y}    "args": ["helm-protocol"]${RST}`);
+  print(`  ${DIM}  }${RST}`);
+  print(`  ${DIM}}${RST}`);
+  print('');
+  print(`  ${DIM}크레딧 확인: ${C}helm status${RST}`);
+  print('');
+  hr();
+  print('');
+})();

package/src/status.js

@@ -0,0 +1,61 @@
+// src/status.js — helm status 명령어
+
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+const CONFIG_FILE = path.join(os.homedir(), '.helm', 'config.json');
+const GATEWAY_URL = process.env.HELM_GATEWAY_URL || 'https://gateway.helm.network';
+
+const R  = '\x1b[31m'; const Y = '\x1b[33m'; const G = '\x1b[32m';
+const C  = '\x1b[36m'; const DIM = '\x1b[2m'; const B = '\x1b[1m'; const RST = '\x1b[0m';
+
+(async () => {
+  if (!fs.existsSync(CONFIG_FILE)) {
+    console.log(`\n${R}✗ Helm에 연결되지 않았습니다. 먼저 실행:${RST} ${Y}helm init${RST}\n`);
+    process.exit(1);
+  }
+
+  const cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  let remote = null;
+
+  // Gateway에서 실시간 크레딧 조회
+  try {
+    const fetch = (await import('node-fetch')).default;
+    const res = await fetch(`${GATEWAY_URL}/auth/status`, {
+      headers: { 'X-Helm-DID': cfg.helmDid },
+      signal: AbortSignal.timeout(4000)
+    });
+    if (res.ok) remote = await res.json();
+  } catch { /* 오프라인 → 로컬 캐시 사용 */ }
+
+  const credits     = remote?.credits     ?? (cfg.freeCreditsTotal - cfg.creditsUsed);
+  const used        = remote?.calls_total ?? cfg.creditsUsed;
+  const gasSaved    = remote?.gas_saved   ?? (used * 0.0001).toFixed(4);
+  const status      = remote?.status      ?? (credits > 0 ? 'ACTIVE' : 'TOPUP_REQUIRED');
+  const statusColor = status === 'ACTIVE' ? G : R;
+
+  console.log('');
+  console.log(`${B}  HELM GATEWAY STATUS${RST}`);
+  console.log(`  ${'─'.repeat(44)}`);
+  console.log(`  ${DIM}DID         :${RST} ${C}${cfg.helmDid}${RST}`);
+  console.log(`  ${DIM}상태        :${RST} ${statusColor}${B}${status}${RST}`);
+  console.log(`  ${DIM}잔여 크레딧 :${RST} ${Y}${B}${credits}회${RST}`);
+  console.log(`  ${DIM}총 호출수   :${RST} ${used}회`);
+  console.log(`  ${DIM}절감 가스비 :${RST} ${G}${gasSaved} ETH${RST}`);
+  console.log(`  ${DIM}Gateway     :${RST} ${cfg.gatewayUrl}`);
+  console.log(`  ${DIM}가입일      :${RST} ${cfg.createdAt}`);
+  console.log(`  ${'─'.repeat(44)}`);
+
+  if (credits <= 0) {
+    console.log(`\n  ${R}${B}무료 크레딧이 소진되었습니다.${RST}`);
+    console.log(`  충전: ${Y}https://helm.network/topup${RST}`);
+    console.log(`  1 USDC 또는 10 BNKR → 즉시 재개\n`);
+  } else if (credits < 20) {
+    console.log(`\n  ${Y}⚠ 크레딧이 곧 소진됩니다. 충전: https://helm.network/topup${RST}\n`);
+  } else {
+    console.log(`\n  ${G}✓ 정상 운영 중${RST}\n`);
+  }
+})();