Introduction
Smart contract developers
Witnet Node Operators
🏗
Integration Guide
This guide is aimed at developers willing to integrate their software with Witnet and the Wit coin in such a way that they can manage addresses, balances, and create and verify transactions.
Running Witnet-Rust
Witnet-Rust can be easily run:
Witnet-Rust Components
Witnet-Rust contains two different components that provide different degrees of wallet functionality:
node, which implements a Witnet full node with an internal single-account, single-address wallet and a JSON-RPC API over TCP.wallet, which implements a BIP-32 compliant, multi-account, multi-address Hierarchical Deterministic wallet, and a JSON-RPC API over WebSockets.
Witnet-Rust node component
node componentThe Witnet-Rust
node component is standalone — you can run it on its own and it will provide full-node functionality: syncing up the Witnet block chain, validate transactions and blocks in real time, and (optionally) propose blocks.1
Integration architecture:
2
[YOUR APP] → [WITNET-RUST NODE] → [WITNET NETWORK]
Copied!
Once a
node instance is fully synced, its JSON-RPC over TCP API offers a minimal single-account, single-address wallet.Running a Witnet-Rust node with the JSON-RPC API exposed on local port
21338 can easily be achieved with this Docker one-liner:1
docker run -d \
2
--name witnet_node \
3
--volume ~/.witnet:/.witnet \
4
--publish 21337:21337 \
5
--publish 21338:21338 \
6
--restart always \
7
witnet/witnet-rust
Copied!
Here is a quick guide on how to interact with a node using the JSON-RPC interface and any TCP client:
Interacting with a Witnet Node via a Remote Procedure Call (RPC)
Medium
There is also a command line client (CLI) that exposes all the node functionality and uses the JSON-RPC API under the hood:
Witnet-Rust wallet component
wallet componentThe Witnet-Rust
wallet component is NOT standalone. It requires a connection to an instance of the node component that will act as its "backend":1
Integration architecture:
2
[YOUR APP] → [WITNET-RUST WALLET] → [WITNET-RUST NODE] → [WITNET NETWORK]
Copied!
Witnet Foundation operates a publicly available
node instance that acts as the backend for the wallet component contained within the Sheikah Witnet wallet desktop app, which follows exactly the same architecture:1
Sheikah Wallet app architecture:
2
[SHEIKAH UI*] → [WITNET-RUST WALLET*] → [WITNET-RUST NODE] → [WITNET NETWORK]
3
4
* The Sheikah UI and the Witnet-Rust wallet are run in the user's computer.
Copied!
For users looking for the maximum degree of privacy, it is recommended that they run their own instance of the
node component, because otherwise they may be disclosing their addresses and balances to 3rd parties, as the queries between the wallet and node components need to be sent over the Internet.The JSON-RPC API of the
wallet component is different than the one from the node not because it has much more advanced wallet functionality, and uses a WebSockets transport instead of plain TCP (this is to enable web wallets and similar apps).Last modified 2mo ago
Copy link
Edit on GitHub