Merge pull request w3f#49 from davxy/master

Author: gavofyork

.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI Workflow
+
+on:
+  # Run CI on push only for 'main' branch
+  push:
+    branches: [master]
+    tags:
+      - "v*"
+  # Run CI on pull request for all branches
+  pull_request:
+    branches: ["**"]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        validator:
+          - codec
+          - erasure
+          - traces
+          - stf/accumulate
+          - stf/assurances
+          - stf/authorizations
+          - stf/disputes
+          - stf/history
+          - stf/preimages
+          - stf/reports
+          - stf/safrole
+          - stf/statistics
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.8'
+      - name: Install dependencies
+        run: |
+          pip install git+https://github.com/davxy/asn1tools.git
+      - name: Validate ${{ matrix.validator }}
+        run: ./${{ matrix.validator }}/validate.py
+

CHANGELOG.md

@@ -0,0 +1,28 @@
+## v0.6.6 [25-06-2025]
+
+### Changes
+
+- Codebase reorganization
+- Binary to JSON conversion scripts and utilities
+* Extended the `fetch` host call with new variants.
+* Updated numeric identifiers used in `fetch`.
+* Updated numeric identifiers for PVM errors.
+* PVM wrangled operands changed.
+* Removed the traces `000...000.bin/json` step, as it was not a valid trace step and was intended to be handled specially for genesis. Since it shared the same format as regular trace steps, it could be ambiguous or misleading. 
+* Introduced an explicit `genesis.bin` file containing the genesis state and header.
+* The *authorizer trace* field has been moved to the end of the accumulation operand encoding  (C.29)
+
+### Deviations
+
+* `fetch` host call for protocol parameters ($\omega_{10}=0$) has been implemented according to this (currently) unreleased change: https://github.com/gavofyork/graypaper/pull/414
+For the `fetch` hostcall id we're still using 18 as per GP 0.6.6. The picked change only concerns the value returned for w_10=0
+
+### Extra
+
+* Codebase reorganization
+* Binary to JSON conversion scripts and utilities
+* CI: ASN.1 verification
+
+## v0.6.5 [02-06-2025]
+
+- First Release

README.md

@@ -1,11 +1,13 @@
 # Test Vectors for the JAM Protocol
 
-JAM protocol version 0.6.4
-
 ## Codec
 
 - [Codec](./codec/README.md)
 
+## Erasure Coding
+
+- [Erasure Coding](./erasure/README.md)
+
 ## State Transition Functions
 
 We offer two types of test vectors:
@@ -24,6 +26,8 @@ We offer two types of test vectors:
   - core assignment rotation period: 10
   - ticket attempts: 2
 
+For more information refer to the community [docs](https://docs.jamcha.in/basics/chain-spec).
+
 ### STF Output
 
 Technically, the STF execution process does not inherently produce auxiliary
@@ -40,12 +44,37 @@ specific subsystem.
 
 ### Vectors
 
-- [Safrole](./safrole/README.md)
-- [Disputes](./disputes/README.md)
-- [History](./history/README.md)
-- [Assurances](./assurances/README.md)
-- [Reports](./reports/README.md)
-- [Statistics](./statistics/README.md)
-- [Authorizations](./authorizations/README.md)
-- [Preimages](./preimages/README.md)
-- [Accumulate](./accumulate/README.md)
+- [Safrole](./stf/safrole/README.md)
+- [Disputes](./stf/disputes/README.md)
+- [History](./stf/history/README.md)
+- [Assurances](./stf/assurances/README.md)
+- [Reports](./stf/reports/README.md)
+- [Statistics](./stf/statistics/README.md)
+- [Authorizations](./stf/authorizations/README.md)
+- [Preimages](./stf/preimages/README.md)
+- [Accumulate](./stf/accumulate/README.md)
+
+## Block Import Traces
+
+- [Fallback](./traces/fallback): fallback block authoring, no-safrole, no-work-reports
+- [Safrole](./traces/safrole): safrole block authoring, no-work-reports
+- [Work Reports L0](./traces/reports-l0): basic work reports, no-safrole
+
+## Vectors Validation
+
+Validation scripts are included to verify the JSON files against the expected
+ASN.1 syntax provided with the test vectors. These scripts currently rely on my
+[asn1tools](https://github.com/davxy/asn1tools) fork.
+
+## Binary To JSON
+
+The repository binary test vector files can be converted to their JSON
+equivalents for easier inspection and debugging. Use the provided conversion
+script to transform binary files into human-readable JSON format:
+
+```bash
+./scripts/convert-all.sh
+```
+
+This conversion script requires the [jam-types](https://github.com/davxy/jam-types)
+Python library to be installed.