Skip to main content

Plugin for Ape Ethereum Framework for compiling Solidity contracts

Project description

Quick Start

Compile Solidity contracts.

Dependencies

  • python3 version 3.8 or greater, python3-dev

Installation

via pip

You can install the latest release via pip:

pip install ape-solidity

via setuptools

You can clone the repository and use setuptools for the most up-to-date version:

git clone https://github.com/ApeWorX/ape-solidity.git
cd ape-solidity
python3 setup.py install

Quick Usage

In your project, make sure you have a contracts/ directory containing Solidity files (.sol).

Then, while this plugin is installed, compile your contracts:

ape compile

The byte-code and ABI for your contracts should now exist in a __local__.json file in a .build/ directory.

Dependency Mapping

To configure import remapping, use your project's ape-config.yaml file:

solidity:
  import_remapping:
    - "@openzeppelin=path/to/open_zeppelin/contracts"

If you are using the dependencies: key in your ape-config.yaml, ape can automatically search those dependencies for the path.

dependencies:
  - name: OpenZeppelin
    github: OpenZeppelin/openzeppelin-contracts
    version: 4.4.2

solidity:
  import_remapping:
    - "@openzeppelin=OpenZeppelin/4.4.2"

Once you have your dependencies configured, you can import packages using your import keys:

import "@openzeppelin/token/ERC721/ERC721.sol";

Compiler Settings

When using ape-solidity, your project's manifest's compiler settings will include standard JSON output. You should have one listed compiler per solc version used in your project. You can view your current project manifest, including the compiler settings, by doing:

from ape import project

manifest = project.extract_manifest()

for compiler_entry in manifest.compilers:
    print(compiler_entry.version)
    print(compiler_entry.settings)

NOTE: These are the settings used during contract verification when using the Etherscan plugin.

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

ape-solidity-0.5.4.tar.gz (33.5 kB view details)

Uploaded Source

Built Distribution

ape_solidity-0.5.4-py3-none-any.whl (16.5 kB view details)

Uploaded Python 3

File details

Details for the file ape-solidity-0.5.4.tar.gz.

File metadata

  • Download URL: ape-solidity-0.5.4.tar.gz
  • Upload date:
  • Size: 33.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.4 readme-renderer/37.3 requests/2.28.1 requests-toolbelt/0.10.1 urllib3/1.26.13 tqdm/4.64.1 importlib-metadata/6.0.0 keyring/23.13.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.8.15

File hashes

Hashes for ape-solidity-0.5.4.tar.gz
Algorithm Hash digest
SHA256 d428bc57a0c0deccb96925cc415b0a6983d1d8dc9cb2c053ad2cceaf0c428d2e
MD5 d9167ea7391f2d5f586efd1c10e2f62d
BLAKE2b-256 a8449a763e41770e0b582a0a091e01f6ecde6e2cc7f6138d833368edb77e889d

See more details on using hashes here.

File details

Details for the file ape_solidity-0.5.4-py3-none-any.whl.

File metadata

  • Download URL: ape_solidity-0.5.4-py3-none-any.whl
  • Upload date:
  • Size: 16.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.4 readme-renderer/37.3 requests/2.28.1 requests-toolbelt/0.10.1 urllib3/1.26.13 tqdm/4.64.1 importlib-metadata/6.0.0 keyring/23.13.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.8.15

File hashes

Hashes for ape_solidity-0.5.4-py3-none-any.whl
Algorithm Hash digest
SHA256 7da0148fa1a8cb733a0166a5d4070a2e365de42142442b45c87dc8e063f1b2f6
MD5 2e905895323ae7c71b9e7842299ca03f
BLAKE2b-256 3470a08b4d117c56853c7fa43d317f9139809b51ad2b17d8bab5f26e4996e7dc

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