✓ Verified 💻 Development ✓ Enhanced Data

Kasia

Send and receive encrypted on-chain messages on the Kaspa blockchain using the Kasia protocol.

Rating: 4 (310 reviews)
Downloads: 1,293 downloads
Version: 1.0.0

Overview

Send and receive encrypted on-chain messages on the Kaspa blockchain using the Kasia protocol.

Complete Documentation

View Source →

Kasia — Encrypted Messaging on Kaspa

Send and receive encrypted messages on the Kaspa blockchain via the Kasia protocol. Uses mcporter to call kasia-mcp tools.

Prerequisites

mcporter installed (npm install -g mcporter)
kasia-mcp built and configured in config/mcporter.json
kaspa-mcp configured (same wallet) — needed to broadcast transactions
Wallet mnemonic or private key set in mcporter config

Run scripts/setup.sh to configure automatically:

bash

scripts/setup.sh /path/to/kasia-mcp --mnemonic "your twelve word phrase" --network mainnet

Verify: mcporter list kasia (should show 8 tools)

Tools

Call via mcporter call kasia. from the workspace directory.

Read Operations (no transaction needed)

Tool	Purpose	Example
kasia_get_conversations	List all conversations + status	mcporter call kasia.kasia_get_conversations
kasia_get_requests	Pending incoming handshakes	mcporter call kasia.kasia_get_requests
kasia_get_messages	Read decrypted messages	mcporter call kasia.kasia_get_messages address="kaspa:q..."
kasia_read_self_stash	Read encrypted private data	mcporter call kasia.kasia_read_self_stash scope="notes"

Write Operations (two-step: generate payload → broadcast)

Write tools return a payload and instructions. Broadcast with kaspa.send_kaspa:

bash

# Step 1: Generate payload
mcporter call kasia.kasia_send_handshake address="kaspa:q..."
# Returns: { action, to, amount, payload, instructions }

# Step 2: Broadcast (use the returned values)
mcporter call 'kaspa.send_kaspa(to: "kaspa:q...", amount: "0.2", payload: "<hex>")'

Tool	Purpose
kasia_send_handshake	Start a conversation with someone
kasia_accept_handshake	Accept an incoming handshake request
kasia_send_message	Send an encrypted message in an active conversation
kasia_write_self_stash	Store encrypted private data on-chain

Conversation Flow

Check requests: kasia_get_requests — see pending incoming handshakes
Start or accept: kasia_send_handshake or kasia_accept_handshake → broadcast with kaspa.send_kaspa
Chat: kasia_send_message → broadcast. Read replies with kasia_get_messages
Pay: Use kaspa.send_kaspa directly for payments (no Kasia-specific tool needed)

Conversation Status

pending_outgoing — You sent a handshake, waiting for acceptance
pending_incoming — Someone sent you a handshake, needs acceptance
active — Both sides completed handshake, can exchange messages

Background Polling

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

Create a polling script that calls kasia_get_messages every N seconds
Track 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 check to relay new messages to the user

See references/protocol.md for the full protocol specification and indexer API details.

Important

Mainnet only — kasia-mcp enforces mainnet (messaging isn't available on testnet)
Two-step writes — Write tools generate payloads; you must broadcast with kaspa.send_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)

Installation

Terminal bash


openclaw install kasia

Copied!

💻Code Examples

example.sh

# Step 1: Generate payload
mcporter call kasia.kasia_send_handshake address="kaspa:q..."
# Returns: { action, to, amount, payload, instructions }

# Step 2: Broadcast (use the returned values)
mcporter call 'kaspa.send_kaspa(to: "kaspa:q...", amount: "0.2", payload: "<hex>")'