Reference · Deterministic structures · mutation evidence

Schemas and test vectors

Validate exact installed v129 structures and deterministic fixtures before integrating transport, persistence, or presentation, while retaining exact historical V123 bytes.

Stable route
/reference/schemas-test-vectors
Version
129.0.0
Source SHA-256
1398345d50a11c320d4ba88b5ad5430d9e50b965a6c6e08fedbd8c50adaada45

Solved outcome

What this enables

Prove compatible parsing, canonical bytes, mutation rejection, and offline verification with reproducible vectors.

Installed identity

@receiz/sdk

Version
129.0.0
Package SHA-256
53337aab33882e945d4243802b8013e3af523644a329c71a64f669a6360c8629
Record source
generated/sdk-testing-reference.json

Exact form

Signature or request

import { createReceizEmulator } from '@receiz/sdk/testing'

Inputs

Inputs and constraints

  1. A deterministic seed and clock.
  2. Canonical fixture bytes or a declared schema instance.
  3. One bounded mutation per rejection test.

Outputs

Output and receipt

  1. sandboxVerified emulator result
  2. Deterministic snapshot
  3. Stable mutation failure

Stable recovery

Failures

ARTIFACT_TAMPERED

Reject the mutated bytes; never normalize them into acceptance.

node_modules/@receiz/sdk/dist/artifactAdmissionTypes.d.ts · 4215ae5bc262f95a7a7b6f8620b2ce3d66ecdbbb386659453320e3919555ed93

Offline

Offline behavior

Fixtures, schemas, emulator state, and artifact verification run locally. Emulator evidence is sandbox evidence, never production verification.

Authority

Truth boundary

Begin with exact held artifact bytes and local verification. SDK, HTTP, MCP, AI, framework, server, session, and UI mechanics may transport, coordinate, inspect, or distribute beneath the sealed Receiz proof object. They do not become proof authority.

The enclosing sealed Receiz proof object and its exact bytes are the stronger source of truth.Record Moment and Seal File are independent local operations after one-time anonymous Signature V4 device enrollment. Neither requires an account or server signer. Identity and account continuity remain optional projections beneath public verification.

Permanent anchor · #schemas-test-vectors-schema-inventory

Schema inventory

Import the installed testing entry point and use the schema and fixture exports named by the installed package. Validate the enclosing artifact before any domain schema projection.

Permanent anchor · #schemas-test-vectors-canonical-bytes

Canonical bytes

Keep fixture bytes byte-for-byte. Hash the exact sealed artifact, compare its artifact digest, then extract payload bytes only after enclosing-artifact verification succeeds.

Permanent anchor · #schemas-test-vectors-test-vectors

Test vectors

Run positive current-native, verified legacy-read, one-byte mutation, payload substitution, owner substitution, claim substitution, verify-path substitution, and exact-byte round-trip vectors.

Permanent anchor · #schemas-test-vectors-mutation-table

Mutation table

Apply one bounded mutation per vector and require deterministic rejection. Do not normalize, repack, recompress, or repair mutated bytes into acceptance.

Permanent anchor · #schemas-test-vectors-emulator

Emulator

createReceizEmulator supplies deterministic seed, clock, snapshot, and sandboxVerified behavior for local tests. Emulator evidence remains sandbox evidence and does not claim production verification.

Permanent anchor · #schemas-test-vectors-end-to-end-example

End-to-end example

Run the held-artifact Verify path against deterministic exact bytes before mutation cases. Test authenticated issuance separately, retain its returned artifact, and require the same local verifier and artifact-digest equality before admitting its receipt.

Copyable path

Authenticated SDK issuance → Verify → inspect receipt

import { createReceizClient } from "@receiz/sdk";

// Begin with the complete proof object already held by the person or runtime.
const encoded = process.env.RECEIZ_ARTIFACT_BASE64;
if (!encoded) throw new Error("RECEIZ_ARTIFACT_BASE64 is required");
const artifactBytes = Uint8Array.from(Buffer.from(encoded, "base64"));

// Local verification is account-free and precedes every transport projection.
const receiz = createReceizClient();
const verification = await receiz.verification.verifyArtifact(artifactBytes);
if (verification.status !== "verified-artifact") {
  throw new Error(`Artifact verification status: ${verification.status}`);
}
console.log(verification.status);

Deterministic check

Conformance

pnpm sdk:test

Run from the Receiz repository against the exact coordinated package identity. A command result is evidence beneath sealed artifact truth.