@uvrn/adapter 1.0.2 → 1.0.3

package/README.md

@@ -2,6 +2,8 @@
 
 UVRN DRVC3 envelope adapter — wraps Delta Engine receipts in DRVC3 envelopes with EIP-191 signatures. Use this when you need to attach issuer identity and signing to core receipts without changing their deterministic hash.
 
+**Disclaimer:** UVRN is in Alpha testing. The engine measures whether your sources agree with each other — not whether they’re correct. Final trust of output rests with the user. Use at your own risk. Have fun.
+
 ## Install
 
 ```bash

package/dist/src/index.d.ts

@@ -5,4 +5,4 @@
 export * from './types';
 export { wrapInDRVC3, extractDeltaReceipt } from './wrapper';
 export { signHash, recoverSigner, verifySignature } from './signer';
-export { validateDRVC3, isDRVC3Receipt } from './validator';
+export { validateDRVC3, isDRVC3Receipt, verifyDRVC3Integrity } from './validator';

package/dist/src/index.js

@@ -18,7 +18,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDRVC3Receipt = exports.validateDRVC3 = exports.verifySignature = exports.recoverSigner = exports.signHash = exports.extractDeltaReceipt = exports.wrapInDRVC3 = void 0;
+exports.verifyDRVC3Integrity = exports.isDRVC3Receipt = exports.validateDRVC3 = exports.verifySignature = exports.recoverSigner = exports.signHash = exports.extractDeltaReceipt = exports.wrapInDRVC3 = void 0;
 // Types
 __exportStar(require("./types"), exports);
 // Core wrapper
@@ -30,7 +30,8 @@ var signer_1 = require("./signer");
 Object.defineProperty(exports, "signHash", { enumerable: true, get: function () { return signer_1.signHash; } });
 Object.defineProperty(exports, "recoverSigner", { enumerable: true, get: function () { return signer_1.recoverSigner; } });
 Object.defineProperty(exports, "verifySignature", { enumerable: true, get: function () { return signer_1.verifySignature; } });
-// Validation
+// Validation (validateDRVC3 is schema-only; use verifyDRVC3Integrity for full integrity)
 var validator_1 = require("./validator");
 Object.defineProperty(exports, "validateDRVC3", { enumerable: true, get: function () { return validator_1.validateDRVC3; } });
 Object.defineProperty(exports, "isDRVC3Receipt", { enumerable: true, get: function () { return validator_1.isDRVC3Receipt; } });
+Object.defineProperty(exports, "verifyDRVC3Integrity", { enumerable: true, get: function () { return validator_1.verifyDRVC3Integrity; } });

package/dist/src/validator.d.ts

@@ -1,17 +1,34 @@
 /**
- * DRVC3 Schema Validator
- * Uses ajv to validate DRVC3 receipts against the official schema
+ * DRVC3 Schema Validator and Integrity Verification
+ * - validateDRVC3: schema-only (structure); does not verify signatures or embedded receipt hash.
+ * - verifyDRVC3Integrity: full integrity check (schema + signature + core receipt hash).
  */
 import { DRVC3ValidationResult } from './types';
 /**
- * Validates a DRVC3 receipt against the official schema
+ * Validates a DRVC3 receipt against the official schema only.
+ * Does not verify cryptographic signature or embedded receipt hash.
+ * For full integrity check, use verifyDRVC3Integrity().
+ *
  * @param receipt - The receipt object to validate
  * @returns Validation result with errors if invalid
  */
 export declare function validateDRVC3(receipt: unknown): DRVC3ValidationResult;
 /**
- * Type guard to check if an object is a valid DRVC3 receipt
+ * Type guard to check if an object is a valid DRVC3 receipt (schema-only).
  * @param obj - Object to check
  * @returns True if the object is a valid DRVC3 receipt
  */
 export declare function isDRVC3Receipt(obj: unknown): boolean;
+/**
+ * Full integrity verification: schema, EIP-191 signature, and embedded receipt hash.
+ * Use this before trusting envelope contents; extractDeltaReceipt is safe after this passes.
+ *
+ * @param drvc3 - DRVC3 envelope to verify
+ * @returns Object with verified: true, or verified: false and error message
+ */
+export declare function verifyDRVC3Integrity(drvc3: unknown): {
+    verified: true;
+} | {
+    verified: false;
+    error: string;
+};

package/dist/src/validator.js

@@ -1,7 +1,8 @@
 "use strict";
 /**
- * DRVC3 Schema Validator
- * Uses ajv to validate DRVC3 receipts against the official schema
+ * DRVC3 Schema Validator and Integrity Verification
+ * - validateDRVC3: schema-only (structure); does not verify signatures or embedded receipt hash.
+ * - verifyDRVC3Integrity: full integrity check (schema + signature + core receipt hash).
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -42,9 +43,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateDRVC3 = validateDRVC3;
 exports.isDRVC3Receipt = isDRVC3Receipt;
+exports.verifyDRVC3Integrity = verifyDRVC3Integrity;
+const core_1 = require("@uvrn/core");
 const ajv_1 = __importDefault(require("ajv"));
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
+const signer_1 = require("./signer");
+const wrapper_1 = require("./wrapper");
 // Load schema from file
 const schemaPath = path.join(__dirname, '../schemas/drvc3.schema.json');
 const drvc3Schema = JSON.parse(fs.readFileSync(schemaPath, 'utf-8'));
@@ -57,7 +62,10 @@ addFormats(ajv);
 // Compile the schema once
 const validateSchema = ajv.compile(drvc3Schema);
 /**
- * Validates a DRVC3 receipt against the official schema
+ * Validates a DRVC3 receipt against the official schema only.
+ * Does not verify cryptographic signature or embedded receipt hash.
+ * For full integrity check, use verifyDRVC3Integrity().
+ *
  * @param receipt - The receipt object to validate
  * @returns Validation result with errors if invalid
  */
@@ -73,10 +81,38 @@ function validateDRVC3(receipt) {
     return { valid: false, errors };
 }
 /**
- * Type guard to check if an object is a valid DRVC3 receipt
+ * Type guard to check if an object is a valid DRVC3 receipt (schema-only).
  * @param obj - Object to check
  * @returns True if the object is a valid DRVC3 receipt
  */
 function isDRVC3Receipt(obj) {
     return validateDRVC3(obj).valid;
 }
+/**
+ * Full integrity verification: schema, EIP-191 signature, and embedded receipt hash.
+ * Use this before trusting envelope contents; extractDeltaReceipt is safe after this passes.
+ *
+ * @param drvc3 - DRVC3 envelope to verify
+ * @returns Object with verified: true, or verified: false and error message
+ */
+function verifyDRVC3Integrity(drvc3) {
+    const schemaResult = validateDRVC3(drvc3);
+    if (!schemaResult.valid) {
+        return { verified: false, error: schemaResult.errors?.join('; ') ?? 'Schema validation failed' };
+    }
+    const envelope = drvc3;
+    const { integrity, validation } = envelope;
+    if (!validation?.checks?.delta_receipt) {
+        return { verified: false, error: 'Missing validation.checks.delta_receipt' };
+    }
+    const receipt = (0, wrapper_1.extractDeltaReceipt)(envelope);
+    const coreResult = (0, core_1.verifyReceipt)(receipt);
+    if (!coreResult.verified) {
+        return { verified: false, error: `Embedded receipt: ${coreResult.error}` };
+    }
+    const sigOk = (0, signer_1.verifySignature)(integrity.hash, integrity.signature, integrity.signer_address);
+    if (!sigOk) {
+        return { verified: false, error: 'Signature verification failed' };
+    }
+    return { verified: true };
+}

package/dist/src/wrapper.d.ts

@@ -33,9 +33,10 @@ import { DRVC3Receipt, WrapOptions } from './types';
  */
 export declare function wrapInDRVC3(deltaReceipt: DeltaReceipt, signer: Wallet | HDNodeWallet, options: WrapOptions): Promise<DRVC3Receipt>;
 /**
- * Extracts the original DeltaReceipt from a DRVC3 envelope
+ * Extracts the original DeltaReceipt from a DRVC3 envelope.
+ * Does not verify signature or receipt hash; for untrusted input use verifyDRVC3Integrity() first, then extract.
  *
- * @param drvc3 - DRVC3 receipt envelope
+ * @param drvc3 - DRVC3 receipt envelope (must have validation.checks.delta_receipt)
  * @returns The embedded DeltaReceipt
  */
 export declare function extractDeltaReceipt(drvc3: DRVC3Receipt): DeltaReceipt;

package/dist/src/wrapper.js

@@ -10,6 +10,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wrapInDRVC3 = wrapInDRVC3;
 exports.extractDeltaReceipt = extractDeltaReceipt;
+const core_1 = require("@uvrn/core");
 const signer_1 = require("./signer");
 /**
  * Wraps a DeltaReceipt in a DRVC3 envelope
@@ -34,14 +35,19 @@ const signer_1 = require("./signer");
  * ```
  */
 async function wrapInDRVC3(deltaReceipt, signer, options) {
-    // 1. Generate receipt_id (ENVELOPE METADATA - non-deterministic, intentional)
+    // 1. Verify receipt integrity before attesting (do not sign tampered payloads)
+    const coreVerify = (0, core_1.verifyReceipt)(deltaReceipt);
+    if (!coreVerify.verified) {
+        throw new Error(`Cannot wrap invalid receipt: ${coreVerify.error}`);
+    }
+    // 2. Generate receipt_id (ENVELOPE METADATA - non-deterministic, intentional)
     const timestamp = new Date().toISOString();
     const receipt_id = `drvc3-${deltaReceipt.bundleId}-${Date.now()}`;
-    // 2. Read hash from DeltaReceipt (HASH DOMAIN - read-only from Layer 1)
+    // 3. Read hash from DeltaReceipt (HASH DOMAIN - read-only from Layer 1)
     const hash = deltaReceipt.hash;
-    // 3. Sign hash with EIP-191 (ENVELOPE METADATA - certifies "who" and "when")
+    // 4. Sign hash with EIP-191 (ENVELOPE METADATA - certifies "who" and "when")
     const signature = await (0, signer_1.signHash)(hash, signer);
-    // 4. Construct DRVC3 envelope
+    // 5. Construct DRVC3 envelope
     const drvc3 = {
         receipt_id,
         issuer: options.issuer,
@@ -82,9 +88,10 @@ async function wrapInDRVC3(deltaReceipt, signer, options) {
     return drvc3;
 }
 /**
- * Extracts the original DeltaReceipt from a DRVC3 envelope
+ * Extracts the original DeltaReceipt from a DRVC3 envelope.
+ * Does not verify signature or receipt hash; for untrusted input use verifyDRVC3Integrity() first, then extract.
  *
- * @param drvc3 - DRVC3 receipt envelope
+ * @param drvc3 - DRVC3 receipt envelope (must have validation.checks.delta_receipt)
  * @returns The embedded DeltaReceipt
  */
 function extractDeltaReceipt(drvc3) {

package/dist/tests/wrapper.test.js

@@ -5,31 +5,25 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
+const core_1 = require("@uvrn/core");
 const wrapper_1 = require("../src/wrapper");
 const validator_1 = require("../src/validator");
 const signer_1 = require("../src/signer");
 describe('DRVC3 Wrapper', () => {
-    // Mock DeltaReceipt (as would come from Layer 1)
-    const mockDeltaReceipt = {
-        bundleId: 'test-bundle-001',
-        deltaFinal: 0.05,
-        sources: ['Source A', 'Source B'],
-        rounds: [
-            {
-                round: 1,
-                deltasByMetric: { revenue: 0.05, users: 0.0 },
-                withinThreshold: true,
-                witnessRequired: false
-            }
-        ],
-        suggestedFixes: [],
-        outcome: 'consensus',
-        hash: 'a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2'
-    };
+    let mockDeltaReceipt;
     let testWallet;
     beforeAll(() => {
-        // Create a deterministic wallet for testing
         testWallet = ethers_1.Wallet.createRandom();
+        const bundle = {
+            bundleId: 'test-bundle-001',
+            claim: 'Test claim',
+            dataSpecs: [
+                { id: 's1', label: 'Source A', sourceKind: 'report', originDocIds: [], metrics: [{ key: 'k', value: 10 }] },
+                { id: 's2', label: 'Source B', sourceKind: 'report', originDocIds: [], metrics: [{ key: 'k', value: 10.5 }] }
+            ],
+            thresholdPct: 0.1
+        };
+        mockDeltaReceipt = (0, core_1.runDeltaEngine)(bundle);
     });
     it('should wrap DeltaReceipt in valid DRVC3 envelope', async () => {
         const drvc3 = await (0, wrapper_1.wrapInDRVC3)(mockDeltaReceipt, testWallet, {
@@ -42,7 +36,7 @@ describe('DRVC3 Wrapper', () => {
         expect(drvc3.event).toBe('delta-reconciliation');
         expect(drvc3.timestamp).toBeDefined();
         expect(drvc3.block_state).toBe('loose');
-        expect(drvc3.certificate).toBe('DRVC3 v1.0');
+        expect(drvc3.certificate).toBe('DRVC3 v1.01');
         // Check integrity block
         expect(drvc3.integrity.hash_algorithm).toBe('sha256');
         expect(drvc3.integrity.hash).toBe(mockDeltaReceipt.hash);
@@ -91,6 +85,8 @@ describe('DRVC3 Wrapper', () => {
             event: 'test'
         });
         const extracted = (0, wrapper_1.extractDeltaReceipt)(drvc3);
-        expect(extracted).toEqual(mockDeltaReceipt);
+        expect(extracted.bundleId).toBe(mockDeltaReceipt.bundleId);
+        expect(extracted.hash).toBe(mockDeltaReceipt.hash);
+        expect(extracted.outcome).toBe(mockDeltaReceipt.outcome);
     });
 });

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@uvrn/adapter",
-  "version": "1.0.2",
+  "version": "1.0.3",
+  "publishConfig": {
+    "access": "public"
+  },
   "description": "UVRN DRVC3 envelope adapter — wraps core receipts with EIP-191 signatures",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +24,7 @@
     "ethers": "^6.0.0",
     "ajv": "^8.12.0",
     "ajv-formats": "^2.1.1",
-    "@uvrn/core": "1.0.2"
+    "@uvrn/core": "^1.0.3"
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",
@@ -33,6 +36,10 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "jest",

package/jest.config.js

@@ -1,12 +0,0 @@
-/** @type {import('ts-jest').JestConfigWithTsJest} */
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  testMatch: ['**/tests/**/*.test.ts'],
-  moduleFileExtensions: ['ts', 'js', 'json'],
-  collectCoverageFrom: ['src/**/*.ts'],
-  moduleNameMapper: {
-    '^@uvrn/core$': '<rootDir>/../uvrn-core/src'
-  }
-};
-

package/schemas/drvc3.schema.json

@@ -1,115 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://uvrn.org/schemas/drvc3.v1.01.json",
-  "title": "DRVC3 Receipt v1.01",
-  "description": "DRVC3 envelope with Layer 2 extensions support. Backward-compatible with v1.0.",
-  "type": "object",
-  "required": [
-    "receipt_id",
-    "issuer",
-    "event",
-    "timestamp",
-    "integrity",
-    "block_state",
-    "certificate"
-  ],
-  "properties": {
-    "receipt_id": {
-      "type": "string"
-    },
-    "issuer": {
-      "type": "string"
-    },
-    "event": {
-      "type": "string"
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time"
-    },
-    "description": {
-      "type": "string"
-    },
-    "resource": {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string"
-        },
-        "url": {
-          "type": "string"
-        },
-        "branch": {
-          "type": "string"
-        },
-        "commit_hash": {
-          "type": "string"
-        }
-      }
-    },
-    "integrity": {
-      "type": "object",
-      "required": [
-        "hash_algorithm",
-        "hash",
-        "signature_method",
-        "signature",
-        "signer_address"
-      ],
-      "properties": {
-        "hash_algorithm": {
-          "enum": [
-            "sha256"
-          ]
-        },
-        "hash": {
-          "type": "string"
-        },
-        "signature_method": {
-          "enum": [
-            "eip191"
-          ]
-        },
-        "signature": {
-          "type": "string"
-        },
-        "signer_address": {
-          "type": "string"
-        }
-      }
-    },
-    "validation": {
-      "type": "object",
-      "properties": {
-        "v_score": {
-          "type": "number"
-        },
-        "checks": {
-          "type": "object"
-        }
-      }
-    },
-    "block_state": {
-      "enum": [
-        "loose",
-        "blocked"
-      ]
-    },
-    "certificate": {
-      "type": "string"
-    },
-    "replay_instructions": {
-      "type": "object"
-    },
-    "tags": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "extensions": {
-      "type": "object",
-      "description": "Layer 2 provenance data — source URLs, timestamps, evidence links, domain metadata. Not covered by L1 integrity hash."
-    }
-  }
-}

package/src/index.ts

@@ -1,16 +0,0 @@
-/**
- * Loosechain UVRN Adapter
- * Layer 2 - Wraps Delta Engine Core receipts in DRVC3 envelopes
- */
-
-// Types
-export * from './types';
-
-// Core wrapper
-export { wrapInDRVC3, extractDeltaReceipt } from './wrapper';
-
-// Signing utilities
-export { signHash, recoverSigner, verifySignature } from './signer';
-
-// Validation
-export { validateDRVC3, isDRVC3Receipt } from './validator';

package/src/signer.ts

@@ -1,47 +0,0 @@
-/**
- * EIP-191 Signing Utilities
- * Provides Ethereum personal message signing for DRVC3 receipts
- */
-
-import { Wallet, HDNodeWallet, verifyMessage } from 'ethers';
-
-/**
- * Signs a hash using EIP-191 (Ethereum Signed Message)
- * @param hash - The hex string hash to sign
- * @param wallet - ethers Wallet instance with private key
- * @returns Promise resolving to the signature hex string
- */
-export async function signHash(hash: string, wallet: Wallet | HDNodeWallet): Promise<string> {
-  // signMessage automatically prefixes with "\x19Ethereum Signed Message:\n" + message length
-  return wallet.signMessage(hash);
-}
-
-/**
- * Recovers the signer address from a hash and signature
- * @param hash - The original hash that was signed
- * @param signature - The EIP-191 signature
- * @returns The signer's Ethereum address
- */
-export function recoverSigner(hash: string, signature: string): string {
-  return verifyMessage(hash, signature);
-}
-
-/**
- * Verifies that a signature was created by the expected signer
- * @param hash - The original hash that was signed
- * @param signature - The EIP-191 signature
- * @param expectedAddress - The expected signer address
- * @returns True if the signature is valid and matches the expected address
- */
-export function verifySignature(
-  hash: string,
-  signature: string,
-  expectedAddress: string
-): boolean {
-  try {
-    const recoveredAddress = recoverSigner(hash, signature);
-    return recoveredAddress.toLowerCase() === expectedAddress.toLowerCase();
-  } catch {
-    return false;
-  }
-}

package/src/types.ts

@@ -1,102 +0,0 @@
-/**
- * DRVC3 Types for UVRN Adapter (v1.01)
- * Layer 2 envelope types that wrap Layer 1 DeltaReceipt
- *
- * v1.01 adds the `extensions` field for Layer 2 provenance data.
- */
-
-import { DeltaReceipt } from '@uvrn/core';
-
-/**
- * DRVC3 Integrity block - contains hash and signature data
- */
-export interface DRVC3Integrity {
-  hash_algorithm: 'sha256';
-  hash: string;
-  signature_method: 'eip191';
-  signature: string;
-  signer_address: string;
-}
-
-/**
- * DRVC3 Validation block - contains score and embedded checks
- */
-export interface DRVC3Validation {
-  v_score: number;
-  checks: {
-    delta_receipt: DeltaReceipt;
-    [key: string]: unknown;
-  };
-}
-
-/**
- * DRVC3 Resource block (optional) - describes the verified resource
- */
-export interface DRVC3Resource {
-  type?: string;
-  url?: string;
-  branch?: string;
-  commit_hash?: string;
-}
-
-/**
- * Block state - "loose" means mutable/portable, "blocked" means canonized/permanent
- */
-export type BlockState = 'loose' | 'blocked';
-
-/**
- * Full DRVC3 Receipt Envelope
- * Wraps Layer 1 DeltaReceipt with protocol metadata and signatures
- */
-export interface DRVC3Receipt {
-  receipt_id: string;
-  issuer: string;
-  event: string;
-  timestamp: string;
-  description?: string;
-  resource?: DRVC3Resource;
-  integrity: DRVC3Integrity;
-  validation: DRVC3Validation;
-  block_state: BlockState;
-  certificate: string;
-  replay_instructions?: Record<string, unknown>;
-  tags?: string[];
-  /**
-   * Layer 2 extension data — provenance, evidence, domain-specific metadata.
-   * This field is NOT covered by the L1 integrity hash. It is envelope metadata
-   * owned by the consumer chain (e.g., MarketChain source URLs, evidence links).
-   */
-  extensions?: Record<string, unknown>;
-}
-
-/**
- * Options for wrapping a DeltaReceipt in DRVC3 envelope
- */
-export interface WrapOptions {
-  /** Issuer identifier (e.g., "uvrn", "app.example.com") */
-  issuer: string;
-  /** Event type (e.g., "delta-reconciliation") */
-  event: string;
-  /** Block state - defaults to "loose" */
-  blockState?: BlockState;
-  /** DRVC3 certificate version - defaults to "DRVC3 v1.0" */
-  certificate?: string;
-  /** Optional description */
-  description?: string;
-  /** Optional resource metadata */
-  resource?: DRVC3Resource;
-  /** Optional replay instructions */
-  replayInstructions?: Record<string, unknown>;
-  /** Optional tags (e.g., ["#uvrn", "#receipt"]) */
-  tags?: string[];
-  /** Optional Layer 2 extension data (provenance, evidence, domain metadata) */
-  extensions?: Record<string, unknown>;
-}
-
-/**
- * Validation result from schema validation
- */
-export interface DRVC3ValidationResult {
-  valid: boolean;
-  errors?: string[];
-}

package/src/validator.ts

@@ -1,53 +0,0 @@
-/**
- * DRVC3 Schema Validator
- * Uses ajv to validate DRVC3 receipts against the official schema
- */
-
-import Ajv from 'ajv';
-import * as path from 'path';
-import * as fs from 'fs';
-import { DRVC3ValidationResult } from './types';
-
-// Load schema from file
-const schemaPath = path.join(__dirname, '../schemas/drvc3.schema.json');
-const drvc3Schema = JSON.parse(fs.readFileSync(schemaPath, 'utf-8'));
-
-// Initialize Ajv with JSON Schema 2020-12 support
-const ajv = new Ajv({ strict: false });
-
-// Add formats support (date-time, etc.)
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const addFormats = require('ajv-formats');
-addFormats(ajv);
-
-// Compile the schema once
-const validateSchema = ajv.compile(drvc3Schema);
-
-/**
- * Validates a DRVC3 receipt against the official schema
- * @param receipt - The receipt object to validate
- * @returns Validation result with errors if invalid
- */
-export function validateDRVC3(receipt: unknown): DRVC3ValidationResult {
-  const valid = validateSchema(receipt);
-  
-  if (valid) {
-    return { valid: true };
-  }
-  
-  const errors = validateSchema.errors?.map(err => {
-    const path = err.instancePath || '/';
-    return `${path}: ${err.message}`;
-  }) || ['Unknown validation error'];
-  
-  return { valid: false, errors };
-}
-
-/**
- * Type guard to check if an object is a valid DRVC3 receipt
- * @param obj - Object to check
- * @returns True if the object is a valid DRVC3 receipt
- */
-export function isDRVC3Receipt(obj: unknown): boolean {
-  return validateDRVC3(obj).valid;
-}

package/src/wrapper.ts

@@ -1,103 +0,0 @@
-/**
- * DRVC3 Wrapper
- * Wraps Layer 1 DeltaReceipt in a DRVC3 envelope with EIP-191 signatures
- * 
- * Key Principle: The DeltaReceipt hash is READ-ONLY from Layer 1.
- * DRVC3 envelope fields (receipt_id, timestamp, signature) are envelope metadata
- * and do NOT affect determinism or replay.
- */
-
-import { DeltaReceipt } from '@uvrn/core';
-import { Wallet, HDNodeWallet, Signer } from 'ethers';
-import { DRVC3Receipt, WrapOptions } from './types';
-import { signHash } from './signer';
-
-/**
- * Wraps a DeltaReceipt in a DRVC3 envelope
- * 
- * @param deltaReceipt - Layer 1 DeltaReceipt (deterministic, hash-covered)
- * @param signer - ethers Wallet for EIP-191 signing
- * @param options - Envelope options (issuer, event, etc.)
- * @returns Promise resolving to complete DRVC3 receipt
- * 
- * @example
- * ```typescript
- * import { runDeltaEngine } from '@uvrn/core';
- * import { wrapInDRVC3 } from '@uvrn/adapter';
- * import { Wallet } from 'ethers';
- * 
- * const deltaReceipt = runDeltaEngine(bundle);
- * const wallet = new Wallet(privateKey);
- * const drvc3 = await wrapInDRVC3(deltaReceipt, wallet, {
- *   issuer: 'uvrn',
- *   event: 'delta-reconciliation'
- * });
- * ```
- */
-export async function wrapInDRVC3(
-  deltaReceipt: DeltaReceipt,
-  signer: Wallet | HDNodeWallet,
-  options: WrapOptions
-): Promise<DRVC3Receipt> {
-  // 1. Generate receipt_id (ENVELOPE METADATA - non-deterministic, intentional)
-  const timestamp = new Date().toISOString();
-  const receipt_id = `drvc3-${deltaReceipt.bundleId}-${Date.now()}`;
-
-  // 2. Read hash from DeltaReceipt (HASH DOMAIN - read-only from Layer 1)
-  const hash = deltaReceipt.hash;
-
-  // 3. Sign hash with EIP-191 (ENVELOPE METADATA - certifies "who" and "when")
-  const signature = await signHash(hash, signer);
-
-  // 4. Construct DRVC3 envelope
-  const drvc3: DRVC3Receipt = {
-    receipt_id,
-    issuer: options.issuer,
-    event: options.event,
-    timestamp,
-    integrity: {
-      hash_algorithm: 'sha256',
-      hash,
-      signature_method: 'eip191',
-      signature,
-      signer_address: signer.address
-    },
-    validation: {
-      v_score: deltaReceipt.deltaFinal,
-      checks: {
-        delta_receipt: deltaReceipt
-      }
-    },
-    block_state: options.blockState || 'loose',
-    certificate: options.certificate || 'DRVC3 v1.01'
-  };
-
-  // Add optional fields if provided
-  if (options.description) {
-    drvc3.description = options.description;
-  }
-  if (options.resource) {
-    drvc3.resource = options.resource;
-  }
-  if (options.replayInstructions) {
-    drvc3.replay_instructions = options.replayInstructions;
-  }
-  if (options.extensions) {
-    drvc3.extensions = options.extensions;
-  }
-  if (options.tags) {
-    drvc3.tags = options.tags;
-  }
-
-  return drvc3;
-}
-
-/**
- * Extracts the original DeltaReceipt from a DRVC3 envelope
- * 
- * @param drvc3 - DRVC3 receipt envelope
- * @returns The embedded DeltaReceipt
- */
-export function extractDeltaReceipt(drvc3: DRVC3Receipt): DeltaReceipt {
-  return drvc3.validation.checks.delta_receipt;
-}

package/tests/integration.test.ts

@@ -1,123 +0,0 @@
-/**
- * Integration Tests
- * Tests the full flow from DeltaBundle → DeltaReceipt → DRVC3Receipt
- */
-
-import { Wallet, HDNodeWallet } from 'ethers';
-import { 
-  runDeltaEngine, 
-  verifyReceipt,
-  DeltaBundle 
-} from '@uvrn/core';
-import { wrapInDRVC3, extractDeltaReceipt, validateDRVC3 } from '../src';
-
-describe('Integration: Layer 1 → Layer 2', () => {
-  let testWallet: HDNodeWallet;
-
-  beforeAll(() => {
-    testWallet = Wallet.createRandom();
-  });
-
-  it('should complete full flow: bundle → receipt → DRVC3', async () => {
-    // 1. Create a DeltaBundle (input to Layer 1)
-    const bundle: DeltaBundle = {
-      bundleId: 'integration-test-001',
-      claim: 'Integration Test',
-      thresholdPct: 0.1,
-      dataSpecs: [
-        {
-          id: 'source-1',
-          label: 'Source 1',
-          sourceKind: 'metric',
-          originDocIds: ['doc-1'],
-          metrics: [
-            { key: 'revenue', value: 1000 },
-            { key: 'users', value: 500 }
-          ]
-        },
-        {
-          id: 'source-2',
-          label: 'Source 2',
-          sourceKind: 'metric',
-          originDocIds: ['doc-2'],
-          metrics: [
-            { key: 'revenue', value: 1050 },
-            { key: 'users', value: 510 }
-          ]
-        }
-      ]
-    };
-
-    // 2. Run Layer 1 Engine
-    const deltaReceipt = runDeltaEngine(bundle);
-
-    // Verify Layer 1 receipt
-    const verifyResult = verifyReceipt(deltaReceipt);
-    expect(verifyResult.verified).toBe(true);
-
-    // 3. Wrap in DRVC3 (Layer 2)
-    const drvc3 = await wrapInDRVC3(deltaReceipt, testWallet, {
-      issuer: 'uvrn-integration',
-      event: 'delta-reconciliation',
-      tags: ['#uvrn', '#integration-test']
-    });
-
-    // 4. Validate DRVC3 schema
-    const schemaResult = validateDRVC3(drvc3);
-    expect(schemaResult.valid).toBe(true);
-
-    // 5. Verify hash chain integrity
-    expect(drvc3.integrity.hash).toBe(deltaReceipt.hash);
-
-    // 6. Extract and verify embedded receipt
-    const extracted = extractDeltaReceipt(drvc3);
-    expect(extracted.hash).toBe(deltaReceipt.hash);
-    expect(verifyReceipt(extracted).verified).toBe(true);
-  });
-
-  it('should maintain hash integrity through Layer 2 wrapping', async () => {
-    const bundle: DeltaBundle = {
-      bundleId: 'hash-integrity-test',
-      claim: 'Hash Test',
-      thresholdPct: 0.05,
-      dataSpecs: [
-        {
-          id: 'a',
-          label: 'A',
-          sourceKind: 'metric',
-          originDocIds: [],
-          metrics: [{ key: 'val', value: 100 }]
-        },
-        {
-          id: 'b',
-          label: 'B',
-          sourceKind: 'metric',
-          originDocIds: [],
-          metrics: [{ key: 'val', value: 100 }]
-        }
-      ]
-    };
-
-    const receipt = runDeltaEngine(bundle);
-    const originalHash = receipt.hash;
-
-    // Wrap multiple times - hash should always match
-    const drvc3_1 = await wrapInDRVC3(receipt, testWallet, {
-      issuer: 'test',
-      event: 'test'
-    });
-
-    const drvc3_2 = await wrapInDRVC3(receipt, testWallet, {
-      issuer: 'test',
-      event: 'test'
-    });
-
-    // Envelope metadata differs (receipt_id, timestamp)
-    expect(drvc3_1.receipt_id).not.toBe(drvc3_2.receipt_id);
-    expect(drvc3_1.timestamp).not.toBe(drvc3_2.timestamp);
-
-    // But hash domain remains identical
-    expect(drvc3_1.integrity.hash).toBe(originalHash);
-    expect(drvc3_2.integrity.hash).toBe(originalHash);
-  });
-});

package/tests/wrapper.test.ts

@@ -1,115 +0,0 @@
-/**
- * DRVC3 Wrapper Tests
- * Tests the wrapInDRVC3 function and schema validation
- */
-
-import { Wallet, HDNodeWallet } from 'ethers';
-import { wrapInDRVC3, extractDeltaReceipt } from '../src/wrapper';
-import { validateDRVC3 } from '../src/validator';
-import { recoverSigner } from '../src/signer';
-import { DeltaReceipt } from '@uvrn/core';
-
-describe('DRVC3 Wrapper', () => {
-  // Mock DeltaReceipt (as would come from Layer 1)
-  const mockDeltaReceipt: DeltaReceipt = {
-    bundleId: 'test-bundle-001',
-    deltaFinal: 0.05,
-    sources: ['Source A', 'Source B'],
-    rounds: [
-      {
-        round: 1,
-        deltasByMetric: { revenue: 0.05, users: 0.0 },
-        withinThreshold: true,
-        witnessRequired: false
-      }
-    ],
-    suggestedFixes: [],
-    outcome: 'consensus',
-    hash: 'a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2'
-  };
-
-  let testWallet: HDNodeWallet;
-
-  beforeAll(() => {
-    // Create a deterministic wallet for testing
-    testWallet = Wallet.createRandom();
-  });
-
-  it('should wrap DeltaReceipt in valid DRVC3 envelope', async () => {
-    const drvc3 = await wrapInDRVC3(mockDeltaReceipt, testWallet, {
-      issuer: 'uvrn-test',
-      event: 'delta-reconciliation'
-    });
-
-    // Check required fields
-    expect(drvc3.receipt_id).toMatch(/^drvc3-test-bundle-001-\d+$/);
-    expect(drvc3.issuer).toBe('uvrn-test');
-    expect(drvc3.event).toBe('delta-reconciliation');
-    expect(drvc3.timestamp).toBeDefined();
-    expect(drvc3.block_state).toBe('loose');
-    expect(drvc3.certificate).toBe('DRVC3 v1.0');
-
-    // Check integrity block
-    expect(drvc3.integrity.hash_algorithm).toBe('sha256');
-    expect(drvc3.integrity.hash).toBe(mockDeltaReceipt.hash);
-    expect(drvc3.integrity.signature_method).toBe('eip191');
-    expect(drvc3.integrity.signature).toBeDefined();
-    expect(drvc3.integrity.signer_address).toBe(testWallet.address);
-
-    // Check validation block
-    expect(drvc3.validation.v_score).toBe(mockDeltaReceipt.deltaFinal);
-    expect(drvc3.validation.checks.delta_receipt).toEqual(mockDeltaReceipt);
-  });
-
-  it('should produce schema-valid DRVC3 receipt', async () => {
-    const drvc3 = await wrapInDRVC3(mockDeltaReceipt, testWallet, {
-      issuer: 'uvrn',
-      event: 'test'
-    });
-
-    const result = validateDRVC3(drvc3);
-    expect(result.valid).toBe(true);
-    expect(result.errors).toBeUndefined();
-  });
-
-  it('should include optional fields when provided', async () => {
-    const drvc3 = await wrapInDRVC3(mockDeltaReceipt, testWallet, {
-      issuer: 'uvrn',
-      event: 'delta-reconciliation',
-      blockState: 'blocked',
-      certificate: 'DRVC3 v1.1',
-      description: 'Test receipt',
-      tags: ['#uvrn', '#receipt', '#test']
-    });
-
-    expect(drvc3.block_state).toBe('blocked');
-    expect(drvc3.certificate).toBe('DRVC3 v1.1');
-    expect(drvc3.description).toBe('Test receipt');
-    expect(drvc3.tags).toEqual(['#uvrn', '#receipt', '#test']);
-  });
-
-  it('should create verifiable signature', async () => {
-    const drvc3 = await wrapInDRVC3(mockDeltaReceipt, testWallet, {
-      issuer: 'uvrn',
-      event: 'test'
-    });
-
-    // Recover signer from signature
-    const recoveredAddress = recoverSigner(
-      drvc3.integrity.hash,
-      drvc3.integrity.signature
-    );
-
-    expect(recoveredAddress.toLowerCase()).toBe(testWallet.address.toLowerCase());
-  });
-
-  it('should extract original DeltaReceipt from envelope', async () => {
-    const drvc3 = await wrapInDRVC3(mockDeltaReceipt, testWallet, {
-      issuer: 'uvrn',
-      event: 'test'
-    });
-
-    const extracted = extractDeltaReceipt(drvc3);
-    expect(extracted).toEqual(mockDeltaReceipt);
-  });
-});

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "lib": ["ES2020"],
-    "declaration": true,
-    "strict": true,
-    "noImplicitAny": true,
-    "strictNullChecks": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "moduleResolution": "node",
-    "resolveJsonModule": true,
-    "outDir": "./dist",
-    "rootDir": ".",
-    "baseUrl": "."
-  },
-  "include": ["src/**/*", "tests/**/*"],
-  "exclude": ["node_modules", "dist"]
-}