Skip to content

Security: clevercon-protocol/clevercon

Security

SECURITY.md

Security Policy

Pre-production status

CleverCon currently runs on Stellar Testnet. Contracts, wallets, and funds involved are all testnet assets with no real-world value. Even so, we treat security issues seriously, since the CleverVault contract, its planned spending- policy layer, and the orchestration logic are the foundation for a future mainnet deployment.

Reporting a vulnerability

If you discover a security vulnerability, please report it privately by emailing joshuaibitoye111@gmail.com. Do not open a public GitHub issue for security reports.

Please include:

  • A description of the vulnerability and its potential impact.
  • Steps to reproduce, including any relevant transaction hashes, contract IDs, or request payloads (testnet only; do not send real secret keys).
  • The affected package or contract (e.g. contracts/agent-vault, packages/orchestrator).

What to expect

  • Acknowledgement within 48 hours of your report.
  • Initial triage within 5 business days, including a severity assessment and, where applicable, a plan and rough timeline for a fix.
  • We keep you updated as a fix is developed and let you know when it ships. Credit is offered to reporters who wish to be named once a fix is released.

Scope

In scope:

  • contracts/agent-vault (CleverVault) and contracts/budget-guardian: fund-handling logic, authorization checks, and state transitions.
  • packages/orchestrator, packages/registry, and packages/common: payment construction and signing, vault interaction, and data persisted to disk (e.g. wallet secrets in packages/orchestrator/src/orchestrator-store.ts).
  • packages/agents/*: payment verification on specialist agent endpoints.
  • The planned spending-policy layer for CleverVault (proof verification, policy commitments, and replay handling). The engine currently lives in CipherMit; report issues there or here.
  • scripts/* and CI/deployment configuration (render.yaml, .github/workflows/*).

Out of scope:

  • packages/dashboard (the React frontend) and general UI/UX issues. Please still report these, but they are a lower priority during the current backend-hardening phase.
  • Third-party services CleverCon depends on (the Stellar network itself, the x402 facilitator, Anthropic's API, Render). Report these to their respective maintainers.
  • Issues that require a compromised local environment or physical access to a user's machine.

Known limitations

A few hardening gaps are tracked as open issues rather than hidden:

  • Orchestrator secret keys are currently stored in plaintext in data/orchestrators.json (flagged in source as a pre-production shortcut).
  • The registry's JSON file store has no write locking, so concurrent writes can race.

If you find additional issues along these lines, please still report them. Duplicates help us prioritize.

There aren't any published security advisories