Understand the project
Practical overview
When it fits
Use Moccasin when your smart-contract work targets Vyper and you want a CLI framework for development and testing tasks in a Python-based workflow.
Who it is for
- Developers building Vyper smart contracts with a Python-oriented workflow.
- Teams seeking CLI commands for contract project setup, compilation, testing and scripts.
Documented uses
- Initialize a Moccasin project.
- Compile contracts and run project tests.
- Run scripts in a project's context.
- Install project dependencies and inspect contract compiler data.
Before you choose
Requirements & limits
- Moccasin is built on Titanoboa and offers a Python-oriented workflow.
- The README lists named contracts, custom pytest staging markers, encrypted-wallet support, dependency installation, and built-in ZKsync support.
- The README identifies the tool as beta and specifically labels its Python-shell console command beta.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Source-based practical guide
Install the Moccasin CLI and view its commands
Install the mox command with uv and inspect the CLI help.
Before you start
- The uv tool.
Steps
Run the command below.
uv tool install moccasinRun
mox --helpto display the available commands.
Expected outcome
Moccasin's CLI is installed and its command list is displayed.
Guide limitations
- This quickstart covers installation and command discovery, not execution of a contract development or testing workflow.
- The README labels Moccasin beta and advises using it at your own risk.
Evidence and transparency
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- Cyfrin/moccasin · Official homepage title · retained in its source language