silverwind

ip-bigint

Convert IPv4 and IPv6 addresses to native BigInt and vice-versa

const isIP = ip => ip.includes(":") ? 6 : ip.includes(".") ? 4 : 0;

  if (!version) throw new Error(`Invalid IP address: ${ip}`);

    for (const n of ip.split(".").map(BigInt).reverse()) {

          const digits = part.split(".").map(str => Number(str).toString(16).padStart(2, "0"));

          return `${digits[0]}${digits[1]}:${digits[2]}${digits[3]}`;

      [, ip, scopeid] = /(.+)%(.+)/.exec(ip);

    for (const n of parts.map(part => BigInt(parseInt(part || 0, 16))).reverse()) {

export function stringifyIp({number, version, ipv4mapped, scopeid} = {}) {

  if (typeof number !== "bigint") throw new Error(`Expected a BigInt`);

  if (![4, 6].includes(version)) throw new Error(`Invalid version: ${version}`);

  if (number < 0n || number > (version === 4 ? max4 : max6)) throw new Error(`Invalid number: ${number}`);

  const stepReduction = version === 4 ? 8n : 16n;

      for (const [index, num] of parts.entries()) {

          ip += `${String(num >> 8n)}.${String(num & 255n)}${index === 6 ? "." : ""}`;

      ip = parts.map(n => n.toString(16)).join(":");

    return ip.replace(emptyPartsRe, "::");

  "description": "Convert IPv4 and IPv6 addresses to native BigInt and vice-versa",

  "author": "silverwind <me@silverwind.io>",

    "eslint-config-silverwind": "66.0.0",

    "eslint-config-silverwind": "73.0.0",

[![](https://img.shields.io/npm/v/ip-bigint.svg?style=flat)](https://www.npmjs.org/package/ip-bigint) [![](https://img.shields.io/npm/dm/ip-bigint.svg)](https://www.npmjs.org/package/ip-bigint) [![](https://img.shields.io/bundlephobia/minzip/ip-bigint.svg)](https://bundlephobia.com/package/ip-bigint)

> Convert IPv4 and IPv6 addresses to native BigInt and vice-versa

import {parseIp, stringifyIp} from "ip-bigint";

import {parseIp, stringifyIp, normalizeIp} from "ip-bigint";

const {number, version} = parseIp("2001:db8::");

// => {number: 42540766411282592856903984951653826560n, version: 6}

const ip = stringifyIp({number, version});

Parse a IP address string to a object (with null prototype).

For IPv6 returns `{number, version, [ipv4mapped], [scopeid]}`.

There is only rudimentary validation that the passed string is actually an IP address. You are encouraged to validate yourself using modules like `ip-regex`.

### stringifyIp({number, version, [ipv4mapped], [scopeid]})

Convert a object to string. Returns `ip`. For IPv6, `ip` is normalized to the "best representation" all-lowercase shortest possible form.

Round-trip an IP address through `parseIp` and `stringifyIp`, effectively normalizing its representation.

The module exports `max4` and `max6` properties which represent the biggest possible BigInt for IPv4 and IPv6 respectively.

		export const max4 = 2n ** 32n - 1n;
		export const max6 = 2n ** 128n - 1n;
		const emptyPartsRe = /\b:?(?:0+:?){2,}/;
		const emptyPartsRe = /\b:?(?:0+:?)+/;
		const isIP = ip => ip.includes(":") ? 6 : ip.includes(".") ? 4 : 0;
		@@ -103,1 +103,5 @@
		}

		export function normalizeIp(ip) {
		return stringifyIp(parseIp(ip));
		}

		{
		"name": "ip-bigint",
		"version": "6.0.1",
		"version": "7.0.0",
		"description": "Convert IPv4 and IPv6 addresses to native BigInt and vice-versa",
		@@ -15,11 +15,11 @@ "author": "silverwind <me@silverwind.io>",
		"files": [
		"index.js"
		"./index.js"
		],
		"devDependencies": {
		"eslint": "8.39.0",
		"eslint-config-silverwind": "66.0.0",
		"updates": "14.1.0",
		"versions": "11.0.0",
		"vitest": "0.30.1"
		"eslint": "8.41.0",
		"eslint-config-silverwind": "73.0.0",
		"updates": "14.1.1",
		"versions": "11.0.1",
		"vitest": "0.31.2"
		}
		}

		@@ -6,17 +6,16 @@ # ip-bigint

		## Install
		## Usage

		```
		npm i ip-bigint
		```

		## Example

		```js
		import {parseIp, stringifyIp} from "ip-bigint";
		import {parseIp, stringifyIp, normalizeIp} from "ip-bigint";

		const {number, version} = parseIp("2001:db8::");
		parseIp("2001:db8::");
		// => {number: 42540766411282592856903984951653826560n, version: 6}
		const ip = stringifyIp({number, version});

		stringifyIp({number, version});
		// => "2001:db8::"

		normalizeIp("2001:db8::0:0:1")
		// => "2001:db8::1"

		```
		@@ -39,2 +38,6 @@

		### normalizeIp(ip)

		Round-trip an IP address through `parseIp` and `stringifyIp`, effectively normalizing its representation.

		### Constants
		@@ -41,0 +44,0 @@

Improved metrics