PyEPM

Python-based EPM (Ethereum Package Manager) for Serpent 2 contract deployment using YAML for package definitions.

Installation

pip install pyepm

Development

git clone https://github.com/etherex/pyepm.git
cd pyepm
pip install -e .

Requirements

cpp-ethereum node with JSONRPC

Configuration

First run pyepm -h to create a config file in ~/.pyepm/config on Linux and OSX and ~/AppData/Roaming/PyEPM on Windows.

Then edit the configuration file, make sure you set the address from which to deploy contracts.

You will need a package definition file in YAML format to get started (see example below). You can use your deployed contracts' names as variables (prefixed with $) in later transact or call steps, making contract initialization a lot easier and less dependent on fixed contract addresses.

-
# Set some variables.
  set:
    NameReg: "0x72ba7d8e73fe8eb666ea66babc8116a41bfb10e2"
-
# Deploy contracts
  deploy:
    NameCoin:
      contract: namecoin.se
      wait: True
    Subcurrency:
      contract: subcurrency.se
      gas: 100000
      endowment: 1000000000000000000
-
# Make transactions, here we register the previously deployed
# 'Subcurrency' contract with the global NameReg
  transact:
    NameReg:
      to: $NameReg
      fun_name: register
      sig: i
      data:
        - $Subcurrency
      gas: 10000
      gas_price: 10000000000000
      value: 0
      wait: True
-
# Contract calls with return values
  call:
    GetMarket:
      to: "0x77045e71a7a2c50903d88e564cd72fab11e82051"
      fun_name: get_market
      sig: i
      data:
        - 1
-
# Another deploy
  deploy:
    extra:
      contract: short_namecoin.se
-
# Deploy Solidity contract
  deploy:
    Config:
      contract: config.sol
      solidity:
        - Config
        - mortal
        - owned

Usage

pyepm YourPackageDefinitions.yaml

usage: pyepm [-h] [-v] [-r HOST] [-p PORT] [-a ADDRESS] [-g GAS] [-c CONFIG]
             [-V VERBOSITY] [-L LOGGING]
             filename [filename ...]

positional arguments:
  filename              Package definition filenames in YAML format

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -r HOST, --host HOST  <host> JSONRPC host (default: 127.0.0.1).
  -p PORT, --port PORT  <port> JSONRPC port (default: 8080).
  -a ADDRESS, --address ADDRESS
                        Set the address from which to deploy contracts.
  -g GAS, --gas GAS     Set the default amount of gas for deployment.
  -c CONFIG, --config CONFIG
                        Use another configuration file.
  -V VERBOSITY, --verbose VERBOSITY
                        <0 - 3> Set the log verbosity from 0 to 3 (default: 1)
  -L LOGGING, --logging LOGGING
                        <logger1:LEVEL,logger2:LEVEL> set the console log
                        level for logger1, logger2, etc. Empty loggername
                        means root-logger, e.g. ':DEBUG,:INFO'. Overrides '-V'

TODO

• Support using variables across multiple definition files
• Export addresses of deployed contracts in a json file
• Post-deployment hooks
• Support named values (1 ether)