libzt

Nodejs libzt binding

Idiomatic Node.js bindings for libzt, intended to be a drop-in replacement for node:net and node:dgram.

This project is very early access, please open a github issue for bugs or feature requests.

Installation

Prebuild binaries are included with the npm package for a number of platforms, so installing should be as easy as:

npm install libzt

Usage

Initialisation

ZeroTier has to be initialised before it can be used. This API is very WIP. See also the official libzt docs.

import { startNode, zts } from "libzt";

// initialises node from storage, new id will be created if path doesn't exist
startNode("path/to/id", (event) => console.log(event));

while (!zts.node_is_online()) {
  // will be made asynchronous in the future
  await setTimeout(50);
}
console.log(zts.node_get_id()); // the node's id

const nwid = "ff0000ffff000000"; // Zerotier network id
zts.net_join(nwid);

while (!zts.net_transport_is_ready(nwid)) {
  await setTimeout(50);
}

// get assigned address, second argument is true for ipv6
const address = zts.addr_get_str(nwid, true);

Sockets

As the end goal is feature parity with node:net and node:dgram, it should ideally be as simple as replacing

import net from "node:net";
import dgram from "node:dgram";

with

import { net, dgram } from "libzt";

Using ZeroTier sockets with other modules is also possible. For example for node:http, inject a connection into a server using httpServer.emit("connection", socket) and use the createConnection option when creating a request.

License

The code for these bindings is licensed under the ISC license. However, ZeroTier and libzt are licensed under the BSL version 1.1 which limits certain commercial uses. See also here licenses for other included third party code.