feat(examples): hall of fame

[leohhhn]

Description

Depends on #2584 for avlpager

Introduces the r/demo/hof realm.

The Hall of Fame is an exhibition that holds items. Users can add their realms to the Hall of Fame by importing the Hall of Fame realm and calling hof.Register() from their init function.

The realm is moderated and the registrations be paused at will.

Contributors' checklist...

• Added new tests, or not needed, or not feasible
• Provided an example (e.g. screenshot) to aid review or the PR is self-explanatory
• Updated the official documentation or not needed
• No breaking changes were made, or a BREAKING CHANGE: xxx message was included in the description
• Added references to related issues and PRs
• Provided any useful hints for running manual tests
• Added new benchmarks to generated graphs, if any. More info here.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 61.11%. Comparing base (5444859) to head (1cc0a9e).

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2842   +/-   ##
=======================================
  Coverage   61.10%   61.11%           
=======================================
  Files         564      564           
  Lines       75355    75351    -4     
=======================================
+ Hits        46045    46050    +5     
+ Misses      25946    25937    -9     
  Partials     3364     3364           

Flag	Coverage Δ
contribs/gnodev	60.65% <ø> (-0.82%)	⬇️
contribs/gnofaucet	15.31% <ø> (ø)
gnovm	66.17% <ø> (ø)
misc/genstd	80.54% <ø> (ø)
misc/logos	19.88% <ø> (ø)
tm2	62.03% <ø> (+0.04%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

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

[moul]

for this, you'll be able to use #2887

[moul]

Can you consider reviewing #2887 so we can use it in this PR?

[moul]

I think we should not panic about registration but instead return an error.

If someone has a conditional registration that can occur 0 or N times, it will brick their contract.

Additionally, when we add "upgradeable contracts," the init() function can be called multiple times.

I suggest returning an error but ignoring it from the caller by default, as we don't need to address it.

[leohhhn]

#2842 (comment)

What about this? :D

[moul]

I'm sorry if I initially said something wrong; I don't recall the context.

However, Register should not panic. Let's avoid returning anything and don't panic.

The goal is to ensure you're registered at launch without needing complex logic to check if you were already registered. It's similar to a "Set" or "Upsert" in other systems (can override with the same value), or sending a "wakeup" UDP packet where it doesn't matter if the system is already up and running.

[leohhhn]

8bcf672 & 3f35e68