Skip to content

chore(images): digest-pin verifier, controller, litellm, cloudflared#517

Closed
bussyjd wants to merge 1 commit into
mainfrom
chore/digest-pin-cluster-images
Closed

chore(images): digest-pin verifier, controller, litellm, cloudflared#517
bussyjd wants to merge 1 commit into
mainfrom
chore/digest-pin-cluster-images

Conversation

@bussyjd
Copy link
Copy Markdown
Collaborator

@bussyjd bussyjd commented May 23, 2026

Why

Only x402-buyer and the frontend image carried @sha256: digest pins. Tag-only refs are vulnerable to mutable-tag rewrites — exactly the class CLAUDE.md pitfall #12 codified after a real local-cluster incident. Extending digest discipline to the other four images closes the gap.

Before

              ┌─────────────────────┐
              │  ghcr.io registry   │
              └──────────┬──────────┘
                         │ tag-only refs (mutable)
       ┌─────────────────┼──────────────────┐
       ▼                 ▼                  ▼
   x402-verifier   serviceoffer-      litellm
   :b13254e        controller:b13254e :sha-c16b156
       │                 │                  │
       │  tag rewrite at registry → new digest │
       ▼                 ▼                  ▼
   silently pulls compromised image on any new node

After

              ┌─────────────────────┐
              │  ghcr.io registry   │
              └──────────┬──────────┘
                         │ tag@sha256 (immutable)
       ┌─────────────────┼──────────────────┐
       ▼                 ▼                  ▼
   x402-verifier   serviceoffer-      litellm
   :b13254e        controller:b13254e :sha-c16b156
   @sha256:…       @sha256:…          @sha256:…
                         │
                         ▼
   tag rewrite → digest mismatch → image pull fails loud

What's pinned

  • ghcr.io/obolnetwork/x402-verifier:b13254e@sha256:a8a7aa0c…0342d
  • ghcr.io/obolnetwork/serviceoffer-controller:b13254e@sha256:f83bd7e5…07af
  • ghcr.io/obolnetwork/litellm:sha-c16b156@sha256:9f112b51…c86e
  • cloudflare/cloudflared:2026.3.0@sha256:6b599ca3…31b0

(x402-buyer and obol-stack-front-end already digest-pinned — no change.)

Digests resolved via docker buildx imagetools inspect <ref> --format '{{ .Manifest.Digest }}'.

Test plan

  • go build ./... clean
  • go test ./internal/embed/... ./internal/defaults/... ./internal/x402/... green
  • Regression test added (TestEmbeddedImages_NamedImagesAreDigestPinned, TestEmbeddedImages_CloudflaredHelmTagIsDigestPinned) asserting @sha256: on every named image
  • Dev-mode rewrite invariant (combo-form regex from CLAUDE.md pitfall Remove unused charts and scripts #12) verified intact — TestCopyInfrastructure_DevModeRewritesDigestPins and TestX402Manifest_DevModeRewritesPins both pass against the new combo-form pins

Companion to

Architecture review surfaced this as the simplest open security item in PRs #513 / #330 follow-up.

Extends the @sha256 digest discipline that x402-buyer and the frontend
already carry to the remaining four images that ship as part of the
embedded infrastructure. Tag-only refs (e.g. ghcr.io/obolnetwork/
x402-verifier:b13254e) are vulnerable to mutable-tag rewrites — the
class of bug CLAUDE.md pitfall #12 documented as a real production fire.

Pins:
  - x402-verifier:b13254e             @ sha256:a8a7aa0ca4c35b0ddf6983fa6e3e5f8a3f64e44d8e506ebfd55e39de2bc0342d
  - serviceoffer-controller:b13254e   @ sha256:f83bd7e55bdc5d87edb49c04e7fd9257097364e2d43e769c19dfd7c8b47d07af
  - litellm:sha-c16b156               @ sha256:9f112b51ac5a57d73cdd54103fb98d24eabaddd8689a9a285884dca6456dc86e
  - cloudflared:2026.3.0              @ sha256:6b599ca3e974349ead3286d178da61d291961182ec3fe9c505e1dd02c8ac31b0

Adds a regression test asserting every embedded manifest carries
@sha256: on its image refs so a future dependency bump can't silently
revert to tag-only.

Dev-rewrite invariant (defaults.go:124 + setup.go:74 alternation regex)
verified intact via go test ./internal/defaults/... ./internal/x402/...
@bussyjd
Copy link
Copy Markdown
Collaborator Author

bussyjd commented May 24, 2026

Superseded by bundle PR #536 — closing in favor of the consolidated merge target. Original branch and history preserved.

@bussyjd bussyjd closed this May 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant