Method TraceChain

protocols/cpc/api_tracer.go:95–129

TraceChain returns the structured logs created during the execution of EVM between two blocks (excluding start) and returns them as a JSON object.

(ctx context.Context, start, end rpc.BlockNumber, config *TraceConfig)

// TraceChain returns the structured logs created during the execution of EVM
// between two blocks (excluding start) and returns them as a JSON object.
func (api *PrivateDebugAPI) TraceChain(ctx context.Context, start, end rpc.BlockNumber, config *TraceConfig) (*rpc.Subscription, error) {
	// Fetch the block interval that we want to trace
	var from, to *types.Block

	switch start {
	case rpc.PendingBlockNumber:
		from = api.cpc.miner.PendingBlock()
	case rpc.LatestBlockNumber:
		from = api.cpc.blockchain.CurrentBlock()
	default:
		from = api.cpc.blockchain.GetBlockByNumber(uint64(start))
	}
	switch end {
	case rpc.PendingBlockNumber:
		to = api.cpc.miner.PendingBlock()
	case rpc.LatestBlockNumber:
		to = api.cpc.blockchain.CurrentBlock()
	default:
		to = api.cpc.blockchain.GetBlockByNumber(uint64(end))
	}
	// Trace the chain if we've found all our blocks
	if from == nil {
		return nil, fmt.Errorf("starting block #%d not found", start)
	}
	if to == nil {
		return nil, fmt.Errorf("end block #%d not found", end)
	}

	// cf. https://github.com/ethereum/go-ethereum/pull/17460
	if from.Number().Cmp(to.Number()) >= 0 {
		return nil, fmt.Errorf("end block (#%d) needs to come after start block (#%d)", end, start)
	}

	return api.traceChain(ctx, from, to, config)
}

// traceChain configures a new tracer according to the provided configuration, and
// executes all the transactions contained within. The return value will be one item