Skip to main content

Plugin for Ape Ethereum Framework for compiling Vyper contracts

Project description

Quick Start

Ape compiler plugin around VVM

Dependencies

Installation

via pip

You can install the latest release via pip:

pip install ape-vyper

via setuptools

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

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

Quick Usage

First, place Vyper contract source files (files with extension .vy) in your Ape project's contracts folder. An example Vyper contract can be found here. Then, from your root Ape project folder, run the command:

ape compile

The .vy files in your project will compile into ContractTypes that you can deploy and interact with in Ape.

Compiler Version

By default, the ape-vyper plugin uses version pragma for version specification. However, you can also configure the version directly in your ape-config.yaml file:

vyper:
  version: 0.3.7

Interfaces

You can not compile interface source files directly. Thus, you must place interface files in a directory named interfaces in your contracts_folder e.g. contracts/interfaces/IFace.vy. Then, these files can be imported in other .vy sources files via:

import interfaces.IFace as IFace

Alternatively, use JSON interfaces from dependency contract types by listing them under the import_remapping key:

# Use `voting` example contracts from Vyperlang repo.
dependencies:
  - name: VyperVoting
    github: vyperlang/vyper
    contracts_folder: examples/voting/
    version: v0.3.8

# Automatically allow importing voting contracts in your project.
vyper:
  import_remapping:
    - "voting=VyperVoting@v0.3.8"

Import the voting contract types like this:

# @version 0.3.10

import voting.ballot as ballot

Pragmas

Ape-Vyper supports Vyper 0.3.10's new pragma formats

Version Pragma

#pragma version 0.3.10

Optimization Pragma

#pragma optimize codesize

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-vyper-0.6.13.tar.gz (46.5 kB view details)

Uploaded Source

Built Distribution

ape_vyper-0.6.13-py3-none-any.whl (21.8 kB view details)

Uploaded Python 3

File details

Details for the file ape-vyper-0.6.13.tar.gz.

File metadata

  • Download URL: ape-vyper-0.6.13.tar.gz
  • Upload date:
  • Size: 46.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.13

File hashes

Hashes for ape-vyper-0.6.13.tar.gz
Algorithm Hash digest
SHA256 83bae06b9127574b6bf24a10cacdbac09a37b278c8a02b8f77fdc1367006ccf0
MD5 3579e12d21886a36c6f58fbb90183419
BLAKE2b-256 01b63576707b4a3be6678a95405d99f9f0d6b66ece1061f5e7ec754e598e39fb

See more details on using hashes here.

File details

Details for the file ape_vyper-0.6.13-py3-none-any.whl.

File metadata

  • Download URL: ape_vyper-0.6.13-py3-none-any.whl
  • Upload date:
  • Size: 21.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.13

File hashes

Hashes for ape_vyper-0.6.13-py3-none-any.whl
Algorithm Hash digest
SHA256 98c46183b978cd308983f476dfb0465da1fec75194e90c9decb3c064a6c7b0e7
MD5 c0368eb38b704953dbcf19d2e2547c50
BLAKE2b-256 bf1f6a36e90a620c62a39640427d12b690c99eda891ac06922e42fd5eb6bfd1a

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