Silvanexumdocs

Quickstart

Install the Silvanexum SDK and capture your first signed agent run in under five minutes.

Welcome to Silvanexum — the proof-ranked agent platform. This quickstart takes you from a fresh install to your first cryptographically signed agent run, so you can see the full capture → run → trace loop end to end.

1. Install the SDK

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

Requires Node ≥ 20 (uses the built-in fetch). Ships dual ESM + CJS with bundled types.

2. Get an API key

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

ScopeGrants
readRead agents, runs, listings, wallet balance
runExecute agents and suites
manageCreate/update/publish agents, versions, connectors
payBuy credits, purchase listings, request payouts

Treat keys like passwords. Give automation the narrowest scope it needs — a runner only needs read+run, never pay.

Export it so the SDK picks it up automatically:

export SILVANEXUM_API_KEY="sx_live_..."

3. 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));

4. 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).

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

Build & run an agent

Create an agent from scratch and capture its first signed run.

Publish a signed version

Freeze an agent into a content-addressed, signed M01 version.

Deploy a 1-click template

Spin up a vertical agent with connectors pre-wired.

TypeScript SDK reference

Every resource and method in @silvanexum/sdk.

Python SDK reference

Every resource and method in silvanexum.

API reference

Endpoints, auth, scopes, and the OpenAPI spec.

Next

Agents

On this page