hyper-vyper

Build Vyper contracts on HyperEVM that read and write to HyperCore.

hyper-vyper gives your HyperEVM contracts one typed interface to HyperCore, so you can work on your protocol instead of byte layouts and decimal conversions:

• Read Core state: balances, perp positions, prices, and token and market metadata.
• Send CoreWriter actions: orders, cancels, transfers, staking, vault moves and account settings.
• Bridge assets (USDC, HYPE and linked ERC-20 tokens) between HyperEVM and HyperCore, with the decimal conversions done for you.
• Test without a testnet: hyper_vyper.testing adds a HyperCore simulator to your Titanoboa tests.

The library has no state and nothing to deploy. It is a Vyper port of the Solidity hyper-evm-lib, and its tests check that both libraries behave the same.

hyper-vyper is open source under the MIT license and maintained by CrowdCent.

Unaudited. This library is provided as is. Read security before you use it with funds.

from hyper_vyper import constants
from hyper_vyper import precompiles

@external
@view
def core_usdc_balance(user: address) -> uint64:
    return precompiles.spot_balance(user, constants.USDC_TOKEN_INDEX).total

Installation

hyper-vyper is a Python package of Vyper modules. Vyper finds them on the Python path, so you don't need a -p option.

uv add hyper-vyper        # or: pip install hyper-vyper

The package pins Vyper 0.4.3 exactly. Every module has # pragma version 0.4.3, and the library is tested only on 0.4.3. Use the Cancun EVM version.

The testing extra adds hyper_vyper.testing, a HyperCore simulator for Titanoboa tests (uv add --dev "hyper-vyper[testing]"):

from hyper_vyper.testing import CoreSim, Policy

See install and quick start, which also covers Moccasin, and the testing quick start.

Documentation

The documentation site is at crowdcent.github.io/hyper-vyper.

• Concepts: HyperEVM and HyperCore, asynchronous actions, units
• Tutorials: five testnet tutorials, each with a contract and a script
• Testing: test your contracts with the HyperCore simulator
• Modules: each module explained with its source code
• API
• Solidity compatibility
• Security

To preview the docs site locally, see contributing.

Development

uv sync --locked
uv run --locked hyper-vyper-check-source src examples tutorials
uv run --locked pytest

See repository tests and contributing. examples/ holds example contracts, and tutorials/ holds the tutorial contracts and scripts. Report security problems as described in SECURITY.md.

Acknowledgements

• hyper-evm-lib by hyperliquid-dev, the Solidity library that hyper-vyper ports.
• The Hyperliquid documentation on HyperEVM, HyperCore and CoreWriter.
• The Circle documentation on USDC and the CoreDepositWallet on HyperCore.

License

MIT. The Solidity reference sources in tests/reference/ keep their own MIT licenses.