@leofcoin/launch-chain 0.1.0

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 vandeurenglenn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# lauch-chain
+> launch chain & peernet (reuses exposed transports when already running)
+
+## usage
+```js
+import launch from '@leofcoin/launch-chain'
+
+const {chain, endpoints, mode} = await launch()
+// chain is undefined when mode is remote
+// endpoints contain urls to connect to the desired remote
+// when mode is remote means an instance is already running
+// when mode is direct means chain is directly available and no endpoint is needed to interact with it
+```
+
+## options
+### default
+
+```js
+{
+  network: 'leofcoin:peach',
+  ws: {
+    port: 4040,
+    url: 'ws://localhost:4040'
+  },
+  http: {
+    port: 8080,
+    url: 'http://localhost:8080'
+  }
+}
+```
+
+### disabling options 
+```js
+{
+  ws: false,
+  http: false
+}
+```

package/exports/launch.js

@@ -0,0 +1,113 @@
+import Node from '@leofcoin/chain/node'
+import Chain from '@leofcoin/chain/chain'
+import nodeConfig from '@leofcoin/lib/node-config.js'
+import wsServer from '@leofcoin/endpoints/ws'
+import httpServer from '@leofcoin/endpoints/http'
+
+/**
+ * 
+ * @param {string} url 
+ * @param {string} networkVersion network/testnet-network sepperate by -
+ * @returns Promise(boolean)
+ */
+const hasHttp = async (url, networkVersion) => {
+  try {
+    await fetch(url + '/network')
+    return true
+  } catch (error) {
+    return false
+  }
+}
+
+const tryWs = (url, networkVersion) => new Promise(async (resolve, reject) => {
+  try {
+    const socket = await new WebSocket(url, networkVersion)
+    socket.onerror = () => resolve(false)
+    if (socket.readyState === 1) socket.close()
+    resolve(true)
+  } catch (error) {
+    reject(error)
+  }
+})
+
+/**
+ * 
+ * @param {string} url 
+ * @param {string} networkVersion network/testnet-network sepperate by -
+ * @returns Promise(boolean)
+ */
+const hasWs = async (url, networkVersion) => {
+  try {
+    await tryWs(url, networkVersion)
+    return true
+  } catch (error) {
+    return false
+  }
+}
+
+/**
+ * 
+ * @param {string} httpURL 
+ * @param {string} wsURL 
+ * @param {string} networkVersion 
+ * @returns Promise({http: boolean, ws: boolean})
+ */
+const hasClient = async (httpURL, wsURL, networkVersion) => {
+  const ws = await hasWs(wsURL, networkVersion)
+  const http = await hasHttp(httpURL, networkVersion)
+  return {http, ws}
+}
+
+// chain is undefined when mode is remote
+// endpoints contain urls to connect to the desired remote
+// when mode is remote means an instance is already running
+// when mode is direct means chain is directly available and no endpoint is needed to interact with it
+/**
+ * 
+ * @param {object} options { ws: boolean || {url: string, port: number}, http: boolean || {url: string, port: number}, network}
+ * @returns '{ mode: string, endpoints: object, chain}'
+ */
+const launch = async (options = {ws, http, network: 'leofcoin:peach'}) => {
+  if (!options) options = {}
+  if (!options.network) options.network = 'leofcoin:peach'
+  if (options.ws === undefined) options.ws = { port: 4040 }
+  if (options.http === undefined) options.http = { port: 8080 }
+  if (options.networkVersion === undefined) options.networkVersion = options.network.replace(':', '-')
+
+  if (options.http?.port && !options.http.url) options.http.url = `http://localhost:${options.http.port}`
+  if (options.ws?.port && !options.ws.url) options.ws.url = `ws://localhost:${options.ws.port}`
+
+  const clients = await hasClient(options.http.url, options.ws.url, options.networkVersion)
+  let endpoints
+  let chain
+  let mode
+
+  if (clients) {
+    Object.entries(clients).forEach(([key, value]) => {
+      if (value) endpoints[key] = options[key].url      
+    })
+    mode = 'remote'
+  } else {    
+    await new Node({ network })
+    await nodeConfig({ network })
+
+    chain = await new Chain()
+
+    if (ws) {
+      await wsServer(chain, options.ws.port, options.networkVersion)
+      endpoints.ws = options.ws.url
+    }
+    if (http) {
+      await httpServer(chain, options.http.port, options.networkVersion)
+      endpoints.http = options.http.url
+    }
+    mode = 'direct'
+  }
+  return {
+    chain,
+    mode,
+    endpoints
+  }
+}
+
+export { launch as default}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@leofcoin/launch-chain",
+  "version": "0.1.0",
+  "description": "",
+  "exports": {
+    ".": "./exports/launch.js"
+  },
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leofcoin/launch-chain.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/leofcoin/launch-chain/issues"
+  },
+  "homepage": "https://github.com/leofcoin/launch-chain#readme",
+  "dependencies": {
+    "@leofcoin/chain": "^1.4.5",
+    "@leofcoin/endpoints": "^0.1.0"
+  }
+}