TATTVA तत्त्व

The YAKMESH TATTVA System is the cryptographic foundation of network identity and verified truth. Every node runs provably-correct code that independently arrives at the same essential truth.

import { deriveNetworkName, deriveNetworkId } from './oracle/index.js';

// For human-readable names
const name = deriveNetworkName(hash, 3);  // "qubit-lattice-prism"

// For short identifiers  
const id = deriveNetworkId(hash);  // "pq-a7x9"

// For verification phrases
const phrase = deriveVerificationPhrase(hash);  // "quantum tiger mesa echo"

Quick Start

Create a fully configured oracle system for your YAKMESH node:

import { createOracleSystem } from './oracle/index.js';

const system = createOracleSystem(nodeIdentity, options);

// Returns:
// {
//   oracle,           // ValidationOracle instance
//   codeProof,        // CodeProofProtocol instance
//   consensus,        // ConsensusEngine instance
//   validate,         // (type, content) => ValidationResult
//   submit,           // (type, content, metadata) => SubmissionResult
//   generateChallenge,// (peerId) => Challenge
//   verifyPeer,       // (proof) => boolean
//   getStats,         // () => { oracle, consensus, codeProof }
// }

// Validate content
const result = system.validate('listing', contentData);

// Submit to consensus
const submission = system.submit('qcoa', certData, { signature, pubkey });

// Challenge a peer
const challenge = system.generateChallenge(peerId);

// Verify peer proof
const verified = system.verifyPeer(peerProof);

Core Exports

The oracle system exports these core components from oracle/index.js:

Ternary ValidationResult v2.8.0

As of v2.8.0, TATTVA's ValidationResult uses balanced ternary internally, mapping naturally to VALID (+1), INVALID (−1), and PENDING (0). This enables mathematical consensus via TRIBHUJ operations.

import { ValidationResult, toTrit, fromTrit } from './oracle/validation-oracle-hardened.js';
import { Trit } from './oracle/tribhuj.js';

// Convert to trit for mathematical operations
const result = oracle.validateListing(data);
const trit = toTrit(result);  // → Trit.POS, Trit.NEG, or Trit.ZERO

// Ternary consensus across multiple validations
import { ternaryConsensus } from './oracle/tribhuj.js';
const multiResults = [result1, result2, result3].map(toTrit);
const consensusTrit = ternaryConsensus(multiResults);

// Convert back to ValidationResult
const consensusResult = fromTrit(consensusTrit);  // → VALID, INVALID, or PENDING

Oracle Modules

The oracle system is composed of specialized modules, each handling a critical aspect of distributed trust.

import { getOracle, contentHash, ValidationResult } from './oracle/index.js';

const oracle = getOracle();
const result = oracle.validateListing(listingData);
const hash = contentHash(content);  // SHA3-256 content address

import { CodeProofProtocol, ProofState } from './oracle/index.js';

const codeProof = new CodeProofProtocol(nodeIdentity);
const challenge = codeProof.generateChallenge(peerId);
// ProofState: PENDING, VERIFIED, FAILED, TIMEOUT

import { ConsensusEngine, ContentState } from './oracle/index.js';

const consensus = new ConsensusEngine(nodeIdentity, { minAttestations: 1 });
const result = consensus.submitContent('listing', content, metadata);
// ContentState: PENDING, VALIDATED, CONSENSUS, REJECTED, CONFLICT

import { ModuleSealer, SealedModule } from './oracle/index.js';

const sealer = new ModuleSealer();
const sealed = sealer.sealModule(sourceCode);
const isValid = sealed.verifySealIntegrity();

import { 
  deriveNetworkName, 
  deriveNetworkId, 
  deriveVerificationPhrase,
  QUANTUM_WORDLIST 
} from './oracle/index.js';

deriveNetworkName(hash, 3);  // "qubit-lattice-prism"
deriveNetworkId(hash);        // "pq-a7x9"
deriveVerificationPhrase(hash); // "quantum tiger mesa echo"

import { 
  createGenesisNetwork,    // v1: Direct hash
  createGenesisNetworkV2   // v2: iO obfuscated
} from './oracle/index.js';

const network = createGenesisNetwork(oracleHash);
const compatible = network.isCompatible(peerHash);
network.registerPeer(peerId, peerHash);

import { lockCodebase, unlockCodebase, setupUnlockOnExit } from './oracle/index.js';

// Lock all source files
const lockResult = lockCodebase();
console.log(`Locked ${lockResult.fileCount} files`);

// Unlock on exit
setupUnlockOnExit();

// Manual unlock
unlockCodebase();

Oracle Directory Files

Security Properties

Where to Use iO

QUANTUM_WORDLIST

The identity system uses a 256-word quantum/crypto themed wordlist curated for uniqueness, pronounceability, and thematic consistency. Categories include: