Wisper is an RPC protocol that defines how two different nodes should communicate. The protocol is heavily inspired by JSON RPC but extended to allow Class like operations.
A simple fire and forget type of message that instructs a remote node to perform a method call with a bunch of parameters.
{
"method" : "log",
"params" : ["Hello world!"]
}When something goes wrong and it is not a result of a request, a plain error will be sent.
{
"error" : {
"message" : "Something went wrong!"
},
}Whenever you want to get some sort of result from a method invocation a request is the way to go. A request will always receive a response from the other node with the result or an error as a result of handling the request.
{
"id" : "abc123",
"method" : "concat",
"params" : ["Hello ", "world!"]
}After handling a request a response should be sent to deliver the final result of that request.
{
"id" : "abc123",
"result" : "Hello world!"
}If we for some reason run into problems when handling a request we can return an error response.
{
"id" : "abc123",
"error" : {
"message" : "could not invoke method",
...
}
}The basic wisper protocol is extended by an object protocol that allows Class like behaviour with constructors, destructors, instance methods and events.