v1

package
v3.2.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 6, 2023 License: GPL-3.0 Imports: 10 Imported by: 1

Documentation

Overview

Package v1 defines mappings of types as defined by the web3signer official specification for its v1 version i.e. /api/v1/eth2 

Web3Signer Specs are found by searching Consensys' Web3Signer API specification

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AggregateAndProof 

type AggregateAndProof struct {
	AggregatorIndex string        `json:"aggregator_index"` /* uint64 */
	Aggregate       *Attestation  `json:"aggregate"`
	SelectionProof  hexutil.Bytes `json:"selection_proof"` /* 96 bytes */
}

AggregateAndProof a sub property of AggregateAndProofSignRequest.

func MapAggregateAndProof 

func MapAggregateAndProof(from *ethpb.AggregateAttestationAndProof) (*AggregateAndProof, error)

MapAggregateAndProof maps the eth2.AggregateAndProof proto to the Web3Signer spec.

type AggregateAndProofSignRequest 

type AggregateAndProofSignRequest struct {
	Type              string             `json:"type" validate:"required"`
	ForkInfo          *ForkInfo          `json:"fork_info" validate:"required"`
	SigningRoot       hexutil.Bytes      `json:"signingRoot"`
	AggregateAndProof *AggregateAndProof `json:"aggregate_and_proof" validate:"required"`
}

AggregateAndProofSignRequest is a request object for web3signer sign api.

func GetAggregateAndProofSignRequest 

func GetAggregateAndProofSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*AggregateAndProofSignRequest, error)

GetAggregateAndProofSignRequest maps the request for signing type AGGREGATE_AND_PROOF.

type AggregationSlot 

type AggregationSlot struct {
	Slot string `json:"slot"`
}

AggregationSlot a sub property of AggregationSlotSignRequest.

type AggregationSlotSignRequest 

type AggregationSlotSignRequest struct {
	Type            string           `json:"type" validate:"required"`
	ForkInfo        *ForkInfo        `json:"fork_info" validate:"required"`
	SigningRoot     hexutil.Bytes    `json:"signingRoot"`
	AggregationSlot *AggregationSlot `json:"aggregation_slot" validate:"required"`
}

AggregationSlotSignRequest is a request object for web3signer sign api.

func GetAggregationSlotSignRequest 

func GetAggregationSlotSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*AggregationSlotSignRequest, error)

GetAggregationSlotSignRequest maps the request for signing type AGGREGATION_SLOT.

type Attestation 

type Attestation struct {
	AggregationBits hexutil.Bytes    `json:"aggregation_bits"` /*hex bitlist*/
	Data            *AttestationData `json:"data"`
	Signature       hexutil.Bytes    `json:"signature"`
}

Attestation a sub property of AggregateAndProofSignRequest.

func MapAttestation 

func MapAttestation(attestation *ethpb.Attestation) (*Attestation, error)

MapAttestation maps the eth2.Attestation proto to the Web3Signer spec.

type AttestationData 

type AttestationData struct {
	Slot            string        `json:"slot"`  /* uint64 */
	Index           string        `json:"index"` /* uint64 */ // Prysm uses CommitteeIndex but web3signer uses index.
	BeaconBlockRoot hexutil.Bytes `json:"beacon_block_root"`
	Source          *Checkpoint   `json:"source"`
	Target          *Checkpoint   `json:"target"`
}

AttestationData a sub property of Attestation.

func MapAttestationData 

func MapAttestationData(data *ethpb.AttestationData) (*AttestationData, error)

MapAttestationData maps the eth2.AttestationData proto to the Web3Signer spec.

type AttestationSignRequest 

type AttestationSignRequest struct {
	Type        string           `json:"type" validate:"required"`
	ForkInfo    *ForkInfo        `json:"fork_info" validate:"required"`
	SigningRoot hexutil.Bytes    `json:"signingRoot"`
	Attestation *AttestationData `json:"attestation" validate:"required"`
}

AttestationSignRequest is a request object for web3signer sign api.

func GetAttestationSignRequest 

func GetAttestationSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*AttestationSignRequest, error)

GetAttestationSignRequest maps the request for signing type ATTESTATION.

type AttesterSlashing 

type AttesterSlashing struct {
	Attestation1 *IndexedAttestation `json:"attestation_1"`
	Attestation2 *IndexedAttestation `json:"attestation_2"`
}

AttesterSlashing a sub property of BeaconBlockBody.

func MapAttesterSlashing 

func MapAttesterSlashing(slashing *ethpb.AttesterSlashing) (*AttesterSlashing, error)

MapAttesterSlashing maps the eth2.AttesterSlashing proto to the Web3Signer spec.

type BeaconBlock 

type BeaconBlock struct {
	Slot          string           `json:"slot"`           /* uint64 */
	ProposerIndex string           `json:"proposer_index"` /* uint64 */
	ParentRoot    hexutil.Bytes    `json:"parent_root"`
	StateRoot     hexutil.Bytes    `json:"state_root"`
	Body          *BeaconBlockBody `json:"body"`
}

BeaconBlock a sub property of BeaconBlockBlockV2.

type BeaconBlockAltair 

type BeaconBlockAltair struct {
	Slot          string                 `json:"slot"`
	ProposerIndex string                 `json:"proposer_index"`
	ParentRoot    hexutil.Bytes          `json:"parent_root"`
	StateRoot     hexutil.Bytes          `json:"state_root"`
	Body          *BeaconBlockBodyAltair `json:"body"`
}

BeaconBlockAltair a sub property of BeaconBlockAltairBlockV2.

func MapBeaconBlockAltair 

func MapBeaconBlockAltair(block *ethpb.BeaconBlockAltair) (*BeaconBlockAltair, error)

MapBeaconBlockAltair maps the eth2.BeaconBlockAltair proto to the Web3Signer spec.

type BeaconBlockAltairBlockV2 

type BeaconBlockAltairBlockV2 struct {
	Version string             `json:"version" enum:"true"`
	Block   *BeaconBlockAltair `json:"block"`
}

BeaconBlockAltairBlockV2 a sub property of BlockAltairSignRequest.

type BeaconBlockBlockV2 

type BeaconBlockBlockV2 struct {
	Version string       `json:"version" enum:"true"`
	Block   *BeaconBlock `json:"beacon_block"`
}

BeaconBlockBlockV2 a sub property of BlockV2SignRequest.

type BeaconBlockBody 

type BeaconBlockBody struct {
	RandaoReveal      hexutil.Bytes          `json:"randao_reveal"`
	Eth1Data          *Eth1Data              `json:"eth1_data"`
	Graffiti          hexutil.Bytes          `json:"graffiti"` // 32 bytes
	ProposerSlashings []*ProposerSlashing    `json:"proposer_slashings"`
	AttesterSlashings []*AttesterSlashing    `json:"attester_slashings"`
	Attestations      []*Attestation         `json:"attestations"`
	Deposits          []*Deposit             `json:"deposits"`
	VoluntaryExits    []*SignedVoluntaryExit `json:"voluntary_exits"`
}

BeaconBlockBody a sub property of BeaconBlock.

func MapBeaconBlockBody 

func MapBeaconBlockBody(body *ethpb.BeaconBlockBody) (*BeaconBlockBody, error)

MapBeaconBlockBody maps the eth2.BeaconBlockBody proto to the Web3Signer spec.

type BeaconBlockBodyAltair 

type BeaconBlockBodyAltair struct {
	RandaoReveal      hexutil.Bytes          `json:"randao_reveal"`
	Eth1Data          *Eth1Data              `json:"eth1_data"`
	Graffiti          hexutil.Bytes          `json:"graffiti"` /* Hash32 */
	ProposerSlashings []*ProposerSlashing    `json:"proposer_slashings"`
	AttesterSlashings []*AttesterSlashing    `json:"attester_slashings"`
	Attestations      []*Attestation         `json:"attestations"`
	Deposits          []*Deposit             `json:"deposits"`
	VoluntaryExits    []*SignedVoluntaryExit `json:"voluntary_exits"`
	SyncAggregate     *SyncAggregate         `json:"sync_aggregate"`
}

BeaconBlockBodyAltair a sub property of BeaconBlockAltair.

func MapBeaconBlockBodyAltair 

func MapBeaconBlockBodyAltair(body *ethpb.BeaconBlockBodyAltair) (*BeaconBlockBodyAltair, error)

MapBeaconBlockBodyAltair maps the eth2.BeaconBlockBodyAltair proto to the Web3Signer spec.

type BeaconBlockHeader 

type BeaconBlockHeader struct {
	Slot          string        `json:"slot"`           /* uint64 */
	ProposerIndex string        `json:"proposer_index"` /* uint64 */
	ParentRoot    hexutil.Bytes `json:"parent_root"`    /* Hash32 */
	StateRoot     hexutil.Bytes `json:"state_root"`     /* Hash32 */
	BodyRoot      hexutil.Bytes `json:"body_root"`      /* Hash32 */
}

BeaconBlockHeader is a sub property of SignedBeaconBlockHeader.

type BeaconBlockV2Blinded added in v3.2.2 

type BeaconBlockV2Blinded struct {
	Version     string             `json:"version" enum:"true"`
	BlockHeader *BeaconBlockHeader `json:"block_header"`
}

BeaconBlockV2Blinded a field of BlockV2BlindedSignRequest. Supports Bellatrix(merge) and Capella

type BlockAltairSignRequest 

type BlockAltairSignRequest struct {
	Type        string                    `json:"type" validate:"required"`
	ForkInfo    *ForkInfo                 `json:"fork_info" validate:"required"`
	SigningRoot hexutil.Bytes             `json:"signingRoot"`
	BeaconBlock *BeaconBlockAltairBlockV2 `json:"beacon_block" validate:"required"`
}

BlockAltairSignRequest is a request object for web3signer sign api.

func GetBlockAltairSignRequest 

func GetBlockAltairSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*BlockAltairSignRequest, error)

GetBlockAltairSignRequest maps the request for signing type BLOCK_V2.

type BlockSignRequest 

type BlockSignRequest struct {
	Type        string        `json:"type" validate:"required"`
	ForkInfo    *ForkInfo     `json:"fork_info" validate:"required"`
	SigningRoot hexutil.Bytes `json:"signingRoot"`
	Block       *BeaconBlock  `json:"block" validate:"required"`
}

BlockSignRequest is a request object for web3signer sign api.

func GetBlockSignRequest 

func GetBlockSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*BlockSignRequest, error)

GetBlockSignRequest maps the request for signing type BLOCK.

type BlockV2BlindedSignRequest added in v3.2.2 

type BlockV2BlindedSignRequest struct {
	Type        string                `json:"type" validate:"required"`
	ForkInfo    *ForkInfo             `json:"fork_info" validate:"required"`
	SigningRoot hexutil.Bytes         `json:"signingRoot"`
	BeaconBlock *BeaconBlockV2Blinded `json:"beacon_block" validate:"required"`
}

BlockV2BlindedSignRequest is a request object for web3signer sign api Supports Bellatrix(merge) and Capella

func GetBlockV2BlindedSignRequest added in v3.2.2 

func GetBlockV2BlindedSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*BlockV2BlindedSignRequest, error)

GetBlockV2BlindedSignRequest maps the request for signing types Supports Bellatrix and Capella

type Checkpoint 

type Checkpoint struct {
	Epoch string `json:"epoch"`
	Root  string `json:"root"`
}

Checkpoint a sub property of AttestationData.

func MapCheckPoint 

func MapCheckPoint(checkpoint *ethpb.Checkpoint) (*Checkpoint, error)

MapCheckPoint maps the eth2.Checkpoint proto to the Web3Signer spec.

type ContributionAndProof 

type ContributionAndProof struct {
	AggregatorIndex string                     `json:"aggregator_index"` /* uint64 */
	SelectionProof  hexutil.Bytes              `json:"selection_proof"`  /* 96 byte hexadecimal */
	Contribution    *SyncCommitteeContribution `json:"contribution"`
}

ContributionAndProof a sub property of AggregatorSelectionSignRequest.

func MapContributionAndProof 

func MapContributionAndProof(contribution *ethpb.ContributionAndProof) (*ContributionAndProof, error)

MapContributionAndProof maps the eth2.ContributionAndProof proto to the Web3Signer spec.

type Deposit 

type Deposit struct {
	Proof []string     `json:"proof"`
	Data  *DepositData `json:"data"`
}

Deposit a sub property of DepositSignRequest.

func MapDeposit 

func MapDeposit(deposit *ethpb.Deposit) (*Deposit, error)

MapDeposit maps the eth2.Deposit proto to the Web3Signer spec.

type DepositData 

type DepositData struct {
	PublicKey             hexutil.Bytes `json:"pubkey"`
	WithdrawalCredentials hexutil.Bytes `json:"withdrawal_credentials"`
	Amount                string        `json:"amount"` /* uint64 */
	Signature             hexutil.Bytes `json:"signature"`
}

DepositData a sub property of Deposit. DepositData Prysm uses Deposit_data instead of DepositData which is inconsistent naming

type Eth1Data 

type Eth1Data struct {
	DepositRoot  hexutil.Bytes `json:"deposit_root"`
	DepositCount string        `json:"deposit_count"` /* uint64 */
	BlockHash    hexutil.Bytes `json:"block_hash"`
}

Eth1Data a sub property of BeaconBlockBody.

type Fork 

type Fork struct {
	PreviousVersion hexutil.Bytes `json:"previous_version"`
	CurrentVersion  hexutil.Bytes `json:"current_version"`
	Epoch           string        `json:"epoch"` /*uint64*/
}

Fork a sub property of ForkInfo.

type ForkInfo 

type ForkInfo struct {
	Fork                  *Fork         `json:"fork"`
	GenesisValidatorsRoot hexutil.Bytes `json:"genesis_validators_root"`
}

ForkInfo a sub property object of the Sign request

func MapForkInfo 

func MapForkInfo(slot primitives.Slot, genesisValidatorsRoot []byte) (*ForkInfo, error)

MapForkInfo maps the eth2.ForkInfo proto to the Web3Signer spec.

type IndexedAttestation 

type IndexedAttestation struct {
	AttestingIndices []string         `json:"attesting_indices"` /* uint64[] */
	Data             *AttestationData `json:"data"`
	Signature        hexutil.Bytes    `json:"signature"`
}

IndexedAttestation a sub property of AttesterSlashing.

func MapIndexedAttestation 

func MapIndexedAttestation(attestation *ethpb.IndexedAttestation) (*IndexedAttestation, error)

MapIndexedAttestation maps the eth2.IndexedAttestation proto to the Web3Signer spec.

type ProposerSlashing 

type ProposerSlashing struct {
	// Prysm uses Header_1 but web3signer uses signed_header_1.
	Signedheader1 *SignedBeaconBlockHeader `json:"signed_header_1"`
	// Prysm uses Header_2 but web3signer uses signed_header_2.
	Signedheader2 *SignedBeaconBlockHeader `json:"signed_header_2"`
}

ProposerSlashing a sub property of BeaconBlockBody.

func MapProposerSlashing 

func MapProposerSlashing(slashing *ethpb.ProposerSlashing) (*ProposerSlashing, error)

MapProposerSlashing maps the eth2.ProposerSlashing proto to the Web3Signer spec.

type RandaoReveal 

type RandaoReveal struct {
	Epoch string `json:"epoch"` /* uint64 */
}

RandaoReveal a sub property of RandaoRevealSignRequest.

type RandaoRevealSignRequest 

type RandaoRevealSignRequest struct {
	Type         string        `json:"type" validate:"required"`
	ForkInfo     *ForkInfo     `json:"fork_info" validate:"required"`
	SigningRoot  hexutil.Bytes `json:"signingRoot"`
	RandaoReveal *RandaoReveal `json:"randao_reveal" validate:"required"`
}

RandaoRevealSignRequest is a request object for web3signer sign api.

func GetRandaoRevealSignRequest 

func GetRandaoRevealSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*RandaoRevealSignRequest, error)

GetRandaoRevealSignRequest maps the request for signing type RANDAO_REVEAL.

type SignedBeaconBlockHeader 

type SignedBeaconBlockHeader struct {
	Message   *BeaconBlockHeader `json:"message"`
	Signature hexutil.Bytes      `json:"signature"`
}

SignedBeaconBlockHeader is a sub property of ProposerSlashing.

func MapSignedBeaconBlockHeader 

func MapSignedBeaconBlockHeader(signedHeader *ethpb.SignedBeaconBlockHeader) (*SignedBeaconBlockHeader, error)

MapSignedBeaconBlockHeader maps the eth2.AttesterSlashing proto to the Web3Signer spec.

type SignedVoluntaryExit 

type SignedVoluntaryExit struct {
	// Prysm uses Exit instead of Message
	Message   *VoluntaryExit `json:"message"`
	Signature hexutil.Bytes  `json:"signature"`
}

SignedVoluntaryExit is a sub property of BeaconBlockBody.

func MapSignedVoluntaryExit 

func MapSignedVoluntaryExit(signedVoluntaryExit *ethpb.SignedVoluntaryExit) (*SignedVoluntaryExit, error)

MapSignedVoluntaryExit maps the eth2.SignedVoluntaryExit proto to the Web3Signer spec.

type SyncAggregate 

type SyncAggregate struct {
	SyncCommitteeBits      hexutil.Bytes `json:"sync_committee_bits"`      /* SSZ hexadecimal string */
	SyncCommitteeSignature hexutil.Bytes `json:"sync_committee_signature"` /* 96 byte hexadecimal string */
}

SyncAggregate is a sub property of BeaconBlockBodyAltair.

type SyncAggregatorSelectionData 

type SyncAggregatorSelectionData struct {
	Slot              string `json:"slot"`               /* uint64 */
	SubcommitteeIndex string `json:"subcommittee_index"` /* uint64 */
}

SyncAggregatorSelectionData a sub property of SyncAggregatorSelectionSignRequest.

func MapSyncAggregatorSelectionData 

func MapSyncAggregatorSelectionData(data *ethpb.SyncAggregatorSelectionData) (*SyncAggregatorSelectionData, error)

MapSyncAggregatorSelectionData maps the eth2.SyncAggregatorSelectionData proto to the Web3Signer spec.

type SyncCommitteeContribution 

type SyncCommitteeContribution struct {
	Slot              string        `json:"slot"`               /* uint64 */
	BeaconBlockRoot   hexutil.Bytes `json:"beacon_block_root"`  /* Hash32 */ // Prysm uses BlockRoot instead of BeaconBlockRoot
	SubcommitteeIndex string        `json:"subcommittee_index"` /* uint64 */
	AggregationBits   hexutil.Bytes `json:"aggregation_bits"`   /* SSZ hexadecimal string */
	Signature         hexutil.Bytes `json:"signature"`          /* 96 byte hexadecimal string */
}

SyncCommitteeContribution a sub property of AggregatorSelectionSignRequest.

type SyncCommitteeContributionAndProofSignRequest 

type SyncCommitteeContributionAndProofSignRequest struct {
	Type                 string                `json:"type" validate:"required"`
	ForkInfo             *ForkInfo             `json:"fork_info" validate:"required"`
	SigningRoot          hexutil.Bytes         `json:"signingRoot"`
	ContributionAndProof *ContributionAndProof `json:"contribution_and_proof" validate:"required"`
}

SyncCommitteeContributionAndProofSignRequest is a request object for web3signer sign api.

func GetSyncCommitteeContributionAndProofSignRequest 

func GetSyncCommitteeContributionAndProofSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*SyncCommitteeContributionAndProofSignRequest, error)

GetSyncCommitteeContributionAndProofSignRequest maps the request for signing type SYNC_COMMITTEE_CONTRIBUTION_AND_PROOF.

type SyncCommitteeMessage 

type SyncCommitteeMessage struct {
	BeaconBlockRoot hexutil.Bytes `json:"beacon_block_root"` /* Hash32 */
	Slot            string        `json:"slot"`              /* uint64 */

}

SyncCommitteeMessage a sub property of SyncCommitteeSignRequest.

type SyncCommitteeMessageSignRequest 

type SyncCommitteeMessageSignRequest struct {
	Type                 string                `json:"type" validate:"required"`
	ForkInfo             *ForkInfo             `json:"fork_info" validate:"required"`
	SigningRoot          hexutil.Bytes         `json:"signingRoot"`
	SyncCommitteeMessage *SyncCommitteeMessage `json:"sync_committee_message" validate:"required"`
}

SyncCommitteeMessageSignRequest is a request object for web3signer sign api.

func GetSyncCommitteeMessageSignRequest 

func GetSyncCommitteeMessageSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*SyncCommitteeMessageSignRequest, error)

GetSyncCommitteeMessageSignRequest maps the request for signing type SYNC_COMMITTEE_MESSAGE.

type SyncCommitteeSelectionProofSignRequest 

type SyncCommitteeSelectionProofSignRequest struct {
	Type                        string                       `json:"type" validate:"required"`
	ForkInfo                    *ForkInfo                    `json:"fork_info" validate:"required"`
	SigningRoot                 hexutil.Bytes                `json:"signingRoot"`
	SyncAggregatorSelectionData *SyncAggregatorSelectionData `json:"sync_aggregator_selection_data" validate:"required"`
}

SyncCommitteeSelectionProofSignRequest is a request object for web3signer sign api.

func GetSyncCommitteeSelectionProofSignRequest 

func GetSyncCommitteeSelectionProofSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*SyncCommitteeSelectionProofSignRequest, error)

GetSyncCommitteeSelectionProofSignRequest maps the request for signing type SYNC_COMMITTEE_SELECTION_PROOF.

type ValidatorRegistration 

type ValidatorRegistration struct {
	FeeRecipient hexutil.Bytes `json:"fee_recipient" validate:"required"` /* 42 hexadecimal string */
	GasLimit     string        `json:"gas_limit" validate:"required"`     /* uint64 */
	Timestamp    string        `json:"timestamp" validate:"required"`     /* uint64 */
	Pubkey       hexutil.Bytes `json:"pubkey"  validate:"required"`       /* bls hexadecimal string */
}

ValidatorRegistration a sub property of ValidatorRegistrationSignRequest

type ValidatorRegistrationSignRequest 

type ValidatorRegistrationSignRequest struct {
	Type                  string                 `json:"type" validate:"required"`
	SigningRoot           hexutil.Bytes          `json:"signingRoot"`
	ValidatorRegistration *ValidatorRegistration `json:"validator_registration" validate:"required"`
}

ValidatorRegistrationSignRequest a request object for web3signer sign api.

func GetValidatorRegistrationSignRequest 

func GetValidatorRegistrationSignRequest(request *validatorpb.SignRequest) (*ValidatorRegistrationSignRequest, error)

GetValidatorRegistrationSignRequest maps the request for signing type VALIDATOR_REGISTRATION.

type VoluntaryExit 

type VoluntaryExit struct {
	Epoch          string `json:"epoch"`           /* uint64 */
	ValidatorIndex string `json:"validator_index"` /* uint64 */
}

VoluntaryExit a sub property of SignedVoluntaryExit.

type VoluntaryExitSignRequest 

type VoluntaryExitSignRequest struct {
	Type          string         `json:"type" validate:"required"`
	ForkInfo      *ForkInfo      `json:"fork_info"`
	SigningRoot   hexutil.Bytes  `json:"signingRoot" validate:"required"`
	VoluntaryExit *VoluntaryExit `json:"voluntary_exit" validate:"required"`
}

VoluntaryExitSignRequest is a request object for web3signer sign api.

func GetVoluntaryExitSignRequest 

func GetVoluntaryExitSignRequest(request *validatorpb.SignRequest, genesisValidatorsRoot []byte) (*VoluntaryExitSignRequest, error)

GetVoluntaryExitSignRequest maps the request for signing type VOLUNTARY_EXIT.

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.