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.

IMPORTANT
TrenchQuest is not a race to be the cleverest. It is a filter for the committed. The trials span creative skill, market instinct, social reach, and raw chaos. If your guild lacks depth, you will stall.

How It Works

The Flow

  1. Connect your Solana wallet — You need a Solana wallet (Phantom, Solflare, Backpack, etc.) with SOL for fees and game actions.
  2. 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.
  3. Take on the twelve trials — Your guild works through trials across all four pillars. Each completed trial yields a fragment.
  4. Buy clues when you're stuck — Clues cost 1 SOL. They're shared with the entire guild the moment one member buys one.
  5. 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.

NOTE
The Quest Board is coming soon. It will display the live countdown, active guilds, and the Shame Board. It is not yet live.

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
WARNING
Guild creation is irreversible. The 0.1 SOL fee is not refundable. The name cannot be changed later.

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:

  1. Find a guild you want to join
  2. Pay 0.01 SOL to submit a join request
  3. Your request sits as pending until the founder reviews it
  4. The founder accepts or rejects
  5. If accepted, you are added to the guild
WARNING
The 0.01 SOL fee is charged when you submit the request, not when you're accepted. If the founder rejects your request, the fee is not refunded.

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.

🔨 Creation
Trials: 1, 2, 3
Build something from nothing. Prove you can create. These trials reward guilds with artists, builders, and makers.
⚔️ Conquest
Trials: 4, 5, 6
Dominate the field. These trials reward guilds who can move markets, commit capital, and command attention.
🤝 Connection
Trials: 7, 8, 9
No one survives alone. Explore the castle, meet people, and earn the trust of the realm.
🎲 Chaos
Trials: 10, 11, 12
Fortune favors the unhinged. Poker, hidden puzzles, and proof of real gains. Adaptability is the skill.

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.

#PillarTrial NameTypeDifficulty
1CreationThe Bard's OfferingCommunity Vote3/5
2CreationThe Artificer's CanvasCommunity Vote2/5
3CreationThe Golem's BlueprintCommunity Vote4/5
4ConquestThe Merchant's AscensionMarket Competition5/5
5ConquestThe Vault Keeper's TitheOn-Chain Action3/5
6ConquestThe Oracle's ThreadSocial Competition3/5
7ConnectionThe Cartographer's JourneyExploration4/5
8ConnectionThe Ambassador's CircleSocial Proof2/5
9ConnectionThe Last Man StandingCommunity Vote2/5
10ChaosThe Gambler's TableTournament3/5
11ChaosThe Codebreaker's PathExploration + Puzzle5/5
12ChaosThe Degen's ProofReal-World Proof3/5

Trial Descriptions

#1

The Bard's Offering

Creation

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

#2

The Artificer's Canvas

Creation

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

#3

The Golem's Blueprint

Creation

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

#4

The Merchant's Ascension

Conquest

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

#5

The Vault Keeper's Tithe

Conquest

Lock 1% of your token's supply into the TrenchQuest vault contract. A sacrifice that proves conviction. The locked amount encodes the fragment.

#6

The Oracle's Thread

Conquest

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

#7

The Cartographer's Journey

Connection

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

#8

The Ambassador's Circle

Connection

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

#9

The Last Man Standing

Connection

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

#10

The Gambler's Table

Chaos

A poker tournament. The stakes are fragments. The bluffs are legendary. The last guild standing at the final table claims the fragment.

#11

The Codebreaker's Path

Chaos

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

#12

The Degen's Proof

Chaos

Show 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

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

Lv 1
50 XP
Lv 2
200 XP
Lv 5
1,250 XP
Lv 10
5,000 XP
Lv 15
11,250 XP
Lv 20
20,000 XP

Titles

Your title changes as you level up. Titles are displayed on your profile alongside your level card.

WandererLv 0+
InitiateLv 1+
SeekerLv 3+
AdventurerLv 5+
VeteranLv 8+
ChampionLv 10+
WardenLv 13+
ConquerorLv 15+
OverlordLv 18+
LegendLv 20+
MythicLv 25+

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.

CommonUncommonRareEpicLegendary
BadgeRarityHow to Earn
⚔️ First BloodCommonSubmit your first answer attempt (right or wrong).
🏰 Guild FounderUncommonCreate and lead your own guild.
🥾 Trench WalkerCommonJoin your first guild.
🔍 Clue HoarderUncommonPurchase 5 clues across any guilds.
💀 Shame SurvivorCommonGet a wrong answer on the Shame Board and keep playing.
👑 Quest SolverLegendarySubmit the correct final answer for any track.
🦋 Social ButterflyUncommonSend 50 messages in guild chat.
🦉 Night OwlRareSubmit an answer between midnight and 5 AM.
🃏 Full HouseRareBe in a guild that reaches max capacity.
💎 The GenerousEpicFund the most clue purchases for your guild.
NOTE
Badges are awarded automatically when you meet the condition. You don't need to claim them manually. They appear on your profile once earned.

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.

ActionCostLamportsWho Can Do ItRefundable
Create a Guild0.1 SOL100,000,000Guild founderNo
Request to Join a Guild0.01 SOL10,000,000Any playerNo
Buy a Clue1 SOL1,000,000,000Guild memberNo
Submit an Answer0.001 SOL1,000,000Guild memberNo

Payment Processing

Every transaction follows this flow:

  1. You click an action button (Create Guild, Request to Join, Buy Clue, Submit Answer)
  2. The server builds a transaction using the pump.fun Agent Payments SDK
  3. The transaction is sent to your wallet for signing
  4. Your wallet shows the details — review them carefully
  5. You approve and sign
  6. The transaction is submitted to the Solana network
  7. 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:

  1. Assemble all twelve fragment letters in the correct order (positions 1-12)
  2. Submit the complete answer
  3. Pay the submission fee (0.001 SOL)
  4. Be the first guild to submit the correct answer
WARNING
Wrong answers are publicly displayed on the Shame Board with your guild name. Every wrong guess costs 0.001 SOL and tells every other guild you haven't cracked it yet. Guess wisely.

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.
NOTE
The castle is also just a place to hang out. Players coordinate there, form alliances, and occasionally betray each other. It is the social layer of TrenchQuest.

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:

  1. Client requests challenge content via API
  2. Server verifies the guild has a valid purchase record
  3. Server decrypts content using the vault key
  4. Decrypted content is sent to the client over HTTPS
  5. The vault key is never transmitted
NOTE
Even if the entire source code repository were leaked, the challenge answers would remain secure. The ciphertext is public. The key is not.

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

TrialOne of the twelve challenges in TrenchQuest. Each trial is assigned to a pillar and yields one fragment when solved.
PillarOne of four thematic groups organizing the trials: Creation, Conquest, Connection, Chaos. Each pillar contains three trials.
FragmentA single letter revealed by solving a trial. Twelve fragments in the correct order spell the final answer that unlocks the vault.
The VaultThe prize pool: 25 SOL + 2% of total token supply. Claimed by the first guild to submit the correct twelve-letter answer.
GuildA team of 3-20 players. The fundamental unit of play in TrenchQuest. You cannot play without one.
Join RequestA pending application to join a guild. Submitted by the player, approved or rejected by the guild founder. Costs 0.01 SOL to submit.
Troll BoxThe real-time guild chat powered by Supabase Realtime. Members-only. 500 character limit per message.
Guild ChatSee Troll Box.
BadgeA collectible awarded for completing specific actions. Ten badges exist with five rarity tiers: Common, Uncommon, Rare, Epic, Legendary.
XPExperience Points. Earned through gameplay actions. Determines your level and title.
LevelCalculated as floor(sqrt(totalXP / 50)). Cosmetic. Shown on your profile via the Level Card.
TitleA rank name tied to your level. Ranges from Wanderer (Lv 0) to Mythic (Lv 25+).
Shame BoardPublic display of all failed answer attempts, showing guild name and attempt count. Permanent and visible to all players. Coming with the Quest Board launch.
The CastleThe TrenchQuest virtual world built on WorkAdventure. A browser-based pixel-art environment with multiple maps, some hidden.
WorkAdventureThe platform hosting the TrenchQuest castle. Browser-based multiplayer map explorer. No download required.
BurnSending SOL or tokens to a dead address, making them permanently unrecoverable.
PDA (Program Derived Address)A Solana address mathematically derived from a set of seeds and a program ID. Used in several challenges for verification.
Pump.fun Agent PaymentsThe on-chain payment program used by TrenchQuest. Handles all transaction processing with automatic token buyback-and-burn.
AES-256-GCMAdvanced Encryption Standard with 256-bit key and Galois/Counter Mode. Used to protect challenge secrets.
SHA-256Secure Hash Algorithm producing a 256-bit hash. Used to verify fragment submissions and the final answer without storing them in plaintext.
SaltRandom data added before hashing to prevent pre-computation attacks. Each hash in TrenchQuest uses a unique salt.
LamportsThe smallest unit of SOL. 1 SOL = 1,000,000,000 lamports.
Quest BoardA page showing the live countdown, active guilds, Shame Board, and leaderboard. Not yet launched.

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()
NOTE
You can inspect every transaction on Solscan or Solana Explorer. Search for the program ID above to see all TrenchQuest payments. Nothing is hidden.