# Veriql Drain Watch, changelog

The open blocklist is published at
[`/drain-watch/blocklist.json`](https://veriql.app/drain-watch/blocklist.json)
and [`/drain-watch/blocklist.csv`](https://veriql.app/drain-watch/blocklist.csv).

**Contents change daily; this file records changes to the SHAPE**, so a consumer
can tell whether a re-fetch needs code changes or just a download. The schema
version is in `meta.version`. The entry count is in `meta.total` and is expected
to move without an entry here.

Reuse: CC BY 4.0 on the compilation, with attribution to Veriql. Every entry
also names the licence of the source that reported it, in `sources[].license`.

---

## 1.1 (2026-10-11)

**Added**

- `meta.version`, so a consumer can pin to a shape.
- `meta.license` and `meta.licenseUrl`. The compilation is CC BY 4.0. The
  structured data previously advertised MIT, which is one upstream source's
  licence rather than ours, so a reuser deciding what they could do with the
  whole file was reading the terms of a part of it.
- `meta.counts.byChain` and `meta.counts.byCategory`.
- `entries[].veriql_first_seen`.
- A CSV mirror at `/drain-watch/blocklist.csv`, same rows, same order.

**Renamed, without removing anything**

- `entries[].first_seen` is now also published as `veriql_first_seen`, and the
  new name is the accurate one: it is when **Veriql first recorded** the
  address, not when the address was first used and not when its source first
  listed it. 1,022 of the 1,674 entries share a timestamp to the second,
  because that is when an ingest ran.

  Where a source does not publish its own first-seen date, we do not know it,
  and no earlier date is invented to make the list look prescient.

  `first_seen` is still present and identical. The file is already fetched by
  people we cannot contact, so the old key stays.

**Not changed**

- Entry order (by chain, then address), so a diff between two days is readable.
- `chain`, `address`, `category`, `confidence`, `sources[]`.

## 1.0

- Initial public list: `meta.generatedAt`, `meta.total`, `meta.note`, and
  entries with `chain`, `address`, `category`, `confidence`, `first_seen` and
  `sources[]` carrying `source`, `url` and `license`.
