Kasia

Kasia — 加密ed Messaging on Kaspa

发送 and 接收 加密ed messages on the Kaspa blockchAIn via the Kasia protocol. Uses mcporter to call kasia-mcp 工具s.

Prerequisites mcporter 安装ed (npm 安装 -g mcporter) kasia-mcp built and 配置d in config/mcporter.json kaspa-mcp 配置d (same wallet) — needed to broadcast transactions Wallet mnemonic or private key 设置 in mcporter config

运行 scripts/设置up.sh to 配置 automatically:

scripts/设置up.sh /path/to/kasia-mcp --mnemonic "your twelve word phrase" --network mAInnet

验证: mcporter 列出 kasia (should show 8 工具s)

工具s

Call via mcporter call kasia.<工具> from the workspace directory.

Read Operations (no transaction needed) 工具 Purpose Example kasia_获取_conversations 列出 all conversations + 状态 mcporter call kasia.kasia_获取_conversations kasia_获取_请求s Pending incoming handshakes mcporter call kasia.kasia_获取_请求s kasia_获取_messages Read 解密ed messages mcporter call kasia.kasia_获取_messages 添加ress="kaspa:q..." kasia_read_self_stash Read 加密ed private data mcporter call kasia.kasia_read_self_stash scope="notes" Write Operations (two-step: 生成 payload → broadcast)

Write 工具s return a payload and instructions. Broadcast with kaspa.发送_kaspa:

# Step 1: 生成 payload mcporter call kasia.kasia_发送_handshake 添加ress="kaspa:q..." # Returns: { action, to, amount, payload, instructions }

# Step 2: Broadcast (use the returned values) mcporter call 'kaspa.发送_kaspa(to: "kaspa:q...", amount: "0.2", payload: "")'

工具 Purpose kasia_发送_handshake 启动 a conversation with someone kasia_accept_handshake Accept an incoming handshake 请求 kasia_发送_message 发送 an 加密ed message in an active conversation kasia_write_self_stash Store 加密ed private data on-chAIn Conversation Flow 检查 请求s: kasia_获取_请求s — see pending incoming handshakes 启动 or accept: kasia_发送_handshake or kasia_accept_handshake → broadcast with kaspa.发送_kaspa Chat: kasia_发送_message → broadcast. Read replies with kasia_获取_messages Pay: Use kaspa.发送_kaspa directly for payments (no Kasia-specific 工具 needed) Conversation 状态 pending_outgoing — You sent a handshake, wAIting for acceptance pending_incoming — Someone sent you a handshake, needs acceptance active — 机器人h sides completed handshake, can exchange messages Background Polling

For real-time message relay, 设置 up a background poller:

创建 a polling script that calls kasia_获取_messages every N seconds 追踪 seen transaction IDs to avoid duplicates Write new messages to a file (e.g., memory/kasia-new-messages.jsonl) Use a cron job or heartbeat 检查 to relay new messages to the user

See references/protocol.md for the full protocol specification and 索引er API detAIls.

导入ant MAInnet only — kasia-mcp enforces mAInnet (messaging isn't avAIlable on testnet) Two-step writes — Write 工具s 生成 payloads; you must broadcast with kaspa.发送_kaspa Same wallet — kasia-mcp and kaspa-mcp must use the same mnemonic/key Costs KAS — Every message is a transaction (~0.2 KAS minimum per tx)