Skip to content

Tailored-Tools/rapidtools-validate-reference

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

RapidTools Validate

Deterministic JSON validation with cryptographically signed attestation records.

Schema in, attestation out, trust attached.

The Problem

  • Validation logic drifts between services
  • Retries produce duplicate side effects or inconsistent results
  • Audit logs lack cryptographic proof
  • No way to independently verify a validation actually happened
  • Schema enforcement behaves differently depending on which service runs it

Why Deterministic Validation Matters

When multiple services validate the same data, they should produce the same result. When that result needs to be auditable, it should be signed. When a retry happens, it should be safe.

RapidTools Validate produces a single deterministic, signed result for any schema-payload pair. The result is idempotent, auditable, and independently verifiable.

Use Cases

  • Prevent schema drift across microservices
  • Generate verifiable audit trails for API validation
  • Ensure deterministic validation in AI pipelines
  • Replace ad-hoc JSON validation logic

How It Works

Send a JSON Schema and payload. Receive a signed attestation record.

curl -X POST https://validate.rapidtools.dev/v1/validate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-123-v1" \
  -d '{
    "schema": {
      "type": "object",
      "required": ["name", "age"],
      "properties": {
        "name": { "type": "string" },
        "age": { "type": "integer", "minimum": 0 }
      }
    },
    "payload": { "name": "James", "age": 36 }
  }'

Response:

{
  "attestation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "valid": true,
  "errors": [],
  "schema_hash": "3f2a1bcd...",
  "payload_hash": "7c9e5d3a...",
  "timestamp": "2026-02-08T12:00:00.000Z",
  "signature": "d4e5f6a7..."
}

Every response includes:

  • Deterministic hashes of the schema and payload
  • HMAC-SHA256 signature for independent verification
  • Idempotency support for safe retries

Stability Guarantees

  • Deterministic responses for identical inputs
  • Append-only attestation records
  • Backwards-compatible API changes only
  • Explicit versioning and deprecation policy

Links

Built On

Cloudflare Workers + D1. No frameworks, no bloat.

About

Deterministic JSON validation with cryptographically signed attestation records. Schema in, attestation out, trust attached.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors