99f81d2724
In this PR, all TryXXX(e.g. TryGet) APIs of trie are renamed to XXX(e.g. Get) with an error returned. The original XXX(e.g. Get) APIs are renamed to MustXXX(e.g. MustGet) and does not return any error -- they print a log output. A future PR will change the behaviour to panic on errorrs.
47 lines
1.8 KiB
Go
47 lines
1.8 KiB
Go
// Copyright 2015 The go-ethereum Authors
|
|
// This file is part of the go-ethereum library.
|
|
//
|
|
// The go-ethereum library is free software: you can redistribute it and/or modify
|
|
// 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.
|
|
//
|
|
// The go-ethereum library is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public License
|
|
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
package trie
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/ethereum/go-ethereum/common"
|
|
)
|
|
|
|
// MissingNodeError is returned by the trie functions (Get, Update, Delete)
|
|
// in the case where a trie node is not present in the local database. It contains
|
|
// information necessary for retrieving the missing node.
|
|
type MissingNodeError struct {
|
|
Owner common.Hash // owner of the trie if it's 2-layered trie
|
|
NodeHash common.Hash // hash of the missing node
|
|
Path []byte // hex-encoded path to the missing node
|
|
err error // concrete error for missing trie node
|
|
}
|
|
|
|
// Unwrap returns the concrete error for missing trie node which
|
|
// allows us for further analysis outside.
|
|
func (err *MissingNodeError) Unwrap() error {
|
|
return err.err
|
|
}
|
|
|
|
func (err *MissingNodeError) Error() string {
|
|
if err.Owner == (common.Hash{}) {
|
|
return fmt.Sprintf("missing trie node %x (path %x) %v", err.NodeHash, err.Path, err.err)
|
|
}
|
|
return fmt.Sprintf("missing trie node %x (owner %x) (path %x) %v", err.NodeHash, err.Owner, err.Path, err.err)
|
|
}
|