mirror of https://github.com/OffchainLabs/prysm.git synced 2026-02-19 09:14:29 -05:00

Files

Justin Traglia 31f77567dd Add a README for specrefs (#16302 )

**What type of PR is this?**

Documentation

**What does this PR do? Why is it needed?**

This PR adds a basic README for the specrefs.


**Acknowledgements**

- [x] I have read
[CONTRIBUTING.md](https://github.com/prysmaticlabs/prysm/blob/develop/CONTRIBUTING.md).
- [x] I have included a uniquely named [changelog fragment
file](https://github.com/prysmaticlabs/prysm/blob/develop/CONTRIBUTING.md#maintaining-changelogmd).
- [x] I have added a description with sufficient context for reviewers
to understand this PR.
- [x] I have tested that my changes work as expected and I added a
testing plan to the PR description (if applicable).

2026-01-29 20:36:29 +00:00

.ethspecify.yml

Add missing fulu presets to beacon config (#16170 )

2026-01-23 15:20:22 +00:00

configs.yml

constants update for ethspecify phase 0 (#16273 )

2026-01-22 21:01:23 +00:00

constants.yml

update spectests (#16219 )

2026-01-07 16:48:50 +00:00

containers.yml

Update consensus spec tests to v1.6.0-beta.1 with new hashes and URL template (#15918 )

2025-10-22 18:22:19 +00:00

dataclasses.yml

Update Spectests to v1.7.0.alpha-1 (#16246 )

2026-01-11 12:54:01 +00:00

functions.yml

core: move EL requests to core/requests (#16280 )

2026-01-26 16:31:47 +00:00

presets.yml

Add missing fulu presets to beacon config (#16170 )

2026-01-23 15:20:22 +00:00

README.md

Add a README for specrefs (#16302 )

2026-01-29 20:36:29 +00:00

README.md

Specification References

This directory contains specification reference tracking files managed by ethspecify.

Installation

Install ethspecify with the following command:

pipx install ethspecify

Note

You can run ethspecify <cmd> in the specrefs directory or ethspecify <cmd> --path=specrefs from the project's root directory.

Maintenance

When adding support for a new specification version, follow these steps:

Change directory into the specrefs directory.
Update the version in .ethspecify.yml configuration.
Run ethspecify process to update/populate specrefs.
Run ethspecify check to check specrefs.
If there are errors, use the error message as a guide to fix the issue. If there are new specrefs with empty sources, implement/locate each item and update each specref source list. If you choose not to implement an item, add an exception to the appropriate section the the .ethspecify.yml configuration.
Repeat steps 3 and 4 until ethspecify check passes.
Run git diff to view updated specrefs. If an object/function/etc has changed, make the necessary updates to the implementation.
Lastly, in the project's root directory, run act -j check-specrefs to ensure everything is correct.