History

Andrea Maria Piana 1f6cccd0fc Add enabling/disabling of installations (#1264 ) This commit adds a list new table, installations, which is used to keep track of which installation are active for a given identity key. In general, we limit the number of installation that we keep synchronized to 5, to avoid excessive usage of resources. Any installation coming from our own identity, will have to be manually enabled, otherwise we trust the other peer has correctly paired their devices. We use a timestamp to decide which installations to keep synchronized as a logical clock would have make the creation of the bundle more complicated, but this can always be converted to a logical clock at later stages without breaking compatibility.		2018-11-06 09:05:32 +01:00
..
chat	Add enabling/disabling of installations (#1264 )	2018-11-06 09:05:32 +01:00
dedup	Use status-im whisper/whisperv6 module everywhere	2018-10-03 09:27:51 +03:00
README.md	Implement mailserver canary service. Closes #1086	2018-08-07 17:17:59 +02:00
api.go	Request historical messages in batches (#1245 )	2018-10-19 11:09:13 +02:00
api_test.go	allow multiple topics in mailserver requests (#1240 )	2018-10-15 23:15:04 +02:00
debug.go	Use status-im whisper/whisperv6 module everywhere	2018-10-03 09:27:51 +03:00
service.go	Add enabling/disabling of installations (#1264 )	2018-11-06 09:05:32 +01:00
service_test.go	Mailserver: return error response. (#1244 )	2018-10-18 12:25:00 +02:00
signal.go	Mailserver: return error response. (#1244 )	2018-10-18 12:25:00 +02:00

README.md

Whisper API Extension

API

shhext_getNewFilterMessages

Accepts the same input as shh_getFilterMessages.

Returns

Returns a list of whisper messages matching the specified filter. Filters out the messages already confirmed received by shhext_confirmMessagesProcessed

Deduplication is made using the whisper envelope content and topic only, so the same content received in different whisper envelopes will be deduplicated.

shhext_confirmMessagesProcessed

Confirms whisper messages received and processed on the client side. These messages won't appear anymore when shhext_getNewFilterMessages is called.

Parameters

Gets a list of whisper envelopes.

shhext_post

Accepts same input as shh_post.

Returns

DATA, 32 Bytes - the envelope hash

shhext_requestMessages

Sends a request for historic messages to a mail server.

Parameters

Object - The message request object:

mailServerPeer:URL - Mail servers' enode addess
from:QUANTITY - (optional) Lower bound of time range as unix timestamp, default is 24 hours back from now
to:QUANTITY- (optional) Upper bound of time range as unix timestamp, default is now
topic:DATA, 4 Bytes - Regular whisper topic
symKeyID:DATA- ID of a symmetric key to authenticate to mail server, derived from mail server password

Returns

Boolean - returns true if the request was send, otherwise false.

Signals

Sends sent signal once per envelope.

{
  "type": "envelope.sent",
  "event": {
    "hash": "0xea0b93079ed32588628f1cabbbb5ed9e4d50b7571064c2962c3853972db67790"
  }
}

Sends expired signal if envelope dropped from whisper local queue before it was sent to any peer on the network.

{
  "type": "envelope.expired",
  "event": {
    "hash": "0x754f4c12dccb14886f791abfeb77ffb86330d03d5a4ba6f37a8c21281988b69e"
  }
}