[CORE] Build Plugin Architecture for Custom Community GasGuard Rules

[mijinummi]

Labels: high-difficulty, rust, architecture, cli, gasguard
Difficulty: High
Module: gasguard-cli/src/plugins/

---

🧠 Concept

Design and build a dynamic plugin architecture for the GasGuard CLI that enables third-party developers to write and load custom static analysis gas rules compiled to WebAssembly (WASM).

⚠️ Problem

Adding new domain-specific gas rules currently requires modifying core GasGuard CLI Rust source files and recompiling the entire binary.

📁 Implementation Scope

• gasguard-cli/src/plugins/engine.rs
• gasguard-cli/src/plugins/wasm_runtime.rs
• docs/PLUGIN_DEVELOPMENT_GUIDE.md

🛠️ Requirements

1. Integrate a WASM runtime (e.g., wasmer or wasmtime) into the GasGuard CLI executable.
2. Expose contract AST node query interfaces to WASM guest plugins.
3. Allow users to load external rule plugins via configuration (gasguard analyze --plugin ./custom_rule.wasm).

🎯 Acceptance Criteria

• CLI successfully loads and executes custom WASM static analysis rules at runtime.
• Plugin API provides complete access to contract AST structures for gas vulnerability detection.

[mysterioustech]

@mysterioustech has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hello maintainer, I’d like to claim this issue and will submit a PR once finished

ℹ️ Repo Maintainers: To accept this application, review their application or assign @mysterioustech to this issue.

[tecmalik]

@tecmalik has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

please assign this issue to me i would love to work on it

ℹ️ Repo Maintainers: To accept this application, review their application or assign @tecmalik to this issue.

[amberly-d]

@amberly-d has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

can i solve this?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @amberly-d to this issue.

[Halimatyemisi]

@Halimatyemisi has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi Maintainer! I’m interested in contributing to this task and can ensure timely delivery with clean implementation. I’ve thoroughly read the issue description and understand the expected outcome. I’d love to work on it. Thank You!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Halimatyemisi to this issue.

[paulpeter32-coder]

@paulpeter32-coder has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainer I'm a fullstack developer and I would love to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @paulpeter32-coder to this issue.

[drips-wave]

Congratulations, @amberly-d! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @amberly-d: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊