Swarmauri Middleware JsonRpc

Middleware that performs simple validation of JSON-RPC requests.

Features

• Validates JSON request bodies for JSON-RPC payloads when the Content-Type header starts with application/json.
• Returns 400 Bad Request with a plain-text error when the body contains invalid JSON.
• Ensures JSON object payloads define a jsonrpc field, responding with 400 Bad Request if it is missing.

Installation

Install the middleware with your preferred Python packaging workflow:

pip install swarmauri_middleware_jsonrpc

poetry add swarmauri_middleware_jsonrpc

uv add swarmauri_middleware_jsonrpc

uv pip install swarmauri_middleware_jsonrpc

Usage

from fastapi import FastAPI
from swarmauri_middleware_jsonrpc import JsonRpcMiddleware

app = FastAPI()
app.middleware("http")(JsonRpcMiddleware().dispatch)

The middleware integrates with FastAPI's app.middleware("http") hook and is compatible with the MiddlewareBase ecosystem. Once registered, every incoming JSON request is validated before reaching subsequent middleware or route handlers.

Request Validation

• Requests without an application/json content type bypass the middleware.
• Malformed JSON bodies are rejected with a 400 response containing the message Invalid JSON.
• JSON objects missing the jsonrpc key are rejected with a 400 response and the message Missing jsonrpc field.

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.