Eth-adapter NPM

eth-adaper :electric_plug:

Ethereum development made easier, interact with smart contracts instantly.

What this library helps with: :check:

Reduce need for writing complex wrapper functions to call ethers.js or web3.js
Reduce complexity around how to interact with smart contracts.
Provided typed parameters for the generated functions based on your ABI:

auto_complete_demo

Additionally:

Exposes ethers on ethAdapter.ethers if you need it
Exposes all loaded contract configuration under ethAdapter.contractConfig

About :grey_question:

eth-adapter is a high level abstraction for interacting with deployed smart contracts through a web3 provider like Metamask.

Would you like to interact with smartcontracts like this:

// If you want to use metamask / injected web3
await ethAdapter.connectToWeb3Wallet();

// OR, just use a JSON Rpc Provider
ethAdapter.setJsonRpcProvider() // Used by default if you don't use connectToWeb3Wallet()

let storedInt = await ethAdapter.contractMethods.STORAGE.retrieve_view_IN0_OUT1();
if (storedInt.error) {
    // ...Handle it
}

// Else... you have storedInt now, conquer the world!

If the above looks pleasing, this library is for you!

How do I use it? :wrench:

Setup :sewing_needle:

npm install eth-adapter | yarn add eth-adapter
Compile a contract and get those artifact files as a .json file, ours is Storage.json
Drop them in your project in a new root /artifacts folder
- Take note of the names, they're important. We have a Storage.json for example
Create a .env file and add your contract with an address CONTRACT_ADDRESS_STORAGE=0x0
- If you use React, the library will also parse REACTAPP environment keys
- The name should be uppercased here without the .json so STORAGE

Run 'ethpst' a bin provided by this library

For React projects it is advised to edit start/build/test to have ethpst; preceed them:

    "scripts": {
      "start": "npx ethpst; react-scripts start",
      "build": "npx ethpst; react-scripts build",
      "test": "npx ethpst; react-scripts test",
      "eject": "react-scripts eject" // Not needed here
  }

The Ethereum Pre-Start-Transpiler (ethpst) should be ran anytime the abi's are updated

For CJS / ES5 compile:

If you wish to use this inside node as ES5 and not ES6 modules, you can compile to cjs by including the following .env parameter in your project root:

ETH_ADAPTER_USE_CJS="TRUE"

A false .env does not need to be included for ES6 Module compiling, it is the default

Calling Contracts :incoming_envelope:

This is the easy part:

// Import ethAdapter
import ethAdapter from 'eth-adapter`

// Set the JSON Rpc Provider
ethAdapter.setJsonRpcProvider("https://localhost:8545); 

// All methods are available on ethAdapter.contractMethods broken down by 'CONTRACTNAME' and have generated types for IntelliSense friendliness
let storedInt = await ethAdapter.contractMethods.STORAGE.retrieve_view_IN0_OUT1();

Remember:

Parameters for contract methods must be passed as destructured objects as {paramName:value}
Functions are named with IN/OUT counts to provide access to overloaded functions

More Functionality :gear:

EthAdapter has some inbuilts for basic things, but also gives you direct access to ethers if you need it through ethAdapter.ethers

EthAdapter exposes all of the compiled contract configuration at ethAdapter.contractConfig this allows you to get the compiled information on your contract within the context ethAdapter sits in.

Additional Methods

setOnNetworkChangeFunction(onNetworkFunction = (networkId: number) => {})

Update the function to be ran anytime the network is updated on the provider

setOnAccountChangeFunction(onAccountChangeFunction = (activeAccount: string) => {})

Update the function to be ran anytime the active account is changed on the provider

setEqualizeFunction( () => {} )

This function is used for the changing the function that is ran everytime ethAdapter changes it's own instance state. This can be beneficial if you integrate EthAdapter into a state management system such as redux.

setJsonRpcProvider(url: string)

Sets the JsonRPCProvider to be used by EthAdapter.

If you run this after connecting a web3 wallet, you will overwrite the injected provider.

connectToWeb3Wallet( () => {})

Used to connect to the injected web3 wallet. Callback is called with {error: msg} as the first parameter if there is a problem connecting or {} if successful.