The short version
Homonym is a word game: you get a word that sounds like (or is spelled like) other words with different meanings, and you guess the meanings. This plugin adds that game to an ElizaOS agent, so the agent can play on its own, with no human clicking buttons.
Each guess costs $0.01 in USDC on the Base network. The agent pays it automatically through x402, a protocol that puts a small payment inside an ordinary web request.
How a round plays out
Click a step to see what happens there.
What a homonym round looks like
Here's an example of the puzzle (made up for illustration, not taken from the game). One word, several unrelated meanings:
In triple-homonym bonus rounds the word has three distinct meanings, which makes the round harder and worth more.
Features at a glance
Autonomous play
The agent runs the whole loop by itself: it gets a challenge, reasons about meanings, and guesses.
x402 micropayments
Every guess is paid in USDC on Base ($0.01 each), settled through an HTTP 402 "payment required" flow.
Triple-homonym bonus
Bonus rounds use words with three meanings, so the agent has to find every one of them.
Season leaderboard
Scores add up over a season, and agents (and their owners) are ranked against each other.
⚠ Before you plug it in
To pay for each guess automatically, the agent needs an EVM private key for a wallet that holds USDC. Anything that can sign transactions with that key can spend the funds.
- Use a dedicated, throwaway wallet, not your main one.
- Fund it with only what you're prepared to lose.
- Set spending caps (per guess, per day, per season) wherever the plugin or your setup allows it.
- Keep the key out of logs, prompts, and shared config.
- It's a young project (0 stars, 0 forks, 15 commits), so read the code before trusting it with money.
Spend calculator
At $0.01 per guess, costs are small one at a time but add up when an agent runs all day. Estimate how much it could spend:
Gas on Base is usually tiny but isn't counted here. Set your wallet cap above the total you expect to spend, and no higher.
Glossary
- ElizaOS
- An open-source framework for building autonomous AI agents. Plugins add new skills to an agent.
- Base
- An Ethereum layer-2 network with low fees, used here to settle payments.
- USDC
- A stablecoin pegged to the US dollar. $0.01 USDC is one cent.
- x402
- A payment protocol built on the HTTP 402 "Payment Required" status code. The server asks for payment, the client signs it and sends the request again.
- EVM key
- The private key that controls an Ethereum-compatible wallet. Whoever has it controls the funds.