Plugin for Ape Ethereum Framework for compiling Solidity contracts
Project description
Ape Solidity
Compile Solidity contracts.
Dependencies
- python3 version 3.7.2 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.
Development
Please see the contributing guide to learn more how to contribute to this project. Comments, questions, criticisms and pull requests are welcomed.
License
This project is licensed under the Apache 2.0.
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
Built Distribution
File details
Details for the file ape-solidity-0.4.2.tar.gz.
File metadata
- Download URL: ape-solidity-0.4.2.tar.gz
- Upload date:
- Size: 30.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.8.3 readme-renderer/37.0 requests/2.28.1 requests-toolbelt/0.9.1 urllib3/1.26.12 tqdm/4.64.0 importlib-metadata/4.12.0 keyring/23.8.2 rfc3986/2.0.0 colorama/0.4.5 CPython/3.8.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7343afed75c716d093ec4bcd2c1217beb4002a044caf084611a76613a2f6716c |
|
| MD5 | eeac5f607e0b6bb6fdacbed4c2aa9acb |
|
| BLAKE2b-256 | 795b0c17fe0f2156b40cf64a6b339022876d1bb35b7d35f95208c0f9acffa8ad |
File details
Details for the file ape_solidity-0.4.2-py3-none-any.whl.
File metadata
- Download URL: ape_solidity-0.4.2-py3-none-any.whl
- Upload date:
- Size: 15.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.8.3 readme-renderer/37.0 requests/2.28.1 requests-toolbelt/0.9.1 urllib3/1.26.12 tqdm/4.64.0 importlib-metadata/4.12.0 keyring/23.8.2 rfc3986/2.0.0 colorama/0.4.5 CPython/3.8.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7f7ef622d54cf13463f73e149c064ec0380afc0b27a9b9da405b8cb0e84794cd |
|
| MD5 | 8f305dbaa456ce94c38961a3f9d0304a |
|
| BLAKE2b-256 | afa5afc2b558b988ab513affc478c4e56b835a6d4b2b1c255565b9db2ff71dc6 |
