Skip to main content

Ape Ethereum Framework

Project description

Overview

Ape Framework is an easy-to-use Web3 development tool. Users can compile, test, and interact with smart contracts all in one command line session. With our modular plugin system, Ape supports multiple contract languages and chains.

Ape is built by ApeWorX LTD.

Join our ApeWorX Discord server to stay up to date on new releases, plugins and tutorials.

If you want to just get started, jump down to the Playing with Ape.

Documentation

Read our technical documentation to get a deeper understanding of our open source Framework.

Read our academic platform will help you master Ape Framework with tutorials and challenges.

Prerequisite

In the latest release, Ape requires:

  • Linux or macOS
  • Python 3.8 up to 3.11
  • Windows: Install Windows Subsystem Linux (WSL)

Check your python version in a terminal with python3 --version.

Installation

There are three ways to install ape: pipx, pip, or Docker.

Considerations for Installing:

  • We advise installing in a virtualenv or venv to avoid interfering with OS-level site packages.

  • We advise installing ape with recommended plugins pip install eth-ape'[recommended-plugins]'.

  • We advise for macOS users to install virtual env via homebrew.

via pipx or pip

  1. Install pipx via their installation instructions or pip via their installation instructions.

  2. Install ape via pipx install eth-ape or pip install eth-ape.

via docker

Ape can also run in a docker container.

Please visit our Dockerhub for more details on using Ape with Docker.

docker run \
--volume $HOME/.ape:/home/harambe/.ape \
--volume $HOME/.vvm:/home/harambe/.vvm \
--volume $HOME/.solcx:/home/harambe/.solcx \
--volume $PWD:/home/harambe/project \
apeworx/ape compile

Playing with Ape

After you installed Ape, you can run ape --version to make sure it works and is the latest version.

There are two ways to interact with Ape:

Ape is both a CLI tool and a Python SDK.

The CLI tool contains all the Ape commands and the Python SDK contains the classes and types needed to compose scripts, console actions, and tests.

Ape Modular Plugin System:

Our list of plugins is the best way to have the most interoperable experience with Web3.

NOTE: If a plugin does not originate from the ApeWorX GitHub Organization, you will get a warning about installing 3rd-party plugins.

Install 3rd party plugins at your own risk.

Additionally, plugins that come bundled with ape in the core installation cannot be removed and are part of the ape core software.

Accounts

In Ape, you will need accounts to make transactions. You can import or generate accounts using the core accounts plugin:

ape accounts import acc0   # Will prompt for a private key
ape accounts generate acc1

List all your accounts with the list command.

ape accounts list

Learn more about accounts in Ape by following the accounts guide.

Plugins

Add any plugins you may need, such as vyper.

ape plugins list -a
ape plugins install vyper
ape plugins list -a

Projects

When using Ape, you generally will work with a project.

Learn more about smart-contract projects from this projects guide.

Compiling

You can compile contracts within the contracts/ directory of your project. The --size option will display you the size of the contract.

ape compile --size

Learn more about compiling in Ape by following the compile guide.

Testing

Use Ape to test your smart-contract projects. Provide the same arguments to pytest as you would to the ape test command.

For example:

ape test -k test_only_one_thing

Visit the testing guide to learn more about testing using Ape.

Console

Ape provides an IPython interactive console with useful pre-defined locals to interact with your project. To interact with a deployed contract in a local environment, start by opening the console:

ape console --network ethereum:mainnet:infura

Visit Ape Console to learn how to use Ape Console.

Scripts

If you want to run specific files in a scripts/ directory, you can do it using the ape run command.

# This command will run a file named deploy in the scripts/ directory
$ ape run deploy

Learn more about scripting using Ape by following the scripting guide.

Logging

To enable debug logging, run your command with the --verbosity flag using DEBUG as the value:

ape --verbosity DEBUG run

Networks

You can work with registered networks, providers, and blockchain ecosystems (like Ethereum):

from ape import networks
with networks.ethereum.mainnet.use_provider("infura"):
    ...  # Work with the infura provider here

To learn more about networks in Ape, see this guide.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

eth-ape-0.6.11.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

eth_ape-0.6.11-py3-none-any.whl (245.0 kB view details)

Uploaded Python 3

File details

Details for the file eth-ape-0.6.11.tar.gz.

File metadata

  • Download URL: eth-ape-0.6.11.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/37.3 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.3 tqdm/4.65.0 importlib-metadata/6.6.0 keyring/23.13.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.12

File hashes

Hashes for eth-ape-0.6.11.tar.gz
Algorithm Hash digest
SHA256 b5ca4f776568bff6420e3bb7f6df15fc5dd353c5043fb4c4739e56d8244de2f1
MD5 0573f0f08471e5df9f3bcf9e7604bfb3
BLAKE2b-256 41858789115486890edc2d3c8abd180e63d60c9bc6221a0635d8819cddca4bda

See more details on using hashes here.

File details

Details for the file eth_ape-0.6.11-py3-none-any.whl.

File metadata

  • Download URL: eth_ape-0.6.11-py3-none-any.whl
  • Upload date:
  • Size: 245.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/37.3 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.3 tqdm/4.65.0 importlib-metadata/6.6.0 keyring/23.13.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.12

File hashes

Hashes for eth_ape-0.6.11-py3-none-any.whl
Algorithm Hash digest
SHA256 0dfb4a9ad84a37022c0b975a5c69b2604d468c7be94266561fb155a6959ca816
MD5 2293b3f5cf10e5b9f14739e5c481a304
BLAKE2b-256 87f4f51c0812a0dfcbef08cb8ca048ae9d56b3c61355efb118f1f6889c7b796f

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