🪶 Engrave Protocol

通过Solana上的x402微支付协议按需支付比特币内存池数据给AI代理

为Solana x402黑客马拉松（MCP赛道）构建

---

🧩 概述

Engrave Protocol 是一个MCP（模型上下文协议）服务器，它通过受微支付保护的API为AI代理提供对接比特币区块链数据的能力。

与昂贵的月度订阅不同，AI代理只需为每次查询支付极小金额（低至0.01美元USDC）。支付通过Solana即时完成，数据来自比特币的内存池。

关键创新点：无需API密钥、无需订阅、无需预付费用。支付即认证。

---

❗ 问题陈述

传统的区块链数据API需要：

• 每月99美元以上的订阅费（无论使用情况）
• API密钥管理（存在安全风险）
• 速率限制（即使付费也有限制）
• 未使用时浪费资金

对于具有不可预测、按需使用模式的AI代理来说，这种模式是不合理的。

---

⚙️ 解决方案

由以下技术支持的真正按需支付API访问：

• x402 HTTP支付协议 - 通过402状态码要求支付
• Solana USDC微支付 - 即时、低于一美分的交易
• MCP集成 - 通过Claude、Gemini等无缝接入AI代理
• 比特币内存池数据 - 实时区块链分析

AI代理询问：“当前比特币费用是多少？”
     ↓
在Solana上支付0.01美元USDC（即时）
     ↓
获取实时内存池数据
     ↓
AI代理回复费用建议

---

🚀 快速开始

先决条件

• 安装Node.js 18+
• 兼容MCP的客户端（推荐使用Claude Desktop）
• 在Devnet上拥有USDC的Solana钱包

1. 安装与设置

# 克隆并安装
git clone https://github.com/david-dacruz/engrave-protocol.git
cd engrave-protocol/api
npm install

# 配置环境
cp .env.example .env
# 编辑.env文件，填写您的金库钱包地址

2. 启动API服务器

cd api
npm run dev

# API启动于http://localhost:3000
# 测试健康状况：curl http://localhost:3000/health

3. 创建MCP钱包

# 生成用于MCP服务器的钱包（存储在api/mcp_wallet.json中）
npm run mcp:create-wallet

# 在Solana Devnet上为钱包充值USDC
# 访问：https://faucet.circle.com

4. 配置您的MCP客户端

对于Claude Code CLI：

cd engrave-protocol/api
claude mcp add engrave-protocol \
  -e PORT=3000 \
  -e TREASURY_WALLET_ADDRESS=您的solana金库地址 \
  -- sh -c "cd $(pwd) && node src/mcp/server.js"

对于Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
	"mcpServers": {
		"engrave-protocol": {
			"command": "sh",
			"args": [
				"-c",
				"cd /绝对路径到/engrave-protocol/api && node src/mcp/server.js"
			],
			"env": {
				"PORT": "3000",
				"TREASURY_WALLET_ADDRESS": "您的solana金库地址"
			}
		}
	}
}

5. 测试！

重启Claude Desktop并尝试：

当前比特币测试网费用建议是什么？

MCP服务器将自动：

• 在Solana上支付0.01美元USDC
• 查询内存池API
• 返回实时费用数据

---

🔧 可用的MCP工具（总计8个）

工具	描述	成本	使用场景
query_mempool_height	当前区块高度	免费	连接性检查
query_mempool_fees	费用建议	0.01美元	交易规划
query_mempool_stats	内存池统计	0.01美元	拥堵监控
query_mempool_tx_status	交易确认状态	0.05美元	跟踪确认
query_mempool_transaction	完整交易详情	0.10美元	调查
query_mempool_address	地址信息及余额	0.10美元	余额检查
query_mempool_address_txs	地址交易历史	0.25美元	完整审计
query_mempool_block	区块数据	0.10美元	链分析

所有价格以Solana Devnet上的USDC计价

---

🏗️ 架构

┌────────────────────────────────────────┐
│  AI代理（Claude/Gemini）              │
│  “比特币费用是多少？”              │
└──────────────┬─────────────────────────┘
               │ MCP协议（标准I/O）
               ▼
┌────────────────────────────────────────┐
│  MCP服务器（Engrave Protocol）         │
│  • 管理Solana钱包               │
│  • 处理x402支付               │
│  • 8个内存池查询工具               │
└──────────────┬─────────────────────────┘
               │ HTTP + x402-axios
               ▼
┌────────────────────────────────────────┐
│  Express API（支付网关）         │
│  • 验证支付签名         │
│  • 速率限制（每秒10次请求）            │
│  • 异步支付结算            │
└──────────────┬─────────────────────────┘
               │ 限速HTTP
               ▼
┌────────────────────────────────────────┐
│  Mempool.space API                     │
│  • 比特币区块链数据             │
│  • 支持测试网和主网           │
└────────────────────────────────────────┘

关键创新点：支付透明地发生在MCP服务器和API之间，用户只需提问。

---

💡 示例用例

1. 交易机器人

每30秒监测内存池拥堵情况以定时交易
成本：0.03美元/检查 = 87美元/天（如果全天候运行）
传统API：300美元/月（无论是否使用）
节省：根据实际使用情况节省70-99%

2. 区块链浏览器

用户查询其交易 → 支付0.10美元 → 返回数据
浏览器向用户收取0.12美元（20%加成）
零固定成本，即时利润率

3. 研究与分析

学术研究者间歇性研究比特币模式
大量分析：活跃时每周花费50美元
平静期：每周0美元
传统API：每月99美元始终
节省：约每年600美元

4. AI助手

用户：“我现在应该发送我的比特币交易吗？”
代理：检查费用（0.01美元）+ 内存池统计（0.01美元）
代理：“费用很低，每字节3聪，现在发送是个好时机！”
总成本：每个问题0.02美元

---

📊 成本比较

传统API（类似于mempool.space）

• 月度订阅：99美元/月
• 年度成本：1,188美元/年
• 每次查询成本（每月30次）：3.30美元
• 未使用时浪费：99美元/月

Engrave Protocol

• 按查询支付：0.01美元 - 0.25美元
• 年度成本：仅使用部分
• 每次查询成本：0.01美元 - 0.25美元
• 未使用时浪费：0.00美元

盈亏平衡点：约每月400次查询

---

🛠️ 开发脚本

# API服务器
npm run dev              # 启动带有热重载的API
npm run start            # 生产模式下启动API

# MCP服务器
npm run mcp:create-wallet # 生成新的MCP钱包
npm run mcp:inspect # 使用检查器测试MCP服务器

# 测试
npm run dev
npm run test

🔐 安全注意事项

• ⚠️ 仅限开发：目前使用比特币测试网+Solana开发网
• 💰 资金有限：保持MCP钱包中的USDC最小化
• 🔒 环境变量：使用.env文件进行敏感配置

---

🤝 贡献

此项目为**Solana x402黑客马拉松（MCP赛道）**而建。

欢迎贡献：

1. 分叉仓库
2. 创建功能分支（git checkout -b feature/amazing）
3. 提交更改（git commit -m '添加神奇功能'）
4. 推送到分支（git push origin feature/amazing）
5. 打开拉取请求

---

🔗 链接

• 主页：https://engrave-protocol.ai/
• GitHub：https://github.com/david-dacruz/engrave-protocol
• Twitter：https://x.com/engraveprotocol
• x402协议：https://solana.com/developers/guides/getstarted/intro-to-x402
• MCP协议：https://modelcontextprotocol.io
• USDC水龙头：https://faucet.circle.com
• Mempool.space：https://mempool.space

---

在Solana x402黑客马拉松期间构建 🏆 让区块链数据对AI代理而言更加经济

📁 资源

此仓库包括演示、开发者和演讲的各种支持材料。

🎥 演示

• 黑客马拉松演示视频
  为Solana x402黑客马拉松创建的短演示视频。

👨‍💻 开发者文档

• API端点（PDF）
  供集成Engrave Protocol的开发者使用的详细API端点文档。

🪄 演讲稿

• 演讲稿（HTML）
• 演讲稿（Markdown）
• 演讲稿（PDF）
• 演讲稿说明

---

每个资源提供了Engrave Protocol演示和开发者材料的不同格式或视角。

🪶 Engrave Protocol - 按需支付，不多不少。

---

📜 许可证

MIT许可证