Quickstart

Welcome to Silvanexum — the spend-control plane for AI agents. This quickstart takes you from a fresh install to your first cryptographically signed, cost-metered agent run, so you can see the full capture → run → trace → attribute loop end to end.

1. Install the SDK

npm install @silvanexum/sdk
# pnpm add @silvanexum/sdk · yarn add @silvanexum/sdk · bun add @silvanexum/sdk

2. Get an API key

Create a key in the dashboard under Settings → API keys. Keys are scoped:

Export it so the SDK picks it up automatically:

export SILVANEXUM_API_KEY="sx_live_..."

3. Add a provider key

Runs execute on your provider key (BYO) — Silvanexum never fronts model spend. Add one in the dashboard under Settings → Keys, or via the SDK/API:

await sx.keys.save("anthropic", process.env.ANTHROPIC_API_KEY!);

When you run a public agent you don't own, it runs on your key and counts toward your budgets.

4. Run an agent

Point the client at an existing agent and send it a prompt. The run is captured, secret-scrubbed, and signed on the server.

import { Silvanexum } from "@silvanexum/sdk";
 
const sx = new Silvanexum(); // reads SILVANEXUM_API_KEY from the environment
 
const run = await sx.runs.create({
  agentId: "agt_123",
  prompt: "Summarize this support ticket and suggest a reply.",
});
 
console.log(run.output);
console.log("status:", run.status, "· latency:", run.latencyMs, "ms");
console.log("signed:", Boolean(run.signature), "· share:", sx.runs.shareUrl(run.id));

5. Read the signed trace

Every run carries a contentHash (sha256 of the canonical run) and a server signature over it — tamper-evident proof the platform recorded exactly this execution. The trace is the step-by-step timeline (model turns, tool calls) — each step carries its latency, tokens, and cost, so the trace doubles as the per-run spend record.

const full = await sx.runs.get(run.id);
for (const step of full.trace) {
  console.log(`${step.startMs}ms  ${step.kind}:${step.name}  (${step.status})`);
}
 
// Make it publicly shareable (scrubbed) — anyone can replay it at the share URL.
await sx.runs.setVisibility(run.id, "public");

Next steps