Innsigle Use Walkthrough: seal a docs page

Walkthrough: seal a docs page

You have a static HTML page (often model-drafted). You want a model-primary colophon, a footer seal, and a claim someone can verify from local copies of the page, attestation, and keys.

Prerequisites

  • Node 20+
  • Innsigle CLI installed (CLI):

npm install github:DocumentDrivenDX/innsigle then npx innsigle, or clone and npm install -g . / node src/cli.mjs

Commands below use innsigle. From a clone without install, substitute node src/cli.mjs.

Steps

1. Draft and edit

Produce the page content (often a model draft). Optionally run sloptimizer on prose. Do not change composition to human-authored because of that rewrite.

2. Write the colophon

innsigle colo example --kind model-primary > colo.json
# edit ingredients: name Claude, sloptimizer, human roles

3. Generate issuer keys (once)

innsigle keygen --out-dir ./keys
innsigle keys template \
 --issuer-id my-house --issuer-name "My House" \
 --public-key "$(cat keys/ed25519.pub.raw.b64url)" \
 --key-id "$(cat keys/key-id.txt)" \
 --out keys.json

Publish keys.json over HTTPS (or ship beside content for local demos). See Issuer.

4. Build claim and sign

innsigle claim build \
 --content ./page.html \
 --uri https://example.com/page/ \
 --colo colo.json \
 --issuer-id my-house --issuer-name "My House" \
 --key-id "$(cat keys/key-id.txt)" \
 --key-url https://example.com/.well-known/innsigle/keys.json \
 --out claim.json

innsigle sign \
 --claim claim.json \
 --key keys/ed25519.priv.pem \
 --out claim.attestation.json

Keep the private key offline (not in the site tree). --key-url must be absolute https://….

5. Place the seal

Footer (see docs/sample/snippets/footer.html): glyph + link to the attestation or a colophon page. Use the A mark for model-primary (Marks).

6. Verify

innsigle verify \
 --attestation claim.attestation.json \
 --content ./page.html \
 --keys keys.json
# expect VALID

Mutate the HTML and re-run: expect content mismatch (exit 3).

Check it (this site)

What we claim: the published sample is already sealed this way.

Live: Sample · curl recipe on CLI. Expect: VALID.

Proof in this repo

  • Sample page + attestation under docs/sample/
  • Vectors: tests/vectors/ on GitHub

Spec

Feature note: signed docs claims

Innsigle seal: mixed by Innsigle (human key)

Signature covers the markdown source of this page, not these HTML bytes. This render quotes that seal.

Composition
mixed
Issuer
Innsigle innsigle
Signing key
ed25519:15c6242b6ef825413847e221267959c9 (human key)
Signed source
docs/website/content/curated/use/walkthrough-docs.md
Signed
2026-09-30T20:46:37Z
Content digest
sha256:4ec0d18b…f52fe54a

Human-controlled key. Signature is not a detector and not a truth guarantee.

Raw attestation JSON
{
  "payload": {
    "innsigle": "1",
    "type": "https://innsigle.dev/claim/colophon/v1",
    "issued_at": "2026-09-30T20:46:37Z",
    "issuer": {
      "id": "innsigle",
      "name": "Innsigle",
      "key_id": "ed25519:15c6242b6ef825413847e221267959c9",
      "key_url": "https://documentdrivendx.github.io/innsigle/.well-known/innsigle/keys.json"
    },
    "subjects": [
      {
        "uri": "https://documentdrivendx.github.io/innsigle/use/walkthrough-docs/",
        "digest": {
          "alg": "sha256",
          "value": "4ec0d18b4e095a32884ea0b287e32d03c3b840fcaff343508a120aa6f52fe54a"
        }
      }
    ],
    "colophon": {
      "schema_version": "1",
      "composition": "mixed",
      "ingredients": [
        {
          "kind": "human",
          "name": "operator",
          "role": "outline"
        },
        {
          "kind": "model",
          "name": "Claude",
          "role": "expand"
        },
        {
          "kind": "human",
          "name": "operator",
          "role": "final-edit"
        }
      ],
      "notes": null
    }
  },
  "payload_encoding": "json",
  "signatures": [
    {
      "key_id": "ed25519:15c6242b6ef825413847e221267959c9",
      "alg": "ed25519",
      "sig": "SWXrNmgapujAPmfX1ikjXhYzoBI6dZuBh5xJWX04UX-2R6RQ40-x_TTX1zQf4_RE1g_hE6rTZ1Z14a7K81oJCg",
      "signed_at": "2026-09-30T20:46:37Z"
    }
  ]
}