@leofcoin/endpoint-clients 0.1.6 → 0.2.1

package/README.md

@@ -1,2 +1,207 @@
 # endpoint-clients
  
+## install
+```sh
+npm i @leofcoin/endpoint-clients
+```
+
+## usage
+```js
+import WsClient from '@leofcoin/endpoint-clients/ws'
+import HttpClient from '@leofcoin/endpoint-clients/http'
+
+const networkVersion = 'leofcoin-peach'
+
+const ws = new WsClient('ws://localhost:4040', networkVersion)
+const http = new HttpClient('http://localhost:8080', networkVersion)
+```
+
+## api
+### selectAccount(address: `string`)
+`address`: desired address
+> set default account to given address
+```js
+await client.selectAccount(address)
+```
+<br>
+
+### getBlock(index: `number`)
+`index`: index of the block to fetch<br>
+```js
+await client.getBlock(10)
+```
+<br>
+
+### blocks(amount)
+`amount`: the amount to slice
+```js
+await client.blocks(-25)
+```
+<br>
+
+### createTransactionFrom(from: `string`, to: `string`, method: `string`, parameters: `array`, nonce: `number` | `undefined`)
+
+`from`:<br>
+`to`: <br>
+`method`: <br>
+`parameters`: <br>
+`nonce`: <br>
+```js
+await client.createTransactionFrom(from, to, method, parameters, nonce)
+```
+<br>
+
+### lookup(name: `string`)
+`name`: name of the contract to lookup the address and owner of
+```js
+await client.lookup('contractName')
+```
+<br>
+
+### participate(address: `string`)
+`address`: <br>
+
+```js
+await client.participate(address)
+```
+<br>
+
+### staticCall(contract: `string`, method: `string`, params: `array`)
+`contract`: contract address todo the call on
+`method`: method/function to call
+`params`: array containing params needed to call the desired method 
+```js
+await client.staticCall(contract, method, params)
+```
+<br>
+
+### createContractAddress(owner: `string`, code: `string`, params: `array`)
+`owner`: address of the deployer<br>
+`code`: contract as a string<br>
+`params`: contract constructor params<br>
+
+```js
+const address = await client.createContractAddress(owner, code, params)
+```
+<br>
+
+### deployContract(code: `string`, params: `array`)
+`code`: contract as a string<br>
+`params`: contract constructor params<br>
+
+```js
+const tx = await client.deployContract(code, params)
+```
+<br>
+
+### accounts() 
+```js
+await client.accounts()
+```
+<br>
+
+### hasTransactionToHandle() 
+```js
+await client.hasTransactionToHandle()
+```
+<br>
+
+### balances()
+> returns all balances
+```js
+await client.balances()
+```
+<br>
+
+### balancOf(address: `string`, format: `boolean`)
+`address`: The address to check<br> 
+`format`: Wether or not to format<br>
+> returns the balance of given address as BigNumber or string (when format is true)
+```js
+await client.balanceOf(address, true)
+```
+<br>
+
+### selectedAccount()
+```js
+await client.selectedAccount()
+```
+<br>
+
+### peerId()
+```js
+await client.peerId()
+```
+<br>
+
+### peers() 
+```js
+await client.peers()
+```
+<br>
+
+### validators() 
+```js
+await client.validators()
+```
+<br>
+
+### nativeBurns()
+```js
+await client.nativeBurns()
+```
+<br>
+
+### contracts()
+```js
+await client.contracts()
+```
+<br>
+
+### nativeMints()
+```js
+await client.nativeMints()
+```
+<br>
+
+### nativeToken()
+```js
+await client.nativeToken()
+```
+<br>
+
+### nativeTransfers()
+```js
+await client.  nativeTransfers()
+```
+<br>
+
+### totalSize()
+```js
+await client.totalSize()
+```
+<br>
+
+### totalTransactions()
+```js
+await client.totalTransactions()
+```
+<br>
+
+### totalBlocks()
+```js
+await client.totalBlocks()
+```
+<br>
+
+### nativeCalls()
+```js
+await client.nativeCalls()
+```
+<br>
+
+### participating()
+```js
+await client.participating()
+```
+<br>

package/exports/http.js

@@ -1,4 +1,7 @@
 export default class {
+  get isHttpClient() {
+    return true
+  }
   constructor(url, networkVersion) {
     this.url = url
     this.networkVersion = networkVersion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leofcoin/endpoint-clients",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "description": "",
   "exports": {
     "./ws": "./exports/ws.js",

package/test/index.js

@@ -0,0 +1,13 @@
+import { needsImplementations } from './spec.js';
+import WsClient from './../exports/ws.js'
+import HttpClient from './../exports/http.js'
+
+try {
+  const wsNeeds = needsImplementations(new WsClient())
+  if (wsNeeds.length > 0) throw new Error(`ws: missing implementations ${wsNeeds.length > 2 ? wsNeeds.join(', ') : wsNeeds.join(' & ')}`)
+
+  const httpNeeds = needsImplementations(new HttpClient())
+  if (httpNeeds.length > 0) throw new Error(`http: missing implementations ${httpNeeds.length > 2 ? httpNeeds.join(', ') : httpNeeds.join(' & ')}`)
+} catch (error) {
+  console.error(error);
+}

package/test/spec.js

@@ -0,0 +1,43 @@
+export const implementations = [
+  'accounts',
+  'balanceOf',
+  'balances',
+  'blocks',
+  'contracts',
+  'createContractAddress',
+  'createTransactionFrom',
+  'deployContract',
+  'getBlock',
+  'hasTransactionToHandle',
+  'lookup',
+  'nativeBurns',
+  'nativeCalls',
+  'nativeMints',
+  'nativeToken',
+  'nativeTransfers',
+  'participate',
+  'participating',
+  'peerId',
+  'peers',
+  'pubsub',
+  'selectAccount',
+  'selectedAccount',
+  'staticCall',
+  'totalBlocks',
+  'totalSize',
+  'totalTransactions',
+  'validators'
+]
+
+export const needsImplementations = (client) => {
+  const needs = []
+  for (const key of implementations)  {
+    try {
+      if (!client[key] && key === 'pubsub' && !client.isHttpClient) needs.push(key)  
+    } catch (error) {
+      if (error.message !== "Cannot read properties of undefined (reading 'pubsub')") throw new Error(error)
+    }
+    
+  }
+  return needs
+}