CodeSampleX

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

  1. hcl.Unmarshal decodes HCL byte slices with top-level attributes, slices, maps, and labeled nested blocks into a Go struct
  2. hcl.Unmarshal decodes equivalent JSON byte slices into an identical Go struct value
  3. hcl.Unmarshal decodes HCL byte slices into a map[string]interface{} target
  4. 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

Download the source artifact (tar.gz)

Source

PROMPT.md
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.
csx.json
{"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"}
go.mod
module sample

go 1.21

require github.com/hashicorp/hcl v1.0.0
go.sum
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=
spec.json
{
  "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"
  ]
}
test/contract.go
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