Serial Alice SDK for JavaScript / TypeScript

The official JS/TS SDK for Serial Alice — certify AI energy consumption in one function call.

Install

npm install serialalice

Requires Node ≥ 18. Works in browsers, Deno, and Bun via native fetch.

Quick start

import { SerialAlice } from "serialalice";

const alice = new SerialAlice({ apiKey: "sa_xxx" });

const cert = await alice.certify({
  model:           "mistralai/Mistral-7B-Instruct-v0.3",
  hardware:        "H100-SXM-80GB",
  provider:        "RunPod",
  energyWh:        0.00419,
  tokensInput:     50,
  tokensOutput:    200,
  durationSeconds: 4.2,
});

console.log(cert.id);            // "sa-abc123..."
console.log(cert.verifyUrl);     // "https://api.serialalice.pt/..."
console.log(cert.trustScore);    // 0.85
console.log(cert.signatureValid);// true
console.log(cert.anchorStatus);  // "PENDING" | "ANCHORED"

Certificate object

cert.id             // "sa-abc123..."
cert.verifyUrl      // public verification URL (no auth)
cert.downloadUrl    // full bundle URL
cert.signatureValid // Ed25519 intact
cert.anchorStatus   // "PENDING" | "ANCHORED" | "FAILED"
cert.anchorTx       // Polygon tx hash | null
cert.trustScore     // 0.0–1.0
cert.trustPosture   // "hardware_measured" | "self_reported"
cert.claimType      // "hardware_measured" | "scheduling_decision"
cert.energyWh       // Wh | null
cert.uwhPerToken    // µWh/token | null
cert.modelId        // HuggingFace model ID
cert.hardware       // GPU label
cert.issuedAt       // ISO 8601

// Methods
const bundle = await cert.downloadBundle();  // full signed JSON
const valid  = await cert.verify();          // re-check now
const dict   = cert.toDict();               // plain object

Links

• Serial Alice Platform
• GitHub