2015-07-07 03:54:22 +03:00
|
|
|
// Copyright 2014 The go-ethereum Authors
|
2015-07-22 19:48:40 +03:00
|
|
|
// This file is part of the go-ethereum library.
|
2015-07-07 03:54:22 +03:00
|
|
|
//
|
2015-07-23 19:35:11 +03:00
|
|
|
// The go-ethereum library is free software: you can redistribute it and/or modify
|
2015-07-07 03:54:22 +03:00
|
|
|
// it under the terms of the GNU Lesser General Public License as published by
|
|
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
|
|
// (at your option) any later version.
|
|
|
|
//
|
2015-07-22 19:48:40 +03:00
|
|
|
// The go-ethereum library is distributed in the hope that it will be useful,
|
2015-07-07 03:54:22 +03:00
|
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
2015-07-22 19:48:40 +03:00
|
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
2015-07-07 03:54:22 +03:00
|
|
|
// GNU Lesser General Public License for more details.
|
|
|
|
//
|
|
|
|
// You should have received a copy of the GNU Lesser General Public License
|
2015-07-22 19:48:40 +03:00
|
|
|
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
|
2015-07-07 03:54:22 +03:00
|
|
|
|
2015-01-08 12:47:04 +02:00
|
|
|
package trie
|
2014-11-18 13:02:13 +02:00
|
|
|
|
2015-07-06 02:19:48 +03:00
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
"io"
|
|
|
|
"strings"
|
|
|
|
|
|
|
|
"github.com/ethereum/go-ethereum/common"
|
|
|
|
"github.com/ethereum/go-ethereum/rlp"
|
|
|
|
)
|
2014-11-18 13:02:13 +02:00
|
|
|
|
|
|
|
var indices = []string{"0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "a", "b", "c", "d", "e", "f", "[17]"}
|
|
|
|
|
2015-07-06 02:19:48 +03:00
|
|
|
type node interface {
|
2016-05-19 13:24:14 +03:00
|
|
|
cache() (hashNode, bool)
|
2022-03-09 16:45:17 +03:00
|
|
|
encode(w rlp.EncoderBuffer)
|
|
|
|
fstring(string) string
|
2014-11-18 13:02:13 +02:00
|
|
|
}
|
|
|
|
|
2015-07-06 02:19:48 +03:00
|
|
|
type (
|
2016-05-19 13:24:14 +03:00
|
|
|
fullNode struct {
|
|
|
|
Children [17]node // Actual trie node data to encode/decode (needs custom encoder)
|
2016-10-14 19:04:33 +03:00
|
|
|
flags nodeFlag
|
2016-05-19 13:24:14 +03:00
|
|
|
}
|
2015-07-06 02:19:48 +03:00
|
|
|
shortNode struct {
|
2016-05-19 13:24:14 +03:00
|
|
|
Key []byte
|
|
|
|
Val node
|
2016-10-14 19:04:33 +03:00
|
|
|
flags nodeFlag
|
2015-07-06 02:19:48 +03:00
|
|
|
}
|
|
|
|
hashNode []byte
|
|
|
|
valueNode []byte
|
|
|
|
)
|
2015-02-03 05:58:34 +02:00
|
|
|
|
2018-06-21 12:28:05 +03:00
|
|
|
// nilValueNode is used when collapsing internal trie nodes for hashing, since
|
|
|
|
// unset children need to serialize correctly.
|
|
|
|
var nilValueNode = valueNode(nil)
|
|
|
|
|
2016-05-19 13:24:14 +03:00
|
|
|
// EncodeRLP encodes a full node into the consensus RLP format.
|
2016-10-14 19:04:33 +03:00
|
|
|
func (n *fullNode) EncodeRLP(w io.Writer) error {
|
2022-03-09 16:45:17 +03:00
|
|
|
eb := rlp.NewEncoderBuffer(w)
|
|
|
|
n.encode(eb)
|
|
|
|
return eb.Flush()
|
2016-05-19 13:24:14 +03:00
|
|
|
}
|
|
|
|
|
2016-10-14 19:04:33 +03:00
|
|
|
func (n *fullNode) copy() *fullNode { copy := *n; return © }
|
|
|
|
func (n *shortNode) copy() *shortNode { copy := *n; return © }
|
|
|
|
|
|
|
|
// nodeFlag contains caching-related metadata about a node.
|
|
|
|
type nodeFlag struct {
|
|
|
|
hash hashNode // cached hash of the node (may be nil)
|
|
|
|
dirty bool // whether the node has changes that must be written to the database
|
|
|
|
}
|
|
|
|
|
|
|
|
func (n *fullNode) cache() (hashNode, bool) { return n.flags.hash, n.flags.dirty }
|
|
|
|
func (n *shortNode) cache() (hashNode, bool) { return n.flags.hash, n.flags.dirty }
|
|
|
|
func (n hashNode) cache() (hashNode, bool) { return nil, true }
|
|
|
|
func (n valueNode) cache() (hashNode, bool) { return nil, true }
|
2016-05-19 13:24:14 +03:00
|
|
|
|
2015-07-06 02:19:48 +03:00
|
|
|
// Pretty printing.
|
2016-10-14 19:04:33 +03:00
|
|
|
func (n *fullNode) String() string { return n.fstring("") }
|
|
|
|
func (n *shortNode) String() string { return n.fstring("") }
|
|
|
|
func (n hashNode) String() string { return n.fstring("") }
|
|
|
|
func (n valueNode) String() string { return n.fstring("") }
|
2014-11-18 13:02:13 +02:00
|
|
|
|
2016-10-14 19:04:33 +03:00
|
|
|
func (n *fullNode) fstring(ind string) string {
|
2014-11-18 13:02:13 +02:00
|
|
|
resp := fmt.Sprintf("[\n%s ", ind)
|
2018-08-07 13:56:40 +03:00
|
|
|
for i, node := range &n.Children {
|
2014-11-18 13:02:13 +02:00
|
|
|
if node == nil {
|
|
|
|
resp += fmt.Sprintf("%s: <nil> ", indices[i])
|
|
|
|
} else {
|
|
|
|
resp += fmt.Sprintf("%s: %v", indices[i], node.fstring(ind+" "))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return resp + fmt.Sprintf("\n%s] ", ind)
|
|
|
|
}
|
2016-10-14 19:04:33 +03:00
|
|
|
func (n *shortNode) fstring(ind string) string {
|
2015-07-06 02:19:48 +03:00
|
|
|
return fmt.Sprintf("{%x: %v} ", n.Key, n.Val.fstring(ind+" "))
|
|
|
|
}
|
|
|
|
func (n hashNode) fstring(ind string) string {
|
|
|
|
return fmt.Sprintf("<%x> ", []byte(n))
|
|
|
|
}
|
|
|
|
func (n valueNode) fstring(ind string) string {
|
|
|
|
return fmt.Sprintf("%x ", []byte(n))
|
|
|
|
}
|
|
|
|
|
2023-04-24 10:38:52 +03:00
|
|
|
// rawNode is a simple binary blob used to differentiate between collapsed trie
|
|
|
|
// nodes and already encoded RLP binary blobs (while at the same time store them
|
|
|
|
// in the same cache fields).
|
|
|
|
type rawNode []byte
|
|
|
|
|
|
|
|
func (n rawNode) cache() (hashNode, bool) { panic("this should never end up in a live trie") }
|
|
|
|
func (n rawNode) fstring(ind string) string { panic("this should never end up in a live trie") }
|
|
|
|
|
|
|
|
func (n rawNode) EncodeRLP(w io.Writer) error {
|
|
|
|
_, err := w.Write(n)
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
2022-08-19 01:39:47 +03:00
|
|
|
// mustDecodeNode is a wrapper of decodeNode and panic if any error is encountered.
|
2019-03-14 16:25:12 +03:00
|
|
|
func mustDecodeNode(hash, buf []byte) node {
|
|
|
|
n, err := decodeNode(hash, buf)
|
2015-07-06 02:19:48 +03:00
|
|
|
if err != nil {
|
2016-05-19 13:24:14 +03:00
|
|
|
panic(fmt.Sprintf("node %x: %v", hash, err))
|
2015-07-06 02:19:48 +03:00
|
|
|
}
|
|
|
|
return n
|
|
|
|
}
|
|
|
|
|
2022-08-19 01:39:47 +03:00
|
|
|
// mustDecodeNodeUnsafe is a wrapper of decodeNodeUnsafe and panic if any error is
|
|
|
|
// encountered.
|
|
|
|
func mustDecodeNodeUnsafe(hash, buf []byte) node {
|
|
|
|
n, err := decodeNodeUnsafe(hash, buf)
|
|
|
|
if err != nil {
|
|
|
|
panic(fmt.Sprintf("node %x: %v", hash, err))
|
|
|
|
}
|
|
|
|
return n
|
|
|
|
}
|
|
|
|
|
|
|
|
// decodeNode parses the RLP encoding of a trie node. It will deep-copy the passed
|
|
|
|
// byte slice for decoding, so it's safe to modify the byte slice afterwards. The-
|
|
|
|
// decode performance of this function is not optimal, but it is suitable for most
|
|
|
|
// scenarios with low performance requirements and hard to determine whether the
|
|
|
|
// byte slice be modified or not.
|
2019-03-14 16:25:12 +03:00
|
|
|
func decodeNode(hash, buf []byte) (node, error) {
|
2022-08-19 01:39:47 +03:00
|
|
|
return decodeNodeUnsafe(hash, common.CopyBytes(buf))
|
|
|
|
}
|
|
|
|
|
|
|
|
// decodeNodeUnsafe parses the RLP encoding of a trie node. The passed byte slice
|
|
|
|
// will be directly referenced by node without bytes deep copy, so the input MUST
|
|
|
|
// not be changed after.
|
|
|
|
func decodeNodeUnsafe(hash, buf []byte) (node, error) {
|
2015-07-06 02:19:48 +03:00
|
|
|
if len(buf) == 0 {
|
|
|
|
return nil, io.ErrUnexpectedEOF
|
|
|
|
}
|
|
|
|
elems, _, err := rlp.SplitList(buf)
|
|
|
|
if err != nil {
|
|
|
|
return nil, fmt.Errorf("decode error: %v", err)
|
|
|
|
}
|
|
|
|
switch c, _ := rlp.CountValues(elems); c {
|
|
|
|
case 2:
|
2019-03-14 16:25:12 +03:00
|
|
|
n, err := decodeShort(hash, elems)
|
2015-07-06 02:19:48 +03:00
|
|
|
return n, wrapError(err, "short")
|
|
|
|
case 17:
|
2019-03-14 16:25:12 +03:00
|
|
|
n, err := decodeFull(hash, elems)
|
2015-07-06 02:19:48 +03:00
|
|
|
return n, wrapError(err, "full")
|
|
|
|
default:
|
|
|
|
return nil, fmt.Errorf("invalid number of list elements: %v", c)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-03-14 16:25:12 +03:00
|
|
|
func decodeShort(hash, elems []byte) (node, error) {
|
2016-05-19 13:24:14 +03:00
|
|
|
kbuf, rest, err := rlp.SplitString(elems)
|
2015-07-06 02:19:48 +03:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
2019-03-14 16:25:12 +03:00
|
|
|
flag := nodeFlag{hash: hash}
|
2017-04-18 14:25:07 +03:00
|
|
|
key := compactToHex(kbuf)
|
|
|
|
if hasTerm(key) {
|
2015-07-06 02:19:48 +03:00
|
|
|
// value node
|
|
|
|
val, _, err := rlp.SplitString(rest)
|
|
|
|
if err != nil {
|
|
|
|
return nil, fmt.Errorf("invalid value node: %v", err)
|
|
|
|
}
|
2022-08-19 01:39:47 +03:00
|
|
|
return &shortNode{key, valueNode(val), flag}, nil
|
2015-07-06 02:19:48 +03:00
|
|
|
}
|
2019-03-14 16:25:12 +03:00
|
|
|
r, _, err := decodeRef(rest)
|
2015-07-06 02:19:48 +03:00
|
|
|
if err != nil {
|
|
|
|
return nil, wrapError(err, "val")
|
|
|
|
}
|
2016-10-14 19:04:33 +03:00
|
|
|
return &shortNode{key, r, flag}, nil
|
2015-07-06 02:19:48 +03:00
|
|
|
}
|
|
|
|
|
2019-03-14 16:25:12 +03:00
|
|
|
func decodeFull(hash, elems []byte) (*fullNode, error) {
|
|
|
|
n := &fullNode{flags: nodeFlag{hash: hash}}
|
2015-07-06 02:19:48 +03:00
|
|
|
for i := 0; i < 16; i++ {
|
2019-03-14 16:25:12 +03:00
|
|
|
cld, rest, err := decodeRef(elems)
|
2015-07-06 02:19:48 +03:00
|
|
|
if err != nil {
|
|
|
|
return n, wrapError(err, fmt.Sprintf("[%d]", i))
|
|
|
|
}
|
2016-05-19 13:24:14 +03:00
|
|
|
n.Children[i], elems = cld, rest
|
2015-07-06 02:19:48 +03:00
|
|
|
}
|
2016-05-19 13:24:14 +03:00
|
|
|
val, _, err := rlp.SplitString(elems)
|
2015-07-06 02:19:48 +03:00
|
|
|
if err != nil {
|
|
|
|
return n, err
|
|
|
|
}
|
|
|
|
if len(val) > 0 {
|
2022-08-19 01:39:47 +03:00
|
|
|
n.Children[16] = valueNode(val)
|
2015-07-06 02:19:48 +03:00
|
|
|
}
|
|
|
|
return n, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
const hashLen = len(common.Hash{})
|
|
|
|
|
2019-03-14 16:25:12 +03:00
|
|
|
func decodeRef(buf []byte) (node, []byte, error) {
|
2015-07-06 02:19:48 +03:00
|
|
|
kind, val, rest, err := rlp.Split(buf)
|
|
|
|
if err != nil {
|
|
|
|
return nil, buf, err
|
|
|
|
}
|
|
|
|
switch {
|
|
|
|
case kind == rlp.List:
|
|
|
|
// 'embedded' node reference. The encoding must be smaller
|
|
|
|
// than a hash in order to be valid.
|
|
|
|
if size := len(buf) - len(rest); size > hashLen {
|
|
|
|
err := fmt.Errorf("oversized embedded node (size is %d bytes, want size < %d)", size, hashLen)
|
|
|
|
return nil, buf, err
|
|
|
|
}
|
2019-03-14 16:25:12 +03:00
|
|
|
n, err := decodeNode(nil, buf)
|
2015-07-06 02:19:48 +03:00
|
|
|
return n, rest, err
|
|
|
|
case kind == rlp.String && len(val) == 0:
|
|
|
|
// empty node
|
|
|
|
return nil, rest, nil
|
|
|
|
case kind == rlp.String && len(val) == 32:
|
2022-08-19 01:39:47 +03:00
|
|
|
return hashNode(val), rest, nil
|
2015-07-06 02:19:48 +03:00
|
|
|
default:
|
|
|
|
return nil, nil, fmt.Errorf("invalid RLP string size %d (want 0 or 32)", len(val))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// wraps a decoding error with information about the path to the
|
|
|
|
// invalid child node (for debugging encoding issues).
|
|
|
|
type decodeError struct {
|
|
|
|
what error
|
|
|
|
stack []string
|
|
|
|
}
|
|
|
|
|
|
|
|
func wrapError(err error, ctx string) error {
|
|
|
|
if err == nil {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
if decErr, ok := err.(*decodeError); ok {
|
|
|
|
decErr.stack = append(decErr.stack, ctx)
|
|
|
|
return decErr
|
|
|
|
}
|
|
|
|
return &decodeError{err, []string{ctx}}
|
|
|
|
}
|
2014-11-18 13:02:13 +02:00
|
|
|
|
2015-07-06 02:19:48 +03:00
|
|
|
func (err *decodeError) Error() string {
|
|
|
|
return fmt.Sprintf("%v (decode path: %s)", err.what, strings.Join(err.stack, "<-"))
|
2014-11-18 13:02:13 +02:00
|
|
|
}
|