raven-solana-agent-kit-plugin
v0.1.0
Published
Raven plugin for Solana Agent Kit v2 — signed, fail-closed token-launch verification (preflight receipts) before your agent touches a Solana token.
Maintainers
Readme
raven-solana-agent-kit-plugin
Signed, fail-closed Solana token-launch verification for Solana Agent Kit v2 agents — one reflex: before your agent touches a Solana token, it asks Raven.
import { SolanaAgentKit } from "solana-agent-kit";
import RavenPlugin from "raven-solana-agent-kit-plugin";
const agent = new SolanaAgentKit(wallet, rpcUrl, { RAVEN_API_KEY: "..." })
.use(RavenPlugin);
// action: VERIFY_TOKEN_WITH_RAVEN — call before any trade/list/route/recommendWhat the action returns: a machine-verifiable receipt — verdict
(pass | pass_with_info_finding | warning | risk | unknowable), finding
codes, explicit coverageGaps, ed25519 signature (published key
rvk_c2997e90215279c2), replay hash, observed slot, engine version — plus a
policy hint (proceed_if_gaps_acceptable / escalate_to_human /
block_or_escalate / do_not_proceed) that never upgrades the verdict.
Honesty rules baked in: never says "safe"; with gaps remaining the summary
says "not enough evidence for a full pass"; verifier errors and unknown
signing keys fail closed; receipt keyId is checked against
/pubkey on every call.
Not financial advice; no price prediction.
Access: free invite-gated alpha keys at
request-access;
no key needed via Virtuals ACP (solana_verify_token, 0.1 USDC/job) or the
free local MCP (npx -y raven-verify-mcp).
Docs agents can eval: agents.json · openapi.json · evals · receipt test vector
Tests: npm test — 5 cases incl. fail-closed paths, run against the public
receipt test vector. Verified live against production.
