
The War Codex
Everything you need to know about TrenchQuest. Read it all. Or die uninformed in the trenches.
Overview
TrenchQuest is a guild-based treasure hunt built on the Solana blockchain. Not a game of chance. Not a lottery. A trial of character — twelve challenges designed to test whether you and your guild have what it takes.
The game revolves around one central prize: The Vault — containing 25 SOL plus 2% of the total token supply. One guild claims it. The guild that proves themselves worthy across all twelve trials assembles the fragments needed to unlock it.
There are no solo players. You must form or join a guild. The trials are organized into four pillars: Creation, Conquest, Connection, and Chaos. Each pillar tests a different dimension of your guild.
How It Works
The Flow
- Connect your Solana wallet — You need a Solana wallet (Phantom, Solflare, Backpack, etc.) with SOL for fees and game actions.
- Create or join a guild — Pay 0.1 SOL to create a guild. To join one, submit a request and wait for the founder's approval. Joining costs 0.01 SOL.
- Take on the twelve trials — Your guild works through trials across all four pillars. Each completed trial yields a fragment.
- Buy clues when you're stuck — Clues cost 1 SOL. They're shared with the entire guild the moment one member buys one.
- Submit the final answer — Once your guild has assembled all twelve fragments in order, submit the complete answer. First correct submission wins the vault.
The Fragment System
Each trial, when solved correctly, reveals a single letter called a fragment. There are twelve fragments. In the correct order, they spell the password that unlocks the vault.
Fragments are cryptographically hashed. When you submit a letter for a trial, the system hashes your submission with a salt and compares it to the stored hash. This means:
- Fragment letters exist nowhere in the codebase in plaintext
- Even the developers cannot extract fragments from the source code
- Verification is instant
- The final answer is similarly hashed — verified but never leaked
Time Structure
Each quest has a defined time window. When the timer expires, the quest ends regardless of whether anyone has won. If no guild submits the correct answer in time, the vault rolls over to the next quest with increased rewards.
Guilds
Creating a Guild
To create a guild, pay 0.1 SOL. This is a real, on-chain transaction. Upon creation:
- You choose a guild name (must be unique)
- You become the guild founder and first member
- Maximum guild size is 20 members
- The guild needs at least 3 members before it activates
Joining a Guild
Joining a guild is not automatic. You submit a request, and the founder must approve it. Only after approval are you added as a member.
The flow:
- Find a guild you want to join
- Pay 0.01 SOL to submit a join request
- Your request sits as pending until the founder reviews it
- The founder accepts or rejects
- If accepted, you are added to the guild
You can only be a member of one guild at a time. Once in a guild, you cannot switch during the current quest.
Guild Chat (Troll Box)
Every guild has a private Troll Box — a real-time chat channel powered by Supabase Realtime. Only guild members can read or send messages.
- Messages are limited to 500 characters
- All messages are stored and visible to all current guild members
- Non-members cannot access the chat
- Chat activity earns XP: every 10 messages grants 5 XP
Use it to coordinate trials, share findings, and strategize. Or just argue. Both happen.
Guild Mechanics
All guild members share access to purchased clues for their trials. When any member buys a clue, the entire guild sees it. Answer submissions are also guild-level — one member submits, it counts for everyone.
The Shame Board (coming with the Quest Board) publicly displays every failed answer attempt, with guild name and attempt number. Failed guesses are permanent and visible to all players.
If your guild wins the vault, the prize is split among all guild members according to the guild's configured split mode (equal, weighted, or custom).
The Four Pillars
The twelve trials are organized into four pillars. Each pillar tests a different kind of strength. Your guild needs to perform across all four.
The Twelve Trials
Below is the complete roster of all twelve trials. Each trial is assigned to a pillar and has a difficulty rating from 1 (easiest) to 5 (hardest). Every trial, when solved, yields one fragment letter.
| # | Pillar | Trial Name | Type | Difficulty |
|---|---|---|---|---|
| 1 | Creation | The Bard's Offering | Community Vote | 3/5 |
| 2 | Creation | The Artificer's Canvas | Community Vote | 2/5 |
| 3 | Creation | The Golem's Blueprint | Community Vote | 4/5 |
| 4 | Conquest | The Merchant's Ascension | Market Competition | 5/5 |
| 5 | Conquest | The Vault Keeper's Tithe | On-Chain Action | 3/5 |
| 6 | Conquest | The Oracle's Thread | Social Competition | 3/5 |
| 7 | Connection | The Cartographer's Journey | Exploration | 4/5 |
| 8 | Connection | The Ambassador's Circle | Social Proof | 2/5 |
| 9 | Connection | The Last Man Standing | Community Vote | 2/5 |
| 10 | Chaos | The Gambler's Table | Tournament | 3/5 |
| 11 | Chaos | The Codebreaker's Path | Exploration + Puzzle | 5/5 |
| 12 | Chaos | The Degen's Proof | Real-World Proof | 3/5 |
Trial Descriptions
The Bard's Offering
CreationSubmit an original piece of music — a war cry, a hymn, a lo-fi beat forged in the trenches. The guild votes. The winner's song echoes through the castle. Your fragment is in the notes.
The Artificer's Canvas
CreationGenerate an AI artwork that captures your guild's spirit. The community votes on which creation is worthy of the Great Hall. The winning image hides a secret.
The Golem's Blueprint
CreationUsing Claude, ChatGPT, or any AI tool, build a working application. It doesn't need to change the world — it needs to work. The community votes. The code compiles to a character.
The Merchant's Ascension
ConquestLaunch a token. The token that climbs highest in market cap within the trial window earns its creator the fragment. The market is the only judge here.
The Vault Keeper's Tithe
ConquestLock 1% of your token's supply into the TrenchQuest vault contract. A sacrifice that proves conviction. The locked amount encodes the fragment.
The Oracle's Thread
ConquestWrite a Twitter thread about TrenchQuest that makes people stop scrolling. The thread with the most organic likes when the trial closes wins. No bots. No raids. Just sharp words.
The Cartographer's Journey
ConnectionThe castle holds secrets in every corridor. Visit every map in TrenchQuest — including the ones they don't advertise. Screenshot each one as proof. Miss one, the fragment stays hidden. The castle is at play.workadventu.re/@/trench-quest/trench-quest/trenchcastle.
The Ambassador's Circle
ConnectionWalk into the castle and talk to strangers. Meet 10 people you've never spoken to. Learn their names. Screenshot the conversations. Connection is the oldest currency.
The Last Man Standing
ConnectionEach guild nominates one champion for a hypothetical: you're the last person alive, pick one companion from the nominees. The realm votes. Charm and conviction win. The winner's initial is no coincidence.
The Gambler's Table
ChaosA poker tournament. The stakes are fragments. The bluffs are legendary. The last guild standing at the final table claims the fragment.
The Codebreaker's Path
ChaosHidden on every map in the castle is a fragment of a code. Find them all. Piece them together. The assembled code spells the password to the final vault. You already know where to look.
The Degen's Proof
ChaosShow the trenches you can survive out there. Submit a screenshot or screen recording of a positive futures PnL. Not paper trading. Not inspect element. Real gains. The trenches respect receipts.
XP & Leveling
Every action in TrenchQuest earns XP. XP determines your level and title. Levels are cosmetic — they don't affect gameplay — but they show how deep in the trenches you've been.
XP Sources
| Action | XP Earned |
|---|---|
| Challenge completed (fragment verified) | +100 XP |
| Clue purchased | +25 XP |
| Wrong answer submitted | +10 XP |
| Correct answer / quest solved | +500 XP |
| Joined a guild | +50 XP |
| Founded a guild | +75 XP |
| Every 10 guild chat messages | +5 XP |
Level Formula
Level is calculated as: level = floor(sqrt(totalXP / 50))
Early levels come fast. Later ones take longer. Some thresholds:
Titles
Your title changes as you level up. Titles are displayed on your profile alongside your level card.
Badges
Badges are earned by completing specific actions. They appear on your profile page via the Badge Showcase. There are ten badges with five rarity tiers.
| Badge | Rarity | How to Earn |
|---|---|---|
| ⚔️ First Blood | Common | Submit your first answer attempt (right or wrong). |
| 🏰 Guild Founder | Uncommon | Create and lead your own guild. |
| 🥾 Trench Walker | Common | Join your first guild. |
| 🔍 Clue Hoarder | Uncommon | Purchase 5 clues across any guilds. |
| 💀 Shame Survivor | Common | Get a wrong answer on the Shame Board and keep playing. |
| 👑 Quest Solver | Legendary | Submit the correct final answer for any track. |
| 🦋 Social Butterfly | Uncommon | Send 50 messages in guild chat. |
| 🦉 Night Owl | Rare | Submit an answer between midnight and 5 AM. |
| 🃏 Full House | Rare | Be in a guild that reaches max capacity. |
| 💎 The Generous | Epic | Fund the most clue purchases for your guild. |
Pricing & Payments
All payments in TrenchQuest are real, on-chain Solana transactions processed through the pump.fun Agent Payments program. No free trials. No refunds. No exceptions.
| Action | Cost | Lamports | Who Can Do It | Refundable |
|---|---|---|---|---|
| Create a Guild | 0.1 SOL | 100,000,000 | Guild founder | No |
| Request to Join a Guild | 0.01 SOL | 10,000,000 | Any player | No |
| Buy a Clue | 1 SOL | 1,000,000,000 | Guild member | No |
| Submit an Answer | 0.001 SOL | 1,000,000 | Guild member | No |
Payment Processing
Every transaction follows this flow:
- You click an action button (Create Guild, Request to Join, Buy Clue, Submit Answer)
- The server builds a transaction using the pump.fun Agent Payments SDK
- The transaction is sent to your wallet for signing
- Your wallet shows the details — review them carefully
- You approve and sign
- The transaction is submitted to the Solana network
- Upon confirmation, the action is recorded in the database
Where Does the Money Go?
All payments flow through the pump.fun Agent Payments program (program ID: AgenTMiC2hvxGebTsgmsD4HHBa8WEcqGFf87iwRRxLo7). A percentage of each payment is used for automatic token buyback-and-burn. The rest goes to the TrenchQuest treasury.
The vault prize (25 SOL + 2% of supply) is held separately in the TrenchQuest vault address until claimed by the winning guild.
The Vault
What's Inside
The vault contains:
- 25 SOL — Direct SOL prize
- 2% of total token supply — Distributed as tokens to the winning guild
The token component's value shifts with the market. At any given time it could be worth more or less than the SOL component.
How to Win
To claim the vault, a guild must:
- Assemble all twelve fragment letters in the correct order (positions 1-12)
- Submit the complete answer
- Pay the submission fee (0.001 SOL)
- Be the first guild to submit the correct answer
Prize Distribution
When a guild wins, the prize is split among all guild members according to the guild's configured split mode. The founder sets this at creation. Options are equal split, weighted split, or custom allocation.
The Castle
TrenchQuest has a virtual world. The Game nav link takes you to a WorkAdventure map — a pixel-art castle where players can explore, meet each other, and hunt for hidden content.
WorkAdventure
The castle is hosted at play.workadventu.re/@/trench-quest/trench-quest/trenchcastle. It is a browser-based multiplayer environment. No download required. Just a wallet address and a willingness to wander.
The castle has multiple maps. Some are obvious. Some are not. Several trials explicitly require you to explore the castle:
- The Cartographer's Journey (Trial #7) — Visit every map in the castle, including hidden ones. Screenshot proof required.
- The Ambassador's Circle (Trial #8) — Meet and introduce yourself to 10 new people inside the castle. Screenshot the conversations.
- The Codebreaker's Path (Trial #11) — Hidden on every map is a fragment of a code. Find them all and piece them together.
Wallet & Transactions
Supported Wallets
TrenchQuest supports any Solana wallet that implements the Wallet Standard:
- Phantom
- Solflare
- Backpack
- Coinbase Wallet
- Ledger (via Phantom or Solflare)
- Any other Wallet Standard-compatible wallet
Transaction Verification
Every transaction can be independently verified on any Solana explorer (Solscan, Solana Explorer, SolanaFM). When you sign a transaction, your wallet displays:
- The exact amount being transferred
- The destination address
- The program being invoked
- Any additional instructions
Always review transaction details before signing. TrenchQuest will never ask you to sign a transaction for more than the displayed action price.
Network
TrenchQuest runs on Solana Mainnet-Beta. All transactions are real and irreversible. Make sure your wallet is connected to mainnet, not devnet or testnet.
Security & Encryption
The Vault Encryption System
All challenge secrets — briefings, descriptions, proof requirements, and fragment letters — are encrypted using AES-256-GCM. The encryption works as follows:
- Each secret is encrypted with a unique initialization vector (IV)
- Decryption requires the
QUEST_VAULT_KEY— a 256-bit key stored only in the server environment - The key never reaches the client or browser
- Even a full frontend decompile yields only ciphertext
Fragment & Answer Hashing
Fragment letters and the final answer are stored as salted SHA-256 hashes:
- The actual letters/answer exist nowhere in the codebase in plaintext
- Verification is one-way: the system can check if your submission is correct, but cannot reverse-engineer the answer
- Each hash uses a unique salt to prevent pre-computation attacks
- Even with full database access, the answer cannot be extracted — only verified
Server-Side Only Decryption
Challenge content is decrypted only on the server, only after verifying the requesting guild has purchased access:
- Client requests challenge content via API
- Server verifies the guild has a valid purchase record
- Server decrypts content using the vault key
- Decrypted content is sent to the client over HTTPS
- The vault key is never transmitted
Strategy & Tips
Guild Composition
The four pillars demand four different types of people. Build accordingly:
- Creation — You need musicians, artists, and builders who can use AI tools. Trials #1-3 are community votes. Your output has to be good.
- Conquest — You need someone who can launch a token, hold capital, and write compelling content. Trial #4 (token market cap) can win or lose alone.
- Connection — You need people who will actually go into the castle and talk to strangers. Trial #8 requires 10 real conversations. There is no shortcut.
- Chaos — You need a poker player, someone willing to explore every corner of the castle, and someone with actual trading receipts.
The Community Vote Trials
Trials #1, #2, #3, and #9 are decided by community vote. This means social reach matters. A guild with a large following can win these outright. A guild without one needs output quality that speaks for itself.
Think about your vote base before the trial window opens. A great entry with no voters loses to a mediocre entry with a crowd behind it.
Common Mistakes
- Guessing the final answer early — Every wrong guess is public. It tells rivals how close (or far) you are.
- Ignoring the Cartographer's Journey — Visiting every map takes time. The hidden ones are genuinely hidden. Start early.
- Not recruiting for the right pillar — A guild of coders will dominate Creation but stall on Conquest. Know your gaps.
- Underestimating Trial #4 — Launching a token that gains market cap is hard. You need a plan before the trial opens, not after.
- Neglecting guild chat — Coordination happens there. A silent guild is a fractured guild.
FAQ
Can I play solo?
No. Every player must be part of a guild. Guilds need at least 3 members to activate. There is no solo path through TrenchQuest.
How do I join a guild?
Find a guild you want to join and submit a request. Pay 0.01 SOL. The founder reviews your request and accepts or rejects it. You are added only after approval. There is no auto-join.
What if the founder rejects my join request?
You don't get added. The 0.01 SOL fee is not refunded — it's the cost of submitting the request, not the cost of membership. Find another guild and try again.
Can I switch guilds?
No. Once you join a guild during a quest, you're locked in for the duration.
What happens if no guild wins before the timer expires?
The vault rolls over to the next quest with increased rewards. No one wins the current round.
Is this gambling?
No. TrenchQuest is a skill-based competition. The trials have deterministic outcomes driven by creative quality, market performance, coordination, and exploration. There is no random element in the fragment solutions.
Can the developers see the answers?
The developers can decrypt challenge descriptions (they hold the vault key). Fragment letters and the final answer are stored as salted SHA-256 hashes — they can be verified but not reversed, even by developers.
What blockchain is this on?
Solana Mainnet-Beta. All transactions are real and irreversible.
How are payments processed?
Through the pump.fun Agent Payments program (AgenTMiC2hvxGebTsgmsD4HHBa8WEcqGFf87iwRRxLo7). Every payment is an on-chain transaction you sign with your wallet.
Can I get a refund?
No. All transactions are on-chain and irreversible. Fees are shown before you sign each transaction.
Where is the castle?
At play.workadventu.re/@/trench-quest/trench-quest/trenchcastle. Browser-based. No download. Accessible from the Game link in the nav.
When does the Quest Board launch?
The Quest Board is not yet live. It will show the live countdown, active guilds, leaderboard, and Shame Board when it launches.
How do badges work?
Badges are awarded automatically when you meet the criteria. No manual claim required. They display on your profile page.
Do levels affect gameplay?
No. Levels and titles are cosmetic. They show your history in TrenchQuest but don't grant any in-game advantage.
How do I know the game is fair?
All payments are verifiable on-chain. Challenge answers are cryptographically hashed and cannot be changed after a quest starts. The vault balance is publicly visible on the blockchain.
Glossary
Powered by Pump.Fun
Every transaction in TrenchQuest — guild creation, join requests, clue purchases, answer submissions — is processed through Pump.Fun's Agent Payments SDK.
What is Pump.Fun?
Pump.Fun is the largest token launchpad on Solana. Their smart contracts have been audited, run at scale, and trusted by the entire Solana community. When payments flow through their program, you're trusting infrastructure that powers one of the biggest platforms in crypto — not something we built in a weekend.
Why This Matters
- Automatic token buyback-and-burn — A percentage of every payment automatically buys back and burns tokens. Handled at the program level. No one can skip it.
- Transparent payment flow — Every transaction goes through program ID
AgenTMiC2hvxGebTsgmsD4HHBa8WEcqGFf87iwRRxLo7. Verifiable on any Solana explorer. - No custom wallet handling — TrenchQuest never touches your private keys, holds your funds in an intermediary, or processes payments through contracts we wrote ourselves.
- Invoice-based verification — Each payment generates a unique invoice with a time window. The SDK verifies on-chain before any game action is recorded.
The Trust Model
You shouldn't trust random game developers with your money. You don't have to. The model is:
- You trust your wallet — You sign every transaction. You see exactly what you're approving.
- You trust Pump.Fun's program — The same program that powers the largest token launchpad on Solana.
- You trust the Solana blockchain — Every transaction is public, immutable, and permanent.
We built the game. Pump.Fun handles the money. Solana keeps the receipts.
Technical Details
- SDK:
@pump-fun/agent-payments-sdk v3.0.3 - Program:
AgenTMiC2hvxGebTsgmsD4HHBa8WEcqGFf87iwRRxLo7 - Currency: Wrapped SOL (
So11111111111111111111111111111111111111112) - Transaction builder:
PumpAgent.buildAcceptPaymentInstructions() - Verification:
PumpAgent.validateInvoicePayment()