Package Exports
- @uvrn/core
- @uvrn/core/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@uvrn/core) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@uvrn/core
UVRN Delta Engine core — deterministic multi-source comparison and verification. Runs the Delta formula on bundles, produces canonical receipts with SHA-256 hashes, and validates or verifies bundles and receipts.
Install
npm install @uvrn/coreOr with pnpm:
pnpm add @uvrn/coreUsage
- Define a bundle: a claim, a threshold, and at least two data specs with metrics.
- Call
runDeltaEngine(bundle)to get a receipt (outcome, delta, hash). - Use
validateBundleandverifyReceiptfor validation and integrity checks.
import { runDeltaEngine, validateBundle, verifyReceipt } from '@uvrn/core';
const bundle = {
bundleId: 'example-001',
claim: 'Metrics from source-a and source-b should agree within 10%.',
thresholdPct: 0.10,
dataSpecs: [
{
id: 'source-a',
label: 'Source A',
sourceKind: 'report',
originDocIds: ['doc-a-1'],
metrics: [{ key: 'count', value: 100 }],
},
{
id: 'source-b',
label: 'Source B',
sourceKind: 'report',
originDocIds: ['doc-b-1'],
metrics: [{ key: 'count', value: 105 }],
},
],
};
const receipt = runDeltaEngine(bundle);
console.log(receipt.outcome); // 'consensus' | 'indeterminate'
console.log(receipt.deltaFinal); // max delta across metrics
console.log(receipt.hash); // SHA-256 of canonical receiptUse cases
- Compare two or more data sources — Run the Delta formula on metrics (e.g. report A vs report B) and get a deterministic consensus or indeterminate outcome.
- Produce verifiable receipts — Every receipt has a canonical hash; use
verifyReceipt(receipt)to recompute and check integrity. - Validate before running — Use
validateBundle(bundle)to check structure and threshold without executing the engine. - Integrate into pipelines — Use as a library in CI, ETL, or any service that needs deterministic comparison and proof.
Links
Open source: Source code and issues: GitHub (uvrn-packages). Project landing: UVRN.
- Repository — monorepo (this package:
uvrn-core) - @uvrn/sdk — programmatic client (CLI/HTTP/local) built on this core
- @uvrn/cli — run the engine from the command line