Source: pcoc reference/go/ at aaa8946.

Go reference

The Go implementation of Satoshi Hike v2.0. It is one of three independent references. It is a guide, not the specification. Where it disagrees with Satoshi Hike v2.0, the specification wins and this tree has a bug.

This port does not generate the conformance vectors. It reads spec/conformance/v2.0/ and compares its section 14 record with the bytes already there.

Tag

The current tag is reference/go/v2.0.3. go.mod declares module github.com/groundinglab/pcoc/reference/go/v2, so the tag must have that prefix. There is no ref-go- tag.

Toolchain

Go 1.22, from go.mod. No third-party dependencies.

Test

From this directory:

cd reference/go
go vet ./...
go test ./...

Expect both to exit 0. go test ./... runs the conformance pack against spec/conformance/v2.0/ and prints ok for each package.

Produce and verify

From reference/go:

go run ./cmd/satoshi-hike-produce --pubkey-hex HEX --output PATH --gossip-peer HOST:PORT --bari-url URL
go run ./cmd/satoshi-hike-verify --input OBJECT --index-url URL

On a successful verify, stdout is the section 14 measurement record and the process exits 0. That exit is not an admission decision.

The default --profile is test, which will not dial https://index.groundinglab.io and reads PCOC_TEST_INDEX_URL when --index-url is omitted. To verify against the public index, pass --profile live --index-url https://index.groundinglab.io. The full usage text (--help) has the rules.

satoshi-hike-verify writes the section 14 measurement record to stdout when the object decodes. It does not apply admission policy.

Spec pin

reference/SPEC_PIN names spec-v2.0.3 and the vector hash. Check it with python3 reference/tools/check_spec_pin.py, run from the repository root.

Demo keys

This port does not derive a production seed. A demo seed phrase on the command line is not production_seed.

From pcoc reference/go/README.md at aaa8946. Raw markdown.