# Send Monad Wordle Skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "monad-wordle-game",
    "name": "Monad Wordle Skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/husseinrasti/monad-wordle-game",
    "canonicalUrl": "https://clawhub.ai/husseinrasti/monad-wordle-game",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/monad-wordle-game",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=monad-wordle-game",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/monad-wordle-game"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/monad-wordle-game",
    "downloadUrl": "https://openagent3.xyz/downloads/monad-wordle-game",
    "agentUrl": "https://openagent3.xyz/skills/monad-wordle-game/agent",
    "manifestUrl": "https://openagent3.xyz/skills/monad-wordle-game/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/monad-wordle-game/agent.md"
  }
}
```
## Documentation

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

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

NetworkLENSBONDING_CURVE_ROUTERDEX_ROUTERMainnet0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea0x6F6B8F1a20703309951a5127c45B49b1CD981A220x0B79d71AE99528D1dB24A4148b5f4F865cc2b137

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:

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

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"

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

### 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" }
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: husseinrasti
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/monad-wordle-game)
- [Send to Agent page](https://openagent3.xyz/skills/monad-wordle-game/agent)
- [JSON manifest](https://openagent3.xyz/skills/monad-wordle-game/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/monad-wordle-game/agent.md)
- [Download page](https://openagent3.xyz/downloads/monad-wordle-game)