127 lines
4.0 KiB
C
127 lines
4.0 KiB
C
#ifndef __LIBNIMBUS_H__
|
|
#define __LIBNIMBUS_H__
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct {
|
|
uint8_t* decoded;
|
|
size_t decodedLen;
|
|
uint8_t* source; /* 64 bytes public key, can be nil */
|
|
uint8_t* recipientPublicKey; /* 64 bytes public key, can be nil */
|
|
uint32_t timestamp;
|
|
uint32_t ttl;
|
|
uint8_t topic[4];
|
|
double pow;
|
|
uint8_t hash[32];
|
|
} received_message;
|
|
|
|
typedef struct {
|
|
const char* symKeyID; /* Identifier for symmetric key, set to nil if none */
|
|
const char* privateKeyID; /* Identifier for asymmetric key, set to nil if none */
|
|
uint8_t* source; /* 64 bytes public key, set to nil if none */
|
|
double minPow;
|
|
uint8_t topic[4]; /* Will default to 0x00000000 if not provided */
|
|
int allowP2P;
|
|
} filter_options;
|
|
|
|
typedef struct {
|
|
const char* symKeyID; /* Identifier for symmetric key, set to nil if none */
|
|
uint8_t* pubKey; /* 64 bytes public key, set to nil if none */
|
|
const char* sourceID; /* Identifier for asymmetric key, set to nil if none */
|
|
uint32_t ttl;
|
|
uint8_t topic[4]; /* Will default to 0x00000000 if not provided */
|
|
uint8_t* payload; /* Payload to be send, can be len=0 but can not be nil */
|
|
size_t payloadLen;
|
|
uint8_t* padding; /* Custom padding, can be set to nil */
|
|
size_t paddingLen;
|
|
double powTime;
|
|
double powTarget;
|
|
} post_message;
|
|
|
|
typedef struct {
|
|
uint8_t topic[4];
|
|
} topic;
|
|
|
|
typedef void (*received_msg_handler)(received_message* msg, void* udata);
|
|
|
|
/** Initialize Nim and the Status library. Must be called before anything else
|
|
* of the API. Also, all following calls must come from the same thread as from
|
|
* which this call was done.
|
|
*/
|
|
void NimMain();
|
|
|
|
/** Start Ethereum node with Whisper capability and connect to Status fleet.
|
|
* Optionally start discovery and listen for incoming connections.
|
|
* The minPow value is the minimum required PoW that this node will allow.
|
|
* When privkey is null, a new keypair will be generated.
|
|
*/
|
|
bool nimbus_start(uint16_t port, bool startListening, bool enableDiscovery,
|
|
double minPow, uint8_t* privkey, bool staging);
|
|
|
|
/** Add peers to connect to - must be called after nimbus_start */
|
|
bool nimbus_add_peer(const char* nodeId);
|
|
|
|
/**
|
|
* Should be called in regularly - for example in a busy loop (beautiful!) on
|
|
* dedicated thread.
|
|
*/
|
|
void nimbus_poll();
|
|
|
|
/** Asymmetric Keys API */
|
|
|
|
/** It is important that caller makes a copy of the returned strings before
|
|
* doing any other API calls. */
|
|
const char* nimbus_new_keypair();
|
|
const char* nimbus_add_keypair(const uint8_t* privkey);
|
|
bool nimbus_delete_keypair(const char* id);
|
|
bool nimbus_get_private_key(const char* id, uint8_t* privkey);
|
|
|
|
/** Symmetric Keys API */
|
|
|
|
/** It is important that caller makes a copy of the returned strings before
|
|
* doing any other API calls. */
|
|
const char* nimbus_add_symkey(const uint8_t* symkey);
|
|
const char* nimbus_add_symkey_from_password(const char* password);
|
|
bool nimbus_delete_symkey(const char* id);
|
|
bool nimbus_get_symkey(const char* id, uint8_t* symkey);
|
|
|
|
/** Whisper message posting and receiving API */
|
|
|
|
/** Subscribe to given filter. The void pointer udata will be passed to the
|
|
* received_msg_handler callback.
|
|
*/
|
|
const char* nimbus_subscribe_filter(filter_options* filter_options,
|
|
received_msg_handler msg, void* udata);
|
|
bool nimbus_unsubscribe_filter(const char* id);
|
|
/* Post Whisper message to the queue */
|
|
bool nimbus_post(post_message* msg);
|
|
|
|
/** TODO: why are following two getters needed? */
|
|
|
|
/** Get the minimum required PoW of this node */
|
|
double nimbus_get_min_pow();
|
|
|
|
/** Get the currently set bloom filter of this node. This will automatically
|
|
*update for each filter subsribed to.
|
|
*/
|
|
void nimbus_get_bloom_filter(uint8_t* bloomfilter);
|
|
|
|
/** Example helper, can be removed */
|
|
topic nimbus_channel_to_topic(const char* channel);
|
|
|
|
/** Very limited Status chat API */
|
|
void nimbus_post_public(const char* channel, const char* payload);
|
|
void nimbus_join_public_chat(const char* channel, received_msg_handler msg);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif //__LIBNIMBUS_H__
|