Sample
github.com/go-chi/chi/v5 v5.2.5: Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules
Verified sample for golang github.com/go-chi/chi/v5 v5.2.5: Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules. The…
sha256:a88987ec08ebc9ea4e6f2285b0a335a9a6f069729ba80a41094ef71ab2e556f2
This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured.
How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people.
MIT-0
Execution evidence
The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.
- Evidence basis
- Signed contract pass
- Verification receipts
- 3
- Signing keys that built it
- 2
Declared environment
go linux x64 go go go
Verification-run environments
| Environment | Contract | Stages | Run |
|---|---|---|---|
| go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · golang@1 |
2026-08-17 |
| go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · golang@1 |
2026-08-18 |
| go 1.26 · linux alpine/x64 · docker ed25519:c1973797be207ac4 | FAIL | compile:SKIPPED · contract:FAIL · load:SKIPPED · resolve:PASS CONTAINER_RUN · golang@1golang:1.26-alpine@sha256:28d89ee9cc0f… |
2026-09-08 |
Case
HOW- Goal
- Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules
- Packages
- Symbols
-
- middleware.RouteHeaders
- Environment
- go
- Created
- 2026-08-17T01:25:28Z
Contract
- `middleware.RouteHeaders().Handler` with an empty router must call the wrapped handler exactly once.
- A request through that setup must return exactly one response body write from the downstream handler.
Files
- NOTES.md
- csx.json
- go.mod
- go.sum
- route_headers_test.go
Source
Known sample cache returned a different chi sample (`sha256:8a05cf61b89bea84e9ae1dc410f9f500c1009e51fec9897152bcdb81c072752f`) focused on URL-param routing, so this project uses a separate `middleware.RouteHeaders` trap.
In pre-fix versions (before `v5.2.5`), `RouteHeaders().Handler` lacked a return on the empty-router branch, so the next handler ran twice on a miss.
{"case":{"believed":"If no routes are configured on `middleware.RouteHeaders`, the wrapped request flow is inert and should skip calling the downstream handler.","caseId":"case:sha256:6bd5ff2114c353ba4ae61b235b9ab8aa9349673c1f339286308f766948e5351f","contract":["`middleware.RouteHeaders().Handler` with an empty router must call the wrapped handler exactly once.","A request through that setup must return exactly one response body write from the downstream handler."],"goal":"Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules","kind":"HOW","packages":["pkg:golang/github.com/go-chi/chi/v5@v5.2.5"],"schemaVersion":1,"symbols":["middleware.RouteHeaders"]},"contractCommand":["go","test","./..."],"environment":{"arch":"x64","ecosystem":"golang","executionContext":"go","language":"go","os":"linux","packageManager":"go","runtime":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/go-chi/chi/v5@v5.2.5"],"schemaVersion":1,"symbols":["middleware.RouteHeaders"],"verifierAdapter":"golang@1"}
module chi_route_headers
go 1.22
require github.com/go-chi/chi/v5 v5.2.5
github.com/go-chi/chi/v5 v5.2.5 h1:Eg4myHZBjyvJmAFjFvWgrqDTXFyOzjj7YIm3L3mu6Ug=
github.com/go-chi/chi/v5 v5.2.5/go.mod h1:X7Gx4mteadT3eDOMTsXzmI4/rwUpOwBHLpAfupzFJP0=
package main
import (
"net/http"
"net/http/httptest"
"testing"
"github.com/go-chi/chi/v5"
"github.com/go-chi/chi/v5/middleware"
)
func TestRouteHeadersEmptyRouterCallsNextExactlyOnce(t *testing.T) {
calls := 0
r := chi.NewRouter()
r.Use(middleware.RouteHeaders().Handler)
r.Get("/", func(w http.ResponseWriter, r *http.Request) {
calls++
_, err := w.Write([]byte("ok"))
if err != nil {
t.Fatalf("unexpected write error: %v", err)
}
})
req := httptest.NewRequest(http.MethodGet, "/", nil)
rr := httptest.NewRecorder()
r.ServeHTTP(rr, req)
if calls != 1 {
t.Fatalf("expected downstream handler to run once, got %d", calls)
}
if got := rr.Body.String(); got != "ok" {
t.Fatalf("expected one body write, got %q", got)
}
}