npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@jibrelnetwork/contracts-jsapi

v2.0.0

Published

Set of stateless wrapper methods for contracts based on ERC20 token.

Downloads

49

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

ttabbaa4ttabbaa4

Keywords

jibreljibrelnetworkcrydrassetsolidityethereumsmartcontractsweb3security

Readme

jibrel-contracts-jsapi

web3 wrapper for jibrel-contracts

Exhaustive API description

About

jibrel-contracts-jsapi is a set of stateless methods that make easier work with Ethereum blockchain, ERC20 Tokens and Jibrel Network contracts.

Get Started

npm install @jibrelnetwork/contracts-jsapi
const jibrelContractsJsapi = require('@jibrelnetwork/contracts-jsapi')

Available npm scripts:

  • compile:standalone: build:standalone & minify
  • compile: lint & build
  • clean: cleans ./lib dir
  • build: cleans & compiles library
  • build:standalone: builds standalone webpack bundle to test library in browser without including it somewhere
  • lint: check code-style errors
  • minify: minifies webpack standalone bundle
  • test: runs mocha tests
  • docs: compile jsdocs
  • docs:open: open docs index.html

Public API definitions

See mocha tests for examples of usage

ETH API

web3.eth functions wrapper

eth.sendTransaction(props)

Sends transaction. Returns Promise that will be resolved with the hash of created transaction.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • privateKey: Private key (64 hex symbols, without '0x' prefix)
  • to: Address of the transaction receiver
  • value: Transaction value
  • gasLimit: (optional) Gas limit for the transaction
  • gasPrice: (optional) Gas price for the transaction
  • nonce: (optional) Nonce for the transaction
  • data: (optional) Transaction data
  • ssl: (optional) Defines using of ssl for connection or not

eth.getBalance(props)

Returns Promise that will be resolved with balance of the provided address.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • address: Address to check balance
  • defaultBlock: (optional) Redefines of web3.eth.defaultBlock
  • ssl: (optional) Defines using of ssl for connection or not

eth.getBlockNumber(props)

Returns Promise that will be resolved with current block number.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • ssl: (optional) Defines using of ssl for connection or not

eth.getBlock(props)

Returns Promise that will be resolved with block data.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • blockId: (optional) Block number or hash. Or the string "earliest"/"latest"/"pending"
  • returnTransactionObjects: (optional) Return all transactions as objects if true
  • ssl: (optional) Defines using of ssl for connection or not

eth.getTransaction(props)

Returns Promise that will be resolved with transaction data.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • transactionHash: Transaction hash
  • ssl: (optional) Defines using of ssl for connection or not

eth.getTransactionReceipt(props)

Returns Promise that will be resolved with transaction receipt.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • transactionHash: Transaction hash
  • ssl: (optional) Defines using of ssl for connection or not

eth.getLogsFilter(props)

Returns Promise that will be resolved with filter object, that can be used for getting of past logs or watching of new.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • options: (optional) Event options
    • fromBlock: (optional) The number of the earliest block
    • toBlock: (optional) The number of the latest block
    • address: (optional) An address(es) to get logs from
    • topics: (optional) Allows to manually set the topics for the event filter
  • ssl: (optional) Defines using of ssl for connection or not

eth.getPastLogs(props)

Returns Promise that will be resolved with past logs.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • options: (optional) Event options
    • fromBlock: (optional) The number of the earliest block
    • toBlock: (optional) The number of the latest block
    • address: (optional) An address(es) to get logs from
    • topics: (optional) Allows to manually set the topics for the event filter
  • ssl: (optional) Defines using of ssl for connection or not

eth.estimateGas(props)

Returns Promise that will be resolved with estimate gas value.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • to: Address of the transaction receiver
  • value: Transaction value
  • data: (optional) Transaction data
  • ssl: (optional) Defines using of ssl for connection or not

eth.getGasPrice(props)

Returns Promise that will be resolved with current gas price value.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • ssl: (optional) Defines using of ssl for connection or not

eth.getNonce(props)

Returns Promise that will be resolved with current transaction count value for address specified

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • ssl: (optional) Defines using of ssl for connection or not
  • address: Address to get transaction count
  • defaultBlock: (optional) Redefines of web3.eth.defaultBlock

ERC20 API

contracts.erc20.totalSupply(props)

Returns Promise that will be resolved with the total supply of tokens.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • ssl: (optional) Defines using of ssl for connection or not

contracts.erc20.balanceOf(props)

Returns Promise that will be resolved with the balance of owner address

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • owner: Address to check balance
  • ssl: (optional) Defines using of ssl for connection or not

contracts.erc20.transfer(props)

Transfers tokens. Returns Promise that will be resolved with the hash of created contract transaction

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • privateKey: Private key (64 hex symbols, without '0x' prefix)
  • to: Address of the transaction receiver
  • value: Transaction value
  • gasLimit: (optional) Gas limit for the transaction
  • gasPrice: (optional) Gas price for the transaction
  • nonce: (optional) Nonce for the transaction
  • ssl: (optional) Defines using of ssl for connection or not

contracts.erc20.allEvents(props)

Subscribes to all contract events. Returns Promise that will be resolved with the event emitter.

The event emitter has the following events:

  • data: Fires on each incoming event with the event object as argument
  • error: Fires when an error in the subscription occours
props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • options: (optional) Event options
    • filter: (optional) Filter options by indexed event parameters
    • fromBlock: (optional) The number of the earliest block
    • toBlock: (optional) The number of the latest block
    • address: (optional) An address(es) to get logs from
    • topics: (optional) Allows to manually set the topics for the event filter
  • callback: (optional) Callback which fired for each event or error
  • ssl: (optional) Defines using of ssl for connection or not

contracts.erc20.Transfer(props)

Subscribes to Transfer event. Returns Promise that will be resolved with the event emitter (the same as for allEvents).

props

The same as for allEvents

contracts.erc20.getPastEvents(props)

Returns Promise that will be resolved with the past event logs.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • event: optional Event name
  • options: (optional) The same options as for allEvents
  • ssl: (optional) Defines using of ssl for connection or not

contracts.erc20.estimateGas(props)

Returns Promise that will be resolved with estimate gas value.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • from: Transaction sender address
  • method: Method name
  • args: Method arguments
  • ssl: (optional) Defines using of ssl for connection or not

ERC20Mintable API

contracts.erc20Mintable.allEvents(props)

See contracts.erc20.allEvents

contracts.erc20Mintable.MintEvent(props)

Subscribes to MintEvent event. Returns Promise that will be resolved with the event emitter (the same as for allEvents).

contracts.erc20Mintable.BurnEvent(props)

Subscribes to BurnEvent event. Returns Promise that will be resolved with the event emitter (the same as for allEvents).

contracts.erc20Mintable.getPastEvents(props)

See contracts.erc20.getPastEvents

ERC20Named API

contracts.erc20Named.name(props)

Returns Promise that will be resolved with the token name.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • ssl: (optional) Defines using of ssl for connection or not

contracts.erc20Named.symbol(props)

Returns Promise that will be resolved with the token symbol.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • ssl: (optional) Defines using of ssl for connection or not

contracts.erc20Named.decimals(props)

Returns Promise that will be resolved with token decimals.

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • ssl: (optional) Defines using of ssl for connection or not

Controller API

contracts.controller.mint(props)

Mint tokens. Returns Promise that will be resolved with the hash of created contract transaction

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • privateKey: Private key (64 hex symbols, without '0x' prefix)
  • account: Address of account to mint tokens to
  • value: Transaction value
  • gasLimit: (optional) Gas limit for the transaction
  • gasPrice: (optional) Gas price for the transaction
  • nonce: (optional) Nonce for the transaction
  • ssl: (optional) Defines using of ssl for connection or not

contracts.controller.burn(props)

Burn tokens. Returns Promise that will be resolved with the hash of created contract transaction

props
  • rpcaddr: RPC address of Ethereum node to connect on
  • rpcport: RPC port of Ethereum node to connect on
  • contractAddress: Contract address
  • privateKey: Private key (64 hex symbols, without '0x' prefix)
  • account: Address of account to burn tokens from
  • value: Transaction value
  • gasLimit: (optional) Gas limit for the transaction
  • gasPrice: (optional) Gas price for the transaction
  • nonce: (optional) Nonce for the transaction
  • ssl: (optional) Defines using of ssl for connection or not

getAddressFromPrivateKey(privateKey)

Gets account's address from its private key.

  • privateKey: Private key (64 hex symbols, without '0x' prefix)

Testing

Testrpc should be launched before tests. Also JSON_PATH env variable should exists. JSON_PATH stores path to .json file, that contains:

  • account addresses
  • private keys
  • contract addresses

The simplest way to test - is launch jibrel-contracts tests. During tests execution it will check that jibrel-contracts-jsapi project is in the same dir, and will agregate all need information and write it to .json file.

Steps to launch tests from jibrel-contracts

Note: prepare jibrel-contracts-jsapi project (npm i && npm run compile)

$ git clone [email protected]:jibrelnetwork/jibrel-contracts.git
$ cd jibrel-contracts
$ git pull origin master
$ git reset --hard e3c917eadcabddef00ab3acd45791c1c456787dd
$ npm i
$ npm run compile
$ npm test