README
Overview
eosgo-client is a simple Go/Golang wrapper for EOS blockchain (https://eos.io).
It wraps the nodeos RPC API and will offer a high level set of API to simplify the development on top of EOS.
Releases
- v0.0.3: implement more eosio contracts (soon)
- v0.0.2: implements standalone test cases
- v0.0.1: fully functional wrapper of nodeos RPC API, see https://eosio.github.io/eos/group__eosiorpc.html for detailed specs
Current features
Chain API (see rpc/chain.go)
- get_info
- get_block
- get_account
- get_code
- get_table_rows
- abi_json_to_bin
- abi_bin_to_json
- push_transaction
- push_transactions
- get_required_keys
Wallet API (see rpc/wallet.go)
- wallet_create
- wallet_open
- wallet_lock
- wallet_lock_all
- wallet_import_key
- wallet_list
- wallet_list_keys
- wallet_get_public_keys
- wallet_set_timeout
- wallet_sign_trx
EOSIO contracts (see rpc/contract.go)
- newaccount
How to start
Configure your own conf file (for exemple test.conf) based on default.conf one with
"NODE_PRODUCER_NAME":"eosio", // see eosio/config.ini file, default is eosio
"NODE_PUB_KEY":"KEY", // see eosio/config.ini file,
"ENV_EOS_SRC_PATH":"YOURPATH/eos", // path to your EOS source folder
"ENV_EOSGO_PATH":"YOURPATH/eosgo-client", // path to this eosgo-client project
"API_PORT": 8888, // nodeos PORT
"API_URL": "localhost", // nodeos URL
"API_METHOD": "http", // https or https
"LOGGING_MODE": "STDOUT", // STDOUT or SYSLOG
"LOGGING_LEVEL": "debug", // debug, info or error
"WALLET_NAME":"NAME", // your wallet name
"WALLET_PRIV_KEY":"KEY" // your wallet private key
"TRANSACTION_EXPIRATION_DELAY":30 // default 30 seconds
Also, you have to create 2 environment vars in order to load your conf file (see default.conf), in your system:
export EOSGO_PATH=/your_path/eosgo-client/.
export EOSGO_CONF=default
or for your IDE (here for a Goland project):
EOSGO_PATH=.;EOSGO_CONF=test
Then, for example of uses, have a look to rpc/chain_test.go, rpc/wallet_test.go and rpc/contract_test.go.