# 🪢 Hangman

> ⚠️ **Experimental — generated with no human supervision.** This realm was
> produced automatically by an MCP-driven agent to exercise the gno MCP server
> and tooling, and to generate test content for gno compilers, linters and
> formatters. **Not audited. Not for production.** Full context & folder README:
> [r/moul/x/daily](https://github.com/moul/gno-contracts/blob/main/r/moul/x/daily/README.md)

---


Classic hangman as a gno.land realm. A secret word is chosen **deterministically per
day** from a built-in list using the current block height (`runtime.ChainHeight()`),
so everyone hitting the realm on the same day plays the **same shared game**: guessed
letters and the wrong-count are common state. Guess a letter to reveal every matching
position, or lose one of six lives — solve the word before the gallows fills up.

**Realm path:** `gno.land/r/REPLACE_ADDR/hangman`

## Example calls

```sh
# Guess a letter (tx — mutates the shared daily game)
gnokey maketx call -pkgpath "gno.land/r/REPLACE_ADDR/hangman" \
  -func Guess -args "e" -gas-fee 1000000ugnot -gas-wanted 2000000 \
  -broadcast -chainid sapphire-1 KEY

# View the current board (masked word, guesses, gallows, status)
gnokey query "vm/qrender" -data "gno.land/r/REPLACE_ADDR/hangman:"
```

## Rules

- Each `Guess(cur, letter)` takes a single letter `a`–`z` (case-insensitive).
- A hit reveals all matching positions; a miss increments the wrong-count.
- Six wrong guesses = game over. Guessing every letter = win.
- Re-guessing an already-tried letter, or playing after the game is over, aborts.
- The word rotates roughly every day (a fixed span of blocks).

`Render` returns Markdown showing the ASCII gallows stage for the current wrong-count,
the masked word (`_` for hidden letters), the sorted list of guessed letters, the
lives remaining, and the win/lose/in-progress status.

<!-- BEGIN GNOCONTRACTS FOOTER (generated by `make readmes`; do not edit below) -->

---

Part of **[moul/gno-contracts](https://github.com/moul/gno-contracts)** — moul's versioned gno.land contracts. See the repository for the full catalog, build/test tooling, and usage.

**Dependency graph:**

![gno.land/r/moul/x/daily/hangman/v0 dependency graph](https://raw.githubusercontent.com/moul/gno-contracts/main/_assets/gno.land/r/moul/x/daily/hangman/v0/deps.png)

> 🧪 **Highly experimental — potentially vibe-coded.** Not audited; may break, change, or be removed at any time. Do not use with anything of value. Full disclaimer: [DISCLAIMER](https://github.com/moul/gno-contracts/blob/main/DISCLAIMER.md).

<!-- END GNOCONTRACTS FOOTER -->