curl -X POST --data '{"jsonrpc":"2.0","method":"shh_version","params":[],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": "6.0"
}
```
***
#### shh_info
Returns diagnostic information about the whisper node.
##### Parameters
none
##### Returns
`Object` - diagnostic information with the following properties:
-`minPow` - `Number`: current minimum PoW requirement.
-`maxMessageSize` - `Float`: current messgae size limit in bytes.
-`memory` - `Number`: Memory size of the floating messages in bytes.
-`messages` - `Number`: Number of floating messages.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_info","params":[],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": {
"minPow": 12.5,
"maxMessageSize": 20000,
"memory": 10000,
"messages": 20,
}
}
```
***
#### shh_setMaxMessageSize
Sets the maximal message size allowed by this node.
Incoming and outgoing messages with a larger size will be rejected.
Whisper message size can never exceed the limit imposed by the underlying P2P protocol (10 Mb).
##### Parameters
1.`Number`: Message size in bytes.
##### Returns
`Boolean`: (`true`) on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_setMaxMessageSize","params":[234567],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
```
***
#### shh_setMinPoW
Sets the minimal PoW required by this node.
This experimental function was introduced for the future dynamic adjustment of PoW requirement. If the node is overwhelmed with messages, it should raise the PoW requirement and notify the peers. The new value should be set relative to the old value (e.g. double). The old value could be obtained via shh_info call.
**Note** This function is currently experimental.
##### Parameters
1.`Number`: The new PoW requirement.
##### Returns
`Boolean`: `true` on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_setMinPoW","params":[12.3],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
```
***
#### shh_markTrustedPeer
Marks specific peer trusted, which will allow it to send historic (expired) messages.
**Note** This function is not adding new nodes, the node needs to exists as a peer.
##### Parameters
1.`String`: Enode of the trusted peer.
##### Returns
`Boolean` (`true`) on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_markTrustedPeer","params":["enode://d25474361659861e9e651bc728a17e807a3359ca0d344afd544ed0f11a31faecaf4d74b55db53c6670fd624f08d5c79adfc8da5dd4a11b9213db49a3b750845e@52.178.209.125:30379"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
```
***
#### shh_newKeyPair
Generates a new public and private key pair for message decryption and encryption.
##### Parameters
none
##### Returns
`String`: Key ID on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_newKeyPair","id":1}'
`String`: Key ID on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_addPrivateKey","params":["0x8bda3abeb454847b515fa9b404cede50b1cc63cfdeddd4999d074284b4c21e15"],"id":1}'
`Boolean`: `true` on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_deleteKeyPair","params":["5e57b9ffc2387e18636e0a3d0c56b023264c16e78a2adcba1303cefc685e610f"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
```
***
#### shh_hasKeyPair
Checks if the whisper node has a private key of a key pair matching the given ID.
##### Parameters
1.`String`: ID of key pair.
##### Returns
`Boolean`: (`true` or `false`) and error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_hasKeyPair","params":["5e57b9ffc2387e18636e0a3d0c56b023264c16e78a2adcba1303cefc685e610f"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": false
}
```
***
#### shh_getPublicKey
Returns the public key for identity ID.
##### Parameters
1.`String`: ID of key pair.
##### Returns
`String`: Public key on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_getPublicKey","params":["86e658cbc6da63120b79b5eec0c67d5dcfb6865a8f983eff08932477282b77bb"],"id":1}'
`String`: Private key on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_getPrivateKey","params":["0xc862bf3cf4565d46abcbadaf4712a8940bfea729a91b9b0e338eab5166341ab5"],"id":1}'
1.`String`: The raw key for symmetric encryption as HEX bytes.
##### Returns
`String`: Key ID on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_addSymKey","params":["0xf6dcf21ed6a17bd78d8c4c63195ab997b3b65ea683705501eae82d32667adc92"],"id":1}'
Deletes the key associated with the name string if it exists.
##### Parameters
1.`String`: key ID.
##### Returns
`Boolean` (`true` or `false`) on success and an error on failure.
##### Example
```js
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_deleteSymKey","params":["5e57b9ffc2387e18636e0a3d0c56b023264c16e78a2adcba1303cefc685e610f"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
```
***
#### shh_subscribe
Creates and registers a new subscription to receive notifications for inbound whisper messages. Returns the ID of the newly created subscription.
##### Parameters
1.`id` - `String`: identifier of function call. In case of Whisper must contain the value "messages".
2.`Object`. Options object with the following properties:
-`symKeyID` - `String`: ID of symmetric key for message decryption.
-`privateKeyID` - `String`: ID of private (asymmetric) key for message decryption.
-`sig` - `String` (optional): Public key of the signature.
-`minPow` - `Number` (optional): Minimal PoW requirement for incoming messages.
-`topics` - `Array` (optional when asym key): Array of possible topics (or partial topics).
-`allowP2P` - `Boolean` (optional): Indicates if this filter allows processing of direct peer-to-peer messages (which are not to be forwarded any further, because they might be expired). This might be the case in some very rare cases, e.g. if you intend to communicate to MailServers, etc.
Either `symKeyID` or `privateKeyID` must be present. Can not be both.
##### Returns
`String` - The subscription ID on success, the error on failure.
##### Notification Return
`Object`: The whisper message matching the subscription options, with the following parameters:
-`sig` - `String`: Public key who signed this message.
-`recipientPublicKey` - `String`: The recipients public key.
-`ttl` - `Number`: Time-to-live in seconds.
-`timestamp` - `Number`: Unix timestamp of the message genertion.
-`topic` - `String` 4 Bytes: Message topic.
-`payload` - `String`: Decrypted payload.
-`padding` - `String`: Optional padding (byte array of arbitrary length).
-`pow` - `Number`: Proof of work value.
-`hash` - `String`: Hash of the enveloved message.
##### Example
```
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_subscribe","params":["messages", {
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_unsubscribe","params":["02c1f5c953804acee3b68eda6c0afe3f1b4e0bec73c7445e10d45da333616412"],"id":1}'
// Result
{
"id":1,
"jsonrpc": "2.0",
"result": true
}
```
***
#### shh_newMessageFilter
Create a new filter within the node. This filter can be used to poll for new messages that match the set of criteria.
##### Parameters
1.`criteria` - `Object`: see [shh_subscribe](#shh_subscribe)
##### Returns
`String`: filter identifier
##### Example
```
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_newMessageFilter","params":[{"symKeyID": "3742c75e4232325d54143707e4b73d17c2f86a5e4abe3359021be5653f5b2c81"}],"id":1}' localhost:8545
1.`id` - `String`: filter identifier as returned when the filter was created
##### Returns
`Boolean`: `true` on success, error on failure.
##### Example
```
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_deleteMessageFilter","params":[{"symKeyID": "3742c75e4232325d54143707e4b73d17c2f86a5e4abe3359021be5653f5b2c81"}],"id":1}' localhost:8545
// Result
{"jsonrpc":"2.0","id":1,"result": true}
```
***
#### shh_getFilterMessages
Retrieve messages that match the filter criteria and are received between the last time this
function was called and now.
##### Parameters
1.`id` - `String`: ID of filter that was created with `shh_newMessageFilter`
##### Returns
`Array of messages`: `true` on success and an error on failure.
`Object`: whisper message:
-`sig` - `String`: Public key who signed this message.
-`ttl` - `Number`: Time-to-live in seconds.
-`timestamp` - `Number`: Unix timestamp of the message generation.
-`topic` - `String` 4 Bytes: Message topic.
-`payload` - `String`: Decrypted payload.
-`padding` - `String`: Optional padding (byte array of arbitrary length).
-`pow` - `Number`: Proof of work value.
-`hash` - `String`: Hash of the enveloped message.
-`recipientPublicKey` - `String`: recipient public key
##### Example
```
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"shh_getFilterMessages","params":["2b47fbafb3cce24570812a82e6e93cd9e2551bbc4823f6548ff0d82d2206b326"],"id":1}'
