064f37d6f6
Here we add a Go API for running tracing plugins within the main block import process. As an advanced user of geth, you can now create a Go file in eth/tracers/live/, and within that file register your custom tracer implementation. Then recompile geth and select your tracer on the command line. Hooks defined in the tracer will run whenever a block is processed. The hook system is defined in package core/tracing. It uses a struct with callbacks, instead of requiring an interface, for several reasons: - We plan to keep this API stable long-term. The core/tracing hook API does not depend on on deep geth internals. - There are a lot of hooks, and tracers will only need some of them. Using a struct allows you to implement only the hooks you want to actually use. All existing tracers in eth/tracers/native have been rewritten to use the new hook system. This change breaks compatibility with the vm.EVMLogger interface that we used to have. If you are a user of vm.EVMLogger, please migrate to core/tracing, and sorry for breaking your stuff. But we just couldn't have both the old and new tracing APIs coexist in the EVM. --------- Co-authored-by: Matthieu Vachon <matthieu.o.vachon@gmail.com> Co-authored-by: Delweng <delweng@gmail.com> Co-authored-by: Martin HS <martin@swende.se>
32 lines
763 B
Go
32 lines
763 B
Go
package tracers
|
|
|
|
import (
|
|
"encoding/json"
|
|
"errors"
|
|
|
|
"github.com/ethereum/go-ethereum/core/tracing"
|
|
)
|
|
|
|
type ctorFunc func(config json.RawMessage) (*tracing.Hooks, error)
|
|
|
|
// LiveDirectory is the collection of tracers which can be used
|
|
// during normal block import operations.
|
|
var LiveDirectory = liveDirectory{elems: make(map[string]ctorFunc)}
|
|
|
|
type liveDirectory struct {
|
|
elems map[string]ctorFunc
|
|
}
|
|
|
|
// Register registers a tracer constructor by name.
|
|
func (d *liveDirectory) Register(name string, f ctorFunc) {
|
|
d.elems[name] = f
|
|
}
|
|
|
|
// New instantiates a tracer by name.
|
|
func (d *liveDirectory) New(name string, config json.RawMessage) (*tracing.Hooks, error) {
|
|
if f, ok := d.elems[name]; ok {
|
|
return f(config)
|
|
}
|
|
return nil, errors.New("not found")
|
|
}
|