eos_evm_sdk

EOS EVM js client

Install dependency packages

npm install ethereumjs-tx --save 
npm install web3 --save
yarn add eosjs

Construct EOSEVMClient

const EOSEVMClient  = require('./EOSEVMClient')

const signatureProvider = new JsSignatureProvider([defaultPrivateKey, akey, bkey, ckey, dkey, fkey])

const rpc = new JsonRpc('https://api-kylin.eoslaomao.com', { fetch })

const api = new Api({ rpc, signatureProvider, textDecoder: new TextDecoder(), textEncoder: new TextEncoder() })

  config = {
    chainid: '5fff1dae8dc8e2fc4d5b23b2c7665c97f9e9d8edf2b6485a86ba311c25639191',
    endpoint: 'https://api-kylin.eoslaomao.com',
    contract: 'eosevm111111',
    tokenContract: 'eosio.token',
    tokenPrecision: 4,
    tokenSymbol: 'EOS',
    worker: 'eosevm11111d',
    ethPrivateKeys: {
      /// address : privateKey
      '0xd81f4358cb8cab53d005e7f47c7ba3f5116000a6': 'cbb1981be330b0d97e620a61b913f678fc9c12c059a70badf92d0db317ff804f',
      '0x39944247c2edf660d86d57764b58d83b8eee9014': '3f04415249414ff900b464f8d588517146c4ec39a3ae9855282030fa3de3862f',
      '0xe327e755438fbdf9e60891d9b752da10a38514d1': '9089c365c66ca5d1ea63f1a42a569326d887e680b2256fe79897a2da5aa708ea'
    },
    eosPrivateKeys: {
      'eosevm111111': akey,
      'eosevm11111b': bkey,
      'eosevm11111c': ckey,
      'eosevm11111d': dkey,
      'eosevm11111f': fkey
    },
    abiFile: './ERC20/ERC20.json',
    sourceFile: './ERC20/ERC20ByteCode.json',
    defaultGasPrice: '0x01',
    defaultGasLimit: '0x27100'
  }
  
  let account_eos_evm_a = new EOSEVMClient(rpc, api, config, 'eosevm11111d', '', '')

Functions

depolyEosEvm

• @method depolyEosEvm
• @for Eos_evm_sdk
• link token as native token in account table

await eos_evm_sdk.depolyEosEvm().then((res) => console.log(res))

updateAuth

• @method updateAuth
• @for Eos_evm_sdk
• updateAuth for contract

await eos_evm_sdk.updateAuth().then(res => console.log(res));

linkToken

• @method linkToken
• @for Eos_evm_sdk
• @param {int} precision
• @param {string} token_sym
• @param {string} contract
• link token as native token in account table

await eos_evm_sdk.linkToken(4, 'EOS', 'eosio.token').then((res) => console.log(res))

native transfer

• @method transfer
• @for Eos_evm_sdk
• @param {string} to
• @param {int} value
• native token transfer to account value

await account_eosevm11111b_eos.transfer('0xd81f4358cb8cab53d005e7f47c7ba3f5116000a6', 1000000).then((res) => console.log(res))

createAddress

• @method createAddress
• @for Eos_evm_sdk
• @param {string} eos_account
• @param {string} eth_address optional
• @return
• create EOS associate account or ETH address
• 1. create EOS account, second param string is optional
• 2. create ETH address, second param string must be native ETH address which user own the private key

let account_eos_evm_a = new EOSEVMClient(rpc, api, config, 'eosevm11111d', '', '')
account_eos_evm_a.createAddress('0xe327e755438fbdf9e60891d9b752da10a38514d1').then((res) => console.log(res))

deposit

• @method deposit
• @for Eos_evm_sdk
• @param {string} from
• @param {string} quantity
• deposit EOS associate account quantity balance
• transfer balance to evm contract address and will deposit balance to the associate EOSIO account address

account_eosevm11111b_eos.deposit('10.0000 EOS').then((res) => console.log(res))

withdraw

• @method withdraw
• @for Eos_evm_sdk
• @param {string} eos_account
• @param {string} quantity
• withdraw EOS associate account quantity balance
• withdraw balance from evm contract address and will withdraw balance to the associate EOSIO account

account_eosevm11111b_eos.withdraw('10.0000 EOS').then((res) => console.log(res))

getNonce

• @method: getNonce
• @for Eos_evm_sdk
• get nonce from eos table for current account

account_eosevm11111b_eos.getNonce().then((res) => console.log(res))

getAllAccounts

• @method: getAllAccounts
• @for Eos_evm_sdk
• get all accounts in table limit 100

account_eosevm11111b_eos.getAllAccounts().then((res) => console.log(res))

getAccountInfoByETH

• @method getAccountInfoByETH
• @for Eos_evm_sdk
• get account infomation by ETH address

account_eosevm11111b_eos.getAccountInfoByETH().then((res) => console.log(res))

getAccountInfoByEOS

• @method getAccountInfoByEOS
• @for Eos_evm_sdk
• get account infomation by EOS account

account_eosevm11111b_eos.getAccountInfoByEOS().then((res) => console.log(res))

getAssociateEOS

• @method getAssociateEOS
• @for Eos_evm_sdk
• get associate EOS account in account infomation

account_eosevm11111b_eos.getAssociateEOS().then((res) => console.log(res))

getBalance

• @method getBalance
• @for Eos_evm_sdk
• get balance for current address

account_eosevm11111b_eos.getBalance().then((res) => console.log(res))

call

• @method call
• @for Eos_evm_sdk
• @param {string} method: function signature need to be send
• @param {array} args: function param need to be send
• @param {boolean} simulate: whether this is a simulated action. If simulate is true, the transaction is forced to fail after execution; if simulate is false, the transaction is executed as it should be.
• @param {int} nonce: nonce, if = 0, it will retrive from EOSIO account table
• @param {int} value: transfer value amount wei, default 0
• @param {boolean} transfer: if true native transfer, defalut false
• @param {boolean} ethSign: if true use ETH sign else use EOS signature
• @param {int} gasPrice: defalut config.defaultGasPrice
• @param {int} gasLimit: default config.defaultGasLimit
• call method with args

await account_eosevm11111b_raw_eth.call('transfer',
 ['0x46051cfbfd3453f72565818a6b3e0a155a804330', 1],
 false
).then((res) => console.log(res))

createContract

• @method createContract
• @for Eos_evm_sdk
• @param {array} args
• set contract in current address

account_eosevm11111b_eos.createContract([10000, 'first token', 4, 'SYS']).then((res) => console.log(res))

sendAction

• @method sendAction
• @for Eos_evm_sdk
• @param {string} method: function signature need to be send
• @param {array} args: function param need to be send
• @param {int} nonce: nonce, if = 0, it will retrive from EOSIO account table
• @param {int} value: transfer value amount wei, default 0
• @param {boolean} transfer: if true native transfer, defalut false
• @param {boolean} ethSign: if true use ETH sign else use EOS signature
• @param {int} gasPrice: defalut config.defaultGasPrice
• @param {int} gasLimit: default config.defaultGasLimit
• send raw transaction
• there are three types of sending raw transaction
• 1. create contract address
• 2. execute vm code for certain evm address

account_eosevm11111b_raw_eth.sendAction(
'transferFrom',
['0xe327e755438fbdf9e60891d9b752da10a38514d1', '0x39944247c2edf660d86d57764b58d83b8eee9014', 10]
)

ERC20 wrapper

ERC20Transfer

• @method ERC20Transfer
• @for Eos_evm_sdk
• @param {string} to
• @param {int} value
• transfer from current account to to account

account_eosevm11111b_raw_eth.ERC20Transfer('0x8c68f5c66628480dd2c2323a7c972fda099900cc', 110)

ERC20TotalSupply

• @method ERC20TotalSupply
• @for Eos_evm_sdk
• @param {string} to
• get total supply for destination contract

await account_eosevm11111b_raw_eth.ERC20TotalSupply().then((res) => console.log(res))

ERC20Symbol

• @method ERC20Symbol
• @for Eos_evm_sdk
• @param {string} to
• get symbol for destination contract

await account_eosevm11111b_raw_eth.ERC20Symbol().then((res) => console.log(res))

ERC20BalanceOf

• @method ERC20BalanceOf
• @for Eos_evm_sdk
• @param {string} to
• get balance of token for this account

await account_eosevm11111b_raw_eth.ERC20BalanceOf().then((res) => console.log(res))

ERC20Decimals

• @method ERC20Decimals
• @for Eos_evm_sdk
• @param {string} to
• get decimals of token for this account

await account_eosevm11111b_raw_eth.ERC20Decimals().then((res) => console.log(res))

ERC20Approve

• @method ERC20Approve
• @for Eos_evm_sdk
• @param {string} spender
• @param {int} amount
• approve spender to cost amount value from owner

account_eosevm11111b_raw_eth.ERC20Approve('0x39944247c2edf660d86d57764b58d83b8eee9014', 200).then((res) => console.log(res))

ERC20Allowance

• @method ERC20Allowance
• @for Eos_evm_sdk
• @param {string} spender
• get allowance spender to cost amount value from owner

await account_eosevm11111b_raw_eth.ERC20Allowance('0x39944247c2edf660d86d57764b58d83b8eee9014').then(res => console.log(res))

ERC20TransferFrom

• @method ERC20TransferFrom
• @for Eos_evm_sdk
• @param {string} to
• @param {int} value
• transfer from current account to to account, this method is used with ERC20Approve method

await account_eosevm11111b_raw_eth.ERC20TransferFrom('0x39944247c2edf660d86d57764b58d83b8eee9014', 1,).then(res => console.log(res))