starknet role discovery script

[remollemo]

Note

Low Risk
Additive Python utility plus tests; main risk is incorrect role/event parsing or fallback behavior against diverse RPC providers, but it does not modify existing production paths.

Overview
Adds a standalone/importable python/utils/role_discovery.py utility to discover current (or historical) CommonRoles role holders on Starknet by scanning RoleGranted events and optionally verifying membership via has_role.

Includes robustness fallbacks: supports multiple event layouts, falls back to raw getEvents RPC when starknet_py event validation fails, and switches to legacy is_<role> entrypoints when has_role is missing. Adds pytest coverage for these fallback paths and a small python/utils/requirements.txt for running the script/tests.

^{Written by Cursor Bugbot for commit ddec176. This will update automatically on new commits. Configure here.}

---

This change is 

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (main@8f41888). Learn more about missing BASE report.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #162   +/-   ##
=======================================
  Coverage        ?   94.69%           
=======================================
  Files           ?       57           
  Lines           ?     3993           
  Branches        ?        0           
=======================================
  Hits            ?     3781           
  Misses          ?      212           
  Partials        ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

[RoeeGross]

python/utils/role_discovery.py line 64 at r2 (raw file):

# Each is keccak256("ROLE_<NAME>") & MASK_250.
ROLE_IDS: Dict[RoleName, int] = {
    RoleName.AppGovernor: 0xD2EAD78C620E94B02D0A996E99298C59DDCCFA1D8A0149080AC3A20DE06068,

Consider locating these constants in a different file

[RoeeGross]

python/utils/role_discovery.py line 93 at r2 (raw file):

}

RPCS = {

considier remove

[RoeeGross]

@RoeeGross reviewed 3 files and all commit messages.
Reviewable status: all files reviewed, 3 unresolved discussions (waiting on remollemo).

[RoeeGross]

Reviewable status: all files reviewed, 3 unresolved discussions (waiting on remollemo).

[remollemo]

@remollemo resolved 2 discussions.
Reviewable status: 2 of 3 files reviewed, all discussions resolved (waiting on RoeeGross).