chore: convert examples to OpenAPI v3-compliant Example Object format

[simone-stacks]

Description

Examples were not rendering correctly in some API documentation viewers (e.g., VSCode OpenAPI preview). The previous example: $ref: pattern is v2-style and not properly supported in OpenAPI v3.x.

This PR:

• Restructured all 31 OpenAPI example files to use proper Example Object format
• Converted externalValue references to $ref pattern with Example Objects
• Ensures OpenAPI v3.1 specification compliance

Applicable issues

• fixes RPC OpenApi example rendering issue #6723

Checklist

• Test coverage for new or modified code paths
• Changelog is updated
• Required documentation changes (e.g., docs/rpc/openapi.yaml and rpc-endpoints.md for v2 endpoints, event-dispatcher.md for new events)
• New clarity functions have corresponding PR in clarity-benchmarking repo

[federico-stacks]

LGMT!

Made some tests and I can confirm that the rendering issue reported in the referenced ticket seems to be solved.

[francesco-stacks]

lgtm!

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.33%. Comparing base (ef4a697) to head (2eab23c).
⚠️ Report is 11 commits behind head on develop.

❌ Your project status has failed because the head coverage (74.33%) is below the target coverage (80.00%). You can increase the head coverage or adjust the target coverage.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #6768      +/-   ##
===========================================
+ Coverage    68.86%   74.33%   +5.47%     
===========================================
  Files          586      586              
  Lines       361650   361650              
===========================================
+ Hits        249053   268845   +19792     
+ Misses      112597    92805   -19792     

see 292 files with indirect coverage changes

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update ef4a697...2eab23c. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.