Skip to main content

An Ethereum simulator for aiding smart contract development.

Project description

## Ethereum Test RPC

Limited RPC client intended for use with automated testing. Uses [pythereum](https://github.com/ethereum/pyethereum) to run an Ethereum client behind the scenes without the need for mining or networking. The result is an Ethereum client that provides instant results and quick feedback during development.

### Install

Installing is easy, through pip:

` $ pip install eth-testrpc `

Or, to upgrade:

` pip install eth-testrpc --upgrade `

### Run

Installing through pip will make the testrpc command available on your machine:

` $ testrpc `

This will run testrpc on localhost:8545. You can pass through a different port (-p, –port) or domain (-d, –domain).

### Implemented methods

The RPC methods currently implemented are:

  • eth_coinbase

  • eth_accounts

  • eth_gasPrice

  • eth_blockNumber

  • eth_sendTransaction

  • eth_sendRawTransaction

  • eth_call

  • eth_getCompilers

  • eth_compileSolidity

  • eth_getCode (only supports block number “latest”)

  • eth_getBalance

  • eth_getTransactionCount

  • eth_getTransactionByHash

  • eth_getTransactionReceipt

  • eth_newBlockFilter

  • eth_newFilter

  • eth_getFilterChanges

  • eth_uninstallFilter

  • web3_sha3

  • web3_clientVersion

There’s also special non-standard methods that aren’t included within the original RPC specification:

  • evm_reset : No params, no return value.

  • evm_snapshot : No params. Returns the integer id of the snapshot created.

  • evm_revert : One optional param. Reverts to the snapshot id passed, or the latest snapshot.

When calling evm_reset, the testrpc will revert the state of its internal chain back to the genesis block and it will act as if no processing of transactions has taken place. Similarly, you can use evm_snapshot and evm_revert methods to save and restore the evm state as desired. Example use cases for these methods are as follows:

  • evm_reset : Run once at the beginning of your test suite.

  • evm_snapshot : Run at the beginning of each test, snapshotting the state of the evm.

  • evm_revert : Run at the end of each test, reverting back to a known clean state.

### Releasing a new version (for eth-testrpc developers)

So we don’t forget. :)

Install seed if you haven’t already:

` $ pip install seed `

Commit any changes you’ve made first. Then, to make the release:

` $ seed release `

Afterward, commit the changes it made for you:

` git push && git push --tags `

All done! No need to update a version number.

### License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eth-testrpc-0.1.26.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

eth_testrpc-0.1.26-py2-none-any.whl (12.3 kB view details)

Uploaded Python 2

File details

Details for the file eth-testrpc-0.1.26.tar.gz.

File metadata

File hashes

Hashes for eth-testrpc-0.1.26.tar.gz
Algorithm Hash digest
SHA256 dd8b72c08aaea645ad58dda14f4cd3e55d2f14add712de828c886b8cdc5a378b
MD5 3f2a54c07bc7b7c6b4797f53c560c19f
BLAKE2b-256 acd7067ca9848d2fc362ce7ea6b368ce90d9c1500d04896b984ce47a191e280e

See more details on using hashes here.

File details

Details for the file eth_testrpc-0.1.26-py2-none-any.whl.

File metadata

File hashes

Hashes for eth_testrpc-0.1.26-py2-none-any.whl
Algorithm Hash digest
SHA256 8e667f9ac7de3e75fac2b79a5420b489ac32fbffba142506a17265cc0bcee270
MD5 26251abe38f0fd108240243e23065027
BLAKE2b-256 c7a62d1dd83aafaf862fb66409564c0081be81bc741d8c6c80c6ed196b894686

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page