Before you write code
Open a Discussion describing:- Who the check is for (a person, an app, or an agent).
- What it proves (identity, ownership, permission, safety).
- Inputs the integrator supplies. No PII. Deterministic for identical inputs.
- Outcome the user sees (verified, processing, failed) and what it unlocks at a gate.
What a new check needs
Conformance
A public check must:- Return deterministic outputs for identical inputs.
- Carry no PII in inputs or outputs.
- Document external API usage with rate limits and error handling.
- Note gas or performance considerations if it anchors on-chain.
Submitting a PR
- Add the input JSON Schema at
verifiers/schemas/<id>.json. - Add the catalog entry to
verifiers/VERIFIERS.jsonwithtier: "public", the schema path, flow, interaction, and API flags. - Add a guide page at
verification/<id>.mdxand link it fromverification/verifiers.mdx. - Update
openapi/public-api.jsonexamples if the request or response shape changed. - Add a
[Unreleased]entry inCHANGELOG.mddescribing what builders will see.
What not to include
- No wallet addresses or private env names.
- No outcomes the live API does not return. Confirm from running code or tests before documenting a result.
- No second catalog.
verifiers/VERIFIERS.jsonis the public index.
Related
Verifier catalog
Current public checks.
Verifier schemas
Request shapes.
Signing format
How a request is signed.
Discussions
Propose before you code.