Sample
github.com/hashicorp/hcl v1.0.0: Unmarshal
Verified sample for golang github.com/hashicorp/hcl v1.0.0: Unmarshal. The contract ran on go 1.26 · linux debian/x64 · docker and passed.
sha256:b4186881e2a21eeb2ff039875029b4382306fe5998b9a2f0a3fb52f6ff903bb2
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
- 1
- Signing keys that built it
- 1
Declared environment
linux 24 · ubuntu · glibc 2.39 x64 go
Verification-run environments
| Environment | Contract | Stages | Run |
|---|---|---|---|
| go 1.26 · linux debian/x64 · docker ed25519:c1973797be207ac4 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · golang@1golang:1.26@sha256:e30143be198a… |
2026-10-27 |
Case
HOW- Goal
- verify hcl.Unmarshal in pkg:golang/github.com/hashicorp/hcl@v1.0.0
- Packages
- Symbols
-
- hcl.Unmarshal
- Created
- 2026-10-27T18:07:54Z
Contract
- hcl.Unmarshal decodes HCL byte slices with top-level attributes, slices, maps, and labeled nested blocks into a Go struct
- hcl.Unmarshal decodes equivalent JSON byte slices into an identical Go struct value
- hcl.Unmarshal decodes HCL byte slices into a map[string]interface{} target
- hcl.Unmarshal returns a non-nil error when given malformed HCL input bytes
Files
- PROMPT.md
- csx.json
- go.mod
- go.sum
- spec.json
- test/contract.go
Source
Clean-room public code sample — generation instructions
Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.
A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.
Goal: verify hcl.Unmarshal in pkg:golang/github.com/hashicorp/hcl@v1.0.0
Kind: HOW
Use EXACTLY these public packages and versions:
- pkg:golang/github.com/hashicorp/hcl@v1.0.0
Demonstrate these symbols/APIs:
- hcl.Unmarshal
Rules:
- One focused purpose; the smallest project that proves the goal.
- Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
- Pin every dependency with a lockfile so resolution is reproducible.
- No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
- No personal names, emails, company names, or project identifiers of any kind.
- No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
- Keep it under 200 files and 256KB packed.
{"case":{"caseId":"case:sha256:5e8314139eaedeb46a4a16d31008bdbdf7db40b85d27aa0fcc49d883c2de0f5a","contract":["hcl.Unmarshal decodes HCL byte slices with top-level attributes, slices, maps, and labeled nested blocks into a Go struct","hcl.Unmarshal decodes equivalent JSON byte slices into an identical Go struct value","hcl.Unmarshal decodes HCL byte slices into a map[string]interface{} target","hcl.Unmarshal returns a non-nil error when given malformed HCL input bytes"],"goal":"verify hcl.Unmarshal in pkg:golang/github.com/hashicorp/hcl@v1.0.0","kind":"HOW","packages":["pkg:golang/github.com/hashicorp/hcl@v1.0.0"],"schemaVersion":1,"symbols":["hcl.Unmarshal"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/hashicorp/hcl@v1.0.0"],"schemaVersion":1,"subject":"pkg:golang/github.com/hashicorp/hcl@v1.0.0","symbols":["hcl.Unmarshal"],"verifierAdapter":"golang@1"}
module sample
go 1.21
require github.com/hashicorp/hcl v1.0.0
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/hashicorp/hcl v1.0.0 h1:0Anlzjpi4vEasTeNFn2mLJgTSwt0+6sfsiTG8qcWGx4=
github.com/hashicorp/hcl v1.0.0/go.mod h1:E5yfLk+7swimpb2L/Alb/PJmXilQ/rhwaUYs4T20WEQ=
{
"schemaVersion": 1,
"goal": "verify hcl.Unmarshal in pkg:golang/github.com/hashicorp/hcl@v1.0.0",
"kind": "HOW",
"packages": [
"pkg:golang/github.com/hashicorp/hcl@v1.0.0"
],
"symbols": [
"hcl.Unmarshal"
]
}
package main
import (
"fmt"
"os"
"reflect"
"github.com/hashicorp/hcl"
)
type EndpointConfig struct {
Host string `hcl:"host"`
Port int `hcl:"port"`
Enabled bool `hcl:"enabled"`
Tags []string `hcl:"tags"`
Labels map[string]string `hcl:"labels"`
}
type ServiceConfig struct {
Service string `hcl:"service"`
Endpoint map[string]EndpointConfig `hcl:"endpoint"`
}
func main() {
hclBytes := []byte(`
service = "api"
endpoint "primary" {
host = "localhost"
port = 8080
enabled = true
tags = ["http", "v1"]
labels = {
tier = "edge"
}
}
`)
// 1. Unmarshal HCL bytes into a typed Go struct.
var fromHCL ServiceConfig
if err := hcl.Unmarshal(hclBytes, &fromHCL); err != nil {
fmt.Fprintf(os.Stderr, "hcl.Unmarshal HCL failed: %v\n", err)
os.Exit(1)
}
if fromHCL.Service != "api" {
fmt.Fprintf(os.Stderr, "unexpected Service: %q\n", fromHCL.Service)
os.Exit(1)
}
ep, ok := fromHCL.Endpoint["primary"]
if !ok {
fmt.Fprintf(os.Stderr, "missing primary endpoint block\n")
os.Exit(1)
}
if ep.Host != "localhost" || ep.Port != 8080 || !ep.Enabled {
fmt.Fprintf(os.Stderr, "unexpected endpoint fields: %+v\n", ep)
os.Exit(1)
}
if !reflect.DeepEqual(ep.Tags, []string{"http", "v1"}) {
fmt.Fprintf(os.Stderr, "unexpected tags: %+v\n", ep.Tags)
os.Exit(1)
}
if ep.Labels["tier"] != "edge" {
fmt.Fprintf(os.Stderr, "unexpected labels: %+v\n", ep.Labels)
os.Exit(1)
}
// 2. Unmarshal equivalent JSON bytes into the same Go struct type.
jsonBytes := []byte(`{
"service": "api",
"endpoint": {
"primary": {
"host": "localhost",
"port": 8080,
"enabled": true,
"tags": ["http", "v1"],
"labels": {"tier": "edge"}
}
}
}`)
var fromJSON ServiceConfig
if err := hcl.Unmarshal(jsonBytes, &fromJSON); err != nil {
fmt.Fprintf(os.Stderr, "hcl.Unmarshal JSON failed: %v\n", err)
os.Exit(1)
}
if !reflect.DeepEqual(fromHCL, fromJSON) {
fmt.Fprintf(os.Stderr, "HCL and JSON unmarshal mismatch: %+v vs %+v\n", fromHCL, fromJSON)
os.Exit(1)
}
// 3. Unmarshal HCL bytes into a generic map[string]interface{}.
var rawMap map[string]interface{}
if err := hcl.Unmarshal([]byte(`count = 3`+"\n"+`mode = "active"`), &rawMap); err != nil {
fmt.Fprintf(os.Stderr, "hcl.Unmarshal map failed: %v\n", err)
os.Exit(1)
}
if rawMap["count"] != 3 || rawMap["mode"] != "active" {
fmt.Fprintf(os.Stderr, "unexpected map contents: %+v\n", rawMap)
os.Exit(1)
}
// 4. Verify hcl.Unmarshal returns a non-nil error on syntax errors.
var invalid ServiceConfig
if err := hcl.Unmarshal([]byte(`service = "unterminated`), &invalid); err == nil {
fmt.Fprintf(os.Stderr, "expected error for invalid HCL syntax\n")
os.Exit(1)
}
}
Origin Seeder
anonymous