Package: pyethapp
Introductionpyethapp is the python based client implementing theEthereumcryptoeconomic state machine.Ethereum as a platform is focussed on enabling people to build new ideas using blockchain technology.The python implementation aims to provide an easily hackable and extendable codebase.pyethapp leverages two ethereum core components to implement the client:pyethereum- the core library, featuring the blockchain, the ethereum virtual machine, miningpydevp2p- the p2p networking library, featuring node discovery for and transport of multiple services over multiplexed and encrypted connectionsInstallationNotesPyethapp runs on Python 2.7. If you don’t know how to install an
up-to-date version of Python, have a lookhere. It is always
advised to install system-dependecies with the help of a package manager
(e.g.homebrewon Mac OS X orapt-geton Debian).Please install avirtualenvenvironment for a comfortable Pyethapp
installation. Also, it is always recommended to use it in combination
with thevirtualenvwrapperextension.TheHomestead-ready
version of Pyethapp isv1.2.0.Installation on Ubuntu/DebianFirst install the system-dependecies for a successful build of the
Python packages:$apt-getinstallbuild-essentialautomakepkg-configlibtoollibffi-devlibgmp-devInstallation of Pyethapp and it’s dependent Python packages viaPyPI:($mkvirtualenvpyethapp)$pipinstallpyethappInstallation on OS X(More detailed instructions can be found in theMac OS X installation instructions)First install the system-dependecies for a successful build of the
Python packages:$brewinstallautomakelibtoolpkg-configlibffigmpopensslInstallation of Pyethapp and it’s dependent Python packages viaPyPI:($mkvirtualenvpyethapp)$pipinstallpyethappDevelopment versionIf you want to install the newest version of the client for development
purposes, you have to clone it directly from GitHub.First install the system dependencies according to your Operating System
above, then:($mkvirtualenvpyethapp)$gitclonehttps://github.com/ethereum/pyethapp$cdpyethapp$pythonsetup.pydevelopThis has the advantage that inside of Python’slib/python2.7/site-packagesthere is a direct link to your directory
of Pyethapp’s source code. Therefore, changes in the code will have
immediate effect on thepyethappcommand in your terminal.Connecting to the networkIf you type in the terminal:$pyethappwill show you all available commands and options of the client.To get started, type:($workonpyethapp)$pyethappaccountnewThis creates a new account and generates the private key. The key-file
is locked with the password that you entered and they are stored in the/keystoredirectory. You can’t unlock the file without the password
and there is no way to recover a lost one. Donot delete the
key-files, if you still want to be able to access Ether and Contracts
associated with that account.To connect to the live Ethereum network, type:($workonpyethapp)$pyethapprunThis establishes the connection to Ethereum’s p2p-network and downloads
the whole blockchain on the first invocation.For additional documentation how to use the client, have a look at theWiki.Data directory:When running the client without specifying a data-directory, the
blockchain-data and the keystore-folder will be saved in a default
directory, depending on your Operating System.on Mac OS X:~/Library/Application\Support/pyethappon Linux:~/.config/pyethappThis folder also holds theconfig.yamlfile, in which you can modify
your default configuration parameters.To provide a different data-directory, e.g. for additionally syncing to
the testnet, run the client with the-d<dir>/--data-dir<dir>argument.Available NetworksLive (Frontier/Homestead)Test (Morden)Currently there are two official networks available. The “Live Network” is
calledFrontier(soon to beHomestead) and this is what the client will
connect to if you start it without any additional options.Additionally there is the official test network calledMordenwhich can be
used to test new code or otherwise experiment without having to risk real
money.
Use the–profilecommand line option to select the test network:$pyethapp--profiletestnetrunNoteIf you’ve previously connected to the live network you will also need
to specify a new data directory by using the–data-diroption.InteractingYou can interact with the client using the JSONRPC api or directly on the console.https://github.com/ethereum/pyethapp/wiki/The_Consolehttps://github.com/ethereum/pyethapp/blob/master/pyethapp/rpc_client.pyStatusWorking PoC9 prototypeinteroperable with the go and cpp clientsjsonrpc (mostly)History0.1.0 (2015-01-01)First release on PyPI.