Conformance & certification

Certification, decided by a machine

“SIGNET Certified” means an implementation passed the public, machine-runnable conformance suite — nothing subjective, identical for every implementer. The same suite that grades a submission is published for anyone to re-run.

Conformance is determined solely by a machine-runnable test suite, versioned with the Canonical Data Model. Two levels exist — Core (the wire contract plus event and provenance integrity) and Full (Core plus interoperability mapping and behavioural semantics). The suite reports pass, fail, or not-applicable per requirement and computes the highest level fully satisfied. There is no rounding up.

The normative levels and the suite live in conformance/ of concerthq/signet-standard at v0.12.0. This page renders directly from them.

Levels

Core and Full

Generated from the normative conformance/levels.md.

Specification v0.1 (Working Draft) Steward: Concert Foundation Tier: Normative Licence: Apache-2.0 (suite) · CC0-1.0 (this document)

This document defines what it means for a document or an implementation to conform to the SIGNET standard, the conformance levels, and the neutrality rules that govern certification. It is the companion to the SIGNET Canonical Data Model specification (CDM §13 Conformance) and the Concert IP & Licensing Policy.

The accompanying machine-runnable suite (conformance/) tests every requirement below. A claim of conformance is only meaningful when accompanied by a passing report from that suite (report-schema.json).


1. Conformance targets

Two things can conform:

  • A document — a single CDM instance (an Invoice, a Decision, …). Document conformance is purely structural (CDM §13.1).
  • An implementation — a system that reads, writes, and changes CDM documents. Implementation conformance additionally covers behaviour: round-trip fidelity, mapping fidelity, and event/provenance integrity (CDM §13.2).

Only implementations are certified. Document conformance is a building block of implementation conformance.


2. Conformance levels

2.1 SIGNET Core v0.1

The floor. An implementation is Core-conformant if it satisfies every MUST in:

  • C-DOC — Document conformance. Every document it emits validates against the published JSON Schema for its declared version, and it rejects documents that do not (CDM §13.1). Tested by: positive fixtures must validate; negative fixtures must be rejected.
  • C-EVT — Event & audit integrity (Layer 3). Every material change produces an append-only Event carrying Provenance; Events hash-chain via previousEventHash so tampering is evident (CDM §1.7, §7.1, §7.2). Tested by: a valid chain verifies; a tampered chain is detected.
  • C-PROV — Provenance presence. Every Decision and every Event carries a provenance object identifying what generated the assertion and when (CDM §6.4, §7.2). Tested by: provenance presence and shape checks.

Core corresponds to Layer 1 (Wire Contract) + Layer 3 (Event & Audit) of the SIGNET architecture.

2.2 SIGNET Full v1.0

Core, plus:

  • F-MAP — Interoperability mapping fidelity (Layer 4). The implementation performs the normative §8 standards mappings without loss of mapped fields. For v0.1 the tested mapping is Invoice → Peppol BIS Billing 3.0 (EN 16931): the projection must preserve every mapped Business Term and the monetary totals must reconcile (CDM §8, §13.2(b)). Tested by: the mapping-conformance cases.
  • F-SEM — Behavioural semantics (Layer 2). Policy objects carry both an executable expression and a humanReadable statement; Mandates bound agent actions; Decisions reference the inputs and policies they applied (CDM §6.3–6.5, §13.2). Tested by: the semantics cases.

Full corresponds to Core + Layer 2 (Behavioural Semantics) + Layer 4 (Interoperability).

2.3 Reporting

The suite reports, per requirement, pass | fail | not-applicable, and computes the highest level fully satisfied: Full, Core, or none. A partial result (e.g. Core met, Full partially met) is reported honestly as Core with the failing Full requirements listed. There is no rounding up.


3. Certification neutrality rules (CN)

These rules are the operational expression of the governance firewall in the IP & Licensing Policy. They bind Concert as the certifier.

  • CN-1 — Machine-runnable. Conformance is determined solely by the machine-runnable suite. No subjective assessment, interview, or discretionary judgement contributes to a pass/fail. If the suite cannot decide a requirement, that requirement is not part of certification.
  • CN-2 — Identical suite. Every implementer is assessed against the byte-for- byte identical suite at a given version. There is no bespoke, relaxed, or extended suite for any party.
  • CN-3 — No preferential path. No implementer — including Score Networks — receives early access to the suite, pre-graded fixtures, a privileged certification route, or any advantage in the process. The suite is public.
  • CN-4 — Reproducible & publishable. A conformance result is reproducible by any third party from the published suite and the implementation's adapter, and the result report is publishable. Certification records which suite version and which CDM version were used.

A certification that cannot cite a passing, reproducible suite report under these rules is invalid.


4. Versioning

The suite is versioned with the CDM. A certification is always qualified by both versions, e.g. "SIGNET Full — CDM v0.1, suite v0.1". A new CDM major version requires re-certification; minor/patch suite updates that only add or clarify tests do not invalidate existing certifications but may be required at renewal.

The governance firewall, operationalised

How certification stays neutral

Four neutrality rules bind Concert as the certifier. They are the operational face of the governance firewall: no implementer — including Score Networks — gets a bespoke suite, a preferential path, or a private assessment.

CN-1

Machine-runnable

Conformance is determined solely by the machine-runnable suite. No subjective assessment, interview, or discretionary judgement contributes to a pass/fail. If the suite cannot decide a requirement, that requirement is not part of certification.

CN-2

Identical suite

Every implementer is assessed against the byte-for- byte identical suite at a given version. There is no bespoke, relaxed, or extended suite for any party.

CN-3

No preferential path

No implementer — including Score Networks — receives early access to the suite, pre-graded fixtures, a privileged certification route, or any advantage in the process. The suite is public.

CN-4

Reproducible & publishable

A conformance result is reproducible by any third party from the published suite and the implementation's adapter, and the result report is publishable. Certification records which suite version and which CDM version were used.

Reproducible proof

The suite discriminates

The same harness run against two adapters. The reference implementation reaches Full; a deliberately broken implementation reaches none — failing exactly at event-chain integrity (C-EVT) and mapping fidelity (F-MAP). Anyone can reproduce this from the published suite.

Reference implementation
reference-adapter.js
Level achievedFull
C-DOCCore · CDM 13.1
pass
C-EVTCore · CDM 1.7,7.1
pass
C-PROVCore · CDM 6.4,7.2
pass
F-MAPFull · CDM 8,13.2(b)
pass
F-SEMFull · CDM 6.3-6.5
pass
Broken implementation
broken-adapter.js
Level achievednone
C-DOCCore · CDM 13.1
pass
C-EVTCore · CDM 1.7,7.1
fail
C-PROVCore · CDM 6.4,7.2
pass
F-MAPFull · CDM 8,13.2(b)
fail
F-SEMFull · CDM 6.3-6.5
pass

The process

Self-test, submit, reproduce, issue

Generated from conformance/certification.md — identical for every implementer.

Steward: Concert Foundation · Tier: Process · Licence: CC0-1.0

Certification turns a passing conformance result into the right to use the "SIGNET Certified" mark. This document describes the process. It is governed by the neutrality rules (CN-1…CN-4) in levels.md and the Concert IP & Licensing Policy. The process is identical for every implementer, including Score Networks.


1. What certification asserts

"SIGNET Certified — Core" or "— Full" asserts that, against a stated CDM version and suite version, the implementation produced a passing conformance report at that level from the public, machine-runnable suite. It asserts nothing more: it is not an endorsement, a security audit, or a guarantee of fitness.

2. The process

  1. Self-test. The implementer writes a conformance adapter for their system (see adapter/adapter-contract.md) and runs the public suite:
    node conformance/runner/run-conformance.js --adapter <their-adapter>
    
    This produces a report conforming to report-schema.json.
  2. Submit. The implementer sends Concert the report, the adapter source, and the suite + CDM versions used. Because the suite is public and the result is reproducible (CN-4), no private assessment is needed.
  3. Reproduce. Concert re-runs the identical suite against the submitted adapter and confirms the report. The check is mechanical (CN-1).
  4. Issue. On a confirmed pass, Concert records the certification (implementer, level, CDM version, suite version, date, report hash) in the public registry and licenses the "SIGNET Certified" mark for that level and version.
  5. Publish. The report is publishable; the registry entry is public.

There is no committee judgement, interview, or discretionary gate at any step.

3. Marks and their use

  • The mark is SIGNET Certified — <Level> and MUST always be qualified by the CDM and suite versions in any formal claim (e.g. "SIGNET Certified — Full (CDM v0.1, suite v0.1)").
  • The mark licence is granted under the IP & Licensing Policy, on identical terms to all implementers, and is conditional on a current passing report.
  • Misuse — claiming a level not achieved, or omitting the version qualification in a way that misleads — is grounds for withdrawal of the mark licence.

4. Renewal and versioning

  • A certification is valid for its stated CDM + suite versions.
  • A new CDM major version requires re-certification.
  • A suite minor/patch update (added or clarified tests) does not invalidate an existing certification immediately, but the current suite applies at renewal.
  • Concert publishes the current versions and a deprecation window for superseded ones.

5. Fees and neutrality

Certification may carry a fee that funds Concert's neutral stewardship. The fee is published, identical for all implementers at a given level, and unrelated to the outcome (you pay to be assessed, not to pass). No implementer — including Score Networks — receives a discount, a fast track, or any other preference (CN-3). Fees are the Foundation's primary sustaining revenue, by design, so that the standard itself can remain free.

6. Disputes

Because conformance is mechanical and reproducible, a dispute is resolved by re-running the public suite. If an implementer believes a test is wrong (rather than their implementation), they raise it through the normal standard change-control process; the suite is corrected for everyone or not at all (CN-2).

Concert

The first GUILD. The first SIGNET.

Concert is building the open infrastructure layer for a new era of governed, intelligent, multi-party commerce. Join the founding consortium.

Get in touch