Giter Club home page Giter Club logo

etherflow's Introduction

etherflow

Java library for interacting with ethereum nodes using Json via RPC and IPC

Install parity

https://github.com/paritytech/parity

bash <(curl https://get.parity.io -Lk)

Install jdk 9

http://jdk.java.net/9/

Test jshell

~/Downloads/jdk-9/bin$ ./jshell

| Welcome to JShell -- Version 9 | For an introduction type: /help intro

jshell> System.out.println("hello world") hello world

jshell> /exit

Install maven

https://maven.apache.org/install.html

Clone etherflow project

git clone https://github.com/adbleu0/etherflow.git

Build the project

~/etherflow$ mvn clean package

Start Parity

The personal API is turned off by default in the config.toml for RPC calls for obvious reasons.

$HOME/.local/share/io.parity.ethereum/config.toml

Only enable it for development if you have firewalls configured.

In this case we are demonstrating the API calls from the jshell to the parity node.

[rpc]

disable = false

port = 8545

interface = "local"

cors = "null"

apis = ["web3", "eth", "net", "parity", "traces", "rpc", "secretstore", "personal"]

Start parity

~/parity$ parity --chain dev

Start the shell

Start the shell passing the etherflow jar in the class-path

~/etherflow$ ~/Downloads/jdk-9/bin/jshell --class-path ~/etherflow/target/etherflow.jar

| Welcome to JShell -- Version 9 | For an introduction type: /help intro

jshell>

Logging

Change the log4j.properties file in main/resources folder to log to a file

API calls

List of calls supported

API Java call RPC API
Personal Parity.listAccounts() list accounts
Personal Parity.newAccount(password) new account
Personal Parity.unlockAccount(address,password,duration) unlock acc
Eth Parity.getBalance(address) get balance
Custom Parity.getAllBalances() Get all the balances on all your accs
Custom Parity.sendEther() Send ether from one account to another
Custom Parity.invokeCall() Invoke a method on a smart contract
Custom Parity.traceCall() Trace a method call on a smart contract

List Accounts

~/adbleu0/etherflow$ ~/Downloads/jdk-9/bin/jshell --class-path ~/adbleu0/etherflow/target/etherflow.jar

| Welcome to JShell -- Version 9 | For an introduction type: /help intro

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.listAccounts()

2017-09-09 15:51:31 [main] INFO :: { "jsonrpc" : "2.0", "id" : "15809296692549", "method" : "personal_listAccounts", "params" : [ ] }

2017-09-09 15:51:32 [main] INFO :: { "jsonrpc" : "2.0", "result" : [ "0x008ae303513c1ed9cb24bcf243b806c828e94b60", "0x009ed82813cacf2577410213802371e7abed7c7d", "0x00a329c0648769a73afac7f9381e08fb43dbea72" ], "id" : 15809296692549 }

{ "jsonrpc" : "2.0", "result" : [ "0x008ae303513c1ed9cb24bcf243b806c828e94b60", "0x009ed82813cacf2577410213802371e7abed7c7d", "0x00a329c0648769a73afac7f9381e08fb43dbea72" ], "id" : 15809296692549 }

New account

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.newAccount("test")

2017-09-09 16:05:58 [main] INFO :: { "jsonrpc" : "2.0", "id" : "16676284750693", "method" : "personal_newAccount", "params" : [ "test" ] }

2017-09-09 16:05:58 [main] INFO :: { "jsonrpc" : "2.0", "result" : "0x00298510ab85f7f2af9cfe76c7369068e2ff2728", "id" : 16676284750693 }

{ "jsonrpc" : "2.0", "result" : "0x00298510ab85f7f2af9cfe76c7369068e2ff2728", "id" : 16676284750693 }

Unlock account

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.unlockAccount("0x550a289a06670f1e2b7840b1a859307e95f6b1d2", "test", 10)

2017-09-09 16:52:04 [main] INFO :: { "jsonrpc" : "2.0", "id" : "19441721103892", "method" : "personal_unlockAccount", "params" : [ "0x550a289a06670f1e2b7840b1a859307e95f6b1d2", "test", "0xa" ] }

2017-09-09 16:52:04 [main] INFO :: { "jsonrpc" : "2.0", "result" : true, "id" : 19441721103892 }

{ "jsonrpc" : "2.0", "result" : true, "id" : 19441721103892 }

Get Balance

Get the balance for an address

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.getBalance("0x550a289a06670f1e2b7840b1a859307e95f6b1d2")

2017-09-09 17:08:11 [main] INFO :: { "jsonrpc" : "2.0", "id" : "20409114911365", "method" : "eth_getBalance", "params" : [ "0x550a289a06670f1e2b7840b1a859307e95f6b1d2" ] }

2017-09-09 17:08:12 [main] INFO :: { "jsonrpc" : "2.0", "result" : "0x0", "id" : 20409114911365 }

{ "jsonrpc" : "2.0", "result" : "0x0", "id" : 20409114911365 }

Get All Balances

Custom method to list all the balances on all your accounts

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.getAllBalances()

0x00298510ab85f7f2af9cfe76c7369068e2ff2728:0x0
0x00298510ab85f7f2af9cfe76c7369068e2ff2728:0

0x008ae303513c1ed9cb24bcf243b806c828e94b60:0x152d02c7e14ad9b60140
0x008ae303513c1ed9cb24bcf243b806c828e94b60:99999999999999517000000

0x009ed82813cacf2577410213802371e7abed7c7d:0x0
0x009ed82813cacf2577410213802371e7abed7c7d:0

0x00a329c0648769a73afac7f9381e08fb43dbea72:0xffffffffffffffffffffffffffffffead2fd381eb509800000
0x00a329c0648769a73afac7f9381e08fb43dbea72:1606938044258990275541962092341162602422202993782792835301376

0x550a289a06670f1e2b7840b1a859307e95f6b1d2:0x0
0x550a289a06670f1e2b7840b1a859307e95f6b1d2:0

Send Ether

Custom method to unlock an account and send ether from one account to another

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.sendEther("0x00a329c0648769a73afac7f9381e08fb43dbea72", "", 2, "0x550a289a06670f1e2b7840b1a859307e95f6b1d2", "0x12AF4","0x9184e72a000", "500");

2017-09-09 20:28:09 [main] INFO :: { "jsonrpc" : "2.0", "id" : "31307568187060", "method" : "personal_unlockAccount", "params" : [ "0x00a329c0648769a73afac7f9381e08fb43dbea72", "", "0x2" ] }

2017-09-09 20:28:09 [main] INFO :: { "jsonrpc" : "2.0", "result" : true, "id" : 31307568187060 }

2017-09-09 20:28:09 [main] INFO :: 0x4563918244f4000000

2017-09-09 20:28:09 [main] INFO :: { "jsonrpc" : "2.0", "id" : "31307594263602", "method" : "eth_sendTransaction", "params" : [ { "gas" : "0x12AF4", "from" : "0x00a329c0648769a73afac7f9381e08fb43dbea72", "to" : "0x550a289a06670f1e2b7840b1a859307e95f6b1d2", "value" : "0x4563918244f4000000", "gasPrice" : "0x9184e72a000" } ] }

2017-09-09 20:28:09 [main] INFO :: { "jsonrpc" : "2.0", "result" : "0x158638c678445a2d98305664e8ed47794843faa7f3c6d2d31801eee0c4d0c9e7", "id" : 31307594263602 }

2017-09-09 20:28:09 [main] INFO :: { "jsonrpc" : "2.0", "result" : "0x158638c678445a2d98305664e8ed47794843faa7f3c6d2d31801eee0c4d0c9e7", "id" : 31307594263602 }

0x158638c678445a2d98305664e8ed47794843faa7f3c6d2d31801eee0c4d0c9e7

Deploy a smart contract

Automatic deployment does not seem to work at the moment, so deploy the contract using the parity browser running on http://localhost:8180.

Use the Hello.sol contract under test/resources folder

Send Ether

Send ether to the contract

Transaction: A piece of data, signed by an External Actor. It represents either a Message or a new Autonomous Object. Transactions are recorded into each block of the blockchain.

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.sendEther("0x00a329c0648769a73afac7f9381e08fb43dbea72", "", 2, "0x59c7Fb494BbF5e0dB71A7B33fAFa1a4f86ff426D", "0x12AF4","0x9184e72a000", "10");

2017-09-09 21:21:46 [main] INFO :: { "jsonrpc" : "2.0", "id" : "34524416286699", "method" : "personal_unlockAccount", "params" : [ "0x00a329c0648769a73afac7f9381e08fb43dbea72", "", "0x2" ] }

2017-09-09 21:21:46 [main] INFO :: { "jsonrpc" : "2.0", "result" : true, "id" : 34524416286699 }

2017-09-09 21:21:46 [main] INFO :: 0x4563918244f400000

2017-09-09 21:21:46 [main] INFO :: { "jsonrpc" : "2.0", "id" : "34524445195920", "method" : "eth_sendTransaction", "params" : [ { "gas" : "0x12AF4", "from" : "0x00a329c0648769a73afac7f9381e08fb43dbea72", "to" : "0x92b3c847c505b1a77ffad79cd855229950be9a5d", "value" : "0x4563918244f400000", "gasPrice" : "0x9184e72a000" } ] }

2017-09-09 21:21:46 [main] INFO :: { "jsonrpc" : "2.0", "result" : "0x4735112196f3c97d31973dd8b343f93d316909f3d0fd42013da4140beb89a3af", "id" : 34524445195920 }

2017-09-09 21:21:46 [main] INFO :: { "jsonrpc" : "2.0", "result" : "0x4735112196f3c97d31973dd8b343f93d316909f3d0fd42013da4140beb89a3af", "id" : 34524445195920 }

0x4735112196f3c97d31973dd8b343f93d316909f3d0fd42013da4140beb89a3af

Get Balance

Get the balance on the contract

jshell> import com.adbleu.jshell.Parity;

jshell> Parity.getBalance("0x92b3c847c505b1a77ffad79cd855229950be9a5d");

2017-09-09 21:22:33 [main] INFO :: { "jsonrpc" : "2.0", "id" : "34571632315454", "method" : "eth_getBalance", "params" : [ "0x92b3c847c505b1a77ffad79cd855229950be9a5d" ] }

2017-09-09 21:22:33 [main] INFO :: { "jsonrpc" : "2.0", "result" : "0x4563918244f400000", "id" : 34571632315454 }

{ "jsonrpc" : "2.0", "result" : "0x4563918244f400000", "id" : 34571632315454 }

jshell>

Invoke a method

We'll be invoking the balances method on the Hello contract (under test/resources)

The Hello.signatures file under test/resources/contract has the signature

27e235e3: balances(address)

To invoke the method the data is encoded using the method signature + padded address.

https://github.com/paritytech/parity/wiki/JSONRPC-eth-module#eth_call https://github.com/ethereum/wiki/wiki/Ethereum-Contract-ABI

Message Call: The act of passing a message from one Account to another. If the destination account is associated with non-empty EVM Code, then the VM will be started with the state of said Object and the Message acted upon. If the message sender is an Autonomous Object, then the Call passes any data returned from the VM operation

jshell> import com.adbleu.jshell.Parity;

jshell> String fromAddress = "0x00a329c0648769a73afac7f9381e08fb43dbea72" fromAddress ==> "0x00a329c0648769a73afac7f9381e08fb43dbea72"

jshell> String toAddress = "0x92b3c847c505b1a77ffad79cd855229950be9a5d" toAddress ==> "0x92b3c847c505b1a77ffad79cd855229950be9a5d"

jshell>String encodedData = "0x27e235e300000000000000000000000000a329c0648769a73afac7f9381e08fb43dbea72";

jshell> Parity.invokeCall(fromAddress, toAddress, encodedData)

Trace a method call

We'll be invoking the balances method on the Hello contract (under test/resources)

jshell> import com.adbleu.jshell.Parity;

jshell> String fromAddress = "0x00a329c0648769a73afac7f9381e08fb43dbea72" fromAddress ==> "0x00a329c0648769a73afac7f9381e08fb43dbea72"

jshell> String toAddress = "0x92b3c847c505b1a77ffad79cd855229950be9a5d" toAddress ==> "0x92b3c847c505b1a77ffad79cd855229950be9a5d"

jshell>String encodedData = "0x27e235e300000000000000000000000000a329c0648769a73afac7f9381e08fb43dbea72";

jshell> Parity.traceCall(fromAddress, toAddress, encodedData)

2017-09-11 09:32:28 [main] INFO :: { "jsonrpc" : "2.0", "result" : { "output" : "0x", "stateDiff" : { "0x0000000000000000000000000000000000000000" : { "balance" : { "" : { "from" : "0xf2db63568e3e9ec0", "to" : "0xf5fedea8eca59ec0" } }, "code" : "=", "nonce" : "=", "storage" : { } }, "0x00a329c0648769a73afac7f9381e08fb43dbea72" : { "balance" : { "" : { "from" : "0xffffffffffffffffffffffffffffffea3b81735510ad622000", "to" : "0xffffffffffffffffffffffffffffffea3b7e4fd9be4efb2000" } }, "code" : "=", "nonce" : { "*" : { "from" : "0x17", "to" : "0x18" } }, "storage" : { } } }, "trace" : [ { "action" : { "callType" : "call", "from" : "0x00a329c0648769a73afac7f9381e08fb43dbea72", "gas" : "0x2fa9828", "input" : "0x27e235e300000000000000000000000000a329c0648769a73afac7f9381e08fb43dbea72", "to" : "0x92b3c847c505b1a77ffad79cd855229950be9a5d", "value" : "0x0" }, "result" : { "gasUsed" : "0x0", "output" : "0x" }, "subtraces" : 0, "traceAddress" : [ ], "type" : "call" } ], "vmTrace" : { "code" : "0x", "ops" : [ ] } }, "id" : 436463190647 }

jshell>

etherflow's People

Contributors

gogit avatar

Stargazers

avatar

Watchers

avatar avatar avatar

Forkers

gogit liuxun1977 poseidon-j

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.