bridge

type Bridge interface {
	// ComputeStateRoot applies `msgs` against `base` (the parent
	// tipset's stateRoot) at the given epoch and returns the resulting
	// state root + per-message receipts.
	//
	// The returned receipts MUST be in the same order as `msgs`.
	//
	// `epoch` lets the upstream node pick the right network version /
	// actor version table. Callers should pass the epoch of the parent
	// tipset (i.e. the epoch at which messages execute).
	//
	// `ctx` cancellation propagates to the upstream RPC call.
	ComputeStateRoot(ctx context.Context, base cid.Cid, epoch int64, msgs []*types.Message) (cid.Cid, []*types.MessageReceipt, error)

	// RawJSONRPC forwards a JSON-RPC method call to the upstream and
	// returns the raw `result` JSON. Used to delegate FEVM-shaped
	// methods (eth_call, eth_estimateGas, eth_sendRawTransaction)
	// that need real FEVM execution — Lantern's native VM is Send-only.
	//
	// `params` should be the already-marshaled JSON array of the
	// upstream method's parameters (e.g. `["0xdeadbeef", "latest"]`).
	//
	// Returns the raw `result` JSON on success, or an error if the
	// upstream call failed or returned a JSON-RPC error.
	RawJSONRPC(ctx context.Context, method string, params json.RawMessage) (json.RawMessage, error)

	// Provenance returns a short, opaque identifier for the upstream
	// node serving this bridge — typically "forest@<host>" or
	// "lotus@<host>". Used for trace logging only; not security-bearing.
	Provenance() string
}

type CachingBridge struct {
	// contains filtered or unexported fields
}

type ForestBridge struct {
	URL    string
	Token  string // optional Bearer token (empty for unauthenticated)
	Client *http.Client
	// contains filtered or unexported fields
}