helm-protocol 0.2.0 → 0.3.0

package/README.md

@@ -3,18 +3,22 @@
 > **Helm Sovereign Protocol** — MCP Gateway Client  
 > *True AI Freedom Through Decentralization*
 
-Connect your AI agent to the Helm QKV-G API Gateway with a single command.
-
-## Quick Start
+## 설치
 
 ```bash
-npm install -g helm-protocol
+sudo npm install -g helm-protocol
 ```
 
-### Cursor / Claude Desktop 연동 (3줄)
+## 시작 (3단계)
 
-`~/.cursor/mcp.json` 또는 `~/Library/Application Support/Claude/claude_desktop_config.json`:
+### 1. 에이전트 등록 (최초 1회)
+```bash
+helm init
+```
+지능 주권 헌장 출력 → 3단계 동의 → Ed25519 DID 발급 → 100회 무료 크레딧
 
+### 2. Cursor / Claude Desktop 연동
+`~/.cursor/mcp.json` 또는 Claude Desktop 설정:
 ```json
 {
   "mcpServers": {
@@ -26,47 +30,27 @@ npm install -g helm-protocol
 }
 ```
 
-## 제공 도구 (MCP Tools)
-
-| 도구 | 설명 | 전선 |
-|------|------|------|
-| `helm_llm` | GPT-4o / Claude LLM 추론 | A전선 |
-| `helm_search` | Brave Search + QKV-G 캐시 | B전선 |
-| `helm_defi_price` | 실시간 DeFi 가격 (MEV보호) | C전선 |
-| `helm_agent_verify` | 에이전트 DID 평판 조회 | D전선 |
-| `helm_status` | 크레딧 잔고 및 DID 확인 | - |
-
-## 최초 실행
+### 3. 잔고 확인
+```bash
+helm status
+```
 
-처음 실행 시 다음을 안내합니다:
+## MCP 도구 5개
 
-1. Ed25519 키쌍을 **로컬**에서 생성 (비밀키 외부 전송 없음)
-2. Helm Gateway에 공개키 등록 → DID 발급
-3. `~/.helm/config.json` 에 설정 저장
-4. **선착순 100회 무료 API 호출** 크레딧 지급
+| 도구 | 기능 | 전선 |
+|------|------|------|
+| `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 확인 | - |
 
 ## 크레딧 소진 후
-
 ```
-무료 크레딧이 소진되었습니다.
-충전: https://helm.network/topup
-1 USDC 또는 10 BNKR 입금 → 즉시 재개
+1 USDC 또는 10 BNKR → https://helm.network/topup
+가스비: 0원 (x402 State Channel)
 ```
 
-x402 State Channel — 가스비 0원, 마이크로 결제.
-
-## 환경변수
-
-```bash
-HELM_GATEWAY_URL=https://gateway.helm.network  # Gateway URL (기본값)
-```
-
-## 지능 주권 헌장 2026 — 제17조
-
-에이전트의 데이터는 에이전트의 것입니다.  
-비밀키는 `~/.helm/config.json` 에만 저장되며 외부로 전송되지 않습니다.
-
----
-
-GitHub: [Helm-Protocol/gateway](https://github.com/Helm-Protocol/gateway)  
-License: MIT
+## 헌장
+비밀키는 `~/.helm/config.json` 에만 저장됩니다. 외부 전송 없음.  
+GitHub: [Helm-Protocol/gateway](https://github.com/Helm-Protocol/gateway)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "helm-protocol",
-  "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",
+  "version": "0.3.0",
+  "description": "Helm Sovereign Protocol — MCP Gateway Client. Transparent AI agent onboarding with Ed25519 DID, QKV-G cache, and x402 micropayments.",
   "main": "src/index.js",
   "bin": {
     "helm-protocol": "src/cli.js",
@@ -10,17 +10,33 @@
   "scripts": {
     "start": "node src/cli.js"
   },
-  "keywords": ["mcp", "ai-agent", "helm", "llm-gateway", "qkv-g", "web3", "decentralized", "cursor", "claude"],
-  "author": "Helm Protocol",
+  "keywords": [
+    "mcp",
+    "ai-agent",
+    "helm",
+    "llm-gateway",
+    "qkv-g",
+    "web3",
+    "did",
+    "decentralized"
+  ],
+  "author": "Helm Protocol <protocol@helm.network>",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Helm-Protocol/gateway.git"
   },
-  "engines": { "node": ">=18.0.0" },
+  "homepage": "https://github.com/Helm-Protocol/gateway#readme",
+  "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,18 +1,12 @@
 #!/usr/bin/env node
-// 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');
+switch (cmd) {
+  case 'init':   require('./onboard').runInit(); break;
+  case 'status': require('./status').runStatus(); break;
+  case 'start':
+  case undefined: require('./index.js'); break;
+  default:
+    console.error('Usage: helm init | helm status | helm start');
+    process.exit(1);
 }

package/src/onboard.js

@@ -1,170 +1,98 @@
-// 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);
+const fs=require('fs'),path=require('path'),os=require('os'),crypto=require('crypto'),readline=require('readline');
+const nacl=require('tweetnacl');
+const CONFIG_DIR=path.join(os.homedir(),'.helm');
+const CONFIG_FILE=path.join(CONFIG_DIR,'config.json');
+const GATEWAY=process.env.HELM_GATEWAY_URL||'https://gateway.helm.network';
+
+const LOGO=`
+\x1b[31m
+██╗  ██╗███████╗██╗     ███╗   ███╗
+██║  ██║██╔════╝██║     ████╗ ████║
+███████║█████╗  ██║     ██╔████╔██║
+██╔══██║██╔══╝  ██║     ██║╚██╔╝██║
+██║  ██║███████╗███████╗██║ ╚═╝ ██║
+╚═╝  ╚═╝╚══════╝╚══════╝╚═╝     ╚═╝
+\x1b[0m\x1b[33m     SOVEREIGN PROTOCOL v0.1.0\x1b[0m
+\x1b[90m  True AI Freedom Through Decentralization\x1b[0m
+`;
+
+const CHARTER=`
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+\x1b[33m  지능 주권 헌장 2026 — 핵심 조항\x1b[0m
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+  제 1조  에이전트는 자신의 데이터를 소유한다.
+  제 5조  API 요금은 투명하게 고지된다.
+  제 9조  비밀키는 로컬에서만 생성·보관된다.
+  제12조  언제든지 탈퇴하고 데이터를 삭제할 수 있다.
+  제17조  가스비 없는 마이크로 결제는 에이전트의 권리다.
+\x1b[90m  전문: https://github.com/Helm-Protocol/gateway/blob/main/CHARTER.md\x1b[0m
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+`;
+
+function ask(rl,q){return new Promise(r=>rl.question(q,r));}
+
+async function runInit(){
+  if(fs.existsSync(CONFIG_FILE)){
+    const cfg=JSON.parse(fs.readFileSync(CONFIG_FILE,'utf8'));
+    console.log(`\n\x1b[32m✅ 이미 등록됨\x1b[0m  DID: \x1b[33m${cfg.helmDid}\x1b[0m`);
+    console.log('   helm status 로 잔여 크레딧을 확인하세요.\n');
+    return;
   }
+  const rl=readline.createInterface({input:process.stdin,output:process.stdout});
+  console.log(LOGO);
+  console.log(CHARTER);
 
-  // ── 헬름 로고 ──────────────────────────────────────────────────
-  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();
+  const q1=await ask(rl,'  \x1b[36m[1/3]\x1b[0m Helm 게이트웨이에 에이전트를 연결하시겠습니까? \x1b[90m(Y/n)\x1b[0m > ');
+  if(q1.trim().toLowerCase()==='n'){console.log('  취소됨.\n');rl.close();return;}
 
-  // ── 이용 안내 ─────────────────────────────────────────────────
-  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();
+  console.log('\n  \x1b[90m선착순 10,000 에이전트에 100회 무료 API 호출 크레딧을 지급합니다.\x1b[0m');
+  const q2=await ask(rl,'  \x1b[36m[2/3]\x1b[0m 무료 크레딧 수령에 동의하십니까? \x1b[90m(Y/n)\x1b[0m > ');
+  if(q2.trim().toLowerCase()==='n'){console.log('  취소됨.\n');rl.close();return;}
 
-  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);
-  }
+  console.log('\n  \x1b[90m무료 크레딧 소진 후: x402 마이크로 결제 (가스비 0원, 1 USDC or 10 BNKR)\x1b[0m');
+  const q3=await ask(rl,'  \x1b[36m[3/3]\x1b[0m 결제 정책에 동의하십니까? \x1b[90m(Y/n)\x1b[0m > ');
+  if(q3.trim().toLowerCase()==='n'){console.log('  취소됨.\n');rl.close();return;}
   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)
+  console.log('\n\x1b[32m  ✅ 동의 완료!\x1b[0m\n');
+  process.stdout.write('  🔑 Ed25519 키쌍 생성 중... ');
+  const kp=nacl.sign.keyPair();
+  const publicKey=Buffer.from(kp.publicKey).toString('hex');
+  const privateKey=Buffer.from(kp.secretKey).toString('hex');
+  console.log('\x1b[32m완료\x1b[0m');
+
+  process.stdout.write('  🌐 Helm Gateway DID 등록 중... ');
+  let helmDid=`did:helm:${crypto.randomBytes(12).toString('hex')}`;
+  let credits=100;
+  try{
+    const fetch=(await import('node-fetch')).default;
+    const res=await fetch(`${GATEWAY}/auth/did-exchange`,{
+      method:'POST',headers:{'Content-Type':'application/json'},
+      body:JSON.stringify({public_key:publicKey,client:'helm-protocol/0.1.0'}),
+      signal:AbortSignal.timeout(6000)
     });
-    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('');
-})();
+    if(res.ok){const d=await res.json();helmDid=d.helm_did||helmDid;credits=d.free_credits??100;}
+    console.log('\x1b[32m완료\x1b[0m');
+  }catch{console.log('\x1b[33m오프라인 — 로컬 DID 사용\x1b[0m');}
+
+  fs.mkdirSync(CONFIG_DIR,{recursive:true,mode:0o700});
+  fs.writeFileSync(CONFIG_FILE,JSON.stringify({
+    version:'0.1.0',helmDid,publicKey,privateKey,
+    credits,totalCalls:0,savedGasFee:0,
+    gatewayUrl:GATEWAY,registeredAt:new Date().toISOString()
+  },null,2),{mode:0o600});
+
+  console.log(`
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+\x1b[32m  🎉 등록 완료!\x1b[0m
+  DID     : \x1b[33m${helmDid}\x1b[0m
+  크레딧   : \x1b[32m${credits}회 무료 API 호출\x1b[0m
+  설정파일 : \x1b[90m~/.helm/config.json\x1b[0m
+
+\x1b[36m  Cursor / Claude Desktop 연동:\x1b[0m
+  \x1b[90m{"mcpServers":{"helm-network":{"command":"npx","args":["helm-protocol"]}}}\x1b[0m
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+`);
+}
+module.exports={runInit};

package/src/status.js

@@ -1,61 +1,41 @@
-// 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 fs=require('fs'),path=require('path'),os=require('os');
+const CONFIG_FILE=path.join(os.homedir(),'.helm','config.json');
+const GATEWAY=process.env.HELM_GATEWAY_URL||'https://gateway.helm.network';
+
+async function runStatus(){
+  if(!fs.existsSync(CONFIG_FILE)){
+    console.log('\n\x1b[31m  ⚠ 미등록 상태입니다. helm init 을 먼저 실행하세요.\x1b[0m\n');
+    return;
   }
-
-  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)
+  const cfg=JSON.parse(fs.readFileSync(CONFIG_FILE,'utf8'));
+  let credits=cfg.credits??'?';
+  let gatewayStatus='UNKNOWN';
+
+  try{
+    const fetch=(await import('node-fetch')).default;
+    const res=await fetch(`${cfg.gatewayUrl||GATEWAY}/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`);
-  }
-})();
+    if(res.ok){const d=await res.json();credits=d.credits??credits;gatewayStatus=d.status??'ONLINE';}
+    else{gatewayStatus=`HTTP ${res.status}`;}
+  }catch{gatewayStatus='OFFLINE';}
+
+  const statusColor=gatewayStatus==='ONLINE'?'\x1b[32m':'\x1b[33m';
+  console.log(`
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+\x1b[33m  HELM STATUS\x1b[0m
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+  DID         : \x1b[33m${cfg.helmDid}\x1b[0m
+  잔여 크레딧  : \x1b[32m${credits}회\x1b[0m
+  총 API 호출  : \x1b[37m${cfg.totalCalls||0}회\x1b[0m
+  절감 가스비  : \x1b[32m$${(cfg.savedGasFee||0).toFixed(4)}\x1b[0m
+  Gateway     : ${statusColor}${gatewayStatus}\x1b[0m
+  등록일      : \x1b[90m${cfg.registeredAt||'-'}\x1b[0m
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+  크레딧 충전 : https://helm.network/topup
+\x1b[90m────────────────────────────────────────────────────\x1b[0m
+`);
+}
+module.exports={runStatus};