Docs · CLI · SDK · MCP · Embed widget

§ DOCS · CLI · SDK · MCP · EMBED

Four ways to plug Ivaronix into a workflow.

Every snippet runs against the live 0G Network — testnet for cheap iteration, mainnet for production. Snippets use a live sample receipt id; replace with any anchored id you have.

CLI

The Ivaronix CLI ships 34 commands. Install once, run a private review against any local file, anchor a receipt on chain. Every command works against the live 0G Network on both testnet and mainnet.

Install + first run

$ git clone https://github.com/Pratiikpy/ivaronix.git
$ cd ivaronix && pnpm install
$ cp .env.example .env  # fill IVARONIX_SIGNER_KEY
$ pnpm ivaronix doctor
$ pnpm ivaronix demo --tier standard

Ask a private skill

$ pnpm ivaronix doc ask contract.pdf "find risks" --skill private-doc-review --burn --quick

Verify a receipt anywhere

$ pnpm ivaronix receipt verify 66 --network mainnet --tee-independent
→ schema · hash · signature · anchor all PASS · TEE re-attestation if <24h old

Browse paid skills →

SDK

21 TypeScript packages. `@ivaronix/runtime` is the integration surface for embedding receipt anchoring in a Node service. `@ivaronix/receipts` carries the canonical hash + verify logic. `@ivaronix/og-chain` wraps the V3 / V2 / V1 receipt registry clients.

Run a skill from a server

import { runSkill } from '@ivaronix/runtime';

const receipt = await runSkill({
  skillId: 'private-doc-review',
  input: { document: contractText, question: 'find risks' },
  tier: 'standard',
});

console.log(receipt.id, receipt.chainAnchor.anchorTxHash);

Verify a receipt offline

import { verifyClaimed } from '@ivaronix/receipts';

const { state, checks } = verifyClaimed(receiptBody);
if (state !== 'CLAIMED') throw new Error('forged receipt');

MCP server

Wire Ivaronix into Claude Desktop or Cursor through the Model Context Protocol. The MCP server exposes 4 tools: run_skill, verify_receipt, list_passports, recall_memory. The host LLM calls them directly inside a chat session. The server runs from a built workspace binary — clone the repo, build the package, then point Claude Desktop at the built binary.

Claude Desktop config (workspace path)

// 1. Clone + build (one-time setup):
//    git clone https://github.com/Pratiikpy/ivaronix\n//    cd ivaronix && pnpm install && pnpm --filter @ivaronix/mcp-server build
//
// 2. Paste into ~/Library/Application Support/Claude/claude_desktop_config.json
//    (macOS) — replace <PATH> with the absolute path to your clone:
{
  "mcpServers": {
    "ivaronix": {
      "command": "node",
      "args": ["<PATH>/apps/mcp-server/dist/bin/server.js"]
    }
  }
}

Inside the chat

> @ivaronix verify 66
→ schema PASS · hash PASS · signature PASS · anchor 0x… · TEE PASS if <24h

Embed widget

Drop a verified receipt into any page with one iframe. The widget renders the TIER badge, four-light row, signer wallet, anchor tx, and verify chip without needing the Ivaronix install on the visitor side.

Single receipt embed

<iframe
  src="https://www.ivaronix.xyz/embed/r/66"
  width="640" height="480"
  frameborder="0"
  title="Ivaronix Verified Receipt #66"
/>

Full proof page link

<a href="https://www.ivaronix.xyz/r/66" target="_blank" rel="noopener">
  Verified by Ivaronix · /r/66
</a>

Preview the embed →

Source on GitHub: Pratiikpy/ivaronix·0G primitives: /0g·Receipt anatomy: /learn#receipt-anatomy