From ec2b904aecf4ef469610ab0c0a20979f03e324c5 Mon Sep 17 00:00:00 2001 From: Nicolas MASSART Date: Tue, 18 Dec 2018 09:48:32 +0100 Subject: [PATCH] Doc migration (#381) Readthedoc migration, still some content to update from the wiki that were updated after I made the last diff - fixes #406 by configuring readthedocs - fixes #407 by configuring material theme - fixes #408 by adding footer with jQuery to enable readthedocs.org versions - fixes #409 - fixes #410 - fixes #411 --- .gitattributes | 4 + .../Accounts-for-Testing.md | 20 + docs/Configuring-Pantheon/Logging.md | 52 + .../NetworkID-And-ChainID.md | 13 + docs/Configuring-Pantheon/Networking.md | 41 + docs/Configuring-Pantheon/Node-Keys.md | 37 + .../Passing-JVM-Options.md | 16 + .../Proof-of-Authority.md | 80 + .../Testing-Developing-Nodes.md | 57 + docs/Getting-Started/ExplorerBlockDetails.png | Bin 0 -> 29191 bytes docs/Getting-Started/ExplorerSearch.png | Bin 0 -> 15483 bytes docs/Getting-Started/ExplorerSummary.png | Bin 0 -> 24016 bytes docs/Getting-Started/Getting-Started.md | 14 + .../Private-Network-Quickstart.md | 460 +++++ docs/Getting-Started/Run-Docker-Image.md | 153 ++ docs/Getting-Started/Starting-Pantheon.md | 115 ++ docs/GettingStartedBinaries.md | 7 +- docs/Installation/Build-From-Source.md | 133 ++ docs/Installation/Install-Binaries.md | 69 + docs/Installation/Install-Chocolatey.md | 22 + docs/Installation/Overview.md | 18 + docs/Reference/JSON-RPC-API-Methods.md | 1817 +++++++++++++++++ docs/Reference/JSON-RPC-API-Objects.md | 158 ++ docs/Reference/JSON-RPC-API.md | 12 + docs/Reference/Pantheon-CLI-Syntax.md | 538 +++++ docs/Reference/Using-JSON-RPC-API.md | 98 + docs/Using-Pantheon/Account-Management.md | 11 + docs/Using-Pantheon/Debugging.md | 12 + docs/Using-Pantheon/FilterExample.md | 1 + docs/Using-Pantheon/Filters.md | 1 + docs/Using-Pantheon/Mining.md | 17 + docs/Using-Pantheon/RPC-PubSub.md | 253 +++ docs/Using-Pantheon/Switching from Geth.md | 1 + docs/Using-Pantheon/Transactions.md | 158 ++ docs/community/code-reviews.md | 3 +- docs/community/community-membership.md | 8 +- docs/conf.py | 2 + docs/custom_theme/404.html | 10 + docs/custom_theme/favicon.ico | Bin 0 -> 32988 bytes docs/custom_theme/partials/footer.html | 146 ++ docs/custom_theme/partials/toc.html | 33 + docs/development/code-coverage.md | 2 +- docs/development/running-with-gradle.md | 2 +- docs/global/test_accounts.md | 19 + docs/index.md | 26 + docs/requirements.txt | 7 + mkdocs.yml | 113 + 47 files changed, 4750 insertions(+), 9 deletions(-) create mode 100644 docs/Configuring-Pantheon/Accounts-for-Testing.md create mode 100644 docs/Configuring-Pantheon/Logging.md create mode 100644 docs/Configuring-Pantheon/NetworkID-And-ChainID.md create mode 100644 docs/Configuring-Pantheon/Networking.md create mode 100644 docs/Configuring-Pantheon/Node-Keys.md create mode 100644 docs/Configuring-Pantheon/Passing-JVM-Options.md create mode 100644 docs/Configuring-Pantheon/Proof-of-Authority.md create mode 100644 docs/Configuring-Pantheon/Testing-Developing-Nodes.md create mode 100644 docs/Getting-Started/ExplorerBlockDetails.png create mode 100644 docs/Getting-Started/ExplorerSearch.png create mode 100644 docs/Getting-Started/ExplorerSummary.png create mode 100644 docs/Getting-Started/Getting-Started.md create mode 100644 docs/Getting-Started/Private-Network-Quickstart.md create mode 100644 docs/Getting-Started/Run-Docker-Image.md create mode 100644 docs/Getting-Started/Starting-Pantheon.md create mode 100644 docs/Installation/Build-From-Source.md create mode 100644 docs/Installation/Install-Binaries.md create mode 100644 docs/Installation/Install-Chocolatey.md create mode 100644 docs/Installation/Overview.md create mode 100644 docs/Reference/JSON-RPC-API-Methods.md create mode 100644 docs/Reference/JSON-RPC-API-Objects.md create mode 100644 docs/Reference/JSON-RPC-API.md create mode 100644 docs/Reference/Pantheon-CLI-Syntax.md create mode 100644 docs/Reference/Using-JSON-RPC-API.md create mode 100644 docs/Using-Pantheon/Account-Management.md create mode 100644 docs/Using-Pantheon/Debugging.md create mode 100644 docs/Using-Pantheon/FilterExample.md create mode 100644 docs/Using-Pantheon/Filters.md create mode 100644 docs/Using-Pantheon/Mining.md create mode 100644 docs/Using-Pantheon/RPC-PubSub.md create mode 100644 docs/Using-Pantheon/Switching from Geth.md create mode 100644 docs/Using-Pantheon/Transactions.md create mode 100644 docs/conf.py create mode 100644 docs/custom_theme/404.html create mode 100644 docs/custom_theme/favicon.ico create mode 100644 docs/custom_theme/partials/footer.html create mode 100644 docs/custom_theme/partials/toc.html create mode 100644 docs/global/test_accounts.md create mode 100644 docs/index.md create mode 100644 docs/requirements.txt create mode 100644 mkdocs.yml diff --git a/.gitattributes b/.gitattributes index df68eeb31d..e488d3e6b0 100644 --- a/.gitattributes +++ b/.gitattributes @@ -5,6 +5,10 @@ *.blocks binary *.eot binary *.svg binary +*.png binary +*.jpg binary +*.gif binary +*.ico binary *.ttf binary *.woff binary *.woff2 binary diff --git a/docs/Configuring-Pantheon/Accounts-for-Testing.md b/docs/Configuring-Pantheon/Accounts-for-Testing.md new file mode 100644 index 0000000000..3ed5609ff2 --- /dev/null +++ b/docs/Configuring-Pantheon/Accounts-for-Testing.md @@ -0,0 +1,20 @@ +description: Ethereum accounts used for testing only on private network + + +# Accounts for Testing + +You can use existing accounts for testing by including them in the genesis file for a private network. Alternatively, Pantheon provides predefined accounts in development mode. + +## Development Mode + + When you start Pantheon with the [`--dev-mode`](/Reference/Pantheon-CLI-Syntax/#dev-mode) command line option, the `dev.json` genesis file is used by default. + + The `dev.json` genesis file defines the accounts below that can be used for testing. + +{!global/test_accounts.md!} + +## Genesis File + +To use existing test accounts, specify the accounts and balances in a genesis file for your test network. For an example of defining accounts in the genesis file, refer to [`dev.json`](https://github.com/PegaSysEng/pantheon/blob/master/config/src/main/resources/dev.json). + +Use the [`--genesis`](/Reference/Pantheon-CLI-Syntax/#genesis) command line option to start Pantheon with the genesis file defining the existing accounts. diff --git a/docs/Configuring-Pantheon/Logging.md b/docs/Configuring-Pantheon/Logging.md new file mode 100644 index 0000000000..57b29f4870 --- /dev/null +++ b/docs/Configuring-Pantheon/Logging.md @@ -0,0 +1,52 @@ +description: Pantheon log level setting and log formatting +path: blob/master/pantheon/src/main/resources/ +source: log4j2.xml + + +# Logging + +Pantheon uses Log4J2 for logging. There are two methods to configure logging behavior: + +* Basic - changes the log level. +* Advanced - configures the output and format of the logs. + +!!!note + For most use-cases, the basic method provides sufficient configurability. + +## Basic Log Level Setting + +Use the [`--logging`](../Reference/Pantheon-CLI-Syntax.md#logging) command line option to specify the logging verbosity. The [`--logging`](../Reference/Pantheon-CLI-Syntax.md#logging) option changes the volume of events displayed in the log. + +## Advanced Custom Logging + +You can provide your own logging configuration using the standard Log4J2 configuration mechanisms. For example, the following Log4J2 configuration is the same as the [default configuration](https://github.com/PegaSysEng/pantheon/blob/master/pantheon/src/main/resources/log4j2.xml) except logging of stack traces for exceptions is excluded. + +```xml tab="log4j2.xml" + + + + INFO + + + + + + + + + + + + + +``` + +To use your custom configuration, set the environment variable `LOG4J_CONFIGURATION_FILE` to the location of your configuration file. + +If you have more specific requirements, you can create your own [log4j2 configuration](https://logging.apache.org/log4j/2.x/manual/configuration.html). + +For Bash-based executions, you can set the variable for only the scope of the program execution by setting it before starting Pantheon. For example, to set the debug logging and start Pantheon connected to the Rinkeby testnet: + +```bash +$ LOG4J_CONFIGURATION_FILE=./debug.xml bin/pantheon --rinkeby +``` \ No newline at end of file diff --git a/docs/Configuring-Pantheon/NetworkID-And-ChainID.md b/docs/Configuring-Pantheon/NetworkID-And-ChainID.md new file mode 100644 index 0000000000..bc6a186243 --- /dev/null +++ b/docs/Configuring-Pantheon/NetworkID-And-ChainID.md @@ -0,0 +1,13 @@ +description: Pantheon network ID and chain ID implementation + + +# Network ID and Chain ID + +Ethereum networks have a **network ID** and a **chain ID**. The network ID is specified using the [`--network-id`](../Reference/Pantheon-CLI-Syntax.md#network-id) option and the chain ID is specified in the genesis file. + +For most networks including mainnet and the public testnets, the network ID and the chain ID are the same. + +The network ID is automatically set by Pantheon when connecting to the Ethereum mainnet ==1==, Rinkeby ==4==, and Ropsten ==3==. + +When using the [`--dev-mode`](../Reference/Pantheon-CLI-Syntax.md#dev-mode) or [`--genesis`](../Reference/Pantheon-CLI-Syntax.md#genesis) options, specify the network ID using the [`--network-id`](../Reference/Pantheon-CLI-Syntax.md#network-id) option. + diff --git a/docs/Configuring-Pantheon/Networking.md b/docs/Configuring-Pantheon/Networking.md new file mode 100644 index 0000000000..884034f854 --- /dev/null +++ b/docs/Configuring-Pantheon/Networking.md @@ -0,0 +1,41 @@ +description: Pantheon networking is about P2P discovery and communication between peers and access to the JSON RPC APIs + + +# Networking + +Pantheon uses the network to find and connect to peers. + +## Firewalls and Incoming Connections + +The default logging configuration does not list node connection and disconnection messages. + +To enable listing of node connection and disconnection messages, specify the [`--logging`](../Reference/Pantheon-CLI-Syntax.md#logging) command line option `--logging=DEBUG`. For more verbosity, specify `--logging=TRACE`. + +The console logs connection and disconnection events when the log level is `DEBUG` or higher. If `Successfully accepted connection from ...` is displayed, connections are getting through the firewalls. For example: + +!!! example "Example log output" + `2018-10-16 12:37:35.479-04:00 | nioEventLoopGroup-3-1 | INFO | NettyP2PNetwork | Successfully accepted connection from 0xa979fb575495b8d6db44f750317d0f4622bf4c2aa3365d6af7c284339968eef29b69ad0dce72a4d8db5ebb4968de0e3bec910127f134779fbcb0cb6d3331163c` + +If connections are not getting through the firewalls, ensure the peer discovery port is open on your firewall. + +## Peer Discovery Port + +The [`--p2p-listen`](../Reference/Pantheon-CLI-Syntax.md#p2p-listen) option specifies the host and port on which P2P peer discovery listens. The default is ==127.0.0.1:30303==. + +## Limiting Peers + +Limiting peers reduces the bandwidth used by Pantheon. It also reduces the CPU time and disk access used to manage and respond to peers. + +Use the [`--max-peers`](../Reference/Pantheon-CLI-Syntax.md#max-peers) command line option to reduce the maximum number of peers. The default is 25. + +Use the [`--max-trailing-peers`](../Reference/Pantheon-CLI-Syntax.md#max-trailing-peers) option to reduce the maximum P2P peer connections for peers that are trailing behind the local chain head. The default is unlimited but the number of trailing peers cannot exceed the value specified by [`--max-peers`](../Reference/Pantheon-CLI-Syntax.md#max-peers). + +Trailing peers cannot be used to get new blocks and are more likely to be requesting blocks from you. Limiting trailing peers may reduce the time taken to catch up to the chain head when synchronizing. + +## No Discovery + +The [`--no-discovery`](../Reference/Pantheon-CLI-Syntax.md#no-discovery) command line option disables P2P peer discovery. Only use this option if you are running a test node or a test network with fixed nodes. + +## Monitoring Peer Connections + +Use the [`debug_metrics`](../Reference/JSON-RPC-API-Methods.md#debug_metrics) JSON-RPC API method to obtain information about peer connections. \ No newline at end of file diff --git a/docs/Configuring-Pantheon/Node-Keys.md b/docs/Configuring-Pantheon/Node-Keys.md new file mode 100644 index 0000000000..c734f6257e --- /dev/null +++ b/docs/Configuring-Pantheon/Node-Keys.md @@ -0,0 +1,37 @@ +description: Pantheon private and public key used to identify node + + +# Node Keys + +Each node has a node key pair consisting of a node private key and node public key. + +## Node Private Key + +If a `key` file does not exist in the data directory and the [`--node-private-key`](../Reference/Pantheon-CLI-Syntax.md#node-private-key) +option is not specified when Pantheon is started, a node private key is generated and written to the `key` file. +If Pantheon is stopped and restarted without deleting the `key` file, the same private key is used when Pantheon is restarted. + +If a `key` file exists in the data directory when Pantheon is started, the node is started with the private key in the `key` file. + +!!!info + The private key is not encrypted. + +## Node Public Key + +The node public key is displayed in the log after starting Pantheon. Use the [`export-pub-key`](../Reference/Pantheon-CLI-Syntax.md#export-pub-key) subcommand to export the public key to a file. + +The node public key is also referred to as the node ID. The node ID forms part of the [enode URL](Testing-Developing-Nodes.md#private-networks) for a node. + +## Specifying a Custom Node Private Key File + +Use the [`--node-private-key`](../Reference/Pantheon-CLI-Syntax.md#node-private-key) option to specify a custom `key` file in any location. + +If the `key` file exists, the node is started with the private key in the custom `key` file. If the custom `key` file does not exist, +a node private key is generated and written to the custom `key` file. + +For example, the following command either reads the node private key from the `privatekeyfile` or writes the generated private key to the `privatekeyfile`: + +!!! example + ```bash + bin/pantheon --node-private-key "/Users/username/privatekeyfile" + ``` \ No newline at end of file diff --git a/docs/Configuring-Pantheon/Passing-JVM-Options.md b/docs/Configuring-Pantheon/Passing-JVM-Options.md new file mode 100644 index 0000000000..fdcdfa2a5a --- /dev/null +++ b/docs/Configuring-Pantheon/Passing-JVM-Options.md @@ -0,0 +1,16 @@ +description: Passing Java virtual machine JVM options to Pantheon at runtime + + +# Passing JVM Options + +To perform tasks such as attaching a debugger or configuring the garbage collector, pass JVM options to Pantheon. + +Pantheon passes the contents of the `PANTHEON_OPTS` environmental variable to the JVM. Set standard JVM options in the `PANTHEON_OPTS` variable. + +For Bash-based executions, you can set the variable for only the scope of the program execution by setting it before starting Pantheon. + +!!! example + ```bash + $ PANTHEON_OPTS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 \ + $ bin/pantheon --rinkeby + ``` \ No newline at end of file diff --git a/docs/Configuring-Pantheon/Proof-of-Authority.md b/docs/Configuring-Pantheon/Proof-of-Authority.md new file mode 100644 index 0000000000..7e854fb37a --- /dev/null +++ b/docs/Configuring-Pantheon/Proof-of-Authority.md @@ -0,0 +1,80 @@ +description: Pantheon Clique Proof-of-Authority (PoA) consensus protocol implementation +path: blob/master/config/src/main/resources/ +source: rinkeby.json + + +# Proof of Authority + +Pantheon implements the Clique Proof-of-Authority (PoA) consensus protocol. Clique is used by the Rinkeby testnet and can be used for private networks. + +In PoA networks, transactions and blocks are validated by approved accounts, known as signers. Signers take turns to create the next block. Existing signers propose and vote to add or remove signers. + +## Genesis File + +To use Clique in a private network, Pantheon requires a PoA genesis file. When connecting to Rinkeby, Pantheon uses the [`rinkeby.json`](https://github.com/PegaSysEng/pantheon/blob/master/config/src/main/resources/rinkeby.json) genesis file in the `/pantheon/config/src/main/resources` directory. + +A PoA genesis file defines properties specific to Clique: + +!!! example "Genesis JSON file (stripped)" + ```json + { + "config": { + .... + "clique": { + "period": 15, + "epoch": 30000 + } + }, + ... + "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000dd37f65db31c107f773e82a4f85c693058fef7a90000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + ... + } + ``` + +The properties specific to Clique are: + +* `period` - Block time in seconds. +* `epoch` - Number of blocks after which to reset all votes. +* `extraData` - Initial signers are specified after the 32 bytes reserved for vanity data. + +To connect to the Rinkeby testnet, start Pantheon with the [`--rinkeby`](../Reference/Pantheon-CLI-Syntax.md#rinkeby) command line option. To start a node on a PoA private network, use the [`--network-id`](../Reference/Pantheon-CLI-Syntax.md#network-id) command line option and [`--genesis`](../Reference/Pantheon-CLI-Syntax.md#genesis`) option. + +### Adding and Removing Signers + +To propose adding or removing signers using the JSON-RPC methods, you must enable the RPC interface using the [`--rpc-enabled`](../Reference/Pantheon-CLI-Syntax.md#rpc-enabled) option. If also using the [`--rpc-api`](../Reference/Pantheon-CLI-Syntax.md#rpc-api) option, include `CLIQUE`. + +The JSON-RPC methods to add or remove signers are: + +* [clique_propose](../Reference/JSON-RPC-API-Methods.md#clique_propose) +* [clique_getSigners](../Reference/JSON-RPC-API-Methods.md#clique_getsigners) +* [clique_discard](../Reference/JSON-RPC-API-Methods.md#clique_discard) + +To propose adding a signer, call `clique_propose` specifying the address of the proposed signer and `true`. +!!! example "JSON-RPC clique_propose Request Example" + ```bash + curl -X POST --data '{"jsonrpc":"2.0","method":"clique_propose","params":["0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73", true], "id":1}' + ``` + +When the next block is created by the signer, a vote is added to the block for the proposed signer. + +When more than half of the existing signers propose adding the signer and their votes have been distributed in blocks, the signer is added and can begin signing blocks. + +Use `clique_getSigners` to return a list of the signers and to confirm that your proposed signer has been added. +!!! example "JSON-RPC clique_getSigners Request Example" + ```bash + curl -X POST --data '{"jsonrpc":"2.0","method":"clique_getSigners","params":["latest"], "id":1}' + ``` + +To discard your proposal after confirming the signer was added, call `clique_discard` specifying the address of the proposed signer. +!!! example "JSON-RPC clique_discard Request Example" + ```bash + curl -X POST --data '{"jsonrpc":"2.0","method":"clique_discard","params":["0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73"], "id":1}' + ``` + +The process for removing a signer is the same as adding a signer except you specify `false` as the second parameter of `clique_propose`. + +#### Epoch Transition + +At each epoch transition, all pending votes collected from received blocks are discarded. Existing proposals remain in effect and signers re-add their vote the next time they create a block. + +Define the number of blocks between epoch transitions in the genesis file. \ No newline at end of file diff --git a/docs/Configuring-Pantheon/Testing-Developing-Nodes.md b/docs/Configuring-Pantheon/Testing-Developing-Nodes.md new file mode 100644 index 0000000000..b13d40e02c --- /dev/null +++ b/docs/Configuring-Pantheon/Testing-Developing-Nodes.md @@ -0,0 +1,57 @@ +description: Pantheon Clique Proof-of-Authority (PoA) consensus protocol implementation +path: blob/master/ethereum/core/src/main/resources/ +source: rinkeby.json + + +# Testing and Developing Nodes + +## Bootnodes + +Bootnodes are used to initially discover peers. + +### Mainnet and Public Testnets + +For mainnet and Rinkeby, Pantheon predefines a list of enonde URLs. For Ropsten, bootnodes are specified using the [`--bootnodes`](../Reference/Pantheon-CLI-Syntax.md#bootnodes) option. + +### Private Networks + +To start a bootnode for a private network: + +1. Export the public key to a file: + + !!! example + ```bash + pantheon export-pub-key bootnode + ``` + The node public key is exported to the `bootnode` file. + +2. Start the bootnode, specifying: + + * An empty string for the [`--bootnodes`](../Reference/Pantheon-CLI-Syntax.md#bootnodes) option because this is the bootnode. + * The network ID for your private network. + + !!! example + ```bash + pantheon --bootnodes="" --network-id 123 + ``` + +To specify this bootnode for another node, the enode URL for the `--bootnodes` option is `enode://@` where: + +* `` is the node public key written to the specified file (`bootnode` in the above example) excluding the initial 0x. +* `` is the host and port the bootnode is listening on for P2P peer discovery. Specified by the `--p2p-listen` option for the bootnode (default is `127.0.0.1:30303`). + +!!! example + If the `--p2p-listen` option is not specified and the node public key exported is `0xc35c3ec90a8a51fd5703594c6303382f3ae6b2ecb9589bab2c04b3794f2bc3fc2631dabb0c08af795787a6c004d8f532230ae6e9925cbbefb0b28b79295d615f` + + Then the enode URL is: + `enode://c35c3ec90a8a51fd5703594c6303382f3ae6b2ecb9589bab2c04b3794f2bc3fc2631dabb0c08af795787a6c004d8f532230ae6e9925cbbefb0b28b79295d615f@127.0.0.1:30303` + +!!! info + The default host and port for P2P peer discovery is `127.0.0.1:30303`. The `--p2p-listen` option can be used to specify a host and port. + +To start a node specifying the bootnode for P2P discovery: + +!!! example + ```bash + pantheon --datadir=/tmp/pantheon/30301 --p2p-listen=127.0.0.1:30301 --network-id=123 --bootnodes=enode://c35c3ec90a8a51fd5703594c6303382f3ae6b2ecb99bab2c04b3794f2bc3fc2631dabb0c08af795787a6c004d8f532230ae6e9925cbbefb0b28b79295d615f@127.0.0.1:30303 + ``` \ No newline at end of file diff --git a/docs/Getting-Started/ExplorerBlockDetails.png b/docs/Getting-Started/ExplorerBlockDetails.png new file mode 100644 index 0000000000000000000000000000000000000000..c3cd87528e20335af3a67807cd48855e955fafc2 GIT binary patch literal 29191 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 literal 0 HcmV?d00001 diff --git a/docs/Getting-Started/ExplorerSearch.png b/docs/Getting-Started/ExplorerSearch.png new file mode 100644 index 0000000000000000000000000000000000000000..b4b9c85ee7a1ec38dbf117c4bf7a1576a32dc472 GIT binary patch literal 15483 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 K)k+>(hW-}<%~whQ literal 0 HcmV?d00001 diff --git a/docs/Getting-Started/Getting-Started.md b/docs/Getting-Started/Getting-Started.md new file mode 100644 index 0000000000..22d1a263f7 --- /dev/null +++ b/docs/Getting-Started/Getting-Started.md @@ -0,0 +1,14 @@ +description: Getting started with Pantheon + + +# Getting started overview + +You can get started with Pantheon by: + +* Starting a node as described in [Starting Pantheon](Starting-Pantheon.md) +* Running from the [Pantheon Docker image](Run-Docker-Image.md) +* Using the [Private Network Quickstart](Private-Network-Quickstart.md) + +To run a single node to connect the Ethereum mainnet or a public testnet, running from the Pantheon [Docker image](Run-Docker-Image.md) or [installing the packaged binaries](../Installation/Install-Binaries.md) is the fastest way to get started. + +To run a private network on which you can make JSON-RPC requests and send transactions, or explore Pantheon and a private Ethereum network, the [Private Network Quickstart](Private-Network-Quickstart.md) runs a private network of Pantheon nodes in Docker containers. \ No newline at end of file diff --git a/docs/Getting-Started/Private-Network-Quickstart.md b/docs/Getting-Started/Private-Network-Quickstart.md new file mode 100644 index 0000000000..5dd5210da8 --- /dev/null +++ b/docs/Getting-Started/Private-Network-Quickstart.md @@ -0,0 +1,460 @@ +description: Pantheon private network quickstart tutorial + + +# Private Network Quickstart tutorial + +This tutorial describes how to use Pantheon to run a private network of Pantheon nodes in a Docker container. + +!!! note + To run the Private Network Quickstart, you must install Pantheon by [cloning and building](../Installation/Build-From-Source.md). + + If you have installed Pantheon from the [packaged binaries](Intallation/Install-Binaries) or are running the [Docker image](Run-Docker-Image), you can proceed with [Starting Pantheon](Starting-Pantheon). + + +## Prerequisites + +To run this tutorial, you must have the following installed: + +- [Docker and Docker-compose](https://docs.docker.com/compose/install/) + +- [Git command line](https://git-scm.com/) + +- [Curl command line](https://curl.haxx.se/download.html) + +- A web browser that supports [Metamask](https://metamask.io/) (currently Chrome, Firefox, Opera, and Brave), and has the MetaMask plug-in installed. This tutorial uses screenshots from Brave. + + +## Clone Pantheon Source Code + +As indicated in [the installation section](../Installation/Build-From-Source.md#clone-the-pantheon-repository), clone the repository. + +## Build Docker Images and Start Services and Network + +This tutorial uses [Docker Compose](https://docs.docker.com/compose/) to simplify assembling images and +running in a private network. To run the containers, go to the `pantheon` directory and run the following commands: + +Run the following commands : + +```bash tab="Linux/macOS" +# Shell script are provided in the Quickstart directory + +quickstart/runPantheonPrivateNetwork.sh +``` + +```bat tab="Windows" +// Run the docker-compose commands directly + +// Run the services and ask for 4 regular nodes +quickstart\docker-compose up -d --scale node=4 + +// List the endpoints +quickstart\docker-compose port explorer 80 +``` + +This script builds Pantheon, builds the images and runs the containers. It will also scale the regular node container to four containers to simulate a network with enough peers to synchronize. + +When the process ends, it lists the running services: + +!!! example "Docker-compose services list example" + ```log + Name Command State Ports + ----------------------------------------------------------------------------------------------------------------------------- + quickstart_bootnode_1 /opt/pantheon/bootnode_sta ... Up 30303/tcp, 8545/tcp, 8546/tcp + quickstart_explorer_1 nginx -g daemon off; Up 0.0.0.0:32770->80/tcp + quickstart_minernode_1 /opt/pantheon/node_start.s ... Up 30303/tcp, 8545/tcp, 8546/tcp + quickstart_node_1 /opt/pantheon/node_start.s ... Up 30303/tcp, 8545/tcp, 8546/tcp + quickstart_node_2 /opt/pantheon/node_start.s ... Up 30303/tcp, 8545/tcp, 8546/tcp + quickstart_node_3 /opt/pantheon/node_start.s ... Up 30303/tcp, 8545/tcp, 8546/tcp + quickstart_node_4 /opt/pantheon/node_start.s ... Up 30303/tcp, 8545/tcp, 8546/tcp + quickstart_rpcnode_1 /opt/pantheon/node_start.s ... Up 30303/tcp, 0.0.0.0:32769->8545/tcp, 0.0.0.0:32768->8546/tcp + ``` + +This is followed by a list of the endpoints: + +!!! example "Endpoint list example" + ```log + **************************************************************** + JSON-RPC HTTP service endpoint : http://localhost:32770/jsonrpc * + JSON-RPC WebSocket service endpoint : ws://localhost:32770/jsonws * + Web block explorer address : http://localhost:32770 * + **************************************************************** + ``` + +- Use the **JSON-RPC HTTP service endpoint** to access the RPC node service from your Dapp or from cryptocurrency wallets such as Metamask. +- Use the **JSON-RPC WebSocket service endpoint** to access the web socket node service from your Dapp. Use the form `ws://localhost:32770/jsonws`. +- Use the **Web block explorer address** to display the block explorer web application. View the block explorer by entering the URL in your web browser. + +To display the list of endpoints again, run the following shell command: + +```bash tab="Linux/macOS" +# Shell script are provided in the Quickstart directory + +quickstart/listQuickstartServices.sh +``` + +```bat tab="Windows" +// Run the docker-compose commands directly + +quickstart\docker-compose port explorer 80 +``` + +## Block Explorer + +This tutorial uses the [Alethio light block explorer](https://aleth.io/). + +### Run the Block Explorer + +Access the explorer by copying and pasting the `Web block explorer address` displayed when starting the private network to your browser. + +The block explorer displays a summary of the private network: + +![Block Explorer](ExplorerSummary.png) + +Notice the explorer indicates 6 peers: the 4 regular nodes, the mining node and the bootnode. + +Click on the block number to the right of **Best Block** to display the block details. + +![Block Details](ExplorerBlockDetails.png) + +You can explore blocks by clicking on the blocks under **Bk** down the left-hand side. + +You can search for a specific block, transaction hash, or address by clicking the magnifying glass in the top left-hand corner. + +![Explorer Search](ExplorerSearch.png) + +## Run JSON-RPC Requests + +Now we're ready to run requests. + +You can run RPC requests on `rpcnode`, the node that is exposed to the host in order to listen for requests. This tutorial uses [cURL](https://curl.haxx.se/download.html) to make JSON-RPC requests. + +!!!tip + **On Windows:** We suggest using [Postman](https://www.getpostman.com/) or a similar client to make RPC requests. + + Using curl via Command Prompt or Windows PowerShell might not work. + +This tutorial uses the placeholder `http://localhost:http-rpc-port`. When you run this tutorial, replace `http-rpc-port` with the JSON-RPC HTTP service endpoint provided when you list the endpoints. (For example, `http://localhost:32770/jsonrpc`.) The dynamic docker port mapping changes each time you run the network. + +### Requesting the Node Version + +Run the following command from the host shell : + +```bash +curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1}' http://localhost:http-rpc-port +``` + +The result should be as follows: + +```json +{ + "jsonrpc" : "2.0", + "id" : 1, + "result" : "pantheon/1.0.0" +} +``` +Here we simply query the version of the Pantheon node, which confirms the node is running. + +Now if this works, let's see some more interesting requests. + +### Counting Peers + +Peers are the number of other nodes connected to the RPC node. + +Poll the peer count using `net_peerCount`: + +```bash +curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' http://localhost:http-rpc-port +``` + +The result should be the following response, indicating that there are 6 peers: + +```json +{ + "jsonrpc" : "2.0", + "id" : 1, + "result" : "0x6" +} +``` + +### Requesting the Most Recent Mined Block Number + +This provides the count of blocks already mined. + +To do so, call `eth_blockNumber` to retrieve the number of the most recent block: + +```bash +curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' http://localhost:http-rpc-port +``` + +The result of this call should be: + +```json +{ + "jsonrpc" : "2.0", + "id" : 1, + "result" : "0x8b8" +} +``` + +Here the hexadecimal value `0x8b8` translates to `2232` in decimal; that many blocks have already been mined. + +### Checking the Miner Account Balance (Coinbase) + +Then call `eth_getBalance` to retrieve the balance of the mining address defined in the miner node: + +```bash +curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xfe3b557e8fb62b89f4916b721be55ceb828dbd73","latest"],"id":1}' http://localhost:http-rpc-port +``` + +The result of this call should be something like : + +```json +{ + "jsonrpc" : "2.0", + "id" : 1, + "result" : "0x79f905c6fd34e80000" +} +``` + +!!!info + 0x79f905c6fd34e80000 = 2250000000000000000000 Wei (2250 Ether) + + you can use a unit [converter](https://etherconverter.online/) to go from wei to ether. + +Wait a few seconds until new blocks are mined and make this call again. The balance should increase, +meaning that the miner address successfully received the mining reward. + +_Also you can see this information in the block explorer. It does exactly the same thing as we +did manually, connecting to the rpc node using http JSON-RPC, but displays information on a web page._ + +### Additional Requests + +Now that you are familiar with basic RPC requests you can run JSON-RPC commands to send transactions. +In order to send transactions, you will first need to create an account or use one of the 3 accounts +created during the genesis of this test network, see . + +{!global/test_accounts.md!} + +!!!note + Pantheon does not provide an accounts management system, so if you want to create your own account, you will have to use a third party tool like Metamask. + +### Creating a Transaction Using MetaMask + +After you sign in to MetaMask, connect to the private network RPC endpoint by: + +1. In the MetaMask network list, select **Custom RPC**. +1. In the **New RPC URL** field, enter the `JSON-RPC HTTP service endpoint` displayed when you started the private network. + +Save the configuration and return to the MetaMask main screen. Your current network is now set to the private network RPC node. + +[Import one of the existing accounts above into metamask](https://metamask.zendesk.com/hc/en-us/articles/360015489331-Importing-an-Account-New-UI-) +using the corresponding private key. + +!!!note + Here we don't really care about securing the keys as it's just a tutorial, but be sure + to secure your accounts when you run into a real usecase. This will be discussed in a more advanced + chapter.** + +Once this is done, try to [create another account from scratch](https://metamask.zendesk.com/hc/en-us/articles/360015289452-Creating-Additional-MetaMask-Wallets-New-UI-) +to send some ether to. + +!!!info + Of course remember that here we are dealing with valueless ether as we are not on the main network but on a local private network. + +In MetaMask, select the new account and copy the account address by clicking the **...** button and selecting **Copy Address to clipboard**. + +In the block explorer, search for the new account by clicking on the magnifying glass and pasting the account address into the search box. The account is displayed with a zero balance. + +[Send some ether](https://metamask.zendesk.com/hc/en-us/articles/360015488991-Sending-Ether-New-UI-) +from the first account (containing some ether) to the new one (that have a zero balance). + +Click refresh on the browser page displaying the new account. The updated balance is displayed and reflects the transaction completed using MetaMask. + +### Truffle Pet Shop Tutorial + +With a couple of modifications, we can use the private network in this tutorial as the blockchain for the [PetShop tutorial on Truffle website](https://truffleframework.com/tutorials/pet-shop). + +#### Prerequisites + +* [Node.js v6+ LTS and npm](https://nodejs.org/en/) (comes with Node) + +#### Install Truffle and Unpack Truffle Box + +Install Truffle : + +```bash +npm install -g truffle +``` + +!!!note + `npm` requires `sudo` on Linux. + +Create a `pet-shop-tutorial` directory and move into it: + +```bash +mkdir pet-shop-tutorial +cd pet-shop-tutorial +``` + +Unpack Pet Shop [truffle box](https://truffleframework.com/boxes): + +`truffle unbox pet-shop` + +Install the [wallet](https://www.npmjs.com/package/truffle-privatekey-provider): + +```bash +npm install truffle-privatekey-provider +``` +!!!note + `npm` requires `sudo` on Linux. + +#### Modify the Pet Shop Example + +Modify the `truffle.js` file in the `pet-shop-tutorial` directory to add our wallet provider: + +```javascript +const PrivateKeyProvider = require("truffle-privatekey-provider"); +const privateKey = "8f2a55949038a9610f50fb23b5883af3b4ecb3c3bb792cbcefbd1542c692be63"; +const privateKeyProvider = new PrivateKeyProvider(privateKey, ""); + +module.exports = { + // See + // for more about customizing your Truffle configuration! + networks: { + development: { + host: "127.0.0.1", + port: 7545, + network_id: "*" // Match any network id + }, + quickstartWallet: { + provider: privateKeyProvider, + network_id: "*" + }, + } +}; +``` + +Replace `` with your HTTP RPC node endpoint (for example, `http://localhost:32770/jsonrpc`). + +The private key is the miner address which means it will have funds. + +Once this is done, you can continue with the [regular tutorial steps](https://truffleframework.com/tutorials/pet-shop#directory-structure) on the Truffle website until Step 3 in the [Migration section](https://truffleframework.com/tutorials/pet-shop#migration). + +#### Use Pantheon Private Network Instead of [Ganache](https://truffleframework.com/ganache) + +We are going to use our private network instead of Ganache, so skip steps 3, 4, and 5 in the [Migration section](https://truffleframework.com/tutorials/pet-shop#migration). + +In step 4, specify our private network: + +```bash +truffle migrate --network quickstartWallet +``` + +Output similar to the following is displayed (your addresses will differ): + +```log +Using network 'quickstartWallet'. + +Running migration: 1_initial_migration.js + Deploying Migrations... + ... 0xfc1dbc1eaa14fa283c2c4415364579da0d195b3f2f2fefd7e0edb600a6235bdb + Migrations: 0x9a3dbca554e9f6b9257aaa24010da8377c57c17e +Saving successful migration to network... + ... 0x77cc6e9966b886fb74268f118b3ff44cf973d32b616ed4f050b3eabf0a31a30e +Saving artifacts... +Running migration: 2_deploy_contracts.js + Deploying Adoption... + ... 0x5035fe3ea7dab1d81482acc1259450b8bf8fefecfbe1749212aca86dc765660a + Adoption: 0x2e1f232a9439c3d459fceca0beef13acc8259dd8 +Saving successful migration to network... + ... 0xa7b5a36e0ebc9c25445ce29ff1339a19082d0dda516e5b72c06ee6b99a901ec0 +Saving artifacts... +``` + +Search for the deployed contracts and transactions in the block explorer using the addresses displayed in your output. + +Continue with the regular tutorial steps in the [Testing the smart contract section](https://truffleframework.com/tutorials/pet-shop#testing-the-smart-contract). + +To run the tests in the [Running the tests section](https://truffleframework.com/tutorials/pet-shop#running-the-tests), specify our private network: + +```bash +truffle test --network quickstartWallet +``` + +Output similar to the following is displayed: +```log +Using network 'quickstartWallet'. + +Compiling ./contracts/Adoption.sol... +Compiling ./test/TestAdoption.sol... +Compiling truffle/Assert.sol... +Compiling truffle/DeployedAddresses.sol... + + + TestAdoption + ✓ testUserCanAdoptPet (2071ms) + ✓ testGetAdopterAddressByPetId (6070ms) + ✓ testGetAdopterAddressByPetIdInArray (6077ms) + + + 3 passing (37s) +``` + +Continue with the regular tutorial steps in the [Creating a user interface to interact with the smart contract section](https://truffleframework.com/tutorials/pet-shop#creating-a-user-interface-to-interact-with-the-smart-contract). + +We have already connected our private network to MetaMask so you can skip the [Installing and configuring MetaMask section](https://truffleframework.com/tutorials/pet-shop#installing-and-configuring-metamask). + +Continue with the regular tutorial steps from the [Installing and configuring lite-server section](https://truffleframework.com/tutorials/pet-shop#installing-and-configuring-lite-server) to the end of the tutorial. + +When you adopt pets in the browser and approve the transaction in MetaMask, you will be able to see the transactions in the block explorer. + +## Shut Down the Network and Remove the Containers + +To shut down the network and delete all containers: + +```bash tab="Linux/macOS" +# Shell script are provided in the Quickstart directory + +quickstart/removePantheonPrivateNetwork.sh +``` + +```bat tab="Windows" +// Run the docker-compose commands directly + +quickstart\docker-compose down +``` + +!!!note + On Windows, the quickstart creates a volume called `quickstart_public-keys` but it's not automatically removed. Remove this volume using `docker volume rm quickstart_public-keys`. + +## Stop and restart the Private Network without Removing the Containers + +To shut down the network without deleting the containers: + +```bash tab="Linux/macOS" +# Shell script are provided in the Quickstart directory + +quickstart/stopPantheonPrivateNetwork.sh +``` + +```bat tab="Windows" +// Run the docker-compose commands directly + +quickstart\docker-compose stop +``` + +(This command will also stop other running containers unrelated to quickstart.) + +To restart the private network: + +```bash tab="Linux/macOS" +# Shell script are provided in the Quickstart directory + +quickstart/resumePantheonPrivateNetwork.sh +``` + +```bat tab="Windows" +// Run the docker-compose commands directly + +quickstart\docker-compose start +``` \ No newline at end of file diff --git a/docs/Getting-Started/Run-Docker-Image.md b/docs/Getting-Started/Run-Docker-Image.md new file mode 100644 index 0000000000..0e502e3822 --- /dev/null +++ b/docs/Getting-Started/Run-Docker-Image.md @@ -0,0 +1,153 @@ +description: Run Pantheon using the official docker image + + +# Running Pantheon from Docker Image + +A Docker image is provided to run a Pantheon node in a Docker container. + +Use this Docker image to run a single Pantheon node without installing Pantheon. + +## Prerequisites + +To run Pantheon from the Docker image, you must have [Docker](https://docs.docker.com/install/) installed. + +## Quickstart + +To run a Pantheon node in a container connected to the Ethereum mainnet: + +```bash +docker run pegasyseng/pantheon:latest +``` + +## Command Line Options + +!!!attention + You cannot use the following Pantheon command line options when running Pantheon from the Docker image: + + * [`--datadir`](../Reference/Pantheon-CLI-Syntax.md#datadir), see [Persisting Data](#persisting-data) + * [`--config`](../Reference/Pantheon-CLI-Syntax.md#config), see [Custom Configuration File](#custom-configuration-file) + * [`--genesis`](../Reference/Pantheon-CLI-Syntax.md#genesis), see [Custom Genesis File](#custom-genesis-file). + * [`--rpc-listen`](../Reference/Pantheon-CLI-Syntax.md#rpc-listen), [`--p2plisten`](../Reference/Pantheon-CLI-Syntax.md#p2plisten), [`--ws-listen`](../Reference/Pantheon-CLI-Syntax.md#ws-listen), see [Exposing Ports](#exposing-ports) + + All other [Pantheon command line options](/Reference/Pantheon-CLI-Syntax) work in the same way as when Pantheon is installed locally. + +### Persisting Data + +Specify a Docker volume to persist data between stopping and restarting the container. This is the equivalent of specifying the [`--datadir`](../Reference/Pantheon-CLI-Syntax.md#datadir) option. + +If a Docker volume is not specified, all data saved to the data directory is removed each time the container is stopped. + +To run Pantheon specifying a volume for the data directory: + +```bash +docker run --mount type=bind,source=/,target=/var/lib/pantheon pegasyseng/pantheon:latest + +``` + +Where `` is the volume to which the data is saved. + +### Custom Configuration File + +Specify a custom configuration file to provide a file containing key/value pairs for command line options. This is the equivalent of specifying the [`--config`](../Reference/Pantheon-CLI-Syntax.md#config) option. + +To run Pantheon specifying a custom configuration file: +```bash +docker run --mount type=bind,source=/,target=/etc/pantheon/pantheon.conf pegasyseng/pantheon:latest + +``` + +Where `myconf.toml` is your custom configuration file and `path` is the absolute path to the file. +!!!example + ```bash + docker run --mount type=bind,source=/Users/username/pantheon/myconf.toml,target=/etc/pantheon/pantheon.conf pegasyseng/pantheon:latest + ``` + +### Custom Genesis File + +Specify a custom genesis file to configure the blockchain. This is equivalent to specifying the `--genesis` option. + +To run Pantheon specifying a custom genesis file: +```bash +docker run --mount type=bind,source=,target=/etc/pantheon/genesis.json pegasyseng/pantheon:latest +``` + +Where `mygenesis.json` is your custom configuration file and `path` is the absolute path to the file. + +!!!example + ```bash + docker run --mount type=bind,source=/Users/username/pantheon/mygenesis.json,target=/etc/pantheon/genesis.json pegasyseng/pantheon:latest + ``` + +### Exposing Ports + +Expose ports for P2P peer discovery, JSON-RPC service, and WebSockets. This is required to use the +defaults ports or specify different ports (the equivalent of specifying the [`--rpc-listen`](../Reference/Pantheon-CLI-Syntax.md#rpc-listen), +[`--p2p-listen`](../Reference/Pantheon-CLI-Syntax.md#p2p-listen), [`--ws-listen`](../Reference/Pantheon-CLI-Syntax.md#ws-listen) options). + +To run Pantheon exposing local ports for access: +```bash +$ docker run -p :8545 -p :8546 -p :30303 pegasyseng/pantheon:latest --rpc-enabled --ws-enabled +``` + +!!!example + To enable RPC calls to http://127.0.0.1:8545 and P2P discovery on http://127.0.0.1:13001: + ```bash + docker run -p 8545:8545 -p 13001:30303 pegasyseng/pantheon:latest --rpc-enabled + ``` + +## Starting Pantheon + +### Run a Node on Ethereum Mainnet + +To run a node on the Ethereum mainnet: + +```bash +docker run -p 30303:30303 --mount type=bind,source=/,target=/var/lib/pantheon pegasyseng/pantheon:latest +``` + +To run a node on mainnet with the HTTP JSON-RPC service enabled: +```bash +docker run -p 8545:8545 -p 30303:30303 --mount type=bind,source=/,target=/var/lib/pantheon pegasyseng/pantheon:latest --rpc-enabled +``` + +## Run a Node on Ropsten Testnet + +Save a local copy of the [Ropsten genesis file](https://github.com/PegaSysEng/pantheon/blob/master/config/src/main/resources/ropsten.json). + +To run a node on Ropsten: +```bash +docker run -p 30303:30303 --mount type=bind,source=/,target=/var/lib/pantheon --mount type=bind,source=//ropsten.json,target=/etc/pantheon/genesis.json pegasyseng/pantheon:latest --network-id=3 --bootnodes=enode://6332792c4a00e3e4ee0926ed89e0d27ef985424d97b6a45bf0f23e51f0dcb5e66b875777506458aea7af6f9e4ffb69f43f3778ee73c81ed9d34c51c4b16b0b0f@52.232.243.152:30303,enode://94c15d1b9e2fe7ce56e458b9a3b672ef11894ddedd0c6f247e0f1d3487f52b66208fb4aeb8179fce6e3a749ea93ed147c37976d67af557508d199d9594c35f09@192.81.208.223:30303 +``` + +## Run a Node on Rinkeby Testnet + +To run a node on Rinkeby: +```bash +docker run -p 30303:30303 --mount type=bind,source=/,target=/var/lib/pantheon pegasyseng/pantheon:latest --rinkeby +``` + +## Run a Node for Testing + +To run a node that mines blocks at a rate suitable for testing purposes with WebSockets enabled: +```bash +docker run -p 8546:8546 --mount type=bind,source=/,target=/var/lib/pantheon pegasyseng/pantheon:latest --dev-mode --bootnodes= --miner-enabled --miner-coinbase fe3b557e8fb62b89f4916b721be55ceb828dbd73 --rpc-cors-origins "all" --ws-enabled +``` + +## Stopping Pantheon and Cleaning up Resources + +When you're done running nodes, you can shut down the node container without deleting resources. Alternatively, you can delete the container (after stopping it) and its associated volume. Run `docker container ls` and `docker volume ls` to obtain the container and volume names. Then run the following commands: + +To stop a container: +```bash +docker stop +``` + +To delete a container: +```bash +docker rm +``` + +To delete a container volume (optional): +```bash +docker volume rm +``` \ No newline at end of file diff --git a/docs/Getting-Started/Starting-Pantheon.md b/docs/Getting-Started/Starting-Pantheon.md new file mode 100644 index 0000000000..650532f70d --- /dev/null +++ b/docs/Getting-Started/Starting-Pantheon.md @@ -0,0 +1,115 @@ +description: Starting Pantheon + + +# Starting Pantheon + +Pantheon nodes can be used for varying purposes as described in the [Overview](../index.md). +Nodes can connect to the Ethereum mainnet, public testnets such as Ropsten, or private networks. + +## Prerequisites + +[Pantheon Installed](../Installation/Overview.md) + +## Local Block Data + +When connecting to a network other than the network previously connected to, you must either delete the local block data +or use the [`--datadir`](../Reference/Pantheon-CLI-Syntax.md#datadir) option to specify a different data directory. + +To delete the local block data, delete the `database` directory in the `pantheon/build/distribution/pantheon-` directory. + +## Genesis Configuration + +Pantheon specifies the genesis configuration, and sets the network ID and bootnodes when connecting to [Mainnet](#run-a-node-on-ethereum-mainnet), +[Rinkeby](#run-a-node-on-rinkeby-testnet), and [Ropsten](#run-a-node-on-ropsten-testnet). + +When [`--dev-mode`](../Reference/Pantheon-CLI-Syntax.md#dev-mode) is specified, Pantheon uses the development mode genesis configuration. + +The genesis files defining the genesis configurations are in the [Pantheon source files](https://github.com/PegaSysEng/pantheon/tree/master/config/src/main/resources). + +To define a genesis configuration, create a genesis file (for example, `genesis.json`) and specify the file +using the [`--genesis`](../Reference/Pantheon-CLI-Syntax.md#genesis) option. + +## Confirm Node is Running + +If you have started Pantheon with the [`--rpc-enabled`](../Reference/Pantheon-CLI-Syntax.md#rpc-enabled) option, use [cURL](https://curl.haxx.se/) to +call [JSON-RPC API methods](../Reference/JSON-RPC-API-Methods.md) to confirm the node is running. + +!!!example + + * `eth_chainId` returns the chain ID of the network. + + ```bash + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' 127.0.0.1:8545 + ``` + + * `eth_syncing` returns the starting, current, and highest block. + + ```bash + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' 127.0.0.1:8545 + ``` + + For example, after connecting to mainnet `eth_syncing` will return something similar to: + + ```json + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : { + "startingBlock" : "0x0", + "currentBlock" : "0x2d0", + "highestBlock" : "0x66c0" + } + } + ``` + +## Run a Node on Ethereum Mainnet + +To run a node on the Ethereum mainnet: + +```bash +$ bin/pantheon +``` + +To run a node on mainnet with the HTTP JSON-RPC service enabled: + +```bash +$ bin/pantheon --rpc-enabled +``` + +## Run a Node on Ropsten Testnet + +!!!note + From v0.8.2 or when [building from source](../Installation/Overview.md), use the [`--ropsten` option](../Reference/Pantheon-CLI-Syntax.md#options) + instead of the following options. For v0.8.1, use the following options. + +Replace `` with the path to the `/pantheon` directory. + +To run a node on Ropsten: + +```bash +$ bin/pantheon --network-id=3 --genesis=/pantheon/ethereum/core/src/main/resources/ropsten.json --bootnodes=enode://6332792c4a00e3e4ee0926ed89e0d27ef985424d97b6a45bf0f23e51f0dcb5e66b875777506458aea7af6f9e4ffb69f43f3778ee73c81ed9d34c51c4b16b0b0f@52.232.243.152:30303,enode://94c15d1b9e2fe7ce56e458b9a3b672ef11894ddedd0c6f247e0f1d3487f52b66208fb4aeb8179fce6e3a749ea93ed147c37976d67af557508d199d9594c35f09@192.81.208.223:30303 +``` + +To run a node on Ropsten with the HTTP JSON-RPC service enabled and allow Remix to access the node: + +```bash +$ bin/pantheon --rpc-enabled --rpc-cors-origins "http://remix.ethereum.org" --network-id=3 --genesis=/pantheon/ethereum/core/src/main/resources/ropsten.json --bootnodes=enode://6332792c4a00e3e4ee0926ed89e0d27ef985424d97b6a45bf0f23e51f0dcb5e66b875777506458aea7af6f9e4ffb69f43f3778ee73c81ed9d34c51c4b16b0b0f@52.232.243.152:30303,enode://94c15d1b9e2fe7ce56e458b9a3b672ef11894ddedd0c6f247e0f1d3487f52b66208fb4aeb8179fce6e3a749ea93ed147c37976d67af557508d199d9594c35f09@192.81.208.223:30303 +``` + +## Run a Node on Rinkeby Testnet + +Replace `` with the path where the Rinkeby chain data is to be saved. + +To run a node on Rinkeby specifying a data directory: + +```bash +$ bin/pantheon --rinkeby --datadir=/rinkebyDataDir +``` + +## Run a Node for Testing + +To run a node that mines blocks at a rate suitable for testing purposes: + +```bash +$ bin/pantheon --dev-mode --network-id="2018" --bootnodes= --miner-enabled --miner-coinbase fe3b557e8fb62b89f4916b721be55ceb828dbd73 --rpc-cors-origins "all" --ws-enabled --rpc-enabled +``` \ No newline at end of file diff --git a/docs/GettingStartedBinaries.md b/docs/GettingStartedBinaries.md index ec131dec64..89be70697f 100644 --- a/docs/GettingStartedBinaries.md +++ b/docs/GettingStartedBinaries.md @@ -8,8 +8,9 @@ After you download and unpackage Pantheon: ./bin/pantheon --help ``` -A [basic quickstart](https://github.com/PegaSysEng/pantheon/wiki/Quickstart) and other options for [starting Pantheon](https://github.com/PegaSysEng/pantheon/wiki/Starting-Pantheon) are included in the documentation. +A [basic quickstart](Getting-Started/Getting-Started.md) and other options for [starting Pantheon](Getting-Started/Starting-Pantheon.md) are included in the documentation. -The documentation is included in this release package and on the [Pantheon Wiki](https://github.com/PegaSysEng/pantheon/wiki). +The documentation is included in this release package and on the [Pantheon documentation site](https://pantheon.readthedocs.io/). ->**Note** Starting Pantheon by double-clicking the `pantheon` or `pantheon.bat` executables starts a node synchronizing with the Ethereum mainnet. \ No newline at end of file +!!!note + Starting Pantheon by double-clicking the `pantheon` or `pantheon.bat` executables starts a node synchronizing with the Ethereum mainnet. \ No newline at end of file diff --git a/docs/Installation/Build-From-Source.md b/docs/Installation/Build-From-Source.md new file mode 100644 index 0000000000..8f9b4cd1ed --- /dev/null +++ b/docs/Installation/Build-From-Source.md @@ -0,0 +1,133 @@ +description: Building Pantheon from source code + + +# Build from Source + +## Prerequisites + +* [Java JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html) + +!!!important + Pantheon requires Java 8+ to compile; earlier versions are not supported. + +* [Git](https://git-scm.com/downloads) or [GitHub Desktop](https://desktop.github.com/) + +## Running Locally + +* [Installation on Linux / Unix / Mac OS X](#installation-on-linux-unix-mac-os-x) +* [Installation on Windows](#installation-on-windows) + +## Running On Virtual Machine + +* [Installation on VM](#installation-on-vm) + + +## Installation on Linux / Unix / Mac OS X + +###Clone the Pantheon Repository + +Clone the **PegaSysEng/pantheon** repo to your home directory (`/home/`): + +```bash +$ git clone --recursive https://github.com/PegaSysEng/pantheon.git +``` + +### Build Pantheon + +After cloning, go to the `pantheon` directory. + +Build Pantheon with the Gradle wrapper `gradlew`, omitting tests as follows: + +```bash +$ ./gradlew build -x test +``` + +Go to the distribution directory: +```bash +$ cd build/distributions/ +``` + +Expand the distribution archive: +```bash +$ tar -xzf pantheon-.tar.gz +``` + +Move to the expanded folder and display the Pantheon help to confirm installation. +````bash +$ cd pantheon-/ +$ bin/pantheon --help +```` + +Continue with the [Private Network Quickstart](../Getting-Started/Private-Network-Quickstart.md) or [Starting Pantheon](../Getting-Started/Starting-Pantheon.md). + + +## Installation on Windows + +!!!note + Pantheon is currently supported only on 64-bit versions of Windows, and requires a 64-bit version of JDK/JRE. + We recommend that you also remove any 32-bit JDK/JRE installations. + +### Install Pantheon + +In Git bash, go to your working directory for repositories. Clone the `PegaSysEng/pantheon` repo into this directory: + +```bat +git clone --recursive https://github.com/PegaSysEng/pantheon +``` + +### Build Pantheon + +Go to the `pantheon` directory: + +```bat +cd pantheon +``` + +Open a Windows command prompt. Build Pantheon with the Gradle wrapper `gradlew`, omitting tests as follows: + +```bat +gradlew build -x test +``` + +!!!note + To run `gradlew`, you must have the **JAVA_HOME** system variable set to the Java installation directory. + For example: `JAVA_HOME = C:\Program Files\Java\jdk1.8.0_181`. + +Go to the distribution directory: +```bat +cd build\distributions +``` + +Expand the distribution archive: +```bat +tar -xzf pantheon-.tar.gz +``` + +Move to the expanded folder and display the Pantheon help to confirm installation. +```bat +cd pantheon- +bin\pantheon --help +``` + +Continue with the [Private Network Quickstart](../Getting-Started/Private-Network-Quickstart.md) or [Starting Pantheon](../Getting-Started/Starting-Pantheon.md). + + +## Installation on VM + +You can run Pantheon on a virtual machine (VM) on a cloud service such as AWS or Azure, or locally using a VM manager such as [VirtualBox](https://www.virtualbox.org/). + +If you set up your own VM locally using a VM manager such as [VirtualBox](https://www.virtualbox.org/), there are a few considerations: + +* Make sure that Intel Virtualization Technology (VTx) and Virtualization Technology for Directed I/O (VT-d) are enabled in BIOS settings. + +* On Windows, you might need to disable Hyper-V in the Windows Feature list. + +It is recommended that you create a VM with the following attributes: + +* Memory Size: Set to 4096 (recommended) + +* Create a virtual hard disk with at least 10 GB; 20 GB is recommended + +* Virtual hard disk file type: VDI (if you need to share it with other apps, use VHD) + +* (Optional) You can create a shared directory in order to copy block files or genesis files from the host computer to the VM. For details on how to create a shared directory, see "Share Folders" in [Install Ubuntu on Oracle VirtualBox](https://linus.nci.nih.gov/bdge/installUbuntu.html). \ No newline at end of file diff --git a/docs/Installation/Install-Binaries.md b/docs/Installation/Install-Binaries.md new file mode 100644 index 0000000000..e6f4a33336 --- /dev/null +++ b/docs/Installation/Install-Binaries.md @@ -0,0 +1,69 @@ +description: Install Pantheon from binary distribution + + +# Install Binary Distribution + +## Mac OS with Homebrew + +### Prerequisites + +* [Homebrew](https://brew.sh/) + +### Install Using Homebrew + +```bash +$ brew tap pegasyseng/pantheon +$ brew install pantheon +``` +Display Pantheon command line help to confirm installation: + +```bash +$ pantheon --help +``` + +## Windows with Chocolatey + +### Prerequisites + +* [Chocolatey](Install-Chocolatey.md) + +### Install Using Chocolatey + +To install from [Chocolatey package](https://chocolatey.org/packages/pantheon/): + +```bat +choco install pantheon +``` + +Display Pantheon command line help to confirm installation: + +```bat +pantheon --help +``` + +## Linux / Unix / Windows without Chocolatey + +### Prerequisites + +* [Java JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html) + +!!!attention + Pantheon requires Java 8+ to compile; earlier versions are not supported. + Pantheon is currently supported only on 64-bit versions of Windows, and requires a 64-bit version of JDK/JRE. + We recommend that you also remove any 32-bit JDK/JRE installations. + +### Install from Packaged Binaries + +Download the Pantheon [packaged binaries](https://bintray.com/consensys/pegasys-repo/pantheon/_latestVersion#files). + +Unpack the downloaded files and change into the `pantheon-` directory. + +Display Pantheon command line help to confirm installation: + +```bash tab="Linux/macOS" +$ bin/pantheon --help +``` + +```bat tab="Windows" +bin\pantheon --help +``` \ No newline at end of file diff --git a/docs/Installation/Install-Chocolatey.md b/docs/Installation/Install-Chocolatey.md new file mode 100644 index 0000000000..578a988165 --- /dev/null +++ b/docs/Installation/Install-Chocolatey.md @@ -0,0 +1,22 @@ +description: Install Pantheon on Windows from Chocolatey package manager + + +# Install Chocolatey + +To install Chocolatey: + +1. Open **cmd.exe** as the administrative user by right-clicking on **cmd.exe** in the Start menu and selecting **Run as administrator**. + +2. Run: + + ```bat + @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin" + ``` + +3. Display the Chocolatey help to confirm installation: + + ```bat + choco -? + ``` + +For more information, refer to the [Chocolatey documentation](https://chocolatey.org/install). \ No newline at end of file diff --git a/docs/Installation/Overview.md b/docs/Installation/Overview.md new file mode 100644 index 0000000000..66294050a8 --- /dev/null +++ b/docs/Installation/Overview.md @@ -0,0 +1,18 @@ +title: Installation overview +description: Overview and requirements to install Pantheon + + +# Installation Overview + +You can install Pantheon by: + +* [Installing the binary distribution](Install-Binaries.md) +* [Building from source](Build-From-Source.md) + +!!! note + To run a single node to connect the Ethereum mainnet or a public testnet, running from the [Pantheon docker image](../Getting-Started/Run-Docker-Image.md) is the fastest way to get started. + +## Disk Space and RAM Requirements +Your computer should have at least 4 GB RAM. + +Disk space needed varies depending on the network on which you run nodes. A small test network might require 200 MB while a mainnet node might require 1.5TB. If syncing a node on mainnet, allow 1.5 TB to 2 TB for the full blockchain archive. diff --git a/docs/Reference/JSON-RPC-API-Methods.md b/docs/Reference/JSON-RPC-API-Methods.md new file mode 100644 index 0000000000..8045d7c66e --- /dev/null +++ b/docs/Reference/JSON-RPC-API-Methods.md @@ -0,0 +1,1817 @@ +description: Pantheon JSON-RPC API methods reference + + +# JSON-RPC API Methods + +!!! danger "Breaking Change in v0.8.3" + From v0.8.3, incoming HTTP requests are only accepted from hostnames specified using the [`--host-whitelist`](Using-JSON-RPC-API.md#breaking-change-in-v083) option. + +The following lists the Pantheon JSON-RPC API commands: + +## Admin Methods + +### admin_peers + +Returns networking information about connected remote nodes. + +**Parameters** + +None + +**Returns** + +`result` : *array* of *objects* - Object returned for each remote node. + +Properties of the remote node object are: + +* `version` - P2P protocol version +* `name` - Client name +* `caps` - P2P message capabilities +* `network` - Addresses of local node and remote node +* `port` - Port +* `id` - Node public key. Excluding the `0x` prefix, the node public key is the ID in the enode URL `enode://@`. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"admin_peers","params":[],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"admin_peers","params":[],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : [ + { + "version" : "0x5", + "name" : "Geth/v1.8.20-unstable-92639b67/linux-amd64/go1.11.1", + "caps" : [ + "eth/62", + "eth/63" + ], + "network" : { + "localAddress" : "192.168.1.229:51279", + "remoteAddress" : "52.3.158.184:30303" + }, + "port" : "0x0", + "id" : "0x343149e4feefa15d882d9fe4ac7d88f885bd05ebb735e547f12e12080a9fa07c8014ca6fd7f373123488102fe5e34111f8509cf0b7de3f5b44339c9f25e87cb8" + } + ] + } + ``` + +## Web3 Methods + +### web3_clientVersion + +Returns the current client version. + +**Parameters** + +None + +**Returns** + +`result` : *string* - Current client version. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "pantheon/1.0.0" + } + ``` + +### web3_sha3 + +Returns a [SHA3](https://en.wikipedia.org/wiki/SHA-3) hash of the specified data. The result value is a [Keccak-256](https://keccak.team/keccak.html) hash, not the standardized SHA3-256. + +**Parameters** + +`DATA` - Data to convert to a SHA3 hash. + +**Returns** + +`result` (*DATA*) - SHA3 result of the input data. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c00"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c00"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x5e39a0a66544c0668bde22d61c47a8710000ece931f13b84d3b2feb44ec96d3f" + } + ``` + +## Net Methods + +### net_version + +Returns the current chain ID. + +**Parameters** + +None + +**Returns** + +`result` : *string* - Current chain ID. +- `1` - Ethereum Mainnet +- `2` - Morden Testnet (deprecated) +- `3` - Ropsten Testnet +- `4` - Rinkeby Testnet +- `42` - Kovan Testnet + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data ''{"jsonrpc":"2.0","method":"net_version","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + $ wscat -c + connected (press CTRL+C to quit) + > '{"jsonrpc":"2.0","method":"net_version","params":[],"id":53} + ``` + + ```json tab="JSON result for Mainnet" + { + "jsonrpc" : "2.0", + "id" : 51, + "result" : "1" + } + ``` + + ```json tab="JSON result for Ropsten" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "3" + } + ``` + +### net_listening + +Indicates whether the client is actively listening for network connections. + +**Parameters** + +None + +**Returns** + +`result` (*BOOLEAN*) - `true` if the client is actively listening for network connections; otherwise `false`. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"net_listening","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : true + } + ``` + +### net_peerCount + +Returns the number of peers currently connected to the client. + +**Parameters** + +None + +**Returns** + +`result` : *integer* - Number of connected peers in hexadecimal. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x5" + } + ``` + +## Eth Methods + +### eth_syncing + +Returns an object with data about the synchronization status, or `false` if not synchronizing. + +**Parameters** + +None + +**Returns** + +`result` : *Object|Boolean* - Object with synchronization status data or `false`, when not synchronizing: + +* `startingBlock` : *quantity* - Index of the highest block on the blockchain when the network synchronization starts. + + If you start with an empty blockchain, the starting block is the beginning of the blockchain (`startingBlock` = 0). + + If you import a block file using `pantheon import `, the synchronization starts at the head of the blockchain, and the starting block is the next block synchronized. For example, if you imported 1000 blocks, the import would include blocks 0 to 999, so in that case `startingBlock` = 1000. + +* `currentBlock` : *quantity* - Index of the latest block (also known as the best block) for the current node. This is the same index that [eth_blockNumber](#eth_blocknumber) returns. + +* `highestBlock`: *quantity* - Index of the highest known block in the peer network (that is, the highest block so far discovered among peer nodes). This is the same value as `currentBlock` if the current node has no peers. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":51}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":51} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 51, + "result" : { + "startingBlock" : "0x5a0", + "currentBlock" : "0xad9", + "highestBlock" : "0xad9" + } + } + ``` + +### eth_chainId + +Returns the [chain ID](../Configuring-Pantheon/NetworkID-And-ChainID.md). + +!!!note + This method is only available from v0.8.2 or when you [build from source](../Installation/Build-From-Source.md). + +**Parameters** + +None + +**Returns** + +`result` : *quantity* - Chain ID in hexadecimal. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":51}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":51} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 51, + "result" : "0x7e2" + } + ``` + +### eth_coinbase + +Returns the client coinbase address. The coinbase address is the account to which mining rewards are paid. + +To set a coinbase address, start Pantheon with the `--miner-coinbase` option set to a valid Ethereum account address. +You can get the Ethereum account address from a client such as MetaMask or Etherscan. For example: + +!!!example + ```bash + $ bin/pantheon --miner-coinbase="0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" --rpc-enabled + ``` + +**Parameters** + +None + +**Returns** + +`result` : *data* - Coinbase address. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" + } + ``` + +### eth_mining + +Indicates whether the client is actively mining new blocks. Mining is paused while the client synchronizes with the network regardless of command settings or methods called. + +**Parameters** + +None + +**Returns** + +`result` (*BOOLEAN*) - `true` if the client is actively mining new blocks; otherwise `false`. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_mining","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : true + } + ``` + +### eth_gasPrice + +Returns the current gas unit price in wei. + +**Parameters** + +None + +**Returns** + +`result` : *quantity* - Current gas unit price in wei as a hexadecimal value. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x3e8" + } + ``` + +### eth_accounts + +Returns a list of account addresses that the client owns. + +!!!note + This method returns an empty object because Pantheon [does not support account management](Using-JSON-RPC-API.md#account-management-not-supported-by-pantheon). + +**Parameters** + +None + +**Returns** + +`Array of data` : List of 20-byte account addresses owned by the client. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : [ ] + } + ``` + +### eth_blockNumber + +Returns the index of the current block the client is processing. + +**Parameters** + +None + +**Returns** + +`result` : *QUANTITY* - Hexadecimal integer representing the 0-based index of the block that the client is currently processing. + + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":51}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":51} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 51, + "result" : "0x2377" + } + ``` + +### eth_getBalance + +Returns the account balance of the specified address. + +**Parameters** + +`DATA` - 20-byte account address from which to retrieve the balance. + +`QUANTITY|TAG` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +**Returns** + +`result` : *QUANTITY* - Integer value of the current balance in wei. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xdd37f65db31c107f773e82a4f85c693058fef7a9", "latest"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getBalance","params":["0xdd37f65db31c107f773e82a4f85c693058fef7a9", "latest"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x0" + } + ``` + +### eth_getStorageAt + +Returns the value of a storage position at a specified address. + +**Parameters** + +`DATA` - A 20-byte storage address. + +`QUANTITY` - Integer index of the storage position. + +`QUANTITY|TAG` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](JSON-RPC-API-Objects.md#block-parameter). + +**Returns** + +`result` : *DATA* - The value at the specified storage position. + +!!! example + Calculating the correct position depends on the storage you want to retrieve. + + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method": "eth_getStorageAt","params": ["0x‭3B3F3E‬","0x0","latest"],"id": 53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method": "eth_getStorageAt","params": ["0x‭3B3F3E‬","0x0","latest"],"id": 53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x0000000000000000000000000000000000000000000000000000000000000000" + } + ``` + +### eth_getTransactionCount + +Returns the number of transactions sent from a specified address. + +**Parameters** + +`DATA` - 20-byte account address. + +`QUANTITY|TAG` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +**Returns** + +`result` : *QUANTITY* - Integer representing the number of transactions sent from the specified address. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0xc94770007dda54cF92009BFF0dE90c06F603a09f","latest"],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0xc94770007dda54cF92009BFF0dE90c06F603a09f","latest"],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : "0x1" + } + ``` + +### eth_getBlockTransactionCountByHash + +Returns the number of transactions in the block matching the given block hash. + +**Parameters** + +`DATA` - 32-byte block hash. + +**Returns** + +`result` : *QUANTITY* - Integer representing the number of transactions in the specified block. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : null + } + ``` + +### eth_getBlockTransactionCountByNumber + +Returns the number of transactions in a block matching the specified block number. + +**Parameters** + +`QUANTITY|TAG` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +**Returns** + +`result` : *QUANTITY* - Integer representing the number of transactions in the specified block. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0xe8"],"id":51}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0xe8"],"id":51} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 51, + "result" : "0x8" + } + ``` + +### eth_getUncleCountByBlockHash + +Returns the number of uncles in a block from a block matching the given block hash. + +**Parameters** + +`DATA` - 32-byte block hash. + +**Returns** + +`result` : *QUANTITY* - Integer representing the number of uncles in the specified block. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : null + } + ``` + +### eth_getUncleCountByBlockNumber + +Returns the number of uncles in a block matching the specified block number. + +**Parameters** + +`QUANTITY|TAG` - Integer representing either the 0-based index of the block within the blockchain, or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +**Returns** + +`result` : *QUANTITY* - Integer representing the number of uncles in the specified block. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : "0x1" + } + ``` + +### eth_getCode + +Returns the code of the smart contract at the specified address. Compiled smart contract code is stored as a hexadecimal value. + +**Parameters** + +`DATA` - 20-byte contract address. + +`QUANTITY|TAG` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +**Returns** + +`result` : *DATA* - Code stored at the specified address. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xa50a51c09a5c451c52bb714527e1974b686d8e77", "latest"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getCode","params":["0xa50a51c09a5c451c52bb714527e1974b686d8e77", "latest"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc": "2.0", + "id": 53, + "result": "0x60806040526004361060485763ffffffff7c01000000000000000000000000000000000000000000000000000000006000350416633fa4f2458114604d57806355241077146071575b600080fd5b348015605857600080fd5b50605f6088565b60408051918252519081900360200190f35b348015607c57600080fd5b506086600435608e565b005b60005481565b60008190556040805182815290517f199cd93e851e4c78c437891155e2112093f8f15394aa89dab09e38d6ca0727879181900360200190a1505600a165627a7a723058209d8929142720a69bde2ab3bfa2da6217674b984899b62753979743c0470a2ea70029" + } + ``` + +### eth_sendRawTransaction + +Sends a signed transaction. A transaction can send ether, deploy a contract, or interact with a contract. + +You can interact with contracts using [eth_sendRawTransaction or eth_call](../Using-Pantheon/Transactions.md#eth_call-or-eth_sendrawtransaction). + +To avoid exposing your private key, create signed transactions offline and send the signed transaction data using this method. For information on creating signed transactions and using `eth_sendRawTransaction`, refer to [Using Pantheon](../Using-Pantheon/Transactions.md). + +!!!important + Pantheon does not implement [eth_sendTransaction](Using-JSON-RPC-API.md#account-management-not-supported-by-pantheon). + +**Parameters** + +`DATA` - Hash of the signed raw transaction in hexadecimal format; for example: + +`params: ["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"]` + + +**Returns** + +`result` : `DATA` - 32-byte transaction hash, or zero hash if the transaction is not yet available. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"],"id":1} + ``` + + ```json tab="JSON result" + { + "id":1, + "jsonrpc": "2.0", + "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331" + } + ``` + +### eth_call + +Invokes a contract function locally and does not change the state of the blockchain. + +You can interact with contracts using [eth_sendRawTransaction or eth_call](../Using-Pantheon/Transactions.md#eth_call-or-eth_sendrawtransaction). + +**Parameters** + +*OBJECT* - [Transaction call object](JSON-RPC-API-Objects.md#transaction-call-object). + +*QUANTITY|TAG* - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](JSON-RPC-API-Objects.md#block-parameter). + +**Returns** + +`result` (*DATA*) - Return value of the executed contract. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x69498dd54bd25aa0c886cf1f8b8ae0856d55ff13","value":"0x1"}, "latest"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x69498dd54bd25aa0c886cf1f8b8ae0856d55ff13","value":"0x1"}, "latest"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc": "2.0", + "id": 53, + "result": "0x" + } + ``` + +### eth_estimateGas + +Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. (Per Etherscan: gas price * gas used.) The transaction is added to the blockchain. The estimate may be significantly more than the amount of gas actually used by the transaction for reasons including EVM mechanics and node performance. + +**Parameters** + +!!!note + Parameters are the same as the eth_call parameters, except that all properties are optional. If you do not specify a `gas` limit, Pantheon uses the gas limit from the pending block as an upper bound. As a result, the returned estimate might not be enough to execute the call or transaction when the amount of gas is higher than the pending block's gas limit. + +*OBJECT* - [Transaction call object](JSON-RPC-API-Objects.md#transaction-call-object). + +*QUANTITY|TAG* - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +**Returns** + +`result` (*QUANTITY*) - Amount of gas used. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{"from":"0x687422eea2cb73b5d3e242ba5456b782919afc85","to":"0xdd37f65db31c107f773e82a4f85c693058fef7a9","value":"0x1"}],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_estimateGas","params":[{"from":"0x687422eea2cb73b5d3e242ba5456b782919afc85","to":"0xdd37f65db31c107f773e82a4f85c693058fef7a9","value":"0x1"}],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 54, + "result" : "0x5208" + } + ``` + +### eth_getBlockByHash + +Returns information about the block by hash. + +**Parameters** + +`DATA` - 32-byte hash of a block. + +`Boolean` - If `true`, returns the full [transaction objects](JSON-RPC-API-Objects.md#transaction-object); if `false`, returns the transaction hashes. + +**Returns** + +`result` : *OBJECT* - [Block object](JSON-RPC-API-Objects.md#block-object) , or `null` when no block is found. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0x16b69965a5949262642cfb5e86368ddbbe57ab9f17d999174a65fd0e66580d8f", false],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0x16b69965a5949262642cfb5e86368ddbbe57ab9f17d999174a65fd0e66580d8f", false],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : { + "number" : "0x7", + "hash" : "0x16b69965a5949262642cfb5e86368ddbbe57ab9f17d999174a65fd0e66580d8f", + "parentHash" : "0xe9bd4b277983580ef0eabad6011891f8b6aff9381a78bd1c4faca374a48b3e09", + "nonce" : "0x46acb59e85b5bb6d", + "sha3Uncles" : "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "logsBloom" : "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "transactionsRoot" : "0x7aa0913c235f272eb6ed6ab74ba5a057e0a62c1c1d1dbccfd971221e6b6e83a3", + "stateRoot" : "0xfaf6520d6e3d24107a4309855593341ab87a1744dbb6eea4e709b92e9c9107ca", + "receiptsRoot" : "0x056b23fbba480696b65fe5a59b8f2148a1299103c4f57df839233af2cf4ca2d2", + "miner" : "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "difficulty" : "0x5", + "totalDifficulty" : "0x10023", + "extraData" : "0x", + "size" : "0x270", + "gasLimit" : "0x1000000", + "gasUsed" : "0x5208", + "timestamp" : "0x5bbbe99f", + "uncles" : [ ], + "transactions" : [ "0x2cc6c94c21685b7e0f8ddabf277a5ccf98db157c62619cde8baea696a74ed18e" ] + } + } + ``` + +### eth_getBlockByNumber + +Returns information about a block by block number. + +**Parameters** + +`QUANTITY|TAG` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +`Boolean` - If `true`, returns the full [transaction objects](JSON-RPC-API-Objects.md#transaction-object); if `false`, returns only the hashes of the transactions. + +**Returns** + +`result` : *OBJECT* - [Block object](JSON-RPC-API-Objects.md#block-object) , or `null` when no block is found. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x64", true],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x64", true],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : { + "number" : "0x64", + "hash" : "0xdfe2e70d6c116a541101cecbb256d7402d62125f6ddc9b607d49edc989825c64", + "parentHash" : "0xdb10afd3efa45327eb284c83cc925bd9bd7966aea53067c1eebe0724d124ec1e", + "nonce" : "0x37129c7f29a9364b", + "sha3Uncles" : "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "logsBloom" : "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "transactionsRoot" : "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "stateRoot" : "0x90c25f6d7fddeb31a6cc5668a6bba77adbadec705eb7aa5a51265c2d1e3bb7ac", + "receiptsRoot" : "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "miner" : "0xbb7b8287f3f0a933474a79eae42cbca977791171", + "difficulty" : "0x42be722b6", + "totalDifficulty" : "0x19b5afdc486", + "extraData" : "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32", + "size" : "0x21e", + "gasLimit" : "0x1388", + "gasUsed" : "0x0", + "timestamp" : "0x55ba43eb", + "uncles" : [ ], + "transactions" : [ ] + } + } + ``` + +### eth_getTransactionByHash + +Returns transaction information for the specified transaction hash. + +**Parameters** + +`DATA` - 32-byte transaction hash. + +**Returns** + +Object - [Transaction object](JSON-RPC-API-Objects.md#transaction-object), or `null` when no transaction is found. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : { + "blockHash" : "0x510efccf44a192e6e34bcb439a1947e24b86244280762cbb006858c237093fda", + "blockNumber" : "0x422", + "from" : "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas" : "0x5208", + "gasPrice" : "0x3b9aca00", + "hash" : "0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44", + "input" : "0x", + "nonce" : "0x1", + "to" : "0x627306090abab3a6e1400e9345bc60c78a8bef57", + "transactionIndex" : "0x0", + "value" : "0x4e1003b28d9280000", + "v" : "0xfe7", + "r" : "0x84caf09aefbd5e539295acc67217563438a4efb224879b6855f56857fa2037d3", + "s" : "0x5e863be3829812c81439f0ae9d8ecb832b531d651fb234c848d1bf45e62be8b9" + } + } + ``` + +### eth_getTransactionByBlockHashAndIndex + +Returns transaction information for the specified block hash and transaction index position. + +**Parameters** + +`DATA` - 32-byte hash of a block. + +`QUANTITY` - Integer representing the transaction index position. + +**Returns** + +Object - [Transaction object](JSON-RPC-API-Objects.md#transaction-object), or `null` when no transaction is found. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0xbf137c3a7a1ebdfac21252765e5d7f40d115c2757e4a4abee929be88c624fdb7", "0x2"], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0xbf137c3a7a1ebdfac21252765e5d7f40d115c2757e4a4abee929be88c624fdb7", "0x2"], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : { + "blockHash" : "0xbf137c3a7a1ebdfac21252765e5d7f40d115c2757e4a4abee929be88c624fdb7", + "blockNumber" : "0x1442e", + "from" : "0x70c9217d814985faef62b124420f8dfbddd96433", + "gas" : "0x3d090", + "gasPrice" : "0x57148a6be", + "hash" : "0xfc766a71c406950d4a4955a340a092626c35083c64c7be907060368a5e6811d6", + "input" : "0x51a34eb8000000000000000000000000000000000000000000000029b9e659e41b780000", + "nonce" : "0x2cb2", + "to" : "0xcfdc98ec7f01dab1b67b36373524ce0208dc3953", + "transactionIndex" : "0x2", + "value" : "0x0", + "v" : "0x2a", + "r" : "0xa2d2b1021e1428740a7c67af3c05fe3160481889b25b921108ac0ac2c3d5d40a", + "s" : "0x63186d2aaefe188748bfb4b46fb9493cbc2b53cf36169e8501a5bc0ed941b484" + } + } + ``` + +### eth_getTransactionByBlockNumberAndIndex + +Returns transaction information for the specified block number and transaction index position. + +**Parameters** + +`QUANTITY|TAG` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +`QUANTITY` - The transaction index position. + +**Returns** + +Object - [Transaction object](JSON-RPC-API-Objects.md#transaction-object), or `null` when no transaction is found. + +!!!note + Your node must be synchronized to at least the block containing the transaction for the request to return it. + +!!! example + This request returns the third transaction in the 82990 block on the Ropsten testnet. You can also view this [block](https://ropsten.etherscan.io/txs?block=82990) and [transaction](https://ropsten.etherscan.io/tx/0xfc766a71c406950d4a4955a340a092626c35083c64c7be907060368a5e6811d6) on Etherscan. + + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["82990", "0x2"], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["82990", "0x2"], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : { + "blockHash" : "0xbf137c3a7a1ebdfac21252765e5d7f40d115c2757e4a4abee929be88c624fdb7", + "blockNumber" : "0x1442e", + "from" : "0x70c9217d814985faef62b124420f8dfbddd96433", + "gas" : "0x3d090", + "gasPrice" : "0x57148a6be", + "hash" : "0xfc766a71c406950d4a4955a340a092626c35083c64c7be907060368a5e6811d6", + "input" : "0x51a34eb8000000000000000000000000000000000000000000000029b9e659e41b780000", + "nonce" : "0x2cb2", + "to" : "0xcfdc98ec7f01dab1b67b36373524ce0208dc3953", + "transactionIndex" : "0x2", + "value" : "0x0", + "v" : "0x2a", + "r" : "0xa2d2b1021e1428740a7c67af3c05fe3160481889b25b921108ac0ac2c3d5d40a", + "s" : "0x63186d2aaefe188748bfb4b46fb9493cbc2b53cf36169e8501a5bc0ed941b484" + } + } + ``` + +### eth_getTransactionReceipt + +Returns the receipt of a transaction by transaction hash. Receipts for pending transactions are not available. + +**Parameters** + +`DATA` - 32-byte hash of a transaction. + +**Returns** + +`Object` - [Transaction receipt object](JSON-RPC-API-Objects.md#transaction-receipt-object), or `null` when no receipt is found. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x504ce587a65bdbdb6414a0c6c16d86a04dd79bfcc4f2950eec9634b30ce5370f"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x504ce587a65bdbdb6414a0c6c16d86a04dd79bfcc4f2950eec9634b30ce5370f"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc": "2.0", + "id": 1, + "result": { + "blockHash": "0xe7212a92cfb9b06addc80dec2a0dfae9ea94fd344efeb157c41e12994fcad60a", + "blockNumber": "0x50", + "contractAddress": null, + "cumulativeGasUsed": "0x5208", + "from": "0x627306090abab3a6e1400e9345bc60c78a8bef57", + "gasUsed": "0x5208", + "logs": [], + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "status": "0x1", + "to": "0xf17f52151ebef6c7334fad080c5704d77216b732", + "transactionHash": "0xc00e97af59c6f88de163306935f7682af1a34c67245e414537d02e422815efc3", + "transactionIndex": "0x0" + } + } + ``` + +### eth_newFilter + +Creates a topic filter with the specified options to notify (log) when the state changes. To determine whether the state has changed, call [eth_getFilterChanges](#eth_getfilterchanges). + +**Parameters** + +`Object` - [Filter options object](JSON-RPC-API-Objects.md#filter-options-object). + +!!!note + Topics are order-dependent. A transaction with a log containing topics `[A, B]` would be matched with the following topic filters: + + * [] - Match any topic + * [A] - Match A in first position (and any topic thereafter) + * [null, B] - Match any topic in first position AND B in second position (and any topic thereafter) + * [A, B] - Match A in first position AND B in second position (and any topic thereafter) + * [[A, B], [A, B]] - Match (A OR B) in first position AND (A OR B) in second position (and any topic thereafter) + + For example, params could be specified as follows: + !!!example + ```json + [{ + "fromBlock": "earliest", + "toBlock": "0x4", + "address": "0xc94770007dda54cF92009BFF0dE90c06F603a09f", + "topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", null, ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"]] + }] + ``` + +**Returns** + +`result` : *QUANTITY* - Filter ID. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":[]}],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":[]}],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x3" + } + ``` + +Invalid params error: + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"fromBlock": "earliest","toBlock": "latest","address": "0xDD37f65dB31c107F773E82a4F85C693058fEf7a9","topics": []}],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_newFilter","params":[{"fromBlock": "earliest","toBlock": "latest","address": "0xDD37f65dB31c107F773E82a4F85C693058fEf7a9","topics": []}],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "error" : { + "code" : -32602, + "message" : "Invalid params" + } + } + ``` + +### eth_newBlockFilter + +Creates a filter in the node that notifies when a new block arrives. To determine whether the state has changed, call [eth_getFilterChanges](#eth_getfilterchanges). + +**Parameters** + +None + +**Returns** + +`QUANTITY` - Hexadecimal integer filter ID. Each time you call this method, it creates a new filter, and the index is incremented by 1. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x3" + } + ``` + +### eth_newPendingTransactionFilter + +Creates a filter in the node that notifies when new pending transactions arrive. To check if the state has changed, call [eth_getFilterChanges](#eth_getfilterchanges). + +**Parameters** + +None + +**Returns** + +`QUANTITY` - Hexadecimal integer filter ID. Each time you call this method, it creates a new filter, and the index is incremented by 1. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : "0x4" + } + ``` + +### eth_uninstallFilter + +Uninstalls a filter with the specified ID. This method should always be called when notification is no longer needed. Note that filters time out when they are not requested with [eth_getFilterChanges](#eth_getfilterchanges) for a period of time. + +This method deletes filters of any type: block filters, pending transaction filters, and state (topic) filters. + + +**Parameters** + +`QUANTITY` - Hexadecimal integer filter ID specifying the filter to be deleted. + +**Returns** + +`Boolean` - `true` if the filter was successfully uninstalled; otherwise `false`. + +!!! example + The following request deletes the block filter with an ID of 0x4: + + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0x4"],"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0x4"],"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : true + } + ``` + +### eth_getFilterChanges + +Polls the specified filter and returns an array of logs that have occurred since the last poll. + +**Parameters** + +`QUANTITY` - Hexadecimal integer filter ID. + +**Returns** + +`result` : `Array of Object` - List of logs, or an empty array if nothing has changed since the last poll. + +* For filters created with `eth_newBlockFilter`, returns 32-byte *DATA* block hashes; for example `["0x3454645634534..."]`. +* For filters created with `eth_newPendingTransactionFilter`, returns transaction hashes (32-byte *DATA*); for example `["0x6345343454645..."]`. +* For filters created with `eth_newFilter`, returns [log objects](JSON-RPC-API-Objects.md#log-object). + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0xa"]:"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0xa"]:"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 53, + "result" : [ ] + } + ``` + +### eth_getFilterLogs + +Returns an array of logs matching the filter with the specified ID. + +**Parameters** + +`QUANTITY` - Integer representing the filter ID. + +**Returns** + +Same as [eth_getFilterChanges](#eth_getfilterchanges). + +!!! example + The following example requests logs for filter ID 0x16 (22 decimal): + + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x3"]"id":53}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x3"]"id":53} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : [ { + "logIndex" : "0x0", + "removed" : false, + "blockNumber" : "0x14427", + "blockHash" : "0x677bf4b962464e6dfd548d6a30b6c703dd78c7cc3602825a7013a6e90a001d2a", + "transactionHash" : "0x7bf9876a9de3c0add38495e21a17b96c81b3f18e0990a4a3aecdf9f47fea0eed", + "transactionIndex" : "0x0", + "address" : "0xe8fe77d1576d0972d453b49bfaa84d716173d133", + "data" : "0x0000000000000000000000001046c9bdec0e634fbd7cf91afebd93cc854432b10000000000000000000000002101416eeaf73acb66d124f79efde9631662a83a0000000000000000000000006f72045702a34c473da863945221965c61528bd3", + "topics" : [ "0xc36800ebd6079fdafc3a7100d0d1172815751804a6d1b7eb365b85f6c9c80e61", "0x000000000000000000000000b344324aa2a82a6fda8459e40923e1fd65bfac36" ] + } ] + } + ``` + +### eth_getLogs + +Returns an array of all logs matching a specified filter object. + +**Parameters** + +`Object` - [Filter options object](JSON-RPC-API-Objects.md#filter-options-object) + +**Returns** + +Same as [eth_getFilterChanges](#eth_getfilterchanges). + +!!!note + You must be synchronized to at least the requested block for the request to return the logs. + +!!! example + The request above returns the logs for the 82893 block on the Ropsten testnet. You can also view this [block](https://ropsten.etherscan.io/block/82983) on Etherscan. + + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"blockhash":"0x677bf4b962464e6dfd548d6a30b6c703dd78c7cc3602825a7013a6e90a001d2a"}], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getLogs","params":[{"blockhash":"0x677bf4b962464e6dfd548d6a30b6c703dd78c7cc3602825a7013a6e90a001d2a"}], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : [ { + "logIndex" : "0x0", + "removed" : false, + "blockNumber" : "0x14427", + "blockHash" : "0x677bf4b962464e6dfd548d6a30b6c703dd78c7cc3602825a7013a6e90a001d2a", + "transactionHash" : "0x7bf9876a9de3c0add38495e21a17b96c81b3f18e0990a4a3aecdf9f47fea0eed", + "transactionIndex" : "0x0", + "address" : "0xe8fe77d1576d0972d453b49bfaa84d716173d133", + "data" : "0x0000000000000000000000001046c9bdec0e634fbd7cf91afebd93cc854432b10000000000000000000000002101416eeaf73acb66d124f79efde9631662a83a0000000000000000000000006f72045702a34c473da863945221965c61528bd3", + "topics" : [ "0xc36800ebd6079fdafc3a7100d0d1172815751804a6d1b7eb365b85f6c9c80e61", "0x000000000000000000000000b344324aa2a82a6fda8459e40923e1fd65bfac36" ] + } ] + } + ``` + +### eth_getWork + +Returns the hash of the current block, the seed hash, and the target boundary condition to be met. + +**Parameters** + +None + +**Returns** + +`result` : `Array of DATA` with the following fields: + +* DATA, 32 Bytes - Hash of the current block header (pow-hash). +* DATA, 32 Bytes - The seed hash used for the DAG. +* DATA, 32 Bytes - The target boundary condition to be met; 2^256 / difficulty. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getWork","params":[],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"eth_getWork","params":[],"id":1} + ``` + + ```json tab="JSON result" + { + "id":1, + "jsonrpc":"2.0", + "result": [ + "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", + "0x5EED00000000000000000000000000005EED0000000000000000000000000000", + "0xd1ff1c01710000000000000000000000d1ff1c01710000000000000000000000" + ] + } + ``` + + +## Clique Methods + +### clique_discard + +Discards a proposal to add or remove a signer with the specified address. + +**Parameters** + +`data` - 20-byte address of proposed signer. + +**Returns** + +`result: boolean` - `true` + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"clique_discard","params":["0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73"], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"clique_discard","params":["0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73"], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : true + } + ``` + +### clique_getSigners + +Lists signers for the specified block. + +**Parameters** + +`quantity|tag` - Integer representing a block number or one of the string tags `latest`, `earliest`, or `pending`, as described in [Block Parameter](Using-JSON-RPC-API.md#block-parameter). + +**Returns** + +`result: array of data` - List of 20-byte addresses of signers. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"clique_getSigners","params":["latest"], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"clique_getSigners","params":["latest"], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : [ "0x42eb768f2244c8811c63729a21a3569731535f06", "0x7ffc57839b00206d1ad20c69a1981b489f772031", "0xb279182d99e65703f0076e4812653aab85fca0f0" ] + } + ``` + +### clique_getSignersAtHash + +Lists signers for the specified block. + +**Parameters** + +`data` - 32-byte block hash. + +**Returns** + +`result: array of data` - List of 20-byte addresses of signers. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"clique_getSignersAtHash","params":["0x98b2ddb5106b03649d2d337d42154702796438b3c74fd25a5782940e84237a48"], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"clique_getSignersAtHash","params":["0x98b2ddb5106b03649d2d337d42154702796438b3c74fd25a5782940e84237a48"], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : [ "0x42eb768f2244c8811c63729a21a3569731535f06", "0x7ffc57839b00206d1ad20c69a1981b489f772031", "0xb279182d99e65703f0076e4812653aab85fca0f0" ] + } + ``` + +### clique_propose + +Proposes adding or removing a signer with the specified address. + +**Parameters** + +`data` - 20-byte address. + +`boolean` - `true` to propose adding signer or `false` to propose removing signer. + +**Returns** + +`result: boolean` - `true` + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"clique_propose","params":["0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73", true], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"clique_propose","params":["0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73", true], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : true + } + ``` + +### clique_proposals + +Returns current proposals. + +**Parameters** + +None + +**Returns** + +`result`:_object_ - Map of account addresses to corresponding boolean values indicating the proposal for each account. + +If the boolean value is `true`, the proposal is to add a signer. If `false`, the proposal is to remove a signer. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"clique_proposals","params":[], "id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"clique_proposals","params":[], "id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc": "2.0", + "id": 1, + "result": { + "0x42eb768f2244c8811c63729a21a3569731535f07": false, + "0x12eb759f2222d7711c63729a45c3585731521d01": true + } + } + ``` + +## Debug Methods + +### debug_metrics + +!!!note + This method is only available only from v0.8.3 or when [building from source](Installation). + +Returns metrics providing information on the internal operation of Pantheon. + +The available metrics may change over time. The JVM metrics may vary based on the JVM implementation being used. + +The metric types are: + +* Timer +* Counter +* Gauge + +**Parameters** + +None + +**Returns** + +`result`:`object` + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"debug_metrics","params":[],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"debug_metrics","params":[],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc": "2.0", + "id": 1, + "result": { + "jvm": { + "memory_bytes_init": { + "heap": 268435456, + "nonheap": 2555904 + }, + "threads_current": 41, + "memory_bytes_used": { + "heap": 696923976, + "nonheap": 63633456 + }, + "memory_pool_bytes_used": { + "PS Eden Space": 669119360, + "Code Cache": 19689024, + "Compressed Class Space": 4871144, + "PS Survivor Space": 2716320, + "PS Old Gen": 25088296, + "Metaspace": 39073288 + }, + ... + }, + "process": { + "open_fds": 546, + "cpu_seconds_total": 67.148992, + "start_time_seconds": 1543897699.589, + "max_fds": 10240 + }, + "rpc": { + "request_time": { + "debug_metrics": { + "bucket": { + "+Inf": 2, + "0.01": 1, + "0.075": 2, + "0.75": 2, + "0.005": 1, + "0.025": 2, + "0.1": 2, + "1.0": 2, + "0.05": 2, + "10.0": 2, + "0.25": 2, + "0.5": 2, + "5.0": 2, + "2.5": 2, + "7.5": 2 + }, + "count": 2, + "sum": 0.015925392 + } + } + }, + "blockchain": { + "difficulty_total": 3533501, + "announcedBlock_ingest": { + "bucket": { + "+Inf": 0, + "0.01": 0, + "0.075": 0, + "0.75": 0, + "0.005": 0, + "0.025": 0, + "0.1": 0, + "1.0": 0, + "0.05": 0, + "10.0": 0, + "0.25": 0, + "0.5": 0, + "5.0": 0, + "2.5": 0, + "7.5": 0 + }, + "count": 0, + "sum": 0 + }, + "height": 1908793 + }, + "peers": { + "disconnected_total": { + "remote": { + "SUBPROTOCOL_TRIGGERED": 5 + }, + "local": { + "TCP_SUBSYSTEM_ERROR": 1, + "SUBPROTOCOL_TRIGGERED": 2, + "USELESS_PEER": 3 + } + }, + "peer_count_current": 2, + "connected_total": 10 + } + } + } + ``` + +### debug_traceTransaction + +[Remix](https://remix.ethereum.org/) uses `debug_traceTransaction` to implement debugging. Use the _Debugger_ tab in Remix rather than calling `debug_traceTransaction` directly. + +Reruns the transaction with the same state as when the transaction was executed. + +**Parameters** + +`transactionHash` : `data` - Transaction hash. + +`Object` - request options (all optional and default to `false`): +* `disableStorage` : `boolean` - `true` disables storage capture. +* `disableMemory` : `boolean` - `true` disables memory capture. +* `disableStack` : `boolean` - `true` disables stack capture. + +**Returns** + +`result`:`object` - [Trace object](JSON-RPC-API-Objects.md#trace-object). + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"debug_traceTransaction","params":["0x2cc6c94c21685b7e0f8ddabf277a5ccf98db157c62619cde8baea696a74ed18e",{"disableStorage":true}],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"debug_traceTransaction","params":["0x2cc6c94c21685b7e0f8ddabf277a5ccf98db157c62619cde8baea696a74ed18e",{"disableStorage":true}],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc" : "2.0", + "id" : 1, + "result" : { + "gas" : 21000, + "failed" : false, + "returnValue" : "", + "structLogs" : [ { + "pc" : 0, + "op" : "STOP", + "gas" : 0, + "gasCost" : 0, + "depth" : 1, + "stack" : [ ], + "memory" : [ ], + "storage" : null + } ] + } + } + ``` + +## Miner Methods + +### miner_start + +Starts the CPU mining process. To start mining, a miner coinbase must have been previously specified using the [`--miner-coinbase`](../Reference/Pantheon-CLI-Syntax.md#miner-coinbase) command line option. + +**Parameters** + +None + +**Returns** + +`result` : `boolean` - `true` if the mining start request was received successfully; otherwise returns an error. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"miner_start","params":[],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"miner_start","params":[],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc": "2.0", + "id": 1, + "result": true + } + ``` + +### miner_stop + +Stops the CPU mining process on the client. + +**Parameters** + +None + +**Returns** + +`result` : `boolean` - `true` if the mining stop request was received successfully; otherwise returns an error. + +!!! example + ```bash tab="curl HTTP request" + $ curl -X POST --data '{"jsonrpc":"2.0","method":"miner_stop","params":[],"id":1}' + ``` + + ```bash tab="wscat WS request" + {"jsonrpc":"2.0","method":"miner_stop","params":[],"id":1} + ``` + + ```json tab="JSON result" + { + "jsonrpc": "2.0", + "id": 1, + "result": true + } + ``` + +## ibft Methods + +:construction: IBFT is not currently supported. Support for IBFT is in active development. \ No newline at end of file diff --git a/docs/Reference/JSON-RPC-API-Objects.md b/docs/Reference/JSON-RPC-API-Objects.md new file mode 100644 index 0000000000..c6df636adc --- /dev/null +++ b/docs/Reference/JSON-RPC-API-Objects.md @@ -0,0 +1,158 @@ +description: Pantheon JSON-RPC API objects reference + + +# JSON-RPC API Objects + +The following objects are parameters for or returned by JSON-RPC Methods. + +## Block Object + +Returned by [eth_getBlockByHash](JSON-RPC-API-Methods.md#eth_getblockbyhash) and [eth_getBlockByNumber](JSON-RPC-API-Methods.md#eth_getblockbynumber). + +| Key | Type | Value | +|----------------------|:---------------------:|----------------------------------------------------------------------------------------------------------------------------------| +| **number** | *Quantity*, Integer | Block number. `null` when block is pending. | +| **hash** | *Data*, 32 bytes | Hash of the block. `null` when block is pending. | +| **parentHash** | *Data*, 32 bytes | Hash of the parent block. | +| **nonce** | *Data*, 8 bytes | Hash of the generated proof of work. `null` when block is pending. | +| **sha3Uncles** | *Data*, 32 bytes | SHA3 of the uncle's data in the block. | +| **logsBloom** | *Data*, 256 bytes | Bloom filter for the block logs. `null` when block is pending. | +| **transactionsRoot** | *Data*, 32 bytes | Root of the transaction trie for the block. | +| **stateRoot** | Data, 32 bytes | Root of the final state trie for the block. | +| **receiptsRoot** | Data, 32 bytes | Root of the receipts trie for the block. | +| **miner** | Data, 20 bytes | Address to which mining rewards were paid. | +| **difficulty** | Quantity, Integer | Difficulty for this block. | +| **totalDifficulty** | Quantity, Integer | Total difficulty of the chain until this block. | +| **extraData** | Data | Extra data field of this block. | +| **size** | Quantity, Integer | Size of block in bytes. | +| **gasLimit** | Quantity | Maximum gas allowed in this block. | +| **gasUsed** | Quantity | Total gas used by all transactions in this block. | +| **timestamp** | Quantity | Unix timestamp when block was collated. | +| **transactions** | Array | Array of [transaction objects](#transaction-object), or 32 byte transaction hashes depending on the specified boolean parameter. | +| **uncles** | Array | Array of uncle hashes. | + + +## Filter Options Object + +Parameter for [eth_newFilter](JSON-RPC-API-Methods.md#eth_newfilter) and [eth_getLogs](JSON-RPC-API-Methods.md#eth_getlogs). + +| Key | Type | Required/Optional | Value | +|---------------|:---------------------------------:|:-----------------:|---------------------------------------------------------------------------------------------------------------------------------------------| +| **fromBlock** | Quantity | Tag | Optional | Integer block number or `latest`, `pending`, `earliest`. See [Block Parameter](Using-JSON-RPC-API.md#block-parameter). Default is `latest`. | +| **toBlock** | Quantity | Tag | Optional | Integer block number or `latest`, `pending`, `earliest`. See [Block Parameter](Using-JSON-RPC-API.md#block-parameter). Default is `latest`. | +| **address** | Data | Array | Optional | Contract address or array of addresses from which logs originate. | +| **topics** | Array of Data, 32 bytes each | Optional | Array of 32-byte topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options. | + +[eth_getLogs](JSON-RPC-API-Methods.md#eth_getlogs) has an additional key. + +| Key | Type | Required/Optional | Value | +|------------|:-----------------:|:-----------------:|------| +| **blockhash** |Data, 32 bytes | Optional | Hash of block for which to return logs. If `blockhash` is specified, `fromBlock` and `toBlock` cannot be specified. | + +## Log Object + +Returned by [eth_getFilterChanges](JSON-RPC-API-Methods.md#eth_getfilterchanges) and [transaction receipt objects](#transaction-receipt-object) can contain an array of log objects. + +| Key | Type | Value | +|----------------------|-:- :------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **removed** | Tag | `true` when log removed due to chain reorganization. `false` if valid log. | +| **logIndex** | Quantity, Integer | Log index position in the block. `null` when log is pending. | +| **transactionIndex** | Quantity, Integer | Index position of transaction from which log was created. `null` when log is pending. | +| **transactionHash** | Data, 32 bytes | Hash of transaction from which log was created. `null` when log is pending. | +| **blockHash** | Data, 32 bytes | Hash of block in which log included. `null` when log is pending. | +| **blockNumber** | Quantity | Number of block in which log included. `null` when log is pending. | +| **address** | Data, 20 bytes | Address from which log originated. | +| **data** | Data | Non-indexed arguments of log. | +| **topics** | Array of Data, 32 bytes each | 0 to 4 indexed log arguments. In Solidity, the first topic is the hash of the signature of the event (for example, `Deposit(address, bytes32, unit256)`) except you declare the event with an anonymous specifier.) | + +## Trace Object + +Returned by [debug_traceTransaction](JSON-RPC-API-Methods.md#debug_traceTransaction). + +| Key | Type | Value | +|-----------------|:-------:|-------------------------------------------------------------------| +| **gas** | Integer | Gas used by the transaction | +| **failed** | Boolean | True if transaction failed; otherwise, false | +| **returnValue** | String | Bytes returned from transaction execution (without a `0x` prefix) | +| **structLogs** | Array | Array of structured log objects | + + +### Structured Log Object + +Part of the [Trace object](#trace-object). + +| Key | Type | Value | +|----------------------------|:----------------------------:|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **pc** | Integer | Current program counter | +| **op** | String | Current OpCode | +| **gas** | Integer | Gas remaining | +| **gasCost** | Integer | Cost in wei of each gas unit | +| **depth** | Integer | Execution depth | +| **exceptionalHaltReasons** | Array | One or more strings representing an error condition that caused the EVM execution to terminate. These indicate that EVM execution terminated for reasons such as running out of gas or attempting to execute an unknown instruction. Generally a single exceptional halt reason is returned but it is possible for more than one to occur at once. | +| **stack** | Array of 32 byte arrays | EVM execution stack before executing current operation | +| **memory** | Array of 32 byte arrays | Memory space of the contract before executing current operation | +| **storage** | Object | Storage entries changed by the current transaction | + + +## Transaction Object + +Returned by [eth_getTransactionByHash](JSON-RPC-API-Methods.md#eth_gettransactionbyhash), [eth_getTransactionByBlockHashAndIndex](JSON-RPC-API-Methods.md#eth_gettransactionbyblockhashandindex), and [eth_getTransactionsByBlockNumberAndIndex](JSON-RPC-API-Methods.md#eth_gettransactionbyblocknumberandindex). + +| Key | Type | Value | +|----------------------|:-------------------:|----------------------------------------------------------------------------------------| +| **blockHash** | Data, 32 bytes | Hash of block containing this transaction. `null` when transaction is pending. | +| **blockNumber** | Quantity | Block number of block containing this transaction. `null` when transaction is pending. | +| **from** | Data, 20 bytes | Address of the sender. | +| **gas** | Quantity | Gas provided by the sender. | +| **gasPrice** | Quantity | Gas price provided by the sender in Wei. | +| **hash** | Data, 32 bytes | Hash of the transaction. | +| **input** | Data | Data sent with the transaction. | +| **nonce** | Quantity | Number of transactions made by the sender before this one. | +| **to** | Data, 20 bytes | Address of the receiver. `null` if a contract creation transaction. | +| **transactionIndex** | Quantity, Integer | Index position of transaction in the block. `null` when transaction is pending. | +| **value** | Quantity | Value transferred in Wei. | +| **v** | Quantity | ECDSA Recovery ID | +| **r** | Data, 32 bytes | ECDSA signature r | +| **s** | Data, 32 bytes | ECDSA signature s | + +## Transaction Call Object + +Parameter for [eth_call](JSON-RPC-API-Methods.md#eth_call) and [eth_estimateGas](JSON-RPC-API-Methods.md#eth_estimategas). + +!!!note + All parameters are optional for [eth_estimateGas](JSON-RPC-API-Methods.md#eth_estimategas) + +| Key | Type | Required/Optional | Value | +|--------------|:-------------------:|:-----------------:|--------------------------------------------------------------------------------------------------------------------------------| +| **from** | Data, 20 bytes | Optional | Address from which transaction sent. | +| **to** | Data, 20 bytes | Required | Address to which transaction is directed. | +| **gas** | Quantity, Integer | Optional | Gas provided for the transaction execution. `eth_call` consumes zero gas, but this parameter may be needed by some executions. | +| **gasPrice** | Quantity, Integer | Optional | gasPrice used for each paid gas. | +| **value** | Quantity, Integer | Optional | Value sent with this transaction. | +| **data** | Data | Optional | Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI. | + +## Transaction Receipt Object + +Returned by [eth_getTransactionReceipt](JSON-RPC-API-Methods.md#eth_gettransactionreceipt). + +| Key | Type | Value | +|-----------------------|:--------------------:|--------------------------------------------------------------------------------------| +| **blockHash** | Data, 32 bytes | Hash of block containing this transaction. | +| **blockNumber** | Quantity | Block number of block containing this transaction. | +| **contractAddress** | Data, 20 bytes | Contract address created, if contract creation transaction; otherwise, `null`. | +| **cumulativeGasUsed** | Quantity | Total amount of gas used by previous transactions in the block and this transaction. | +| **from** | Data, 20 bytes | Address of the sender. | +| **gasUsed** | Quantity | Amount of gas used by this specific transaction. | +| **logs** | Array | Array of [log objects](#log-object) generated by this transaction. | +| **logsBloom** | Data, 256 bytes | Bloom filter for light clients to quickly retrieve related logs. | +| **status** | Quantity | Either `1` (success) or `0` (failure) | +| **to** | Data, 20 bytes | Address of the receiver, if sending ether; otherwise, null. | +| **transactionHash** | Data, 32 bytes | Hash of the transaction. | +| **transactionIndex** | Quantity, Integer | Index position of transaction in the block. | + +!!!note + For pre-Byzantium transactions, the transaction receipt object includes the following instead of `status`: + +| Key | Type | Value | +|-------|:-----------------:|---------| +| **root** | Data, 32 bytes| Post-transaction stateroot| \ No newline at end of file diff --git a/docs/Reference/JSON-RPC-API.md b/docs/Reference/JSON-RPC-API.md new file mode 100644 index 0000000000..0a03a998e9 --- /dev/null +++ b/docs/Reference/JSON-RPC-API.md @@ -0,0 +1,12 @@ +description: Pantheon JSON-RPC API reference + + +# JSON-RPC API overview + +The Pantheon JSON-RPC API uses the [JSON](http://json.org/) (RFC 4627) data format, which can represent objects and data fields as collections of name/value pairs, in a relatively readable, hierarchical form. Values have specific data types such as QUANTITIES (decimal integers, hexadecimal numbers, strings) and UNFORMATTED DATA (byte arrays, account addresses, hashes, and bytecode arrays). + +RPC is the remote procedure call protocol (RFC 1831), which is stateless and transport agnostic in that the concepts can be used within the same process, over sockets, over HTTP, or in many various message passing environments. + +* [Using the Pantheon JSON-RPC API](Using-JSON-RPC-API.md) +* [JSON-RPC API Methods](JSON-RPC-API-Methods.md) +* [JSON-RPC API Objects](JSON-RPC-API-Objects.md) \ No newline at end of file diff --git a/docs/Reference/Pantheon-CLI-Syntax.md b/docs/Reference/Pantheon-CLI-Syntax.md new file mode 100644 index 0000000000..615720686a --- /dev/null +++ b/docs/Reference/Pantheon-CLI-Syntax.md @@ -0,0 +1,538 @@ +description: Pantheon commande line interface reference + + +# Pantheon Command Line + +This reference describes the syntax of the Pantheon Command Line Interface (CLI) options and subcommands. + +```bash +pantheon [OPTIONS] [COMMAND] +``` + +Runs the Pantheon Ethereum full node client. + +## Options + +### banned-nodeids + +```bash tab="Syntax" +--banned-nodeids=[,...]... +``` + +```bash tab="Example" +--banned-nodeids=enode://c35c3...d615f@1.2.3.4:30303,enode://f42c13...fc456@1.2.3.5:30303 +``` + +List of node IDs with which this node will not peer. The node ID is the public key of the node. You can specify the banned node IDs with or without the `0x` prefix. + +!!!info + This option is only available from v0.8.2 or when [building from source](../Installation/Build-From-Source.md). + +### bootnodes + +```bash tab="Syntax" +--bootnodes=[,...]... +``` + +```bash tab="Example" +--bootnodes=enode://c35c3...d615f@1.2.3.4:30303,enode://f42c13...fc456@1.2.3.5:30303 +``` + +List of comma-separated enode URLs for P2P discovery bootstrap. + +When connecting to mainnet and Rinkeby, the default is a predefined list of enode URLs. +Specify bootnodes when [connecting to Ropsten](../Getting-Started/Starting-Pantheon.md#run-a-node-on-ropsten-testnet) or +a [private network](../Configuring-Pantheon/Testing-Developing-Nodes.md#bootnodes). + +### config + +```bash tab="Syntax" +--config= +``` + +```bash tab="Example" +--config=/home/me/me_node/config.toml +``` + +The path to the TOML configuration file. +The default is `none`. +The TOML file is composed of key/value pairs. +Each key is the same as the corresponding CLI option name without the leading dashes (`--`). +The config option is not used in the config file. +Values must be treated according to TOML specifications for string, numbers, arrays and Booleans. + +!!!example "Example TOML configuration file" + ```toml + # Valid TOML config file + datadir="~/pantheondata" # Path + + # Network + bootnodes=["enode://001@123:4567", "enode://002@123:4567", "enode://003@123:4567"] + p2p-listen="1.2.3.4:1234" # IP:port + max-peers=42 + rpc-listen="5.6.7.8:5678" # IP:port + ws-listen="9.10.11.12:9101" # IP:port + + # Chain + genesis="~/genesis.json" # Path to the custom genesis file + + # Mining + miner-enabled=true + miner-coinbase="0x0000000000000000000000000000000000000002" + ``` + +!!!note + This option is not used when running Pantheon from the [Docker image](../Getting-Started/Run-Docker-Image.md#custom-configuration-file). + +### datadir + +```bash tab="Syntax" +--datadir= +``` + +```bash tab="Example" +--datadir=/home/me/me_node +``` + +The path to the Pantheon data directory. The default location is the `/build/distributions/pantheon-` directory in the Pantheon installation directory. + +!!!note + This option is not used when running Pantheon from the [Docker image](../Getting-Started/Run-Docker-Image.md#persisting-data). + + +### dev-mode + +```bash tab="Syntax" +--dev-mode +``` + +Set this option to `true` to run in development mode. +For example, specify this option to perform CPU mining more easily in a private test network. +In development mode, a custom genesis configuration specifies the chain ID. +When using this option, also set the [`--network-id`](#network-id) option to the network you use for development. +Default is `false`. + + +!!!note + The [`--dev-mode`](#dev-mode) option overrides the [`--genesis`](#genesis) option. If both are specified, the development mode configuration is used. + + +### genesis + +```bash tab="Syntax" +--genesis= +``` + +```bash tab="Example" +--genesis=/home/me/me_node/genesis_calling_all_stations.json +``` + +The path to the genesis file. The default is the embedded genesis file for the Ethereum mainnet. +When using this option, it is recommended to also set the [`--network-id`](#network-id) option. + +!!!note + This option is not used when running Pantheon from the [Docker image](../Getting-Started/Run-Docker-Image.md#custom-genesis-file). + +!!!note + The [`--genesis`](#genesis) option is overridden by the [`--dev-mode`](#dev-mode) option. + If both are specified, the specified genesis file is ignored and the development mode configuration used. + + +### host-whitelist + +```bash tab="Syntax" +--host-whitelist=[,...]... +``` + +```bash tab="Example" +--host-whitelist=medomain.com,meotherdomain.com +``` + +Comma-separated list of hostnames to allow access to the HTTP JSON-RPC API. Default is `localhost`. + +!!!tip + To allow all hostnames, use `*` or `all`. We don't recommend this for production code. + +!!!note + This option is only available from v0.8.3 or when [building from source](../Installation/Build-From-Source.md). + Earlier versions allow access by all hostnames. + +### max-peers + +```bash tab="Syntax" +--max-peers= +``` + +```bash tab="Example" +--max-peers=42 +``` + +Specifies the maximum P2P peer connections that can be established. +The default is 25. + +### max-trailing-peers + +```bash tab="Syntax" +--max-trailing-peers= +``` + +```bash tab="Example" +--max-trailing-peers=2 +``` + +Specifies the maximum P2P peer connections for peers that are trailing behind the local chain head. +The default is unlimited but the number of trailing peers cannot exceed the value specified by [`--max-peers`](#max-peers). + +### miner-coinbase + +```bash tab="Syntax" +--miner-coinbase= +``` + +```bash tab="Example" +--miner-coinbase=fe3b557e8fb62b89f4916b721be55ceb828dbd73 +``` + +Account to which mining rewards are paid. +You must specify a valid coinbase when you enable mining using the [`--miner-enabled`](#miner-enabled) +option or the [`miner_start`](JSON-RPC-API-Methods.md#miner_start) JSON RPC-API method. + +!!!note + This option is ignored in networks using the [Clique Proof-of-Authority (PoA) consensus protocol](../Configuring-Pantheon/Proof-of-Authority.md). + +### miner-enabled + +```bash tab="Syntax" +--miner-enabled +``` + +Enables mining when the node is starts. +Default is `false`. + +### miner-extraData + +```bash tab="Syntax" +--miner-extraData= +``` + +```bash tab="Example" +--miner-extraData=0x444F4E27542050414E4943202120484F444C2C20484F444C2C20484F444C2021 +``` + +A hex string representing the 32 bytes to be included in the extra data field of a mined block. +The default is 0x. + +### miner-minTransactionGasPriceWei + +```bash tab="Syntax" +--miner-minTransactionGasPriceWei= +``` + +```bash tab="Example" +--miner-minTransactionGasPriceWei=1337 +``` + +The minimum price that a transaction offers for it to be included in a mined block. +The default is 1000. + +### network-id + +```bash tab="Syntax" +--network-id= +``` + +```bash tab="Example" +--network-id=8675309 +``` + +P2P network identifier. +The default is set to mainnet with value `1`. + +### no-discovery + +```bash tab="Syntax" +--no-discovery +``` + +Disables P2P peer discovery. +The default is `false`. + +### node-private-key + +```bash tab="Syntax" +--node-private-key= +``` + +```bash tab="Example" +--node-private-key=/home/me/me_node/my_precious +``` + +`` is the path of the private key file of the node. +The default is the key file in the data directory. +If no key file exists, a key file containing the generated private key is created; +otherwise, the existing key file specifies the node private key. + + +!!!attention + The private key is not encrypted. + +!!!note + This option is only available from v0.8.2 or when [building from source](../Installation/Build-From-Source.md). + +### nodes-whitelist + +```bash tab="Syntax" +--nodes-whitelist=[=[,...]...] +``` + +```bash tab="Example" +--nodes-whitelist=enode://c35c3...d615f@3.14.15.92:30303,enode://f42c13...fc456@65.35.89.79:30303 +``` + +Comma-separated enode URLs for permissioned networks. +If you specify an empty list or [`--nodes-whitelist`](#nodes-whitelist) without a list, your node will not connect to any other nodes. + + +!!!note + This option is only available from v0.8.3 or when [building from source](../Installation/Build-From-Source.md). + +!!!note + :construction: Permissioning is not currently supported. Support for permissioning is in active development. + +### ottoman + +```bash tab="Syntax" +--ottoman +``` + +Synchronize against the Ottoman test network. This is only useful if you are using an IBFT genesis file. The default is `false`. + +!!!note + :construction: IBFT is not currently supported. Support for IBFT is in active development. + +### p2p-listen + +```bash tab="Syntax" +--p2p-listen= +``` + +```bash tab="Example" +# to listen on all interfaces on port 1789 +--p2p-listen=0.0.0.0:1789 +``` + +Specifies the host and port on which P2P peer discovery listens. +The default is 127.0.0.1:30303. + +!!!note + This option is not used when running Pantheon from the [Docker image](../Getting-Started/Run-Docker-Image.md#exposing-ports). + +### rinkeby + +```bash tab="Syntax" +--rinkeby +``` + +Uses the Rinkeby test network. +Default is `false`. + + +### ropsten + +```bash tab="Syntax" +--ropsten +``` + +Uses the Ropsten test network. +Default is `false`. + +!!!note + This option is only available only from v0.8.2 or when [building from source](../Installation/Build-From-Source.md). + For v0.8.1, refer to [Ropsten section on Starting Pantheon page](../Getting-Started/Starting-Pantheon.md#run-a-node-on-ropsten-testnet). + +### rpc-enabled + +```bash tab="Syntax" +--rpc-enabled +``` + +Set to `true` to enable the JSON-RPC service (RPC over HTTP). +The default is `false`. + +### rpc-listen + +```bash tab="Syntax" +--rpc-listen= +``` + +```bash tab="Example" +# to listen on all interfaces on port 3435 +--rpc-listen=0.0.0.0:3435. +``` + +Specifies the host and port on which JSON-RPC listens. +The default is 127.0.0.1:8545. + +!!!note + This option is not used when running Pantheon from the [Docker image](../Getting-Started/Run-Docker-Image.md#exposing-ports). + +### rpc-api + +```bash tab="Syntax" +--rpc-api=[,...]... +``` + +```bash tab="Example" +--rpc-api=ETH,NET,WEB3 +``` + +Comma-separated APIs to enable on the JSON-RPC channel. +When you use this option, the `--rpc-enabled` option must also be specified. +The available API options are: `ETH`, `NET`, `WEB3`, `CLIQUE`, `IBFT`, `DEBUG`, and `MINER`. +The default is: `ETH`, `NET`, `WEB3`, `CLIQUE`, `IBFT`. + +!!!note + :construction: IBFT is not currently supported. Support for IBFT is in active development. + +### rpc-cors-origins + +```bash tab="Syntax" +--rpc-cors-origins= +``` + +```bash tab="Single domain xample" +# You can whitelist one single domains. + +--rpc-cors-origins="http://medomain.com" +``` + +```bash tab="Multiple domains example" +# You can whitelist one or more domains with a comma-separated list. + +--rpc-cors-origins="http://medomain.com","https://meotherdomain.com" +``` + +```bash tab="Remix IDE domain example" +# The following allows Remix to interact with your Pantheon node without using MetaMask. + +--rpc-cors-origins "http://remix.ethereum.org" +``` + +Specifies domain URLs for CORS validation. +Domain URLs must be enclosed in double quotes and comma-separated. + +Listed domains will be allowed access to node data (whitelisted). +If your client interacts with Pantheon using a browser app (such as Remix using a direct connection or a block explorer), +you must whitelist the client domains. + +The default value is `"none"`. +If you don't whitelist any domains, you won't be able to use webapps to interact with your Pantheon node. + +!!!note + MetaMask runs as native code so does not require CORS validation. + If Remix is connecting to the node through MetaMask, it also does not require CORS validation. + +!!!tip + For development purposes, you can use `"all"` to accept requests from any domain, but we don't recommend this for production code. + +### ws-enabled + +```bash tab="Syntax" +--ws-enabled +``` + +Set to `true` to enable the WS-RPC (WebSockets) service. +The default is `false`. + +### ws-api + +```bash tab="Syntax" +--ws-api=[,...]... +``` + +```bash tab="Example" +--ws-api=ETH,NET,WEB3 +``` + +Comma-separated APIs to enable on Websockets channel. +When you use this option, the `--ws-enabled` option must also be specified. +The available API options are: `ETH`, `NET`, `WEB3`, `CLIQUE`, `IBFT`, `DEBUG`, and `MINER`. +The default is: `ETH`, `NET`, `WEB3`, `CLIQUE`, `IBFT`. + +!!!note + :construction: IBFT is not currently supported. Support for IBFT is in active development. + +### ws-listen + +```bash tab="Syntax" +--ws-listen= +``` + +```bash tab="Example" +# to listen on all interfaces on port 6174 +--ws-listen=0.0.0.0:6174 +``` + +Host and port for WS-RPC (Websocket) to listen on. +The default is 127.0.0.1:8546. + +!!!note + This option is not used when running Pantheon from the [Docker image](../Getting-Started/Run-Docker-Image.md#exposing-ports). + +### help + +```bash tab="Syntax" +-h, --help +``` + +Show the help message and exit. + +### logging + +```bash tab="Syntax" +-l, --logging= +``` + +```bash tab="Example" +--logging=DEBUG +``` + +Sets the logging verbosity. +Log levels are `OFF`, `FATAL`, `WARN`, `INFO`, `DEBUG`, `TRACE`, `ALL`. +Default is `INFO`. + +### version + +```bash tab="Syntax" + -V, --version +``` + +Print version information and exit. + +## Commands + +Pantheon subcommands are: + +### import + +```bash tab="Syntax" +$ pantheon import +``` + +```bash tab="Example" +$ pantheon import /home/me/me_project/mainnet.blocks +``` + +Imports blocks from the specified file into the blockchain database + +### export-pub-key + +```bash tab="Syntax" +$ pantheon export-pub-key +``` + +```bash tab="Example" +$ pantheon export-pub-key /home/me/me_project/not_precious_pub_key +``` + +Exports node public key to the specified file. \ No newline at end of file diff --git a/docs/Reference/Using-JSON-RPC-API.md b/docs/Reference/Using-JSON-RPC-API.md new file mode 100644 index 0000000000..9eaeb4bc5f --- /dev/null +++ b/docs/Reference/Using-JSON-RPC-API.md @@ -0,0 +1,98 @@ +description: How to use Pantheon JSON-RPC API + + +# Using the JSON-RPC API + +!!!attention "Breaking Change in v0.8.3" + + From v0.8.3, incoming HTTP requests are only accepted from hostnames specified using the [`--host-whitelist`](Pantheon-CLI-Syntax.md#host-whitelist) option. + If not specified, the default value for [`--host-whitelist`](Pantheon-CLI-Syntax.md#host-whitelist) is `localhost`. + + If using the URL `http://127.0.0.1` to make JSON-RPC calls, use [`--host-whitelist`](Pantheon-CLI-Syntax.md#host-whitelist) to specify the hostname `127.0.0.1` or update the hostname to `localhost`. + + If your application publishes RPC ports, specify the hostnames when starting Pantheon. For example: + ```bash + pantheon --host-whitelist=foo.com + ``` + + Specify `*` or `all` for [`--host-whitelist`](Pantheon-CLI-Syntax.md#host-whitelist) to effectively disable host protection and replicate pre-v0.8.3 behavior. + + **This is not recommended for production code.** + +## Using the Pantheon JSON-RPC API + +### Postman + +Use the button to import our collection of examples to [Postman](https://www.getpostman.com/). + +[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/cffe1bc034b3ab139fa7) + +### Endpoint Address and Port + +In this reference, the placeholder +`` and `` means an endpoint (IP address and port) +of the JSON-RPC service of a Pantheon node respectively for http endpoint and for WebSocket endpoint. + +To activate JSON-RPC using http or WebSocket, see [`--rpc-listen`](../Reference/Pantheon-CLI-Syntax.md#rpc-listen) +and [`--ws-listen`](../Reference/Pantheon-CLI-Syntax.md#ws-listen) options in the CLI documentation. + +The transport attributes are: + +* HTTP: Listens by default on port 8545 +* WebSockets: Listens by default on port 8546 + +### HTTP and WebSocket Requests + +#### HTTP + +To make RPC over HTTP requests, you can use the `curl` tool, available in many systems using [curl source code or pre-compiled packages](https://curl.haxx.se/download.html). + +```bash +$ curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":53}' +``` + +#### WebSockets + +To make requests over WebSockets, this reference uses [wscat](https://github.com/websockets/wscat), a Node.js based command-line tool. + +First connect to the WebSockets server using `wscat` (you only need to connect once per session): + +```bash +$ wscat -c ws:// +``` + +After the connection is established, the terminal will display a '>' prompt. +Send individual requests as a JSON data package at each prompt: + +```bash +> {"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":53} +``` + +The [RPC Pub/Sub methods](../Using-Pantheon/RPC-PubSub.md) can also be used over WebSockets. + +### Block Parameter + +When you make requests that might have different results depending on the block accessed, +the block parameter specifies the block. +Several methods, such as [eth_getTransactionByBlockNumberAndIndex](JSON-RPC-API-Methods.md#eth_gettransactionbyblocknumberandindex), have a block parameter. + +The block parameter can have the following values: + +* `blockNumber` : `quantity` - Block number. Can be specified in hexadecimal or decimal. 0 represents the genesis block. +* `earliest` : `tag` - Earliest (genesis) block. +* `latest` : `tag` - Last block mined. +* `pending` : `tag` - Last block mined plus pending transactions. Use only with [eth_getTransactionCount](JSON-RPC-API-Methods.md#eth_gettransactioncount). + +## Not Supported by Pantheon + +### Account Management + +Account management relies on private key management in the client which is not implemented by Pantheon. + +Use [`eth_sendRawTransaction`](JSON-RPC-API-Methods.md#eth_sendrawtransaction) to send signed transactions; `eth_sendTransaction` is not implemented. + +Use third-party wallets for [account management](../Using-Pantheon/Account-Management.md). + +### Protocols + +Pantheon does not implement the Whisper and Swarm protocols. \ No newline at end of file diff --git a/docs/Using-Pantheon/Account-Management.md b/docs/Using-Pantheon/Account-Management.md new file mode 100644 index 0000000000..5b695115c6 --- /dev/null +++ b/docs/Using-Pantheon/Account-Management.md @@ -0,0 +1,11 @@ +description: Using third party wallets for account management + + +# Using Wallets for Account Management + +Pantheon does not implement private key management. Use third-party tools (for example, [MetaMask](https://consensys.zendesk.com/hc/en-us/articles/360004685212-Generating-MetaMask-Wallet-New-UI-) and [web3j](https://web3j.io/)) for creating accounts. + +In Pantheon, you can use the JSON-RPC methods: + + * [eth_getBalance](../Reference/JSON-RPC-API-Methods.md#eth_getbalance) to obtain the account balance + * [eth_sendRawTransaction](../Reference/JSON-RPC-API-Methods.md#eth_sendrawtransaction) to transfer ether or create and interact with contracts (for more information, refer to [Transactions](Transactions.md#transactions)). \ No newline at end of file diff --git a/docs/Using-Pantheon/Debugging.md b/docs/Using-Pantheon/Debugging.md new file mode 100644 index 0000000000..315d337ac4 --- /dev/null +++ b/docs/Using-Pantheon/Debugging.md @@ -0,0 +1,12 @@ +description: Frequently asked questions FAQ and answers for troubleshooting Pantheon use + + +# Debugging Pantheon + +## My command line options are not working as I expected? + +Ensure quotes have not been automatically converted to smart quotes or hyphens combined if copying and pasting. + +## How can I monitor node performance and connectivity? + +Using the [`debug_metrics`](JSON-RPC-API-Methods#debug_metrics) JSON-RPC API method. \ No newline at end of file diff --git a/docs/Using-Pantheon/FilterExample.md b/docs/Using-Pantheon/FilterExample.md new file mode 100644 index 0000000000..503fa1da06 --- /dev/null +++ b/docs/Using-Pantheon/FilterExample.md @@ -0,0 +1 @@ +#TODO \ No newline at end of file diff --git a/docs/Using-Pantheon/Filters.md b/docs/Using-Pantheon/Filters.md new file mode 100644 index 0000000000..503fa1da06 --- /dev/null +++ b/docs/Using-Pantheon/Filters.md @@ -0,0 +1 @@ +#TODO \ No newline at end of file diff --git a/docs/Using-Pantheon/Mining.md b/docs/Using-Pantheon/Mining.md new file mode 100644 index 0000000000..2d5083b996 --- /dev/null +++ b/docs/Using-Pantheon/Mining.md @@ -0,0 +1,17 @@ +description: Using Pantheon for PoW CPU mining + + +# Mining + +Start Pantheon with the following options to enable CPU mining: +```bash +bin/pantheon --miner-enabled --miner-coinbase +``` + +Where `` is the account to which mining rewards are to be paid. For example, `fe3b557e8fb62b89f4916b721be55ceb828dbd73`. + +JSON-RPC API methods for mining are: + +* [`miner_start`](../Reference/JSON-RPC-API-Methods.md#miner_start) to start mining. +* [`miner_stop`](../Reference/JSON-RPC-API-Methods.md#miner_stop) to stop mining. +* [`eth_mining`](../Reference/JSON-RPC-API-Methods.md#eth_mining) to determine whether the client is actively mining new blocks. \ No newline at end of file diff --git a/docs/Using-Pantheon/RPC-PubSub.md b/docs/Using-Pantheon/RPC-PubSub.md new file mode 100644 index 0000000000..0df1a40aa7 --- /dev/null +++ b/docs/Using-Pantheon/RPC-PubSub.md @@ -0,0 +1,253 @@ +description: Using RPC Pub/Sub with Pantheon Web Socket API + + +# RPC Pub/Sub + +## Introduction + +Use the RPC Pub/Sub methods over [WebSockets](../Reference/Using-JSON-RPC-API.md#endpoint-address-and-port) +to wait for events instead of polling for them. For example, if a Dapp submits a transaction to the network, +you can use the RPC Pub/Sub interface to wait for the transaction confirmation followed by a specified +number of new blocks before confirming the transaction to the user. + +The RPC Pub/Sub methods are: + +* `eth_subscribe` - call to create a subscription for specific events. +* `eth_unsubscribe` - call to cancel a subscription. +* `eth_subscription` - invoked to publish event notifications to your client. + +!!!info + Notifications are published by `eth_subscription`; you do not need to call `eth_subscription`. + +!!!important + Unlike other [JSON RPC-API methods](../Reference/JSON-RPC-API-Methods.md), + the RPC Pub/Sub methods cannot be called over HTTP as well as WebSockets. + +### Subscription ID + +`eth_subscribe` returns a subscription ID for each subscription created. Notifications include the subscription ID. + + +!!!example + For example, to create a synchonizing subscription + + ```json + {"id": 1, "method": "eth_subscribe", "params": ["syncing"]} + ``` + The result includes the subscription ID of `"0x1"`: + ```json + {"jsonrpc":"2.0","id":1,"result":"0x1"} + ``` + The notifications also include the subscription ID of `"0x1"`: + ```json + {"jsonrpc":"2.0","method":"eth_subscription","params":{"subscription":"0x1","result":{"startingBlock":"0x0","currentBlock":"0x50","highestBlock":"0x343c19"}}} + ``` + +### Notifications when Synchronizing + +Subscribing to some events (for example, logs) can cause a flood of notifications while the node is synchronizing. + +Notifications are stored in an internal buffer to be sent to the client. +If the client falls behind and the number of buffered notifications reaches the limit of ==10,000==, the connection is closed. + +## Subscribing + +Use `eth_subscribe` to create subscriptions for the following event types: + +* [New headers](#new-headers) +* [Logs](#logs) +* [Pending transactions](#pending-transactions) +* [Sychronizng](#synchronizing) + +If the WebSockets connection is closed, all subscriptions are removed. + +### New Headers + +Use the `newHeads` parameter with `eth_subscribe` to be notified each time a new header is added to the blockchain. + +If a chain reorganization occurs, the subscription publishes notifications for headers in the new chain. +This means the subscription can publish notifications for multiple headers at the same height on the blockchain. + +The new headers notification returns [Block Objects](Objects#block-object). Use the `logsBloom` parameter +to filter blocks to determine which blocks have logs of interest to you. + +!!!example + To subscribe to new header notifications: + + ```json + {"id": 1, "method": "eth_subscribe", "params": ["newHeads"]} + ``` + + Example result: + ```json + {"jsonrpc":"2.0","id":2,"result":"0x1"} + ``` + + Example notification: + ```json + { + "jsonrpc": "2.0", + "method": "eth_subscription", + "params":{ + "subscription":"0x1", + "result": { + "number":"0x40c22", + "hash":"0x16af2ee1672203c7ac13ff280822008be0f38e1e5bdc675760015ae3192c0e3a", + "parentHash":"0x1fcf5dadfaf2ab4d985eb05d40eaa23605b0db25d736610c4b87173bfe438f91", + "nonce":"0x0000000000000000", + "sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "logsBloom":"0x00008000000000080000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000040000000000000000000000000000000000000000001000000000000000000000040000000000000000000000000000000000000400000000010000000000000000100000000000020000000000000000000000000000000000010000000000000000000000000000000000000000000", + "transactionsRoot":"0x5b2e3c1a49352f1ca9fb5dfe74b7ffbbb6d70e23a12693444e26058d8a8e6296", + "stateRoot":"0xbe8d3bc58bd982421a3ea8b66753404502df0f464ae78a17661d157c406dd38b", + "receiptsRoot":"0x81b175ec1f4d44fbbd6ba08f1bd3950663b307b7cb35751c067b535cc0b58f12", + "miner":"0x0000000000000000000000000000000000000000", + "difficulty":"0x1", + "totalDifficulty":"0x7c16e", + "extraData":"0xd783010600846765746887676f312e372e33856c696e757800000000000000002160f780bb1f61eda045c67cdb1297ba37d8349df8035533cb0cf82a7e45f23f3d72bbec125a9f499b3eb110b7d1918d466cb2ede90b38296cfe2aaf452c513f00", + "size":"0x3a1", + "gasLimit":"0x47e7c4", + "gasUsed":"0x11ac3a", + "timestamp":"0x592afc24", + "uncles":[], + "transactions":["0x419c69d21b14e2e8f911def22bb6d0156c876c0e1c61067de836713043364d6c","0x70a5b2cb2cee6e0b199232a1757fc2a9d6053a4691a7afef8508fd88aeeec703","0x4b3035f1d32339fe1a4f88147dc197a0fe5bbd63d3b9dec2dad96a3b46e4fddd"] + } + } + } + ``` + +#### Logs + +Use the `logs` parameter with `eth_subscribe` to be notified of logs included in new blocks. + +Logs subscriptions have an `object` parameter with the following fields: + + - `address` - (optional) Either an address or an array of addresses. Returns only logs created from these addresses. + - `topics` - (optional) Returns only logs that match the specified topics. + +If a chain reorganization occurs, the subscription publishes notifications for logs from the old chain +with the `removed` property in the [log object](../Reference/JSON-RPC-API-Objects.md#log-object) set to `true`. +This means the subscription can publish notifications for multiple logs for the same transaction. + +The logs subscription returns [Log objects](../Reference/JSON-RPC-API-Objects.md#log-object). + +!!!exemple + To subscribe to all logs notifications: + ```json + {"id": 1, "method": "eth_subscribe", "params": ["logs",{}]} + ``` + To subscribe to logs for a specific address and topic: + ```json + {"id": 1, "method": "eth_subscribe", "params": ["logs", {"address": "0x8320fe7702b96808f7bbc0d4a888ed1468216cfd", "topics": ["0xd78a0cb8bb633d06981248b816e7bd33c2a35a6089241d099fa519e361cab902"]}]} + ``` + + Example result: + ```json + {"jsonrpc":"2.0","id":1,"result":"0x2"} + ``` + Example notification: + ```json + { + "jsonrpc":"2.0", + "method":"eth_subscription", + "params":{ + "subscription":"0x2", + "result":{ + "logIndex":"0x0", + "removed":false, + "blockNumber":"0x2174", + "blockHash":"0x7bc83837534aa13df55ff7db77784b1d1ba666d4c4bdd223cae9fe09c7c37eba", + "transactionHash":"0x942179373e413824c6bc7045e92295aff91b679215446549b4aeb084da46495b", + "transactionIndex":"0x0", + "address":"0x9b8397f1b0fecd3a1a40cdd5e8221fa461898517", + "data":"0x", + "topics":["0x199cd93e851e4c78c437891155e2112093f8f15394aa89dab09e38d6ca072787","0x0000000000000000000000000000000000000000000000000000000000000005"] + } + } + } + ``` + +#### Pending Transactions + +Use the `newPendingTransactions` parameter with `eth_subscribe` to be notified of new pending transactions of which your node is aware. + +The pending transactions subscription returns the transaction hashes of the pending transactions. + +If a chain reorganization occurs, transactions are resubmitted to be included in the new canonical chain. +This means the subscription can publish notifications for the same pending transaction more than once. + +!!!example + To subscribe to pending transaction notifications: + + ```json + {"id": 1, "method": "eth_subscribe", "params": ["newPendingTransactions"]} + ``` + + Example result: + ```json + {"jsonrpc":"2.0","id":1,"result":"0x1"} + ``` + + + Example notification: + ```json + { + "jsonrpc":"2.0", + "method":"eth_subscription", + "params":{ + "subscription":"0x1", + "result":"0x5705bc8bf875ff03e98adb98489428835892dc6ba6a6b139fee1becbc26db0b8" + } + } + ``` + +#### Synchronizing + +Use the `syncing` parameter with `eth_subscribe` to be notified about synchronization progress. + +The sychronizing subscription either returns `false` indicating the synchronization has finished +or an `object` indicating the synchronization progress. + +!!!example + To subscribe to synchronizing notifications: + ```json + {"id": 1, "method": "eth_subscribe", "params": ["syncing"]} + ``` + + Example result: + ```json + {"jsonrpc":"2.0","id":1,"result":"0x4"} + ``` + + Example notification: + + ```json + { + "jsonrpc":"2.0", + "method":"eth_subscription", + "params":{ + "subscription":"0x4", + "result":{ + "startingBlock":"0x0", + "currentBlock":"0x3e80", + "highestBlock":"0x67b93c" + } + } + } + ``` + +## Unsubscribing + +Use the [subscription ID](#subscription-id) with `eth_unsubscribe` to cancel a subscription. + +!!!example + To unsubscribe from a subsciption with subscription ID of `0x1`: + ```json + {"id": 1, "method": "eth_unsubscribe", "params": ["0x1"]} + ``` + + `eth_unsubscribe` returns `true` if subscription succuessfully unsubscribed; otherwise, an error is returned. + + Example result: + ```json + {"jsonrpc":"2.0","id":1,"result":true} + ``` \ No newline at end of file diff --git a/docs/Using-Pantheon/Switching from Geth.md b/docs/Using-Pantheon/Switching from Geth.md new file mode 100644 index 0000000000..503fa1da06 --- /dev/null +++ b/docs/Using-Pantheon/Switching from Geth.md @@ -0,0 +1 @@ +#TODO \ No newline at end of file diff --git a/docs/Using-Pantheon/Transactions.md b/docs/Using-Pantheon/Transactions.md new file mode 100644 index 0000000000..0ca7302841 --- /dev/null +++ b/docs/Using-Pantheon/Transactions.md @@ -0,0 +1,158 @@ +description: Some use cases of creating transactions on a Pantheon network + + +# Creating and Sending Transactions + +You can send signed transactions using the [`eth_sendRawTransaction`](../Reference/JSON-RPC-API-Methods.md#eth_sendrawtransaction) JSON-RPC API method. + +These examples describe how to create a signed raw transaction that can be passed to [`eth_sendRawTransaction`](../Reference/JSON-RPC-API-Methods.md#eth_sendrawtransaction). + +!!!tip + To avoid exposing your private keys, create signed transactions offline. + +The examples use the following libraries to create signed transactions: + +* [web3.js](https://github.com/ethereum/web3.js/) +* [ethereumjs](https://github.com/ethereumjs/ethereumjs-tx) + +!!!info + Other libraries (such as [web3j](https://github.com/web3j/web3j) or [ethereumj](https://github.com/ethereum/ethereumj)) + and tools (such as [MyEtherWallet](https://kb.myetherwallet.com/offline/making-offline-transaction-on-myetherwallet.html) + or [MyCrypto](https://mycrypto.com/)) can also be used to create signed transactions. + +Example Javascript scripts are provided to create signed raw transaction strings to: + +* [Send ether](#sending-ether) +* [Deploy a contract](#deploying-a-contract) + +!!!attention + [Node.js](https://nodejs.org/en/download/) must be installed to run these Javascript scripts. + +The example Javascript scripts can be used to create raw transactions to send in the private network created +by the [Private Network Quickstart](../Getting-Started/Private-Network-Quickstart.md). + +The `JSON-RPC endpoint` in the examples must be updated to the endpoint for the private network displayed +after running the `quickstart/runPantheonPrivateNetwork.sh` script. + +To create and display the transaction string, run the Javascript script. + +```bash +$ node create_signed_raw_transaction.js +``` + +To send a signed transaction, run: +```bash +$ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["raw_transaction_string"],"id":1}' +``` + +Where: + +* `raw_transaction_string` is the signed raw transaction string displayed by the JS script. +* `` is the JSON-RPC endpoint. + +!!!example + ```bash + $ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xf86a808203e882520894f17f52151ebef6c7334fad080c5704d77216b732896c6b935b8bbd400000801ca08ce4a6c12f7f273321c5dc03910744f8fb11573fcce8140aa44486d385d22fb3a051f6bcc918bf3f12e06bfccfd1451bea5c517dffee0777ebd50caf177b17f383"],"id":1}' http://localhost:8545 + ``` + +All accounts and private keys in the examples are from the `dev.json` genesis file in the `/pantheon/ethereum/core/src/main/resources` directory. + +## Sending Ether + +!!!example + + The following is an example of JavaScript that displays a signed transaction string to send ether. + + ```javascript linenums="1" + const web3 = require('web3') + const ethTx = require('ethereumjs-tx') + + // web3 initialization - must point to the HTTP JSON-RPC endpoint + const web3 = new Web3(new Web3.providers.HttpProvider('http://127.0.0.1:8545')) + + // Sender address and private key + // Second acccount in dev.json genesis file + // Exclude 0x at the beginning of the private key + const addressFrom = '0x627306090abaB3A6e1400e9345bC60c78a8BEf57' + const privKey = Buffer.from('c87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3', 'hex') + + // Receiver address and value to transfer + // Third account in dev.json genesis file + const addressTo = '0xf17f52151EbEF6C7334FAD080c5704D77216b732' + const valueInEther = 2000 + + // Get the address transaction count in order to specify the correct nonce + txnCount = web3.eth.getTransactionCount(addressFrom, "pending"); + + // Create the transaction object + var txObject = { + nonce: web3.toHex(txnCount), + gasPrice: web3.toHex(1000), + gasLimit: web3.toHex(21000), + to: addressTo, + value: web3.toHex(web3.toWei(valueInEther, 'ether')) + }; + + // Sign the transaction with the private key + const tx = new ethTx(txObject); + tx.sign(privKey) + + //Convert to raw transaction string + const serializedTx = tx.serialize(); + const rawTxHex = '0x' + serializedTx.toString('hex'); + + console.log("Raw transaction string=" + rawTxHex) + ``` + +## Deploying a Contract + +!!!example + The following is an example of JavaScript that displays a signed raw transaction string to deploy a contract. + + ```javascript linenums="1" + const web3 = require('web3') + const ethTx = require('ethereumjs-tx') + + // web3 initialization - must point to the HTTP JSON-RPC endpoint + const web3 = new Web3(new Web3.providers.HttpProvider('http://127.0.0.1:8545')) + + // Deployer address and private key + // First account in the dev.json genesis file + const addressFrom = '0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73' + const privKey = Buffer.from('8f2a55949038a9610f50fb23b5883af3b4ecb3c3bb792cbcefbd1542c692be63', 'hex') + + // Compiled contract hash - can obtain from Remix by clicking the Details button in the Compile tab. + // Compiled contract hash is value of data parameter in the WEB3DEPLOY section + const contractData = '0x608060405234801561001057600080fd5b5060dc8061001f6000396000f3006080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680633fa4f24514604e57806355241077146076575b600080fd5b348015605957600080fd5b50606060a0565b6040518082815260200191505060405180910390f35b348015608157600080fd5b50609e6004803603810190808035906020019092919050505060a6565b005b60005481565b80600081905550505600a165627a7a723058202bdbba2e694dba8fff33d9d0976df580f57bff0a40e25a46c398f8063b4c00360029' + + // Get the address transaction count in order to specify the correct nonce + txnCount = web3.eth.getTransactionCount(addressFrom, "pending"); + + var txObject = { + nonce: web3.toHex(txnCount), + gasPrice: web3.toHex(1000), + gasLimit: web3.toHex(126165), + data: contractData + }; + + const tx = new ethTx(txObject); + tx.sign(privKey) + + const serializedTx = tx.serialize(); + const rawTxHex = '0x' + serializedTx.toString('hex'); + + console.log("Raw transaction string=" + rawTxHex); + ``` + +## eth_call or eth_sendRawTransaction + +You can interact with contracts using [eth_call](../Reference/JSON-RPC-API-Methods.md#eth_call) or [eth_sendRawTransaction](../Reference/JSON-RPC-API-Methods.md#eth_sendrawtransaction). + +|eth_call | eth_sendRawTransaction | +|--------|--------| +|Read-only | Write +| Invokes contract function locally | Broadcasts to network +| Does not change state of blockchain | Updates blockchain (for example, transfers ether between accounts) +| Does not consume gas | Requires gas +| Synchronous | Asynchronous | +| Return value of contract function available immediately| Returns transaction hash only. Possible transaction may not be included in a block (for example, if the gas price is too low) diff --git a/docs/community/code-reviews.md b/docs/community/code-reviews.md index 85578f26b3..83efcb6751 100644 --- a/docs/community/code-reviews.md +++ b/docs/community/code-reviews.md @@ -1,4 +1,5 @@ -## Code reviews +description: Code review guidelines for Pantheon developers + All changes must be code reviewed. For non-approvers this is obvious, since you can't commit anyway. But even for approvers, we want all changes to get at diff --git a/docs/community/community-membership.md b/docs/community/community-membership.md index f10140f8c3..f7f5b061c0 100644 --- a/docs/community/community-membership.md +++ b/docs/community/community-membership.md @@ -1,6 +1,8 @@ -# Community membership +description: Community organisation and members responsibilities + -**Note:** This document is in progress +!!!note + This document is in progress This doc outlines the various responsibilities of contributor roles in this project. @@ -170,4 +172,4 @@ This document is adapted from the following sources: [two-factor authentication]: https://help.github.com/articles/about-two-factor-authentication [pantheon-dev@pegasys.tech]: mailto:pantheon-dev@pegasys.tech [Pantheon Gitter]: https://gitter.im/PegaSysEng/pantheon -[Pantheon Wiki]: https://github.com/PegaSysEng/pantheon/wiki +[Pantheon Documentation]: https://pantheon.readthedocs.io/ diff --git a/docs/conf.py b/docs/conf.py new file mode 100644 index 0000000000..d7a642db98 --- /dev/null +++ b/docs/conf.py @@ -0,0 +1,2 @@ +# -*- coding: utf-8 -*- +exclude_patterns = ['/ethereum/referencetests'] \ No newline at end of file diff --git a/docs/custom_theme/404.html b/docs/custom_theme/404.html new file mode 100644 index 0000000000..4952cc7a3a --- /dev/null +++ b/docs/custom_theme/404.html @@ -0,0 +1,10 @@ +{% extends "base.html" %} +{% block content %} + +

account_balance

+

404

+

Deity not found in the Pantheon

+

Try the homepage, or use the search field on the top right of this documentation.

+

If you think we made a mistake and deleted a page that should be here, then please tell us on Gitter or create an issue in Pantheon Github repository.

+ +{% endblock %} \ No newline at end of file diff --git a/docs/custom_theme/favicon.ico b/docs/custom_theme/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..f2883bad61b7ef7218098b0111c7e3c48e536b24 GIT binary patch literal 32988 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 + + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to + deal in the Software without restriction, including without limitation the + rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + sell copies of the Software, and to permit persons to whom the Software is + furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS + IN THE SOFTWARE. +--> + +{% import "partials/language.html" as lang with context %} + + + + + + + + + + + \ No newline at end of file diff --git a/docs/custom_theme/partials/toc.html b/docs/custom_theme/partials/toc.html new file mode 100644 index 0000000000..d34ba7ee57 --- /dev/null +++ b/docs/custom_theme/partials/toc.html @@ -0,0 +1,33 @@ +{% import "partials/language.html" as lang with context %} + diff --git a/docs/development/code-coverage.md b/docs/development/code-coverage.md index 3815f6919c..b94dab1652 100644 --- a/docs/development/code-coverage.md +++ b/docs/development/code-coverage.md @@ -1,4 +1,4 @@ -## Code coverage +# Code coverage We use the jacoco test coverage plugin, which will generate coverage data whenever tests are run. diff --git a/docs/development/running-with-gradle.md b/docs/development/running-with-gradle.md index 0eced75b27..2809d19e35 100644 --- a/docs/development/running-with-gradle.md +++ b/docs/development/running-with-gradle.md @@ -1,4 +1,4 @@ -# Running Pantheon +# Running Pantheon with Gradle You can build and run Pantheon with default options via: diff --git a/docs/global/test_accounts.md b/docs/global/test_accounts.md new file mode 100644 index 0000000000..03850096cd --- /dev/null +++ b/docs/global/test_accounts.md @@ -0,0 +1,19 @@ +!!! warning + Do not use the following accounts on mainnet or any public network except for testing. + + The private keys are displayed here so the accounts are not secure. + +!!! example "Account 1 (Miner Coinbase Account)" + * Address: `0xfe3b557e8fb62b89f4916b721be55ceb828dbd73` + * Private key : ==0x8f2a55949038a9610f50fb23b5883af3b4ecb3c3bb792cbcefbd1542c692be63== + * Initial balance : `0xad78ebc5ac6200000` (200000000000000000000 in decimal) + +!!! example "Account 2" + * Address: `0x627306090abaB3A6e1400e9345bC60c78a8BEf57` + * Private key : ==0xc87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3== + * Initial balance : `0x90000000000000000000000` (2785365088392105618523029504 in decimal) + +!!! example "Account 3" + * Address: `0xf17f52151EbEF6C7334FAD080c5704D77216b732` + * Private key : ==0xae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f== + * Initial balance : `0x90000000000000000000000` (2785365088392105618523029504 in decimal) \ No newline at end of file diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000000..8de35bae39 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,26 @@ +title: Pantheon Enterprise Ethereum client +description: Pantheon is an open-source Enterprise Ethereum client developed under the Apache 2.0 license and written in Java. It runs on the Ethereum public network, private networks, and test networks. + + +## What is Pantheon? + +Pantheon is an open-source Ethereum client developed under the Apache 2.0 license and written in Java. It runs on the Ethereum public network, private networks, and test networks such as Rinkeby and Ropsten. Pantheon implements Proof of Work (Ethash) and Proof of Authority (Clique) consensus mechanisms. + +You can use Pantheon to develop enterprise applications requiring secure, high-performance transaction processing in a private network. + +Our roadmap includes Pantheon with privacy features, alternative consensus mechanisms, and other enterprise features. + + +## What can you do with Pantheon? + +Pantheon includes a [command line interface](Reference/Pantheon-CLI-Syntax.md) and [JSON-RPC API](Reference/JSON-RPC-API.md) for running, maintaining, debugging, and monitoring node operations in an Ethereum network. You can use the API via RPC over HTTP or via WebSockets transport, and Pub/Sub is supported. The API supports typical Ethereum functionalities such as: + +* Ether token mining +* Smart contract development +* Decentralized application (Dapp) development + +## What does Pantheon support? + +The Pantheon client supports common smart contract and Dapp development, deployment, and operational use cases, using tools such as [Truffle](http://truffleframework.com/), [Remix](https://github.com/ethereum/remix), and [web3j](https://web3j.io/). The client supports common JSON-RPC API methods such as eth, net, web3, debug, and miner. + +Pantheon doesn't support [Account management](Using-Pantheon/Account-Management.md). diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 0000000000..44e78d661d --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1,7 @@ +mkdocs>=1.0 +pymdown-extensions==6.0 +mkdocs-material>=3.1 +Markdown==3.0.1 +markdown-fenced-code-tabs==1.0.5 +markdown-include==0.5.1 +MarkupSafe==1.1.0 diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000000..1bcf2a0461 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,113 @@ +# Copyright 2018 ConsenSys AG. +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on +# an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the +# specific language governing permissions and limitations under the License. + +# Project information +site_name: Pantheon +site_url: https://pantheon.readthedocs.io/ +site_description: Pantheon Java Ethereum client documentation. +site_author: Pantheon community +copyright: Pantheon and its documentation are licensed under Apache 2.0 license / + This Readthedocs.org documentation is maintained with love by PegaSys. +#google_analytics: ['UA-36723568-3', 'pantheon.readthedocs.io'] + +#extra project info and template customisation +extra: + support: + gitter: https://gitter.im/PegaSysEng/pantheon + email: support@pegasys.tech + footer_layout: + background_color: lightseagreen + links_color: white + + +# Repository +repo_name: PegaSysEng/pantheon +repo_url: https://github.com/PegaSysEng/pantheon +edit_uri: "" + +theme: + name: material + custom_dir: docs/custom_theme + highlightjs: true + hljs_languages: + - java + - bash + - bat + - toml + - json + - yaml + palette: + primary: blue-grey + accent: teal + favicon: favicon.ico + logo: + icon: account_balance +nav: + - Installation: + - Installation Overview: Installation/Overview.md + - Install Binary Distribution: Installation/Install-Binaries.md + - Build from Source: Installation/Build-From-Source.md + - Getting Started: + - Getting Started Overview: Getting-Started/Getting-Started.md + - Starting Pantheon: Getting-Started/Starting-Pantheon.md + - Running Pantheon from Docker Image: Getting-Started/Run-Docker-Image.md + - Private Network Quickstart Tutorial: Getting-Started/Private-Network-Quickstart.md + - Configuring Pantheon: + - Network ID and Chain ID: Configuring-Pantheon/NetworkID-And-ChainID.md + - Node Keys: Configuring-Pantheon/Node-Keys.md + - Networking: Configuring-Pantheon/Networking.md + - Accounts for Testing: Configuring-Pantheon/Accounts-for-Testing.md + - Logging: Configuring-Pantheon/Logging.md + - Testing and Developing Nodes: Configuring-Pantheon/Testing-Developing-Nodes.md + - Proof of Authority: Configuring-Pantheon/Proof-of-Authority.md + - Passing JVM Options: Configuring-Pantheon/Passing-JVM-Options.md + - Using Pantheon: + - Creating and Sending Transactions: Using-Pantheon/Transactions.md + - Using Wallets for Account Management: Using-Pantheon/Account-Management.md + - Mining: Using-Pantheon/Mining.md + - RPC Pub/Sub: Using-Pantheon/RPC-PubSub.md + - Debugging Pantheon: Using-Pantheon/Debugging.md + - Reference: + - Pantheon Command Line: Reference/Pantheon-CLI-Syntax.md + - Pantheon JSON-RPC API: + - JSON-RPC API Overview: Reference/JSON-RPC-API.md + - Using the JSON-RPC API: Reference/Using-JSON-RPC-API.md + - JSON-RPC API Methods: Reference/JSON-RPC-API-Methods.md + - JSON-RPC API Objects: Reference/JSON-RPC-API-Objects.md + +markdown_extensions: + - toc: + permalink:  + - markdown_include.include: + base_path: docs + - admonition + - footnotes + - def_list + - pymdownx.arithmatex + - pymdownx.betterem: + smart_enable: all + - pymdownx.caret + - pymdownx.keys + - pymdownx.critic + - pymdownx.details + - pymdownx.emoji + - pymdownx.magiclink + - pymdownx.mark + - pymdownx.smartsymbols + - pymdownx.superfences + - pymdownx.tasklist: + custom_checkbox: true + - pymdownx.tilde + - meta + - smarty + +plugins: + - search