koi_net.components.server

Classes

NodeServer(log, logging_context, ...)

Entry point for full nodes, manages FastAPI server.

class koi_net.components.server.NodeServer(log, logging_context, shutdown_signal, exception_queue, config, response_handler)

Bases: ThreadedComponent

Entry point for full nodes, manages FastAPI server.

Parameters:

• log (Logger)

• logging_context (LoggingContext)

• shutdown_signal (Event)

• exception_queue (Queue[Exception])

• config (FullNodeConfig)

• response_handler (ResponseHandler)

app: FastAPI

build_app()

Builds FastAPI app.

build_endpoints(router)

Builds endpoints for API router.

Parameters:

router (APIRouter)

config: FullNodeConfig

async logging_middleware(request, call_next)

Binds contextvars per HTTP request, and emits access logs.

Parameters:

request (Request)

protocol_error_handler(request, exc)

Catches ProtocolError and returns an ErrorResponse payload.

Parameters:

exc (ProtocolError)

response_handler: ResponseHandler

router: APIRouter

run()

Processing loop for thread.

server: Server | None = None

start()

stop()