mirror of https://github.com/vacp2p/rfc.git
1650 lines
112 KiB
HTML
1650 lines
112 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en" dir="ltr">
|
|
|
|
<head>
|
|
<meta name="generator" content="Hugo 0.106.0">
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="description" content="Introduction # Native applications that wish to integrate Waku may not be able to use nwaku and its JSON RPC API due to constraints on packaging, performance or executables.
|
|
An alternative is to link existing Waku implementation as a static or dynamic library in their application.
|
|
This specification describes the C API that SHOULD be implemented by native Waku library and that SHOULD be used to consume them.
|
|
Design requirements # The API should be generic enough, so:">
|
|
<meta name="theme-color" content="#FFFFFF"><meta property="og:title" content="36/WAKU2-BINDINGS-API" />
|
|
<meta property="og:description" content="Introduction # Native applications that wish to integrate Waku may not be able to use nwaku and its JSON RPC API due to constraints on packaging, performance or executables.
|
|
An alternative is to link existing Waku implementation as a static or dynamic library in their application.
|
|
This specification describes the C API that SHOULD be implemented by native Waku library and that SHOULD be used to consume them.
|
|
Design requirements # The API should be generic enough, so:" />
|
|
<meta property="og:type" content="article" />
|
|
<meta property="og:url" content="https://rfc.vac.dev/spec/36/" /><meta property="article:section" content="docs" />
|
|
|
|
|
|
|
|
<title>36/WAKU2-BINDINGS-API | Vac RFC</title>
|
|
<link rel="manifest" href="/manifest.json">
|
|
<link rel="icon" href="/favicon.png" type="image/x-icon">
|
|
<link rel="stylesheet" href="/book.min.e935e20bd0d469378cb482f0958edf258c731a4f895dccd55799c6fbc8043f23.css" integrity="sha256-6TXiC9DUaTeMtILwlY7fJYxzGk+JXczVV5nG+8gEPyM=">
|
|
<script defer src="/en.search.min.07668e91447d4b5e23bc427fda23768cc7456c7564bfc4b25421bc181027a261.js" integrity="sha256-B2aOkUR9S14jvEJ/2iN2jMdFbHVkv8SyVCG8GBAnomE="></script>
|
|
<!--
|
|
Made with Book Theme
|
|
https://github.com/alex-shpak/hugo-book
|
|
-->
|
|
|
|
|
|
</head>
|
|
|
|
<body dir="ltr">
|
|
<input type="checkbox" class="hidden toggle" id="menu-control" />
|
|
<input type="checkbox" class="hidden toggle" id="toc-control" />
|
|
<main class="container flex">
|
|
<aside class="book-menu">
|
|
<div class="book-menu-content">
|
|
|
|
<nav>
|
|
<h2 class="book-brand">
|
|
<a href="/"><span>Vac RFC</span>
|
|
</a>
|
|
</h2>
|
|
|
|
|
|
<div class="book-search">
|
|
<input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
|
|
<div class="book-search-spinner hidden"></div>
|
|
<ul id="book-search-results"></ul>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
<li>Raw
|
|
<ul>
|
|
<li><a href="/spec/20/">20/TOY-ETH-PM</a></li>
|
|
<li><a href="/spec/24/">24/STATUS-CURATION</a></li>
|
|
<li><a href="/spec/28/">28/STATUS-FEATURING</a></li>
|
|
<li><a href="/spec/31/">31/WAKU2-ENR</a></li>
|
|
<li><a href="/spec/32/">32/RLN-V1</a></li>
|
|
<li><a href="/spec/34/">34/WAKU2-PEER-EXCHANGE</a></li>
|
|
<li><a href="/spec/35/">35/WAKU2-NOISE</a></li>
|
|
<li><a href="/spec/37/">37/WAKU2-NOISE-SESSIONS</a></li>
|
|
<li><a href="/spec/38/">38/CONSENSUS-CLARO</a></li>
|
|
<li><a href="/spec/43/">43/WAKU2-NOISE-PAIRING</a></li>
|
|
<li><a href="/spec/44/">44/WAKU2-DANDELION</a></li>
|
|
<li><a href="/spec/45/">45/WAKU2-ADVERSARIAL-MODELS</a></li>
|
|
<li><a href="/spec/46/">46/GOSSIPSUB-TOR-PUSH</a></li>
|
|
<li><a href="/spec/47/">47/WAKU2-TOR-PUSH</a></li>
|
|
<li><a href="/spec/48/">48/RLN-INTEREP-SPEC</a></li>
|
|
<li><a href="/spec/51/">51/WAKU2-RELAY-SHARDING</a></li>
|
|
<li><a href="/spec/52/">52/WAKU2-RELAY-STATIC-SHARD-ALLOC</a></li>
|
|
<li><a href="/spec/57/">57/STATUS-Simple-Scaling</a></li>
|
|
<li><a href="/spec/58/">58/RLN-V2</a></li>
|
|
<li><a href="/spec/61/">61/STATUS-Community-History-Archives</a></li>
|
|
<li><a href="/spec/63/">63/STATUS-Keycard-Usage</a></li>
|
|
<li><a href="/spec/64/">64/WAKU2-NETWORK</a></li>
|
|
</ul>
|
|
</li>
|
|
<li>Draft
|
|
<ul>
|
|
<li><a href="/spec/1/">1/COSS</a></li>
|
|
<li><a href="/spec/3/">3/REMOTE-LOG</a></li>
|
|
<li><a href="/spec/4/">4/MVDS-META</a></li>
|
|
<li><a href="/spec/10/">10/WAKU2</a></li>
|
|
<li><a href="/spec/12/">12/WAKU2-FILTER</a></li>
|
|
<li><a href="/spec/13/">13/WAKU2-STORE</a></li>
|
|
<li><a href="/spec/14/">14/WAKU2-MESSAGE</a></li>
|
|
<li><a href="/spec/15/">15/WAKU2-BRIDGE</a></li>
|
|
<li><a href="/spec/16/">16/WAKU2-RPC</a></li>
|
|
<li><a href="/spec/17/">17/WAKU2-RLN-RELAY</a></li>
|
|
<li><a href="/spec/18/">18/WAKU2-SWAP</a></li>
|
|
<li><a href="/spec/19/">19/WAKU2-LIGHTPUSH</a></li>
|
|
<li><a href="/spec/21/">21/WAKU2-FTSTORE</a></li>
|
|
<li><a href="/spec/22/">22/TOY-CHAT</a></li>
|
|
<li><a href="/spec/23/">23/WAKU2-TOPICS</a></li>
|
|
<li><a href="/spec/26/">26/WAKU2-PAYLOAD</a></li>
|
|
<li><a href="/spec/27/">27/WAKU2-PEERS</a></li>
|
|
<li><a href="/spec/29/">29/WAKU2-CONFIG</a></li>
|
|
<li><a href="/spec/30/">30/ADAPTIVE-NODES</a></li>
|
|
<li><a href="/spec/33/">33/WAKU2-DISCV5</a></li>
|
|
<li><a href="/spec/36/"class=active>36/WAKU2-BINDINGS-API</a></li>
|
|
<li><a href="/spec/53/">53/WAKU2-X3DH</a></li>
|
|
<li><a href="/spec/54/">54/WAKU2-X3DH-SESSIONS</a></li>
|
|
<li><a href="/spec/55/">55/STATUS-1TO1-CHAT</a></li>
|
|
<li><a href="/spec/56/">56/STATUS-COMMUNITIES</a></li>
|
|
</ul>
|
|
</li>
|
|
<li>Stable
|
|
<ul>
|
|
<li><a href="/spec/2/">2/MVDS</a></li>
|
|
<li><a href="/spec/6/">6/WAKU1</a></li>
|
|
<li><a href="/spec/7/">7/WAKU-DATA</a></li>
|
|
<li><a href="/spec/8/">8/WAKU-MAIL</a></li>
|
|
<li><a href="/spec/9/">9/WAKU-RPC</a></li>
|
|
<li><a href="/spec/11/">11/WAKU2-RELAY</a></li>
|
|
</ul>
|
|
</li>
|
|
<li>Deprecated
|
|
<ul>
|
|
<li><a href="/spec/5/">5/WAKU0</a></li>
|
|
</ul>
|
|
</li>
|
|
<li>Retired</li>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</nav>
|
|
|
|
|
|
|
|
|
|
<script>(function(){var e=document.querySelector("aside.book-menu nav");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
|
|
|
|
|
|
|
|
</div>
|
|
</aside>
|
|
|
|
<div class="book-page">
|
|
<header class="book-header">
|
|
|
|
<div class="flex align-center justify-between">
|
|
<label for="menu-control">
|
|
<img src="/svg/menu.svg" class="book-icon" alt="Menu" />
|
|
</label>
|
|
|
|
<strong>36/WAKU2-BINDINGS-API</strong>
|
|
|
|
<label for="toc-control">
|
|
|
|
<img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
|
|
|
|
</label>
|
|
</div>
|
|
|
|
|
|
|
|
<aside class="hidden clearfix">
|
|
|
|
|
|
<nav id="TableOfContents">
|
|
<ul>
|
|
<li><a href="#introduction">Introduction</a></li>
|
|
<li><a href="#design-requirements">Design requirements</a></li>
|
|
<li><a href="#the-api">The API</a>
|
|
<ul>
|
|
<li><a href="#general">General</a>
|
|
<ul>
|
|
<li><a href="#jsonresponse-type"><code>JsonResponse</code> type</a></li>
|
|
<li><a href="#jsonmessage-type"><code>JsonMessage</code> type</a></li>
|
|
<li><a href="#decodedpayload-type"><code>DecodedPayload</code> type</a></li>
|
|
<li><a href="#filtersubscription-type"><code>FilterSubscription</code> type</a></li>
|
|
<li><a href="#contentfilter-type"><code>ContentFilter</code> type</a></li>
|
|
<li><a href="#storequery-type"><code>StoreQuery</code> type</a></li>
|
|
<li><a href="#storeresponse-type"><code>StoreResponse</code> type</a></li>
|
|
<li><a href="#pagingoptions-type"><code>PagingOptions</code> type</a></li>
|
|
<li><a href="#index-type"><code>Index</code> type</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#events">Events</a>
|
|
<ul>
|
|
<li><a href="#jsonsignal-type"><code>JsonSignal</code> type</a></li>
|
|
<li><a href="#jsonmessageevent-type"><code>JsonMessageEvent</code> type</a></li>
|
|
<li><a href="#extern-void-waku_set_event_callbackvoid-cb"><code>extern void waku_set_event_callback(void* cb)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#node-management">Node management</a>
|
|
<ul>
|
|
<li><a href="#jsonconfig-type"><code>JsonConfig</code> type</a></li>
|
|
<li><a href="#gossipsubparameters-type"><code>GossipsubParameters</code> type</a></li>
|
|
<li><a href="#extern-unsigned-int-waku_newchar-jsonconfig-char-jsonresp"><code>extern unsigned int waku_new(char* jsonConfig, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_startchar-jsonresp"><code>extern unsigned int waku_start(char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_stopchar-jsonresp"><code>extern unsigned int waku_stop(char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_peerid"><code>extern char* waku_peerid()</code></a></li>
|
|
<li><a href="#extern-char-waku_listen_addresses"><code>extern char* waku_listen_addresses()</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#connecting-to-peers">Connecting to peers</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>extern char* waku_add_peer(char* address, char* protocolId)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_connectchar-address-int-timeoutms-char-jsonresp"><code>extern unsigned int waku_connect(char* address, int timeoutMs, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_connect_peeridchar-peerid-int-timeoutms"><code>extern char* waku_connect_peerid(char* peerId, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_disconnectchar-peerid"><code>extern char* waku_disconnect(char* peerId)</code></a></li>
|
|
<li><a href="#extern-char-waku_peer_count"><code>extern char* waku_peer_count()</code></a></li>
|
|
<li><a href="#extern-char-waku_peers"><code>extern char* waku_peers()</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-relay">Waku Relay</a>
|
|
<ul>
|
|
<li><a href="#extern-void-waku_content_topicchar-applicationname-unsigned-int-applicationversion-char-contenttopicname-char-encoding-char-outcontenttopic"><code>extern void waku_content_topic(char* applicationName, unsigned int applicationVersion, char* contentTopicName, char* encoding, char* outContentTopic)</code></a></li>
|
|
<li><a href="#extern-char-waku_pubsub_topicchar-name-char-encoding-char-outpubsubtopic"><code>extern char* waku_pubsub_topic(char* name, char* encoding, char* outPubsubTopic)</code></a></li>
|
|
<li><a href="#extern-void-waku_default_pubsub_topicchar-defaultpubsubtopic"><code>extern void waku_default_pubsub_topic(char* defaultPubsubTopic)</code></a></li>
|
|
<li><a href="#extern-unsinged-int-waku_relay_publishchar-messagejson-char-pubsubtopic-int-timeoutms-char-jsonresp"><code>extern unsinged int waku_relay_publish(char* messageJson, char* pubsubTopic, int timeoutMs, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-publickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_relay_publish_enc_asymmetric(char* messageJson, char* pubsubTopic, char* publicKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-symmetrickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_relay_publish_enc_symmetric(char* messageJson, char* pubsubTopic, char* symmetricKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_enough_peerschar-pubsubtopic"><code>extern char* waku_relay_enough_peers(char* pubsubTopic)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_relay_subscribechar-topic-char-jsonresp"><code>extern unsigned int waku_relay_subscribe(char* topic, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_relay_unsubscribechar-topic-char-jsonresp"><code>extern unsigned int waku_relay_unsubscribe(char* topic, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_topics"><code>extern char* waku_relay_topics()</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-filter">Waku Filter</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_filter_subscribechar-filterjson-char-peerid-int-timeoutms"><code>extern char* waku_filter_subscribe(char* filterJSON, char* peerID, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_filter_unsubscribechar-filterjson-int-timeoutms"><code>extern char* waku_filter_unsubscribe(char* filterJSON, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-lightpush">Waku Lightpush</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_lightpush_publishchar-messagejson-char-topic-char-peerid-int-timeoutms"><code>extern char* waku_lightpush_publish(char* messageJSON, char* topic, char* peerID, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_lightpush_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-peerid-char-publickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_lightpush_publish_enc_asymmetric(char* messageJson, char* pubsubTopic, char* peerID, char* publicKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_lightpush_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-peerid-char-symmetrickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_lightpush_publish_enc_symmetric(char* messageJson, char* pubsubTopic, char* peerID, char* symmetricKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-store">Waku Store</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_store_querychar-queryjson-char-peerid-int-timeoutms"><code>extern char* waku_store_query(char* queryJSON, char* peerID, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#decrypting-messages">Decrypting messages</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_decode_symmetricchar-messagejson-char-symmetrickey"><code>extern char* waku_decode_symmetric(char* messageJson, char* symmetricKey)</code></a></li>
|
|
<li><a href="#extern-char-waku_decode_asymmetricchar-messagejson-char-privatekey"><code>extern char* waku_decode_asymmetric(char* messageJson, char* privateKey)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#dns-discovery">DNS Discovery</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_dns_discoverychar-url-char-nameserver-int-timeoutms"><code>extern char* waku_dns_discovery(char* url, char* nameserver, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#utils">Utils</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_utils_base64_encodechar-data"><code>extern char* waku_utils_base64_encode(char* data)</code></a></li>
|
|
<li><a href="#extern-char-waku_utils_base64_decodechar-data"><code>extern char* waku_utils_base64_decode(char* data)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#copyright">Copyright</a></li>
|
|
</ul>
|
|
</nav>
|
|
|
|
|
|
|
|
</aside>
|
|
|
|
|
|
</header>
|
|
|
|
|
|
|
|
<article class="markdown">
|
|
<h1 id="36waku2-bindings-api">
|
|
36/WAKU2-BINDINGS-API
|
|
<a class="anchor" href="#36waku2-bindings-api">#</a>
|
|
</h1>
|
|
|
|
|
|
<h1 id="waku-v2-c-bindings-api">
|
|
Waku v2 C Bindings API
|
|
<a class="anchor" href="#waku-v2-c-bindings-api">#</a>
|
|
</h1>
|
|
|
|
|
|
|
|
|
|
|
|
<img src="https://img.shields.io/badge/status-draft-blue?style=flat-square" />
|
|
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
<li>Status: draft</li>
|
|
<li>Editor: Richard Ramos <a href="mailto:richard@status.im">richard@status.im</a></li>
|
|
|
|
<li>Contributors:
|
|
|
|
|
|
Franck Royer <a href="mailto:franck@status.im">franck@status.im</a>
|
|
|
|
</li>
|
|
|
|
</ul><h1 id="introduction">
|
|
Introduction
|
|
<a class="anchor" href="#introduction">#</a>
|
|
</h1>
|
|
<p>Native applications that wish to integrate Waku may not be able to use nwaku and its JSON RPC API due to constraints
|
|
on packaging, performance or executables.</p>
|
|
<p>An alternative is to link existing Waku implementation as a static or dynamic library in their application.</p>
|
|
<p>This specification describes the C API that SHOULD be implemented by native Waku library and that SHOULD be used to
|
|
consume them.</p>
|
|
<h1 id="design-requirements">
|
|
Design requirements
|
|
<a class="anchor" href="#design-requirements">#</a>
|
|
</h1>
|
|
<p>The API should be generic enough, so:</p>
|
|
<ul>
|
|
<li>it can be implemented by both nwaku and go-waku C-Bindings,</li>
|
|
<li>it can be consumed from a variety of languages such as C#, Kotlin, Swift, Rust, C++, etc.</li>
|
|
</ul>
|
|
<p>The selected format to pass data to and from the API is <code>JSON</code>.</p>
|
|
<p>It has been selected due to its widespread usage and easiness of use. Other alternatives MAY replace it in the future (C
|
|
structure, protobuf) if it brings limitations that need to be lifted.</p>
|
|
<h1 id="the-api">
|
|
The API
|
|
<a class="anchor" href="#the-api">#</a>
|
|
</h1>
|
|
<h2 id="general">
|
|
General
|
|
<a class="anchor" href="#general">#</a>
|
|
</h2>
|
|
<h3 id="jsonresponse-type">
|
|
<code>JsonResponse</code> type
|
|
<a class="anchor" href="#jsonresponse-type">#</a>
|
|
</h3>
|
|
<p>All the API functions return a <code>JsonResponse</code> unless specified otherwise. The returned <code>JsonResponse</code> is a <code>char *</code> whose format depends on whether the function was executed successfully or not. And it is important to notice that this returned <code>JsonReponse</code> is returned from the latest argument, instead of from the actual function’s returned value.</p>
|
|
<p>On failure:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">error</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"error"</span>: <span style="color:#e6db74">"the error message"</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>On success:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">result</span>: <span style="color:#66d9ef">any</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>The type of the <code>result</code> object depends on the function it was returned by.</p>
|
|
<h3 id="jsonmessage-type">
|
|
<code>JsonMessage</code> type
|
|
<a class="anchor" href="#jsonmessage-type">#</a>
|
|
</h3>
|
|
<p>A Waku Message in JSON Format:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">payload</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">contentTopic</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">version</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">timestamp</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>payload</code>: base64 encoded payload, <a href="#extern-char-waku_utils_base64_encodechar-data"><code>waku_utils_base64_encode</code></a> can be used for this.</li>
|
|
<li><code>contentTopic</code>: The content topic to be set on the message.</li>
|
|
<li><code>version</code>: The Waku Message version number.</li>
|
|
<li><code>timestamp</code>: Unix timestamp in nanoseconds.</li>
|
|
</ul>
|
|
<h3 id="decodedpayload-type">
|
|
<code>DecodedPayload</code> type
|
|
<a class="anchor" href="#decodedpayload-type">#</a>
|
|
</h3>
|
|
<p>A payload once decoded, used when a received Waku Message is encrypted:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span><span style="color:#66d9ef">interface</span> <span style="color:#a6e22e">DecodedPayload</span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pubkey?</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">signature?</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">data</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">padding</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>pubkey</code>: Public key that signed the message (optional), hex encoded with <code>0x</code> prefix,</li>
|
|
<li><code>signature</code>: Message signature (optional), hex encoded with <code>0x</code> prefix,</li>
|
|
<li><code>data</code>: Decrypted message payload base64 encoded,</li>
|
|
<li><code>padding</code>: Padding base64 encoded.</li>
|
|
</ul>
|
|
<h3 id="filtersubscription-type">
|
|
<code>FilterSubscription</code> type
|
|
<a class="anchor" href="#filtersubscription-type">#</a>
|
|
</h3>
|
|
<p>The criteria to create subscription to a light node in JSON Format:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">contentFilters</span>: <span style="color:#66d9ef">ContentFilter</span>[];
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pubsubTopic</span>: <span style="color:#66d9ef">string?</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>contentFilters</code>: Array of <a href="#contentfilter-type"><code>ContentFilter</code></a> being subscribed to / unsubscribed from.</li>
|
|
<li><code>topic</code>: Optional pubsub topic.</li>
|
|
</ul>
|
|
<h3 id="contentfilter-type">
|
|
<code>ContentFilter</code> type
|
|
<a class="anchor" href="#contentfilter-type">#</a>
|
|
</h3>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">contentTopic</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>contentTopic</code>: The content topic of a Waku message.</li>
|
|
</ul>
|
|
<h3 id="storequery-type">
|
|
<code>StoreQuery</code> type
|
|
<a class="anchor" href="#storequery-type">#</a>
|
|
</h3>
|
|
<p>Criteria used to retrieve historical messages</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span><span style="color:#66d9ef">interface</span> <span style="color:#a6e22e">StoreQuery</span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pubsubTopic?</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">contentFilters?</span>: <span style="color:#66d9ef">ContentFilter</span>[];
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">startTime?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">endTime?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pagingOptions?</span>: <span style="color:#66d9ef">PagingOptions</span>
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>pubsubTopic</code>: The pubsub topic on which messages are published.</li>
|
|
<li><code>contentFilters</code>: Array of <a href="#contentfilter-type"><code>ContentFilter</code></a> to query for historical messages,</li>
|
|
<li><code>startTime</code>: The inclusive lower bound on the timestamp of queried messages. This field holds the Unix epoch time in nanoseconds.</li>
|
|
<li><code>endTime</code>: The inclusive upper bound on the timestamp of queried messages. This field holds the Unix epoch time in nanoseconds.</li>
|
|
<li><code>pagingOptions</code>: Paging information in <a href="#pagingoptions-type"><code>PagingOptions</code></a> format.</li>
|
|
</ul>
|
|
<h3 id="storeresponse-type">
|
|
<code>StoreResponse</code> type
|
|
<a class="anchor" href="#storeresponse-type">#</a>
|
|
</h3>
|
|
<p>The response received after doing a query to a store node:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span><span style="color:#66d9ef">interface</span> <span style="color:#a6e22e">StoreResponse</span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">messages</span>: <span style="color:#66d9ef">JsonMessage</span>[];
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pagingOptions?</span>: <span style="color:#66d9ef">PagingOptions</span>;
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>messages</code>: Array of retrieved historical messages in <a href="#jsonmessage-type"><code>JsonMessage</code></a> format.</li>
|
|
<li><code>pagingOption</code>: Paging information in <a href="#pagingoptions-type"><code>PagingOptions</code></a> format from which to resume further historical queries</li>
|
|
</ul>
|
|
<h3 id="pagingoptions-type">
|
|
<code>PagingOptions</code> type
|
|
<a class="anchor" href="#pagingoptions-type">#</a>
|
|
</h3>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span><span style="color:#66d9ef">interface</span> <span style="color:#a6e22e">PagingOptions</span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pageSize</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">cursor?</span>: <span style="color:#66d9ef">Index</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">forward</span>: <span style="color:#66d9ef">bool</span>;
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>pageSize</code>: Number of messages to retrieve per page.</li>
|
|
<li><code>cursor</code>: Message Index from which to perform pagination. If not included and forward is set to true, paging will be performed from the beginning of the list. If not included and forward is set to false, paging will be performed from the end of the list.</li>
|
|
<li><code>forward</code>: <code>true</code> if paging forward, <code>false</code> if paging backward</li>
|
|
</ul>
|
|
<h3 id="index-type">
|
|
<code>Index</code> type
|
|
<a class="anchor" href="#index-type">#</a>
|
|
</h3>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span><span style="color:#66d9ef">interface</span> <span style="color:#a6e22e">Index</span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">digest</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">receiverTime</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">senderTime</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pubsubTopic</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>digest</code>: Hash of the message at this <a href="#index-type"><code>Index</code></a>.</li>
|
|
<li><code>receiverTime</code>: UNIX timestamp in nanoseconds at which the message at this <a href="#index-type"><code>Index</code></a> was received.</li>
|
|
<li><code>senderTime</code>: UNIX timestamp in nanoseconds at which the message is generated by its sender.</li>
|
|
<li><code>pubsubTopic</code>: The pubsub topic of the message at this <a href="#index-type"><code>Index</code></a>.</li>
|
|
</ul>
|
|
<h2 id="events">
|
|
Events
|
|
<a class="anchor" href="#events">#</a>
|
|
</h2>
|
|
<p>Asynchronous events require a callback to be registered.
|
|
An example of an asynchronous event that might be emitted is receiving a message.
|
|
When an event is emitted, this callback will be triggered receiving a JSON string of type <code>JsonSignal</code>.</p>
|
|
<h3 id="jsonsignal-type">
|
|
<code>JsonSignal</code> type
|
|
<a class="anchor" href="#jsonsignal-type">#</a>
|
|
</h3>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#66d9ef">type</span><span style="color:#f92672">:</span> <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">event</span>: <span style="color:#66d9ef">any</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<ul>
|
|
<li><code>type</code>: Type of signal being emitted. Currently, only <code>message</code> is available.</li>
|
|
<li><code>event</code>: Format depends on the type of signal.</li>
|
|
</ul>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"message"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"event"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"subscriptionId"</span>: <span style="color:#ae81ff">1</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"pubsubTopic"</span>: <span style="color:#e6db74">"/waku/2/default-waku/proto"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"messageId"</span>: <span style="color:#e6db74">"0x6496491e40dbe0b6c3a2198c2426b16301688a2daebc4f57ad7706115eac3ad1"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"wakuMessage"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"payload"</span>: <span style="color:#e6db74">"TODO"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"contentTopic"</span>: <span style="color:#e6db74">"/my-app/1/notification/proto"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"version"</span>: <span style="color:#ae81ff">1</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"timestamp"</span>: <span style="color:#ae81ff">1647826358000000000</span>
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><table>
|
|
<thead>
|
|
<tr>
|
|
<th style="text-align:left"><code>type</code></th>
|
|
<th><code>event</code> Type</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td style="text-align:left"><code>message</code></td>
|
|
<td><code>JsonMessageEvent</code></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h3 id="jsonmessageevent-type">
|
|
<code>JsonMessageEvent</code> type
|
|
<a class="anchor" href="#jsonmessageevent-type">#</a>
|
|
</h3>
|
|
<p>Type of <code>event</code> field for a <code>message</code> event:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">pubsubTopic</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">messageId</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">wakuMessage</span>: <span style="color:#66d9ef">JsonMessage</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><ul>
|
|
<li><code>pubsubTopic</code>: The pubsub topic on which the message was received.</li>
|
|
<li><code>messageId</code>: The message id.</li>
|
|
<li><code>wakuMessage</code>: The message in <a href="#jsonmessage-type"><code>JsonMessage</code></a> format.</li>
|
|
</ul>
|
|
<h3 id="extern-void-waku_set_event_callbackvoid-cb">
|
|
<code>extern void waku_set_event_callback(void* cb)</code>
|
|
<a class="anchor" href="#extern-void-waku_set_event_callbackvoid-cb">#</a>
|
|
</h3>
|
|
<p>Register callback to act as event handler and receive application signals,
|
|
which are used to react to asynchronous events in Waku.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>void* cb</code>: callback that will be executed when an async event is emitted.
|
|
The function signature for the callback should be <code>void myCallback(char* jsonSignal)</code></li>
|
|
</ol>
|
|
<h2 id="node-management">
|
|
Node management
|
|
<a class="anchor" href="#node-management">#</a>
|
|
</h2>
|
|
<h3 id="jsonconfig-type">
|
|
<code>JsonConfig</code> type
|
|
<a class="anchor" href="#jsonconfig-type">#</a>
|
|
</h3>
|
|
<p>Type holding a node configuration:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span><span style="color:#66d9ef">interface</span> <span style="color:#a6e22e">JsonConfig</span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">host?</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">port?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">advertiseAddr?</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">nodeKey?</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">keepAliveInterval?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">relay?</span>: <span style="color:#66d9ef">boolean</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">relayTopics?</span>: <span style="color:#66d9ef">Array</span><<span style="color:#f92672">string</span>>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">gossipsubParameters?</span>: <span style="color:#66d9ef">GossipSubParameters</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">minPeersToPublish?</span>: <span style="color:#66d9ef">number</span>
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">filter?</span>: <span style="color:#66d9ef">boolean</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">discV5?</span>: <span style="color:#66d9ef">boolean</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">discV5BootstrapNodes?</span>: <span style="color:#66d9ef">Array</span><<span style="color:#f92672">string</span>>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">discV5UDPPort?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">store?</span>: <span style="color:#66d9ef">boolean</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">databaseURL?</span>: <span style="color:#66d9ef">string</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">storeRetentionMaxMessages?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">storeRetentionTimeSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<p>All fields are optional.
|
|
If a key is <code>undefined</code>, or <code>null</code>, a default value will be set.</p>
|
|
<ul>
|
|
<li><code>host</code>: Listening IP address.
|
|
Default <code>0.0.0.0</code>.</li>
|
|
<li><code>port</code>: Libp2p TCP listening port.
|
|
Default <code>60000</code>.
|
|
Use <code>0</code> for random.</li>
|
|
<li><code>advertiseAddr</code>: External address to advertise to other nodes.
|
|
Can be ip4, ip6 or dns4, dns6.
|
|
If <code>null</code>, the multiaddress(es) generated from the ip and port specified in the config (or default ones) will be used.
|
|
Default: <code>null</code>.</li>
|
|
<li><code>nodeKey</code>: Secp256k1 private key in Hex format (<code>0x123...abc</code>).
|
|
Default random.</li>
|
|
<li><code>keepAliveInterval</code>: Interval in seconds for pinging peers to keep the connection alive.
|
|
Default <code>20</code>.</li>
|
|
<li><code>relay</code>: Enable relay protocol.
|
|
Default <code>true</code>.</li>
|
|
<li><code>relayTopics</code>: Array of pubsub topics that WakuRelay will automatically subscribe to when the node
|
|
starts
|
|
Default <code>[]</code></li>
|
|
<li><code>gossipSubParameters</code>: custom gossipsub parameters. See <code>GossipSubParameters</code> section for defaults</li>
|
|
<li><code>minPeersToPublish</code>: The minimum number of peers required on a topic to allow broadcasting a message.
|
|
Default <code>0</code>.</li>
|
|
<li><code>filter</code>: Enable filter protocol.
|
|
Default <code>false</code>.</li>
|
|
<li><code>discV5</code>: Enable DiscoveryV5.
|
|
Default <code>false</code></li>
|
|
<li><code>discV5BootstrapNodes</code>: Array of bootstrap nodes ENR</li>
|
|
<li><code>discV5UDPPort</code>: UDP port for DiscoveryV5
|
|
Default <code>9000</code></li>
|
|
<li><code>store</code>: Enable store protocol to persist message history
|
|
Default <code>false</code></li>
|
|
<li><code>databaseURL</code>: url connection string. Accepts SQLite and PostgreSQL connection strings
|
|
Default: <code>sqlite3://store.db</code></li>
|
|
<li><code>storeRetentionMaxMessages</code>: max number of messages to store in the database.
|
|
Default <code>10000</code></li>
|
|
<li><code>storeRetentionTimeSeconds</code>: max number of seconds that a message will be persisted in the database.
|
|
Default <code>2592000</code> (30d)
|
|
For example:</li>
|
|
</ul>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"host"</span>: <span style="color:#e6db74">"0.0.0.0"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"port"</span>: <span style="color:#ae81ff">60000</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"advertiseAddr"</span>: <span style="color:#e6db74">"1.2.3.4"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"nodeKey"</span>: <span style="color:#e6db74">"0x123...567"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"keepAliveInterval"</span>: <span style="color:#ae81ff">20</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"relay"</span>: <span style="color:#66d9ef">true</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"minPeersToPublish"</span>: <span style="color:#ae81ff">0</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="gossipsubparameters-type">
|
|
<code>GossipsubParameters</code> type
|
|
<a class="anchor" href="#gossipsubparameters-type">#</a>
|
|
</h3>
|
|
<p>Type holding custom gossipsub configuration:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-ts" data-lang="ts"><span style="display:flex;"><span><span style="color:#66d9ef">interface</span> <span style="color:#a6e22e">GossipSubParameters</span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">D?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">D_low?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">D_high?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">D_score?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">D_out?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">HistoryLength?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">HistoryGossip?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">D_lazy?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">GossipFactor?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">GossipRetransmission?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">HeartbeatInitialDelayMs?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">HeartbeatIntervalSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">SlowHeartbeatWarning?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">FanoutTTLSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">PrunePeers?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">PruneBackoffSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">UnsubscribeBackoffSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">Connectors?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">MaxPendingConnections?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">ConnectionTimeoutSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">DirectConnectTicks?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">DirectConnectInitialDelaySeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">OpportunisticGraftTicks?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">OpportunisticGraftPeers?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">GraftFloodThresholdSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">MaxIHaveLength?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">MaxIHaveMessages?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span> <span style="color:#a6e22e">IWantFollowupTimeSeconds?</span>: <span style="color:#66d9ef">number</span>;
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Fields:</p>
|
|
<p>All fields are optional.
|
|
If a key is <code>undefined</code>, or <code>null</code>, a default value will be set.</p>
|
|
<ul>
|
|
<li><code>d</code>: optimal degree for a GossipSub topic mesh.
|
|
Default <code>6</code></li>
|
|
<li><code>dLow</code>: lower bound on the number of peers we keep in a GossipSub topic mesh
|
|
Default <code>5</code></li>
|
|
<li><code>dHigh</code>: upper bound on the number of peers we keep in a GossipSub topic mesh.
|
|
Default <code>12</code></li>
|
|
<li><code>dScore</code>: affects how peers are selected when pruning a mesh due to over subscription.
|
|
Default <code>4</code></li>
|
|
<li><code>dOut</code>: sets the quota for the number of outbound connections to maintain in a topic mesh.
|
|
Default <code>2</code></li>
|
|
<li><code>historyLength</code>: controls the size of the message cache used for gossip.
|
|
Default <code>5</code></li>
|
|
<li><code>historyGossip</code>: controls how many cached message ids we will advertise in IHAVE gossip messages.
|
|
Default <code>3</code></li>
|
|
<li><code>dLazy</code>: affects how many peers we will emit gossip to at each heartbeat.
|
|
Default <code>6</code></li>
|
|
<li><code>gossipFactor</code>: affects how many peers we will emit gossip to at each heartbeat.
|
|
Default <code>0.25</code></li>
|
|
<li><code>gossipRetransmission</code>: controls how many times we will allow a peer to request the same message id through IWANT gossip before we start ignoring them.
|
|
Default <code>3</code></li>
|
|
<li><code>heartbeatInitialDelayMs</code>: short delay in milliseconds before the heartbeat timer begins after the router is initialized.
|
|
Default <code>100</code> milliseconds</li>
|
|
<li><code>heartbeatIntervalSeconds</code>: controls the time between heartbeats.
|
|
Default <code>1</code> second</li>
|
|
<li><code>slowHeartbeatWarning</code>: duration threshold for heartbeat processing before emitting a warning.
|
|
Default <code>0.1</code></li>
|
|
<li><code>fanoutTTLSeconds</code>: controls how long we keep track of the fanout state.
|
|
Default <code>60</code> seconds</li>
|
|
<li><code>prunePeers</code>: controls the number of peers to include in prune Peer eXchange.
|
|
Default <code>16</code></li>
|
|
<li><code>pruneBackoffSeconds</code>: controls the backoff time for pruned peers.
|
|
Default <code>60</code> seconds</li>
|
|
<li><code>unsubscribeBackoffSeconds</code>: controls the backoff time to use when unsuscribing from a topic.
|
|
Default <code>10</code> seconds</li>
|
|
<li><code>connectors</code>: number of active connection attempts for peers obtained through PX.
|
|
Default <code>8</code></li>
|
|
<li><code>maxPendingConnections</code>: maximum number of pending connections for peers attempted through px.
|
|
Default <code>128</code></li>
|
|
<li><code>connectionTimeoutSeconds</code>: timeout in seconds for connection attempts.
|
|
Default <code>30</code> seconds</li>
|
|
<li><code>directConnectTicks</code>: the number of heartbeat ticks for attempting to reconnect direct peers that are not currently connected.
|
|
Default <code>300</code></li>
|
|
<li><code>directConnectInitialDelaySeconds</code>: initial delay before opening connections to direct peers.
|
|
Default <code>1</code> second</li>
|
|
<li><code>opportunisticGraftTicks</code>: number of heartbeat ticks for attempting to improve the mesh with opportunistic grafting.
|
|
Default <code>60</code></li>
|
|
<li><code>opportunisticGraftPeers</code>: the number of peers to opportunistically graft.
|
|
Default <code>2</code></li>
|
|
<li><code>graftFloodThresholdSeconds</code>: If a GRAFT comes before GraftFloodThresholdSeconds has elapsed since the last PRUNE, then there is an extra score penalty applied to the peer through P7.
|
|
Default <code>10</code> seconds</li>
|
|
<li><code>maxIHaveLength</code>: max number of messages to include in an IHAVE message, also controls the max number of IHAVE ids we will accept and request with IWANT from a peer within a heartbeat.
|
|
Default <code>5000</code></li>
|
|
<li><code>maxIHaveMessages</code>: max number of IHAVE messages to accept from a peer within a heartbeat.
|
|
Default <code>10</code></li>
|
|
<li><code>iWantFollowupTimeSeconds</code>: Time to wait for a message requested through IWANT following an IHAVE advertisement.
|
|
Default <code>3</code> seconds</li>
|
|
<li><code>seenMessagesTTLSeconds</code>: configures when a previously seen message ID can be forgotten about.
|
|
Default <code>120</code> seconds</li>
|
|
</ul>
|
|
<h3 id="extern-unsigned-int-waku_newchar-jsonconfig-char-jsonresp">
|
|
<code>extern unsigned int waku_new(char* jsonConfig, char* jsonResp)</code>
|
|
<a class="anchor" href="#extern-unsigned-int-waku_newchar-jsonconfig-char-jsonresp">#</a>
|
|
</h3>
|
|
<p>Instantiates a Waku node.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li>
|
|
<p><strong>[input]</strong> <code>char* jsonConfig</code>: JSON string containing the options used to initialize a waku node.
|
|
Type <a href="#jsonconfig-type"><code>JsonConfig</code></a>.
|
|
It can be <code>NULL</code> to use defaults.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong>[output]</strong> <code>char* jsonResp</code>: <a href="#jsonresponse-type"><code>JsonResponse</code></a>. Provides information indicating whether the operation succeded or not. In case or error, it tries to give as much detail as possible.</p>
|
|
<p>Ex1:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Ex2:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"error"</span>: <span style="color:#e6db74">"The node key is missing."</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div></li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>Unsigned int. Possible values:</p>
|
|
<ul>
|
|
<li>1 - The operation was completed successfuly.</li>
|
|
<li>0 - The operation failed for any reason. It worth checking the value of <code>jsonResp</code> in this case.</li>
|
|
</ul>
|
|
<h3 id="extern-unsigned-int-waku_startchar-jsonresp">
|
|
<code>extern unsigned int waku_start(char* jsonResp)</code>
|
|
<a class="anchor" href="#extern-unsigned-int-waku_startchar-jsonresp">#</a>
|
|
</h3>
|
|
<p>Starts a Waku node mounting all the protocols that were enabled during the Waku node instantiation.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li>
|
|
<p><strong>[output]</strong> <code>char* jsonResp</code>: <a href="#jsonresponse-type"><code>JsonResponse</code></a>. Provides information indicating whether the operation succeded or not. In case or error, it tries to give as much detail as possible.</p>
|
|
<p>Ex:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div></li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>Unsigned int. Possible values:</p>
|
|
<ul>
|
|
<li>1 - The operation was completed successfuly.</li>
|
|
<li>0 - The operation failed for any reason. It worth checking the value of <code>jsonResp</code> in this case.</li>
|
|
</ul>
|
|
<h3 id="extern-unsigned-int-waku_stopchar-jsonresp">
|
|
<code>extern unsigned int waku_stop(char* jsonResp)</code>
|
|
<a class="anchor" href="#extern-unsigned-int-waku_stopchar-jsonresp">#</a>
|
|
</h3>
|
|
<p>Stops a Waku node.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li>
|
|
<p><strong>[output]</strong> <code>char* jsonResp</code>: <a href="#jsonresponse-type"><code>JsonResponse</code></a>. Provides information indicating whether the operation succeded or not. In case or error, it tries to give as much detail as possible.</p>
|
|
<p>Ex:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div></li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>Unsigned int. Possible values:</p>
|
|
<ul>
|
|
<li>1 - The operation was completed successfuly.</li>
|
|
<li>0 - The operation failed for any reason. It worth checking the value of <code>jsonResp</code> in this case.</li>
|
|
</ul>
|
|
<h3 id="extern-char-waku_peerid">
|
|
<code>extern char* waku_peerid()</code>
|
|
<a class="anchor" href="#extern-char-waku_peerid">#</a>
|
|
</h3>
|
|
<p>Get the peer ID of the waku node.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the peer ID as a <code>string</code> (base58 encoded).</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#e6db74">"QmWjHKUrXDHPCwoWXpUZ77E8o6UbAoTTZwf1AD1tDC4KNP"</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-char-waku_listen_addresses">
|
|
<code>extern char* waku_listen_addresses()</code>
|
|
<a class="anchor" href="#extern-char-waku_listen_addresses">#</a>
|
|
</h3>
|
|
<p>Get the multiaddresses the Waku node is listening to.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains an array of multiaddresses.
|
|
The multiaddresses are <code>string</code>s.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: [
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/ip4/127.0.0.1/tcp/30303"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/ip4/1.2.3.4/tcp/30303"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/dns4/waku.node.example/tcp/8000/wss"</span>
|
|
</span></span><span style="display:flex;"><span> ]
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h2 id="connecting-to-peers">
|
|
Connecting to peers
|
|
<a class="anchor" href="#connecting-to-peers">#</a>
|
|
</h2>
|
|
<h3 id="extern-char-waku_add_peerchar-address-char-protocolid">
|
|
<code>extern char* waku_add_peer(char* address, char* protocolId)</code>
|
|
<a class="anchor" href="#extern-char-waku_add_peerchar-address-char-protocolid">#</a>
|
|
</h3>
|
|
<p>Add a node multiaddress and protocol to the waku node’s peerstore.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* address</code>: A multiaddress (with peer id) to reach the peer being added.</li>
|
|
<li><code>char* protocolId</code>: A protocol we expect the peer to support.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the peer ID as a base58 <code>string</code> of the peer that was added.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#e6db74">"QmWjHKUrXDHPCwoWXpUZ77E8o6UbAoTTZwf1AD1tDC4KNP"</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-unsigned-int-waku_connectchar-address-int-timeoutms-char-jsonresp">
|
|
<code>extern unsigned int waku_connect(char* address, int timeoutMs, char* jsonResp)</code>
|
|
<a class="anchor" href="#extern-unsigned-int-waku_connectchar-address-int-timeoutms-char-jsonresp">#</a>
|
|
</h3>
|
|
<p>Dial peer using a multiaddress.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li>
|
|
<p><strong>[input]</strong> <code>char* address</code>: A multiaddress to reach the peer being dialed.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong>[input]</strong> <code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong>[output]</strong> <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field is set to <code>true</code>.</p>
|
|
<p>Ex1:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p>Ex2:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"error"</span>: <span style="color:#e6db74">"Timeout expired."</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div></li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>Unsigned int. Possible values:</p>
|
|
<ul>
|
|
<li>1 - The operation was completed successfuly.</li>
|
|
<li>0 - The operation failed for any reason. It worth checking the value of <code>jsonResp</code> in this case.</li>
|
|
</ul>
|
|
<h3 id="extern-char-waku_connect_peeridchar-peerid-int-timeoutms">
|
|
<code>extern char* waku_connect_peerid(char* peerId, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_connect_peeridchar-peerid-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Dial peer using its peer ID.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<p>1<code>char* peerID</code>: Peer ID to dial.
|
|
The peer must be already known.
|
|
It must have been added before with <a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>waku_add_peer</code></a>
|
|
or previously dialed with <a href="#extern-char-waku_connectchar-address-int-timeoutms"><code>waku_connect</code></a>.
|
|
2. <code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field is set to <code>true</code>.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-char-waku_disconnectchar-peerid">
|
|
<code>extern char* waku_disconnect(char* peerId)</code>
|
|
<a class="anchor" href="#extern-char-waku_disconnectchar-peerid">#</a>
|
|
</h3>
|
|
<p>Disconnect a peer using its peerID</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* peerID</code>: Peer ID to disconnect.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field is set to <code>true</code>.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-char-waku_peer_count">
|
|
<code>extern char* waku_peer_count()</code>
|
|
<a class="anchor" href="#extern-char-waku_peer_count">#</a>
|
|
</h3>
|
|
<p>Get number of connected peers.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains an <code>integer</code> which represents the number of connected peers.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#ae81ff">0</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-char-waku_peers">
|
|
<code>extern char* waku_peers()</code>
|
|
<a class="anchor" href="#extern-char-waku_peers">#</a>
|
|
</h3>
|
|
<p>Retrieve the list of peers known by the Waku node.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a> containing a list of peers.
|
|
The list of peers has this format:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: [
|
|
</span></span><span style="display:flex;"><span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"peerID"</span>: <span style="color:#e6db74">"16Uiu2HAmJb2e28qLXxT5kZxVUUoJt72EMzNGXB47RedcBafeDCBA"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"protocols"</span>: [
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/ipfs/id/1.0.0"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/vac/waku/relay/2.0.0"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/ipfs/ping/1.0.0"</span>
|
|
</span></span><span style="display:flex;"><span> ],
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"addrs"</span>: [
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/ip4/1.2.3.4/tcp/30303"</span>
|
|
</span></span><span style="display:flex;"><span> ],
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"connected"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span> ]
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h2 id="waku-relay">
|
|
Waku Relay
|
|
<a class="anchor" href="#waku-relay">#</a>
|
|
</h2>
|
|
<h3 id="extern-void-waku_content_topicchar-applicationname-unsigned-int-applicationversion-char-contenttopicname-char-encoding-char-outcontenttopic">
|
|
<code>extern void waku_content_topic(char* applicationName, unsigned int applicationVersion, char* contentTopicName, char* encoding, char* outContentTopic)</code>
|
|
<a class="anchor" href="#extern-void-waku_content_topicchar-applicationname-unsigned-int-applicationversion-char-contenttopicname-char-encoding-char-outcontenttopic">#</a>
|
|
</h3>
|
|
<p>Create a content topic string according to <a href="https://rfc.vac.dev/spec/23/">RFC 23</a>.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><strong>[input]</strong> <code>char* applicationName</code></li>
|
|
<li><strong>[input]</strong> <code>unsigned int applicationVersion</code></li>
|
|
<li><strong>[input]</strong> <code>char* contentTopicName</code></li>
|
|
<li><strong>[input]</strong> <code>char* encoding</code>: depending on the payload, use <code>proto</code>, <code>rlp</code> or <code>rfc26</code></li>
|
|
<li><strong>[output]</strong> <code>char* outContentTopic</code>. Gets populated with a content topic formatted according to <a href="https://rfc.vac.dev/spec/23/">RFC 23</a>.
|
|
<pre tabindex="0"><code>/{application-name}/{version-of-the-application}/{content-topic-name}/{encoding}
|
|
</code></pre></li>
|
|
</ol>
|
|
<h3 id="extern-char-waku_pubsub_topicchar-name-char-encoding-char-outpubsubtopic">
|
|
<code>extern char* waku_pubsub_topic(char* name, char* encoding, char* outPubsubTopic)</code>
|
|
<a class="anchor" href="#extern-char-waku_pubsub_topicchar-name-char-encoding-char-outpubsubtopic">#</a>
|
|
</h3>
|
|
<p>Create a pubsub topic string according to <a href="https://rfc.vac.dev/spec/23/">RFC 23</a>.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><strong>[input]</strong> <code>char* name</code></li>
|
|
<li><strong>[input]</strong> <code>char* encoding</code>: depending on the payload, use <code>proto</code>, <code>rlp</code> or <code>rfc26</code></li>
|
|
<li><strong>[output]</strong> <code>char* outPubsubTopic</code>. Gets populated with a pubsub topic formatted according to <a href="https://rfc.vac.dev/spec/23/">RFC 23</a>.
|
|
<pre tabindex="0"><code>/waku/2/{topic-name}/{encoding}
|
|
</code></pre></li>
|
|
</ol>
|
|
<h3 id="extern-void-waku_default_pubsub_topicchar-defaultpubsubtopic">
|
|
<code>extern void waku_default_pubsub_topic(char* defaultPubsubTopic)</code>
|
|
<a class="anchor" href="#extern-void-waku_default_pubsub_topicchar-defaultpubsubtopic">#</a>
|
|
</h3>
|
|
<p>Returns the default pubsub topic used for exchanging waku messages defined in <a href="https://rfc.vac.dev/spec/10/">RFC 10</a>.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><strong>[output]</strong> <code>char* defaultPubsubTopic</code>. Gets populated with <code>/waku/2/default-waku/proto</code></li>
|
|
</ol>
|
|
<h3 id="extern-unsinged-int-waku_relay_publishchar-messagejson-char-pubsubtopic-int-timeoutms-char-jsonresp">
|
|
<code>extern unsinged int waku_relay_publish(char* messageJson, char* pubsubTopic, int timeoutMs, char* jsonResp)</code>
|
|
<a class="anchor" href="#extern-unsinged-int-waku_relay_publishchar-messagejson-char-pubsubtopic-int-timeoutms-char-jsonresp">#</a>
|
|
</h3>
|
|
<p>Publish a message using Waku Relay.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><strong>[input]</strong> <code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><strong>[input]</strong> <code>char* pubsubTopic</code>: pubsub topic on which to publish the message.
|
|
If <code>NULL</code>, it uses the default pubsub topic.</li>
|
|
<li><strong>[input]</strong> <code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
<li><strong>[output]</strong>: A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the message ID.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is overwritten to <code>0</code>.</p>
|
|
<p><strong>Returns</strong>
|
|
Unsigned int. Possible values:</p>
|
|
<ul>
|
|
<li>1 - The operation was completed successfuly.</li>
|
|
<li>0 - The operation failed for any reason. It worth checking the value of <code>jsonResp</code> in this case.</li>
|
|
</ul>
|
|
<h3 id="extern-char-waku_relay_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-publickey-char-optionalsigningkey-int-timeoutms">
|
|
<code>extern char* waku_relay_publish_enc_asymmetric(char* messageJson, char* pubsubTopic, char* publicKey, char* optionalSigningKey, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_relay_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-publickey-char-optionalsigningkey-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Optionally sign,
|
|
encrypt using asymmetric encryption
|
|
and publish a message using Waku Relay.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><code>char* pubsubTopic</code>: pubsub topic on which to publish the message.
|
|
If <code>NULL</code>, it uses the default pubsub topic.</li>
|
|
<li><code>char* publicKey</code>: hex encoded public key to be used for encryption.</li>
|
|
<li><code>char* optionalSigningKey</code>: hex encoded private key to be used to sign the message.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is overwritten to <code>1</code>.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the message ID.</p>
|
|
<h3 id="extern-char-waku_relay_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-symmetrickey-char-optionalsigningkey-int-timeoutms">
|
|
<code>extern char* waku_relay_publish_enc_symmetric(char* messageJson, char* pubsubTopic, char* symmetricKey, char* optionalSigningKey, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_relay_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-symmetrickey-char-optionalsigningkey-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Optionally sign,
|
|
encrypt using symmetric encryption
|
|
and publish a message using Waku Relay.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><code>char* pubsubTopic</code>: pubsub topic on which to publish the message.
|
|
If <code>NULL</code>, it uses the default pubsub topic.</li>
|
|
<li><code>char* symmetricKey</code>: hex encoded secret key to be used for encryption.</li>
|
|
<li><code>char* optionalSigningKey</code>: hex encoded private key to be used to sign the message.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is overwritten to <code>1</code>.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the message ID.</p>
|
|
<h3 id="extern-char-waku_relay_enough_peerschar-pubsubtopic">
|
|
<code>extern char* waku_relay_enough_peers(char* pubsubTopic)</code>
|
|
<a class="anchor" href="#extern-char-waku_relay_enough_peerschar-pubsubtopic">#</a>
|
|
</h3>
|
|
<p>Determine if there are enough peers to publish a message on a given pubsub topic.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* pubsubTopic</code>: Pubsub topic to verify.
|
|
If <code>NULL</code>, it verifies the number of peers in the default pubsub topic.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains a <code>boolean</code> indicating whether there are enough peers.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-unsigned-int-waku_relay_subscribechar-topic-char-jsonresp">
|
|
<code>extern unsigned int waku_relay_subscribe(char* topic, char* jsonResp)</code>
|
|
<a class="anchor" href="#extern-unsigned-int-waku_relay_subscribechar-topic-char-jsonresp">#</a>
|
|
</h3>
|
|
<p>Subscribe to a Waku Relay pubsub topic to receive messages.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li>
|
|
<p><strong>[input]</strong> <code>char* topic</code>: Pubsub topic to subscribe to.
|
|
If <code>NULL</code>, it subscribes to the default pubsub topic.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong>[output]</strong> <code>char* jsonResp</code>: A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field is set to <code>true</code>.</p>
|
|
<p>Ex1:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"error"</span>: <span style="color:#e6db74">"Cannot subscribe without Waku Relay enabled."</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div></li>
|
|
</ol>
|
|
<p><strong>Returns</strong>
|
|
Unsigned int. Possible values:</p>
|
|
<ul>
|
|
<li>1 - The operation was completed successfuly.</li>
|
|
<li>0 - The operation failed for any reason. It worth checking the value of <code>jsonResp</code> in this case.</li>
|
|
</ul>
|
|
<p><strong>Events</strong></p>
|
|
<p>When a message is received, a ``“message”<code> event</code> is emitted containing the message, pubsub topic, and node ID in which
|
|
the message was received.</p>
|
|
<p>The <code>event</code> type is <a href="#jsonmessageevent-type"><code>JsonMessageEvent</code></a>.</p>
|
|
<p>For Example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"message"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"event"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"pubsubTopic"</span>: <span style="color:#e6db74">"/waku/2/default-waku/proto"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"messageId"</span>: <span style="color:#e6db74">"0x6496491e40dbe0b6c3a2198c2426b16301688a2daebc4f57ad7706115eac3ad1"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"wakuMessage"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"payload"</span>: <span style="color:#e6db74">"TODO"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"contentTopic"</span>: <span style="color:#e6db74">"/my-app/1/notification/proto"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"version"</span>: <span style="color:#ae81ff">1</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"timestamp"</span>: <span style="color:#ae81ff">1647826358000000000</span>
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-unsigned-int-waku_relay_unsubscribechar-topic-char-jsonresp">
|
|
<code>extern unsigned int waku_relay_unsubscribe(char* topic, char* jsonResp)</code>
|
|
<a class="anchor" href="#extern-unsigned-int-waku_relay_unsubscribechar-topic-char-jsonresp">#</a>
|
|
</h3>
|
|
<p>Closes the pubsub subscription to a pubsub topic. No more messages will be received
|
|
from this pubsub topic.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li>
|
|
<p><strong>[input]</strong> <code>char* pusubTopic</code>: Pubsub topic to unsubscribe from.
|
|
If <code>NULL</code>, unsubscribes from the default pubsub topic.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong>[output]</strong> A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field is set to <code>true</code>.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div></li>
|
|
</ol>
|
|
<p><strong>Returns</strong>
|
|
Unsigned int. Possible values:</p>
|
|
<ul>
|
|
<li>1 - The operation was completed successfuly.</li>
|
|
<li>0 - The operation failed for any reason. It worth checking the value of <code>jsonResp</code> in this case.</li>
|
|
</ul>
|
|
<h3 id="extern-char-waku_relay_topics">
|
|
<code>extern char* waku_relay_topics()</code>
|
|
<a class="anchor" href="#extern-char-waku_relay_topics">#</a>
|
|
</h3>
|
|
<p>Get the list of subscribed pubsub topics in Waku Relay.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field will contain an array of pubsub topics.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: [<span style="color:#e6db74">"pubsubTopic1"</span>, <span style="color:#e6db74">"pubsubTopic2"</span>]
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h2 id="waku-filter">
|
|
Waku Filter
|
|
<a class="anchor" href="#waku-filter">#</a>
|
|
</h2>
|
|
<h3 id="extern-char-waku_filter_subscribechar-filterjson-char-peerid-int-timeoutms">
|
|
<code>extern char* waku_filter_subscribe(char* filterJSON, char* peerID, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_filter_subscribechar-filterjson-char-peerid-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Creates a subscription in a lightnode for messages that matches a content filter and optionally a <a href="https://github.com/libp2p/specs/blob/master/pubsub/README.md#the-topic-descriptor">PubSub <code>topic</code></a>.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* filterJSON</code>: JSON string containing the <a href="#filtersubscription-type"><code>FilterSubscription</code></a> to subscribe to.</li>
|
|
<li><code>char* peerID</code>: Peer ID to subscribe to.
|
|
The peer must be already known.
|
|
It must have been added before with <a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>waku_add_peer</code></a>
|
|
or previously dialed with <a href="#extern-char-waku_connect_peerchar-address-int-timeoutms"><code>waku_connect_peer</code></a>.
|
|
Use <code>NULL</code> to automatically select a node.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field is set to <code>true</code>.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><p><strong>Events</strong></p>
|
|
<p>When a message is received, a ``“message”<code> event</code> is emitted containing the message, pubsub topic, and node ID in which
|
|
the message was received.</p>
|
|
<p>The <code>event</code> type is <a href="#jsonmessageevent-type"><code>JsonMessageEvent</code></a>.</p>
|
|
<p>For Example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"message"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"event"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"pubsubTopic"</span>: <span style="color:#e6db74">"/waku/2/default-waku/proto"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"messageId"</span>: <span style="color:#e6db74">"0x6496491e40dbe0b6c3a2198c2426b16301688a2daebc4f57ad7706115eac3ad1"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"wakuMessage"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"payload"</span>: <span style="color:#e6db74">"TODO"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"contentTopic"</span>: <span style="color:#e6db74">"/my-app/1/notification/proto"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"version"</span>: <span style="color:#ae81ff">1</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"timestamp"</span>: <span style="color:#ae81ff">1647826358000000000</span>
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-char-waku_filter_unsubscribechar-filterjson-int-timeoutms">
|
|
<code>extern char* waku_filter_unsubscribe(char* filterJSON, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_filter_unsubscribechar-filterjson-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Removes subscriptions in a light node matching a content filter and, optionally, a <a href="https://github.com/libp2p/specs/blob/master/pubsub/README.md#the-topic-descriptor">PubSub <code>topic</code></a>.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* filterJSON</code>: JSON string containing the <a href="#filtersubscription-type"><code>FilterSubscription</code></a>.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field is set to <code>true</code>.</p>
|
|
<p>For example:</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: <span style="color:#66d9ef">true</span>
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h2 id="waku-lightpush">
|
|
Waku Lightpush
|
|
<a class="anchor" href="#waku-lightpush">#</a>
|
|
</h2>
|
|
<h3 id="extern-char-waku_lightpush_publishchar-messagejson-char-topic-char-peerid-int-timeoutms">
|
|
<code>extern char* waku_lightpush_publish(char* messageJSON, char* topic, char* peerID, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_lightpush_publishchar-messagejson-char-topic-char-peerid-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Publish a message using Waku Lightpush.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><code>char* pubsubTopic</code>: pubsub topic on which to publish the message.
|
|
If <code>NULL</code>, it uses the default pubsub topic.</li>
|
|
<li><code>char* peerID</code>: Peer ID supporting the lightpush protocol.
|
|
The peer must be already known.
|
|
It must have been added before with <a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>waku_add_peer</code></a>
|
|
or previously dialed with <a href="#extern-char-waku_connect_peerchar-address-int-timeoutms"><code>waku_connect_peer</code></a>.
|
|
Use <code>NULL</code> to automatically select a node.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is overwritten to <code>0</code>.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the message ID.</p>
|
|
<h3 id="extern-char-waku_lightpush_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-peerid-char-publickey-char-optionalsigningkey-int-timeoutms">
|
|
<code>extern char* waku_lightpush_publish_enc_asymmetric(char* messageJson, char* pubsubTopic, char* peerID, char* publicKey, char* optionalSigningKey, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_lightpush_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-peerid-char-publickey-char-optionalsigningkey-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Optionally sign,
|
|
encrypt using asymmetric encryption
|
|
and publish a message using Waku Lightpush.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><code>char* pubsubTopic</code>: pubsub topic on which to publish the message.
|
|
If <code>NULL</code>, it uses the default pubsub topic.</li>
|
|
<li><code>char* peerID</code>: Peer ID supporting the lightpush protocol.
|
|
The peer must be already known.
|
|
It must have been added before with <a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>waku_add_peer</code></a>
|
|
or previously dialed with <a href="#extern-char-waku_connect_peerchar-address-int-timeoutms"><code>waku_connect_peer</code></a>.</li>
|
|
<li><code>char* publicKey</code>: hex encoded public key to be used for encryption.</li>
|
|
<li><code>char* optionalSigningKey</code>: hex encoded private key to be used to sign the message.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is overwritten to <code>1</code>.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the message ID.</p>
|
|
<h3 id="extern-char-waku_lightpush_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-peerid-char-symmetrickey-char-optionalsigningkey-int-timeoutms">
|
|
<code>extern char* waku_lightpush_publish_enc_symmetric(char* messageJson, char* pubsubTopic, char* peerID, char* symmetricKey, char* optionalSigningKey, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_lightpush_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-peerid-char-symmetrickey-char-optionalsigningkey-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Optionally sign,
|
|
encrypt using symmetric encryption
|
|
and publish a message using Waku Lightpush.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><code>char* pubsubTopic</code>: pubsub topic on which to publish the message.
|
|
If <code>NULL</code>, it uses the default pubsub topic.</li>
|
|
<li><code>char* peerID</code>: Peer ID supporting the lightpush protocol.
|
|
The peer must be already known.
|
|
It must have been added before with <a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>waku_add_peer</code></a>
|
|
or previously dialed with <a href="#extern-char-waku_connect_peerchar-address-int-timeoutms"><code>waku_connect_peer</code></a>.</li>
|
|
<li><code>char* symmetricKey</code>: hex encoded secret key to be used for encryption.</li>
|
|
<li><code>char* optionalSigningKey</code>: hex encoded private key to be used to sign the message.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is overwritten to <code>1</code>.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the message ID.</p>
|
|
<h2 id="waku-store">
|
|
Waku Store
|
|
<a class="anchor" href="#waku-store">#</a>
|
|
</h2>
|
|
<h3 id="extern-char-waku_store_querychar-queryjson-char-peerid-int-timeoutms">
|
|
<code>extern char* waku_store_query(char* queryJSON, char* peerID, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_store_querychar-queryjson-char-peerid-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Retrieves historical messages on specific content topics. This method may be called with <a href="#pagingoptions-type"><code>PagingOptions</code></a>,
|
|
to retrieve historical messages on a per-page basis. If the request included <a href="#pagingoptions-type"><code>PagingOptions</code></a>, the node
|
|
must return messages on a per-page basis and include <a href="#pagingoptions-type"><code>PagingOptions</code></a> in the response. These <a href="#pagingoptions-type"><code>PagingOptions</code></a>
|
|
must contain a cursor pointing to the Index from which a new page can be requested.</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* queryJSON</code>: JSON string containing the <a href="#storequery-type"><code>StoreQuery</code></a>.</li>
|
|
<li><code>char* peerID</code>: Peer ID supporting the store protocol.
|
|
The peer must be already known.
|
|
It must have been added before with <a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>waku_add_peer</code></a>
|
|
or previously dialed with <a href="#extern-char-waku_connect_peerchar-address-int-timeoutms"><code>waku_connect_peer</code></a>.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains a <a href="#storeresponse-type"><code>StoreResponse</code></a>..</p>
|
|
<h2 id="decrypting-messages">
|
|
Decrypting messages
|
|
<a class="anchor" href="#decrypting-messages">#</a>
|
|
</h2>
|
|
<h3 id="extern-char-waku_decode_symmetricchar-messagejson-char-symmetrickey">
|
|
<code>extern char* waku_decode_symmetric(char* messageJson, char* symmetricKey)</code>
|
|
<a class="anchor" href="#extern-char-waku_decode_symmetricchar-messagejson-char-symmetrickey">#</a>
|
|
</h3>
|
|
<p>Decrypt a message using a symmetric key</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><code>char* symmetricKey</code>: 32 byte symmetric key hex encoded.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is expected to be <code>1</code>.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the decoded payload as a <a href="#decodedpayload-type"><code>DecodedPayload</code></a>.
|
|
An <code>error</code> message otherwise.</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"pubkey"</span>: <span style="color:#e6db74">"0x......"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"signature"</span>: <span style="color:#e6db74">"0x...."</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"data"</span>: <span style="color:#e6db74">"..."</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"padding"</span>: <span style="color:#e6db74">"..."</span>
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h3 id="extern-char-waku_decode_asymmetricchar-messagejson-char-privatekey">
|
|
<code>extern char* waku_decode_asymmetric(char* messageJson, char* privateKey)</code>
|
|
<a class="anchor" href="#extern-char-waku_decode_asymmetricchar-messagejson-char-privatekey">#</a>
|
|
</h3>
|
|
<p>Decrypt a message using a secp256k1 private key</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* messageJson</code>: JSON string containing the <a href="https://rfc.vac.dev/spec/14/">Waku Message</a> as <a href="#jsonmessage-type"><code>JsonMessage</code></a>.</li>
|
|
<li><code>char* privateKey</code>: secp256k1 private key hex encoded.</li>
|
|
</ol>
|
|
<p>Note: <code>messageJson.version</code> is expected to be <code>1</code>.</p>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the decoded payload as a <a href="#decodedpayload-type"><code>DecodedPayload</code></a>.
|
|
An <code>error</code> message otherwise.</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>: {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"pubkey"</span>: <span style="color:#e6db74">"0x......"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"signature"</span>: <span style="color:#e6db74">"0x...."</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"data"</span>: <span style="color:#e6db74">"..."</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"padding"</span>: <span style="color:#e6db74">"..."</span>
|
|
</span></span><span style="display:flex;"><span> }
|
|
</span></span><span style="display:flex;"><span>}
|
|
</span></span></code></pre></div><h2 id="dns-discovery">
|
|
DNS Discovery
|
|
<a class="anchor" href="#dns-discovery">#</a>
|
|
</h2>
|
|
<h3 id="extern-char-waku_dns_discoverychar-url-char-nameserver-int-timeoutms">
|
|
<code>extern char* waku_dns_discovery(char* url, char* nameserver, int timeoutMs)</code>
|
|
<a class="anchor" href="#extern-char-waku_dns_discoverychar-url-char-nameserver-int-timeoutms">#</a>
|
|
</h3>
|
|
<p>Returns a list of multiaddress given a url to a DNS discoverable ENR tree</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* url</code>: URL containing a discoverable ENR tree</li>
|
|
<li><code>char* nameserver</code>: The nameserver to resolve the ENR tree url.
|
|
If <code>NULL</code> or empty, it will automatically use the default system dns.</li>
|
|
<li><code>int timeoutMs</code>: Timeout value in milliseconds to execute the call.
|
|
If the function execution takes longer than this value,
|
|
the execution will be canceled and an error returned.
|
|
Use <code>0</code> for no timeout.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains an array objects describing the multiaddresses, enr and peerID each node found.
|
|
An <code>error</code> message otherwise.</p>
|
|
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"result"</span>:[
|
|
</span></span><span style="display:flex;"><span> {
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"peerID"</span>:<span style="color:#e6db74">"16Uiu2HAmPLe7Mzm8TsYUubgCAW1aJoeFScxrLj8ppHFivPo97bUZ"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"multiaddrs"</span>:[
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/ip4/134.209.139.210/tcp/30303/p2p/16Uiu2HAmPLe7Mzm8TsYUubgCAW1aJoeFScxrLj8ppHFivPo97bUZ"</span>,
|
|
</span></span><span style="display:flex;"><span> <span style="color:#e6db74">"/dns4/node-01.do-ams3.wakuv2.test.statusim.net/tcp/8000/wss/p2p/16Uiu2HAmPLe7Mzm8TsYUubgCAW1aJoeFScxrLj8ppHFivPo97bUZ"</span>
|
|
</span></span><span style="display:flex;"><span> ],
|
|
</span></span><span style="display:flex;"><span> <span style="color:#f92672">"enr"</span>:<span style="color:#e6db74">"enr:-M-4QCtJKX2WDloRYDT4yjeMGKUCRRcMlsNiZP3cnPO0HZn6IdJ035RPCqsQ5NvTyjqHzKnTM6pc2LoKliV4CeV0WrgBgmlkgnY0gmlwhIbRi9KKbXVsdGlhZGRyc7EALzYobm9kZS0wMS5kby1hbXMzLndha3V2Mi50ZXN0LnN0YXR1c2ltLm5ldAYfQN4DiXNlY3AyNTZrMaEDnr03Tuo77930a7sYLikftxnuG3BbC3gCFhA4632ooDaDdGNwgnZfg3VkcIIjKIV3YWt1Mg8"</span>
|
|
</span></span><span style="display:flex;"><span> },
|
|
</span></span><span style="display:flex;"><span> <span style="color:#960050;background-color:#1e0010">...</span>
|
|
</span></span><span style="display:flex;"><span><span style="color:#960050;background-color:#1e0010">}</span>
|
|
</span></span></code></pre></div><h2 id="utils">
|
|
Utils
|
|
<a class="anchor" href="#utils">#</a>
|
|
</h2>
|
|
<h3 id="extern-char-waku_utils_base64_encodechar-data">
|
|
<code>extern char* waku_utils_base64_encode(char* data)</code>
|
|
<a class="anchor" href="#extern-char-waku_utils_base64_encodechar-data">#</a>
|
|
</h3>
|
|
<p>Encode a byte array to base64.
|
|
Useful for creating the payload of a Waku Message in the format understood by <a href="#extern-char-waku_relay_publishchar-messagejson-char-pubsubtopic-int-timeoutms"><code>waku_relay_publish</code></a></p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* data</code>: Byte array to encode</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <code>char *</code> containing the base64 encoded byte array.</p>
|
|
<h3 id="extern-char-waku_utils_base64_decodechar-data">
|
|
<code>extern char* waku_utils_base64_decode(char* data)</code>
|
|
<a class="anchor" href="#extern-char-waku_utils_base64_decodechar-data">#</a>
|
|
</h3>
|
|
<p>Decode a base64 string (useful for reading the payload from Waku Messages).</p>
|
|
<p><strong>Parameters</strong></p>
|
|
<ol>
|
|
<li><code>char* data</code>: base64 encoded byte array to decode.</li>
|
|
</ol>
|
|
<p><strong>Returns</strong></p>
|
|
<p>A <a href="#jsonresponse-type"><code>JsonResponse</code></a>.
|
|
If the execution is successful, the <code>result</code> field contains the decoded payload.</p>
|
|
<h1 id="copyright">
|
|
Copyright
|
|
<a class="anchor" href="#copyright">#</a>
|
|
</h1>
|
|
<p>Copyright and related rights waived via
|
|
<a href="https://creativecommons.org/publicdomain/zero/1.0/">CC0</a>.</p>
|
|
</article>
|
|
|
|
|
|
|
|
<footer class="book-footer">
|
|
|
|
<div class="flex flex-wrap justify-between">
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</footer>
|
|
|
|
|
|
|
|
<div class="book-comments">
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<label for="menu-control" class="hidden book-menu-overlay"></label>
|
|
</div>
|
|
|
|
|
|
<aside class="book-toc">
|
|
<div class="book-toc-content">
|
|
|
|
|
|
<nav id="TableOfContents">
|
|
<ul>
|
|
<li><a href="#introduction">Introduction</a></li>
|
|
<li><a href="#design-requirements">Design requirements</a></li>
|
|
<li><a href="#the-api">The API</a>
|
|
<ul>
|
|
<li><a href="#general">General</a>
|
|
<ul>
|
|
<li><a href="#jsonresponse-type"><code>JsonResponse</code> type</a></li>
|
|
<li><a href="#jsonmessage-type"><code>JsonMessage</code> type</a></li>
|
|
<li><a href="#decodedpayload-type"><code>DecodedPayload</code> type</a></li>
|
|
<li><a href="#filtersubscription-type"><code>FilterSubscription</code> type</a></li>
|
|
<li><a href="#contentfilter-type"><code>ContentFilter</code> type</a></li>
|
|
<li><a href="#storequery-type"><code>StoreQuery</code> type</a></li>
|
|
<li><a href="#storeresponse-type"><code>StoreResponse</code> type</a></li>
|
|
<li><a href="#pagingoptions-type"><code>PagingOptions</code> type</a></li>
|
|
<li><a href="#index-type"><code>Index</code> type</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#events">Events</a>
|
|
<ul>
|
|
<li><a href="#jsonsignal-type"><code>JsonSignal</code> type</a></li>
|
|
<li><a href="#jsonmessageevent-type"><code>JsonMessageEvent</code> type</a></li>
|
|
<li><a href="#extern-void-waku_set_event_callbackvoid-cb"><code>extern void waku_set_event_callback(void* cb)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#node-management">Node management</a>
|
|
<ul>
|
|
<li><a href="#jsonconfig-type"><code>JsonConfig</code> type</a></li>
|
|
<li><a href="#gossipsubparameters-type"><code>GossipsubParameters</code> type</a></li>
|
|
<li><a href="#extern-unsigned-int-waku_newchar-jsonconfig-char-jsonresp"><code>extern unsigned int waku_new(char* jsonConfig, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_startchar-jsonresp"><code>extern unsigned int waku_start(char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_stopchar-jsonresp"><code>extern unsigned int waku_stop(char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_peerid"><code>extern char* waku_peerid()</code></a></li>
|
|
<li><a href="#extern-char-waku_listen_addresses"><code>extern char* waku_listen_addresses()</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#connecting-to-peers">Connecting to peers</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_add_peerchar-address-char-protocolid"><code>extern char* waku_add_peer(char* address, char* protocolId)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_connectchar-address-int-timeoutms-char-jsonresp"><code>extern unsigned int waku_connect(char* address, int timeoutMs, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_connect_peeridchar-peerid-int-timeoutms"><code>extern char* waku_connect_peerid(char* peerId, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_disconnectchar-peerid"><code>extern char* waku_disconnect(char* peerId)</code></a></li>
|
|
<li><a href="#extern-char-waku_peer_count"><code>extern char* waku_peer_count()</code></a></li>
|
|
<li><a href="#extern-char-waku_peers"><code>extern char* waku_peers()</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-relay">Waku Relay</a>
|
|
<ul>
|
|
<li><a href="#extern-void-waku_content_topicchar-applicationname-unsigned-int-applicationversion-char-contenttopicname-char-encoding-char-outcontenttopic"><code>extern void waku_content_topic(char* applicationName, unsigned int applicationVersion, char* contentTopicName, char* encoding, char* outContentTopic)</code></a></li>
|
|
<li><a href="#extern-char-waku_pubsub_topicchar-name-char-encoding-char-outpubsubtopic"><code>extern char* waku_pubsub_topic(char* name, char* encoding, char* outPubsubTopic)</code></a></li>
|
|
<li><a href="#extern-void-waku_default_pubsub_topicchar-defaultpubsubtopic"><code>extern void waku_default_pubsub_topic(char* defaultPubsubTopic)</code></a></li>
|
|
<li><a href="#extern-unsinged-int-waku_relay_publishchar-messagejson-char-pubsubtopic-int-timeoutms-char-jsonresp"><code>extern unsinged int waku_relay_publish(char* messageJson, char* pubsubTopic, int timeoutMs, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-publickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_relay_publish_enc_asymmetric(char* messageJson, char* pubsubTopic, char* publicKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-symmetrickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_relay_publish_enc_symmetric(char* messageJson, char* pubsubTopic, char* symmetricKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_enough_peerschar-pubsubtopic"><code>extern char* waku_relay_enough_peers(char* pubsubTopic)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_relay_subscribechar-topic-char-jsonresp"><code>extern unsigned int waku_relay_subscribe(char* topic, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-unsigned-int-waku_relay_unsubscribechar-topic-char-jsonresp"><code>extern unsigned int waku_relay_unsubscribe(char* topic, char* jsonResp)</code></a></li>
|
|
<li><a href="#extern-char-waku_relay_topics"><code>extern char* waku_relay_topics()</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-filter">Waku Filter</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_filter_subscribechar-filterjson-char-peerid-int-timeoutms"><code>extern char* waku_filter_subscribe(char* filterJSON, char* peerID, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_filter_unsubscribechar-filterjson-int-timeoutms"><code>extern char* waku_filter_unsubscribe(char* filterJSON, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-lightpush">Waku Lightpush</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_lightpush_publishchar-messagejson-char-topic-char-peerid-int-timeoutms"><code>extern char* waku_lightpush_publish(char* messageJSON, char* topic, char* peerID, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_lightpush_publish_enc_asymmetricchar-messagejson-char-pubsubtopic-char-peerid-char-publickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_lightpush_publish_enc_asymmetric(char* messageJson, char* pubsubTopic, char* peerID, char* publicKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
<li><a href="#extern-char-waku_lightpush_publish_enc_symmetricchar-messagejson-char-pubsubtopic-char-peerid-char-symmetrickey-char-optionalsigningkey-int-timeoutms"><code>extern char* waku_lightpush_publish_enc_symmetric(char* messageJson, char* pubsubTopic, char* peerID, char* symmetricKey, char* optionalSigningKey, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#waku-store">Waku Store</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_store_querychar-queryjson-char-peerid-int-timeoutms"><code>extern char* waku_store_query(char* queryJSON, char* peerID, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#decrypting-messages">Decrypting messages</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_decode_symmetricchar-messagejson-char-symmetrickey"><code>extern char* waku_decode_symmetric(char* messageJson, char* symmetricKey)</code></a></li>
|
|
<li><a href="#extern-char-waku_decode_asymmetricchar-messagejson-char-privatekey"><code>extern char* waku_decode_asymmetric(char* messageJson, char* privateKey)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#dns-discovery">DNS Discovery</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_dns_discoverychar-url-char-nameserver-int-timeoutms"><code>extern char* waku_dns_discovery(char* url, char* nameserver, int timeoutMs)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#utils">Utils</a>
|
|
<ul>
|
|
<li><a href="#extern-char-waku_utils_base64_encodechar-data"><code>extern char* waku_utils_base64_encode(char* data)</code></a></li>
|
|
<li><a href="#extern-char-waku_utils_base64_decodechar-data"><code>extern char* waku_utils_base64_decode(char* data)</code></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#copyright">Copyright</a></li>
|
|
</ul>
|
|
</nav>
|
|
|
|
|
|
|
|
</div>
|
|
</aside>
|
|
|
|
</main>
|
|
|
|
|
|
</body>
|
|
|
|
</html>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|