nim-chat-poc/library/liblogoschat.h

// Generated manually
#ifndef __liblogoschat__
#define __liblogoschat__

#include <stddef.h>
#include <stdint.h>

// The possible returned values for the functions that return int
#define RET_OK 0
#define RET_ERR 1
#define RET_MISSING_CALLBACK 2

#ifdef __cplusplus
extern "C" {
#endif

typedef void (*FFICallBack)(int callerRet, const char *msg, size_t len,
                            void *userData);

//////////////////////////////////////////////////////////////////////////////
// Client Lifecycle
//////////////////////////////////////////////////////////////////////////////

// Creates a new instance of the chat client.
// Sets up the chat client from the given configuration.
// Returns a pointer to the Context needed by the rest of the API functions.
// configJson: JSON object with fields:
//   - "name": string - identity name (default: "anonymous")
//   - "port": int - Waku port (optional)
//   - "clusterId": int - Waku cluster ID (optional)
//   - "shardId": int - Waku shard ID (optional)
//   - "staticPeers": array of strings - static peer multiaddrs (optional)
//   - "mixEnabled": bool - enable mix protocol for sender anonymity (default: false)
//   - "mixNodes": array of strings - mix bootstrap nodes as "multiaddr:mixPubKeyHex"
//   - "destPeerAddr": string - lightpush destination peer "multiaddr/p2p/peerId"
//   - "minMixPoolSize": int - minimum mix pool size before sending via mix (default: 4)
void *chat_new(const char *configJson, FFICallBack callback, void *userData);

// Start the chat client and begin listening for messages
int chat_start(void *ctx, FFICallBack callback, void *userData);

// Stop the chat client
int chat_stop(void *ctx, FFICallBack callback, void *userData);

// Destroys an instance of a chat client created with chat_new
int chat_destroy(void *ctx, FFICallBack callback, void *userData);

// Sets a callback that will be invoked whenever an event occurs.
// Events are JSON objects with "eventType" field:
//   - "new_message":
//   {"eventType":"new_message","conversationId":"...","messageId":"...","content":"hex...","timestamp":...}
//   - "new_conversation":
//   {"eventType":"new_conversation","conversationId":"...","conversationType":"private"}
//   - "delivery_ack":
//   {"eventType":"delivery_ack","conversationId":"...","messageId":"..."}
void set_event_callback(void *ctx, FFICallBack callback, void *userData);

//////////////////////////////////////////////////////////////////////////////
// Client Info
//////////////////////////////////////////////////////////////////////////////

// Get the client's identifier
int chat_get_id(void *ctx, FFICallBack callback, void *userData);

//////////////////////////////////////////////////////////////////////////////
// Conversation Operations
//////////////////////////////////////////////////////////////////////////////

// List all conversations as JSON array
// Returns: JSON array of objects with "id" field
int chat_list_conversations(void *ctx, FFICallBack callback, void *userData);

// Get a specific conversation by ID
// Returns: JSON object with "id" field
int chat_get_conversation(void *ctx, FFICallBack callback, void *userData,
                          const char *convoId);

// Create a new private conversation with the given IntroBundle
// introBundleStr: Intro bundle ASCII string as returned by chat_create_intro_bundle
// contentHex: Initial message content as hex-encoded string
int chat_new_private_conversation(void *ctx, FFICallBack callback,
                                  void *userData, const char *introBundleStr,
                                  const char *contentHex);

// Send a message to a conversation
// convoId: Conversation ID string
// contentHex: Message content as hex-encoded string
// Returns: Message ID on success
int chat_send_message(void *ctx, FFICallBack callback, void *userData,
                      const char *convoId, const char *contentHex);

//////////////////////////////////////////////////////////////////////////////
// Identity Operations
//////////////////////////////////////////////////////////////////////////////

// Get the client identity
// Returns JSON: {"name": "..."}
int chat_get_identity(void *ctx, FFICallBack callback, void *userData);

// Create an IntroBundle for initiating private conversations
// Returns the intro bundle as an ASCII string (format: logos_chatintro_<version>_<base64url payload>)
int chat_create_intro_bundle(void *ctx, FFICallBack callback, void *userData);

//////////////////////////////////////////////////////////////////////////////
// Mix Protocol Status
//////////////////////////////////////////////////////////////////////////////

// Get mix protocol status
// Returns JSON: {"mixEnabled":bool,"mixReady":bool,"mixPoolSize":int,"minPoolSize":int}
int chat_get_mix_status(void *ctx, FFICallBack callback, void *userData);

//////////////////////////////////////////////////////////////////////////////
// RLN Integration (for logos-core module wiring)
//////////////////////////////////////////////////////////////////////////////

// RLN fetcher callback type: C++ implements this, Nim calls it to get
// roots/proofs from the RLN module via LogosAPI IPC.
typedef int (*RlnFetcherFunc)(const char *method, const char *params,
    FFICallBack callback, void *callbackData, void *fetcherData);

// Register the RLN fetcher callback (called by C++ plugin during init)
void chat_set_rln_fetcher(void *ctx, RlnFetcherFunc fetcher, void *fetcherData);

// Set RLN configuration (account ID + leaf index in the on-chain tree)
int chat_set_rln_config(void *ctx, const char *configAccountId, int leafIndex);

// Set RLN identity credential (seed hex for proof generation)
void chat_set_rln_identity(void *ctx, const char *idSecretHashHex);

// Push valid merkle roots from RLN module events
void chat_push_roots(void *ctx, const char *rootsJson);

// Push merkle proof from RLN module events
void chat_push_proof(void *ctx, const char *proofJson);

#ifdef __cplusplus
}
#endif

#endif /* __liblogoschat__ */