chore: experimental render proxy example for versioned realms

[jeronimoalbi]

This example shows how proxying render calls can be used to allow updating realms to new versions while keeping the same realm path. The idea is to have a simple "parent" realm that only keeps track of the latest realm version and forwards all render calls to it.

[Gno2D2]

🛠 PR Checks Summary

All Automated Checks passed. ✅

Manual Checks (for Reviewers):

• IGNORE the bot requirements for this PR (force green CI check)

Read More

🤖 This bot helps streamline PR reviews by verifying automated checks and providing guidance for contributors and reviewers.

✅ Automated Checks (for Contributors):

No automated checks match this pull request.

☑️ Contributor Actions:

1. Fix any issues flagged by automated checks.
2. Follow the Contributor Checklist to ensure your PR is ready for review.
   • Add new tests, or document why they are unnecessary.
   • Provide clear examples/screenshots, if necessary.
   • Update documentation, if required.
   • Ensure no breaking changes, or include BREAKING CHANGE notes.
   • Link related issues/PRs, where applicable.

☑️ Reviewer Actions:

1. Complete manual checks for the PR, including the guidelines and additional checks if applicable.

📚 Resources:

• Report a bug with the bot.
• View the bot’s configuration file.

Debug

Manual Checks

**IGNORE** the bot requirements for this PR (force green CI check)

If

🟢 Condition met
└── 🟢 On every pull request

Can be checked by

• Any user with comment edit permission

[jeronimoalbi]

@moul this is the simple pattern that we are using for Gno.me to be able to support multiple realm versions while keeping the same URL for rendering content.

Instead of merging this example we could have a couple of tutorials in Gno.me explaining different patterns to version realms. The patterns could be the ones that you wrote plus this one.

cc @leohhhn @michelleellen @wyhaines

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

📢 Thoughts on this report? Let us know!

[jeronimoalbi]

@leohhhn there is a test failing but is not related to these changes, as far as I can see.
Do you know what might be the issue?

It seems a package name is missing somewhere.

[thehowl]

This looks good by itself, though I'm beginning to think that maybe we should move all x/ realms into simple realms in personal namespaces.

[jeronimoalbi]

This looks good by itself, though I'm beginning to think that maybe we should move all x/ realms into simple realms in personal namespaces.

It would make sense

[thehowl]

This a push and pray because the CI is selective, but merging this and creating an issue.