Source: [pcoc `reference/go/` at aaa8946](https://github.com/groundinglab/pcoc/tree/aaa8946d241bf22a3004b71cf082267c757221a2/reference/go/).

# 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](spec.md), 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:

```sh
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`:

```sh
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](https://github.com/groundinglab/pcoc/blob/aaa8946d241bf22a3004b71cf082267c757221a2/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`.