Security
Reporting a vulnerability
Do not open a public GitHub issue for security vulnerabilities.
Email security@k0yote.dev with:
- A description of the vulnerability and its potential impact.
- Steps to reproduce (proof-of-concept code if possible).
- Affected version(s) and environment.
Expect an initial acknowledgement within 72 hours. We will keep you informed as we investigate and work toward a fix, and credit you in the release notes unless you prefer to remain anonymous.
Supported versions
kawasekit is pre-alpha software. Until the 0.1.0 release, only the
latest main branch receives security fixes. Milestone tags
(v0.0.0-mN) are checkpoints — they do not receive backported fixes.
Threat model
The layer-by-layer threat model used by external reviewers lives in
docs/THREAT_MODEL.md.
It covers:
- EIP-3009 / x402 wire format — cross-chain replay, MITM eavesdrop, misadvertised EIP-712 domain.
- Self-facilitator EOA — key custody, concurrent settle nonce race,
DoS via repeated invalid
/verify. - Session-key envelope — bearer-grade combined with the session key, revoke race, envelope policy fingerprinting.
- Smart account boundary — validator privilege escalation, UserOp
signature replay, EIP-3009 attempted from a smart-account
from. - Agent runtime — LLM prompt injection, budget guard bypass, tool input forgery.
The document closes with a Known limitations section that records gaps the SDK chooses not to close in 0.1.0 — including the reasoning-step idempotency gap surfaced by external feedback on the M3 release announcement.