{"_id":"@digitalforgestudios/minerva-sdk","_rev":"9-24aa693815d60f6b71ec7d6bb83a7224","name":"@digitalforgestudios/minerva-sdk","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@digitalforgestudios/minerva-sdk","version":"0.1.0","keywords":["zk-stark","esg","privacy","compliance","wasm","zero-knowledge"],"license":"SEE LICENSE IN LICENSE.md","_id":"@digitalforgestudios/minerva-sdk@0.1.0","maintainers":[{"name":"mcdoolz","email":"apouriliaee@gmail.com"}],"homepage":"https://zkesg.com/sdk","bugs":{"url":"https://github.com/digitalforgeca/minerva-sdk/issues"},"dist":{"shasum":"7ddf23bd26767a8e37cba2b49c9a65e2ce9b4f6f","tarball":"https://registry.npmjs.org/@digitalforgestudios/minerva-sdk/-/minerva-sdk-0.1.0.tgz","fileCount":6,"integrity":"sha512-9bROTHXW7IzGaggq+a5hyNa8pFeZ0Pki/IYPq/tq1NLIZPcwxtkrwAnJtWaBHrG53ZctIDnTmdSrR92V2tgNow==","signatures":[{"sig":"MEQCIB1iqjWkWAiB6UH2aDRButmr3x84HAzGNO6981FU2FsoAiBXrbTpxvawlDAJc4/5ybj/+yUa87v1gRc25t42om+1Vg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":874173},"main":"minerva_wasm.js","type":"module","types":"minerva_wasm.d.ts","gitHead":"f4a4796d4a2f2cdd29e0a521d9c196d93e169bd4","_npmUser":{"name":"mcdoolz","email":"apouriliaee@gmail.com"},"deprecated":"Security update: use v0.2.0. This version contained debug artifacts.","repository":{"url":"git+https://github.com/digitalforgeca/minerva-sdk.git","type":"git"},"_npmVersion":"11.11.0","description":"zkESG Compliance Engine - Privacy-preserving ZK-STARK proof system for ESG compliance","directories":{},"sideEffects":["./snippets/*"],"_nodeVersion":"25.8.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/minerva-sdk_0.1.0_1773539298840_0.8402211065152305","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@digitalforgestudios/minerva-sdk","version":"0.1.1","keywords":["zk-stark","esg","privacy","compliance","wasm","zero-knowledge"],"license":"SEE LICENSE IN LICENSE.md","_id":"@digitalforgestudios/minerva-sdk@0.1.1","maintainers":[{"name":"mcdoolz","email":"apouriliaee@gmail.com"}],"homepage":"https://zkesg.com/sdk","bugs":{"url":"https://github.com/digitalforgeca/minerva-sdk/issues"},"dist":{"shasum":"b9510df331fb731216bd6baca1d40f82f6c69c0f","tarball":"https://registry.npmjs.org/@digitalforgestudios/minerva-sdk/-/minerva-sdk-0.1.1.tgz","fileCount":6,"integrity":"sha512-SkvFNieUdV4mRKz816d0C3IVqDhjjx4HxFc8Wat991l9cRipkM/FY/bI0TNbwIqaGkhUuZvVoxXGVx55mFaghg==","signatures":[{"sig":"MEUCIE8PFcA1tWx+mXo0N4QGat+ulFM6lojTCo/Mo42Du+6RAiEAjxp87nLE7Y3NjbktxCRClg/X8RlCAoeCQZMx3b2GdqU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":874173},"main":"minerva_wasm.js","type":"module","types":"minerva_wasm.d.ts","gitHead":"f4a4796d4a2f2cdd29e0a521d9c196d93e169bd4","_npmUser":{"name":"mcdoolz","email":"apouriliaee@gmail.com"},"deprecated":"Security update: use v0.2.0. This version contained debug artifacts.","repository":{"url":"git+https://github.com/digitalforgeca/minerva-sdk.git","type":"git"},"_npmVersion":"11.11.0","description":"zkESG Compliance Engine - Privacy-preserving ZK-STARK proof system for ESG compliance","directories":{},"sideEffects":["./snippets/*"],"_nodeVersion":"25.8.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/minerva-sdk_0.1.1_1773539394200_0.19058730548987346","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@digitalforgestudios/minerva-sdk","version":"0.2.0","keywords":["zero-knowledge","zk-stark","zkp","proof","privacy","cryptography","wasm","minerva","esg","compliance","verification","winterfell"],"author":{"name":"Digital Forge Studios","email":"hello@dforge.ca"},"license":"MIT","_id":"@digitalforgestudios/minerva-sdk@0.2.0","maintainers":[{"name":"mcdoolz","email":"apouriliaee@gmail.com"}],"homepage":"https://zkesg.com/developers","bugs":{"url":"https://github.com/digitalforgeca/minerva-sdk/issues"},"dist":{"shasum":"88c5a2b8b8b8f90ffc19b08be5da8f6c4bd25c6a","tarball":"https://registry.npmjs.org/@digitalforgestudios/minerva-sdk/-/minerva-sdk-0.2.0.tgz","fileCount":7,"integrity":"sha512-iIWINtJTWBSuhNFxCS1weKjodh+ZLbGFtpsCc9obYHqer05fVGZlPm1cc7dFKTN2zVHm65bUbNh2XG8xRq/YwQ==","signatures":[{"sig":"MEUCIQDOcuSsoHpBqPm6RH3ErP5DXpBzCo+Zv7Ziui/fWm8thwIgF1fMU8vZr1myEHBekQRWfDX9IH+KBZZedJJqmR5uhMY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64354},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./circuits":{"types":"./dist/circuits/index.d.ts","import":"./dist/circuits/index.mjs","require":"./dist/circuits/index.js"},"./verifier":{"types":"./dist/verifier.d.ts","import":"./dist/verifier.mjs","require":"./dist/verifier.js"}},"gitHead":"d6384ac2540d8bf71e2bdef4d0191425705cd817","scripts":{"dev":"tsup src/index.ts --format cjs,esm --dts --watch","lint":"eslint src/","test":"vitest","build":"tsup src/index.ts --format cjs,esm --dts --clean","typecheck":"tsc --noEmit"},"_npmUser":{"name":"mcdoolz","email":"apouriliaee@gmail.com"},"deprecated":"License corrected in v0.2.2. Use latest.","repository":{"url":"git+https://github.com/digitalforgeca/minerva-sdk.git","type":"git"},"_npmVersion":"11.11.0","description":"TypeScript/JavaScript SDK for the Minerva ZK-STARK proof engine. Generate, verify, and share zero-knowledge proofs.","directories":{},"_nodeVersion":"25.8.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","eslint":"^9.0.0","vitest":"^2.0.0","typescript":"^5.4.0"},"_npmOperationalInternal":{"tmp":"tmp/minerva-sdk_0.2.0_1773964776849_0.022667735634276598","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@digitalforgestudios/minerva-sdk","version":"0.2.1","keywords":["zero-knowledge","zk-stark","zkp","proof","privacy","cryptography","wasm","minerva","esg","compliance","verification"],"author":{"name":"Digital Forge Studios","email":"hello@dforge.ca"},"license":"MIT","_id":"@digitalforgestudios/minerva-sdk@0.2.1","maintainers":[{"name":"mcdoolz","email":"apouriliaee@gmail.com"}],"homepage":"https://zkesg.com/developers","bugs":{"url":"https://github.com/digitalforgeca/minerva-sdk/issues"},"dist":{"shasum":"dac0001e6ff5a6ad5bd097d911b33295fc3faad5","tarball":"https://registry.npmjs.org/@digitalforgestudios/minerva-sdk/-/minerva-sdk-0.2.1.tgz","fileCount":7,"integrity":"sha512-eqwqg2XA7bL0RnHEWWPq4SyAv7NSvMu+jamtF/TkCLV7P30Re8EFTFLTrmcB6FPRXSIe02nE4ANVnVjOS/92xg==","signatures":[{"sig":"MEUCIQCIJtX0EFAsG3YDYPtNGbiF1q3Sqq67nyh0XWPcM0VwfQIgTphVTooY6x6Q5cF06vh2igtv6rBdfOx7g85sapNuToU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62206},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./circuits":{"types":"./dist/circuits/index.d.ts","import":"./dist/circuits/index.mjs","require":"./dist/circuits/index.js"},"./verifier":{"types":"./dist/verifier.d.ts","import":"./dist/verifier.mjs","require":"./dist/verifier.js"}},"gitHead":"0f5c0aeb69cb02d899ba4d3fef803f18dbf93ce1","scripts":{"dev":"tsup src/index.ts --format cjs,esm --dts --watch","lint":"eslint src/","test":"vitest","build":"tsup src/index.ts --format cjs,esm --dts --clean","typecheck":"tsc --noEmit"},"_npmUser":{"name":"mcdoolz","email":"apouriliaee@gmail.com"},"repository":{"url":"git+https://github.com/digitalforgeca/minerva-sdk.git","type":"git"},"_npmVersion":"11.11.0","description":"TypeScript/JavaScript SDK for the Minerva ZK-STARK proof platform. Circuit templates, proof verification, and Juno AI integration.","directories":{},"_nodeVersion":"25.8.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","eslint":"^9.0.0","vitest":"^2.0.0","typescript":"^5.4.0"},"_npmOperationalInternal":{"tmp":"tmp/minerva-sdk_0.2.1_1773966139306_0.7166616156398045","host":"s3://npm-registry-packages-npm-production"},"deprecated":"License corrected in v0.2.2. Use latest."},"0.2.2":{"name":"@digitalforgestudios/minerva-sdk","version":"0.2.2","keywords":["zero-knowledge","zk-stark","zkp","proof","privacy","cryptography","wasm","minerva","esg","compliance","verification"],"author":{"name":"Digital Forge Studios","email":"hello@dforge.ca"},"license":"SEE LICENSE IN LICENSE","_id":"@digitalforgestudios/minerva-sdk@0.2.2","maintainers":[{"name":"mcdoolz","email":"apouriliaee@gmail.com"}],"homepage":"https://zkesg.com/developers","bugs":{"url":"https://github.com/digitalforgeca/minerva-sdk/issues"},"dist":{"shasum":"02e0046ec9613a6ecf99d090f9ece5d76220bc13","tarball":"https://registry.npmjs.org/@digitalforgestudios/minerva-sdk/-/minerva-sdk-0.2.2.tgz","fileCount":3,"integrity":"sha512-Md4lw2ULk7pgBBxI63Q0sWlc81TuYKVT4r8rgXAHbRny3rI52GD94ljLKQqe2d2GdMpij9D7PCxK9ukypmrqNw==","signatures":[{"sig":"MEQCIBhPFnha2IHolpbEsWqLcQxEShKlrcelfWYbv5ykvgFTAiAgzSx8Eqv1JJnkw/GBj80lcl4cWZCOiBuit2WK6sDEYg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10623},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./circuits":{"types":"./dist/circuits/index.d.ts","import":"./dist/circuits/index.mjs","require":"./dist/circuits/index.js"},"./verifier":{"types":"./dist/verifier.d.ts","import":"./dist/verifier.mjs","require":"./dist/verifier.js"}},"gitHead":"b19e2118b744fbc1d02f23a1a7a78dd47522d6bf","scripts":{"dev":"tsup src/index.ts --format cjs,esm --dts --watch","lint":"eslint src/","test":"vitest","build":"tsup src/index.ts --format cjs,esm --dts --clean","typecheck":"tsc --noEmit"},"_npmUser":{"name":"mcdoolz","email":"apouriliaee@gmail.com"},"repository":{"url":"git+https://github.com/digitalforgeca/minerva-sdk.git","type":"git"},"_npmVersion":"11.11.0","description":"TypeScript/JavaScript SDK for the Minerva ZK-STARK proof platform. Circuit templates, proof verification, and Juno AI integration.","directories":{},"_nodeVersion":"25.8.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","eslint":"^9.0.0","vitest":"^2.0.0","typescript":"^5.4.0"},"_npmOperationalInternal":{"tmp":"tmp/minerva-sdk_0.2.2_1773968710290_0.9113692975187897","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-03-15T01:48:18.737Z","modified":"2026-03-20T01:06:11.994Z","0.1.0":"2026-03-15T01:48:19.069Z","0.1.1":"2026-03-15T01:49:54.386Z","0.2.0":"2026-03-19T23:59:36.996Z","0.2.1":"2026-03-20T00:22:19.471Z","0.2.2":"2026-03-20T01:05:10.428Z"},"bugs":{"url":"https://github.com/digitalforgeca/minerva-sdk/issues"},"author":{"name":"Digital Forge Studios","email":"hello@dforge.ca"},"license":"SEE LICENSE IN LICENSE","homepage":"https://zkesg.com/developers","keywords":["zero-knowledge","zk-stark","zkp","proof","privacy","cryptography","wasm","minerva","esg","compliance","verification"],"repository":{"url":"git+https://github.com/digitalforgeca/minerva-sdk.git","type":"git"},"description":"TypeScript/JavaScript SDK for the Minerva ZK-STARK proof platform. Circuit templates, proof verification, and Juno AI integration.","maintainers":[{"name":"mcdoolz","email":"apouriliaee@gmail.com"}],"readme":"# @digitalforgestudios/minerva-sdk\n\n> TypeScript/JavaScript SDK for the [Minerva ZK-STARK Proof Engine](https://zkesg.com)\n\nInteract with the Minerva platform from any JavaScript environment. The SDK provides typed access to circuit templates, proof generation, verification, and the Juno AI circuit design oracle.\n\n## Features\n\n- 📐 **MinervaFormat circuits** — Load from templates or build programmatically\n- ✅ **Proof verification** — Verify any Minerva proof structurally\n- 🤖 **Juno integration** — Generate circuits from natural language via the Juno API\n- 📤 **Export & share** — JSON and portable proof formats\n- 🏢 **Enterprise-ready** — TypeScript-first, tree-shakeable, zero runtime dependencies\n\n## Installation\n\n```bash\nnpm install @digitalforgestudios/minerva-sdk\n```\n\n## Quick Start\n\n```typescript\nimport { Minerva, circuits } from '@digitalforgestudios/minerva-sdk';\n\n// Connect to the Minerva platform\nconst minerva = new Minerva({ apiKey: 'mzk_your_key_here' });\n\n// Load a built-in circuit template\nconst circuit = circuits.ageVerification({\n  minimumAge: 18\n});\n\n// Generate a proof via the platform\nconst proof = await minerva.prove(circuit, {\n  public: { minimum_age: 18 },\n  private: { user_age: 25 }\n});\n\nconsole.log(proof.valid);      // true\nconsole.log(proof.hash);       // \"a1b2c3...\"\nconsole.log(proof.publicOnly); // { minimum_age: 18, result: true }\n\n// Verify a proof\nconst verified = await minerva.verify(proof);\nconsole.log(verified); // true\n```\n\n## Circuit Templates\n\nThe SDK ships with 10 production-ready circuit templates:\n\n| Template | Category | Description |\n|----------|----------|-------------|\n| `ageVerification` | Identity | Prove age meets minimum threshold |\n| `incomeThreshold` | Finance | Prove income exceeds requirement |\n| `creditRange` | Finance | Prove credit score within range |\n| `documentAuthenticity` | Legal | Prove document is authentic |\n| `balanceProof` | Finance | Prove account balances sum correctly |\n| `kycAttestation` | Identity | Prove KYC without re-sharing docs |\n| `supplyChain` | Logistics | Prove supplier certification |\n| `voteEligibility` | Governance | Prove voter eligibility |\n| `financialAudit` | Finance | Prove financial compliance |\n| `carbonCompliance` | ESG | Prove emissions below threshold |\n\n## Custom Circuits\n\nBuild circuits programmatically using MinervaFormat:\n\n```typescript\nimport { Minerva, Circuit } from '@digitalforgestudios/minerva-sdk';\n\nconst circuit: Circuit = {\n  version: '2.0',\n  meta: {\n    name: 'Salary Band Proof',\n    description: 'Prove salary falls within a band',\n    tags: ['hr', 'finance']\n  },\n  circuit: {\n    gates: [\n      { type: 'gt', left: 'salary', right: 'band_min' },\n      { type: 'gt', left: 'band_max', right: 'salary' }\n    ]\n  },\n  inputs: {\n    public: { band_min: 80000, band_max: 120000 },\n    private: { salary: 95000 }\n  }\n};\n\nconst minerva = new Minerva({ apiKey: 'mzk_your_key_here' });\nconst proof = await minerva.prove(circuit);\n```\n\n## Juno AI Circuit Generation\n\nGenerate circuits from natural language:\n\n```typescript\nimport { Juno } from '@digitalforgestudios/minerva-sdk';\n\nconst juno = new Juno({ apiKey: 'mzk_your_key_here' });\n\nconst circuit = await juno.design(\n  'Prove my company has fewer than 500 employees without revealing the exact count'\n);\n\nconsole.log(circuit.gates);\nconsole.log(circuit.inputs);\n```\n\n## MinervaFormat Specification\n\nAll circuits use the MinervaFormat JSON schema (v2.0):\n\n```json\n{\n  \"version\": \"2.0\",\n  \"meta\": {\n    \"name\": \"string\",\n    \"description\": \"string\",\n    \"author\": \"string\",\n    \"created_at\": \"ISO-8601\",\n    \"tags\": [\"string\"]\n  },\n  \"circuit\": {\n    \"gates\": [\n      {\n        \"type\": \"gt | lt | eq | add | mul | hash_eq\",\n        \"left\": \"input_name\",\n        \"right\": \"input_name\"\n      }\n    ]\n  },\n  \"inputs\": {\n    \"public\": { \"key\": \"value\" },\n    \"private\": { \"key\": \"value\" }\n  }\n}\n```\n\n### Gate Types\n\n| Gate | Operation | Description |\n|------|-----------|-------------|\n| `gt` | Greater than | `left > right` |\n| `lt` | Less than | `left < right` |\n| `eq` | Equals | `left == right` |\n| `add` | Addition | `left + right` |\n| `mul` | Multiplication | `left * right` |\n| `hash_eq` | Hash equality | `hash(left) == right` |\n\n## API Reference\n\n### `new Minerva(options)`\n\nConnect to the Minerva platform.\n\n```typescript\nconst minerva = new Minerva({\n  apiKey: string;      // Your Minerva API key (mzk_ prefix)\n  baseUrl?: string;    // API endpoint (default: https://zkesg.com/api)\n});\n```\n\n### `minerva.prove(circuit, inputs?)`\n\nGenerate a zero-knowledge proof.\n\n```typescript\nconst proof = await minerva.prove(circuit, {\n  public: { threshold: 100 },\n  private: { value: 42 }\n});\n// Returns: { valid, hash, proof, publicOnly, meta }\n```\n\n### `minerva.verify(proof)`\n\nVerify a proof.\n\n```typescript\nconst isValid = await minerva.verify(proof);\n// Returns: boolean\n```\n\n### `Juno(options)`\n\nConnect to the Juno AI circuit design oracle.\n\n```typescript\nconst juno = new Juno({\n  apiKey: string;      // Your Minerva API key\n  baseUrl?: string;    // API endpoint (default: https://zkesg.com/api)\n});\n```\n\n### `juno.design(prompt)`\n\nGenerate a circuit from natural language.\n\n```typescript\nconst circuit = await juno.design('Prove X without revealing Y');\n// Returns: Circuit (MinervaFormat)\n```\n\n## Standalone Verifier\n\nThe SDK includes a lightweight standalone verifier for structural proof validation. Anyone can check a Minerva proof — no authentication or account needed.\n\n```typescript\nimport { Verifier } from '@digitalforgestudios/minerva-sdk/verifier';\n\nconst verifier = new Verifier();\n\nconst result = await verifier.check(proofJsonString);\n\nconsole.log(result.valid);        // true\nconsole.log(result.status);       // \"verified\"\nconsole.log(result.circuit);      // \"Carbon Compliance\"\nconsole.log(result.publicInputs); // { threshold: 10000 }\nconsole.log(result.security);     // 128\nconsole.log(result.verifiedInMs); // 12\n\n// Simple boolean check\nconst ok = await verifier.isValid(proofJson);\n\n// Batch verification\nconst results = await verifier.checkBatch([proof1, proof2, proof3]);\n```\n\nFor full cryptographic verification, use the [Minerva platform API](https://zkesg.com/api/v1/proofs/verify) or the [web verifier](https://zkesg.com/verify).\n\n### CLI Verifier\n\nA standalone CLI verifier is available at [`digitalforgeca/minerva-verify`](https://github.com/digitalforgeca/minerva-verify):\n\n```bash\n# Verify a proof file\nminerva-verify proof.json\n# ✅ Verified: Carbon Compliance (128-bit security)\n```\n\n## Security\n\n- Private inputs are **never transmitted** to third parties during proof generation\n- No trusted setup required (STARK-based)\n- API keys use the `mzk_` prefix with argon2id storage\n\n## Requirements\n\n- **Node.js:** 18+\n- **Browser:** Chrome 89+, Firefox 89+, Safari 15+, Edge 89+\n\n## Links\n\n- 🌐 [Minerva Platform](https://zkesg.com)\n- 💬 [Juno AI Oracle](https://zkesg.com/chat)\n- 📐 [Circuit Templates](https://zkesg.com/templates)\n- 📖 [Guides](https://zkesg.com/guides)\n- 🏢 [Digital Forge Studios](https://dforge.ca)\n\n## License\n\nProprietary — see [LICENSE](./LICENSE)\n","readmeFilename":"README.md"}