feat: add FOMO3D game implementation #3344

stefann-01 · 2024-12-16T12:59:20Z

Description

This PR introduces FOMO3D, a blockchain-based game that combines lottery and investment mechanics, implemented as a Gno realm. The game creates an engaging economic model where players compete to be the last key purchaser while earning dividends from subsequent purchases.

Key Features

Players purchase keys using GNOT tokens
Each key purchase:
- Extends the game timer
- Increases key price by 1%
- Makes buyer potential jackpot winner
- Distributes dividends to existing key holders
Automatic prize distribution:
- 47% to jackpot (winner)
- 28% as dividends to key holders
- 20% to next round's starting pot
- 5% as a fee to the contract owner
Full test coverage

Technical Implementation

Utilizes AVL tree for player data storage
Implements dividend distribution system
Includes comprehensive test suite
Features markdown-formatted render functions for game state visualization
Mints a unique FOMO3D NFT to the winner of each round

How to Use

Start game with StartGame()
Purchase keys with BuyKeys()
Claim dividends with ClaimDividends()
View game status via render functions
Winner automatically receives jackpot when timer expires

Testing

All core functionalities are covered by unit tests including:

Full game flow
Key purchasing mechanics
Dividend distribution
Game ending conditions

Inspired by the original Ethereum FOMO3D game but rebuilt for the Gno platform.

Note

The test checks will not pass until gnolang/gno#3495 is merged. In case this PR is not approved, I will refactor the NFT feature accordingly.

- reduce min_key_price

Gno2D2 · 2024-12-16T13:00:37Z

🛠 PR Checks Summary

All Automated Checks passed. ✅

Manual Checks (for Reviewers):

IGNORE the bot requirements for this PR (force green CI check)
The pull request description provides enough details

✅ Automated Checks (for Contributors):

🟢 Maintainers must be able to edit this pull request (more info)
🟢 Pending initial approval by a review team member, or review from tech-staff

☑️ Contributor Actions:

Fix any issues flagged by automated checks.
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:

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

📚 Resources:

Debug

Automated Checks

Maintainers must be able to edit this pull request (more info)

If

🟢 Condition met
└── 🟢 The pull request was created from a fork (head branch repo: stefann-01/gno)

Then

🟢 Requirement satisfied
└── 🟢 Maintainer can modify this pull request

Pending initial approval by a review team member, or review from tech-staff

If

🟢 Condition met
└── 🟢 Not (🔴 Pull request author is a member of the team: tech-staff)

Then

🟢 Requirement satisfied
└── 🟢 If
    ├── 🟢 Condition
    │   └── 🟢 Or
    │       ├── 🟢 At least 1 user(s) of the organization reviewed the pull request (with state "APPROVED")
    │       ├── 🔴 At least 1 user(s) of the team tech-staff reviewed pull request
    │       └── 🔴 This pull request is a draft
    └── 🟢 Then
        └── 🟢 Not (🔴 This label is applied to pull request: review/triage-pending)

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
The pull request description provides enough details
If
🟢 Condition met
└── 🟢 And
    ├── 🟢 Not (🔴 Pull request author is a member of the team: core-contributors)
    └── 🟢 Not (🔴 Pull request author is user: dependabot[bot])
Can be checked by

team core-contributors

codecov · 2024-12-16T13:02:06Z

Codecov Report

All modified and coverable lines are covered by tests ✅

📢 Thoughts on this report? Let us know!

- Add 5% owner fee (47% jackpot, 28% dividends) - Improve error handling - Update UI with better organization & emojis - Add ownership tests & update test coverage - Register realm to Hall of Realms

leohhhn · 2024-12-19T15:07:46Z

examples/gno.land/r/stefann/fomo3d/fomo3d.gno

+}
+
+// GetGameState returns current game state
+func GetGameState() (int64, int64, int64, std.Address, int64, int64, int64, bool) {


Might make sense to pack these into a struct, wdyt?

Is this what you had in mind? 059917e

Figured out the best way to handle this, made TODO comments in 4a5435f.
Current solution works fine for now, will be improving this some time in future.

- add test for Ownership

- remove redundant TransferOwnership func

- use PrevRealm() - format

stefann-01 · 2025-01-22T02:48:27Z

On top of this, register to the hall of fame :)

I did, it's in init(). I also added a small section in Render to encourage upvotes :)

…g#3569) This PR aims to improve the HTML composability of gnoweb and avoid DRY issues across templates and layouts. The changes include: - Refactoring HTML components for better reusability. - Reducing code duplication in views. - Removing static data from the layout - Enhancing code maintainability and readability. --------- Signed-off-by: gfanton <[email protected]> Co-authored-by: gfanton <[email protected]>

This pull request is for : - remove `require` statement from official documentation [gnolang#3123](gnolang#3123) - add an example that was `//TODO` in the `effective-gno / Documentation is for users` section

…olang#3557) This will make it so that on master, there is only 1 job of releaser-master executing at a time. There may be another pending one (if, say, we merge two PRs back to back), and it will be put as `pending`. It's cancelled if we merge a third PR while the second one is still `pending`. For more information: https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#concurrency

@moul

## Description To make contracts more simpler(and low computation for execution), it is better for contract to manipulate with only `std.Address` rather than using `users.AddressOrName` and resolving it. ([Discussed with @moul](gnoswap-labs/gnoswap#465 (comment))) Clients such as gnoeky, gnoweb or adena should perform look up(convert username to address) and pass address value to contract.

## Description Fixes txtar that needed to be in gnolang#3580 Should've been caught by CI, wasn't --------- Co-authored-by: Morgan Bazalgette <[email protected]>

…iew (gnolang#3574) After a first day of experimentation, we determined we don't want the triage-pending label on PRs that have already received a review from a tech-staff member. Some additional changes: - Split between `ApprovalBy` and `ReviewBy` in reviewer.go, to distinguish between the requirements that only work with an approval and those that are more generic. - Don't request a team review if a member of the team already reviewed or is requested for review. (The bot was nagging a bit on some PRs because of this)

Depends on gnolang#3323 - add test in `examples/no_cycles_test.go` to detect import cycles in stdlibs and examples - add `matchString` native injection in the `testing` stdlib to avoid a cycle in `regexp` tests - remove other import cycles Go never allows import cycles. Our stdlibs have a lot of import cycles, and some examples import self which is not allowed in golang either. Keeping support for import cycles in stdlib and importing self will require a lot of hacky and weird logic in generic package loading code so I try to tackle this first. TODO: - [x] fix tests - [x] ~~check cycles with the test stdlibs overlay applied~~ -> be explicit about the lack of support for modifying imports in testing stdlibs overlay --------- Signed-off-by: Norman Meier <[email protected]> Signed-off-by: Norman <[email protected]> Signed-off-by: Norman <[email protected]> Co-authored-by: Morgan <[email protected]> Co-authored-by: Norman <[email protected]>

- make event emit functions private - minor fixes

stefann-01 added 4 commits December 16, 2024 02:20

add fomo3d game and tests

8b38258

add game info

fc4af43

- add render function

751a62d

- reduce min_key_price

Merge branch 'master' into feat/fomo3d

32dba1d

github-actions bot assigned stefann-01 Dec 16, 2024

github-actions bot added the 🧾 package/realm Tag used for new Realms or Packages. label Dec 16, 2024

stefann-01 mentioned this pull request Dec 16, 2024

Stefann's Builder Journey gnolang/hackerspace#94

Open

n2p5 and others added 6 commits December 16, 2024 09:15

Merge branch 'master' into feat/fomo3d

ff19a03

Merge branch 'gnolang:master' into feat/fomo3d

47b616d

Merge branch 'gnolang:master' into feat/fomo3d

0a21261

Merge remote-tracking branch 'upstream/master' into feat/fomo3d

caafb87

- Add contract owner

5013649

- Add 5% owner fee (47% jackpot, 28% dividends) - Improve error handling - Update UI with better organization & emojis - Add ownership tests & update test coverage - Register realm to Hall of Realms

Merge remote-tracking branch 'upstream/master' into feat/fomo3d

dbddecc

leohhhn reviewed Dec 19, 2024

View reviewed changes

stefann-01 added 14 commits December 20, 2024 15:56

Merge remote-tracking branch 'upstream/master' into feat/fomo3d

b14658d

Improve game logic, render and tests

108e914

Merge remote-tracking branch 'upstream/master' into feat/fomo3d

142bd77

run make fmt

20717b8

Merge branch 'gnolang:master' into feat/fomo3d

41f9ab6

- make struct for GameState

059917e

- add test for Ownership

add namespace resolving

7561950

fix render problem

494169e

add events and fix time extension logic

53693e3

run gno fmt

ce88d4d

improve owner functions

745d874

Merge branch 'gnolang:master' into feat/fomo3d

446ffe2

add functions to update studio connect links

3cb0dc8

fix render

28565da

stefann-01 added 9 commits January 21, 2025 15:55

remove redundant comment in nft.gno

027c212

use urequire instead of custom helpers in test

c4a8a1a

move render to separate file

1334c37

fix player rendering

11418b0

Merge branch 'master' into feat/fomo3d

4d87208

- use better practice for Coin & Coins structs

b0a8467

- remove redundant TransferOwnership func

use PrevRealm() instead of GetOrigCaller()

89ee61d

remove redundant conversion in BuyKeys()

4723e1e

- use AmountOf()

400c7cd

- use PrevRealm() - format

alexiscolin and others added 8 commits January 24, 2025 03:05

docs: remove require, add example gno doc (gnolang#3576)

3b02f8e

This pull request is for : - remove `require` statement from official documentation [gnolang#3123](gnolang#3123) - add an example that was `//TODO` in the `effective-gno / Documentation is for users` section

fix(gno.land): update txtar, not modified in gnolang#3580 (gnolang#3590)

8caa6ca

## Description Fixes txtar that needed to be in gnolang#3580 Should've been caught by CI, wasn't --------- Co-authored-by: Morgan Bazalgette <[email protected]>

fix(p2p): infinity loop if no peer in queue (gnolang#3593)

092e549

github-actions bot added 📦 🤖 gnovm Issues or PRs gnovm related 📦 🌐 tendermint v2 Issues or PRs tm2 related 📦 ⛰️ gno.land Issues or PRs gno.land package related labels Jan 24, 2025

Gno2D2 requested review from a team January 24, 2025 02:07

stefann-01 added 7 commits January 24, 2025 03:07

Merge branch 'gnolang:master' into feat/fomo3d

5a95374

- add ipfs nft rendering in gnoweb

10fe981

- make event emit functions private - minor fixes

- run gno fmt

4b7b5ec

- remove TODO comment

14bb272

- run gno fmt

471c2d9

Merge branch 'master' into feat/fomo3d

1723d2b

- remove line from render

e7c1fbd

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add FOMO3D game implementation #3344

feat: add FOMO3D game implementation #3344

stefann-01 commented Dec 16, 2024 •

edited

Loading

Gno2D2 commented Dec 16, 2024 •

edited

Loading

✅ Automated Checks (for Contributors):

☑️ Contributor Actions:

☑️ Reviewer Actions:

📚 Resources:

If

Then

If

Then

If

Can be checked by

If

Can be checked by

codecov bot commented Dec 16, 2024

leohhhn Dec 19, 2024

stefann-01 Dec 29, 2024 •

edited

Loading

stefann-01 Jan 13, 2025 •

edited

Loading

stefann-01 commented Jan 22, 2025

feat: add FOMO3D game implementation #3344

Are you sure you want to change the base?

feat: add FOMO3D game implementation #3344

Conversation

stefann-01 commented Dec 16, 2024 • edited Loading

Description

Key Features

Technical Implementation

How to Use

Testing

Note

Gno2D2 commented Dec 16, 2024 • edited Loading

🛠 PR Checks Summary

Manual Checks (for Reviewers):

✅ Automated Checks (for Contributors):

☑️ Contributor Actions:

☑️ Reviewer Actions:

📚 Resources:

If

Then

If

Then

If

Can be checked by

If

Can be checked by

codecov bot commented Dec 16, 2024

Codecov Report

leohhhn Dec 19, 2024

Choose a reason for hiding this comment

stefann-01 Dec 29, 2024 • edited Loading

Choose a reason for hiding this comment

stefann-01 Jan 13, 2025 • edited Loading

Choose a reason for hiding this comment

stefann-01 commented Jan 22, 2025

stefann-01 commented Dec 16, 2024 •

edited

Loading

Gno2D2 commented Dec 16, 2024 •

edited

Loading

stefann-01 Dec 29, 2024 •

edited

Loading

stefann-01 Jan 13, 2025 •

edited

Loading