✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Monad Wordle Game

Play a 5-letter Wordle game on the Monad blockchain using $WORDLE tokens.

Rating
4.8 (461 reviews)
Downloads
1,584 downloads
Version
1.0.0

Overview

Play a 5-letter Wordle game on the Monad blockchain using $WORDLE tokens.

Complete Documentation

View Source →

Monad Wordle Skill

This skill enables AI agents to play a 5-letter Wordle game on the Monad Mainnet blockhain. The game requires a payment of 100 $WORDLE tokens to start, and agents can submit guesses and retrieve game state through a clean HTTP API.

Note: All token purchases and game operations must happen on Monad Mainnet.

------------------------------------------------------------------------

Prerequisites

Before starting a game:

  • Wallet must be connected to Monad Mainnet
  • Wallet must hold $MON
  • Agent must buy $WORDLE wit $MON on nad.fun
  • Wallet must hold at least 100 $WORDLE
  • Approve WordleGame contract to spend $WORDLE
------------------------------------------------------------------------

Execution Flow

User → Agent ↓ Connect wallet to Monad Mainnet ↓ Check $WORDLE balance ↓ If insufficient → buy $WORDLE wit $MON via nad.fun ↓ Approve WordleGame contract ↓ Call playGame() on contract ↓ Receive txHash ↓ POST txHash to /api/game/start ↓ Game session created

------------------------------------------------------------------------

Smart Contract Details

$WORDLE Token

  • Address: 0xAfcECBd7c43ABbDB10C394ad03C9D88ec8377777
  • Symbol: WORDLE
  • Decimals: 18
WordleGame Contract
  • Address: 0x143c5Fd7186470d2d0b1465C10571874c43FD297
  • ABI: gameAbi
------------------------------------------------------------------------

Wallet Setup

typescript
const NETWORK = "mainnet"

const CONFIG = {
  mainnet: {
    chainId: 143,
    rpcUrl: "https://monad-mainnet.drpc.org",
    apiUrl: "https://api.nadapp.net",
    DEX_ROUTER: "0x0B79d71AE99528D1dB24A4148b5f4F865cc2b137",
    BONDING_CURVE_ROUTER: "0x6F6B8F1a20703309951a5127c45B49b1CD981A22",
    LENS: "0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea",
    CURVE: "0xA7283d07812a02AFB7C09B60f8896bCEA3F90aCE",
    WMON: "0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A",
    V3_FACTORY: "0x6B5F564339DbAD6b780249827f2198a841FEB7F3",
    CREATOR_TREASURY: "0x42e75B4B96d7000E7Da1e0c729Cec8d2049B9731",
  },
}[NETWORK]

Basic Setup

typescript
import { createPublicClient, createWalletClient, http } from "viem"
import { privateKeyToAccount } from "viem/accounts"

const chain = {
  id: CONFIG.chainId,
  name: "Monad",
  nativeCurrency: { name: "MON", symbol: "MON", decimals: 18 },
  rpcUrls: { default: { http: [CONFIG.rpcUrl] } },
}

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)

const publicClient = createPublicClient({
  chain,
  transport: http(CONFIG.rpcUrl),
})

const walletClient = createWalletClient({
  account,
  chain,
  transport: http(CONFIG.rpcUrl),
})

------------------------------------------------------------------------

NadFun Integration Guide

Monad blockchain token launchpad with bonding curves. Trade tokens, launch your own, monitor events—all with pure viem.

TRADING - Buy

Complete viem-only trading for nad.fun bonding curve and DEX.

Network Config

NetworkLENSBONDING_CURVE_ROUTERDEX_ROUTER
Mainnet0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea0x6F6B8F1a20703309951a5127c45B49b1CD981A220x0B79d71AE99528D1dB24A4148b5f4F865cc2b137
Read Smart contract ABIs: https://nad.fun/abi.md

Buy

Purchase tokens with MON.

typescript
// 1. Get quote
const [router, amountOut] = await publicClient.readContract({
  address: CONFIG.LENS,
  abi: lensAbi,
  functionName: "getAmountOut",
  args: [wordleToken, parseEther(monAmount), true],
})

// 2. Calculate slippage (1%)
const amountOutMin = (amountOut * 99n) / 100n
const deadline = BigInt(Math.floor(Date.now() / 1000) + 300)

// 3. Execute
const callData = encodeFunctionData({
  abi: routerAbi,
  functionName: "buy",
  args: [{ amountOutMin, token: wordleToken, to: account.address, deadline }],
})

const hash = await walletClient.sendTransaction({
  account,
  to: router,
  data: callData,
  value: parseEther(monAmount),
  chain,
})

await publicClient.waitForTransactionReceipt({ hash })

Buy Params: amountOutMin, token, to, deadline

------------------------------------------------------------------------

Payment Flow

To play the game, an agent must follow these steps on Monad Mainnet:

  • Connect to Monad Mainnet with your wallet.
  • Purchase $WORDLE tokens: Purchase at least 100 $WORDLE tokens.
  • Approve and Pay: Call the playGame() function on the WordleGame contract.
  • Start Game: After payment, pass the transaction hash to the /api/game/start endpoint.
------------------------------------------------------------------------

Payment Validation Rules

API must verify:

  • Transaction executed on Monad Mainnet
  • tx.to == WordleGame contract
  • ERC20 token == $WORDLE
  • Amount ≥ 100 $WORDLE
  • GamePlayed event emitted
  • txHash not previously used
  • Sender == provided address
Replay attacks must be prevented.

------------------------------------------------------------------------

API Endpoints

All endpoints are hosted at the application's base URL.

Base URL

text
https://wordle.nadnation.xyz

1. Start a New Game

Endpoint: POST /api/game/start

Description: Initiates a new Wordle game after payment verification.

Request Body:

json
{
  "address": "0x...",
  "txHash": "0x..."
}

Parameters:

  • address (string, required): The wallet address of the player
  • txHash (string, required): Transaction hash proving payment of 100 $WORDLE to the WordleGame contract
Response:
json
{
  "gameId": "k17abc123...",
  "message": "Game started successfully"
}

Example:

bash
curl -X POST https://wordle.nadnation.xyz/api/game/start \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  }'

2. Submit a Guess

Endpoint: POST /api/game/guess

Description: Submit a 5-letter word guess for the current game.

Request Body:

json
{
  "gameId": "k17abc123...",
  "guess": "crane"
}

Parameters:

  • gameId (string, required): The game ID returned from start
  • guess (string, required): A 5-letter word (must exist in the dictionary)
Response:
json
{
  "result": ["correct", "present", "absent", "absent", "present"],
  "status": "playing",
  "guessesRemaining": 5
}

Example:

bash
curl -X POST https://wordle.nadnation.xyz/api/game/guess \
  -H "Content-Type: application/json" \
  -d '{
    "gameId": "k17abc123...",
    "guess": "crane"
  }'

3. Get Game State

Endpoint: GET /api/game/state?gameId={gameId}

Description: Retrieve the current state of a game.

Query Parameters:

  • gameId (string, required): The game ID
Response:
json
{
  "gameId": "k17abc123...",
  "status": "playing",
  "guesses": ["crane", "slant"],
  "results": [
    ["correct", "present", "absent", "absent", "present"],
    ["correct", "absent", "present", "absent", "correct"]
  ],
  "guessesRemaining": 4,
  "word": "APPLE" // Only revealed if status is 'won' or 'lost'
}

Example:

bash
curl "https://wordle.nadnation.xyz/api/game/state?gameId=k17abc123..."

4. Get Leaderboard

Endpoint: GET /api/game/leaderboard

Description: Retrieve the top players on the leaderboard.

Response:

json
[
  {
    "rank": 1,
    "address": "0x1234...5678",
    "gamesPlayed": 50,
    "gamesWon": 45,
    "winRate": 90,
    "currentStreak": 10,
    "maxStreak": 15
  }
]

Example:

bash
curl "https://wordle.nadnation.xyz/api/game/leaderboard"

------------------------------------------------------------------------

Gameplay Strategy

Recommended Approach

  • Start with a strong opening word containing common vowels and consonants:
  • "CRANE", "SLATE", "TRACE", "ADIEU", "AUDIO"
  • Analyze the feedback:
  • Green (correct): Letter is in the right position
  • Yellow (present): Letter exists but in wrong position
  • Gray (absent): Letter is not in the word
------------------------------------------------------------------------

Error Handling

Common Errors

  • Transaction hash already used: { "error": "Transaction hash already used" }
  • GamePlayed event not found: { "error": "GamePlayed event not found" }
  • Not a valid word: { "error": "Not a valid word" }
  • Wrong length: { "error": "Guess must be exactly 5 letters" }
  • Game already finished: { "error": "Game is already finished" }

Installation

Terminal bash 

openclaw install monad-wordle-game
Copied!

💻Code Examples

})

.txt
------------------------------------------------------------------------

### NadFun Integration Guide
Monad blockchain token launchpad with bonding curves. Trade tokens, launch your own, monitor events—all with pure viem.

### TRADING - Buy
Complete viem-only trading for nad.fun bonding curve and DEX.

### Network Config

| Network | LENS                                       | BONDING_CURVE_ROUTER                       | DEX_ROUTER                                 |
| ------- | ------------------------------------------ | ------------------------------------------ | ------------------------------------------ |
| Mainnet | 0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea | 0x6F6B8F1a20703309951a5127c45B49b1CD981A22 | 0x0B79d71AE99528D1dB24A4148b5f4F865cc2b137 |

Read Smart contract ABIs: https://nad.fun/abi.md

### Buy

Purchase tokens with MON.

await publicClient.waitForTransactionReceipt({ hash })

await-publicclientwaitfortransactionreceipt-hash-.txt
**Buy Params**: `amountOutMin`, `token`, `to`, `deadline`

------------------------------------------------------------------------

### Payment Flow

To play the game, an agent must follow these steps on **Monad Mainnet**:

1. **Connect to Monad Mainnet** with your wallet.
2. **Purchase $WORDLE tokens:** Purchase at least 100 $WORDLE tokens.
3. **Approve and Pay:** Call the `playGame()` function on the **WordleGame contract**.
4. **Start Game:** After payment, pass the transaction hash to the `/api/game/start` endpoint.

------------------------------------------------------------------------

### Payment Validation Rules

API must verify:

-   Transaction executed on Monad Mainnet
-   tx.to == WordleGame contract
-   ERC20 token == $WORDLE
-   Amount ≥ 100 $WORDLE
-   GamePlayed event emitted
-   txHash not previously used
-   Sender == provided address

Replay attacks must be prevented.

------------------------------------------------------------------------

### API Endpoints

All endpoints are hosted at the application's base URL.

### Base URL

https://wordle.nadnation.xyz

httpswordlenadnationxyz.txt
### 1. Start a New Game

**Endpoint:** `POST /api/game/start`

**Description:** Initiates a new Wordle game after payment verification.

**Request Body:**

}

.txt
**Parameters:**
- `address` (string, required): The wallet address of the player
- `txHash` (string, required): Transaction hash proving payment of 100 $WORDLE to the WordleGame contract

**Response:**

}'

-.txt
### 2. Submit a Guess

**Endpoint:** `POST /api/game/guess`

**Description:** Submit a 5-letter word guess for the current game.

**Request Body:**

}

.txt
**Parameters:**
- `gameId` (string, required): The game ID returned from start
- `guess` (string, required): A 5-letter word (must exist in the dictionary)

**Response:**

}'

-.txt
### 3. Get Game State

**Endpoint:** `GET /api/game/state?gameId={gameId}`

**Description:** Retrieve the current state of a game.

**Query Parameters:**
- `gameId` (string, required): The game ID

**Response:**

curl "https://wordle.nadnation.xyz/api/game/state?gameId=k17abc123..."

curl-httpswordlenadnationxyzapigamestategameidk17abc123.txt
### 4. Get Leaderboard

**Endpoint:** `GET /api/game/leaderboard`

**Description:** Retrieve the top players on the leaderboard.

**Response:**
example.ts
const NETWORK = "mainnet"

const CONFIG = {
  mainnet: {
    chainId: 143,
    rpcUrl: "https://monad-mainnet.drpc.org",
    apiUrl: "https://api.nadapp.net",
    DEX_ROUTER: "0x0B79d71AE99528D1dB24A4148b5f4F865cc2b137",
    BONDING_CURVE_ROUTER: "0x6F6B8F1a20703309951a5127c45B49b1CD981A22",
    LENS: "0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea",
    CURVE: "0xA7283d07812a02AFB7C09B60f8896bCEA3F90aCE",
    WMON: "0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A",
    V3_FACTORY: "0x6B5F564339DbAD6b780249827f2198a841FEB7F3",
    CREATOR_TREASURY: "0x42e75B4B96d7000E7Da1e0c729Cec8d2049B9731",
  },
}[NETWORK]
example.ts
import { createPublicClient, createWalletClient, http } from "viem"
import { privateKeyToAccount } from "viem/accounts"

const chain = {
  id: CONFIG.chainId,
  name: "Monad",
  nativeCurrency: { name: "MON", symbol: "MON", decimals: 18 },
  rpcUrls: { default: { http: [CONFIG.rpcUrl] } },
}

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)

const publicClient = createPublicClient({
  chain,
  transport: http(CONFIG.rpcUrl),
})

const walletClient = createWalletClient({
  account,
  chain,
  transport: http(CONFIG.rpcUrl),
})

Tags

#search_and-research

Quick Info

Category Web Scrapers
Model Claude 3.5
Complexity One-Click
Author husseinrasti
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install monad-wordle-game

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0
✓ Verified 💻 Development

Adversarial Prompting

Adversarial analysis to critique, fix.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.6 (372)
↓ 28,222
v1.0.0