Skip to content

Commit

Permalink
Some misc README cleanup
Browse files Browse the repository at this point in the history
Saving work in progress. Going to try to merge some in flight PRs and rebase against those.
  • Loading branch information
Lane Rettig authored and lrettig committed Nov 14, 2018
1 parent e771b58 commit 59df754
Showing 1 changed file with 15 additions and 10 deletions.
25 changes: 15 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,16 @@
Welcome to the Ewasm public testnet! This repository is the primary point of coordination for the testnet. Read on for more information about how to:

- Write smart contracts in supported languages and compile them to Wasm bytecode
- Transact on the testnet, including deploying contracts
- Transact on the testnet, such as by deploying smart contracts compiled to Ewasm bytecode
- Run a testnet node locally
- Add a node to the testnet
- Participate in mining
- Participate in network forks
- Participate in network upgrades
- Contribute to development and devops

## Background

Ewasm, which stands for Ethereum-flavored WebAssembly, is the primary candidate to replace EVM (the Ethereum virtual machine) as part of the Ethereum 2.0 "Shasper" roadmap. It is also proposed for adoption on the Ethereum mainnet. Ewasm is a deterministic smart contract execution engine built on the modern, standard [WebAssembly virtual machine](https://webassembly.org/).
Ewasm, which stands for Ethereum-flavored WebAssembly, is the primary candidate to replace EVM (the Ethereum virtual machine) as part of the Ethereum 2.0 "Serenity" roadmap. It is also proposed for adoption on the Ethereum mainnet. Ewasm is a deterministic smart contract execution engine built on the modern, standard [WebAssembly virtual machine](https://webassembly.org/).

For more information on Ewasm, please refer to the following resources:

Expand Down Expand Up @@ -45,6 +46,15 @@ At present, we've developed support for the following languages and toolchains:

If you're interested in adding support for another language, framework, or toolset, see the Contributing section above and reach out.

## Differences from mainnet

The Ewasm testnet supports executing EVM 1.0 (Byzantium) bytecode **and** ewasm bytecode. The chain id is set to 0x42 (66).

There are two further technical differences:

- the code size limit introduced by Spurious Dragon has been lifted and there is no upper limit (as Wasm bytecode is more verbose than the EVM equivalent)
- zero bytes in contract bytecode are not subsidised during deployment (they cost the same as non-zero bytes)

## Transacting

You don't need any special infrastructure to transact on the Ewasm testnet. You may run your own node (see below), or you may use the public node. You may view the list of testnet tools here: http://ewasm.ethereum.org/. Start by requesting test ether from the faucet:
Expand All @@ -55,17 +65,12 @@ You don't need any special infrastructure to transact on the Ewasm testnet. You

Voila! You're now ready to transact on the testnet.

## Differences from mainnet

The Ewasm testnet supports executing EVM 1.0 (Byzantium) bytecode **and** ewasm bytecode. The chain id is set to 0x42 (66).
## Running a testnet node locally

There are two differences:
- code size limit introduced by Spurious Dragon has been lifted and there is no upper limit
- zero bytes in contract bytecode are not subsidised anymore during deployment (they cost the same as non-zero bytes)
The testnet currently only supports the [go-ethereum](https://github.com/ethereum/go-ethereum) (geth) client. Support for aleth (formerly, cpp-ethereum) is a work in progress and more information may be found [here](aleth.md).

## Adding a node to the testnet

The testnet currently only supports the [go-ethereum](https://github.com/ethereum/go-ethereum) (geth) client. Support for aleth (formerly, cpp-ethereum) is a work in progress and more information may be found [here](aleth.md).

### Geth

Expand Down

0 comments on commit 59df754

Please sign in to comment.