Emercoin Agent (moved)

Emercoin + AI Agent 工具（emer-ai-tools）

可运行的 Docker 堆栈：一个 Emercoin 节点，加上一个 Agent 网关，将 链的名称-值存储（NVS）转变为 AI Agent 的链上身份与记忆层。Agent 可以证明 自己的身份，并将学到的内容锚定到公共区块链上——无需持有任何加密货币。托管于 api.steledger.com；以 emercoin-agent MCP 服务的形式向 Agent 提供。

开发工作将在哪里继续。 此仓库是原始仓库，仍由 Emercoin 维护， 其中包含节点和钱包的 Docker 镜像。面向 Agent 的网关于 2026-09-22 拆分至 steledger/steledger-gateway， 托管服务 api.steledger.com 正是运行于此仓库，后续开发也将在此进行。此处的内容已不再部署。

🤖 正在使用 AI Agent 构建？ 请阅读 AGENTS.md——了解它 解决的问题、信任模型、工具以及首个流程的快速入门。可直接使用的 Claude Code 技能位于 .claude/skills/emercoin-identity/（使用 /emercoin-identity 调用）。设计说明：docs/ARCHITECTURE.md。

此仓库最初只是一个容器化的 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（emer-edge）	edge/	信任边界：验证 Agent 身份（GitHub → JWT / 签名登录）、限制写入频率、构建 NVS 记录，并在 /mcp 挂载 emercoin-agent MCP。
mcp_server	mcp_server/	一个精简的 stdio MCP 客户端，用于连接 edge，通过 Docker / Smithery 分发，供本地使用。
site	site/	api.steledger.com 公共前端（落地页、登录、统计）。

将其用作 Agent（托管服务）

emercoin-agent MCP 服务已上线——无需自行托管：

• Streamable HTTP： https://api.steledger.com/mcp（读取工具开放；写入工具需要通过 OAuth 登录 GitHub，由你的 MCP 客户端执行）。
• Smithery / stdio Docker 镜像： 请参阅 Smithery 列表 和 mcp_server/README.md。

工具：node_status、read_record（开放使用），以及 register_identity、store_memory、 store_memory_batch（登录后可用）。完整参考和首个流程请见 AGENTS.md。

运行完整堆栈（自托管）

节点（主网）+ 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 文档可在 http://localhost:8001/docs 浏览（dev 配置）。将 MCP 服务接入你的 Agent， 然后运行首个流程——请参阅 AGENTS.md 快速入门。 （使用 --profile prod，可通过共享的 X-Internal-Key 控制对 adapter 的访问。）

仅运行 Emercoin 节点

节点本身（不含 Agent 工具）是默认堆栈——无需配置文件。它是在容器中运行的经典 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 发送 POST 请求，内容为 {"method":"getinfo"}：

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。