Skip to content

docs: add design and phase plans for removing packages/contracts - #1372

Draft
Maikol wants to merge 22 commits into
mainfrom
docs/contracts-package-removal-spec
Draft

Maikol wants to merge 22 commits into
mainfrom
docs/contracts-package-removal-spec

Conversation

@Maikol

@Maikol Maikol commented Oct 22, 2026 •

Copy link
Copy Markdown
Member

Adds the design for removing packages/contracts and packages/contracts-test by moving each live contract to the package that owns it, and the implementation plan for each phase of that work. Plans are added here as each phase starts, so this PR is the single place for the docs; it has no code changes and is not meant to be merged.

@Maikol
Maikol marked this pull request as draft October 22, 2026 14:43
@Maikol
Maikol force-pushed the docs/contracts-package-removal-spec branch from 986f4e1 to 0b7bd28 Compare October 22, 2026 14:45
@codecov

codecov Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.47%. Comparing base (3c7ca93) to head (61448d2).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1372   +/-   ##
=======================================
  Coverage   91.47%   91.47%           
=======================================
  Files          81       81           
  Lines        5326     5326           
  Branches      973      973           
=======================================
  Hits         4872     4872           
  Misses        433      433           
  Partials       21       21           
Flag Coverage Δ
unittests 91.47% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@Maikol Maikol changed the title docs: add design and phase 0 plan for removing packages/contracts docs: add design and phase plans for removing packages/contracts Oct 26, 2026
Maikol added 17 commits October 27, 2026 10:48
Frozen contracts move unchanged to graph-core and graph-token; living
contracts (RewardsManager, L2GNS, L2Curation) are ported to 0.8 into
issuance and subgraph-service in a new Phase P. EpochManager goes to
graph-core, subgraph-discovery is removed, legacy keeps plain files,
and Ignition keeps only deploy:protocol on live artifacts.
P3 moves the frozen discovery contracts to graph-token, P4 moves
EpochManager to graph-core, P5 drops legacy's bytecode check and P6
simplifies Ignition. RewardsManager and Phase 2a move to the Phase P
plan.
Ports compile without viaIR, hotfixes may branch from the pre-port tag,
Pa is a major interfaces release, legacy keeps a source-hash check, and
the ignition-records-final tag waits for P5 to merge. The plan fixes the
P4 manifest order and restores the prepack, interfaces dependency and
clean-before-build edits.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant