Compare commits

...

4 Commits

Author SHA1 Message Date
ipfs.kane-il.us publisher 49d83cdff8 publish: manifest + signature + log for 20250827T191034Z 2025-08-29 16:28:21 +00:00
ipfs.kane-il.us publisher 89fe77fcc3 publish: add legal/20250827T191034Z_ipfs_in_plain_english.md 2025-08-29 16:21:14 +00:00
ipfs.kane-il.us publisher ff84b47668 chore(manifests): align .sshsig to canonical ipfspublish namespace 2025-08-29 16:06:58 +00:00
ipfs.kane-il.us publisher 88a01c3c14 chore: normalize manifest sig namespace to ipfspublish 2025-08-29 16:05:30 +00:00
3 changed files with 70 additions and 6 deletions

View File

@ -1,6 +1,6 @@
-----BEGIN SSH SIGNATURE----- -----BEGIN SSH SIGNATURE-----
U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgVEY8m5hZXa43Z7YkjG2RtiOE46 U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgVEY8m5hZXa43Z7YkjG2RtiOE46
P3nB4hMQ6JF5TaDYUAAAAEZmlsZQAAAAAAAAAGc2hhNTEyAAAAUwAAAAtzc2gtZWQyNTUx P3nB4hMQ6JF5TaDYUAAAALaXBmc3B1Ymxpc2gAAAAAAAAABnNoYTUxMgAAAFMAAAALc3No
OQAAAEDeM28XOIf7rTSmct7Ya7M7ciCdYYkL4d+vkfkIPYr6VKhL1BAI54locaojTrRjXG LWVkMjU1MTkAAABAdBDY+Y/J4YsdzIr3RHMugVe09h0+dTdm+mTnJHEcBi8xC11FfIl+v0
KVSKRXP8GQdyNrB3VnZOwB NmblDyv2caH/WsNkktIOEgyr7tgN/eBQ==
-----END SSH SIGNATURE----- -----END SSH SIGNATURE-----

3
_log/publish.jsonl Normal file → Executable file
View File

@ -1,3 +0,0 @@
{"event":"init","utc":"1970-01-01T00:00:00Z","note":"publish log created"}{"event":"publish","utc":"2025-08-28T20:03:39Z","cid":"Qmcd9786Mz86sRAZbgEsf6trZUfhNXDPzhXCjfqePKP7vo","path":"/legal/research/county/kane/zoning/20250828T185238Z_zoning_buffer_requirements.md","gateway":"https://ipfs.kane-il.us/ipfs/Qmcd9786Mz86sRAZbgEsf6trZUfhNXDPzhXCjfqePKP7vo","tag":"publish-20250828T200339Z"}
{"event":"publish","utc":"2025-08-28T20:10:08Z","cid":"OK:","path":"/legal/research/county/kane/zoning/20250828T185238Z_zoning_buffer_requirements.md","gateway":"https://ipfs.kane-il.us/ipfs/OK:","tag":"publish-20250828T201008Z"}
{"event":"publish","utc":"2025-08-28T20:15:54Z","cid":"Qmcd9786Mz86sRAZbgEsf6trZUfhNXDPzhXCjfqePKP7vo","path":"/legal/research/county/kane/zoning/20250828T185238Z_zoning_buffer_requirements.md","gateway":"https://ipfs.kane-il.us/ipfs/Qmcd9786Mz86sRAZbgEsf6trZUfhNXDPzhXCjfqePKP7vo","tag":"publish-20250828T201554Z"}

View File

@ -0,0 +1,67 @@
# IPFS in Plain English (for legal readers)
Host: https://ipfs.kane-il.us · Repository: `w3pbs/ipfs.kane-il.us` (Gitea, branch `main`) · Version: v1.0 · Generated (UTC): 2025-08-27 19:10:34Z
---
## What IPFS does
- IPFS gives every document a CID (content ID) that is a fingerprint of the exact bytes.
- If anything changes—even one character—the document gets a different CID.
- Example: if a body of text contains `01/01/1978` and that changes to `01/01/1987`, the CID changes. The original text keeps its original CID and remains retrievable at that CID.
---
## Why this matters in legal settings
- **Integrity:** Opening the same `/ipfs/<CID>` always returns the same document. If the bytes were different, the CID would be different.
- **Stable citations:** Every publish is timestamped and logged. CIDs never change, so filings can cite them permanently.
- **Audit trail:** Each publish has a signed manifest (path ↔ CID) and an entry in the permanent log at `/_log/publish.jsonl`. This log, not transient web pages, is the provenance record.
- **Court admissibility:** The CID itself is the authoritative reference. Filings should cite the CID to guarantee immutability, not just a URL or repository path.
---
## Repository vs. Immutable Retrieval
- **Repository (Gitea):** The repo at [gitea.barternetwork.us](https://gitea.barternetwork.us/w3pbs/ipfs.kane-il.us) holds the structured hierarchy (`/legal`, `/civics`, `/naics`, etc.). It provides human-readable organization, history, and convenience for operators.
- **Immutable files:** For authentic, court-admissible retrieval, always use the **CID**. The Gitea repo structures the files, but the CID guarantees their identity forever.
---
## Snapshots and navigation
- There is **no mutable “latest” pointer** (no IPNS, no DNSLink).
- Each published file is permanent, timestamped in its filename (`YYYYMMDDThhmmssZ_<slug>.md`), and referenced in the manifest/log.
- Gateway directory listings under `https://ipfs.kane-il.us` expose these timestamped files directly.
---
## How to verify (no installs needed)
1. Open `https://ipfs.kane-il.us/_log/publish.jsonl` (or the manifest for the filings date).
2. Find the file path and note its CID (and, if provided, SHA-256).
3. Confirm the CID matches the value on the filings cover sheet.
4. *(Optional)* Fetch the same `/ipfs/<CID>` via a second public gateway to cross-check—it will return the same bytes for the same CID.
---
## Scope & privacy
- Only court-public materials are published. Private or sealed content is not placed on IPFS.
---
## Terms (brief)
- **CID:** Content ID (hash of the exact bytes).
- **Manifest:** JSON file mapping file paths to their CIDs; cryptographically signed.
- **Publish log:** Append-only JSONL file at `/_log/publish.jsonl` recording each publish.
- **Snapshot:** Timestamped file committed once, never changed.
- **Gitea repo:** Source of structure and convenience; not itself proof of immutability.
---
## Email-sized blurbs (pick one)
**Ultra-plain (2 sentences):** IPFS assigns each document a unique CID that is a fingerprint of its exact text. If anything changes—even one character—the CID changes, so opening the same CID always returns the original document.
**With date example:** IPFS identifies each document by a CID. If `01/01/1978` is changed to `01/01/1987`, that small change produces a new CID—so the original text keeps its original CID and can always be retrieved.
**With “repo vs CID”:** The Gitea repo provides the folder structure, but the CID is the legal proof. For citations, always use the CID—because the CID is immutable, permanent, and court-admissible.
---
*Disclaimer: This explainer is informational, not legal advice, and does not represent any government.*