json-rpc

Fully-featured JSON-RPC 2.0 library

https://github.com/jprupp/json-rpc.git#readme

LTS Haskell 24.55:1.1.2
Stackage Nightly 2026-08-19:1.1.3
Latest on Hackage:1.1.3

See all snapshots json-rpc appears in

MIT licensed by JP Rupp
Maintained by [email protected]
This version can be pinned in stack with:json-rpc-1.1.3@sha256:1f28eb072e2c5eb84f5d91aa1e0b355d232b526002233ac3a104fb02433b8a5f,3502

Module documentation for 1.1.3

Used by 1 package in nightly-2026-08-19(full list with versions):
json-rpc

json-rpc

Fully-featured JSON-RPC 2.0 library for Haskell programs.

This JSON-RPC library is fully-compatible with JSON-RPC 2.0 and 1.0. It provides an interface that combines a JSON-RPC client and server. It can set and keep track of request ids to parse responses. There is support for sending and receiving notifications. You may use any underlying transport. Basic TCP client and server provided.

A JSON-RPC application using this interface is considered to be peer-to-peer, as it can send and receive all types of JSON-RPC message independent of whether it originated the connection.

Documentation

Examples

Changes

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

1.1.3 - 2026-08-18

Fixed

  • Correct JSON identity test for requests that have null params.
  • Refactor to eliminate use of head.

1.1.2 - 2025-05-09

Fixed

  • Correct Arbitraty instance for errors.

1.1.1 - 2023-03-14

Fixed

  • Close TBMChan when the session is closed

1.1.0 - 2023-12-29

Changed

  • Update dependency to Aeson 2.2.

1.0.4 - 2022-05-15

Fixed

  • Remove Arbitrary Value instance because it is already provided by the aeson package.

Changed

  • Relax restrictions on params field for JSON-RPCv1 requests.
  • Bump minimum version of aeson accordingly.

1.0.3 - 2020-06-19

Changed

  • LogSource (defined in monad-logger) for this library is set to "json-rpc" so that logs can be filtered base on it.

1.0.2 - 2020-06-12

Changed

  • Change license to MIT.

1.0.1 - 2019-01-01

Fixed

  • Correct JSON-RPC 2.0 methods returning null result.

1.0.0 - 2018-08-12

Added

  • Complete JSON-RPC 1.0 and 2.0 support.
  • Ability to use either endpoint to send and receive requests, responses or notifications.
  • Simple TCP client/server implementation available.
  • Example files.
  • Exhaustive test suite.
  • Compatibility with GHC 8.4.
  • Support semantic versioning.
  • Add a changelog.