npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

holesail-client

v1.1.6

Published

A client for securely connecting to holesail-server using P2P

Downloads

354

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.