[Admin Core] Implement parameter validation for grant_role(role)

[p3ris0n]

Epic: RBAC Implementation (Wave 2)
Bucket: Admin Core

📝 Description

Validate role inputs.

🛠️ Implementation Guide

1. Check role bounds (non-zero).
2. Ensure it's a valid bitmask.
3. Revert with InvalidRole if bad input.

✅ Acceptance Criteria

• Code compiles and adheres to Soroban/Rust/TypeScript best practices.
• Unit tests cover both happy paths and expected error states.
• All CI/CD pipelines pass successfully.

[iyanukid2008-pixel]

@iyanukid2008-pixel has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I'd love to work on this issue. I'll keep the implementation simple, clean, and well-tested.

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

[TochukwuJustice]

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

Hi I would like to contribute to this issue. I’m a blockchain and backend developer with experience in Solidity, TypeScript, and Node.js, specializing in secure smart contract development and scalable backend systems. I focus on writing reliable, well-structured code and building efficient integrations for blockchain-based applications.

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

[harryjupiter148]

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

Hello, Maintainer. Please, permit me to work on this issue.

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

[teethaking]

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

Hey Maintainer,
I'll implement input parameter validation for grant_role(role) to reject invalid role bitmasks before executing storage updates.
Solution Steps

• Validation Function: Create a role bitmask validator helper in contracts/.../src/lib.rs that verifies:
  • The role is non-zero (role != 0).
  • The role is a single valid bitmask flag (or valid flag combination) using power-of-two / bitwise check ((role & (role - 1)) == 0 for single roles, or checking against defined VALID_ROLES_MASK).
• Enforce in grant_role: Invoke the validator at the top of grant_role. If validation fails, early revert with Error::InvalidRole.
• Unit Tests: Add test cases in contracts/.../src/test.rs covering:
  • Attempting to grant a zero role (0), asserting InvalidRole.
  • Passing invalid bitmask values outside defined bounds, asserting InvalidRole.
  • Happy path passing valid role masks (ROLE_ADMIN, ROLE_OPERATOR).
• Verification: Run cargo test and cargo clippy to ensure all edge cases pass and CI checks remain green.

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

[bamiebot-maker]

@bamiebot-maker has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi team! I'm ready to tackle this task. My technical background aligns well with this issue, and I can have a clean, tested Pull Request ready for review within your expected timeframe. Please let me assign me so I can begin

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

[nekwasar]

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

HI maintainer, i am a full stack developer with expperience can i work on this issue??

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

[drips-wave]

Congratulations, @nekwasar! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

🧑‍💻 @nekwasar: 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 🌊

[drips-wave]

This issue has been completed by @nekwasar as part of the Stellar Wave Program's 8th Wave 🥳

😎 @nekwasar: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.