Gloas support for Glamsterdam devnet-7 (types + transport)

.github/workflows/golangci-lint.yml

@@ -15,6 +15,12 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
+        with:
+          # attgo's current-year analyzer resolves the changed-file set with
+          # `git diff origin/master...HEAD`.  The default shallow checkout has no
+          # origin/master ref, so the analyzer fails open and checks every file in
+          # the repo rather than the ones this branch touches.
+          fetch-depth: 0
 
       - uses: actions/setup-go@v5
         with:

.github/workflows/http-tests.yml

@@ -33,3 +33,23 @@ jobs:
           HTTP_TEST_CONCURRENCY: ${{ vars.HTTP_TEST_CONCURRENCY }}
           HTTP_BEARER_TOKEN: ${{ secrets.HTTP_BEARER_TOKEN }}
         run: go test -v -timeout=10m ./http/...
+
+  http-tests-gloas:
+    if: ${{ vars.HTTP_ADDRESS_GLOAS != '' }}
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.25.2'
+
+      - name: Run HTTP tests
+        env:
+          HTTP_ADDRESS: ${{ vars.HTTP_ADDRESS_GLOAS }}
+          HTTP_TEST_CONCURRENCY: ${{ vars.HTTP_TEST_CONCURRENCY }}
+          HTTP_BEARER_TOKEN: ${{ secrets.HTTP_BEARER_TOKEN_GLOAS }}
+          HTTP_REQUIRE_GLOAS: 'true'
+        run: go test -v -timeout=25m ./http/...

.gitignore

@@ -7,6 +7,9 @@
 # Test binary, build with `go test -c`
 *.test
 
+# Custom golangci-lint binary built via `golangci-lint custom` (config: .custom-gcl.yml)
+custom-gcl
+
 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
 coverage.html

.golangci.yml

@@ -154,7 +154,7 @@ linters:
           # HIGH PRIORITY
           enable_no_pkg_logger: false
           enable_enum_iota: true
-          enable_current_year: false
+          enable_current_year: true
           # MEDIUM PRIORITY
           enable_capital_comment: false
           enable_func_opts: true
@@ -178,6 +178,17 @@ linters:
       - third_party$ # Exclude third party code
       - builtin$ # Exclude builtin code
       - examples$ # Exclude example code
+    # Rule-based exclusions
+    rules:
+      # gloas ePBS type definitions carry long dynssz size-expression struct
+      # tags and require ssz-index tags for correct SSZ generation (removing
+      # them changes the generated SSZ). gofmt aligns these tags past the
+      # 132-char limit and struct tags cannot be wrapped, so exempt only the
+      # line-length checks for the gloas type packages.
+      - path: (spec|api/v1)/gloas/
+        text: "line is [0-9]+ characters"
+        linters:
+          - revive
 # Formatters: Code formatting tools
 formatters:
   enable:

api/epbsproposalopts.go

@@ -0,0 +1,71 @@
+// Copyright © 2026 Attestant Limited.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package api
+
+import (
+	"github.com/attestantio/go-eth2-client/spec/phase0"
+)
+
+// EPBSProposalOpts are the options for obtaining ePBS block proposals.
+//
+// Post-Gloas there is no blinded proposal: proposers commit to an execution
+// payload bid rather than to a payload, so the axis that replaced blinded versus
+// unblinded is IncludePayload — whether the execution payload envelope travels
+// with the block or stays cached on the producing node.
+type EPBSProposalOpts struct {
+	Common CommonOpts
+
+	// Slot is the slot for which the proposal should be fetched.
+	Slot phase0.Slot
+	// RandaoReveal is the RANDAO reveal for the proposal.
+	RandaoReveal phase0.BLSSignature
+	// Graffiti is the graffiti to be included in the beacon block body.
+	Graffiti [32]byte
+	// SkipRandaoVerification is true if we do not want the server to verify our RANDAO reveal.
+	// If this is set then the RANDAO reveal should be passed as the point at infinity (0xc0…00)
+	SkipRandaoVerification bool
+	// IncludePayload selects whether a self-built proposal carries its execution
+	// payload envelope and blobs.
+	//
+	// True asks a self-building node for the stateless form: everything needed to
+	// publish travels in the response, so any beacon node can publish the block.
+	// This is what multiple-beacon-node, distributed-validator and failover setups
+	// require.  It is a request rather than a guarantee: a block built on an
+	// external builder's bid comes back with
+	// VersionedEPBSProposal.ExecutionPayloadIncluded false whatever was asked for,
+	// because the node does not hold the builder's payload, so those setups must
+	// read that field rather than assume this one describes what arrived.
+	//
+	// False is stateful: the producing node caches the envelope and blobs, so the
+	// block must be published via that same node, and the envelope retrieved from
+	// it with ExecutionPayloadEnvelope() — but only when the node self-built the
+	// block. An external builder's bid comes back excluded regardless of what was
+	// asked for, and the response alone does not say which case occurred; that is
+	// operational context the caller must already know.
+	//
+	// The spec marks this parameter required with no default, and the two choices
+	// carry materially different operational constraints, so it is a pointer:
+	// there is no safe value to assume on the caller's behalf, and leaving it
+	// unset is rejected rather than silently resolved to the constraining mode.
+	IncludePayload *bool
+	// BuilderBoostFactor is the relative weight of the builder payload versus a locally-produced
+	// payload, as per https://ethereum.github.io/beacon-APIs/#/Validator/produceBlockV4
+	//
+	// This is optional, and when it is not supplied the parameter is left off the
+	// request entirely, leaving the choice to the node.  Note that differs from
+	// ProposalOpts, which materialises 100 client-side: the spec states no
+	// default for either endpoint, so sending nothing is what actually leaves the
+	// decision where the caller left it.
+	BuilderBoostFactor *uint64
+}

api/eventsopts.go

@@ -1,4 +1,4 @@
-// Copyright © 2025 Attestant Limited.
+// Copyright © 2025 - 2026 Attestant Limited.
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
@@ -21,6 +21,7 @@ import (
 	"github.com/attestantio/go-eth2-client/spec/altair"
 	"github.com/attestantio/go-eth2-client/spec/capella"
 	"github.com/attestantio/go-eth2-client/spec/electra"
+	"github.com/attestantio/go-eth2-client/spec/gloas"
 	"github.com/attestantio/go-eth2-client/spec/phase0"
 )
 
@@ -53,12 +54,28 @@ type EventsOpts struct {
 	ContributionAndProofHandler ContributionAndProofEventHandlerFunc
 	// DataColumnSidecarHandler is a handler for the data_column_sidecar event.
 	DataColumnSidecarHandler DataColumnSidecarEventHandlerFunc
+	// ExecutionPayloadHandler is a handler for the execution_payload event
+	// (SignedExecutionPayloadEnvelope successfully imported on the fork-choice).
+	ExecutionPayloadHandler ExecutionPayloadEventHandlerFunc
+	// ExecutionPayloadAvailableHandler is a handler for the execution_payload_available event.
+	ExecutionPayloadAvailableHandler ExecutionPayloadAvailableEventHandlerFunc
+	// ExecutionPayloadBidHandler is a handler for the execution_payload_bid event.
+	ExecutionPayloadBidHandler ExecutionPayloadBidEventHandlerFunc
+	// ExecutionPayloadGossipHandler is a handler for the execution_payload_gossip event
+	// (SignedExecutionPayloadEnvelope passed gossip validation).
+	ExecutionPayloadGossipHandler ExecutionPayloadGossipEventHandlerFunc
+	// FastConfirmationHandler is a handler for the fast_confirmation event.
+	FastConfirmationHandler FastConfirmationEventHandlerFunc
 	// FinalizedCheckpointHandler is a handler for the finalized_checkpoint event.
 	FinalizedCheckpointHandler FinalizedCheckpointEventHandlerFunc
 	// HeadHandler is a handler for the head event.
 	HeadHandler HeadEventHandlerFunc
+	// PayloadAttestationMessageHandler is a handler for the payload_attestation_message event.
+	PayloadAttestationMessageHandler PayloadAttestationMessageEventHandlerFunc
 	// PayloadAttributesHandler is a handler for the payload_attributes event.
 	PayloadAttributesHandler PayloadAttributesEventHandlerFunc
+	// ProposerPreferencesHandler is a handler for the proposer_preferences event.
+	ProposerPreferencesHandler ProposerPreferencesEventHandlerFunc
 	// ProposerSlashingHandler is a handler for the proposer_slashing event.
 	ProposerSlashingHandler ProposerSlashingEventHandlerFunc
 	// SingleAttestationHandler is a handler for the single_attestation event.
@@ -114,3 +131,24 @@ type VoluntaryExitEventHandlerFunc func(context.Context, *phase0.SignedVoluntary
 
 // DataColumnSidecarEventHandlerFunc is the handler for data_column_sidecar events.
 type DataColumnSidecarEventHandlerFunc func(context.Context, *apiv1.DataColumnSidecarEvent)
+
+// ExecutionPayloadEventHandlerFunc is the handler for execution_payload events.
+type ExecutionPayloadEventHandlerFunc func(context.Context, *apiv1.ExecutionPayloadEvent)
+
+// ExecutionPayloadAvailableEventHandlerFunc is the handler for execution_payload_available events.
+type ExecutionPayloadAvailableEventHandlerFunc func(context.Context, *apiv1.ExecutionPayloadAvailableEvent)
+
+// ExecutionPayloadBidEventHandlerFunc is the handler for execution_payload_bid events.
+type ExecutionPayloadBidEventHandlerFunc func(context.Context, *gloas.SignedExecutionPayloadBid)
+
+// ExecutionPayloadGossipEventHandlerFunc is the handler for execution_payload_gossip events.
+type ExecutionPayloadGossipEventHandlerFunc func(context.Context, *apiv1.ExecutionPayloadEvent)
+
+// FastConfirmationEventHandlerFunc is the handler for fast_confirmation events.
+type FastConfirmationEventHandlerFunc func(context.Context, *apiv1.FastConfirmationEvent)
+
+// PayloadAttestationMessageEventHandlerFunc is the handler for payload_attestation_message events.
+type PayloadAttestationMessageEventHandlerFunc func(context.Context, *gloas.PayloadAttestationMessage)
+
+// ProposerPreferencesEventHandlerFunc is the handler for proposer_preferences events.
+type ProposerPreferencesEventHandlerFunc func(context.Context, *gloas.SignedProposerPreferences)

api/executionpayloadenvelopeopts.go

@@ -0,0 +1,40 @@
+// Copyright © 2026 Attestant Limited.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package api
+
+import (
+	"github.com/attestantio/go-eth2-client/spec/phase0"
+)
+
+// ExecutionPayloadEnvelopeOpts are the options for obtaining the execution
+// payload envelope a node cached while producing a block.
+//
+// This is the other half of asking for a proposal with the payload excluded: the
+// node kept the envelope, and this is how the caller retrieves it to sign and
+// publish.
+type ExecutionPayloadEnvelopeOpts struct {
+	Common CommonOpts
+
+	// Slot is the slot for which the envelope was built.
+	Slot phase0.Slot
+	// BeaconBlockRoot is the root of the beacon block the envelope commits to.
+	//
+	// Passing it makes the lookup re-org resistant: if a re-org happens between
+	// producing the block and retrieving the envelope, the caller gets nothing
+	// rather than an envelope committed to a block that is no longer on the
+	// chain.  The node is expected to check the cached envelope against it, and
+	// the returned envelope's own root is checked against it again here, so a
+	// node that does not is caught rather than trusted.
+	BeaconBlockRoot phase0.Root
+}

api/payloadattestationdataopts.go

@@ -0,0 +1,24 @@
+// Copyright © 2026 Attestant Limited.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package api
+
+import "github.com/attestantio/go-eth2-client/spec/phase0"
+
+// PayloadAttestationDataOpts are the options for obtaining payload attestation data.
+type PayloadAttestationDataOpts struct {
+	Common CommonOpts
+
+	// Slot is the slot for which the data is obtained.
+	Slot phase0.Slot
+}

api/payloadattestationpoolopts.go

@@ -0,0 +1,26 @@
+// Copyright © 2026 Attestant Limited.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package api
+
+import "github.com/attestantio/go-eth2-client/spec/phase0"
+
+// PayloadAttestationPoolOpts are the options for obtaining the payload attestation pool.
+type PayloadAttestationPoolOpts struct {
+	Common CommonOpts
+
+	// Slot is the slot for which the data is obtained.  If not present then
+	// data for all slots will be obtained.  Note that some beacon nodes
+	// require a slot and will reject a request without one.
+	Slot *phase0.Slot
+}

api/ptcdutiesopts.go

@@ -0,0 +1,26 @@
+// Copyright © 2026 Attestant Limited.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package api
+
+import "github.com/attestantio/go-eth2-client/spec/phase0"
+
+// PTCDutiesOpts are the options for obtaining payload timeliness committee duties.
+type PTCDutiesOpts struct {
+	Common CommonOpts
+
+	// Epoch is the epoch for which the data is obtained.
+	Epoch phase0.Epoch
+	// Indices is a list of validators for which to obtain the duties.
+	Indices []phase0.ValidatorIndex
+}

api/signedexecutionpayloadenvelopeopts.go

@@ -0,0 +1,22 @@
+// Copyright © 2026 Attestant Limited.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package api
+
+// SignedExecutionPayloadEnvelopeOpts are the options for obtaining signed execution payload envelopes.
+type SignedExecutionPayloadEnvelopeOpts struct {
+	Common CommonOpts
+
+	// Block is the ID of the block which the data is obtained.
+	Block string
+}

api/submitexecutionpayloadbidopts.go

@@ -0,0 +1,28 @@
+// Copyright © 2026 Attestant Limited.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package api
+
+import (
+	"github.com/attestantio/go-eth2-client/spec"
+)
+
+// SubmitExecutionPayloadBidOpts are the options for submitting execution
+// payload bids.
+type SubmitExecutionPayloadBidOpts struct {
+	Common CommonOpts
+
+	// SignedExecutionPayloadBid is the signed bid to publish. Its Version
+	// selects the wire schema and the consensus version header.
+	SignedExecutionPayloadBid *spec.VersionedSignedExecutionPayloadBid
+}