fsm

type ActionMetadata struct {
	Block   [32]byte `json:"block,omitempty" form:"block" query:"block" validate:"required"`
	AppID   string   `json:"appID,omitempty" form:"appID" query:"appID" validate:"required"`
	Attempt uint64   `json:"attempt,omitempty" form:"attempt" query:"attempt" validate:"required"`
	// contains filtered or unexported fields
}

type App interface {
	// Init returns the app configuration.
	Init() (*AppConfig, error)

	// ShouldExecute determines if L1 should execute or should skip this block.
	// This is where the app should pull accounts with the light client.
	ShouldExecute(*StateContext, *NetworkBlockMetadata) (bool, error)

	// Execute returns a list of transactions that should be executed.
	Execute(*StateContext) ([]*AppAction, error)

	// DidExecute is called after L1 completes.
	DidExecute(*StateContext, []*AppAction) error

	// WillRetry is called during reset if L1 fails and is going to try again.
	WillRetry(*StateContext)
}

type AppAction struct {
	Transaction *protocol.Transaction

	// WillComplete indicates whether this action is expected to complete. If
	// WillComplete is nil or true, the FSM will consider it an error if the
	// action does not complete once signed.
	WillComplete *bool
}

type AppConfig struct {
	ID         string
	Blocks     *url.URL
	Validators *url.URL
}

type BadRequestTx struct {
	internal.TxExecuted
	Data  protocol.DataEntry
	Error error
}

type CoreAPI interface {
	core.NetworkService
	core.Querier
	core.Submitter
}

type L1BlockMetadata struct {
	Network *NetworkBlockMetadata `json:"network,omitempty" form:"network" query:"network" validate:"required"`
	Leader  *protocol.KeySpec     `json:"leader,omitempty" form:"leader" query:"leader" validate:"required"`
	// Actions lists the actions completed in this block.
	Actions []*url.TxID `json:"actions,omitempty" form:"actions" query:"actions" validate:"required"`
	// contains filtered or unexported fields
}

type NetworkBlockMetadata struct {
	Index uint64    `json:"index,omitempty" form:"index" query:"index" validate:"required"`
	Time  time.Time `json:"time,omitempty" form:"time" query:"time" validate:"required"`
	Major uint64    `json:"major,omitempty" form:"major" query:"major" validate:"required"`
	Hash  [32]byte  `json:"hash,omitempty" form:"hash" query:"hash" validate:"required"`
	// contains filtered or unexported fields
}

type Options struct {
	Logger    *slog.Logger
	App       App
	CoreAPI   CoreAPI
	WalletAPI WalletAPI
	Light     *light.Client

	// Address is the address that will be used to sign transactions. Address
	// may be nil if the node is not a validator.
	Address *address.PublicKey

	// SignExternalTransactions enables signing of transactions that were
	// initiated externally.
	SignExternalTransactions bool

	// DebugAttemptNumber allows retrying when debugging.
	DebugAttemptNumber uint64
}

type PayoutApp struct {
	Params *types.Parameters
	// contains filtered or unexported fields
}

type RequestTx struct {
	internal.TxExecuted
	Action requests.Action
}

type RequestsApp struct {
	Params *types.Parameters
}

type StateContext struct {
	Executor *StateExecutor

	// Block state
	CurrentBlock    *NetworkBlockMetadata //block of the current state being processed
	PreviousBlock   *NetworkBlockMetadata //previous block checked
	ExecutorVersion protocol.ExecutorVersion

	// Execution state
	AppData any
	// contains filtered or unexported fields
}

type StateDelegate interface {
	String() string
	// contains filtered or unexported methods
}

type StateExecutor struct {
	Options
	Config *AppConfig
	// contains filtered or unexported fields
}

type WalletAPI interface {
	wallet.SigningService
	wallet.KeyService
	wallet.AccountService
}