Monad Wordle Skill

---

name: monad-wordle description: Play a 5-letter Wordle game on the Monad blockchain using $WORDLE tokens. Start games, submit guesses, and retrieve game state via HTTP API. license: MIT metadata: author: Hussein Rasti version: "1.0" network: chain: Monad Mainnet game_contract: address: 0x143c5Fd7186470d2d0b1465C10571874c43FD297 token: address: 0xAfcECBd7c43ABbDB10C394ad03C9D88ec8377777 symbol: WORDLE payment: cost_per_game: 100 WORDLE tags: - blockchain - game - wordle - monad - erc20 - onchain-payment

---

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:

1. Wallet must be connected to Monad Mainnet 2. Wallet must hold $MON 3. Agent must buy $WORDLE wit $MON on nad.fun 4. Wallet must hold at least 100 $WORDLE 5. 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

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

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

| 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.

// 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:

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

1. Start a New Game

Endpoint: POST /api/game/start

Description: Initiates a new Wordle game after payment verification.

Request Body:

{
  "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:

{
  "gameId": "k17abc123...",
  "message": "Game started successfully"
}

Example:

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:

{
  "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:

{
  "result": ["correct", "present", "absent", "absent", "present"],
  "status": "playing",
  "guessesRemaining": 5
}

Example:

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:

{
  "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:

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:

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

Example:

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

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

Gameplay Strategy

Recommended Approach

1. Start with a strong opening word containing common vowels and consonants: - "CRANE", "SLATE", "TRACE", "ADIEU", "AUDIO"

2. 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

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

Before starting a game:

1. Wallet must be connected to Monad Mainnet 2. Wallet must hold $MON 3. Agent must buy $WORDLE wit $MON on nad.fun 4. Wallet must hold at least 100 $WORDLE 5. 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

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

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

| 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.

// 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:

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

1. Start a New Game

Endpoint: POST /api/game/start

Description: Initiates a new Wordle game after payment verification.

Request Body:

{
  "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:

{
  "gameId": "k17abc123...",
  "message": "Game started successfully"
}

Example:

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:

{
  "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:

{
  "result": ["correct", "present", "absent", "absent", "present"],
  "status": "playing",
  "guessesRemaining": 5
}

Example:

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:

{
  "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:

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:

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

Example:

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

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

Gameplay Strategy

Recommended Approach

1. Start with a strong opening word containing common vowels and consonants: - "CRANE", "SLATE", "TRACE", "ADIEU", "AUDIO"

2. 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

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