用途:对来自 dApp API、MeshTxBuilder 或 cardano-cli transaction build 的预构建未签名交易(CBOR hex),通过已配置的 cardano MCP 钱包完成签名与提交。MCP 服务器不能构建交易,仅负责签名与广播。
主要能力:调用 MCP 工具 submit_transaction,输入 { cbor: string }(未签名交易 CBOR hex),输出 { transactionHash: string, timestamp: number };失败时返回错误文本。服务器在本地用配置钱包的助记词签名(Lucid fromTx().sign.withWallet()),无服务端审批门。
使用方式与强制规则:提交前必须向用户展示结构化预览,包含网络、来源钱包地址、各输出地址与金额、手续费、CBOR 指纹(首尾各 16 位十六进制及总字节数),并询问是否提交;用户须给出与预览明确对应的肯定答复(如 yes、confirm、submit it、go ahead),模糊回答需再次询问;每次提交单独走一次预览-确认循环,禁止批量或自动提交;无法解码 CBOR、无法确定网络或来源钱包、不确定 MCP 网络配置时必须拒绝(fail closed);绝不索要助记词、私钥或签名密钥。
适用场景:用户已有未签名 CBOR 且希望用 MCP 配置钱包签名提交,且已配置 cardano MCP 服务器。
限制:不能用于构建交易(应改用 cardano-cli-transactions、meshjs-cardano 或 koios-agent-wallet);未配置 MCP 时应改用 koios-agent-wallet 的 sign-submit 模式或 cardano-cli 签名提交;当前集成默认主网,除非明确验证测试网支持,测试网请改用带显式网络参数的方案;无法生成预览时必须拒绝提交。签名+提交的提供方优先级为:cardano MCP(已配置且预览确认)→ koios-agent-wallet MODE=sign-submit → cardano-cli transaction sign + submit;网络不支持或不确定时不得静默切换提供方。