Announcing ProtoTest: testing tool for Tezos protocol proposal developers

Nomadic Labs is pleased to announce the release of the ProtoTest v0.1, an experimental tool that enables Tezos protocol proposal developers to test their work locally by reusing existing test suites from the Tezos GitLab repository.

:backhand_index_pointing_right: https://gitlab.com/nomadic-labs/prototest

Context

This tool was developed in response to feedback from the Quebec Protocol Activation Survey, where several respondents emphasized the need for accessible tools to test protocol proposals and assess their impact on existing functionality.

What the tool does

The tool provides a dockerized environment that packages the necessary components of the Octez suite to test protocol proposals under development locally.

One can do that by:

  • Running existing protocol tests locally.

  • Modifying or extending these tests to match the changes introduced by their proposal.

  • Reusing test suites from any version of the Tezos protocol as a baseline for validation.

Hardware Requirements

The hardware requirements are the same as those for building Tezos from sources.

For more information, please refer to the dedicated section in the tezos documentation.

Software Prerequisites

  • Docker

Installation Instructions

Please refer to the README.md file in the ProtoTest repository for detailed instructions.

Note that some explanations are also available in the Octez documentation here: How to Test a Protocol Proposal. They give the general context of protocol test suites and the main use cases to run them using ProtoTest.

Experimental status

This is an experimental v0.1 release, shared to gather early feedback from the community.
We encourage developers to try it, report issues, and suggest improvements directly in the repository.

Happy testing!

2 Likes