-
Notifications
You must be signed in to change notification settings - Fork 662
/
vm.go
95 lines (83 loc) · 3.57 KB
/
vm.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
// Copyright (C) 2019-2022, Ava Labs, Inc. All rights reserved.
// See the file LICENSE for licensing terms.
package common
import (
"context"
"github.com/ava-labs/avalanchego/api/health"
"github.com/ava-labs/avalanchego/database/manager"
"github.com/ava-labs/avalanchego/snow"
"github.com/ava-labs/avalanchego/snow/validators"
)
// VM describes the interface that all consensus VMs must implement
type VM interface {
AppHandler
// Returns nil if the VM is healthy.
// Periodically called and reported via the node's Health API.
health.Checker
// Connector represents a handler that is called on connection connect/disconnect
validators.Connector
// Initialize this VM.
// [chainCtx]: Metadata about this VM.
// [chainCtx.networkID]: The ID of the network this VM's chain is
// running on.
// [chainCtx.chainID]: The unique ID of the chain this VM is running on.
// [chainCtx.Log]: Used to log messages
// [chainCtx.NodeID]: The unique staker ID of this node.
// [chainCtx.Lock]: A Read/Write lock shared by this VM and the
// consensus engine that manages this VM. The write
// lock is held whenever code in the consensus engine
// calls the VM.
// [dbManager]: The manager of the database this VM will persist data to.
// [genesisBytes]: The byte-encoding of the genesis information of this
// VM. The VM uses it to initialize its state. For
// example, if this VM were an account-based payments
// system, `genesisBytes` would probably contain a genesis
// transaction that gives coins to some accounts, and this
// transaction would be in the genesis block.
// [toEngine]: The channel used to send messages to the consensus engine.
// [fxs]: Feature extensions that attach to this VM.
Initialize(
ctx context.Context,
chainCtx *snow.Context,
dbManager manager.Manager,
genesisBytes []byte,
upgradeBytes []byte,
configBytes []byte,
toEngine chan<- Message,
fxs []*Fx,
appSender AppSender,
) error
// SetState communicates to VM its next state it starts
SetState(ctx context.Context, state snow.State) error
// Shutdown is called when the node is shutting down.
Shutdown(context.Context) error
// Version returns the version of the VM this node is running.
Version(context.Context) (string, error)
// Creates the HTTP handlers for custom VM network calls.
//
// This exposes handlers that the outside world can use to communicate with
// a static reference to the VM. Each handler has the path:
// [Address of node]/ext/VM/[VM ID]/[extension]
//
// Returns a mapping from [extension]s to HTTP handlers.
//
// Each extension can specify how locking is managed for convenience.
//
// For example, it might make sense to have an extension for creating
// genesis bytes this VM can interpret.
CreateStaticHandlers(context.Context) (map[string]*HTTPHandler, error)
// Creates the HTTP handlers for custom chain network calls.
//
// This exposes handlers that the outside world can use to communicate with
// the chain. Each handler has the path:
// [Address of node]/ext/bc/[chain ID]/[extension]
//
// Returns a mapping from [extension]s to HTTP handlers.
//
// Each extension can specify how locking is managed for convenience.
//
// For example, if this VM implements an account-based payments system,
// it have an extension called `accounts`, where clients could get
// information about their accounts.
CreateHandlers(context.Context) (map[string]*HTTPHandler, error)
}