OpenClaw · Skill

Kasia

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

Web & Frontend Development

v1.0.0

VirusTotal: Suspicious

Install

Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.

Primary command

clawhub install renkasiyas/kasia

ClawHub installer

npx clawhub@latest install renkasiyas/kasia

OpenClaw CLI

openclaw skills install renkasiyas/kasia

Direct OpenClaw install

openclaw install renkasiyas/kasia

View source

What this skill does

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

Why it matters

Messages are stored on-chain and encrypted end-to-end, so no server or intermediary can read or delete them.

Typical use cases

Sending an encrypted message to a Kaspa wallet address
Checking pending handshake requests from other users
Reading decrypted conversation history on-chain
Storing encrypted private notes on the Kaspa blockchain
Attaching a note to a KAS payment

Source instructions

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:

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.<tool> 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:

# 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)

Related OpenClaw skills

Browse all →

OpenClaw Skill