# SVS: Solana Verification System

SVS is the Solana Verification System for agent and bot actions. Older integration copy may call this capability SVS Agent Verification, but do not narrow the product to only that label.

Use SVS when a Solana agent needs to prove that an action was:

- requested by an authenticated bot,
- checked against policy,
- approved by a human wallet/operator,
- broadcast and registered on-chain,
- protected against replay and stale credentials,
- exportable as a portable audit proof.
- presentable as a verified agent profile and badge that users and protocols can re-check.

Start here:

- `docs/agent-quickstart.md`
- `docs/llm-integration-guide.md`
- `docs/openapi.json`
- `docs/examples.json`
- New project scaffold: `npm create svs-agent my-agent`, or `npm run agent:scaffold -- ./tmp/my-agent` locally
- `packages/svs-js/README.md`
- Framework adapters: `@svsprotocol/solana/solana-agent-kit`, `@svsprotocol/solana/elizaos`, `@svsprotocol/solana/goat`, and `@svsprotocol/solana/vercel-ai`

Primary package:

```sh
npm install @svsprotocol/solana
```

Primary code path:

```js
import { SolanaVerificationClient } from "@svsprotocol/solana";

const svs = new SolanaVerificationClient({
  baseUrl: process.env.SVS_SERVER_URL,
  apiKey: process.env.SVS_BOT_API_KEY,
  requestSigningSecret: process.env.SVS_BOT_REQUEST_SIGNING_SECRET,
  expectedIntegrationContractHash: process.env.SVS_BOT_EXPECTED_INTEGRATION_CONTRACT_HASH
});

await svs.checkBotReadiness({ botId: process.env.SVS_BOT_ID });
await svs.submitCertifiedActionAndWaitForProof(action, {
  botId: process.env.SVS_BOT_ID,
  idempotencyKey: action.requestId,
  fetchProof: true,
  checkReceiptRegistryChain: true
});
```

Never bypass production certification, request signing, nonce replay protection, or idempotency-key retry safety. If SVS returns a `nextAction.message`, show that message to the operator.

Adoption goal: Any Solana agent can add SVS in 10 minutes, prove it is production-ready, and show a public badge that protocols and users can verify.