All notable changes to this project are documented here. The format is based on
Keep a Changelog, and the project aims to
follow Semantic Versioning once it reaches
1.0.0. While in 0.x, minor versions may include breaking changes.
Universal hardening pass: proxy/diamond resolution, more token & governance shapes, admin evidence in the UI, and a live-demo “load your contract” flow.
- EIP-2535 diamond support: loupe
facetAddresses()detection, per-facet ABI fetch + selector-deduped merge; diamond address stays the call target;diamondCutlabelled upgrade/critical. - Governor Bravo/Alpha shape detector (Compound-style propose/queue/execute), disjoint from OpenZeppelin Governor.
- DAI-style permit, ERC-777, rebasing / share-based tokens, and a fee-on-transfer advisory (fee-exclusion admin surface + Overview warning).
- ERC-1155 nuances: Supply / Burnable / mintBatch semantics.
- NatSpec + body-level access detection, PermissionBadge, tx Preview /
dry-run, proxy implementation override, Aragon ERC-897 +
*Delegatorproxy shapes, event-based corroboration. - Live demo: “Load your contract” (address or paste ABI) on GitHub Pages.
- Real-contract corpus harness (incl. source-backed DAI/BAYC rows).
- Risk heuristic:
payableis a medium floor, not an override of user routing. - Signature-aware
mint/withdrawheuristics to cut false admin labels.
First npm release: all nine @semantic-dapp/* packages published under the scope,
plus new user-facing panels.
- Governor proposal-builder & board: a
GovernorPanelwith Propose / Vote tabs and aProposalBoardthat tracks proposals by id with livestate, proposer, vote-start/end andhasVotedfor the connected account. - ERC-721 gallery:
NftGallery+Erc721Actionslist the connected owner's tokens, inspect any token id, resolvetokenURImetadata (ipfs/data/http), and transfer owned tokens inline (safeTransferFrom). - ERC-1155 batch panel, ERC-4626 vault panel, ERC-2612 permit detector and decimals-aware amount widgets.
- npm publishing:
publishConfig.access=public, repo metadata andrelease/release:dryscripts on every package; OIDC trusted-publishing workflow (.github/workflows/release.yml) anddocs/RELEASING.md.
0.1.0-beta - 2026-07-19
First public beta: the full pipeline from a contract to a shippable dApp, proven on production-like fixtures.
- Address resolver (Phase 2): import by chain + address via block explorer (Etherscan v2) and Sourcify, with EIP-1967 proxy detection and implementation binding.
- Semantic manifest (Phase 3): a versioned, machine-readable manifest as the
layer between analysis and UI, with migrations, staleness detection and
mergeReviewedto preserve human edits across re-analysis. - Standards analyzer (Phase 4): member-based detection for ERC-721/1155/4626 and access models (Ownable, AccessControl, Pausable, Upgradeable) with confidence scoring and evidence.
- Classification & routing (Phase 5): a priority rule engine that routes every function to a semantic operation, audience and risk - never dropping a function.
- Trusted UI components (Phase 6): purpose-built Overview, Pause and Role
Manager consoles and a
ConfirmDialoggating high/critical writes (critical actions require typingCONFIRM). - Safety & diagnostics (Phase 7): text sanitization (
sanitizeText/SafeTextstrip bidi/zero-width/control chars, flag homoglyphs), preflight write warnings, and a local, exportable execution history (audit trail). - Export & CLI (Phase 8): a portable
SemanticBundle(identity + ABI + reviewed manifest), a one-click studio export, a standalonegenerated-apptemplate that renders any bundle analyzer-free, and asemantic-dappCLI (bundle/export/serve). - Fixtures, demos & beta (Phase 9):
MockVault(ERC-4626) andMockRWA(roles + pause) Foundry fixtures with tests; analyzer/classifier tests driven by the real compiled ABIs; three committed demo bundles (ERC-20, vault, RWA) and a demos guide; an@axe-core/playwrightaccessibility gate on the standalone app; and CI jobs for the Solidity fixtures and the standalone e2e.
- Bumped all workspace packages to
0.1.0-beta. - Raised UI text contrast (audience/risk/emergency badges, connect button) to meet WCAG AA.
- ADR-002 … ADR-010 covering resolver, manifest, standards, classification, trusted UI, safety, export, and fixtures/release decisions.
0.0.1 - 2026-07-19
- Foundation (Phase 0): pnpm + Turborepo monorepo, TypeScript strict, ESLint / Prettier, CI, and the initial package layout.
- Raw ABI runtime vertical slice (Phase 1): manual ABI/artifact import → normalized contract model → first ERC-20 detector → generated User/Admin/Raw UI → wallet read/write against Anvil, with local project persistence.