Enable trace methods

.gitignore

@@ -62,3 +62,8 @@ cmd/geth/geth
 cmd/rlpdump/rlpdump
 cmd/workload/workload
 cmd/keeper/keeper
+
+# Local environment secrets
+.env
+.env.local
+CLAUDE.local.md

README.md

@@ -45,6 +45,36 @@
 
 Post `v0.3.0` release, bor uses a new command line interface (cli). The new-cli (located at `internal/cli`) has been built while keeping the flag usage similar to old-cli (located at `cmd/geth`) with a few notable changes. Please refer to [docs](./docs) section for the flag usage guide and example.
 
+### Parity / OpenEthereum Trace API (`trace_*`)
+
+Bor includes a Parity-compatible trace namespace (`trace_block`, `trace_transaction`,
+`trace_replayTransaction`, `trace_replayBlockTransactions`, `trace_call`,
+`trace_callMany`). These methods are **disabled by default** because they are
+expensive and require an archive node.
+
+Enable with the `--rpc.enabletrace` flag (or `JsonRPC.EnableTrace = true` in TOML):
+
+```shell
+bor server --config ./config.toml --rpc.enabletrace
+```
+
+Or in `config.toml`:
+
+```toml
+[jsonrpc]
+  enabletrace = true
+```
+
+**Requirements:**
+- Archive node (`--gcmode archive`)
+- Sufficient RPC timeout for deep blocks (`--rpc.evmtimeout` ≥ 60s recommended)
+
+**Known limitations vs Polygon Erigon:**
+- `trace_call`/`trace_callMany` on underfunded simulated senders returns an error
+  instead of a bailout trace (gas bailout not yet implemented).
+- `trace_block` omits the state-sync pseudo-transaction for pre-Madhugiri blocks
+  (< 80,084,800 on mainnet); post-Madhugiri blocks are fully supported.
+
 ### Latest Config Reference
 
 For the latest canonical TOML config options, refer to:

docs/cli/chain_sethead.md

@@ -10,4 +10,6 @@ The ```chain sethead <number>``` command sets the current chain to a certain blo
 
 - ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
 
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.
+
 - ```yes```: Force set head (default: false)

docs/cli/debug_block.md

@@ -6,4 +6,6 @@ The ```bor debug block <number>``` command will create an archive containing tra
 
 - ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
 
-- ```output```: Output directory
+- ```output```: Output directory
+
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.

docs/cli/debug_pprof.md

@@ -10,4 +10,6 @@ The ```debug pprof <enode>``` command will create an archive containing bor ppro
 
 - ```seconds```: seconds to profile (default: 2)
 
-- ```skiptrace```: Skip running the trace (default: false)
+- ```skiptrace```: Skip running the trace (default: false)
+
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.

docs/cli/default_config.toml

@@ -118,6 +118,7 @@ devfakeauthor = false
   rangelimit = 0
   allow-unprotected-txs = false
   enabledeprecatedpersonal = false
+  enabletrace = false
   "txsync.defaulttimeout" = "20s"
   "txsync.maxtimeout" = "1m0s"
   accept-preconf-tx = false

docs/cli/peers_add.md

@@ -6,4 +6,6 @@ The ```peers add <enode>``` command joins the local client to another remote pee
 
 - ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
 
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.
+
 - ```trusted```: Add the peer as a trusted (default: false)

docs/cli/peers_list.md

@@ -4,4 +4,6 @@ The ```peers list``` command lists the connected peers.
 
 ## Options
 
-- ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
+- ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
+
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.

docs/cli/peers_remove.md

@@ -6,4 +6,6 @@ The ```peers remove <enode>``` command disconnects the local client from a conne
 
 - ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
 
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.
+
 - ```trusted```: Add the peer as a trusted (default: false)

docs/cli/peers_status.md

@@ -4,4 +4,6 @@ The ```peers status <peer id>``` command displays the status of a peer by its id
 
 ## Options
 
-- ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
+- ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
+
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.

docs/cli/removedb.md

@@ -6,4 +6,6 @@ The ```bor removedb``` command will remove the blockchain and state databases at
 
 - ```address```: Address of the grpc endpoint (default: 127.0.0.1:3131)
 
-- ```datadir```: Path of the data directory to store information
+- ```datadir```: Path of the data directory to store information
+
+- ```token```: Bearer token to authenticate with the bor gRPC server (matches --grpc.token on the server). Falls back to the BOR_GRPC_TOKEN environment variable when unset.

docs/cli/server.md

@@ -244,6 +244,8 @@ The ```bor server``` command runs the Bor client.
 
 - ```rpc.enabledeprecatedpersonal```: Enables the (deprecated) personal namespace (default: false)
 
+- ```rpc.enabletrace```: Enables the Parity-compatible trace namespace (trace_block, trace_transaction, trace_call, trace_callMany, trace_replayTransaction, trace_replayBlockTransactions) (default: false)
+
 - ```rpc.evmtimeout```: Sets a timeout used for eth_call (0=infinite) (default: 5s)
 
 - ```rpc.gascap```: Sets a cap on gas that can be used in eth_call/estimateGas (0=infinite) (default: 50000000)

eth/tracers/api.go

@@ -1004,49 +1004,13 @@ func containsTx(block *types.Block, hash common.Hash) bool {
 // TraceTransaction returns the structured logs created during the execution of EVM
 // and returns them as a JSON object.
 func (api *API) TraceTransaction(ctx context.Context, hash common.Hash, config *TraceConfig) (interface{}, error) {
-	found, _, blockHash, blockNumber, index := api.backend.GetCanonicalTransaction(hash)
-	if !found {
-		// Warn in case tx indexer is not done.
-		if !api.backend.TxIndexDone() {
-			return nil, ethapi.NewTxIndexingError()
-		}
-		// Only mined txes are supported
-		return nil, errTxNotFound
-	}
-	// It shouldn't happen in practice.
-	if blockNumber == 0 {
-		return nil, errors.New("genesis is not traceable")
-	}
-	reexec := defaultTraceReexec
-	if config != nil && config.Reexec != nil {
-		reexec = *config.Reexec
-	}
-	block, err := api.blockByNumberAndHash(ctx, rpc.BlockNumber(blockNumber), blockHash)
-	if err != nil {
-		return nil, err
-	}
-	tx, vmctx, statedb, release, err := api.backend.StateAtTransaction(ctx, block, int(index), reexec)
+	in, release, err := api.canonicalTxTraceEnv(ctx, hash, config)
 	if err != nil {
 		return nil, err
 	}
 	defer release()
 
-	txctx := &Context{
-		BlockHash:   blockHash,
-		BlockNumber: block.Number(),
-		TxIndex:     int(index),
-		TxHash:      hash,
-		// This field is only used for bor transactions. Use block gas used as state-sync is
-		// always the last tx.
-		CumulativeGasUsed: block.GasUsed(),
-		LogIndex:          len(statedb.Logs()),
-	}
-
-	msg, err := core.TransactionToMessage(tx, types.MakeSigner(api.backend.ChainConfig(), block.Number(), block.Time()), block.BaseFee())
-	if err != nil {
-		return nil, err
-	}
-	res, _, err := api.traceTx(ctx, tx, msg, txctx, vmctx, statedb, config, nil)
+	res, _, err := api.traceTx(ctx, in.tx, in.msg, in.txctx, in.vmctx, in.statedb, config, nil)
 	return res, err
 }