JSON-RPC 2.0

Unified JSON-RPC 2.0 interface over HTTP[S], WebSocket and UNIX socket for Clojure/Script.

Rationale

Goals

• [x] Support Clojure.
• [x] Support HTTP.
• [x] Future support.
• [x] Support WebSocket.
• [x] Support HTTP status override.
• [x] Support UNIX socket.
• [x] Write unit tests.
• [ ] Write integration tests.
• [ ] Support WebSocket Ping/Pong.
• [ ] Support request batching.
• [ ] Pluggable HTTP client.
• [ ] Pluggable WebSocket client.
• [ ] Pluggable JSON encoder.
• [ ] Support ClojureScript.
• [ ] Support JSON-RPC notification.

Usage

Leiningen/Boot

[com.github.hindol/json-rpc.core "${version}"]

tools.deps.alpha

com.github.hindol/json-rpc.core {:mvn/version "${version}"}

Quickstart

(ns example.core
  (:require [json-rpc.core :as rpc]))

;; Choose from HTTP[S], WebSocket and UNIX socket
(def url "http://localhost:8545")
(def url "ws://localhost:8546")
(def url "unix:///var/run/geth.ipc")

(def connection (rpc/connect url))

;; Receive a future
(rpc/send! connection "eth_blockNumber" ["latest"])

;; Deref to get the response
@(rpc/send! connection "eth_blockNumber" ["latest"])

;; Like send! but accepts a variable number of arguments
@(rpc/send!* connection "eth_blockNumber" "latest")

Component

Mount

Logs

API Documentation