@leofcoin/chain 1.0.5 → 1.0.8

package/out/@leofcoin/chain/1.0.7/styles/prettify-jsdoc.css

@@ -0,0 +1,111 @@
+/* JSDoc prettify.js theme */
+
+/* plain text */
+.pln {
+  color: #000000;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* string content */
+.str {
+  color: #006400;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* a keyword */
+.kwd {
+  color: #000000;
+  font-weight: bold;
+  font-style: normal;
+}
+
+/* a comment */
+.com {
+  font-weight: normal;
+  font-style: italic;
+}
+
+/* a type name */
+.typ {
+  color: #000000;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* a literal value */
+.lit {
+  color: #006400;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* punctuation */
+.pun {
+  color: #000000;
+  font-weight: bold;
+  font-style: normal;
+}
+
+/* lisp open bracket */
+.opn {
+  color: #000000;
+  font-weight: bold;
+  font-style: normal;
+}
+
+/* lisp close bracket */
+.clo {
+  color: #000000;
+  font-weight: bold;
+  font-style: normal;
+}
+
+/* a markup tag name */
+.tag {
+  color: #006400;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* a markup attribute name */
+.atn {
+  color: #006400;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* a markup attribute value */
+.atv {
+  color: #006400;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* a declaration */
+.dec {
+  color: #000000;
+  font-weight: bold;
+  font-style: normal;
+}
+
+/* a variable name */
+.var {
+  color: #000000;
+  font-weight: normal;
+  font-style: normal;
+}
+
+/* a function name */
+.fun {
+  color: #000000;
+  font-weight: bold;
+  font-style: normal;
+}
+
+/* Specify class=linenums on a pre to get line numbering */
+ol.linenums {
+  margin-top: 0;
+  margin-bottom: 0;
+}

package/out/@leofcoin/chain/1.0.7/styles/prettify-tomorrow.css

@@ -0,0 +1,132 @@
+/* Tomorrow Theme */
+/* Original theme - https://github.com/chriskempson/tomorrow-theme */
+/* Pretty printing styles. Used with prettify.js. */
+/* SPAN elements with the classes below are added by prettyprint. */
+/* plain text */
+.pln {
+  color: #4d4d4c; }
+
+@media screen {
+  /* string content */
+  .str {
+    color: #718c00; }
+
+  /* a keyword */
+  .kwd {
+    color: #8959a8; }
+
+  /* a comment */
+  .com {
+    color: #8e908c; }
+
+  /* a type name */
+  .typ {
+    color: #4271ae; }
+
+  /* a literal value */
+  .lit {
+    color: #f5871f; }
+
+  /* punctuation */
+  .pun {
+    color: #4d4d4c; }
+
+  /* lisp open bracket */
+  .opn {
+    color: #4d4d4c; }
+
+  /* lisp close bracket */
+  .clo {
+    color: #4d4d4c; }
+
+  /* a markup tag name */
+  .tag {
+    color: #c82829; }
+
+  /* a markup attribute name */
+  .atn {
+    color: #f5871f; }
+
+  /* a markup attribute value */
+  .atv {
+    color: #3e999f; }
+
+  /* a declaration */
+  .dec {
+    color: #f5871f; }
+
+  /* a variable name */
+  .var {
+    color: #c82829; }
+
+  /* a function name */
+  .fun {
+    color: #4271ae; } }
+/* Use higher contrast and text-weight for printable form. */
+@media print, projection {
+  .str {
+    color: #060; }
+
+  .kwd {
+    color: #006;
+    font-weight: bold; }
+
+  .com {
+    color: #600;
+    font-style: italic; }
+
+  .typ {
+    color: #404;
+    font-weight: bold; }
+
+  .lit {
+    color: #044; }
+
+  .pun, .opn, .clo {
+    color: #440; }
+
+  .tag {
+    color: #006;
+    font-weight: bold; }
+
+  .atn {
+    color: #404; }
+
+  .atv {
+    color: #060; } }
+/* Style */
+/*
+pre.prettyprint {
+  background: white;
+  font-family: Consolas, Monaco, 'Andale Mono', monospace;
+  font-size: 12px;
+  line-height: 1.5;
+  border: 1px solid #ccc;
+  padding: 10px; }
+*/
+
+/* Specify class=linenums on a pre to get line numbering */
+ol.linenums {
+  margin-top: 0;
+  margin-bottom: 0; }
+
+/* IE indents via margin-left */
+li.L0,
+li.L1,
+li.L2,
+li.L3,
+li.L4,
+li.L5,
+li.L6,
+li.L7,
+li.L8,
+li.L9 {
+  /* */ }
+
+/* Alternate shading for lines */
+li.L1,
+li.L3,
+li.L5,
+li.L7,
+li.L9 {
+  /* */ }

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@leofcoin/chain",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "<a rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc/4.0/\"><img alt=\"Creative Commons Licence\" style=\"border-width:0\" src=\"https://i.creativecommons.org/l/by-nc/4.0/88x31.png\" /></a><br />This work is licensed under a <a rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc/4.0/\">Creative Commons Attribution-NonCommercial 4.0 International License</a>.",
   "source": "./src/node.js",
   "main": "./dist/node.js",
   "scripts": {
     "c": "rollup -c",
     "w": "rollup -c -w",
-    "build": "npm run c && webpack",
+    "build": "npm run c && webpack && npm run docs",
     "demo": "jsproject --serve ./ --port 5478 --open demo",
+    "docs": "sh node_modules/.bin/jsdoc --configure .jsdoc.json --verbose",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "browserslist": "> 0.5%, last 2 versions, not dead",
@@ -21,6 +22,8 @@
     "@rollup/plugin-node-resolve": "^13.1.3",
     "@rollup/plugin-strip": "^2.1.0",
     "@vandeurenglenn/debug": "^1.0.0",
+    "jsdoc": "^3.6.10",
+    "jsdoc-template": "github:braintree/jsdoc-template",
     "rollup": "^2.70.1",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-modify": "^3.0.0",
@@ -33,7 +36,7 @@
     "@ethersproject/bignumber": "^5.6.0",
     "@ethersproject/units": "^5.6.0",
     "@leofcoin/multi-wallet": "^2.1.1",
-    "@leofcoin/peernet": "^0.11.25",
+    "@leofcoin/peernet": "^0.11.28",
     "@leofcoin/storage": "^2.3.0",
     "chalk": "^4.0.0",
     "datastore-level": "^8.0.0",

package/src/chain.js

@@ -1,4 +1,4 @@
-import { BigNumber, formatUnits, parseUnits, info } from './utils/utils'
+import { BigNumber, formatUnits, parseUnits } from './utils/utils'
 import Machine from './machine'
 import lib from './lib'
 
@@ -154,7 +154,7 @@ export default class Chain {
       console.log(this.#blocks);
       let blocksSynced = localIndex > 0 ? localIndex - index : index
       blocksSynced += 1
-      info(`synced ${blocksSynced} ${blocksSynced > 1 ? 'blocks' : 'block'}`)
+      debug(`synced ${blocksSynced} ${blocksSynced > 1 ? 'blocks' : 'block'}`)
 
       const end = this.#blocks.length
       const start = (this.#blocks.length) - blocksSynced
@@ -268,7 +268,7 @@ export default class Chain {
     this.#lastBlock = {hash: blockMessage.hash, ...blockMessage.decoded}
     await blockStore.put(blockMessage.hash, blockMessage.encoded)
     await chainStore.put('lastBlock', new TextEncoder().encode(blockMessage.hash))
-    info(`added block: ${blockMessage.hash}`)
+    debug(`added block: ${blockMessage.hash}`)
     let promises = []
     let contracts = []
     for (let transaction of blockMessage.decoded.transactions) {
@@ -467,6 +467,11 @@ export default class Chain {
    *
    * example: [hash]
    * createTransaction('0x0', 'createContract', [hash])
+   *
+   * @param {String} to - the contract address for the contract to interact with
+   * @param {String} method - the method/function to run
+   * @param {Array} params - array of paramters to apply to the contract method
+   * @param {Number} nonce - total transaction count [optional]
    */
   createTransaction(to, method, params, nonce) {
     return this.createTransactionFrom(peernet.id, to, method, params, nonce)
@@ -475,6 +480,12 @@ export default class Chain {
    * every tx done is trough contracts so no need for amount
    * data is undefined when nothing is returned
    * error is thrown on error so undefined data doesn't mean there is an error...
+   *
+   * @param {String} from - the sender address
+   * @param {String} to - the contract address for the contract to interact with
+   * @param {String} method - the method/function to run
+   * @param {Array} params - array of paramters to apply to the contract method
+   * @param {Number} nonce - total transaction count [optional]
    */
   async createTransactionFrom(from, to, method, params, nonce) {
     if (nonce === undefined) {
@@ -519,6 +530,7 @@ export default class Chain {
 
   /**
    *
+   * @param {String} contract - a contract string (see plugins/deployContract)
    */
   async deployContract(contract, params = []) {
     globalThis.msg = {sender: peernet.id, call: this.call}
@@ -588,6 +600,15 @@ export default class Chain {
     return this.#machine.deleteAll()
   }
 
+  /**
+   * lookup an address for a registered name using the builtin nameService
+   * @check nameService
+   *
+   * @param {String} - contractName
+   * @returns {String} - address
+   *
+   * @example chain.lookup('myCoolContractName') // qmqsfddfdgfg...
+   */
   lookup(name) {
     return this.call(lib.nameService, 'lookup', [name])
   }

package/src/machine.js

@@ -2,7 +2,6 @@ import vm from 'vm'
 import ContractMessage from './messages/contract'
 import TransactionMessage from './messages/transaction'
 import lib from './lib'
-import { info, subinfo } from './utils/utils'
 // import State from './state'
 
 export default class Machine {
@@ -62,8 +61,8 @@ console.log(e);
       globalThis.msg = this.#createMessage(contractMessage.decoded.creator)
       // globalThis.msg = {sender: contractMessage.decoded.creator}
       this.#contracts[contractMessage.hash] = new Contract(...params)
-      info(`loaded contract: ${contractMessage.hash}`);
-      subinfo(`size: ${Math.round((contractMessage.encoded.length / 1024) * 100) / 100} kb`);
+      debug(`loaded contract: ${contractMessage.hash}`);
+      debug(`size: ${Math.round((contractMessage.encoded.length / 1024) * 100) / 100} kb`);
     } catch (e) {
       console.log(e);
       console.warn(`removing contract ${contractMessage.hash}`);

package/src/utils/utils.js

@@ -2,15 +2,6 @@
 // import { writeFile, readFile } from 'fs'
 export { BigNumber } from "@ethersproject/bignumber";
 export { formatUnits, parseUnits } from '@ethersproject/units'
-import chalk from 'chalk'
 
-const info = text => console.log(chalk.blueBright(text))
-
-const subinfo = text => console.log(chalk.magentaBright(text))
-
-export {
-  info,
-  subinfo
-}
 // export const write = promisify(writeFile)
 // export const read = promisify(readFile)