holesail-client
v1.1.6
Published
A client for securely connecting to holesail-server using P2P
Downloads
350
Readme
Holesail Client
Join our Discord Support Server
Connect to other peers running holesail-server. This client can connect to servers and relay the data on your system locally. It is supposed to be used as a Node.js module.
Installation
To install the Holesail Client module, use npm:
npm install holesail-client
Usage
To use the Holesail Client module, first require the module in your code:
const holesailClient = require('holesail-client');
Then, create a new instance of the holesailClient
class:
const test = new holesailClient("ff14220e8155f8cd2bbeb2f6f2c3b7ed0212023449bc64b9435ec18c46b8de7f");
If you are connecting securely you need to pass the "secure" flag [Optional but recommended]
const test = new holesailClient("ff14220e8155f8cd2bbeb2f6f2c3b7ed0212023449bc64b9435ec18c46b8de7f","secure");
You can connect to holesail-server network by calling the connect
method:
test.connect({port:5000, address:"127.0.0.1"}, () => {
console.log("Listening on 127.0.0.1:5000")
});
Once you're done using the client, you can destroy the connection to the DHT network by calling the destroy
method:
test.destroy();
Example
Here's a simple example of how to use the Holesail Client module:
const holesailClient = require('holesail-client');
let test = new holesailClient("ff14220e8155f8cd2bbeb2f6f2c3b7ed0212023449bc64b9435ec18c46b8de7f");
test.connect({port:8000, address:"127.0.0.1"}, () => {
console.log("Connected")
}
)
setTimeout(() => {
console.log(test.destroy())
}, 5000);
API
new holesailClient(key)
Create a new instance of the holesailClient
class. The key
parameter is a hexadecimal string representing the peer's key.
For connecting securely you should pass a secure parameter, the server also needs to be running securely:
new holesailClient(key,"secure")
connect(options,callback)
Connect to the DHT network. The port
parameter is the port number to connect to, and the address
parameter is the IP address of the target host.
options
- port:number
- address: The local address
- udp: (boolean) (optional)
destroy()
Destroy the connection to the DHT network.
License
This module is released under the GPL-v3 License. See the LICENSE file for more information.