KYE™ State Library™ · v1

Open-source state machines for every regulated industry.

Every regulated entity — a loan, a claim, a prescription, a drug batch, an AI system — has a lifecycle that regulators expect you to be able to evidence. The KYE™ State Library™ publishes those lifecycles as signed, versioned, machine-readable state machines. Adopt one for your tenant, tighten it where you must, replay it in audit.

One protocol, every sector: the State Library™

Demo data

You learn: Which regulated lifecycle KYE™ already models for your sector, and what each state obliges you to evidence. You can: Switch sectors, pick a lifecycle, play it.

AI Inference Run Lifecycle NIST-AI-RMF-MEASURE · EU-AI-Act-Art-14 · EU-AI-Act-Art-15 · ISO-IEC-42001 · Apache-2.0

Lifecycle of a single (or batched) AI inference run with drift + safety controls. Aligned with NIST AI RMF MEASURE function and EU AI Act Art 14 (human oversight).

  1. Queued

    Inference request queued.

    • Capture input provenance + prompt envelope.
  2. Executing

    Model execution in progress.

    • Capture model id, version, inputs hash.
  3. Quarantined

    Output withheld pending human review.

    • Hand off to human reviewer.
  4. Completed

    Output delivered; logged for audit.

    • Persist output + safety classifier result.
  5. Drift flagged

    Drift / OOD detected; under review.

    • Record drift signal + window.
  6. Replayed

    Replayed on a corrected model / inputs.

    • Link to original run.
9 transitions
  • queued executing · Execute
  • queued quarantined · Hold output
  • executing completed · Deliver output
  • executing drift_flagged · Queue review
  • executing quarantined · Hold output
  • drift_flagged completed · Release output
  • drift_flagged quarantined · Hold output
  • quarantined replayed · Re execute
  • completed replayed · Re execute

Corporate Credit Facility Lifecycle Basel-III-CRR · EBA-GL-LOM-2020-06 · IFRS-9 · FCA-SYSC-7 · Apache-2.0

Lifecycle for a corporate revolving / term credit facility. Covers proposal, underwriting, activation, drawdown, repayment, and exit paths including default and renegotiation. References Basel III…

  1. Proposed

    Facility term sheet drafted with borrower.

    • Capture indicative term sheet + pricing.
  2. Underwriting

    Credit committee underwriting in progress.

    • Compile credit memo with IFRS 9 staging.
    • Independent collateral valuation if secured.
  3. Active

    Facility live; commitment fee accruing on undrawn portion.

    • Monitor financial covenants quarterly.
  4. Drawn

    Facility partially or fully drawn.

    • Accrue interest + monitor LTV.
  5. Repaid

    Facility fully repaid + closed.

  6. Renegotiated

    Facility amended / restated.

    • Capture amendment + restatement docs.
  7. Defaulted

    Covenant breach or payment default; recovery handed off.

    • Issue event-of-default notice + accelerate.
11 transitions
  • proposed underwriting · Open credit case
  • underwriting active · Activate facility
  • underwriting proposed · Return to borrower
  • active drawn · Release funds
  • drawn active · Repay to undrawn
  • drawn repaid · Close facility
  • active repaid · Close facility
  • drawn defaulted · Accelerate
  • active renegotiated · Execute amendment
  • drawn renegotiated · Execute amendment
  • renegotiated drawn · Resume servicing

Smart Meter Reading Lifecycle UK-SMETS2 · EU-Clean-Energy-Package-2019 · Elexon-BSC · Ofgem-SLC-21D · Apache-2.0

Lifecycle of a smart meter reading from acquisition through billing settlement. Aligned with UK SMETS2, EU Clean Energy Package, and Elexon BSC.

  1. Pending

    Reading captured at meter.

    • Capture reading with timestamp + interval.
  2. Validated

    VEE (validation/estimation/editing) passed.

    • Apply industry VEE rules.
  3. Disputed

    Consumer disputed reading.

    • Capture dispute + resolution path.
  4. Billed

    Reading consumed by billing engine.

    • Link reading to invoice line.
  5. Settled

    Dispute / billing settled.

8 transitions
  • pending validated · Mark validated
  • pending disputed · Open dispute
  • validated billed · Emit invoice line
  • validated disputed · Open dispute
  • billed disputed · Open dispute
  • billed settled · Close reading
  • disputed settled · Close dispute
  • disputed validated · Restore reading

Patient Consent Lifecycle (HIPAA / GDPR Art 9) HIPAA-45-CFR-164.508 · GDPR-Art-9 · GDPR-Art-7 · NHS-IG-Toolkit · Apache-2.0

Lifecycle of a patient consent record for processing of special-category health data. Aligned with HIPAA authorisation requirements and GDPR Art 9(2)(a) explicit consent.

  1. Requested

    Consent request issued to patient.

    • Issue consent form with purpose, retention, recipients.
  2. Granted

    Patient granted consent.

    • Capture granular scope (purposes, parties, retention).
    • Maintain easy revocation route.
  3. Expired

    Consent expired per stated term.

  4. Withdrawn

    Patient withdrew consent.

    • Cease processing + propagate revocation.
4 transitions
  • requested granted · Activate consent
  • requested expired · Close request
  • granted withdrawn · Propagate revocation
  • granted expired · Close consent

Insurance Claim Lifecycle FCA-ICOBS-8 · EIOPA-BoS-21-260 · Solvency-II-Art-44 · GDPR-Art-22 · Apache-2.0

End-to-end insurance claim from FNOL through adjudication and payout. Covers triage, investigation, fraud detection, payment, and litigation pathways. Aligned with FCA ICOBS and EIOPA conduct…

  1. Reported

    First Notification of Loss (FNOL) received.

    • Capture FNOL with date, peril, policy ref.
  2. Triage

    Coverage + initial fraud screen.

    • Verify coverage in force at loss date.
    • Run anti-fraud scoring.
  3. Investigation

    Loss adjuster / SIU investigation.

    • Field adjuster report.
    • Photos, statements, police reports.
  4. Denied

    Claim denied; reason + appeal rights communicated.

    • Document denial reason + appeal route.
  5. Fraud flagged

    Fraud confirmed; referred to law enforcement / IFB.

  6. Adjudicated

    Claim decision recorded.

    • Issue ICOBS-compliant decision letter.
  7. Litigation

    Matter in litigation; reserves under Solvency II.

    • Hold IBNR / litigation reserve.
  8. Paid

    Indemnity settled to policyholder / third party.

12 transitions
  • reported triage · Open claim case
  • triage investigation · Assign adjuster
  • triage denied · Issue denial
  • triage fraud_flagged · Escalate to siu
  • investigation adjudicated · Record decision
  • investigation fraud_flagged · Refer law enforcement
  • adjudicated paid · Disburse indemnity
  • adjudicated denied · Issue denial
  • denied litigation · Open litigation file
  • paid litigation · Open litigation file
  • litigation paid · Disburse per order
  • litigation denied · Close file

Bill of Lading Lifecycle (UCP 600) ICC-UCP-600 · ICC-eUCP-2.1 · UNCITRAL-MLETR · Hague-Visby-Rules · Apache-2.0

Lifecycle of a (potentially electronic) bill of lading from issuance through endorsement and consumption under letters of credit. Aligned with UCP 600, eUCP, and MLETR.

  1. Issued

    B/L issued by carrier.

    • Capture carrier signature + shipper details.
  2. Presented

    Presented to bank under L/C.

    • Document UCP 600 compliance check.
  3. Endorsed

    Endorsed in favour of consignee / holder.

    • Maintain endorsement chain.
  4. Consumed

    B/L surrendered against delivery.

    • Capture surrender + cargo release.
5 transitions
  • issued presented · Submit to bank
  • issued endorsed · Transfer title
  • presented endorsed · Release to consignee
  • presented issued · Return for correction
  • endorsed consumed · Release cargo

Chargeback Lifecycle Visa-Core-Rules-Disputes · MC-CR-Ch-7 · Reg-Z-12-CFR-1026.13 · PSD2-Art-74 · Apache-2.0

Lifecycle of a card-scheme chargeback case. Covers issuer notification, evidence collection, representment, and final adjudication.

  1. Opened

    Issuer raised chargeback against merchant.

    • Persist chargeback notice + reason code.
  2. Evidence required

    Merchant gathering representment evidence.

    • Compile compelling evidence per scheme rules.
  3. Accepted

    Merchant accepted; no representment.

  4. Defended

    Evidence submitted; scheme adjudicating.

    • Capture submission receipt from scheme.
  5. Lost

    Merchant lost; debit final.

  6. Won

    Merchant won; funds restored.

6 transitions
  • opened evidence_required · Notify merchant
  • opened accepted · Close case lost
  • evidence_required defended · Submit to scheme
  • evidence_required lost · Close case lost
  • defended won · Restore funds
  • defended lost · Debit merchant

Adverse Event Report Lifecycle (ICH E2B) ICH-E2B-R3 · EMA-EudraVigilance · FDA-FAERS · EU-GVP-Module-VI · Apache-2.0

Lifecycle of an Individual Case Safety Report (ICSR) from intake through regulator submission. Aligned with ICH E2B(R3), EMA EudraVigilance, and FDA FAERS.

  1. Reported

    Case received from HCP, patient, or literature.

    • Persist intake source + minimum criteria.
  2. Triage

    Seriousness + expectedness triage.

    • Assess seriousness criteria.
  3. Assessed

    Causality + narrative compiled.

    • Document causality per WHO-UMC scale.
    • Compile case narrative.
  4. Submitted to regulator

    E2B(R3) submitted to EudraVigilance / FAERS.

    • Capture submission ACK from receiving authority.
3 transitions
  • reported triage · Assign safety officer
  • triage assessed · Compile assessment
  • assessed submitted_to_regulator · Submit e2b

AML Suspicious Transaction Report Lifecycle EU-5AMLD-Art-33 · EU-6AMLD-Dir-2018-1673 · FATF-R20 · UK-POCA-2002-s.330 · Apache-2.0

Lifecycle of a Suspicious Transaction / Activity Report from internal alert through FIU submission. Aligned with EU 5AMLD/6AMLD and FATF Recommendation 20.

  1. Flagged

    Internal alert raised by monitoring / staff.

    • Persist alert with model id + features.
  2. Reviewing

    MLRO / financial intelligence team reviewing.

    • Document investigation steps + rationale.
  3. Reported to fiu

    STR/SAR filed with FIU; tipping-off rules applied.

    • Capture FIU submission reference.
    • Ensure no tipping-off to subject.
  4. Dismissed

    False positive; rationale documented.

    • Document dismissal rationale.
3 transitions
  • flagged reviewing · Open case
  • reviewing reported_to_fiu · File str
  • reviewing dismissed · Close alert
How this widget is built
Demonstrates
KYE™ State Library™
Components
  • kye.state.library_entry.v1 entries
  • States with obligations
  • Transitions with guards and actor roles
  • Machine seal and signature
Flow
Sector → entry → states (initial to terminal) along transitions → obligations evidenced at each state. Architecture diagram
Used on

1 · What it is

30 starter entries. 9 industries.

Each entry is a JSON document conforming to kye.state.library_entry.v1 — states (with obligations), transitions (with guards, actor roles, effects), platform_locked_obligations that cannot be overridden, a machine_seal sha256 over the canonical content, and a detached signature. Tenants adopt by reference and may add states, add transitions, tighten guards, or add extra obligations. They cannot remove states, loosen guards, or strip locked obligations.

  • Versioned. Semver per entry; supersedes pointer for migrations.
  • Signed. Sha256 machine_seal + Ed25519 signature with a published kid.
  • Aligned. Each entry cites the regulations it implements — FCA, PSD2, HIPAA, GDPR, EU AI Act, DORA, NIS2, IATA, IMO, GMP, ICH-E2B, and more.
  • Open. MIT / Apache-2.0 / CC-BY-4.0 only.

2 · The catalog

Pick the one that matches your regulator.

Banking · 5 entries

Loan applications under FCA CONC 5/6/7 and EU MCD. PSD2 Strong Customer Authentication for payment intents. BSA + 5AMLD KYC. Corporate credit facilities under Basel III + IFRS 9. Merchant / acquirer onboarding under scheme rules.

Payments · 3 entries

Outbound payouts across SEPA / Faster Payments / ACH / SWIFT. Refunds under PSD2 Art 76 + UK Consumer Rights Act. Chargebacks under Visa Core Rules + Mastercard CR + Reg Z.

Insurance · 3 entries

Claims under FCA ICOBS 8 and EIOPA guidance. Policy lifecycles under IDD. Underwriting cases governed by Solvency II + EIOPA POG.

Healthcare · 3 entries

Electronic prescriptions under HIPAA + NHS DCB0129/0160. Payer prior-authorisation under CMS-0057-F + HIPAA X12 278. Patient consent under HIPAA + GDPR Art 9.

Pharma · 3 entries

Drug manufacturing batches under EU GMP + FDA 21 CFR 11 + FMD/DSCSA serialisation. Clinical trial subjects under ICH-GCP E6(R3) + EU CTR. Adverse event reporting (ICSR) under ICH E2B(R3).

Logistics · 3 entries

Cargo shipments under IMO SOLAS VGM + IATA DGR + WCO SAFE. Bills of lading under UCP 600 + MLETR. Customs declarations under EU UCC + ICS2.

Energy · 2 entries

Smart meter readings under SMETS2 + Elexon BSC. Power Purchase Agreement settlements under EU REMIT + EFET.

RegTech · 4 entries

DORA third-party ICT provider lifecycle (Art 28-30). NIS2 significant incidents with 24h / 72h / 1-month windows. GDPR data subject requests (Art 12-22). AML suspicious transaction reports under 5AMLD + FATF R20.

AI Governance · 4 entries

EU AI Act high-risk systems (Art 16-29) — design through conformity assessment, CE marking, post-market monitoring, recall. Model evaluations against NIST AI RMF + ISO/IEC 42001. AI inference runs with drift + human-oversight controls. Prompt-injection incident handling.

3 · How adoption works

Adopt by reference. Derive by tightening.

  1. Pick a library entry — e.g. kye:state-library:banking.loan_application.v1.
  2. POST to /v1/state-machines/from-library with your tenant id + a local entity class.
  3. The platform resolves the entry, verifies the machine_seal, validates your overrides, and writes both a tenant-scoped state machine and a kye.state.machine_derivation.v1 record.
  4. From that point on, every transition in your tenant is checked against your derived machine — and the derivation is replayable from the signed library entry.

Derivations are constrained: you can add states / transitions / guards / obligations, but you cannot remove the ones the platform locked. That is what makes a regulator-acceptable starting position auditable across customers.

4 · License + governance

Open source. Signed releases.

Library entries ship under MIT, Apache-2.0, or CC-BY-4.0 — your in-house derivations remain yours. The maintainers (KYE™ Platform Team) co-sign new entries with a published kid; supersedes pointers preserve the chain when a regulator updates the underlying rule.

Ready to adopt these in your tenant?

Pilot the State Library with your team. We’ll help you classify your regulated entities, pick the entries that match, and ship your first signed derivation in a week.

Canonical KYE™ surfaces referenced on this page: KYE Protocol™.