test(node-api): Introduce E2E tests for existing beacon endpoints

examples/berad/pkg/consensus-types/validator.go

@@ -37,15 +37,15 @@ type Validator struct {
 	// Pubkey is the validator's 48-byte BLS public key.
 	Pubkey crypto.BLSPubkey `json:"pubkey"`
 	// WithdrawalCredentials are an address that controls the validator.
-	WithdrawalCredentials types.WithdrawalCredentials `json:"withdrawalCredentials"`
+	WithdrawalCredentials types.WithdrawalCredentials `json:"withdrawal_credentials"`
 	// EffectiveBalance is the validator's current effective balance in gwei.
-	EffectiveBalance math.Gwei `json:"effectiveBalance"`
+	EffectiveBalance math.Gwei `json:"effective_balance"`
 	// ActivationEpoch is the epoch in which the validator activated.
-	ActivationEpoch math.Epoch `json:"activationEpoch"`
+	ActivationEpoch math.Epoch `json:"activation_epoch"`
 	// ExitEpoch is the epoch in which the validator exited.
-	ExitEpoch math.Epoch `json:"exitEpoch"`
+	ExitEpoch math.Epoch `json:"exit_epoch"`
 	// WithdrawableEpoch is the epoch in which the validator can withdraw.
-	WithdrawableEpoch math.Epoch `json:"withdrawableEpoch"`
+	WithdrawableEpoch math.Epoch `json:"withdrawable_epoch"`
 }
 
 /* -------------------------------------------------------------------------- */
@@ -233,3 +233,13 @@ func (v Validator) GetWithdrawableEpoch() math.Epoch {
 func (v Validator) GetWithdrawalCredentials() types.WithdrawalCredentials {
 	return v.WithdrawalCredentials
 }
+
+// GetActivationEpoch returns the activation epoch of the validator.
+func (v *Validator) GetActivationEpoch() math.Epoch {
+	return v.ActivationEpoch
+}
+
+// GetExitEpoch returns the exit epoch of the validator.
+func (v *Validator) GetExitEpoch() math.Epoch {
+	return v.ExitEpoch
+}

mod/consensus-types/go.mod

@@ -4,7 +4,7 @@ go 1.23.0
 
 require (
 	github.com/berachain/beacon-kit/mod/engine-primitives v0.0.0-20240808194557-e72e74f58197
-	github.com/berachain/beacon-kit/mod/errors v0.0.0-20240705193247-d464364483df
+	github.com/berachain/beacon-kit/mod/errors v0.0.0-20240806211103-d1105603bfc0
 	github.com/berachain/beacon-kit/mod/primitives v0.0.0-20240911165923-82f71ec86570
 	github.com/ferranbt/fastssz v0.1.4-0.20240629094022-eac385e6ee79
 	github.com/holiman/uint256 v1.3.1

mod/consensus-types/go.sum

@@ -12,8 +12,8 @@ github.com/berachain/beacon-kit/mod/chain-spec v0.0.0-20240705193247-d464364483d
 github.com/berachain/beacon-kit/mod/chain-spec v0.0.0-20240705193247-d464364483df/go.mod h1:bTFB4Rdvm7D/WdwPYkqQ+8T0XOMBv0pzXfp1E46BFX8=
 github.com/berachain/beacon-kit/mod/engine-primitives v0.0.0-20240808194557-e72e74f58197 h1:wVWkiiERY/7kaXvE/VNPPUtYp/l8ky6QSuKM3ThVMXU=
 github.com/berachain/beacon-kit/mod/engine-primitives v0.0.0-20240808194557-e72e74f58197/go.mod h1:LiOiqrJhhLH/GPo0XE5fel3EYyi7X6dwBOyTqZakTeQ=
-github.com/berachain/beacon-kit/mod/errors v0.0.0-20240705193247-d464364483df h1:6MJllcmMFt6dtvftM5zmdl1WVDpqZkNy3hFXVZtNV0s=
-github.com/berachain/beacon-kit/mod/errors v0.0.0-20240705193247-d464364483df/go.mod h1:yRD7rmnyaaqgq/6+eIVqvSkFJXuLXpBddUu59HUOrtc=
+github.com/berachain/beacon-kit/mod/errors v0.0.0-20240806211103-d1105603bfc0 h1:kCSrkb/uVXfMKJPKjf0c7nlJkwn5cNwMxtzRW4zNq2A=
+github.com/berachain/beacon-kit/mod/errors v0.0.0-20240806211103-d1105603bfc0/go.mod h1:og0jtHZosPDTyhge9tMBlRItoZ4Iv3aZFM9n4QDpcdo=
 github.com/berachain/beacon-kit/mod/geth-primitives v0.0.0-20240806160829-cde2d1347e7e h1:0/FDBXtagMkpta/f4J2uAah2NM1G+0dqxngzMzrmbw4=
 github.com/berachain/beacon-kit/mod/geth-primitives v0.0.0-20240806160829-cde2d1347e7e/go.mod h1:7/SXz8S5VpFl2thcKuBdu1OId+SgI1o4N+S1FB92Zw8=
 github.com/berachain/beacon-kit/mod/primitives v0.0.0-20240911165923-82f71ec86570 h1:w0Gkg31VQRFDv0EJjYgVtlpza7kSaJq7U28zxZjfZeE=

mod/consensus-types/pkg/types/fork.go

@@ -129,7 +129,7 @@ func (f *Fork) HashTreeRootWith(hh fastssz.HashWalker) error {
 	hh.PutBytes(f.CurrentVersion[:])
 
 	// Field (2) 'Epoch'
-	hh.PutUint64(uint64(f.Epoch))
+	hh.PutUint64(f.Epoch.Unwrap())
 
 	hh.Merkleize(indx)
 	return nil
@@ -139,3 +139,22 @@ func (f *Fork) HashTreeRootWith(hh fastssz.HashWalker) error {
 func (f *Fork) GetTree() (*fastssz.Node, error) {
 	return fastssz.ProofTree(f)
 }
+
+/* -------------------------------------------------------------------------- */
+/*                                 Getters                                    */
+/* -------------------------------------------------------------------------- */
+
+// GetPreviousVersion returns the previous version of the fork.
+func (f *Fork) GetPreviousVersion() common.Version {
+	return f.PreviousVersion
+}
+
+// GetCurrentVersion returns the current version of the fork.
+func (f *Fork) GetCurrentVersion() common.Version {
+	return f.CurrentVersion
+}
+
+// GetEpoch returns the epoch at which the fork occurred.
+func (f *Fork) GetEpoch() math.Epoch {
+	return f.Epoch
+}

mod/consensus-types/pkg/types/state_test.go

@@ -78,8 +78,10 @@ func generateValidBeaconState() *types.BeaconState[
 		},
 		Validators: []*types.Validator{
 			{
-				Pubkey:                     [48]byte{0x01},
-				WithdrawalCredentials:      [32]byte{0x02},
+				Pubkey: [48]byte{0x01},
+				WithdrawalCredentials: types.NewCredentialsFromExecutionAddress(
+					common.ExecutionAddress{0x02},
+				),
 				EffectiveBalance:           32000000000,
 				Slashed:                    false,
 				ActivationEligibilityEpoch: 1,
@@ -88,8 +90,10 @@ func generateValidBeaconState() *types.BeaconState[
 				WithdrawableEpoch:          18446744073709551615,
 			},
 			{
-				Pubkey:                     [48]byte{0x03},
-				WithdrawalCredentials:      [32]byte{0x04},
+				Pubkey: [48]byte{0x03},
+				WithdrawalCredentials: types.NewCredentialsFromExecutionAddress(
+					common.ExecutionAddress{0x04},
+				),
 				EffectiveBalance:           31000000000,
 				Slashed:                    true,
 				ActivationEligibilityEpoch: 3,

mod/consensus-types/pkg/types/validator.go

@@ -47,20 +47,20 @@ type Validator struct {
 	// Pubkey is the validator's 48-byte BLS public key.
 	Pubkey crypto.BLSPubkey `json:"pubkey"`
 	// WithdrawalCredentials are an address that controls the validator.
-	WithdrawalCredentials WithdrawalCredentials `json:"withdrawalCredentials"`
+	WithdrawalCredentials WithdrawalCredentials `json:"withdrawal_credentials"`
 	// EffectiveBalance is the validator's current effective balance in gwei.
-	EffectiveBalance math.Gwei `json:"effectiveBalance"`
+	EffectiveBalance math.Gwei `json:"effective_balance"`
 	// Slashed indicates whether the validator has been slashed.
 	Slashed bool `json:"slashed"`
 	// ActivationEligibilityEpoch is the epoch in which the validator became
 	// eligible for activation.
-	ActivationEligibilityEpoch math.Epoch `json:"activationEligibilityEpoch"`
+	ActivationEligibilityEpoch math.Epoch `json:"activation_eligibility_epoch"`
 	// ActivationEpoch is the epoch in which the validator activated.
-	ActivationEpoch math.Epoch `json:"activationEpoch"`
+	ActivationEpoch math.Epoch `json:"activation_epoch"`
 	// ExitEpoch is the epoch in which the validator exited.
-	ExitEpoch math.Epoch `json:"exitEpoch"`
+	ExitEpoch math.Epoch `json:"exit_epoch"`
 	// WithdrawableEpoch is the epoch in which the validator can withdraw.
-	WithdrawableEpoch math.Epoch `json:"withdrawableEpoch"`
+	WithdrawableEpoch math.Epoch `json:"withdrawable_epoch"`
 }
 
 /* -------------------------------------------------------------------------- */
@@ -226,15 +226,15 @@ func (v *Validator) GetEffectiveBalance() math.Gwei {
 // https://github.com/ethereum/consensus-specs/blob/dev/specs/phase0/beacon-chain.md#is_active_validator
 //
 //nolint:lll
-func (v Validator) IsActive(epoch math.Epoch) bool {
+func (v *Validator) IsActive(epoch math.Epoch) bool {
 	return v.ActivationEpoch <= epoch && epoch < v.ExitEpoch
 }
 
 // IsEligibleForActivation as defined in the Ethereum 2.0 Spec
 // https://github.com/ethereum/consensus-specs/blob/dev/specs/phase0/beacon-chain.md#is_eligible_for_activation_queue
 //
 //nolint:lll
-func (v Validator) IsEligibleForActivation(
+func (v *Validator) IsEligibleForActivation(
 	finalizedEpoch math.Epoch,
 ) bool {
 	return v.ActivationEligibilityEpoch <= finalizedEpoch &&
@@ -245,7 +245,7 @@ func (v Validator) IsEligibleForActivation(
 // https://github.com/ethereum/consensus-specs/blob/dev/specs/phase0/beacon-chain.md#is_eligible_for_activation_queue
 //
 //nolint:lll
-func (v Validator) IsEligibleForActivationQueue(
+func (v *Validator) IsEligibleForActivationQueue(
 	maxEffectiveBalance math.Gwei,
 ) bool {
 	return v.ActivationEligibilityEpoch == math.Epoch(
@@ -258,21 +258,21 @@ func (v Validator) IsEligibleForActivationQueue(
 // https://github.com/ethereum/consensus-specs/blob/dev/specs/phase0/beacon-chain.md#is_slashable_validator
 //
 //nolint:lll
-func (v Validator) IsSlashable(epoch math.Epoch) bool {
+func (v *Validator) IsSlashable(epoch math.Epoch) bool {
 	return !v.Slashed && v.ActivationEpoch <= epoch &&
 		epoch < v.WithdrawableEpoch
 }
 
 // IsSlashed returns whether the validator has been slashed.
-func (v Validator) IsSlashed() bool {
+func (v *Validator) IsSlashed() bool {
 	return v.Slashed
 }
 
 // IsFullyWithdrawable as defined in the Ethereum 2.0 specification:
 // https://github.com/ethereum/consensus-specs/blob/dev/specs/capella/beacon-chain.md#is_fully_withdrawable_validator
 //
 //nolint:lll
-func (v Validator) IsFullyWithdrawable(
+func (v *Validator) IsFullyWithdrawable(
 	balance math.Gwei,
 	epoch math.Epoch,
 ) bool {
@@ -284,7 +284,7 @@ func (v Validator) IsFullyWithdrawable(
 // https://github.com/ethereum/consensus-specs/blob/dev/specs/capella/beacon-chain.md#is_partially_withdrawable_validator
 //
 //nolint:lll
-func (v Validator) IsPartiallyWithdrawable(
+func (v *Validator) IsPartiallyWithdrawable(
 	balance, maxEffectiveBalance math.Gwei,
 ) bool {
 	hasExcessBalance := balance > maxEffectiveBalance
@@ -296,13 +296,13 @@ func (v Validator) IsPartiallyWithdrawable(
 // https://github.com/ethereum/consensus-specs/blob/dev/specs/capella/beacon-chain.md#has_eth1_withdrawal_credential
 //
 //nolint:lll
-func (v Validator) HasEth1WithdrawalCredentials() bool {
+func (v *Validator) HasEth1WithdrawalCredentials() bool {
 	return v.WithdrawalCredentials[0] == EthSecp256k1CredentialPrefix
 }
 
 // HasMaxEffectiveBalance determines if the validator has the maximum effective
 // balance.
-func (v Validator) HasMaxEffectiveBalance(
+func (v *Validator) HasMaxEffectiveBalance(
 	maxEffectiveBalance math.Gwei,
 ) bool {
 	return v.EffectiveBalance == maxEffectiveBalance
@@ -314,11 +314,27 @@ func (v *Validator) SetEffectiveBalance(balance math.Gwei) {
 }
 
 // GetWithdrawableEpoch returns the epoch when the validator can withdraw.
-func (v Validator) GetWithdrawableEpoch() math.Epoch {
+func (v *Validator) GetWithdrawableEpoch() math.Epoch {
 	return v.WithdrawableEpoch
 }
 
 // GetWithdrawalCredentials returns the withdrawal credentials of the validator.
-func (v Validator) GetWithdrawalCredentials() WithdrawalCredentials {
+func (v *Validator) GetWithdrawalCredentials() WithdrawalCredentials {
 	return v.WithdrawalCredentials
 }
+
+// GetActivationEligibilityEpoch returns the activation eligibility
+// epoch of the validator.
+func (v *Validator) GetActivationEligibilityEpoch() math.Epoch {
+	return v.ActivationEligibilityEpoch
+}
+
+// GetActivationEpoch returns the activation epoch of the validator.
+func (v *Validator) GetActivationEpoch() math.Epoch {
+	return v.ActivationEpoch
+}
+
+// GetExitEpoch returns the exit epoch of the validator.
+func (v *Validator) GetExitEpoch() math.Epoch {
+	return v.ExitEpoch
+}

mod/consensus-types/pkg/types/withdrawal_credentials.go

@@ -81,3 +81,8 @@ func (wc WithdrawalCredentials) MarshalText() ([]byte, error) {
 func (wc *WithdrawalCredentials) UnmarshalText(text []byte) error {
 	return (*common.Bytes32)(wc).UnmarshalText(text)
 }
+
+// Bytes returns the raw byte representation of the withdrawal credentials.
+func (wc WithdrawalCredentials) Bytes() []byte {
+	return wc[:]
+}