JS library for building browser apps & NodeJS services that interact with Loom DAppChains.
# NPM
npm install loom-js
# Yarn
yarn add loom-js
<script src="https://cdn.jsdelivr.net/npm/loom-js@1.15.0/dist/loom.umd.js"></script>
loom-js
uses the debug
package for logging.
- To inspect the logs when running in the browser set
localStorage.debug = '*'
- To inspect the logs when running in NodeJS set the
DEBUG
env var to*
See docs for debug
package if you wish to filter the log messages.
# build for Node
yarn build
# build for Browser
yarn build:browser
# build for Node while targeting ES2017 (more readable than ES5)
yarn build:dev
# run unit tests on Node & Browser
yarn test
# auto-format source files
yarn format
# run unit tests in Node
yarn test:node
# run unit tests in Electon
yarn test:browser
# run e2e test in Node (local DAppChain node must be running first)
yarn e2e:node
# run e2e test in Electron (local DAppChain node must be running first)
yarn e2e:browser
The e2e test environment can be configured by changing .env.test
(see .env.test.example
for
default values).
To debug loom-js while using it another project:
- Clone the Git repo from https://github.com/loomnetwork/loom-js
- Inside the loom-js repo run:
yarn link yarn build:dev
- In your project repo run
yarn link loom-js
. - Debug your project normally.
yarn build:dev
will compile the TypeScript source to target ES2017, which requires a lot less
transformation of async/await constructs than the ES5 code released on NPM.
Whenever you change src/proto/loom.proto
, or src/tests/tests.proto
you will need to regenerate
the corresponding *_pb.js
by running:
yarn proto
The shell must be able to locate the protoc
binary, which can be obtained from https://github.com/google/protobuf/releases
Install the loom-js beta version:
yarn add loom-js@beta
LoomProvider takes a custom function that lets you customize what middlewares it runs. For example, we have an experimental nonce caching middleware that has more advanced nonce tracking. You can add it as such:
const setupMiddlewareFn = function(client, privateKey) {
const publicKey = CryptoUtils.publicKeyFromPrivateKey(privateKey)
return [new CachedNonceTxMiddleware(publicKey, client), new SignedTxMiddleware(privateKey)]
}
const loomProviderObj = new LoomProvider(client, privateKey, setupMiddlewareFn)
More examples here: https://github.com/loomnetwork/loom-js/blob/master/src/tests/e2e/loom-provider-web3-middlewares-tests.ts
LoomProvider combined with Web3 supports the following JSON RPC
calls
- eth_accounts
- eth_blockNumber
- eth_call
- eth_gasPrice
- eth_getBlockByHash
- eth_getBlockByNumber
- eth_getCode
- eth_getFilterChanges
- eth_getLogs
- eth_getTransactionByHash
- eth_getTransactionReceipt
- eth_newBlockFilter
- eth_newFilter
- eth_newPendingTransactionFilter
- eth_sendTransaction
- eth_subscribe
- eth_uninstallFilter
- eth_unsubscribe
- net_version
- eth_getFilterLogs (Returns an array of all logs matching filter with given id)
- eth_estimateGas (Currently, it always returns zero)
- net_peerCount (Returns the current ethereum protocol version)
- eth_syncing (Returns an object with data about the sync status or false)
- eth_coinbase (Returns the client coinbase address)
- web3_clientVersion (Returns the current client version)
- eth_getTransactionCount (Returns the number of transactions sent from an address)
- eth_getBlockTransactionCountByHash (Returns the number of transactions in a block from a block matching the given block hash)
- eth_getBlockTransactionCountByNumber (Returns the number of transactions in a block matching the given block number)
Sometimes the project requires few functions that aren't provided directly from LoomProvider in this case is possible to add a custom Eth RPC method. You can add it as such:
const loomProviderObj = new LoomProvider(client, privateKey)
loomProviderObj.addCustomMethod('eth_balance', payload => {
return '0x1'
})
The first param should be the Ethereum RPC call method to add on LoomProvider and the second parameter a callback function with the result
If the project requires to overwrite a RPC function that already exists on LoomProvider. You can add it as such:
loomProvider.overwriteMethod('eth_estimateGas', payload => {
return '0x123'
})
The first param should be the Ethereum RPC call method to overwrite on LoomProvider and the second parameter a callback function with the result
BSD 3-Clause, see LICENSE
file for details.