Skip to content

EPIC v0.2.0-beta.0

Latest
Latest

Choose a tag to compare

View all tags
@akxh5 akxh5 released this 30 Jun 06:13
· 16 commits to main since this release
v0.2.0-beta.0
14263d4

EPIC v0.2.0-beta.0

This release marks the first public beta of EPIC: Upgrade Intelligence for Solana.
EPIC acts as a deployment safety layer, answering a single, critical question before you sign a migration transaction: "Can I safely deploy this?"

Highlights

  • Account Compatibility Engine: Complete simulation of byte shifts, structural alterations, and serialization drifts across Anchor layouts.
  • First-class GitHub Action Integration: Natively embeds into CI/CD pipelines to block PRs that would break on-chain state.
  • Prebuilt Cross-Platform Binaries: The Rust-based parser is now bundled into the NPM CLI via optional dependencies for seamless installation across macOS, Linux, and Windows.
  • Intelligent Upgrades Intelligence: Classification of changes into SAFE, MIGRATION REQUIRED, and BLOCKED states with explicit remediation plans.

What's New

CLI

  • Re-architected as a thin integration and rendering wrapper (@solana-epic/cli).
  • Improved, human-readable terminal rendering.
  • New --format json and --format sarif outputs for programmatic consumption.
  • epic doctor safely checks host dependencies.

Parser (@solana-epic/parser)

  • A full rewriting of the AST engine in Rust to support recursive nested struct resolution.
  • Resolves Rust structs with lifetimes, generics, and complex attribute macros.
  • Advanced memory layout mapping logic specifically designed for Anchor's padding and discriminator offsets.

Diff Engine (@solana-epic/diff-engine)

  • Tracks precise byte insertions, removals, and dynamic sizing behavior (Vec, String).
  • Enforces explicit semantic rules matching Solana deployment mechanics (e.g., rejecting mid-struct field insertions).
  • Maps layout drift against security policies defined in epic.toml.

GitHub Action (@solana-epic/github-action)

  • Extracted from a monolithic implementation into a clean execution orchestrator.
  • Submits PR comments using GITHUB_STEP_SUMMARY.
  • Fully supports GitHub Advanced Security via formal SARIF v2.1.0 report generation.

Testing & Confidence

  • Extensive historical benchmarks on real-world Solana upgrades (Kamino, Marginfi, Drift, etc.).
  • Automated cross-architecture distribution testing.
  • Total test coverage of exact on-disk serialization failures.

Known Limitations

  • Advanced tracking of PDA derivation logic is not yet fully stabilized.
  • Dynamic Vec reallocation limits are approximated when parsing non-static arrays.

Installation

npm install -g @solana-epic/cli@0.2.0-beta.0

Roadmap

  • v0.3.0: Dynamic resizing bounds checking and PDA validation.
  • v0.4.0: Automated zero-downtime migration scaffolding.
  • v1.0.0: Stable release.
Assets 2
Loading