activation

package
v1.5.2-hotfix1 Latest Latest
Warning

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

Go to latest
Published: May 7, 2024 License: MIT Imports: 60 Imported by: 0

Documentation

Overview

Package activation is responsible for creating activation transactions and running the mining flow, coordinating Post building, sending proofs to PoET and building NIPost structs.

Package activation is a generated GoMock package.

Index

Constants

View Source
const DefaultPostServiceName = "service"

Variables

View Source
var (
	// ErrATXChallengeExpired is returned when atx missed its publication window and needs to be regenerated.
	ErrATXChallengeExpired = errors.New("builder: atx expired")
	// ErrPoetServiceUnstable is returned when poet quality of service is low.
	ErrPoetServiceUnstable = &PoetSvcUnstableError{}
	// ErrPoetProofNotReceived is returned when no poet proof was received.
	ErrPoetProofNotReceived = errors.New("builder: didn't receive any poet proof")
)
View Source
var (
	ErrPostClientClosed       = errors.New("post client closed")
	ErrPostClientNotConnected = errors.New("post service not registered")
)
View Source
var (
	ErrNotFound       = errors.New("not found")
	ErrUnavailable    = errors.New("unavailable")
	ErrInvalidRequest = errors.New("invalid request")
)
View Source
var ErrObjectExists = sql.ErrObjectExists
View Source
var VerifyChainOpts verifyChainOptsNs

Functions

func CheckPrevATXs added in v1.5.3

func CheckPrevATXs(ctx context.Context, logger *zap.Logger, db sql.Executor) error

func NewPostStates added in v1.4.0

func NewPostStates(log *zap.Logger) *postStates

func PostSubset added in v1.4.0

func PostSubset(seed []byte) validatorOption

PostSubset configures the validator to validate only a subset of the POST indices. The `seed` is used to randomize the selection of indices.

func SignAndFinalizeAtx added in v1.0.0

func SignAndFinalizeAtx(signer *signing.EdSigner, atx *types.ActivationTx) error

SignAndFinalizeAtx signs the atx with specified signer and calculates the ID of the ATX.

Types

type AtxBuilder added in v1.4.0

type AtxBuilder interface {
	Register(sig *signing.EdSigner)
}

type AtxReceiver added in v1.0.0

type AtxReceiver interface {
	OnAtx(*types.ActivationTxHeader)
}

type Builder

type Builder struct {
	// contains filtered or unexported fields
}

Builder struct is the struct that orchestrates the creation of activation transactions it is responsible for initializing post, receiving poet proof and orchestrating nipst. after which it will calculate total weight and providing relevant view as proof.

func NewBuilder

func NewBuilder(
	conf Config,
	db sql.Executor,
	localDB *localsql.Database,
	publisher pubsub.Publisher,
	nipostBuilder nipostBuilder,
	layerClock layerClock,
	syncer syncer,
	log *zap.Logger,
	opts ...BuilderOption,
) *Builder

NewBuilder returns an atx builder that will start a routine that will attempt to create an atx upon each new layer.

func (*Builder) BuildNIPostChallenge added in v1.4.0

func (b *Builder) BuildNIPostChallenge(ctx context.Context, nodeID types.NodeID) (*types.NIPostChallenge, error)

func (*Builder) Coinbase added in v1.0.0

func (b *Builder) Coinbase() types.Address

Coinbase returns the current coinbase address.

func (*Builder) GetPrevAtx

func (b *Builder) GetPrevAtx(nodeID types.NodeID) (*types.VerifiedActivationTx, error)

func (*Builder) PostStates added in v1.4.0

func (b *Builder) PostStates() map[types.IdentityDescriptor]types.PostState

PostState returns the current state of the post service for each registered smesher.

func (*Builder) PublishActivationTx

func (b *Builder) PublishActivationTx(ctx context.Context, sig *signing.EdSigner) error

PublishActivationTx attempts to publish an atx, it returns an error if an atx cannot be created.

func (*Builder) Register added in v1.4.0

func (b *Builder) Register(sig *signing.EdSigner)

func (*Builder) Regossip added in v1.1.10

func (b *Builder) Regossip(ctx context.Context, nodeID types.NodeID) error

func (*Builder) SetCoinbase added in v1.0.0

func (b *Builder) SetCoinbase(rewardAddress types.Address)

SetCoinbase sets the address rewardAddress to be the coinbase account written into the activation transaction the rewards for blocks made by this miner will go to this address.

func (*Builder) SmesherIDs added in v1.4.0

func (b *Builder) SmesherIDs() []types.NodeID

SmesherID returns the ID of the smesher that created this activation.

func (*Builder) Smeshing added in v1.0.0

func (b *Builder) Smeshing() bool

Smeshing returns true if atx builder is smeshing.

func (*Builder) StartSmeshing added in v1.0.0

func (b *Builder) StartSmeshing(coinbase types.Address) error

StartSmeshing is the main entry point of the atx builder. It runs the main loop of the builder in a new go-routine and shouldn't be called more than once without calling StopSmeshing in between. If the post data is incomplete or missing, data creation session will be preceded. Changing of the post options (e.g., number of labels), after initial setup, is supported. If data creation fails for any reason then the go-routine will panic.

func (*Builder) StopSmeshing added in v1.0.0

func (b *Builder) StopSmeshing(deleteFiles bool) error

StopSmeshing stops the atx builder.

type BuilderOption added in v1.0.0

type BuilderOption func(*Builder)

func WithContext added in v1.0.0

func WithContext(ctx context.Context) BuilderOption

WithContext modifies parent context for background job.

func WithPoetConfig added in v1.0.0

func WithPoetConfig(c PoetConfig) BuilderOption

WithPoetConfig sets the poet config.

func WithPoetRetryInterval added in v1.0.0

func WithPoetRetryInterval(interval time.Duration) BuilderOption

WithPoetRetryInterval modifies time that builder will have to wait before retrying ATX build process if it failed due to issues with PoET server.

func WithPostStates added in v1.4.0

func WithPostStates(ps PostStates) BuilderOption

func WithPostValidityDelay added in v1.4.0

func WithPostValidityDelay(delay time.Duration) BuilderOption

func WithValidator added in v1.0.3

func WithValidator(v nipostValidator) BuilderOption

type Config added in v0.1.28

type Config struct {
	GoldenATXID      types.ATXID
	LabelsPerUnit    uint64
	RegossipInterval time.Duration
}

Config defines configuration for Builder.

type ErrAtxNotFound

type ErrAtxNotFound struct {
	Id types.ATXID
	// contains filtered or unexported fields
}

func (*ErrAtxNotFound) Error added in v1.0.0

func (e *ErrAtxNotFound) Error() string

func (*ErrAtxNotFound) Is added in v1.0.0

func (e *ErrAtxNotFound) Is(target error) bool

func (*ErrAtxNotFound) Unwrap added in v1.0.0

func (e *ErrAtxNotFound) Unwrap() error

type HTTPPoetClient

type HTTPPoetClient struct {
	// contains filtered or unexported fields
}

HTTPPoetClient implements PoetProvingServiceClient interface.

func NewHTTPPoetClient

func NewHTTPPoetClient(server types.PoetServer, cfg PoetConfig, opts ...PoetClientOpts) (*HTTPPoetClient, error)

NewHTTPPoetClient returns new instance of HTTPPoetClient connecting to the specified url.

func (*HTTPPoetClient) Address added in v1.0.8

func (c *HTTPPoetClient) Address() string

func (*HTTPPoetClient) PowParams added in v1.0.0

func (c *HTTPPoetClient) PowParams(ctx context.Context) (*PoetPowParams, error)

func (*HTTPPoetClient) Proof added in v1.0.0

Proof implements PoetProvingServiceClient.

func (*HTTPPoetClient) Submit

func (c *HTTPPoetClient) Submit(
	ctx context.Context,
	deadline time.Time,
	prefix, challenge []byte,
	signature types.EdSignature,
	nodeID types.NodeID,
	pow PoetPoW,
) (*types.PoetRound, error)

Submit registers a challenge in the proving service current open round.

type Handler added in v1.0.0

type Handler struct {
	// contains filtered or unexported fields
}

Handler processes the atxs received from all nodes and their validity status.

func NewHandler added in v1.0.0

func NewHandler(
	local p2p.Peer,
	cdb *datastore.CachedDB,
	atxsdata *atxsdata.Data,
	edVerifier *signing.EdVerifier,
	c layerClock,
	pub pubsub.Publisher,
	fetcher system.Fetcher,
	tickSize uint64,
	goldenATXID types.ATXID,
	nipostValidator nipostValidator,
	beacon AtxReceiver,
	tortoise system.Tortoise,
	log log.Log,
) *Handler

NewHandler returns a data handler for ATX.

func (*Handler) ContextuallyValidateAtx added in v1.0.0

func (h *Handler) ContextuallyValidateAtx(atx *types.VerifiedActivationTx) error

ContextuallyValidateAtx ensures that the previous ATX referenced is the last known ATX for the referenced miner ID. If a previous ATX is not referenced, it validates that indeed there's no previous known ATX for that miner ID.

func (*Handler) HandleGossipAtx added in v1.0.0

func (h *Handler) HandleGossipAtx(ctx context.Context, peer p2p.Peer, msg []byte) error

HandleGossipAtx handles the atx gossip data channel.

func (*Handler) HandleSyncedAtx added in v1.1.0

func (h *Handler) HandleSyncedAtx(ctx context.Context, expHash types.Hash32, peer p2p.Peer, data []byte) error

HandleSyncedAtx handles atxs received by sync.

func (*Handler) Register added in v1.3.8

func (h *Handler) Register(sig *signing.EdSigner)

func (*Handler) SyntacticallyValidate added in v1.1.5

func (h *Handler) SyntacticallyValidate(ctx context.Context, atx *types.ActivationTx) error

func (*Handler) SyntacticallyValidateDeps added in v1.1.5

func (h *Handler) SyntacticallyValidateDeps(
	ctx context.Context,
	atx *types.ActivationTx,
) (*types.VerifiedActivationTx, *mwire.MalfeasanceProof, error)

type InvalidChainError added in v1.4.0

type InvalidChainError struct {
	ID types.ATXID
	// contains filtered or unexported fields
}

func (*InvalidChainError) Error added in v1.4.0

func (e *InvalidChainError) Error() string

func (*InvalidChainError) Is added in v1.4.0

func (e *InvalidChainError) Is(target error) bool

func (*InvalidChainError) Unwrap added in v1.4.0

func (e *InvalidChainError) Unwrap() error

type MockAtxBuilder added in v1.4.0

type MockAtxBuilder struct {
	// contains filtered or unexported fields
}

MockAtxBuilder is a mock of AtxBuilder interface.

func NewMockAtxBuilder added in v1.4.0

func NewMockAtxBuilder(ctrl *gomock.Controller) *MockAtxBuilder

NewMockAtxBuilder creates a new mock instance.

func (*MockAtxBuilder) EXPECT added in v1.4.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockAtxBuilder) Register added in v1.4.0

func (m *MockAtxBuilder) Register(sig *signing.EdSigner)

Register mocks base method.

type MockAtxBuilderMockRecorder added in v1.4.0

type MockAtxBuilderMockRecorder struct {
	// contains filtered or unexported fields
}

MockAtxBuilderMockRecorder is the mock recorder for MockAtxBuilder.

func (*MockAtxBuilderMockRecorder) Register added in v1.4.0

Register indicates an expected call of Register.

type MockAtxBuilderRegisterCall added in v1.4.0

type MockAtxBuilderRegisterCall struct {
	*gomock.Call
}

MockAtxBuilderRegisterCall wrap *gomock.Call

func (*MockAtxBuilderRegisterCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockAtxBuilderRegisterCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockAtxBuilderRegisterCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockAtxReceiver added in v1.0.0

type MockAtxReceiver struct {
	// contains filtered or unexported fields
}

MockAtxReceiver is a mock of AtxReceiver interface.

func NewMockAtxReceiver added in v1.0.0

func NewMockAtxReceiver(ctrl *gomock.Controller) *MockAtxReceiver

NewMockAtxReceiver creates a new mock instance.

func (*MockAtxReceiver) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockAtxReceiver) OnAtx added in v1.0.0

func (m *MockAtxReceiver) OnAtx(arg0 *types.ActivationTxHeader)

OnAtx mocks base method.

type MockAtxReceiverMockRecorder added in v1.0.0

type MockAtxReceiverMockRecorder struct {
	// contains filtered or unexported fields
}

MockAtxReceiverMockRecorder is the mock recorder for MockAtxReceiver.

func (*MockAtxReceiverMockRecorder) OnAtx added in v1.0.0

OnAtx indicates an expected call of OnAtx.

type MockAtxReceiverOnAtxCall added in v1.4.0

type MockAtxReceiverOnAtxCall struct {
	*gomock.Call
}

MockAtxReceiverOnAtxCall wrap *gomock.Call

func (*MockAtxReceiverOnAtxCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockAtxReceiverOnAtxCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockAtxReceiverOnAtxCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockPostClient added in v1.3.0

type MockPostClient struct {
	// contains filtered or unexported fields
}

MockPostClient is a mock of PostClient interface.

func NewMockPostClient added in v1.3.0

func NewMockPostClient(ctrl *gomock.Controller) *MockPostClient

NewMockPostClient creates a new mock instance.

func (*MockPostClient) EXPECT added in v1.3.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockPostClient) Info added in v1.3.0

func (m *MockPostClient) Info(ctx context.Context) (*types.PostInfo, error)

Info mocks base method.

func (*MockPostClient) Proof added in v1.3.0

func (m *MockPostClient) Proof(ctx context.Context, challenge []byte) (*types.Post, *types.PostInfo, error)

Proof mocks base method.

type MockPostClientInfoCall added in v1.4.0

type MockPostClientInfoCall struct {
	*gomock.Call
}

MockPostClientInfoCall wrap *gomock.Call

func (*MockPostClientInfoCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockPostClientInfoCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockPostClientInfoCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockPostClientMockRecorder added in v1.3.0

type MockPostClientMockRecorder struct {
	// contains filtered or unexported fields
}

MockPostClientMockRecorder is the mock recorder for MockPostClient.

func (*MockPostClientMockRecorder) Info added in v1.3.0

Info indicates an expected call of Info.

func (*MockPostClientMockRecorder) Proof added in v1.3.0

func (mr *MockPostClientMockRecorder) Proof(ctx, challenge any) *MockPostClientProofCall

Proof indicates an expected call of Proof.

type MockPostClientProofCall added in v1.4.0

type MockPostClientProofCall struct {
	*gomock.Call
}

MockPostClientProofCall wrap *gomock.Call

func (*MockPostClientProofCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockPostClientProofCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockPostClientProofCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockPostStates added in v1.4.0

type MockPostStates struct {
	// contains filtered or unexported fields
}

MockPostStates is a mock of PostStates interface.

func NewMockPostStates added in v1.4.0

func NewMockPostStates(ctrl *gomock.Controller) *MockPostStates

NewMockPostStates creates a new mock instance.

func (*MockPostStates) EXPECT added in v1.4.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockPostStates) Get added in v1.4.0

func (m *MockPostStates) Get() map[types.NodeID]types.PostState

Get mocks base method.

func (*MockPostStates) Set added in v1.4.0

func (m *MockPostStates) Set(id types.NodeID, state types.PostState)

Set mocks base method.

type MockPostStatesGetCall added in v1.4.0

type MockPostStatesGetCall struct {
	*gomock.Call
}

MockPostStatesGetCall wrap *gomock.Call

func (*MockPostStatesGetCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockPostStatesGetCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockPostStatesGetCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockPostStatesMockRecorder added in v1.4.0

type MockPostStatesMockRecorder struct {
	// contains filtered or unexported fields
}

MockPostStatesMockRecorder is the mock recorder for MockPostStates.

func (*MockPostStatesMockRecorder) Get added in v1.4.0

Get indicates an expected call of Get.

func (*MockPostStatesMockRecorder) Set added in v1.4.0

Set indicates an expected call of Set.

type MockPostStatesSetCall added in v1.4.0

type MockPostStatesSetCall struct {
	*gomock.Call
}

MockPostStatesSetCall wrap *gomock.Call

func (*MockPostStatesSetCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockPostStatesSetCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockPostStatesSetCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockPostVerifier added in v1.0.0

type MockPostVerifier struct {
	// contains filtered or unexported fields
}

MockPostVerifier is a mock of PostVerifier interface.

func NewMockPostVerifier added in v1.0.0

func NewMockPostVerifier(ctrl *gomock.Controller) *MockPostVerifier

NewMockPostVerifier creates a new mock instance.

func (*MockPostVerifier) Close added in v1.0.0

func (m *MockPostVerifier) Close() error

Close mocks base method.

func (*MockPostVerifier) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockPostVerifier) Verify added in v1.0.0

Verify mocks base method.

type MockPostVerifierCloseCall added in v1.4.0

type MockPostVerifierCloseCall struct {
	*gomock.Call
}

MockPostVerifierCloseCall wrap *gomock.Call

func (*MockPostVerifierCloseCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockPostVerifierCloseCall) DoAndReturn added in v1.4.0

func (c *MockPostVerifierCloseCall) DoAndReturn(f func() error) *MockPostVerifierCloseCall

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockPostVerifierCloseCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockPostVerifierMockRecorder added in v1.0.0

type MockPostVerifierMockRecorder struct {
	// contains filtered or unexported fields
}

MockPostVerifierMockRecorder is the mock recorder for MockPostVerifier.

func (*MockPostVerifierMockRecorder) Close added in v1.0.0

Close indicates an expected call of Close.

func (*MockPostVerifierMockRecorder) Verify added in v1.0.0

func (mr *MockPostVerifierMockRecorder) Verify(ctx, p, m any, opts ...any) *MockPostVerifierVerifyCall

Verify indicates an expected call of Verify.

type MockPostVerifierVerifyCall added in v1.4.0

type MockPostVerifierVerifyCall struct {
	*gomock.Call
}

MockPostVerifierVerifyCall wrap *gomock.Call

func (*MockPostVerifierVerifyCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockPostVerifierVerifyCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockPostVerifierVerifyCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockSmeshingProvider added in v1.0.0

type MockSmeshingProvider struct {
	// contains filtered or unexported fields
}

MockSmeshingProvider is a mock of SmeshingProvider interface.

func NewMockSmeshingProvider added in v1.0.0

func NewMockSmeshingProvider(ctrl *gomock.Controller) *MockSmeshingProvider

NewMockSmeshingProvider creates a new mock instance.

func (*MockSmeshingProvider) Coinbase added in v1.0.0

func (m *MockSmeshingProvider) Coinbase() types.Address

Coinbase mocks base method.

func (*MockSmeshingProvider) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockSmeshingProvider) SetCoinbase added in v1.0.0

func (m *MockSmeshingProvider) SetCoinbase(coinbase types.Address)

SetCoinbase mocks base method.

func (*MockSmeshingProvider) SmesherIDs added in v1.4.0

func (m *MockSmeshingProvider) SmesherIDs() []types.NodeID

SmesherIDs mocks base method.

func (*MockSmeshingProvider) Smeshing added in v1.0.0

func (m *MockSmeshingProvider) Smeshing() bool

Smeshing mocks base method.

func (*MockSmeshingProvider) StartSmeshing added in v1.0.0

func (m *MockSmeshingProvider) StartSmeshing(arg0 types.Address) error

StartSmeshing mocks base method.

func (*MockSmeshingProvider) StopSmeshing added in v1.0.0

func (m *MockSmeshingProvider) StopSmeshing(arg0 bool) error

StopSmeshing mocks base method.

type MockSmeshingProviderCoinbaseCall added in v1.4.0

type MockSmeshingProviderCoinbaseCall struct {
	*gomock.Call
}

MockSmeshingProviderCoinbaseCall wrap *gomock.Call

func (*MockSmeshingProviderCoinbaseCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockSmeshingProviderCoinbaseCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockSmeshingProviderCoinbaseCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockSmeshingProviderMockRecorder added in v1.0.0

type MockSmeshingProviderMockRecorder struct {
	// contains filtered or unexported fields
}

MockSmeshingProviderMockRecorder is the mock recorder for MockSmeshingProvider.

func (*MockSmeshingProviderMockRecorder) Coinbase added in v1.0.0

Coinbase indicates an expected call of Coinbase.

func (*MockSmeshingProviderMockRecorder) SetCoinbase added in v1.0.0

SetCoinbase indicates an expected call of SetCoinbase.

func (*MockSmeshingProviderMockRecorder) SmesherIDs added in v1.4.0

SmesherIDs indicates an expected call of SmesherIDs.

func (*MockSmeshingProviderMockRecorder) Smeshing added in v1.0.0

Smeshing indicates an expected call of Smeshing.

func (*MockSmeshingProviderMockRecorder) StartSmeshing added in v1.0.0

StartSmeshing indicates an expected call of StartSmeshing.

func (*MockSmeshingProviderMockRecorder) StopSmeshing added in v1.0.0

StopSmeshing indicates an expected call of StopSmeshing.

type MockSmeshingProviderSetCoinbaseCall added in v1.4.0

type MockSmeshingProviderSetCoinbaseCall struct {
	*gomock.Call
}

MockSmeshingProviderSetCoinbaseCall wrap *gomock.Call

func (*MockSmeshingProviderSetCoinbaseCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockSmeshingProviderSetCoinbaseCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockSmeshingProviderSetCoinbaseCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockSmeshingProviderSmesherIDsCall added in v1.4.0

type MockSmeshingProviderSmesherIDsCall struct {
	*gomock.Call
}

MockSmeshingProviderSmesherIDsCall wrap *gomock.Call

func (*MockSmeshingProviderSmesherIDsCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockSmeshingProviderSmesherIDsCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockSmeshingProviderSmesherIDsCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockSmeshingProviderSmeshingCall added in v1.4.0

type MockSmeshingProviderSmeshingCall struct {
	*gomock.Call
}

MockSmeshingProviderSmeshingCall wrap *gomock.Call

func (*MockSmeshingProviderSmeshingCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockSmeshingProviderSmeshingCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockSmeshingProviderSmeshingCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockSmeshingProviderStartSmeshingCall added in v1.4.0

type MockSmeshingProviderStartSmeshingCall struct {
	*gomock.Call
}

MockSmeshingProviderStartSmeshingCall wrap *gomock.Call

func (*MockSmeshingProviderStartSmeshingCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockSmeshingProviderStartSmeshingCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockSmeshingProviderStartSmeshingCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockSmeshingProviderStopSmeshingCall added in v1.4.0

type MockSmeshingProviderStopSmeshingCall struct {
	*gomock.Call
}

MockSmeshingProviderStopSmeshingCall wrap *gomock.Call

func (*MockSmeshingProviderStopSmeshingCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockSmeshingProviderStopSmeshingCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockSmeshingProviderStopSmeshingCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockatxProvider added in v1.0.0

type MockatxProvider struct {
	// contains filtered or unexported fields
}

MockatxProvider is a mock of atxProvider interface.

func NewMockatxProvider added in v1.0.0

func NewMockatxProvider(ctrl *gomock.Controller) *MockatxProvider

NewMockatxProvider creates a new mock instance.

func (*MockatxProvider) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockatxProvider) GetAtxHeader added in v1.0.0

func (m *MockatxProvider) GetAtxHeader(id types.ATXID) (*types.ActivationTxHeader, error)

GetAtxHeader mocks base method.

type MockatxProviderGetAtxHeaderCall added in v1.4.0

type MockatxProviderGetAtxHeaderCall struct {
	*gomock.Call
}

MockatxProviderGetAtxHeaderCall wrap *gomock.Call

func (*MockatxProviderGetAtxHeaderCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockatxProviderGetAtxHeaderCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockatxProviderGetAtxHeaderCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockatxProviderMockRecorder added in v1.0.0

type MockatxProviderMockRecorder struct {
	// contains filtered or unexported fields
}

MockatxProviderMockRecorder is the mock recorder for MockatxProvider.

func (*MockatxProviderMockRecorder) GetAtxHeader added in v1.0.0

GetAtxHeader indicates an expected call of GetAtxHeader.

type MocklayerClock added in v1.0.0

type MocklayerClock struct {
	// contains filtered or unexported fields
}

MocklayerClock is a mock of layerClock interface.

func NewMocklayerClock added in v1.0.0

func NewMocklayerClock(ctrl *gomock.Controller) *MocklayerClock

NewMocklayerClock creates a new mock instance.

func (*MocklayerClock) AwaitLayer added in v1.0.0

func (m *MocklayerClock) AwaitLayer(layerID types.LayerID) <-chan struct{}

AwaitLayer mocks base method.

func (*MocklayerClock) CurrentLayer added in v1.0.0

func (m *MocklayerClock) CurrentLayer() types.LayerID

CurrentLayer mocks base method.

func (*MocklayerClock) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MocklayerClock) LayerToTime added in v1.0.0

func (m *MocklayerClock) LayerToTime(arg0 types.LayerID) time.Time

LayerToTime mocks base method.

type MocklayerClockAwaitLayerCall added in v1.4.0

type MocklayerClockAwaitLayerCall struct {
	*gomock.Call
}

MocklayerClockAwaitLayerCall wrap *gomock.Call

func (*MocklayerClockAwaitLayerCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocklayerClockAwaitLayerCall) DoAndReturn added in v1.4.0

func (c *MocklayerClockAwaitLayerCall) DoAndReturn(f func(types.LayerID) <-chan struct{}) *MocklayerClockAwaitLayerCall

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocklayerClockAwaitLayerCall) Return added in v1.4.0

func (c *MocklayerClockAwaitLayerCall) Return(arg0 <-chan struct{}) *MocklayerClockAwaitLayerCall

Return rewrite *gomock.Call.Return

type MocklayerClockCurrentLayerCall added in v1.4.0

type MocklayerClockCurrentLayerCall struct {
	*gomock.Call
}

MocklayerClockCurrentLayerCall wrap *gomock.Call

func (*MocklayerClockCurrentLayerCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocklayerClockCurrentLayerCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocklayerClockCurrentLayerCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocklayerClockLayerToTimeCall added in v1.4.0

type MocklayerClockLayerToTimeCall struct {
	*gomock.Call
}

MocklayerClockLayerToTimeCall wrap *gomock.Call

func (*MocklayerClockLayerToTimeCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocklayerClockLayerToTimeCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocklayerClockLayerToTimeCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocklayerClockMockRecorder added in v1.0.0

type MocklayerClockMockRecorder struct {
	// contains filtered or unexported fields
}

MocklayerClockMockRecorder is the mock recorder for MocklayerClock.

func (*MocklayerClockMockRecorder) AwaitLayer added in v1.0.0

AwaitLayer indicates an expected call of AwaitLayer.

func (*MocklayerClockMockRecorder) CurrentLayer added in v1.0.0

CurrentLayer indicates an expected call of CurrentLayer.

func (*MocklayerClockMockRecorder) LayerToTime added in v1.0.0

LayerToTime indicates an expected call of LayerToTime.

type MocknipostBuilder added in v1.0.0

type MocknipostBuilder struct {
	// contains filtered or unexported fields
}

MocknipostBuilder is a mock of nipostBuilder interface.

func NewMocknipostBuilder added in v1.0.0

func NewMocknipostBuilder(ctrl *gomock.Controller) *MocknipostBuilder

NewMocknipostBuilder creates a new mock instance.

func (*MocknipostBuilder) BuildNIPost added in v1.0.0

func (m *MocknipostBuilder) BuildNIPost(ctx context.Context, sig *signing.EdSigner, publish types.EpochID, challenge types.Hash32) (*nipost.NIPostState, error)

BuildNIPost mocks base method.

func (*MocknipostBuilder) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MocknipostBuilder) Proof added in v1.3.5

func (m *MocknipostBuilder) Proof(ctx context.Context, nodeID types.NodeID, challenge []byte) (*types.Post, *types.PostInfo, error)

Proof mocks base method.

func (*MocknipostBuilder) ResetState added in v1.4.0

func (m *MocknipostBuilder) ResetState(arg0 types.NodeID) error

ResetState mocks base method.

type MocknipostBuilderBuildNIPostCall added in v1.4.0

type MocknipostBuilderBuildNIPostCall struct {
	*gomock.Call
}

MocknipostBuilderBuildNIPostCall wrap *gomock.Call

func (*MocknipostBuilderBuildNIPostCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostBuilderBuildNIPostCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostBuilderBuildNIPostCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostBuilderMockRecorder added in v1.0.0

type MocknipostBuilderMockRecorder struct {
	// contains filtered or unexported fields
}

MocknipostBuilderMockRecorder is the mock recorder for MocknipostBuilder.

func (*MocknipostBuilderMockRecorder) BuildNIPost added in v1.0.0

func (mr *MocknipostBuilderMockRecorder) BuildNIPost(ctx, sig, publish, challenge any) *MocknipostBuilderBuildNIPostCall

BuildNIPost indicates an expected call of BuildNIPost.

func (*MocknipostBuilderMockRecorder) Proof added in v1.3.5

func (mr *MocknipostBuilderMockRecorder) Proof(ctx, nodeID, challenge any) *MocknipostBuilderProofCall

Proof indicates an expected call of Proof.

func (*MocknipostBuilderMockRecorder) ResetState added in v1.4.0

ResetState indicates an expected call of ResetState.

type MocknipostBuilderProofCall added in v1.4.0

type MocknipostBuilderProofCall struct {
	*gomock.Call
}

MocknipostBuilderProofCall wrap *gomock.Call

func (*MocknipostBuilderProofCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostBuilderProofCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostBuilderProofCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostBuilderResetStateCall added in v1.4.0

type MocknipostBuilderResetStateCall struct {
	*gomock.Call
}

MocknipostBuilderResetStateCall wrap *gomock.Call

func (*MocknipostBuilderResetStateCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostBuilderResetStateCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostBuilderResetStateCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidator added in v1.0.0

type MocknipostValidator struct {
	// contains filtered or unexported fields
}

MocknipostValidator is a mock of nipostValidator interface.

func NewMocknipostValidator added in v1.0.0

func NewMocknipostValidator(ctrl *gomock.Controller) *MocknipostValidator

NewMocknipostValidator creates a new mock instance.

func (*MocknipostValidator) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MocknipostValidator) InitialNIPostChallenge added in v1.0.0

func (m *MocknipostValidator) InitialNIPostChallenge(challenge *types.NIPostChallenge, atxs atxProvider, goldenATXID types.ATXID) error

InitialNIPostChallenge mocks base method.

func (*MocknipostValidator) IsVerifyingFullPost added in v1.4.0

func (m *MocknipostValidator) IsVerifyingFullPost() bool

IsVerifyingFullPost mocks base method.

func (*MocknipostValidator) NIPost added in v1.0.0

func (m *MocknipostValidator) NIPost(ctx context.Context, nodeId types.NodeID, commitmentAtxId types.ATXID, NIPost *types.NIPost, expectedChallenge types.Hash32, numUnits uint32, opts ...validatorOption) (uint64, error)

NIPost mocks base method.

func (*MocknipostValidator) NIPostChallenge added in v1.0.0

func (m *MocknipostValidator) NIPostChallenge(challenge *types.NIPostChallenge, atxs atxProvider, nodeID types.NodeID) error

NIPostChallenge mocks base method.

func (*MocknipostValidator) NumUnits added in v1.0.0

func (m *MocknipostValidator) NumUnits(cfg *PostConfig, numUnits uint32) error

NumUnits mocks base method.

func (*MocknipostValidator) PositioningAtx added in v1.0.0

func (m *MocknipostValidator) PositioningAtx(id types.ATXID, atxs atxProvider, goldenATXID types.ATXID, pubepoch types.EpochID) error

PositioningAtx mocks base method.

func (*MocknipostValidator) Post added in v1.0.0

func (m *MocknipostValidator) Post(ctx context.Context, nodeId types.NodeID, commitmentAtxId types.ATXID, Post *types.Post, PostMetadata *types.PostMetadata, numUnits uint32, opts ...validatorOption) error

Post mocks base method.

func (*MocknipostValidator) PostMetadata added in v1.0.0

func (m *MocknipostValidator) PostMetadata(cfg *PostConfig, metadata *types.PostMetadata) error

PostMetadata mocks base method.

func (*MocknipostValidator) VRFNonce added in v1.0.0

func (m *MocknipostValidator) VRFNonce(nodeId types.NodeID, commitmentAtxId types.ATXID, vrfNonce *types.VRFPostIndex, PostMetadata *types.PostMetadata, numUnits uint32) error

VRFNonce mocks base method.

func (*MocknipostValidator) VerifyChain added in v1.4.0

func (m *MocknipostValidator) VerifyChain(ctx context.Context, id, goldenATXID types.ATXID, opts ...VerifyChainOption) error

VerifyChain mocks base method.

type MocknipostValidatorInitialNIPostChallengeCall added in v1.4.0

type MocknipostValidatorInitialNIPostChallengeCall struct {
	*gomock.Call
}

MocknipostValidatorInitialNIPostChallengeCall wrap *gomock.Call

func (*MocknipostValidatorInitialNIPostChallengeCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorInitialNIPostChallengeCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorInitialNIPostChallengeCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorIsVerifyingFullPostCall added in v1.4.0

type MocknipostValidatorIsVerifyingFullPostCall struct {
	*gomock.Call
}

MocknipostValidatorIsVerifyingFullPostCall wrap *gomock.Call

func (*MocknipostValidatorIsVerifyingFullPostCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorIsVerifyingFullPostCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorIsVerifyingFullPostCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorMockRecorder added in v1.0.0

type MocknipostValidatorMockRecorder struct {
	// contains filtered or unexported fields
}

MocknipostValidatorMockRecorder is the mock recorder for MocknipostValidator.

func (*MocknipostValidatorMockRecorder) InitialNIPostChallenge added in v1.0.0

func (mr *MocknipostValidatorMockRecorder) InitialNIPostChallenge(challenge, atxs, goldenATXID any) *MocknipostValidatorInitialNIPostChallengeCall

InitialNIPostChallenge indicates an expected call of InitialNIPostChallenge.

func (*MocknipostValidatorMockRecorder) IsVerifyingFullPost added in v1.4.0

IsVerifyingFullPost indicates an expected call of IsVerifyingFullPost.

func (*MocknipostValidatorMockRecorder) NIPost added in v1.0.0

func (mr *MocknipostValidatorMockRecorder) NIPost(ctx, nodeId, commitmentAtxId, NIPost, expectedChallenge, numUnits any, opts ...any) *MocknipostValidatorNIPostCall

NIPost indicates an expected call of NIPost.

func (*MocknipostValidatorMockRecorder) NIPostChallenge added in v1.0.0

func (mr *MocknipostValidatorMockRecorder) NIPostChallenge(challenge, atxs, nodeID any) *MocknipostValidatorNIPostChallengeCall

NIPostChallenge indicates an expected call of NIPostChallenge.

func (*MocknipostValidatorMockRecorder) NumUnits added in v1.0.0

NumUnits indicates an expected call of NumUnits.

func (*MocknipostValidatorMockRecorder) PositioningAtx added in v1.0.0

func (mr *MocknipostValidatorMockRecorder) PositioningAtx(id, atxs, goldenATXID, pubepoch any) *MocknipostValidatorPositioningAtxCall

PositioningAtx indicates an expected call of PositioningAtx.

func (*MocknipostValidatorMockRecorder) Post added in v1.0.0

func (mr *MocknipostValidatorMockRecorder) Post(ctx, nodeId, commitmentAtxId, Post, PostMetadata, numUnits any, opts ...any) *MocknipostValidatorPostCall

Post indicates an expected call of Post.

func (*MocknipostValidatorMockRecorder) PostMetadata added in v1.0.0

PostMetadata indicates an expected call of PostMetadata.

func (*MocknipostValidatorMockRecorder) VRFNonce added in v1.0.0

func (mr *MocknipostValidatorMockRecorder) VRFNonce(nodeId, commitmentAtxId, vrfNonce, PostMetadata, numUnits any) *MocknipostValidatorVRFNonceCall

VRFNonce indicates an expected call of VRFNonce.

func (*MocknipostValidatorMockRecorder) VerifyChain added in v1.4.0

func (mr *MocknipostValidatorMockRecorder) VerifyChain(ctx, id, goldenATXID any, opts ...any) *MocknipostValidatorVerifyChainCall

VerifyChain indicates an expected call of VerifyChain.

type MocknipostValidatorNIPostCall added in v1.4.0

type MocknipostValidatorNIPostCall struct {
	*gomock.Call
}

MocknipostValidatorNIPostCall wrap *gomock.Call

func (*MocknipostValidatorNIPostCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorNIPostCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorNIPostCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorNIPostChallengeCall added in v1.4.0

type MocknipostValidatorNIPostChallengeCall struct {
	*gomock.Call
}

MocknipostValidatorNIPostChallengeCall wrap *gomock.Call

func (*MocknipostValidatorNIPostChallengeCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorNIPostChallengeCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorNIPostChallengeCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorNumUnitsCall added in v1.4.0

type MocknipostValidatorNumUnitsCall struct {
	*gomock.Call
}

MocknipostValidatorNumUnitsCall wrap *gomock.Call

func (*MocknipostValidatorNumUnitsCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorNumUnitsCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorNumUnitsCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorPositioningAtxCall added in v1.4.0

type MocknipostValidatorPositioningAtxCall struct {
	*gomock.Call
}

MocknipostValidatorPositioningAtxCall wrap *gomock.Call

func (*MocknipostValidatorPositioningAtxCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorPositioningAtxCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorPositioningAtxCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorPostCall added in v1.4.0

type MocknipostValidatorPostCall struct {
	*gomock.Call
}

MocknipostValidatorPostCall wrap *gomock.Call

func (*MocknipostValidatorPostCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorPostCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorPostCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorPostMetadataCall added in v1.4.0

type MocknipostValidatorPostMetadataCall struct {
	*gomock.Call
}

MocknipostValidatorPostMetadataCall wrap *gomock.Call

func (*MocknipostValidatorPostMetadataCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorPostMetadataCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorPostMetadataCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorVRFNonceCall added in v1.4.0

type MocknipostValidatorVRFNonceCall struct {
	*gomock.Call
}

MocknipostValidatorVRFNonceCall wrap *gomock.Call

func (*MocknipostValidatorVRFNonceCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorVRFNonceCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorVRFNonceCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MocknipostValidatorVerifyChainCall added in v1.4.0

type MocknipostValidatorVerifyChainCall struct {
	*gomock.Call
}

MocknipostValidatorVerifyChainCall wrap *gomock.Call

func (*MocknipostValidatorVerifyChainCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocknipostValidatorVerifyChainCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocknipostValidatorVerifyChainCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpoetClient added in v1.3.0

type MockpoetClient struct {
	// contains filtered or unexported fields
}

MockpoetClient is a mock of poetClient interface.

func NewMockpoetClient added in v1.3.0

func NewMockpoetClient(ctrl *gomock.Controller) *MockpoetClient

NewMockpoetClient creates a new mock instance.

func (*MockpoetClient) Address added in v1.3.0

func (m *MockpoetClient) Address() string

Address mocks base method.

func (*MockpoetClient) EXPECT added in v1.3.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockpoetClient) Proof added in v1.3.0

func (m *MockpoetClient) Proof(ctx context.Context, roundID string) (*types.PoetProof, []types.Hash32, error)

Proof mocks base method.

func (*MockpoetClient) Submit added in v1.3.0

func (m *MockpoetClient) Submit(ctx context.Context, deadline time.Time, prefix, challenge []byte, signature types.EdSignature, nodeID types.NodeID) (*types.PoetRound, error)

Submit mocks base method.

type MockpoetClientAddressCall added in v1.4.0

type MockpoetClientAddressCall struct {
	*gomock.Call
}

MockpoetClientAddressCall wrap *gomock.Call

func (*MockpoetClientAddressCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpoetClientAddressCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpoetClientAddressCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpoetClientMockRecorder added in v1.3.0

type MockpoetClientMockRecorder struct {
	// contains filtered or unexported fields
}

MockpoetClientMockRecorder is the mock recorder for MockpoetClient.

func (*MockpoetClientMockRecorder) Address added in v1.3.0

Address indicates an expected call of Address.

func (*MockpoetClientMockRecorder) Proof added in v1.3.0

func (mr *MockpoetClientMockRecorder) Proof(ctx, roundID any) *MockpoetClientProofCall

Proof indicates an expected call of Proof.

func (*MockpoetClientMockRecorder) Submit added in v1.3.0

func (mr *MockpoetClientMockRecorder) Submit(ctx, deadline, prefix, challenge, signature, nodeID any) *MockpoetClientSubmitCall

Submit indicates an expected call of Submit.

type MockpoetClientProofCall added in v1.4.0

type MockpoetClientProofCall struct {
	*gomock.Call
}

MockpoetClientProofCall wrap *gomock.Call

func (*MockpoetClientProofCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpoetClientProofCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpoetClientProofCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpoetClientSubmitCall added in v1.4.0

type MockpoetClientSubmitCall struct {
	*gomock.Call
}

MockpoetClientSubmitCall wrap *gomock.Call

func (*MockpoetClientSubmitCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpoetClientSubmitCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpoetClientSubmitCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpoetDbAPI added in v1.0.0

type MockpoetDbAPI struct {
	// contains filtered or unexported fields
}

MockpoetDbAPI is a mock of poetDbAPI interface.

func NewMockpoetDbAPI added in v1.0.0

func NewMockpoetDbAPI(ctrl *gomock.Controller) *MockpoetDbAPI

NewMockpoetDbAPI creates a new mock instance.

func (*MockpoetDbAPI) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockpoetDbAPI) Proof added in v1.5.2

Proof mocks base method.

func (*MockpoetDbAPI) ProofForRound added in v1.5.2

func (m *MockpoetDbAPI) ProofForRound(poetID []byte, roundID string) (*types.PoetProof, error)

ProofForRound mocks base method.

func (*MockpoetDbAPI) ValidateAndStore added in v1.0.0

func (m *MockpoetDbAPI) ValidateAndStore(ctx context.Context, proofMessage *types.PoetProofMessage) error

ValidateAndStore mocks base method.

type MockpoetDbAPIMockRecorder added in v1.0.0

type MockpoetDbAPIMockRecorder struct {
	// contains filtered or unexported fields
}

MockpoetDbAPIMockRecorder is the mock recorder for MockpoetDbAPI.

func (*MockpoetDbAPIMockRecorder) Proof added in v1.5.2

Proof indicates an expected call of Proof.

func (*MockpoetDbAPIMockRecorder) ProofForRound added in v1.5.2

func (mr *MockpoetDbAPIMockRecorder) ProofForRound(poetID, roundID any) *MockpoetDbAPIProofForRoundCall

ProofForRound indicates an expected call of ProofForRound.

func (*MockpoetDbAPIMockRecorder) ValidateAndStore added in v1.0.0

func (mr *MockpoetDbAPIMockRecorder) ValidateAndStore(ctx, proofMessage any) *MockpoetDbAPIValidateAndStoreCall

ValidateAndStore indicates an expected call of ValidateAndStore.

type MockpoetDbAPIProofCall added in v1.5.2

type MockpoetDbAPIProofCall struct {
	*gomock.Call
}

MockpoetDbAPIProofCall wrap *gomock.Call

func (*MockpoetDbAPIProofCall) Do added in v1.5.2

Do rewrite *gomock.Call.Do

func (*MockpoetDbAPIProofCall) DoAndReturn added in v1.5.2

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpoetDbAPIProofCall) Return added in v1.5.2

Return rewrite *gomock.Call.Return

type MockpoetDbAPIProofForRoundCall added in v1.5.2

type MockpoetDbAPIProofForRoundCall struct {
	*gomock.Call
}

MockpoetDbAPIProofForRoundCall wrap *gomock.Call

func (*MockpoetDbAPIProofForRoundCall) Do added in v1.5.2

Do rewrite *gomock.Call.Do

func (*MockpoetDbAPIProofForRoundCall) DoAndReturn added in v1.5.2

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpoetDbAPIProofForRoundCall) Return added in v1.5.2

Return rewrite *gomock.Call.Return

type MockpoetDbAPIValidateAndStoreCall added in v1.4.0

type MockpoetDbAPIValidateAndStoreCall struct {
	*gomock.Call
}

MockpoetDbAPIValidateAndStoreCall wrap *gomock.Call

func (*MockpoetDbAPIValidateAndStoreCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpoetDbAPIValidateAndStoreCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpoetDbAPIValidateAndStoreCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpostService added in v1.3.0

type MockpostService struct {
	// contains filtered or unexported fields
}

MockpostService is a mock of postService interface.

func NewMockpostService added in v1.3.0

func NewMockpostService(ctrl *gomock.Controller) *MockpostService

NewMockpostService creates a new mock instance.

func (*MockpostService) Client added in v1.3.0

func (m *MockpostService) Client(nodeId types.NodeID) (PostClient, error)

Client mocks base method.

func (*MockpostService) EXPECT added in v1.3.0

EXPECT returns an object that allows the caller to indicate expected use.

type MockpostServiceClientCall added in v1.4.0

type MockpostServiceClientCall struct {
	*gomock.Call
}

MockpostServiceClientCall wrap *gomock.Call

func (*MockpostServiceClientCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpostServiceClientCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpostServiceClientCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpostServiceMockRecorder added in v1.3.0

type MockpostServiceMockRecorder struct {
	// contains filtered or unexported fields
}

MockpostServiceMockRecorder is the mock recorder for MockpostService.

func (*MockpostServiceMockRecorder) Client added in v1.3.0

Client indicates an expected call of Client.

type MockpostSetupProvider added in v1.0.0

type MockpostSetupProvider struct {
	// contains filtered or unexported fields
}

MockpostSetupProvider is a mock of postSetupProvider interface.

func NewMockpostSetupProvider added in v1.0.0

func NewMockpostSetupProvider(ctrl *gomock.Controller) *MockpostSetupProvider

NewMockpostSetupProvider creates a new mock instance.

func (*MockpostSetupProvider) EXPECT added in v1.0.0

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockpostSetupProvider) PrepareInitializer added in v1.0.0

func (m *MockpostSetupProvider) PrepareInitializer(ctx context.Context, opts PostSetupOpts, id types.NodeID) error

PrepareInitializer mocks base method.

func (*MockpostSetupProvider) Reset added in v1.0.0

func (m *MockpostSetupProvider) Reset() error

Reset mocks base method.

func (*MockpostSetupProvider) StartSession added in v1.0.0

func (m *MockpostSetupProvider) StartSession(context context.Context, id types.NodeID) error

StartSession mocks base method.

func (*MockpostSetupProvider) Status added in v1.0.0

Status mocks base method.

type MockpostSetupProviderMockRecorder added in v1.0.0

type MockpostSetupProviderMockRecorder struct {
	// contains filtered or unexported fields
}

MockpostSetupProviderMockRecorder is the mock recorder for MockpostSetupProvider.

func (*MockpostSetupProviderMockRecorder) PrepareInitializer added in v1.0.0

PrepareInitializer indicates an expected call of PrepareInitializer.

func (*MockpostSetupProviderMockRecorder) Reset added in v1.0.0

Reset indicates an expected call of Reset.

func (*MockpostSetupProviderMockRecorder) StartSession added in v1.0.0

StartSession indicates an expected call of StartSession.

func (*MockpostSetupProviderMockRecorder) Status added in v1.0.0

Status indicates an expected call of Status.

type MockpostSetupProviderPrepareInitializerCall added in v1.4.0

type MockpostSetupProviderPrepareInitializerCall struct {
	*gomock.Call
}

MockpostSetupProviderPrepareInitializerCall wrap *gomock.Call

func (*MockpostSetupProviderPrepareInitializerCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpostSetupProviderPrepareInitializerCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpostSetupProviderPrepareInitializerCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpostSetupProviderResetCall added in v1.4.0

type MockpostSetupProviderResetCall struct {
	*gomock.Call
}

MockpostSetupProviderResetCall wrap *gomock.Call

func (*MockpostSetupProviderResetCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpostSetupProviderResetCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpostSetupProviderResetCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpostSetupProviderStartSessionCall added in v1.4.0

type MockpostSetupProviderStartSessionCall struct {
	*gomock.Call
}

MockpostSetupProviderStartSessionCall wrap *gomock.Call

func (*MockpostSetupProviderStartSessionCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpostSetupProviderStartSessionCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpostSetupProviderStartSessionCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type MockpostSetupProviderStatusCall added in v1.4.0

type MockpostSetupProviderStatusCall struct {
	*gomock.Call
}

MockpostSetupProviderStatusCall wrap *gomock.Call

func (*MockpostSetupProviderStatusCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockpostSetupProviderStatusCall) DoAndReturn added in v1.4.0

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockpostSetupProviderStatusCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type Mockscaler added in v1.2.12

type Mockscaler struct {
	// contains filtered or unexported fields
}

Mockscaler is a mock of scaler interface.

func NewMockscaler added in v1.2.12

func NewMockscaler(ctrl *gomock.Controller) *Mockscaler

NewMockscaler creates a new mock instance.

func (*Mockscaler) EXPECT added in v1.2.12

func (m *Mockscaler) EXPECT() *MockscalerMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

type MockscalerMockRecorder added in v1.2.12

type MockscalerMockRecorder struct {
	// contains filtered or unexported fields
}

MockscalerMockRecorder is the mock recorder for Mockscaler.

type MockscalerscaleCall added in v1.4.0

type MockscalerscaleCall struct {
	*gomock.Call
}

MockscalerscaleCall wrap *gomock.Call

func (*MockscalerscaleCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MockscalerscaleCall) DoAndReturn added in v1.4.0

func (c *MockscalerscaleCall) DoAndReturn(f func(int)) *MockscalerscaleCall

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MockscalerscaleCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type Mocksyncer added in v1.0.0

type Mocksyncer struct {
	// contains filtered or unexported fields
}

Mocksyncer is a mock of syncer interface.

func NewMocksyncer added in v1.0.0

func NewMocksyncer(ctrl *gomock.Controller) *Mocksyncer

NewMocksyncer creates a new mock instance.

func (*Mocksyncer) EXPECT added in v1.0.0

func (m *Mocksyncer) EXPECT() *MocksyncerMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*Mocksyncer) RegisterForATXSynced added in v1.0.0

func (m *Mocksyncer) RegisterForATXSynced() <-chan struct{}

RegisterForATXSynced mocks base method.

type MocksyncerMockRecorder added in v1.0.0

type MocksyncerMockRecorder struct {
	// contains filtered or unexported fields
}

MocksyncerMockRecorder is the mock recorder for Mocksyncer.

func (*MocksyncerMockRecorder) RegisterForATXSynced added in v1.0.0

func (mr *MocksyncerMockRecorder) RegisterForATXSynced() *MocksyncerRegisterForATXSyncedCall

RegisterForATXSynced indicates an expected call of RegisterForATXSynced.

type MocksyncerRegisterForATXSyncedCall added in v1.4.0

type MocksyncerRegisterForATXSyncedCall struct {
	*gomock.Call
}

MocksyncerRegisterForATXSyncedCall wrap *gomock.Call

func (*MocksyncerRegisterForATXSyncedCall) Do added in v1.4.0

Do rewrite *gomock.Call.Do

func (*MocksyncerRegisterForATXSyncedCall) DoAndReturn added in v1.4.0

func (c *MocksyncerRegisterForATXSyncedCall) DoAndReturn(f func() <-chan struct{}) *MocksyncerRegisterForATXSyncedCall

DoAndReturn rewrite *gomock.Call.DoAndReturn

func (*MocksyncerRegisterForATXSyncedCall) Return added in v1.4.0

Return rewrite *gomock.Call.Return

type NIPostBuilder added in v1.0.0

type NIPostBuilder struct {
	// contains filtered or unexported fields
}

NIPostBuilder holds the required state and dependencies to create Non-Interactive Proofs of Space-Time (NIPost).

func NewNIPostBuilder added in v1.0.0

func NewNIPostBuilder(
	db *localsql.Database,
	poetDB poetDbAPI,
	postService postService,
	poetServers []types.PoetServer,
	lg *zap.Logger,
	poetCfg PoetConfig,
	layerClock layerClock,
	opts ...NIPostBuilderOption,
) (*NIPostBuilder, error)

NewNIPostBuilder returns a NIPostBuilder.

func (*NIPostBuilder) BuildNIPost added in v1.0.0

func (nb *NIPostBuilder) BuildNIPost(
	ctx context.Context,
	signer *signing.EdSigner,
	publishEpoch types.EpochID,
	challenge types.Hash32,
) (*nipost.NIPostState, error)

BuildNIPost uses the given challenge to build a NIPost. The process can take considerable time, because it includes waiting for the poet service to publish a proof - a process that takes about an epoch.

func (*NIPostBuilder) Proof added in v1.3.5

func (nb *NIPostBuilder) Proof(
	ctx context.Context,
	nodeID types.NodeID,
	challenge []byte,
) (*types.Post, *types.PostInfo, error)

func (*NIPostBuilder) ResetState added in v1.4.0

func (nb *NIPostBuilder) ResetState(nodeId types.NodeID) error

type NIPostBuilderOption added in v1.0.3

type NIPostBuilderOption func(*NIPostBuilder)

func NipostbuilderWithPostStates added in v1.4.0

func NipostbuilderWithPostStates(ps PostStates) NIPostBuilderOption

type PoetClient added in v1.5.2

type PoetClient struct {
	// contains filtered or unexported fields
}

PoetClient is a higher-level interface to communicate with a PoET service. It wraps the HTTP client, adding additional functionality.

func (*PoetClient) Address added in v1.5.2

func (c *PoetClient) Address() string

func (*PoetClient) Proof added in v1.5.2

func (c *PoetClient) Proof(ctx context.Context, roundID string) (*types.PoetProof, []types.Hash32, error)

func (*PoetClient) Submit added in v1.5.2

func (c *PoetClient) Submit(
	ctx context.Context,
	deadline time.Time,
	prefix, challenge []byte,
	signature types.EdSignature,
	nodeID types.NodeID,
) (*types.PoetRound, error)

type PoetClientOpts added in v1.0.0

type PoetClientOpts func(*HTTPPoetClient)

func WithLogger added in v1.1.5

func WithLogger(logger *zap.Logger) PoetClientOpts

type PoetConfig added in v1.0.0

type PoetConfig struct {
	PhaseShift        time.Duration `mapstructure:"phase-shift"`
	CycleGap          time.Duration `mapstructure:"cycle-gap"`
	GracePeriod       time.Duration `mapstructure:"grace-period"`
	RequestTimeout    time.Duration `mapstructure:"poet-request-timeout"`
	RequestRetryDelay time.Duration `mapstructure:"retry-delay"`
	MaxRequestRetries int           `mapstructure:"retry-max"`
}

PoetConfig is the configuration to interact with the poet server.

func DefaultPoetConfig added in v1.0.0

func DefaultPoetConfig() PoetConfig

type PoetDb

type PoetDb struct {
	// contains filtered or unexported fields
}

PoetDb is a database for PoET proofs.

func NewPoetDb

func NewPoetDb(db *sql.Database, log log.Log) *PoetDb

NewPoetDb returns a new PoET handler.

func (*PoetDb) GetProofMessage

func (db *PoetDb) GetProofMessage(proofRef types.PoetProofRef) ([]byte, error)

GetProofMessage returns the originally received PoET proof message.

func (*PoetDb) GetProofRef added in v1.0.0

func (db *PoetDb) GetProofRef(poetID []byte, roundID string) (types.PoetProofRef, error)

func (*PoetDb) HasProof

func (db *PoetDb) HasProof(proofRef types.PoetProofRef) bool

HasProof returns true if the database contains a proof with the given reference, or false otherwise.

func (*PoetDb) Proof added in v1.5.2

func (db *PoetDb) Proof(proofRef types.PoetProofRef) (*types.PoetProof, *types.Hash32, error)

Proof returns full proof.

func (*PoetDb) ProofForRound added in v1.5.2

func (db *PoetDb) ProofForRound(poetID []byte, roundID string) (*types.PoetProof, error)

func (*PoetDb) StoreProof added in v1.0.0

func (db *PoetDb) StoreProof(ctx context.Context, ref types.PoetProofRef, proofMessage *types.PoetProofMessage) error

StoreProof saves the poet proof in local db.

func (*PoetDb) Validate

func (db *PoetDb) Validate(
	root []byte,
	proof types.PoetProof,
	poetID []byte,
	roundID string,
	signature types.EdSignature,
) error

Validate validates a new PoET proof.

func (*PoetDb) ValidateAndStore

func (db *PoetDb) ValidateAndStore(ctx context.Context, proofMessage *types.PoetProofMessage) error

ValidateAndStore validates and stores a new PoET proof.

func (*PoetDb) ValidateAndStoreMsg added in v0.1.16

func (db *PoetDb) ValidateAndStoreMsg(ctx context.Context, expHash types.Hash32, _ p2p.Peer, data []byte) error

ValidateAndStoreMsg validates and stores a new PoET proof.

type PoetPoW added in v1.0.0

type PoetPoW struct {
	Nonce  uint64
	Params PoetPowParams
}

type PoetPowParams added in v1.0.0

type PoetPowParams struct {
	Challenge  []byte
	Difficulty uint
}

type PoetSvcUnstableError added in v1.0.0

type PoetSvcUnstableError struct {
	// contains filtered or unexported fields
}

PoetSvcUnstableError means there was a problem communicating with a Poet service. It wraps the source error.

func (*PoetSvcUnstableError) Error added in v1.0.0

func (e *PoetSvcUnstableError) Error() string

func (*PoetSvcUnstableError) Is added in v1.0.0

func (e *PoetSvcUnstableError) Is(target error) bool

func (*PoetSvcUnstableError) Unwrap added in v1.0.0

func (e *PoetSvcUnstableError) Unwrap() error

type PostClient

type PostClient interface {
	Info(ctx context.Context) (*types.PostInfo, error)
	Proof(ctx context.Context, challenge []byte) (*types.Post, *types.PostInfo, error)
}

type PostConfig added in v1.0.0

type PostConfig struct {
	MinNumUnits   uint32 `mapstructure:"post-min-numunits"`
	MaxNumUnits   uint32 `mapstructure:"post-max-numunits"`
	LabelsPerUnit uint64 `mapstructure:"post-labels-per-unit"`
	K1            uint   `mapstructure:"post-k1"`
	K2            uint   `mapstructure:"post-k2"`
	// size of the subset of labels to verify in POST proofs
	// lower values will result in faster ATX verification but increase the risk
	// as the node must depend on malfeasance proofs to detect invalid ATXs
	K3            uint          `mapstructure:"post-k3"`
	PowDifficulty PowDifficulty `mapstructure:"post-pow-difficulty"`
}

PostConfig is the configuration of the Post protocol, used for data creation, proofs generation and validation.

func DefaultPostConfig added in v1.0.0

func DefaultPostConfig() PostConfig

DefaultPostConfig defines the default configuration for Post.

func (PostConfig) ToConfig added in v1.0.0

func (c PostConfig) ToConfig() config.Config

type PostPowFlags added in v1.3.0

type PostPowFlags config.PowFlags

func (*PostPowFlags) Set added in v1.3.0

func (f *PostPowFlags) Set(value string) error

Set implements pflag.Value.Set.

func (PostPowFlags) String added in v1.3.0

func (f PostPowFlags) String() string

String implements pflag.Value.String.

func (PostPowFlags) Type added in v1.3.0

func (PostPowFlags) Type() string

Type implements pflag.Value.Type.

func (*PostPowFlags) Value added in v1.3.0

func (f *PostPowFlags) Value() config.PowFlags

type PostProofVerifyingOpts added in v1.0.0

type PostProofVerifyingOpts struct {
	// Disable verifying POST proofs. Experimental.
	// Use with caution, only on private nodes with a trusted public peer that
	// validates the proofs.
	Disabled bool `mapstructure:"smeshing-opts-verifying-disable"`

	// Number of workers spawned to verify proofs.
	Workers int `mapstructure:"smeshing-opts-verifying-workers"`
	// The minimum number of verifying workers to keep
	// while POST is being generated in parallel.
	//
	// Caps at the value of `Workers` (then scaling is disabled).
	MinWorkers int `mapstructure:"smeshing-opts-verifying-min-workers"`
	// Flags used for the PoW verification.
	Flags PostPowFlags `mapstructure:"smeshing-opts-verifying-powflags"`
}

PostProofVerifyingOpts are the options controlling POST proving process.

func DefaultPostVerifyingOpts added in v1.0.0

func DefaultPostVerifyingOpts() PostProofVerifyingOpts

type PostProviderID added in v1.1.0

type PostProviderID struct {
	// contains filtered or unexported fields
}

func (*PostProviderID) Set added in v1.1.0

func (id *PostProviderID) Set(value string) error

Set implements pflag.Value.Set.

func (*PostProviderID) SetUint32 added in v1.3.0

func (id *PostProviderID) SetUint32(value uint32)

SetInt64 sets the value of the PostProviderID to the given int64.

func (PostProviderID) String added in v1.1.0

func (id PostProviderID) String() string

String implements pflag.Value.String.

func (PostProviderID) Type added in v1.1.0

func (PostProviderID) Type() string

Type implements pflag.Value.Type.

func (*PostProviderID) Value added in v1.1.0

func (id *PostProviderID) Value() *uint32

Value returns the value of the PostProviderID as a pointer to uint32.

type PostProvingOpts added in v1.0.0

type PostProvingOpts struct {
	// Number of threads used in POST proving process.
	Threads uint `mapstructure:"smeshing-opts-proving-threads"`

	// Number of nonces tried in parallel in POST proving process.
	Nonces uint `mapstructure:"smeshing-opts-proving-nonces"`

	// RandomXMode is the mode used for RandomX computations.
	RandomXMode PostRandomXMode `mapstructure:"smeshing-opts-proving-randomx-mode"`
}

PostProvingOpts are the options controlling POST proving process.

func DefaultPostProvingOpts added in v1.0.0

func DefaultPostProvingOpts() PostProvingOpts

type PostRandomXMode added in v1.3.0

type PostRandomXMode string
const (
	PostRandomXModeFast  PostRandomXMode = "fast"
	PostRandomXModeLight PostRandomXMode = "light"
)

func (*PostRandomXMode) Set added in v1.3.0

func (m *PostRandomXMode) Set(value string) error

Set implements pflag.Value.Set.

func (PostRandomXMode) String added in v1.3.0

func (m PostRandomXMode) String() string

String implements pflag.Value.String.

func (PostRandomXMode) Type added in v1.3.0

func (PostRandomXMode) Type() string

Type implements pflag.Value.Type.

type PostSetupManager added in v1.0.0

type PostSetupManager struct {
	// contains filtered or unexported fields
}

PostSetupManager implements the PostProvider interface.

func NewPostSetupManager added in v1.0.0

func NewPostSetupManager(
	cfg PostConfig,
	logger *zap.Logger,
	db *datastore.CachedDB,
	goldenATXID types.ATXID,
	syncer syncer,
	validator nipostValidator,
	opts ...PostSetupManagerOpt,
) (*PostSetupManager, error)

NewPostSetupManager creates a new instance of PostSetupManager.

func (*PostSetupManager) PrepareInitializer added in v1.0.0

func (mgr *PostSetupManager) PrepareInitializer(ctx context.Context, opts PostSetupOpts, id types.NodeID) error

PrepareInitializer prepares the initializer to begin the initialization process, it needs to be called before each call to StartSession. Having this function be separate from StartSession provides a means to understand if the post configuration is valid before kicking off a very long running task (StartSession can take days to complete). After the first call to this method subsequent calls to this method will return an error until StartSession has completed execution.

func (*PostSetupManager) Reset added in v1.0.0

func (mgr *PostSetupManager) Reset() error

Reset deletes the data file(s).

func (*PostSetupManager) StartSession added in v1.0.0

func (mgr *PostSetupManager) StartSession(ctx context.Context, nodeID types.NodeID) error

StartSession starts (or continues) a PoST session. It supports resuming a previously started session, and will return an error if a session is already in progress. It must be ensured that PrepareInitializer is called once before each call to StartSession and that the node is ATX synced.

func (*PostSetupManager) Status added in v1.0.0

func (mgr *PostSetupManager) Status() *PostSetupStatus

Status returns the setup current status.

type PostSetupManagerOpt added in v1.4.0

type PostSetupManagerOpt func(*PostSetupManager)

func PostValidityDelay added in v1.4.0

func PostValidityDelay(delay time.Duration) PostSetupManagerOpt

PostValidityDelay sets the delay before PoST in ATX is considered valid.

type PostSetupOpts added in v1.0.0

type PostSetupOpts struct {
	DataDir          string              `mapstructure:"smeshing-opts-datadir"`
	NumUnits         uint32              `mapstructure:"smeshing-opts-numunits"`
	MaxFileSize      uint64              `mapstructure:"smeshing-opts-maxfilesize"`
	ProviderID       PostProviderID      `mapstructure:"smeshing-opts-provider"`
	Throttle         bool                `mapstructure:"smeshing-opts-throttle"`
	Scrypt           config.ScryptParams `mapstructure:"smeshing-opts-scrypt"`
	ComputeBatchSize uint64              `mapstructure:"smeshing-opts-compute-batch-size"`
}

PostSetupOpts are the options used to initiate a Post setup data creation session, either via the public smesher API, or on node launch (via cmd args).

func DefaultPostSetupOpts added in v1.0.0

func DefaultPostSetupOpts() PostSetupOpts

DefaultPostSetupOpts defines the default options for Post setup.

func (PostSetupOpts) ToInitOpts added in v1.0.3

func (o PostSetupOpts) ToInitOpts() config.InitOpts

type PostSetupProvider added in v1.0.0

type PostSetupProvider initialization.Provider

PostSetupProvider represent a compute provider for Post setup data creation.

type PostSetupState added in v1.0.0

type PostSetupState int32
const (
	PostSetupStateNotStarted PostSetupState = 1 + iota
	PostSetupStatePrepared
	PostSetupStateInProgress
	PostSetupStateStopped
	PostSetupStateComplete
	PostSetupStateError
)

type PostSetupStatus added in v1.0.0

type PostSetupStatus struct {
	State            PostSetupState
	NumLabelsWritten uint64
	LastOpts         *PostSetupOpts
}

PostSetupStatus represents a status snapshot of the Post setup.

type PostStates added in v1.4.0

type PostStates interface {
	Set(id types.NodeID, state types.PostState)
	Get() map[types.NodeID]types.PostState
}

type PostSupervisor added in v1.3.0

type PostSupervisor struct {
	// contains filtered or unexported fields
}

PostSupervisor manages a local post service.

func NewPostSupervisor added in v1.3.0

func NewPostSupervisor(
	logger *zap.Logger,
	postCfg PostConfig,
	provingOpts PostProvingOpts,
	postSetupProvider postSetupProvider,
	atxBuilder AtxBuilder,
) *PostSupervisor

NewPostSupervisor returns a new post service.

func (*PostSupervisor) Benchmark added in v1.3.0

func (*PostSupervisor) Benchmark(p PostSetupProvider) (int, error)

Benchmark runs a short benchmarking session for a given provider to evaluate its performance.

func (*PostSupervisor) Config added in v1.3.0

func (ps *PostSupervisor) Config() PostConfig

func (*PostSupervisor) Providers added in v1.3.0

func (*PostSupervisor) Providers() ([]PostSetupProvider, error)

Providers returns a list of available compute providers for Post setup.

func (*PostSupervisor) Start added in v1.3.0

func (*PostSupervisor) Status added in v1.3.0

func (ps *PostSupervisor) Status() *PostSetupStatus

func (*PostSupervisor) Stop added in v1.3.0

func (ps *PostSupervisor) Stop(deleteFiles bool) error

Stop stops the post service.

type PostSupervisorConfig added in v1.3.0

type PostSupervisorConfig struct {
	PostServiceCmd string
	NodeAddress    string
	MaxRetries     int

	CACert string
	Cert   string
	Key    string
}

func DefaultPostServiceConfig added in v1.3.0

func DefaultPostServiceConfig() PostSupervisorConfig

DefaultPostServiceConfig returns the default config for post service.

func DefaultTestPostServiceConfig added in v1.3.0

func DefaultTestPostServiceConfig() PostSupervisorConfig

DefaultTestPostServiceConfig returns the default config for post service in tests.

type PostVerifier added in v1.0.0

type PostVerifier interface {
	io.Closer
	Verify(ctx context.Context, p *shared.Proof, m *shared.ProofMetadata, opts ...verifying.OptionFunc) error
}

func NewPostVerifier added in v1.0.0

func NewPostVerifier(cfg PostConfig, logger *zap.Logger, opts ...PostVerifierOpt) (PostVerifier, error)

NewPostVerifier creates a new post verifier.

type PostVerifierOpt added in v1.3.8

type PostVerifierOpt func(v *postVerifierOpts)

func WithAutoscaling added in v1.3.8

func WithAutoscaling(postStates postStatesGetter) PostVerifierOpt

func WithPrioritizedID added in v1.4.0

func WithPrioritizedID(id types.NodeID) PostVerifierOpt

func WithVerifyingOpts added in v1.3.8

func WithVerifyingOpts(opts PostProofVerifyingOpts) PostVerifierOpt

type PowDifficulty added in v1.0.0

type PowDifficulty [32]byte

func (*PowDifficulty) Set added in v1.0.0

func (f *PowDifficulty) Set(value string) error

Set implements pflag.Value.Set.

func (PowDifficulty) String added in v1.0.0

func (d PowDifficulty) String() string

func (PowDifficulty) Type added in v1.0.0

func (PowDifficulty) Type() string

Type implements pflag.Value.Type.

func (*PowDifficulty) UnmarshalText added in v1.0.0

func (d *PowDifficulty) UnmarshalText(text []byte) error

type SmeshingProvider added in v1.0.0

type SmeshingProvider interface {
	Smeshing() bool
	StartSmeshing(types.Address) error
	StopSmeshing(bool) error
	SmesherIDs() []types.NodeID
	Coinbase() types.Address
	SetCoinbase(coinbase types.Address)
}

SmeshingProvider defines the functionality required for the node's Smesher API.

type Validator

type Validator struct {
	// contains filtered or unexported fields
}

Validator contains the dependencies required to validate NIPosts.

func NewValidator

func NewValidator(
	db sql.Executor,
	poetDb poetDbAPI,
	cfg PostConfig,
	scrypt config.ScryptParams,
	postVerifier PostVerifier,
) *Validator

NewValidator returns a new NIPost validator.

func (*Validator) InitialNIPostChallenge added in v1.0.0

func (v *Validator) InitialNIPostChallenge(
	challenge *types.NIPostChallenge,
	atxs atxProvider,
	goldenATXID types.ATXID,
) error

func (*Validator) IsVerifyingFullPost added in v1.4.0

func (v *Validator) IsVerifyingFullPost() bool

func (*Validator) NIPost added in v1.0.0

func (v *Validator) NIPost(
	ctx context.Context,
	nodeId types.NodeID,
	commitmentAtxId types.ATXID,
	nipost *types.NIPost,
	expectedChallenge types.Hash32,
	numUnits uint32,
	opts ...validatorOption,
) (uint64, error)

NIPost validates a NIPost, given a node id and expected challenge. It returns an error if the NIPost is invalid.

Some of the Post metadata fields validation values is ought to eventually be derived from consensus instead of local configuration. If so, their validation should be removed to contextual validation, while still syntactically-validate them here according to locally configured min/max values.

func (*Validator) NIPostChallenge added in v1.0.0

func (*Validator) NIPostChallenge(challenge *types.NIPostChallenge, atxs atxProvider, nodeID types.NodeID) error

func (*Validator) NumUnits added in v1.0.0

func (*Validator) NumUnits(cfg *PostConfig, numUnits uint32) error

func (*Validator) PositioningAtx added in v1.0.0

func (v *Validator) PositioningAtx(
	id types.ATXID,
	atxs atxProvider,
	goldenATXID types.ATXID,
	pubepoch types.EpochID,
) error

func (*Validator) Post added in v1.0.0

func (v *Validator) Post(
	ctx context.Context,
	nodeId types.NodeID,
	commitmentAtxId types.ATXID,
	PoST *types.Post,
	PostMetadata *types.PostMetadata,
	numUnits uint32,
	opts ...validatorOption,
) error

Post validates a Proof of Space-Time (PoST). It returns nil if validation passed or an error indicating why validation failed.

func (*Validator) PostMetadata added in v1.0.0

func (*Validator) PostMetadata(cfg *PostConfig, metadata *types.PostMetadata) error

func (*Validator) VRFNonce added in v1.0.0

func (v *Validator) VRFNonce(
	nodeId types.NodeID,
	commitmentAtxId types.ATXID,
	vrfNonce *types.VRFPostIndex,
	PostMetadata *types.PostMetadata,
	numUnits uint32,
) error

func (*Validator) VerifyChain added in v1.4.0

func (v *Validator) VerifyChain(ctx context.Context, id, goldenATXID types.ATXID, opts ...VerifyChainOption) error

type VerifyChainOption added in v1.4.0

type VerifyChainOption func(*verifyChainOpts)

Directories

Path Synopsis
Package mocks is a generated GoMock package.
Package mocks is a generated GoMock package.
nolint
nolint

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL