Skip to content

Add exhaustive Solidity contract interaction atlas - #628

Open
KillariDev wants to merge 12 commits into
mainfrom
t3code/full-contract-chart
Open

Add exhaustive Solidity contract interaction atlas#628
KillariDev wants to merge 12 commits into
mainfrom
t3code/full-contract-chart

Conversation

@KillariDev

@KillariDev KillariDev commented Jul 29, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • keep the compact Contract Interaction Map at exactly 12 primary components and 19 interactions
  • add a separate exhaustive Contract Atlas with all 117 Solidity declarations plus two type-only modules, split across six Zoltar, Statoblast, infrastructure/OpenOracle, and test regions
  • preserve 394 exact relationship meanings across 376 ordered source-target routes, including 18 routes with two relationship types
  • reduce line overlap with stable focused layers, endpoint fan-out, repeated test target gateways, secondary-route de-emphasis, and a plot-only scroller
  • expose Protocol flow (96), Type structure (105), Source references (144), Test exercise (40), and All routes (376) without moving or removing components
  • use compiler ASTs to promote contract/interface calls, ordinary low-level encoded Solidity and assembly calls, library calls/constants, using for directives, and test-helper calls out of the generic source-reference layer while excluding selector-only and delegatecall payload references
  • mechanically reconcile declarations, references, inheritance, deployments, delegatecalls, behavioral calls/uses, and test evidence against current Solidity sources

Screenshots

Before: every route overlaid

Dense all-routes atlas before focused layers and gateway routing

After: focused Protocol flow

Exhaustive Contract Atlas focused Protocol flow at 1440 by 900

Type structure

Exhaustive Contract Atlas Type structure layer at 1440 by 900

Test exercise with repeated target gateways

Test-only contracts routed into seven repeated production target groups

Narrow viewport

Relationship-layer controls at 390 by 844 Locally scrollable Protocol chart at 390 by 844

Exact component inventory

Expanded 119-component inventory

Exact relationship register

Expanded 394-relationship register

All 376 routes completeness view

All relationship layers enabled at 1440 by 900

Screenshots are hosted on Sharey with a 90-day expiry.

Validation

  • bun run docs:build-charts
  • bun run docs:check-charts
  • bun run tsc
  • bun run format:check
  • bun run check
  • bun run knip
  • Chromium/ChromeDriver QA at exact 1440×900 and 390×844 across the compact map, all five atlas layers, grayscale line patterns, local plot scrolling, stationary caption, test gateways, expanded inventory/register, and documentation reader
  • branch-current gate: 0 commits behind origin/main
  • git diff --check — pending as the required literal final command after commit, push, PR, and CI operations

Protocol/Solidity and UI application tests were skipped because this changes executable static-document chart/runtime/check tooling rather than protocol or application behavior. The implementation-linked chart checker, compiler-AST mutation probes, full repository checks, and browser QA cover the changed behavior.

Final documentation, visual, and repository review scores will be added after the remaining review gates complete.

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