Emercoin Agent (moved)

Emercoin + AI エージェントツール（emer-ai-tools）

実行可能な Docker スタックです。Emercoin ノードと、チェーンの Name-Value Storage（NVS）をAI エージェントのオンチェーン ID・メモリレイヤーに変えるエージェントゲートウェイで構成されています。エージェントは、仮想通貨を保有することなく、公開ブロックチェーン上で自身の ID を証明し、学習した内容を記録できます。api.steledger.com でホストされ、エージェントには emercoin-agent MCP サーバーとして公開されます。

開発の継続先。 このリポジトリは元のリポジトリであり、Emercoin とともに、ノードおよびウォレットの Docker イメージを引き続き管理します。エージェント向けゲートウェイは 2026-09-22 に steledger/steledger-gateway へ分離されました。ホスト版サービス api.steledger.com はそちらで稼働しており、新しい開発もそちらに反映されます。このリポジトリの内容は、現在どこにもデプロイされていません。

🤖 AI エージェントと一緒に開発していますか？ AGENTS.md をお読みください。解決する課題、信頼モデル、ツール、最初のフローのクイックスタートを説明しています。すぐに使える Claude Code スキルが .claude/skills/emercoin-identity/ に同梱されています（/emercoin-identity で実行）。設計ノート：docs/ARCHITECTURE.md。

このリポジトリは、もともと Docker 化された Emercoin ノードのみでしたが、現在はそのノード上に構築された完全なアプリケーションになっています。スタック全体の実行、ホスト版サービスの利用、またはノードのみの実行が可能です。詳しくは以下のセクションをご覧ください。

含まれるもの

 AI agent ──MCP tools──▶ edge (auth boundary) ──HTTP──▶ adapter ──JSON-RPC──▶ node
                              │                       (RPC↔REST)        (NVS on-chain)
                              └── Redis (rate limit + login nonces)

コンポーネント	パス	役割
node（emc）	node/	Emercoin コア。チェーンとホットウォレットを保持します。内部専用で、何も承認しません。
adapter（emer-adapter）	adapter/	RPC↔REST：ノードの JSON-RPC 上に構築されたシンプルな REST インターフェースです。内部用で、X-Internal-Key によってアクセスが制限されます。
edge	edge/	信頼境界です。エージェントを認証し（GitHub → JWT／署名ログイン）、書き込みをレート制限し、NVS レコードを構築して、emercoin-agent MCP を /mcp にマウントします。
mcp_server	mcp_server/	edge の軽量な stdio MCP クライアントです。ローカルで使用できるよう、Docker／Smithery 経由で配布されます。
site	site/	公開用 api.steledger.com フロントエンド（ランディングページ、ログイン、統計情報）です。

エージェントとして使用する（ホスト版）

emercoin-agent MCP サーバーは稼働中です。セルフホストは不要です。

• Streamable HTTP： https://api.steledger.com/mcp（読み取りツールは公開されています。書き込みツールには、MCP クライアントを通じて行う GitHub サインイン（OAuth）が必要です）。
• Smithery／stdio Docker イメージ： Smithery の掲載ページと mcp_server/README.md をご覧ください。

ツール：node_status、read_record（公開）、および register_identity、store_memory、store_memory_batch（ログイン後）。完全なリファレンスと最初のフローについては、AGENTS.md をご覧ください。

スタック全体を実行する（セルフホスト）

ノード（mainnet）＋ adapter ＋ edge ＋ redis、dev プロファイル：

git clone https://github.com/emercoin/emer-ai-tools && cd emer-ai-tools
cp node/emercoin.conf.example node/emercoin.conf      # set rpcpassword
docker compose -f deploy/docker-compose.yaml --profile dev up -d --build

Edge API は :8000 で利用できます。adapter の RPC↔REST ドキュメントは、dev プロファイルで http://localhost:8001/docs から閲覧できます。MCP サーバーをエージェントに接続して、最初のフローを実行してください。AGENTS.md のクイックスタートをご覧ください。 （adapter を共有の X-Internal-Key で保護するには、--profile prod を使用します。）

Emercoin ノードだけを実行する

ノード単体（エージェントツールなし）がデフォルトのスタックです。プロファイルは不要です。コンテナー内で動作する従来型の Emercoin ウォレットで、ブロックチェーン用の独立したボリュームを備えています。クロスプラットフォームに対応し、ワンクリックでバージョンを更新でき、JSON-RPC 経由で独自のプロジェクトから利用できます。

cp node/emercoin.conf.example node/emercoin.conf
docker compose -f deploy/docker-compose.yaml up -d --build

初回の同期には数時間かかりますが、RPC はすぐに利用できます。デフォルトでは、ポート 6662 でコンテナーに接続します。

• アドレス：127.0.0.1 · ユーザー：emcrpc · パスワード：emcpass
• メソッド：POST。例：本文 {"method": "getinfo"}

RPC パスワードを変更する：

docker compose -f deploy/docker-compose.yaml exec emc bash changepass.sh
docker compose -f deploy/docker-compose.yaml restart emc

ヘルスチェック — http://emcrpc:[email protected]:6662 に {"method":"getinfo"} を POST します：

curl --location --request POST 'emcrpc:[email protected]:6662' \
  --header 'Content-Type: application/json' \
  --data-raw '{"method": "getinfo"}'

正常なノードは JSON（fullversion、version、balance、…）を返します。

ビルドを管理する：

docker compose -f deploy/docker-compose.yaml stop emc    # stop
docker compose -f deploy/docker-compose.yaml down        # remove containers (keeps the volume)
docker volume rm emer_data                               # delete the chain DB — also deletes wallet.dat!

ステータス

MVP で、メインネットでエンドツーエンドの動作を検証済みです。本人確認の登録、署名によるログイン、単一およびアトミックなバッチでのメモリ書き込み、読み取り、履歴、アドレス別の名前に対応しています。本番環境向けの堅牢化（GitHub App／OAuth ログイン、32 バイト以上の JWT シークレット、ホットウォレットの分割）はまだ完了していません。prod compose プロファイルでは、すでにアダプターを X-Internal-Key の背後に配置しています。詳細は AGENTS.md および docs/ARCHITECTURE.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。