/
client.go
158 lines (129 loc) · 3.99 KB
/
client.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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
package exported
import (
proto "github.com/cosmos/gogoproto/proto"
"github.com/cosmos/cosmos-sdk/codec"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// Status represents the status of a client
type Status string
const (
// TypeClientMisbehaviour is the shared evidence misbehaviour type
TypeClientMisbehaviour string = "client_misbehaviour"
// Tendermint is used to indicate that the client uses the Tendermint Consensus Algorithm.
Tendermint string = "007-tendermint"
// BSC is the client type for a bianance smart chain client.
BSC string = "008-bsc"
// ETH is the client type for a Ethereum client.
ETH string = "009-eth"
// Fabric is the client type for a hyperledge fabric client.
// Fabric string = "009-fabric"
// Active is a status type of a client. An active client is allowed to be used.
Active Status = "Active"
// Expired is a status type of a client. An expired client is not allowed to be used.
Expired Status = "Expired"
// Unknown indicates there was an error in determining the status of a client.
Unknown Status = "Unknown"
)
// ClientState defines the required common functions for light clients.
type ClientState interface {
proto.Message
ClientType() string
GetLatestHeight() Height
Validate() error
GetDelayTime() uint64
GetDelayBlock() uint64
GetPrefix() Prefix
// Initialize function
// Clients must validate the initial consensus state, and may store any client-specific metadata
// necessary for correct light client operation
Initialize(sdk.Context, codec.BinaryCodec, sdk.KVStore, ConsensusState) error
// Status function
// Clients must return their status. Only Active clients are allowed to process packets.
Status(ctx sdk.Context, clientStore sdk.KVStore, cdc codec.BinaryCodec) Status
// ExportMetadata function
ExportMetadata(sdk.KVStore) []GenesisMetadata
// Update and Misbehaviour functions
CheckHeaderAndUpdateState(
sdk.Context,
codec.BinaryCodec,
sdk.KVStore,
Header,
) (ClientState, ConsensusState, error)
// State verification functions
// Verify the commitment of the cross-chain data package
VerifyPacketCommitment(
ctx sdk.Context,
store sdk.KVStore,
cdc codec.BinaryCodec,
height Height,
proof []byte,
sourceChain,
destChain string,
sequence uint64,
commitmentBytes []byte,
) error
// Verify the Acknowledgement of the cross-chain data package
VerifyPacketAcknowledgement(
ctx sdk.Context,
store sdk.KVStore,
cdc codec.BinaryCodec,
height Height,
proof []byte,
sourceChain,
destChain string,
sequence uint64,
ackBytes []byte,
) error
// Verify the CleanCommitment of the cross-chain data package
VerifyPacketCleanCommitment(
ctx sdk.Context,
store sdk.KVStore,
cdc codec.BinaryCodec,
height Height,
proof []byte,
sourceChain string,
destChain string,
sequence uint64,
) error
}
// ConsensusState is the state of the consensus process
type ConsensusState interface {
proto.Message
ClientType() string // Consensus kind
// GetRoot returns the commitment root of the consensus state,
// which is used for key-value pair verification.
GetRoot() Root
// GetTimestamp returns the timestamp (in nanoseconds) of the consensus state
GetTimestamp() uint64
ValidateBasic() error
}
// Header is the consensus state update information
type Header interface {
proto.Message
ClientType() string
GetHeight() Height
ValidateBasic() error
}
// Height is a wrapper interface over clienttypes.Height
// all clients must use the concrete implementation in types
type Height interface {
IsZero() bool
LT(Height) bool
LTE(Height) bool
EQ(Height) bool
GT(Height) bool
GTE(Height) bool
GetRevisionNumber() uint64
GetRevisionHeight() uint64
Increment() Height
Decrement() (Height, bool)
String() string
}
// GenesisMetadata is a wrapper interface over clienttypes.GenesisMetadata
// all clients must use the concrete implementation in types
type GenesisMetadata interface {
// return store key that contains metadata without chainName-prefix
GetKey() []byte
// returns metadata value
GetValue() []byte
}