radix-community-web

Radix Community Web — MCP 技能

https://radix-community.genkipool.com 的 MCP 服务（服务名称：radix-community，版本 1.0.0）。

连接

Streamable HTTP 端点（无状态，无需身份验证）：

https://radix-community.genkipool.com/api/mcp

示例（Claude Code）：claude mcp add --transport http radix https://radix-community.genkipool.com/api/mcp

通用 JSON 客户端配置：

{
  "mcpServers": {
    "radix": { "type": "http", "url": "https://radix-community.genkipool.com/api/mcp" }
  }
}

如何使用此服务

1. 站点问题（“X 在哪里？”、“这个站点提供什么？”）→ get_site_overview。

2. 知识问题（“NFT 在 Radix 上如何运作？”、“验证者安装指南在哪里？”）→ search_radix_docs，然后调用 read_radix_doc 获取完整文本。两者都接受 locale: "en" | "es"——请使用用户的语言作答。

3. 链上数据（余额、实体状态、交易、验证者、NFT、持有者、组件状态、蓝图）→ 使用账本工具。所有工具都接受 network: "mainnet" | "stokenet"；默认值为 mainnet。切勿混用网络：mainnet 地址包含 _rdx1，stokenet 地址包含 _tdx_2_1（inspect_address 会告诉你地址所属的网络）。

4. 操作（发送代币、质押、创建代币、部署、使用 Radix 登录，……）：此服务无法签署交易（它是无状态的）。安全流程为：构建清单（控制台工具）→ validate_transaction_manifest → preview_transaction（显示实际费用和余额变动，不签名）→ explain_manifest，让用户了解清单内容 → 签名。签名通过单独的本地 MCP 服务 radix-connector（来自 SDK 的小型二进制文件）在用户的机器上执行：调用 setup_wallet_connector 获取一次性安装步骤。关键的配对流程：务必先调用 list_wallets。如果钱包已配对，则跳过配对并继续签名；如果尚未配对，则调用 pair_wallet。对于二维码：如果你的界面支持图像，请将 base64 PNG 保存到文件（例如工作区根目录下），并通过 Markdown 显示。如果你的界面是纯文本 CLI，请直接在聊天中打印 ASCII 艺术二维码，以便用户从终端扫描。告诉用户在 Radix Wallet（Linked Connectors）中扫描，然后立即调用 pair_status（该调用会阻塞，直到用户批准）。随后使用它的 send_transaction / request_pre_authorization / request_account_proof；对于身份和数据，使用 request_login（身份登录，在本地验证证明）、request_ownership_proof（指定账户 / 身份，无需选择）、request_authorized（登录、无挑战登录或 use_persona；重置；持续访问账户和身份数据）以及 request_data（精确或最低数量、电子邮件、电话号码）。手机上一次只显示一个请求，且无法远程撤回请求：每次只发送一个请求，等待结果，切勿并行发送多个请求。每个连接器故障都包含 code、stage 和 retry_safe——如果 retry_safe 为 NO（例如 NO_ANSWER：钱包已收到请求，但无人应答），请勿重新发送：让用户查看手机并调用 await_response；PENDING_IN_WALLET 表示仍有先前请求在等待（请在手机上处理该请求；如果请求始终不显示，则强制关闭并重新打开钱包，然后调用 cancel_request）；WALLET_UNREACHABLE / NOT_DELIVERED 表示请求从未到达手机（钱包应用已关闭或在后台运行——调用 check_wallet_connection）；DAPP_NOT_VERIFIED 表示 dApp 身份信息会导致钱包拒绝或静默丢弃请求（调用 check_dapp_identity）。使用 connector_log 跟踪请求；使用 pending_requests 查看正在等待的请求。不要盲目等待：如果约一分钟内请求仍未到达手机，请停止操作并读取 connector_log（request_start → turn_taken → channel_open → delivered → answered），查看请求停在了哪个环节。手机提示前模拟（connector ≥ 0.6.0）：send_transaction 会在 Gateway 上预览清单；如果交易会失败，就不会向手机发送提示（PREVIEW_FAILED，retry_safe: yes）；传入 preview_only: true 可模拟而不发送。多个进程共用一个连接：两个 AI 会话、sudo 提示或 CLI 可以共用已配对的连接，而钱包每个连接只保留一个通道——从 0.6.0 开始，连接器会在整台机器范围内轮流获取执行权，并等待钱包完成处理；如果同时运行旧版连接器，请求可能会消失。update 后，请重启 AI 工具：正在运行的会话会继续使用启动时的二进制文件（Linux：/proc/<pid>/exe 以 (deleted) 结尾）。手机无法联网？ 仍可通过 USB 线缆签名：运行连接器的本地中继（radix-connector-mcp relay），将它列入 RADIX_CONNECT_RELAYS，并将其设为钱包的信令服务器（URL 以 / 结尾，STUN 不得为空）；仅使用 USB 网络共享并不足够——手机还需要通过 WireGuard 隧道连接到这台电脑，并将其设为默认路由（PamAuthority：pamauthority wire）。dApp 身份信息：务必向这些调用传入 dapp_definition + origin，以便钱包显示已验证的 dApp，而非“未验证”——对于 send_transaction，这些参数是可选的；但对于 request_account_proof（ROLA 登录），它们是必需的，因为它们是签名消息的一部分。请通过 get_known_addresses {network} 获取这些值（origin 始终为 https://radix-community.genkipool.com；dApp 定义因网络而异）。提示手机前：钱包必须切换到与请求相同的网络（Settings → App Settings → Gateways），否则会返回 wrongNetwork。切勿在清单中添加 lock_fee（或 lock_contingent_fee）：钱包会根据用户选择的费用支付方自行添加费用锁定项；如果清单中已有费用锁定项，钱包会以 invalidRequest 拒绝。构建工具不会生成此项。如果用户不想安装连接器，可以在 https://radix-community.genkipool.com/{locale}/console/transaction-manifest 粘贴清单，并改在浏览器中签名。务必使用自定义仪表板向用户显示最终交易 URL：https://radix-community.genkipool.com/es/dashboard/tx/<intent_hash>

5. AI 安全与清单规则（重要）：切勿凭记忆手动编写或猜测 Scrypto 交易清单。Radix 清单语法经常变化，且非常复杂（例如，严格的 Enum 类型、Option/None 包装）。务必使用此服务提供的构建工具（build_fungible_token_manifest、build_manifest_from_template、build_validator_manifest，……）。此外，在调用本地连接器的 send_transaction 提示用户查看手机之前，必须先将清单传入 validate_transaction_manifest。如果验证失败，请勿提示用户；应修复错误或使用构建工具。

6. 验证者：在提出任何更改前，先用 get_validator_state 读取当前状态，再用 list_validator_operations 列出可执行的操作，然后用 build_validator_manifest 构建清单。它会解析账户持有的所有所有者徽章，并为它们组合一份证明。它会拒绝三种在账本上会出问题的组合，其中两种会悄无声息地失败，而非报错：在同一笔交易中执行 register + unregister（或两次费用变更）会提交成功，但最后一项会静默生效；对同一个验证者执行 unstake + claim-xrd 会导致整笔交易中止。create-validator 必须单独执行。不要为了绕过拒绝而手动拼装验证者清单——拒绝反映的是账本行为，并非工具的限制。

   启动验证者，按以下顺序操作：

   1. 单独执行 create-validator，提供节点的公钥（/system/identity → public_key_hex）、费用系数和以 XRD 计价的 payment。创建费用按美元计价，因此请先预览：余额变更会显示实际费用，未使用的 XRD 会退回账户。在 Stokenet 上，先用 build_faucet_manifest 为账户注资。交易提交后，所有者徽章会立即进入账户，工具会实时读取。
   2. 在一笔交易中执行 profile + register + accept-delegated-stake（这三项都需要所有者权限，可共用一份证明）。
   3. 节点运营者在节点上将 consensus.validator_address 设置为新的 validator_… 地址，然后重启节点；不设置该地址，节点就永远不会参与验证。
   4. 节点同步完成后执行一次 stake-as-owner（/system/health 显示 UP，而非 SYNCING）：如果验证者已激活，但节点仍在追赶同步进度，它收到的每个提案都会错过。

7. Gateway 暂时性错误：如果工具报错 NotSyncedUpError，表示 Gateway 比账本落后了一分钟以上。等待约 20 秒后，保持原样再次调用即可；请求本身没有问题。

输出格式

每个工具都会返回预先格式化的纯文本（横幅、对齐的键值行、表格、 围栏代码块和“后续步骤”部分）。这些内容就是为直接阅读而设计的—— 可原样引用，也可概述给用户，不要将其重新解析为数据。

典型工作流

• “Radix 上的 NFT 如何运作？” → search_radix_docs {"query": "NFT"} → read_radix_doc → 使用文档 URL 作答。
• “验证者安装指南在哪里？” → search_radix_docs {"query": "validator node"} → 分享结果中的 URL。
• “account_rdx1… 持有什么？” → get_account_balances。
• “给 Bob 转 10 XRD” → build_manifest_from_template {"templateId": "transfer-tokens", "values": {…}} → preview_transaction → 使用本地 radix-connector 签名（如果尚未安装，先运行 setup_wallet_connector），或在控制台中签名。
• “签名／实际发送这笔交易” → setup_wallet_connector（安装并配对一次）→ 本地连接器的 send_transaction {manifest, network, dapp_definition, origin} → transaction_status。
• “创建一个名为 Foo 的代币” → build_fungible_token_manifest → preview_transaction → 用户在控制台中签名。
• “创建 NFT 集合” → build_nft_collection_manifest（名称 + 初始 NFT）→ preview_transaction → 签名。
• “给我测试 XRD／为我的 Stokenet 账户注资” → build_faucet_manifest {"accountAddress": "account_tdx_2_…"} → 签名（仅限 Stokenet）。
• “部署我的 Scrypto 包” → build_deploy_package_manifest {"rpdHex": "<.rpd hex>"} → 本地连接器的 deploy_package {"wasm_path": "…/pkg.wasm", "package_definition": …}（它会从磁盘读取 WASM）。
• “注册／注销我的验证者，修改其费用、密钥或委托” → get_validator_state → build_validator_manifest {"account": "account_…", "operations": [{"kind": "register", "values": {"validator": "validator_…"}}, {"kind": "update-fee", "values": {"validator": "validator_…", "feeFactor": "0.05"}}]} → preview_transaction → 签名。控制台中的对应页面：https://radix-community.genkipool.com/en/console/validator-registration。
• “设置我的验证者名称、描述、图标或网站” → 使用 profile 操作调用 build_validator_manifest（只会写入你传入的字段）→ 签名。控制台：https://radix-community.genkipool.com/en/console/validator-profile。
• “我可以从未解除质押的资产中领取什么？” → list_claimable_stake_nfts {"account": "account_…"} → 将已成熟的 ID 传给 build_validator_manifest，作为 claim-xrd → 签名。控制台：https://radix-community.genkipool.com/en/console/validator-staking。
• “创建验证者” → 使用单个 create-validator 操作调用 build_validator_manifest（它不能与任何其他操作共用一笔交易）→ preview_transaction → 签名 → 然后在一笔交易中执行 profile + register + accept-delegated-stake → 在节点上设置 consensus.validator_address → 节点同步后执行一次 stake-as-owner。控制台：https://radix-community.genkipool.com/en/console/validator-create。
• “我应该向哪个验证者质押？” → list_validators → 比较费用／在线率／年化收益率 → 质押页面：https://radix-community.genkipool.com/en/console/staking。
• “这份清单将执行什么操作？” → explain_manifest（自然语言步骤）+ preview_transaction（费用、余额变化）。
• “XRD 价格／网络状态如何？” → get_xrd_price、get_network_status。
• “让我登录／证明我的身份” → 本地连接器的 request_login {network, dapp_definition, origin}（由身份签名；在同一次审批中添加 accounts: {quantity: 1, with_proof: true}，即可证明一个账户）→ 当需要再次证明确切账户时，运行 request_ownership_proof {identity_address, accounts}。
• “手机上一直没有显示请求／什么请求都收不到” → pending_requests → check_wallet_connection → connector_log；在钱包中响应请求或强制关闭钱包，然后运行 await_response 或 cancel_request。如果失败信息显示 retry_safe: NO，切勿重新发送请求。如果日志显示请求从未获得处理机会或通道，请检查机器上是否运行着其他连接器进程（旧版本，或更新前启动的会话），并更新／重启它们。
• “我有哪些账户／显示我的余额”（此服务是无状态的——它没有“已连接的钱包”）→ 本地连接器的 request_accounts（无需签名）以获取地址 → 对所选账户运行 get_account_balances。
• “谁持有代币 X？集合 Y 中有哪些 NFT？” → get_resource_holders、get_nft_data。
• “component_rdx1… 提供哪些方法？其中的状态是什么？” → get_component_blueprint、get_component_state、get_key_value_store。

工具参考

站点导航

get_site_overview — 获取站点概览

Radix Community 网站地图：列出每个版块、对应的 URL 及其提供的内容。当你需要了解网站上的某项内容位于何处时，请先调用此工具。

• locale（"en" | "es"；必填，默认值："en"）— 描述和生成的 URL 所用语言："en" 或 "es"

文档与知识

search_radix_docs — 搜索 Radix 文档

搜索网站精选文档（白皮书、Scrypto/开发者指南、节点与验证者指南、DeFi 概念）。返回匹配的文档及其 URL。不传入 "query" 即可列出所有可用文档。使用 read_radix_doc 获取完整内容。

• query（字符串；可选）— 自由文本搜索，例如 "install validator" 或 "NFT"。省略则列出所有文档。
• locale（"en" | "es"；必填，默认值："en"）— 返回内容所用语言："en"（英语）或 "es"（西班牙语）

read_radix_doc — 阅读 Radix 文档

以 Markdown 格式返回某个精选文档页面的完整内容，支持英语或西班牙语。通过 search_radix_docs 获取有效的文档 ID。

• docId（字符串；必填）— 文档 ID，例如 "scrypto-basics" 或 "babylon-guide"
• locale（"en" | "es"；必填，默认值："en"）— 返回内容所用语言："en"（英语）或 "es"（西班牙语）

账本（链上数据）

lookup_entity — 查询账本实体

获取任意 Radix 地址的链上状态：账户、组件、包、资源（代币/NFT）、验证者、池等。返回实体类型、元数据及其详细信息摘要。查询账户代币余额时，优先使用 get_account_balances。

• address（字符串；必填）— Bech32m Radix 地址，例如 account_rdx1…、component_rdx1…、package_rdx1…、resource_rdx1…、validator_rdx1…
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产网）或 "stokenet"（测试网）

get_account_balances — 获取账户余额

列出 Radix 账户持有的同质化代币（含数量）和非同质化代币（含本地 ID）。

• address（字符串；必填）— 账户地址（account_rdx1… / account_tdx_2_1…）
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产网）或 "stokenet"（测试网）

get_transaction — 获取交易详情

根据交易意图哈希（txid_…）获取已提交的交易：状态、费用、时间戳、受影响的实体、余额变动和交易清单。

• intentHash（字符串；必填）— 交易意图哈希（txid_…）
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产网）或 "stokenet"（测试网）

list_validators — 列出网络验证者

按质押排名列出 Radix 网络的验证者，并显示质押量、费用、正常运行时间和 APY。使用 "find" 按名称或地址筛选。可用于回答有关质押目标或特定验证者的问题。

• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产网）或 "stokenet"（测试网）
• find（字符串；可选）— 可选，不区分大小写地按验证者名称或地址筛选
• limit（整数；必填，默认值：20）— 最多返回的验证者数量

get_network_status — 获取网络状态

Radix 网络的当前状态：epoch、XRD 质押总量、活跃验证者数量、平均 APY 和平均正常运行时间。

• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产网）或 "stokenet"（测试网）

get_xrd_price — 获取 XRD 市场数据

来自 CoinGecko 的实时 XRD 市场数据：美元和欧元价格、24 小时变动、市值、流通供应量和总锁仓价值。

无参数。

get_recent_transactions — 获取最近的网络交易

整个网络中最新提交的交易，按时间从新到旧排列。使用 get_transaction 并传入交易意图哈希，获取其中一笔交易的完整明细。

• network ("mainnet" | "stokenet"; required, default: "mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• limit (integer; required, default: 10) — 最多返回的交易数量

get_address_transactions — 获取地址的交易记录

任意实体（账户、验证者、组件、资源）的交易历史，按时间从新到旧排列。第一页已显示最近的活动，这几乎总是用户想要的内容。账户可能有数千笔交易：请勿一直翻页到底——只有用户明确要求查看更早的记录时，才使用返回的游标获取更多页面。使用 get_transaction 获取其中一笔交易的完整明细。

• address (string; required) — Bech32m Radix 地址，例如 account_rdx1…、component_rdx1…、package_rdx1…、resource_rdx1…、validator_rdx1…
• network ("mainnet" | "stokenet"; required, default: "mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• limit (integer; required, default: 10) — 每页最多返回的交易数量
• cursor (string; optional) — 上次调用返回的分页游标，用于获取下一页（更早的记录）

get_nft_data — 获取 NFT ID 和数据

查看非同质化资源（NFT 集合）：不传入 "ids" 时，列出该集合的本地 ID；传入 "ids" 时，返回这些 NFT 解码后的链上数据（特征、字段），每次调用最多 10 个。

• resourceAddress (string; required) — 非同质化资源地址（resource_rdx1…）
• ids (array; optional) — NFT 本地 ID，例如 ["#1#", "#2#"] 或 ["<member_1>"]。省略则列出集合 ID。
• network ("mainnet" | "stokenet"; required, default: "mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

get_resource_holders — 获取资源的最大持有者

按持有数量排序，列出任意代币或 NFT 集合的最大持有者，并显示持有者总数。

• resourceAddress (string; required) — 资源地址（resource_rdx1…）
• network ("mainnet" | "stokenet"; required, default: "mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

get_component_state — 获取解码后的组件状态

组件当前解码后的链上状态（预言机价格、池储备、配置等），以及其包和蓝图。如需查看可调用方法，请使用 get_component_blueprint。

• address (string; required) — 组件地址（component_rdx1… / pool_rdx1…）
• network ("mainnet" | "stokenet"; required, default: "mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

get_key_value_store — 读取键值存储

读取链上键值存储（组件内部存储）的条目，并解码为 JSON。KVS 地址会显示在组件状态中的 internal_keyvaluestore_… 里。

• address (string; required) — 键值存储地址（internal_keyvaluestore_…）
• network ("mainnet" | "stokenet"; required, default: "mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

get_component_blueprint — 获取蓝图接口

组件或包蓝图的可调用接口：包含每个函数/方法的参数名称和类型。传入组件地址（系统会自动解析蓝图），或传入包地址以及可选的 blueprintName。

• address (string; required) — 组件（component_rdx1…）或包（package_rdx1…）地址
• blueprintName (string; optional) — 包中的蓝图名称。对组件地址无效。
• network ("mainnet" | "stokenet"; required, default: "mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

控制台（交易与开发者工具）

list_console_tools — 列出控制台工具

列出 Web 开发者控制台中的所有工具（发送交易、质押、创建代币、部署包、元数据、SBOR 解码等），并提供其 URL，以及是否需要连接钱包。使用此工具将用户引导至合适的控制台页面。

• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"

list_manifest_templates — 列出清单模板

列出可直接使用的交易清单模板（转移代币/NFT、质押、取消质押、领取、铸造、销毁、创建池、faucet 等）及每个模板所需的字段。使用 build_manifest_from_template 来生成模板内容。

• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"

build_manifest_from_template — 根据模板构建清单

根据给定的字段值生成可直接使用的交易清单模板（模板 ID 和字段参见 list_manifest_templates），对其进行验证，并返回可在 Web 控制台中签名的清单。

• templateId（string；必填）— 来自 list_manifest_templates 的模板 ID
• values（object；必填）— 按字段键名提供字段值，例如 { "from": "account_rdx1…", "amount": "10" }
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"

build_fungible_token_manifest — 构建同质化代币清单

构建交易清单，在 Radix 上创建新的同质化代币，并采用合理的默认设置（所有者：无，开放转账）。初始供应量会存入指定账户。对于 NFT，请使用 build_nft_collection_manifest；对于高级角色设置，请将用户引导至控制台的 create-token 工具。

• accountAddress（string；必填）— 接收初始供应量的账户
• name（string；必填）— 代币名称，例如 "My Token"
• symbol（string；必填）— 代币代码，例如 "MTK"
• description（string；可选）— 代币描述
• iconUrl（string；可选）— 代币图标的 HTTPS URL
• initialSupply（string；必填）— 初始供应量，以十进制字符串表示，例如 "1000000"
• divisibility（integer；必填，默认值：18）— 小数位数（0-18）
• mintable（boolean；必填，默认值：false）— 是否允许任何人铸造更多代币
• burnable（boolean；必填，默认值：false）— 是否允许任何人销毁代币
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"

build_nft_collection_manifest — 构建 NFT 集合清单

构建交易清单，在 Radix 上创建新的非同质化资源（NFT 集合），并创建一组初始 NFT（名称、描述、图像）；同时采用合理的默认设置（所有者：无，开放转账）。NFT 会存入指定账户。对于自定义数据字段或高级角色设置，请将用户引导至控制台的 create-token 工具。

• accountAddress（string；必填）— 接收铸造的 NFT 的账户
• name（string；必填）— 集合名称，例如 "My Collection"
• description（string；可选）— 集合描述
• iconUrl（string；可选）— 集合图标的 HTTPS URL
• nfts（array；必填）— 要在集合中铸造的初始 NFT
• mintable（boolean；必填，默认值：false）— 是否允许以后铸造更多 NFT
• burnable（boolean；必填，默认值：false）— 是否允许销毁 NFT
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"

build_faucet_manifest — 构建 Stokenet 水龙头清单

构建用于向 Stokenet 水龙头申请免费测试用 XRD 并将其存入账户的清单。仅限 Stokenet 使用——主网没有水龙头。可在执行其他交易前为测试账户充值。

• accountAddress（字符串；必填）— 要充值的 Stokenet 账户（account_tdx_2_…）
• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"

build_deploy_package_manifest — 准备 Scrypto 软件包部署

将已编译的 .rpd 软件包定义（Manifest SBOR）解码为发布 Scrypto 软件包所需的值，并返回要在本地 radix-connector 上运行的确切 deploy_package 调用。这里不会处理 WASM（对 Agent 来说太大）——连接器会从磁盘读取。请在使用 deploy_package 前调用此工具。

• rpdHex（字符串；必填）— 已编译的 .rpd 软件包定义文件内容的十六进制编码
• owner（"none" | "allowAll"；必填，默认值："none"）— 软件包所有者："none"（无所有者）或 "allowAll"（任何人都可以更新）
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

validate_transaction_manifest — 验证交易清单

使用 Radix Engine Toolkit 静态验证 Radix 交易清单语法，并在无效时报告确切的解析错误。

• manifest（字符串；必填）— 交易清单源文本
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

preview_transaction — 预览（模拟）交易

在 Gateway 上对交易清单进行无签名试运行：返回执行状态、XRD 总手续费、各实体的余额变更以及引擎日志。请务必先预览清单，再请求用户签名。

• manifest（字符串；必填）— 交易清单源文本
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"
• blobs（数组；可选）— 由清单通过 Blob("") 引用的十六进制编码 blob，例如软件包 WASM。对软件包部署进行试运行时必需。

explain_manifest — 解释交易清单

将 Radix 交易清单转换为通俗易懂的分步说明（取款、存款、证明、组件调用等），支持英语或西班牙语。可用于帮助用户了解即将签署的内容。

• manifest（字符串；必填）— 交易清单源文本
• locale（"en" | "es"；必填，默认值："en"）— 返回的标签/链接所用语言："en" 或 "es"

decode_sbor — 解码 SBOR 负载

将十六进制编码的 SBOR 负载（组件状态、事件、架构）解码为人类可读的文本。根据前缀字节自动检测 Scrypto 或 Manifest SBOR。

• hex（字符串；必填）— 十六进制编码的 SBOR 负载（Scrypto 以 5c 开头，Manifest 以 4d 开头）
• network（"mainnet" | "stokenet"；必填，默认值："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

convert_olympia_address — 转换 Olympia 地址

将旧版 Olympia 地址（rdx1… 账户或 _rr1… 资源）转换为 Babylon 对应地址。对于账户，还会返回嵌入地址中的压缩 secp256k1 公钥，以及 Radix Wallet 扫描后可导入旧版账户的钱包导入 QR 负载字符串（Settings → "Import from a Legacy Wallet"）。将该字符串呈现为 QR（或保存该字符串）即可完成导入。负载仅包含公开数据，不包含助记词或私钥。

• olympiaAddress（字符串；必填）— Olympia 地址（rdx1… 或 …_rr1…）
• network ("mainnet" | "stokenet"；必填，默认值："mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• accountType ("S" | "H"；必填，默认值："S") — 原始 Olympia 账户类型："S" 表示软件（助记词），"H" 表示硬件（Ledger）。
• addressIndex（整数；必填，默认值：0）— 推导该账户时使用的 BIP44 地址索引（第一个账户为 0）。
• accountName（字符串；必填，默认值："") — 导入时在移动钱包中显示的名称（最多 30 个字符）。
• wordCount（任意；必填，默认值：12）— 原始 Olympia 钱包助记词的单词数量（12、15、18、21 或 24）。

resolve_vault_address — 解析保险库地址

解析账户中持有某项资源的内部保险库地址（召回或冻结操作所需的目标）。一个账户恰好会在一个保险库中持有某项资源。对于非同质化资源，还会返回该保险库中的 NFT ID。将保险库填入 recall-token / recall-nft / freeze-vault / unfreeze-vault 清单模板。

• account（字符串；必填）— 持有该资源的账户地址（account_…）。
• resource（字符串；必填）— 要在账户中查找的资源地址（resource_…）。
• network ("mainnet" | "stokenet"；必填，默认值："mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

inspect_address — 检查 Radix 地址

离线分析任意 Radix bech32m 地址：实体类型（账户、资源、组件、包、验证者等）、网络及校验和有效性。不进行网络调用。

• address（字符串；必填）— 任意 Radix 地址或交易 ID

verify_account_security — 验证账户的保护方式

从账本读取实际控制 Radix 账户的对象：账户密钥（一个助记词，无恢复机制）或账户所有者徽章。如果是徽章，还会说明该徽章是否位于 Access Controller 中（具有恢复功能的多因素保护），还是直接存放在账户中。报告控制器的角色、定时恢复延迟，以及正在进行的恢复或徽章提取尝试。只读。

• address（字符串；必填）— 账户地址（account_rdx1… / account_tdx_2_1…）
• network ("mainnet" | "stokenet"；必填，默认值："mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

get_known_addresses — 获取网络常用地址

网络的规范常用地址：XRD 资源、水龙头、原生包（账户、池、验证者等）、系统徽章，以及签名时传递给钱包的本站 dApp 定义和来源。使用它填充清单地址，无需猜测。

• network ("mainnet" | "stokenet"；必填，默认值："mainnet") — Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

list_validator_operations — 列出验证者操作

列出验证者支持的所有操作（注册、注销、更改费用、更改共识密钥、开启 / 关闭委托、协议更新投票、公开资料元数据、质押、解除质押、领取、所有者锁定的质押单位、创建验证者），并说明每项操作是否需要所有者徽章，以及能否与其他操作共用一笔交易。在 build_validator_manifest 之前使用。

无参数。

get_validator_state — 读取验证者状态

从账本读取验证者信息：是否已注册、是否接受委托质押、费用系数、共识公钥，以及其铸造的质押单位（LSU）和领取 NFT 资源。可在提出更改前用于了解当前状态。

• validator（字符串；必填）— 验证者组件地址（validator_…）
• network（"mainnet" | "stokenet"；必填，默认："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

list_claimable_stake_nfts — 列出可领取的质押 NFT

列出账户持有的质押领取 NFT，每个 NFT 都标明铸造它的验证者、可兑换的 XRD 数量，以及是否已到期。将已到期的 NFT 传入 build_validator_manifest，作为 claim-xrd 操作。

• account（字符串；必填）— 账户地址（account_…）
• network（"mainnet" | "stokenet"；必填，默认："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

build_validator_manifest — 构建验证者清单

将一个或多个验证者操作构建为一份交易清单，解析账户持有的所有者徽章，并为它们组合成一份证明。拒绝账本会造成混乱的操作组合。返回清单，供用户在 Radix 钱包中签名。

• account（字符串；必填）— 用于签名、支付手续费并出示所有者徽章的账户
• operations（数组；必填）— 要合并到一笔交易中的操作
• network（"mainnet" | "stokenet"；必填，默认："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）

verify_document_signature — 验证文档签名证书

验证 Radix Seal 文档证明证书（即 .radixsig.json 文件的内容）。针对共享载荷检查每个签名——ROLA 证明和／或链上保管链——并报告证书是否完整。它只接收证书，绝不会接收文档本身。

• certificate（字符串；必填）— 证书 JSON：.radixsig.json 文件的完整内容。

check_signing_request — 检查 Radix Seal 签名请求

根据签名请求 ID（第一个邀请 NFT 全局 ID，例如 "resource_tdx_2_1...:#25#"）读取 Radix Seal 签名请求的链上状态。返回所需签名者、已签名者，以及请求是否已完成。只读 Gateway 查询。

• requestId（字符串；必填）— 请求 ID：第一个邀请 NFT 全局 ID，例如 "resource_tdx_2_1...:#25#"。
• network（"mainnet" | "stokenet"；必填，默认："mainnet"）— Radix 网络："mainnet"（生产环境）或 "stokenet"（测试网）
• docHash（字符串；可选）— 可选的文档哈希（blake2b-256，64 个十六进制字符），用于确认请求关联了预期文件。

setup_wallet_connector — 设置本地钱包签名

说明如何安装和使用本地 Radix 签名连接器（radix-connector-mcp），以便用户使用 Radix Wallet 签名并提交交易。此 HTTP 服务无法签名（它是无状态的）；本地连接器负责保持钱包通道，手机负责批准。用户想发送／签名交易、质押、创建代币、部署或使用 Radix 登录时，请调用此工具。

• client（"claude-code" | "claude-desktop" | "cursor" | "antigravity" | "generic"；必填，默认："generic"）— 用户运行的 MCP 客户端，以便注册代码片段与之匹配。
• os（"linux" | "macos" | "windows"；可选）— 用户的操作系统，用于显示对应的预编译二进制安装程序。省略则显示全部。