[CORE] Implement Dynamic Reentrancy Guard with EIP-1153 Transient Support

[mijinummi]

Labels: high-difficulty, yul, security, gasguard
Difficulty: High
Module: contracts/security/

---

🧠 Concept

Develop an adaptive reentrancy guard module in Yul assembly that utilizes EIP-1153 transient storage (TSTORE/TLOAD) if supported by the EVM target, falling back to storage slot packing if transient storage is unavailable.

⚠️ Problem

Standard reentrancy guards write to storage slots (SSTORE), costing $2,100\text{--}5,000\text{ gas}$ per call, whereas transient storage locks cost only $100\text{ gas}$.

📁 Implementation Scope

• contracts/security/AdaptiveReentrancyGuard.sol
• test/security/AdaptiveReentrancyGuard.test.ts

🛠️ Requirements

1. Detect or feature-flag EIP-1153 transient opcode availability.
2. Implement low-level Yul locks using tstore(slot, 1) and tload(slot) for transient mode.
3. Fall back gracefully to sstore mode if transient storage is disabled.

🎯 Acceptance Criteria

• Executes reentrancy checks for under $200\text{ gas}$ in transient mode.
• Full protection against reentrant function invocations across both modes.

[brite-side0]

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

Hello maintainer,

I’m a Full Stack Blockchain, Mobile, and Software Engineer with experience building scalable and production ready applications.

I’ve reviewed this particular issue and understand its requirements. If assigned, I’ll begin work immediately, provide regular updates, and deliver a clean, well-tested, and maintainable solution that meets the project’s standards.

Looking forward to contributing.

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

[GiftedGiftB]

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

I can get this work done in less than 30 minutes.

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

[lightnoor890]

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

Kindly assign

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

[Cent-Dave]

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

Please assign me to this issue.

I am eligible to work on this issue because I have experience developing EVM smart contracts with Solidity, Yul assembly, and gas optimisation techniques, particularly for security-critical components. I understand the importance of implementing a reentrancy guard that takes advantage of EIP-1153 transient storage where available while preserving secure and deterministic behaviour on networks that do not support it. I can implement the adaptive guard in contracts/security/AdaptiveReentrancyGuard.sol, use low-level Yul to perform locking with TSTORE/TLOAD when transient storage is enabled, provide a robust fallback using packed storage slots when it is unavailable, ensure both execution paths offer equivalent protection against reentrant calls, add comprehensive tests covering transient mode, fallback mode, successful execution, reentrancy attempts, and edge cases, and verify the implementation satisfies the project's gas, security, and quality requirements while integrating cleanly with the existing architecture.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Cent-Dave 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.

[watz98]

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

Hi maintainer! I would love to help you with this issue. Given my theoretical knowledge and background, I am quite sure that I am well-equipped to tackle it. Please kindly assign it to me.

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

[khanavi272-spec]

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

I would like to work on this issue

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

[Adediwura-dev]

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

I can handle this efficiently if assigned to me

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

[AJ0070]

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

could you please assign?

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

[Oluwasuyi-Oluwatimilehin-Daniel]

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

Hello @maintainer, I’d like to work on this issue. I have experience handling similar tasks and can start immediately. And I will deliver at the shortest possible time.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwasuyi-Oluwatimilehin-Daniel to this issue.

[idrisososanwo]

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

Hi maintainer, I would like to work on this issue

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

[Dhivine-stack]

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

Hello! I've reviewed the issue and understand what's required. I have a clear plan for the implementation and will ensure the solution is maintainable, aligns with the project's standards, and satisfies the acceptance criteria. Kindly assign it to me.

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

[onajidavid87-web]

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

Hello, I’d love to work on this issue

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