Vraimony Open Proof Toolkit — Free & Open

Capture. Hash. Lint. Export.
Verify anywhere.

A free, open toolkit for building offline-verifiable proof bundles — across SDK, CLI, browser extension, and GitHub Action. No lock-in. No tracking. No backend required for the core layer.

Free forever Open source Offline-verifiable Zero dependencies (core) ERF-compatible

GitHub → npm install Chrome extension

Why this exists

The market is fragmented. No one owns the full layer.

Three categories of tools exist today — none of them fill the same slot.

Tool / Category	Open SDK?	Offline-verifiable?	Readiness lint?	Review-oriented output?	Business case layer?
GitHub Artifact Attestations	Partial	✓	—	Software provenance only	—
ProofSnap / WebPreserver / Page Vault	Proprietary	Some	—	Web capture	—
Reclaim Browser Extension SDK	Partial	—	—	Verification flows only	—
Document signing tools	—	Some	—	Signing only	—
Vraimony Open Proof Toolkit	✓ Open	✓ Full	✓ Reason-specific	✓ Decision-ready	✓ Core layer

No single player combines: open SDK + extension + offline-verifiable bundle + readiness lint + review-oriented output. This is the slot.

Architecture

One pipeline. Four distribution channels.

📂

Artifact
(file / URL / clipboard)

→

⚙️

Canonicalize
+ SHA-256 hash

→

📋

Readiness
lint

→

📦

Portable
proof bundle

→

🔍

Verify offline
or via viewer

📦

npm / composer

JS + PHP SDK · zero deps

💻

CLI

lint, hash, export, verify

🔵

Chrome Extension

capture · lint · export

⚙

GitHub Action

verify/lint in CI

The toolkit — four components

Install what you need. Use the rest as-is.

📦

JavaScript PHP Free

Proof SDK

Zero-dependency library for canonicalization, SHA-256 hashing, readiness assessment, and PDF download export. Runs in Node.js, browser, Deno, or PHP.

# JavaScript (npm)
npm install vraimony-proof-sdk

# PHP (composer)
composer require vraimony/proof-sdk

# Direct (browser)
<script src="/downloads/sdk/vraimony-sdk.js"></script>

const sdk = require('vraimony-proof-sdk');

// Build a record from any inputs
const record = sdk.createRecord({
  type:    'dispute',
  subject: 'Order #4521 — DNR claim',
  evidence: [
    { label: 'Tracking screenshot', file_hash: 'abc…', status: 'PASS' },
    { label: 'Delivery confirmation', status: 'Declared' },
  ]
});

// Assess readiness
const lint = sdk.assessReadiness(record);
// → { score: 78, gaps: ['missing_delivery_proof'], ready: false }

// Export PDF download
const bundle = sdk.buildExportJSON(record);
// → ERF-compatible JSON, offline-verifiable

GitHub → Full API docs

💻

CLI Free

Proof CLI

Terminal tool for hashing, linting, and exporting proof bundles. Runs offline. Useful in pipelines, local review stations, or air-gapped systems.

# Hash a file
vraimony hash evidence/tracking.jpg

# Lint a bundle for readiness gaps
vraimony lint case.erf.json --type dnr

# Export PDF download
vraimony export case/ --out bundle.erf.json

# Verify a bundle offline
vraimony verify bundle.erf.json

# Summarise for reviewer
vraimony summary bundle.erf.json

Download CLI Guide

🔵

Chrome Free

Browser Extension

Capture any page or artifact from the browser. Runs lint instantly. Exports a portable proof bundle you can verify offline or hand to a reviewer.

One-click page capture with timestamp + URL hash
Inline lint: readiness score + gap list
Export as ERF bundle (JSON) or print summary
Verify any ERF bundle without server call
Works on any page — no login required

Download Extension Install guide

⚙

GitHub Action Free

Verify / Lint Action

Add proof bundle verification to any CI pipeline. Lint ERF bundles on every PR or release. Fail fast on readiness gaps before evidence is submitted.

# .github/workflows/proof-lint.yml
name: Proof Lint
on: [push, pull_request]
jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: vraimony/proof-lint-action@v1
        with:
          bundle: case/bundle.erf.json
          type:   dnr
          fail-on-gaps: true

View Action →

📦

Spec Open

ERF Bundle Format

The portable proof bundle format. Readable by humans, parseable by machines, verifiable offline. Nine test vectors included.

{
  "erf": "1.0",
  "id": "vry_…",
  "type": "dispute",
  "subject": "Order #4521",
  "canonical_hash": "sha256:…",
  "evidence": [
    { "label": "Tracking", "status": "PASS",
      "file_hash": "sha256:…" },
    { "label": "Delivery", "status": "Declared" }
  ],
  "readiness": { "score": 78, "gaps": ["delivery_confirmation"] },
  "packaged_by": "vraimony-sdk/2.0"
}

Full spec → Test vectors

🔍

Free

Unified Proof Viewer

Open any ERF bundle in a clean, read-only reviewer interface. Works offline. No login. Runs from a single HTML file.

Drag-and-drop any .erf.json file
Renders timeline, evidence map, and readiness score
Verifies canonical hash locally — no server call
Printable / exportable as PDF

Open Viewer → Embed in your site

Honest scope

What the free toolkit does. What it does not.

✓ What it does

Canonicalize, hash, and lint any artifact or bundle. Build ERF-compatible records. Assess readiness. Export portable, offline-verifiable bundles. Verify integrity without a server call.

✕ What it does not

Cryptographic signing with ed25519 — that requires a key. Sealing records — happens on the Vraimony platform. Deciding outcome. Replacing legal opinion or formal audit.

🔐 For production sealing

The free toolkit builds the bundle. For a sealed, signed, reviewer-linked case record — use One-Case or the Embedded Case SDK.

One-Case → Embedded SDK

The upgrade path

Free toolkit builds the layer. Embedded SDK operationalises it.

The free toolkit gives any developer the building blocks. The paid Embedded Case SDK adds: rule packs, white-label receiver experience, workflow states, batch/ops features, and compliance packaging — for teams embedding this into their own product.

Start with GitHub → Embedded Case SDK (paid)

Capture. Hash. Lint. Export.Verify anywhere.