Truth, Locked at the
Moment of Creation

// Physics gate — called before every HCS submission
// maxKwh is set by Spine at gateway commissioning
// The edge notary cannot change its own ceiling.
function physicsCheck(kwh, maxKwh) {
  if (!Number.isFinite(kwh) || kwh < 0)
    return { ok: false, reason: "kwh_not_finite_or_negative" };

  if (kwh > maxKwh)
    return { ok: false, reason: "kwh_exceeds_reasonable_threshold" };

  return { ok: true };
}

// Physics limit derived from gateway commissioning record:
// physicsLimitKwh = capacityMW × 1000 × intervalHours
// For 1MW station, ~12-min interval: 1.0 × 1000 × 0.2 = 200 kWh
// A reading of 500 kWh → rejected. Forever. No exceptions.

// Frozen — runtime mutation is impossible
const SCHEMAS = Object.freeze({

  TELEMETRY: {
    version:  '2.0',
    // Fields that MUST be present
    required: ['type', 'sensorRef', 'gatewayRef',
               'licenseeRef', 'kwh', 'ts', 'meta'],
    // Fields that MUST NOT be present — injection guards
    forbidden: ['interpretation', 'value',
                'accumulated', 'passport',
                'tokenId', 'nftSerial']
  },

  MINT_EVENT: {
    version:  '2.0',
    required: ['type', 'claimId', 'licenseeRef',
               'tokenType', 'tokenId', 'proof',
               'passport', 'ts', 'meta'],
    forbidden: ['balance', 'accumulated', 'mutable']
  }

  // ... 6 more schema types
});

function validateSchema(payload) {
  if (!payload || typeof payload !== 'object')
    throw new Error('SCHEMA VIOLATION: Payload must be a non-null object.');

  const schema = SCHEMAS[payload.type];
  if (!schema)
    throw new Error(
      `SCHEMA FROZEN: Unknown message type "${payload.type}".`
    );

  // Enforce required fields
  for (const field of schema.required) {
    if (!(field in payload))
      throw new Error(
        `SCHEMA LOCK VIOLATION: Missing "${field}" in ${payload.type}.`
      );
  }

  // Reject forbidden fields (injection guard)
  for (const field of schema.forbidden) {
    if (field in payload)
      throw new Error(
        `SCHEMA LOCK VIOLATION: Forbidden field "${field}" detected. Mutation attempt blocked.`
      );
  }

  return true;
}

function buildDigitalPassport(opts) {
  return {
    asset_identity: {
      issuer:          opts.issuer,
      registration_no: opts.registrationNo,
      asset_class:     opts.type,       // REC | H2O | CO2
      pc_mu_id:        opts.claimId
    },
    technical_telemetry: {
      sensor_did:        opts.sensorDid,
      measurement_value: opts.measurementValue,
      measurement_unit:  opts.measurementUnit,
      gef:               0.9908          // Mauritius baseline
    },
    proof: {
      verification_method: 'Hedera Consensus Service',
      topic_id:            opts.proofTopicId,
      seq_from:            opts.proofSeqFrom,  // first TELEMETRY
      seq_to:              opts.proofSeqTo     // last TELEMETRY
    },
    regulatory: {
      iso_standard:    'ISO 14064-1:2018',
      eu_qualification:'EU-CBAM-COMPLIANT',
      us_standard:     'US-GAAP Scope 2'
    }
  };
}