Impervious
Search…
Overview
Impervious Node API and Architecture
This documentation is intended for developers who wish to build applications using the Impervious Node API. These endpoints allow for a variety of interesting use cases and allow for creative combinations of API calls to build projects.
The goal of the Impervious Node is to enable developers to easily build robust applications which take advantage of the Lightning Network, without having to learn or worry about the deep technicals of Lighting payment systems.
Impervious Node's are a FRAMEWORK, for developers to create their own networks, applications, APIs and other creative architectural structures.
API End User License Agreement ("EULA") & Contest Rules
Please find the Impervious API End User License Agreement ("EULA") in our Github repository. If you are participating in the hackathon, you may find the Contest/Hackathon rules here. If you have any questions or comments regarding these Terms, please contact us at [email protected]
The Impervious Architecture Explained
At layer one, there exists the Bitcoin network - money, deep storage, global root trust.
At layer two, there exists the Lightning Network - cash, fluid payments, peer to peer trust.
At layer three, there exists the Impervious Network - applications, streaming micro payments, and node federation.
Layers
The Impervious Node offers three web developer friendly interfaces for communications.
- 1.GRPC input
- 2.HTTP RESTful input
- 3.HTTP Websocket output
Message interfaces
Both GRPC/REST interfaces provide an input and a message ID on the response. This message ID allows for a developer to track and coordinate message synchronization.
The websocket output is a stream of messages, with the above message ID, or a far end message ID. The websocket is used for asynchronous/random reception of messages. For some API endpoints, the response is via the websocket because there could be a long wait state for the Lightning Network to forward the messages. In our design, these GRPC/REST interfaces, generate a message ID, fire off the message into the Lightning Network, and then immediately respond to the developer with the message ID. The developer then monitors the websocket for that message ID to return. It is recommended to always monitor the websocket for asynchronous incoming messages. Do not transmit INTO the websocket, it will be ignored.
Message flow
​
LND Node Configuration
Impervious currently only supports LND lightning nodes, and relies on a running LND node to get started. Additionally, the LND node requires KEYSEND to be enabled via the
accept-keysend=true parameter in the lnd.confconfig file.Then go to our website to get a pair of FREE Voltage LND nodes.
Impervious AI
imperviousai
Follow the Voltage instructions for starting up a node on testnet. Then open a channel per https://faucet.lightning.community/ which will fund your channel.
Once your node(s) up and running, click on your node then choose CONNECT and then MANUAL. This will provide you with the URL, macaroon, and TLS certificate. Port is default 10009.
Save the macaroon/TLS files in your Impervious Node user's home directory. Configure the Impervious node's config.yaml file for these locations and the node URL:port.
Downloading the Impervious Daemon
The latest version of our Impervious binaries can be found in the Releases section of our public repository. You may also use our Docker image with the binaries built in, follow the setup instructions here for that.
Impervious Node Configuration
The Impervious Node is configured via a simple YAML file. Only a couple sections need to be edited, the rest can safely be ignored. You can grab a template file from our public repository to get started.
Additionally, be sure that your YAML file ends in a .yml extension and NOT .yaml.
Note: Currently the configuration file includes the sqlite3 password, and for this reason it is not recommended to check this file into version control. In a later update, handling of the sqlite3 credentials will be updated.
1
# Server configurations
2
server:
3
enabled: true # enable the GRPC/HTTP/websocket server
4
grpc_addr: 127.0.0.1:8881 #IP:port for GRPC
5
http_addr: 127.0.0.1:8882 #IP:port for HTTP/websocket
6
# Redis DB configurations
7
sqlite3:
8
username: admin
9
password: supersecretpassword # this will get moved to environment variable or generated dynamically
10
###### DO NOT EDIT THE BELOW SECTION#####
11
# Services
12
service_list:
13
- service_type: federate
14
active: true
15
custom_record_number: 100000
16
additional_service_data:
17
- service_type: vpn
18
active: true
19
custom_record_number: 200000
20
additional_service_data:
21
- service_type: websocket
22
active: true
23
custom_record_number: 300000
24
additional_service_data:
25
- service_type: message
26
active: true
27
custom_record_number: 400000
28
additional_service_data:
29
- service_type: socket
30
active: true
31
custom_record_number: 500000
32
additional_service_data:
33
- service_type: sign
34
active: true
35
custom_record_number: 800000
36
additional_service_data:
37
###### DO NOT EDIT THE ABOVE SECTION#####
38
39
# Lightning
40
lightning:
41
lnd_node:
42
ip: 127.0.0.1 #IP of your LND node
43
port: 10001 #GRPC port of your LND node
44
pub_key: asdfasdfasdf #get your LND pubkey with "lncli getinfo"
45
tls_cert: /path/to/tls.cert
46
admin_macaroon: /path/to/admin.macaroon
47
federate:
48
ttl: 31560000 #Federation auto delete in seconds
49
imp_id: YOUR_IMP_ID #plain text string of your IMP node name
50
vpn:
51
price: 100 #per hour
52
server_ip: 127.0.0.1 #public IP of your VPN server
53
server_port: 51820 #port you want to listen on
54
subnet: 10.0.0.0/24 #subnet you want to give to your clients. .1 == your server IP.
55
server_pub_key: asdfasdfasdf #get this from your WG public key file
56
allowed_ips: 0.0.0.0/0 #what subnets clients can reach. Default is entire world.
57
binary_path: /usr/bin/wg #where your installed the "wg" command.
58
dns: 8.8.8.8 #set your preferred DNS server here.
59
socket:
60
server_ip: 1.1.1.1 #public IP of your socket server
Copied!
Starting your IMP Daemon
How exciting! You've got your configuration file setup, Impervious installed, and you are ready to roll! The impervious daemon can be run by simple typing the following.
1
$ ./impervious --config /path/to/config/file.yml
Copied!
If you don't want to add the
--config flag, note that the Impervious daemon defaults to a series of steps if --config is not present. - First, it checks for a
config/local.config.ymlfile to exist within the working directory - Secondly, it checks for a
config/config.ymlfile to exist within the working directory
If the
--config file is omitted, the daemon can be run simply using the following command: 1
$ ./impervious
2
...output...
3
{"level":"info" ... "msg":"IMPD started!"}
Copied!
Connecting with your Impervious Daemon
Good work! Now it's time to connect and take your daemon for a drive! Impervious is intended to be instrumented via API and currently supports REST and gRPC, with event subscription handled via Websocket.
Dive into the specific APIs to get started and learn more about each service! Or click Next for the Quick Start Guide.
Last modified 8mo ago