jsonrpc-http-server

Rust http server using JSON-RPC 2.0.

Documentation

Example

Cargo.toml

[dependencies] jsonrpc-http-server = { git = "https://github.com/paritytech/jsonrpc" }

main.rs

```rust extern crate jsonrpchttpserver;

use jsonrpchttpserver::; use jsonrpc_http_server::jsonrpc_core::;

fn main() { let mut io = IoHandler::default(); io.addmethod("sayhello", |_| { Ok(Value::String("hello".into())) });

let server = ServerBuilder::new(io)
    .cors(DomainsValidation::AllowOnly(vec![AccessControlAllowOrigin::Null]))
    .start_http(&"127.0.0.1:3030".parse().unwrap())
    .expect("Unable to start RPC server");

server.wait();

} You can now test the above server by running `cargo run` in one terminal, and from another terminal issue the following POST request to your server: $ curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "sayhello", "id":123 }' 127.0.0.1:3030 to which the server will respond with the following: {"jsonrpc":"2.0","result":"hello","id":123} If you omit any of the fields above, or invoke a different method you will get an informative error message: $ curl -X POST -H "Content-Type: application/json" -d '{"method": "sayhello", "id":123 }' 127.0.0.1:3030 {"error":{"code":-32600,"message":"Unsupported JSON-RPC protocol version"},"id":123} $ curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "say_bye", "id":123 }' 127.0.0.1:3030 {"jsonrpc":"2.0","error":{"code":-32601,"message":"Method not found"},"id":123} ```