@bradthomasbrown/900ef2 1.0.0

package/README.md

@@ -0,0 +1,42 @@
+# 900ef2
+This is function that can return classes which can create containerized EVM nodes and return interfaces for them, with some helpful features, in TypeScript/JavaScript.
+Features include automatic cleanup and "wait until responsive" logic, as well as returning a class (see `@bradthomasbrown/ejra`) to make interacting with the EVM node more convenient.
+
+## Why?
+To make testing EVM nodes a little bit easier to manage.
+
+## Dependencies
+This has a hard dependency on having `podman` for containers and images. See [podman.io](https://podman.io/).
+
+## Installation
+```sh
+npm i @bradthomasbrown/900ef2
+```
+
+## Usage
+```js
+import { _900ef2_ } from "@bradthomasbrown/900ef2";
+
+const anvilPort = 8546;
+const gethPort = 8547;
+
+const Anvil = _900ef2_("ghcr.io/foundry-rs/foundry:v1.5.1", `anvil -b 1 -p ${anvilPort} --host 0.0.0.0`);
+const Geth = _900ef2_("ethereum/client-go", ["--dev", "--http", "--http.addr", "0.0.0.0", "--http.port", `${gethPort}`, "--http.api", "eth,debug"]);
+
+const [anvilNode, gethNode] = await Promise.all([Anvil.make(anvilPort), Geth.make(gethPort)]);
+
+const [anvilChainId, gethChainId] = await Promise.all([anvilNode, gethNode].map(node => node.chainId()));
+
+const anvilUrl = anvilNode.client.url;
+const gethUrl = gethNode.client.url;
+
+console.log({ anvilUrl, anvilChainId, gethUrl, gethChainId });
+/*
+{
+  anvilUrl: "localhost:8546",
+  anvilChainId: 31337n,
+  gethUrl: "localhost:8547",
+  gethChainId: 1337n,
+}
+*/
+```

package/dist/900ef2.d.ts

@@ -0,0 +1,14 @@
+import { Node } from "@bradthomasbrown/ejra";
+declare function _900ef2_(_80_: string, _c9_: null | string | string[]): {
+    new (): {};
+    make(_d0_: number, _5c_?: {
+        verbose?: boolean;
+        i?: number;
+        b?: number;
+        e?: number;
+        j?: number;
+        t?: number;
+    }): Promise<Node>;
+};
+export { _900ef2_ };
+//# sourceMappingURL=900ef2.d.ts.map

package/dist/900ef2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"900ef2.d.ts","sourceRoot":"","sources":["../src/900ef2.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAuC7C,iBAAS,QAAQ,CAAC,IAAI,EAAC,MAAM,EAAE,IAAI,EAAC,IAAI,GAAC,MAAM,GAAC,MAAM,EAAE;;eAKvC,MAAM,SACN;QACD,OAAO,CAAC,EAAC,OAAO,CAAC;QACjB,CAAC,CAAC,EAAC,MAAM,CAAC;QACV,CAAC,CAAC,EAAC,MAAM,CAAC;QACV,CAAC,CAAC,EAAC,MAAM,CAAC;QACV,CAAC,CAAC,EAAC,MAAM,CAAC;QACV,CAAC,CAAC,EAAC,MAAM,CAAA;KAChB;EA0CR;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/900ef2.js

@@ -0,0 +1,95 @@
+import { Podman } from "@bradthomasbrown/podman";
+import { Node } from "@bradthomasbrown/ejra";
+/**
+ Partial Box-Muller transform to get a normally distributed random number.
+ */
+function _027cdb_() {
+    const theta = 2 * Math.PI * Math.random();
+    const R = Math.sqrt(-2 * Math.log(Math.random()));
+    const v = R * Math.cos(theta);
+    return v;
+}
+/**
+ @param {()=>boolean} _89_ - A nullary boolean function that when called expresses success or failure of some operation.
+ @param {number} _4a_ - The number of times to try some operation before throwing an error due to failure.
+ @param {number} _ae_ - The base delay between operation attempts.
+ @param {number} _0b_ - The exponent used to calculate the next delay.
+ @param {number} _bb_ - The scale with which to apply jitter in calculating the next delay.
+ @param {number} _7e_ - The threshold of potential next delay triggering an error thrown due to failure.
+ */
+async function _178fae_(_89_, _4a_, _ae_, _0b_, _bb_, _7e_, verbose = false) {
+    let i = 0;
+    let _dc_ = _ae_;
+    while (i < _4a_) {
+        _dc_ = Math.max(_ae_, _dc_ * (1 + _027cdb_() * _bb_));
+        if (_dc_ > _7e_)
+            throw new Error("max delay exceeded");
+        if (_89_()) {
+            if (verbose) {
+                console.log(`success, ${i}, ${Date.now()}`);
+            }
+            return;
+        }
+        if (verbose) {
+            console.log(`failure, ${i}, ${Date.now()}`);
+        }
+        await new Promise(r => setTimeout(r, _dc_));
+        _dc_ = _dc_ ** _0b_;
+        i++;
+    }
+    throw new Error("max attempts exceeded");
+}
+const _3c_ = new Set();
+// "ethereum/client-go", "--dev --http --http.addr 0.0.0.0 --http.api eth,debug"
+// "ghcr.io/foundry-rs/foundry:v1.5.1", "anvil -b 1 --host 0.0.0.0"
+function _900ef2_(_80_, _c9_) {
+    return class _33926d_ {
+        static async make(_d0_, _5c_ = {}) {
+            const id = await Podman.run([["detach"], ["publish", `${_d0_}:${_d0_}`]], _80_, _c9_);
+            _3c_.add(id);
+            let _bb_ = false;
+            async function _78_(exit) {
+                if (_bb_ === true)
+                    return;
+                else
+                    _bb_ = true;
+                process.off("beforeExit", _78_);
+                process.off("unhandledRejection", _78_);
+                process.off("uncaughtException", _78_);
+                process.off("SIGINT", _78_);
+                await Promise.all([..._3c_].map(id => Podman.remove([["force"], ["time", 0]], id)));
+                if (exit == "SIGINT")
+                    process.exit();
+                if (exit instanceof Error)
+                    throw exit;
+            }
+            process.on("beforeExit", _78_);
+            process.on("unhandledRejection", _78_);
+            process.on("uncaughtException", _78_);
+            process.on("SIGINT", _78_);
+            const node = new Node(`localhost:${_d0_}`);
+            let _cb_ = null;
+            const _fb_ = () => node.blockNumber().then(() => _cb_ = true).catch(e => _cb_ = e);
+            let _45_ = _fb_();
+            const f = () => {
+                if (_cb_ == true)
+                    return true;
+                if (_cb_ instanceof Error)
+                    _45_ = _fb_();
+                return false;
+            };
+            _5c_.i ??= 12;
+            _5c_.b ??= 50;
+            _5c_.e ??= 1.06;
+            _5c_.j ??= 0.05;
+            _5c_.t ??= Infinity;
+            const error = await _178fae_(f, _5c_.i, _5c_.b, _5c_.e, _5c_.j, _5c_.t, _5c_.verbose).catch(e => e);
+            if (error) {
+                error.cause = _cb_;
+                throw error;
+            }
+            return node;
+        }
+    };
+}
+export { _900ef2_ };

package/dist/_f8a4c6_.d.ts

@@ -0,0 +1,14 @@
+import { Node } from "@bradthomasbrown/ejra";
+declare function _f8a4c6_(_80_: string, _c9_: string, _5c_?: {
+    verbose?: boolean;
+    i?: number;
+    b?: number;
+    e?: number;
+    j?: number;
+    t?: number;
+}): {
+    new (): {};
+    make(): Promise<Node>;
+};
+export { _f8a4c6_ };
+//# sourceMappingURL=_f8a4c6_.d.ts.map

package/dist/_f8a4c6_.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_f8a4c6_.d.ts","sourceRoot":"","sources":["../src/_f8a4c6_.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAqC7C,iBAAS,QAAQ,CAAC,IAAI,EAAC,MAAM,EAAE,IAAI,EAAC,MAAM,EAAE,IAAI,GAAC;IAAE,OAAO,CAAC,EAAC,OAAO,CAAC;IAAC,CAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,CAAC,EAAC,MAAM,CAAA;CAAM;;;EA6C/H;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/_f8a4c6_.js

@@ -0,0 +1,93 @@
+import { Podman } from "@bradthomasbrown/podman";
+import { Node } from "@bradthomasbrown/ejra";
+/**
+ Partial Box-Muller transform to get a normally distributed random number.
+ */
+function _027cdb_() {
+    const theta = 2 * Math.PI * Math.random();
+    const R = Math.sqrt(-2 * Math.log(Math.random()));
+    const v = R * Math.cos(theta);
+    return v;
+}
+/**
+ @param {()=>boolean} _89_ - A nullary boolean function that when called expresses success or failure of some operation.
+ @param {number} _4a_ - The number of times to try some operation before throwing an error due to failure.
+ @param {number} _ae_ - The base delay between operation attempts.
+ @param {number} _0b_ - The exponent used to calculate the next delay.
+ @param {number} _bb_ - The scale with which to apply jitter in calculating the next delay.
+ @param {number} _7e_ - The threshold of potential next delay triggering an error thrown due to failure.
+ */
+async function _178fae_(_89_, _4a_, _ae_, _0b_, _bb_, _7e_, verbose = false) {
+    let i = 0;
+    let _dc_ = _ae_;
+    while (i < _4a_) {
+        _dc_ = Math.max(_ae_, _dc_ * (1 + _027cdb_() * _bb_));
+        if (_dc_ > _7e_)
+            throw new Error("max delay exceeded");
+        if (_89_()) {
+            if (verbose) {
+                console.log(`success, ${i}, ${Date.now()}`);
+            }
+            return;
+        }
+        if (verbose) {
+            console.log(`failure, ${i}, ${Date.now()}`);
+        }
+        await new Promise(r => setTimeout(r, _dc_));
+        _dc_ = _dc_ ** _0b_;
+        i++;
+    }
+    throw new Error("max attempts exceeded");
+}
+// "ethereum/client-go", "--dev --http --http.addr 0.0.0.0 --http.api eth,debug"
+// "ghcr.io/foundry-rs/foundry:v1.5.1", "anvil -b 1 --host 0.0.0.0"
+function _f8a4c6_(_80_, _c9_, _5c_ = {}) {
+    return class _33926d_ {
+        static async make() {
+            const id = await Podman.run([["detach"], ["publish", "8545:8545"]], _80_, _c9_);
+            let _bb_ = false;
+            async function _78_(exit) {
+                if (_bb_ === true)
+                    return;
+                else
+                    _bb_ = true;
+                process.off("beforeExit", _78_);
+                process.off("unhandledRejection", _78_);
+                process.off("uncaughtException", _78_);
+                process.off("SIGINT", _78_);
+                await Podman.remove([["force"], ["time", 0]], id);
+                if (exit == "SIGINT")
+                    process.exit();
+                if (exit instanceof Error)
+                    throw exit;
+            }
+            process.on("beforeExit", _78_);
+            process.on("unhandledRejection", _78_);
+            process.on("uncaughtException", _78_);
+            process.on("SIGINT", _78_);
+            const node = new Node("localhost:8545");
+            let _cb_ = null;
+            const _fb_ = () => node.blockNumber().then(() => _cb_ = true).catch(e => _cb_ = e);
+            let _45_ = _fb_();
+            const f = () => {
+                if (_cb_ == true)
+                    return true;
+                if (_cb_ instanceof Error)
+                    _45_ = _fb_();
+                return false;
+            };
+            _5c_.i ??= 12;
+            _5c_.b ??= 50;
+            _5c_.e ??= 1.06;
+            _5c_.j ??= 0.05;
+            _5c_.t ??= Infinity;
+            const error = await _178fae_(f, _5c_.i, _5c_.b, _5c_.e, _5c_.j, _5c_.t).catch(e => e);
+            if (error) {
+                error.cause = _cb_;
+                throw error;
+            }
+            return node;
+        }
+    };
+}
+export { _f8a4c6_ };

package/package.json

@@ -0,0 +1,27 @@
+{
+    "name": "@bradthomasbrown/900ef2",
+    "description": "Minimal, unoptimized, and unaudited { podman, containerized evm node (foundry's anvil, go-ethereum, etc. } library in JavaScript/TypeScript.",
+    "version": "1.0.0",
+    "author": "Brad Brown <https://t.me/bradthomasbrown>",
+    "type": "module",
+    "scripts": {
+        "bump-patch": "npm version patch && git push && npm publish --access=public",
+        "bump-minor": "npm version minor && git push && npm publish --access=public",
+        "bump-major": "npm version major && git push && npm publish --access=public",
+        "prepublishOnly": "bun test.ts"
+    },
+    "files": [
+        "dist/"
+    ],
+    "exports": {
+        ".": "./dist/900ef2.js"
+    },
+    "dependencies": {
+        "@bradthomasbrown/ejra": "^1.0.5",
+        "@bradthomasbrown/podman": "^1.1.7"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.3.5",
+        "@types/node": "^25.0.3"
+    }
+}