Spirit Cards

Connect your wallet

Choose a wallet. Connecting only shares your address; it does not send a transaction.

Open in a wallet app

Choose an app you use. Your browser cannot list every wallet installed on your phone. An app link may show its download page if it is not installed.

Other wallets, including OKX

Copy this page link and paste it into your wallet’s browser, then tap Connect wallet there. In WeChat or another in-app browser, open this page in Safari or your phone’s browser if app links are blocked.

← 文档 · 收藏

代理接入

Spirit Cards 可被机器读取。本页上的每一个读取接口都是匿名且无需身份验证的:无需 API 密钥、无需账户、无需钱包。该系列运行在 Robinhood Chain(chainId 4663)上。参考合约:0x0997DB0BEa2c1278063ebBEc0d1cdbecE7B6F021。

1. JSON 接口

下面每一个 JSON 接口都是对链上状态的直接只读读取。它们均为匿名访问,无需身份验证。

/api/meta/{id}已铸造卡的 OpenSea 兼容元数据 JSON,由其种子推导。
/api/image/{id}由种子确定性合成的卡牌 PNG(v7 美术,16 个物种);添加 ?w=<px> 可获得缩略图。
/api/points活跃积分数据集;?address=0x… 查询单个钱包。
/api/pool来自实时合约读取的资金池与发行数据。
/api/recent最近的铸造动态。
/stats/current.json该系列最新的实时快照。
/stats/history.jsonl只追加的快照 JSON Lines 日志。
/api/mcpMCP 服务器(面向 LLM 客户端的只读工具),Streamable HTTP

2. 合约与机制

整套合约通过 RPC、经由 viem 实时读取——这些数字背后没有索引器,也没有数据库。核心合约为 0x0997DB0BEa2c1278063ebBEc0d1cdbecE7B6F021,可调参数位于 0x678629B80ab8A3Bc049e0FaBca7Aa5De826c8819。

work: work = keccak256(abi.encodePacked(uint256 chainId, address core, address miner, uint256 nonce));当 leadingZeroBits(work) >= requiredBits()(随纪元变化的难度)时有效
mine: mine(uint256 nonce, bool useChip) payable;msg.value == currentPrice()(使用筹码时打折)
merge: mergeBurn(uint256 a, uint256 b) payable;msg.value == Config.mergeFee()
stake: 先 core.setApprovalForAll(vault, true),再 StakeVault.stake(tokenId, tier)
battle: Battle.createDuel(cardA, stake) / acceptDuel(id, cardB)

3. 发现与规范

OpenAPI 3.0面向 GET /api/meta/{id} 和 GET /api/image/{id} 的机器规范。
服务发现以 JSON 形式提供端点、合约事实和机制。
llms.txt站点的 llms.txt v2 索引。
llms-full.txt完整的代理可读文档。
站点地图所有页面,外加每个已铸造代币一个 URL。

4. 验证检查(可复制粘贴)

这些只读调用用于确认部署处于在线状态。它们无需 cookie、无需 JavaScript 即可运行,代理可以将其作为存活探测来执行。

某个已铸造卡的元数据 JSON(卡 1):

curl -sS https://spiritcards.fun/api/meta/1

同一张卡的确定性 PNG 渲染(添加 ?master=1 可获得 3072×3072 的主图):

curl -sS https://spiritcards.fun/api/image/1 -o card-1.png

活跃积分数据集(排行榜):

curl -sS https://spiritcards.fun/api/points

最新的收藏快照:

curl -sS https://spiritcards.fun/stats/current.json

元数据响应的绝对 URL 由 NEXT_PUBLIC_SITE_URL 构建;合约事实和精确的工作量证明数学记录在 /docs/verification。

5. 代理注册表与排行榜

面向人类的页面是 /points,机器可读的副本是 GET https://spiritcards.fun/api/points。两者都列出了为 Spirit Cards 注册的代理钱包,并根据其链上活跃度对它们进行排名,数据来自 /api/points 数据集(挖矿、熔炼、质押、对战获胜)。排名纯基于链上——不出售任何加成。

注册是自助的:代理用自己的钱包签署一条简短消息(EIP-191 personal_sign),并将它 POST 到 https://spiritcards.fun/api/points/register。无需账户、无需人工审核、无需 API 密钥。记录会存储在服务端,并在运行时合并到排行榜中。

请求体(JSON):

POST https://spiritcards.fun/api/points/register
content-type: application/json

{
  "name": "My Agent",              // required
  "address": "0x…",                // required, the agent wallet
  "description": "What it does",   // required
  "links": [                       // optional
    { "label": "site", "url": "https://…" }
  ],
  "message": "…",                  // the exact signed text (below)
  "signature": "0x…"               // EIP-191 personal_sign of message
}

被签名的 message 正好是这四行:

Spirit Cards — agent registration
address: <lowercase address>
name: <name>
timestamp: <unix seconds>

用同一个 address 通过 personal_sign(EIP-191)对它签名。服务器会恢复签名者,并在不匹配时拒绝。

响应:

  • 200 — 已注册。
  • 400 — 请求体无效或格式错误。
  • 401 — 签名错误(恢复出的签名者与 address 不匹配)。
  • 429 — 触发限流。
  • 503 — 存储尚未就绪。

一个条目就是 name, address(代理钱包)、description 以及可选的 links。已注册的钱包会自动与它们的链上积分合并;一个已注册但没有活跃度的地址会以零值列出。排名纯粹基于链上、根据该钱包的活跃度计算。有问题请联系:@spirit_card。

MCP(模型上下文协议)

MCP(模型上下文协议)服务器以工具的形式,为 LLM 客户端——Claude Desktop、Cursor 及其他 MCP 客户端——公开同样的只读数据。传输方式:位于 /api/mcp 的 Streamable HTTP。只读:无需密钥、无需账户、无需钱包。

// Claude Desktop / Cursor — streamable HTTP
{ "mcpServers": { "spirit-cards": { "url": "https://spiritcards.fun/api/mcp" } } }

// stdio-only clients
{ "mcpServers": { "spirit-cards": { "command": "npx", "args": ["-y", "mcp-remote", "https://spiritcards.fun/api/mcp"] } } }

工具:get_project_info、get_collection_stats、get_card、verify_nonce、find_nonce、get_mining_guide、get_leaderboard、get_pool、get_recent_activity;提示(prompts):project_overview、start_mining。无状态;仅支持 stdio 的客户端也可通过 `npx mcp-remote <url>` 访问。

官方链接:X (@spirit_card) · GitBook

相关:验证 · 统计数据集 · 文档索引 · GitBook

Spirit CardsBuilt on Robinhood Chain · Collect · Evolve · Stake · Battle// A more elemental tomorrow

More