一条Javascript命令玩转EOS, js4eos开源了

其实很早就想做一个简化EOS操作的项目了，因为EOS探索过程遇到太多朋友咨询EOS编译问题，EOS更新导致操作错误问题。这还是那些有一定编程基础的伙伴，对于"小白"用户就更难了。昨天终于有时间实现了，用户只需通过npm一键安装js4eos,后面就可以通过js4eos玩转EOS生态了。且通过切换网络，可以很便捷的玩转其他EOS生态链。

js4eos

js4eos is a Command Line javascript Application for EOS

js4eos is also a EOS Test Framework for Smart Contract just like truffle on
ethereum

js4eos是一个javascript命令行程序, 包含一个可执行程序js4eos和npm库js4eos。可执行程序js4eos类似EOS的cleos,
完全一样的命令及参数传递方式，以命令行的方式执行EOS命令,一键安装即可立即使用，跨平台，极大降低了EOS使用操作的门槛。同时通过js4eos的npm库，js开发人员能非常简便的开发操作EOS。

js4eos本身也是一个EOS智能合约测试框架库，类似以太坊下的Truffle

安装(install) js4eos

npm install js4eos -g

然后就可以使用js4eos执行EOS cleos程序的相似操作

js4eos最新版本已增加较多功能，如你已安装js4eos，也强烈推荐你执行上述命令更新js4eos

如果出错，请将npm, node都更新一下

npm install -g npm

npm install -g node

ubuntu等linux OS上, 上面的’npm install’ 前需要加sudo

js4eos合约测试框架

Contract Test Framework

初始化一个合约应用(initail a contract application)

mkdir js4eos-dapp

cd js4eos-dapp

js4eos dapp init

or

// a version support IDE 'vscode'

js4eos dapp init -v vscode

新增合约(create contract)

js4eos dapp create anewcontract

编译智能合约(compile contract)

js4eos dapp compile hello

部署智能合约(deploy contract)

js4eos dapp deploy hello

测试合约(test hello contract)

只测试hello contract

‘-g hi’指只测试包含’hi’描述的测试用例,由于只有test/hello.js包含’hi’描述，因而只会测试hello contract

js4eos dapp test -g hi

测试全部

js4eos dapp test

更多信息

点击查看 <https://blog.csdn.net/ITleaks/article/details/84645002>

创建钱包(create wallet)

js4eos只支持一个钱包，钱包可以管理很多key(账号)

js4eos wallet create

解锁钱包(unlock wallet)

js4eos的钱包是加密的，解锁前必须输入创建钱包时输出的密码

js4eos wallet unlock

创建新账号(create new account)

测试网络账号创建

js4eos config set --network jungle

js4eos faucet accountxxx

这个 accountxxx 为你想要创建的新账号， 必须是12个字符，每个字符只能是a-z，1-4

主网等其他网络创建请切换到对应网络

js4eos config set --network mainnet/kylin/fibos

js4eos faucet accountxxx

导入账号私钥(import private key of account)

你要操作某个账号，必须导入该账号的私钥，导入私钥必须先解锁钱包

js4eos wallet unlock （然后输入钱包的密码）

js4eos wallet import keyxxx

keyxxx 为前面账号生成时输出的privateKey

编译智能合约(compile contract)

目前只支持单层目录合约编译

合约目录结构为xxx/xxx.cpp

编译wasm程序(compile wasm)

#编译需要网络，请保持网络畅通

cd xxx

js4eos compile -o xxx.wasm xxx.cpp

如果是采用eosio.cdt规范的智能合约，请用compile2

js4eos compile2 -o xxx.wasm xxx.cpp

生成abi文件(generate abi)

js4eos compile -g xxx.abi xxx.cpp

如果是采用eosio.cdt规范的智能合约，请用compile2, 并指定contract类名

js4eos compile2 -g xxx.abi xxx.cpp --contract contractclass

编译完成后xxx目录下有xxx.cpp, xxx.abi, xxx.wasm三个文件

购买ram(buyram)

hello合约大约需要52k ram

前面通过faucet获取的jungle测试账号是没有余额的，因此需要在下面网址免费获得EOS

http://jungle.cryptolions.io/#faucet <http://jungle.cryptolions.io/#faucet>,
然后购买ram

js4eos system buyram acountxxx acountxxx "10.0000 EOS"

上面的.0000四个0不能省略

部署智能合约(deploy contract)

js4eos set contract accountxxx xxx

xxx是上面合约的目录，里面必须包含xxx.wasm和xxx.abi两个文件

其他接口

其他接口和EOS的cleos一模一样(包括参数名字传递方式)

新增的接口

js4eos config,
该接口用来设置系统配置，比如主网nodeos节点服务信息，网络chainid。通过该命令可以切换EOS网络。]可通过下面的命令来切换到不同网络

切换不同EOS链(switch network)

比如在测试网络jungle,kylin麒麟和主网之间切换

js4eos config set --network mainnet/kylin/jungle/enu/fibos

也可通过如下命令切换

js4eos config choose network

修改当前网络参数（比如chainid, httpend的url)

以下命令会更改当前网络的参数

js4eos config set
--chainid=aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906
--url=http://bp.cryptolions.io:8888

切换网络，同时修改该网络的参数(change network)

下面命令就会切换到mainnnet网络并且修改该网络参数

js4eos config set --network mainnet
--chainid=aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906
--url=http://bp.cryptolions.io:8888

同步网络信息(sync configuration)

由于httpendpoint有时可能会失效，我们的服务器会不定时更新节点信息，所以本地需要时可以通过config sync来同步

js4eos config sync

重置配置(reset configuration)

有时修改配置导致配置信息错误，可以通过reset命令修复

js4eos config reset

水龙头(创建第一个账号,First account)

由于EOS操作的复杂性，任何一个EOS公链侧链账号注册是一个高门槛。因而js4eos配置了水龙头功能，只需执行

js4eos faucet accountxxx

这个 accountxxx 为你想要创建的新账号， 必须是12个字符，每个字符只能是a-z，1-4

常见问题(Problems)

出现问题第一步请执行如下命令更新js4eos

npm install -g js4eos

如还没解决请尝试下面的方法

key问题

出现下面提示，表示你没有导入私钥(需要js4eos wallet import)或者钱包已经锁定(需要js4eos wallet unlock)

js4eos的钱包只有30分钟缓存时间，30分钟无操作需要再次unlock

missing key, check your keyprovider

如果导入私钥或者unlock还是不工作，可以通过如下命令重置钱包

js4eos wallet delete

js4eos wallet create

js4eos wallet import xxx

网络问题(network problem)

出现fetchError

{ FetchError: request to

需要检测是否有网络或者需要更换节点(change httpendpoint)

js4eos config choose url

编译问题(compile issue)

compile needs network if no compiler in local

如果本地没有eosio-cpp编译器环境，js4eos compile 需要网络，请保持电脑网络通畅

错误无解时(what to when no idea)

错误无解时可以通过如下命令来恢复

#(ubuntu等需要sudo)

npm install -g js4eos@latest

js4eos config reset

js4eos config sync

如还有问题,执行如下操作，如下操作会删除钱包等文件

npm install -g js4eos@latest

js4eos reset

如果还有问题，请手工杀死js4eos_bg进程，然后执行

npm install -g js4eos@latest

js4eos reset

如果还是有问题请重启机器再试，并报issue或者添加微信itleaks

windows兼容问题(windows compatible issue)

没有安装mingwin或cygwin等类linux终端环境的用户，如果命令行直接执行js4eos,有些输入需要转义，比如

js4eos push action eosio.token transfer '["youraccount", "account2", "1.0000
EOS", "test"]' -p youraccount

需要更改为(change to below)

js4eos push action eosio.token transfer "[""youraccount"", ""account2"",
""1.0000 EOS"", ""test""]" -p youraccount

引号”需要增加一个”来转义即”“

如果是vscode下的powershell则需要使用 \ 来转义, 上述命令需更改为如下

js4eos push action eosio.token transfer '[\"youraccount\", \"account2\",
\"1.0000 EOS\", \"test\"]' -p youraccount

如果是使用其他window命令行，请自己尝试上述三种方式

推荐使用vscode，vscode的powershell非常好用,点击查看
<https://blog.csdn.net/ITleaks/article/details/83651513>

常用命令解读(common commands)

下图的EOS请替换为具体网络的币符号

比如ENU网络替换为ENU，fibos替换为FO

生成公私钥

js4eos create key

导入私钥

js4eos wallet import xxxxx

导入私钥，才能执行该私钥对应的账号写操作，比如抵押CPU,NET等

创建账号

下面的EOS请使用上面的create key输出的公钥

js4eos system newaccount --stake-net "0.0000 EOS" --stake-cpu "0.0000 EOS"
--buy-ram-kbytes 3 createraccount somenewaccount EOSxxxxx... EOSxxxxx... -p
createraccount

转账

js4eos push action eosio.token transfer '["itleakstoken", "itleakstokem",
"10.0000 EOS", "test"]' -p itleakstoken

查询账号

js4eos get account youraccount

购买RAM

js4eos system buyram payer receiver "0.0001 EOS"

出售RAM

js4eos system sellram payer bytes

抵押CPU,NET

js4eos system delegatebw payer receiver "0.0000 EOS" "0.1000 EOS"

第一个(0.0000 EOS)是net抵押量,第二个(0.1000 EOS)是cpu抵押量

你必须有payer账号的操作权限

取消抵押

js4eos system undelegatebw payer receiver "0.0000 EOS" "0.1000 EOS"

第一个(0.0000 EOS)是net抵押量,第二个(0.100 EOS)是cpu抵押量

你必须有payer账号的操作权限

部署合约

js4eos set contract xxx/xxx/contract_name

contract_name目录下需要有contract_name.abi和contract_name.wasm两个文件

选择节点(choose httpendpoint)

由于httpendpoint有时可能会失效，我们可以切换节点

$ js4eos config choose url

Choose one httpEndpoint for mainnet:

*[0] http://bp.cryptolions.io:8888

[1] https://mainnet.genereos.io

[2] https://mainnet.meet.one

[3] http://mainnet.eoscalgary.io

please input[0~3]>

选择网络(choose network)

用户可能不了解网络的名字，可以通过列表选择方式切换网络

$ js4eos config choose network

Choose one network:

*[0] mainnet

[1] localnet

[2] eosforce

[3] jungle

[4] kylin

[5] enu

[6] fibos

please input[0~6]>

源码GitHub

https://github.com/itleaks/js4eos

|**************************************************
* 本文来自CSDN博主"爱踢门"，喜欢请点关注
* 转载请标明出处:http://blog.csdn.net/itleaks
***************************************************|

如果你对EOS，ETH技术及开发感兴趣，请入QQ群讨论: 829789117


如需实时查看最新文章，请关注公众号"区块链斜杠青年"，一起探索区块链未来

• « 上一篇：ERP不规范，同事两行泪
• » 下一篇：浅谈互联网大数据+智能化时代