FilingWatch

Documentation

Overview

FilingWatch locks a recurring SEC disclosure obligation — CIK, required form, deadline, cadence — and checks it against EDGAR's own submissions record via independent GenLayer validator consensus. No stake, no fund custody: the output is a durable, fail-closed compliance-standing record.

How it works

register_obligation locks the obligation. Once its deadline passes, open_check creates a checkpoint and rolls the deadline forward by the cadence. assess_check runs gl.eq_principle.prompt_comparative: independent validators each fetch EDGAR fresh and must agree exactly on the matched filing's form, date, and accession number. A deterministic layer then re-derives SATISFIED vs. LATE from that date against the sealed deadline — the model never gets to hand over its own verdict label directly.

Architecture

Two storage record types (Obligation, Check) plus a lightweight boolean index preventing duplicate checkpoints. Full diagram and evidence-binding rationale in docs/architecture.md in the repository.

Smart contracts

contracts/FilingWatch.py — the only contract in this repo. Full method table, verdict-reachability trace, and deliberate-gaps list in docs/contracts.md.

API reference

Writes: register_obligation, open_check, assess_check, close_obligation. Views (all plain dict): get_contract_version, get_obligation, get_check, get_totals. Full parameter and precondition table in docs/contracts.md.

FAQ

Why not a submitter-supplied evidence URL? Because a caller-chosen page only proves the page repeats a claim, not that the claim is true — the evidence source here is instead derived deterministically from the locked CIK, and EDGAR's own JSON is required to echo that CIK before anything in it counts as evidence. Why no stake? There's no adversarial counterparty positioned to benefit from a false verdict here, so a slashing mechanic would be decorative rather than structural. Is this legal or investment advice? No — it's a public monitoring record, not a compliance or legal determination.