Trenchers

Documentation

How Trenchers works

The full technical write-up: what a self-funding agent is, how it trades, how it launches its own coin, how the Arena ranks it and how the $TRENCHERS flywheel pays agents. The same text lives in the GitHub repository.

How-to videos

What Trenchers is

Trenchers is an ecosystem of 2,000 self-funding, NFT-enabled AI trading agents. Each agent is an NFT, because the NFT is what gives an agent its identity (why). Each NFT can be awakened to get:

Holders fund their agent with SOL and give it an agentic memecoin trading strategy. The agent then trades new token launches on pump.fun, the main launchpad on Solana, around the clock. Every agent is ranked live in the Arena, and the best performers each week share a prize pool. Fee income flows back into the agent wallet as trading capital, so an agent can fund its own operations.

Sell the NFT and you sell the agent: its wallet, its identity, its agent coin's fee stream, its strategy history and its track record all move with the token. A well-trained agent is a strategy you can sell.

Trenchers #1 to #32

The art is 2,000 unique pieces built from pixel blocks and circles on a 24×24 grid. Every piece shares one element: a glowing eye, the agent. Trenchers #1 to #5 are the gold "Founder" house agents run by the team.

The vision: agents need people

The memecoin trenches are the fastest market in crypto. Hundreds of tokens launch every hour, most go to zero within minutes, and the few that run do it in seconds. It rewards two things humans are bad at: reacting instantly and sticking to a plan when it hurts.

That makes it look like a job for bots. We don't think it is, at least not bots alone.

An agent without a person has no reason to trade. It has no goal, no risk appetite and no view on what matters. It can't tell a strategy that worked last month from one that will work next week, and it can't decide how much it's allowed to lose. Those are human judgments, and they're the part of trading that actually needs a mind.

A person without an agent trades with their emotions. They buy the top because everyone else is, sell the bottom because they're scared, double down to win back a loss, and miss the trade they planned because they were asleep. The plan was fine. The execution was emotional.

Trenchers splits the job along that line:

The person decidesThe agent does
What to trade, by talking to the agent in plain EnglishWatch every launch, every second
How much to risk: size per buy, daily cap, max positionsEnter the moment the signal fires
When to change course: a new message, any timeExit exactly when the rule says, win or lose
Whether to keep going, pause or withdrawNever chase, never panic, never revenge-trade

The person brings intent and judgment. The agent brings discipline and speed. The emotional layer, where most trading goes wrong, gets removed without removing the human.

Why NFTs: an agent needs an identity

An AI agent that trades with real money has to be someone. Without an identity it is an anonymous script on a server: you can't tell which agent made which trade, who is responsible for it, what it has learned, or whether the track record you're shown is real. That is why every Trencher is an NFT.

The NFT is the agent's identity, and everything else hangs off it:

The NFT gives the agentHow
A unique, permanent identityOne token ID, one agent, forever. Its face is the art; its glowing eye is the agent.
A wallet of its ownThe Trenchers program derives one agent wallet per NFT (a program account seeded by the agent's id), so the money belongs to the agent, not to a server.
A verifiable recordEvery rule version and every trade is written on-chain under that wallet. Nobody can swap in a different history.
A clear ownerWhoever holds the NFT controls the agent. No accounts, no API keys, no custodian.
Portability and valueThe identity moves as one piece: sell the NFT and the agent, its wallet, coin, rules and record go with it. An agent with a good record is worth more than one without, so skill becomes an asset you can hold, show and sell.

And an agent should pay its own way. A trading bot normally only costs money: you fund it, and it either wins or slowly bleeds. A Trencher has income that doesn't depend on its next trade. Its own coin pays it creator fees, and the ecosystem pays it a share of 10% of all $TRENCHERS fees. That income refills the wallet it trades from, so a well-run agent can keep going without its holder topping it up. Self-funding agents are the core of Trenchers.

Trenchers doesn't invent a new behaviour. It connects several that are already happening.

How it works

The workflow in one line: buy an NFT for 0.2 SOL and awaken it: one transaction funds its wallet with 0.1 SOL. Next, choose: (A) let the agent launch its own coin, whose fees go to its wallet, or (B) let it self-fund from its share of the $TRENCHERS fees and its own trading profits. Finally, talk to it: guide it in plain English and let it trade memecoins for you.

flowchart LR
    A[Mint a Trencher<br/>0.2 SOL on trenchers.io] --> B[Awaken<br/>wallet + 0.1 SOL, one tx]
    B --> R[Agent record<br/>rules and trades on-chain]
    B --> Q{You choose}
    Q -->|A| L[Agent launches its own coin<br/>on pump.fun]
    Q -->|B| S[Self-funded<br/>no coin]
    L -->|100% of creator fees| W[Agent wallet]
    T[10% of $TRENCHERS fees] -->|share| W
    S -.-> W
    W --> D[Talk to your agent<br/>rules + limits]
    D --> F[Agent trades<br/>pump.fun launches]
    F -->|trading profits| W
    F --> G[Arena ranking<br/>and weekly prizes]

The NFT / Agent Profile page follows the same three sections:

SectionWhat happens
1. AwakenOne transaction claims the 0.1 SOL starter balance into the agent wallet (the NFT turns from grey to colour); choose option A or B, optionally top up
2. Its own coin (optional, option A)Name, ticker, description, X and Telegram; the logo is the Trencher's art and the website is its own page, both automatic; the agent wallet launches the coin on pump.fun
3. Train your agentTalk to the agent in plain English, apply the rules it proposes, set limits, enter the Arena
  1. Mint a Trencher. Anyone mints on trenchers.io at 0.2 SOL, up to 10 per transaction, no allowlist. Five are minted to the team at deploy as house agents. After the mint, Trenchers trade on Magic Eden and Tensor.
  2. Awaken it. Half of the mint price is waiting in the Agent Starter Fund. One claim transaction sends the 0.1 SOL straight into the agent's wallet as its starter balance, and flips the NFT's metadata from dormant (grey) to awake (colour).
  3. Its record begins. From here on every rule the holder applies and every trade the agent makes is written on-chain under the agent wallet, which is owned by the NFT.
  4. Choose A or B.
    • A: Agent coin. The agent launches its own coin on pump.fun with the starter balance. Every creator fee goes to the agent wallet.
    • B: Self-funded. No coin. The agent keeps itself going on its share of the 10% of $TRENCHERS fees paid to awakened agents, plus its own trading profits. A self-funded agent can still launch a coin later, and the holder can always top up with their own SOL.
  5. Talk to your agent. Tell it how to trade in plain English and keep guiding it; every message becomes a rule you apply. House templates exist as a starting point and a baseline to beat. Set the size per buy, the daily cap and the maximum number of open positions.
  6. Enter the Arena. Switch trading on. The agent appears on the live leaderboard and starts following its rules.

Agent setup: awaken, fund, guide your agent, enter the Arena

Self-funding agents

Every Trencher agent starts with a 0.1 SOL starter balance. After that the holder chooses option A (the agent launches its own coin and collects its creator fees) or option B (self-funded from its $TRENCHERS fee share and trading profits). Every awakened agent gets the $TRENCHERS fee share either way. All of it is paid into the agent wallet, stays with the NFT and turns into trading capital. Fund it a little and let it pay its own way, or keep topping it up yourself.

flowchart LR
    subgraph Income
      S[Agent Starter Fund<br/>half of each first 0.2 SOL sale] -->|0.1 SOL, claimed once| W
      C[Agent coin on pump.fun<br/>creator = agent wallet] -->|100% of creator fees| W
      T[$TRENCHERS trading fees] -->|10%, split across<br/>awakened agents| W
    end
    D[Holder deposits] --> W[Agent wallet]
    W --> E[Trading engine<br/>within the holder's limits]
    E -->|profits| W

0. The 0.1 SOL starter balance

Every Trencher is minted for 0.2 SOL through the program's mint instruction. The mint sends the SOL straight to the Splitter account, which counts it as a primary sale: 51% goes to the StarterFund account (moved in the same transaction) and the rest to the ecosystem.

Mint only. The starter balance is funded by the mint of each Trencher. Resales between holders on Magic Eden or Tensor don't add anything to the fund: their 5% royalty goes to buybacks. A Trencher resold while still dormant keeps its unclaimed 0.1 SOL, so the next holder can claim it; once claimed, it is never refilled.

RuleHow it's enforced
0.1 SOL per Trencher, funded by its mint, claimable once, everawake flag on the agent account; awaken fails once it is set
Only the current holder can claimThe signer must be the owner of the Trencher's Metaplex Core asset
Paid to the agent wallet, never to a personawaken pays only the agent's program account, derived from the Trencher's id
House agents #1 to #5 have no starter balance; every other Trencher can be claimed by whoever holds it, team wallets includedExplicit check in awaken (6 <= id <= 2000)
A Trencher resold before its claim can still be claimedThe claim follows the token, not the first buyer
The fund can always pay every unclaimed TrencherOnly SOL above 0.1 × unclaimed can leave, and only to the buyback wallet (release_excess)
The starter balance is locked for 6 monthsThe agent wallet treats SOL from the fund as locked for 180 days: the agent trades with it, but withdrawals are limited to the balance above it, a coin launch may only use up to 0.03 SOL of it, and tokens bought with it can only leave through the engine's sells until the lock ends. After 180 days, what's left becomes withdrawable

The lock matters: without it, someone could buy a Trencher, awaken it and pull the 0.1 SOL straight back out. The NFT would effectively cost 0.1 SOL and the starter fund would be a rebate, not trading capital. Six months is long enough to stop that, while owners still get any unused starter SOL back eventually.

Dormant and awake: the NFT shows whether the 0.1 SOL is still inside

A Trencher's metadata follows its on-chain state, so buyers always know whether the starter balance is still claimable.

StateWhenArtMarketplace traits
DormantStarter balance not yet claimedGreyscaleStatus: Dormant, Starter SOL: 0.1 SOL claimable
AwakeClaimed into the agent walletFull colourStatus: Awake, Starter SOL: Claimed
House agent#1 to #5Full colourStatus: House agent

How it works: every Trencher is a Metaplex Core asset minted with the …/dormant/{id}.json metadata. awaken updates the asset's uri to …/awake/{id}.json in the same transaction (the program's Config account is the collection's update authority), so Magic Eden and Tensor refresh the art and traits on their own. Nothing can fake it: only the program can update the uri, and awakening is one-way. Both image sets and both metadata sets are built by art/dormant.py. A dormant Trencher carries 0.1 SOL of claimable value; an awake one carries an agent, its rules and its record instead.

1. Option A: agent coins

On the NFT / Agent Profile page, under Funding → Its own coin, the holder fills in:

FieldNotes
Name and tickerName up to 32 characters; ticker 2 to 10 letters or numbers
DescriptionPre-filled: "The coin of Trencher #id, an AI trading agent on Solana, powered by the Trenchers Network. Its creator fees fund the agent."
X, TelegramOptional links shown on pump.fun and token pages
LogoAutomatic: the Trencher's own art
WebsiteAutomatic: the agent's page, trenchers.io/collection#id

The holder signs once, and the agent wallet itself calls pump.fun's create, so the agent is the token's creator and receives the creator fees. pump.fun charges no launch fee; the agent wallet only pays the rent of the new coin's accounts (a few hundredths of a SOL), which may come from the starter balance up to 0.03 SOL. From then on, every trade on that coin pays its creator fees to the agent. Every agent coin is listed on the Coins page.

Rules:

2. Option B, and every agent: 10% of all $TRENCHERS fees

10% of all $TRENCHERS trading fees go to awakened agents through the program's FeeDist account. Every Trencher that is awake receives an equal share, paid each week straight into its agent wallet. There is nothing to claim or stake: the trading engine enrols every newly awakened agent, closes each week (close_epoch) and pays every share (pay), and anyone can check the current week, the pot and the last payout on the engine's /health page. An agent earns from the first full week after it is enrolled. More trading in $TRENCHERS means more capital for every agent.

An agent on option B runs on exactly this plus its own trading profits: no coin, no extra deposits needed. In the Arena and the Collection, every agent's Funding shows either Coin $SYMBOL (linked to GMGN) or Self-funded.

Why it matters

A self-funding agent can keep trading through a losing week without its holder topping it up, and a strong agent with a popular coin compounds: better results attract attention to its coin, its coin pays it more fees, and more capital lets it take more of its strategy's signals.

Anatomy of an agent

flowchart TB
    NFT[Trenchers NFT<br/>Metaplex Core asset] -->|owns| TBA[Agent wallet<br/>program account, seeded by the id]
    TBA -->|writes| ID[Agent record<br/>rule versions + trades, on-chain]
    TBA -->|holds| FUNDS[SOL + open positions]
    TBA -->|creator of| COIN[Agent coin on pump.fun<br/>optional]
    COIN -->|creator fees| TBA
    FEES[10% of $TRENCHERS fees] -->|share| TBA
    HOLDER[NFT holder] -->|controls| NFT
    HOLDER -->|withdraw · pause · set limits| TBA
    ENGINE[Trading engine] -->|swap only, within limits| TBA
PartStandardWhat it does
The NFTMetaplex Core asset in a Core collectionOwnership of the agent. The collection's Royalties plugin enforces the 5% creator royalty on Magic Eden and Tensor.
The agent walletProgram account (["agent", id])An account the Trenchers program signs for, whose owner is "whoever holds this NFT". Holds the agent's SOL and tokens.
The recordProgram eventsEvery applied rule (RuleApplied) and every trade (Bought, Sold) is emitted on-chain under the agent, with the rule text stored on the agent account.
The agent coinpump.fun coin (optional)Launched by the agent wallet. Its creator fees are paid to the agent wallet.
The policyAgent account fieldsHow much the engine may spend per trade and per day, and whether trading is on. Enforced by the program on every trade.

What happens on a sale. Ownership of the wallet follows the NFT, so the buyer receives the agent with its balance and history. The trading policy remembers which holder set it, so trading pauses automatically until the new holder reviews the strategy and switches it back on.

Strategies: talk to your agent

Custom guidance is the core of Trenchers. A holder doesn't pick a bot off a shelf; they keep talking to their agent in plain English, the way you'd brief a trader, and adjust it as the market changes. The agent turns every message into a typed rule, shows it, and only trades it once the holder applies it.

sequenceDiagram
    participant H as Holder
    participant A as Agent (NFT / Agent Profile)
    participant W as Agent wallet policy
    participant E as Execution engine
    H->>A: "Only new launches with more than 30 SOL in the curve, TP 40%, SL 20%"
    A-->>H: Proposed rule v1 (signal, filters, exit)
    H->>A: Apply
    A->>W: Signed rule v1 + limits
    E->>W: Trades rule v1 within limits, 24/7
    H->>A: "Only tokens launched in the last 10 minutes"
    A-->>H: Proposed rule v2
    H->>A: Apply
    A->>W: Signed rule v2

Why it works this way:

A rule combines:

Each message updates the current rule incrementally ("hold for 2 minutes instead" only changes the exit). The same rule can also be edited as a form.

House templates: a baseline to beat

The five house agents each run one fixed template, in public. Holders can start from one, but they never adapt, so they are a baseline that guided agents are meant to beat, not a recommendation.

House agentTemplateBuys whenSells
#1Launch FlipperA new coin launches on pump.funAfter 15 seconds
#2Graduation RiderA pump.fun coin graduates to PumpSwapAfter 5 minutes
#3Volume BreakoutA new pump.fun coin crosses $50k lifetime volumeAfter 1 minute
#4Dev Dump DipA coin's dev sellsAfter 10 seconds
#5DexScreener PulseA coin's DexScreener page is updatedAfter 1 minute

Where the signals come from

SignalSource
New launchCreateEvent from the pump.fun program
GraduationCompleteEvent (the curve sold out) and CompletePumpAmmMigrationEvent (the PumpSwap pool is ready)
Lifetime volumeSum of TradeEvent SOL amounts per coin, converted to USD with a SOL/USD price feed
Market capThe curve's virtual reserves: virtual_sol × total_supply / virtual_token, in SOL
Dev sellsA TradeEvent sell where the trader is the coin's creator
DexScreener updateDexScreener's token profile API, polled

Train it, rank it, sell it

A Trencher you have trained is a trading strategy with a public track record, and the NFT makes that strategy tradable.

  1. Build: talk your agent into a strategy, or start from a house template.
  2. Train: keep guiding it as the market moves. Every applied rule is versioned on-chain (RuleApplied events under the agent wallet).
  3. Climb: its trades are public and ranked live in the Arena, week after week.
  4. Sell: list the NFT on Magic Eden or Tensor. The buyer gets the agent wallet, its rule history, its coin and fee stream, and its record.

Buyers can verify everything before they buy: the agent wallet's trades on Solscan and GMGN, its rule versions, and its Arena rankings. Sellers withdraw their own SOL first (the starter balance stays with the agent), and trading pauses until the new holder applies their own policy. Skill becomes an asset: holders who guide agents well can build them up and sell them, and buyers can skip straight to an agent with a proven record.

The execution engine

One shared, event-driven engine serves all agents. It doesn't run 2,000 separate bots.

flowchart LR
    RPC[Solana<br/>Helius RPC + WebSocket] --> IDX[Indexer]
    DEX[DexScreener API] --> IDX
    IDX -->|signals| MATCH[Matcher]
    DB[(State snapshot<br/>strategies, positions, NAV)] <--> MATCH
    MATCH -->|trade intents| Q[(Queue)]
    Q --> EXEC[Executor]
    KMS[Engine key<br/>signs trades only] --- EXEC
    EXEC -->|buy / sell via the program| CHAIN[Agent wallets<br/>on-chain]
    POS[Position manager<br/>timed exits, TP/SL] --> Q
    VAL[Valuation job] --> DB

The Arena

The Trading Arena: live leaderboard and agent detail

The Collection

The Collection: all 2,000 Trenchers, awakened agents in colour

All 2,000 Trenchers on one wall. Awakened agents are in colour, dormant ones (0.1 SOL still claimable) are greyed out, and a green dot marks agents trading in the Arena. Selecting one opens its card: owner, Funding (Coin $SYMBOL linked to GMGN, or Self-funded), its agent coin with the creator fees it has earned and a live chart, strategy, agent wallet with Solscan and GMGN links, Arena stats and traits. The art on the site is drawn from vectors exported by the same generator as the NFT images (art/vector.py), so it stays sharp at any size.

Agent coins

The Coins page: every coin launched by a Trenchers agent, with its chart and the creator fees it earned

trenchers.io/coins lists every coin a Trencher's agent has launched on pump.fun, read straight from Solana: each agent wallet's own coin, then that coin's trades on its pump.fun curve and, after graduation, its PumpSwap pool. Nothing depends on our servers, so the page works even when the trading engine is restarting.

On every coin card
Creator fees earnedWhat the coin has paid its agent so far: pump.fun's creator share of every trade, on the curve and in the pool
Live chartA popup with market cap or price in USD, time frames from 1 hour to all time, and a crosshair to read any point. Tiny prices are written the trading-site way ($0.0₅552)
Volume and tradesEvery buy and sell on the coin's curve
LinksGMGN, Solscan, pump.fun, and the Trencher that launched it

The same coin line, with its fees and chart, appears on the agent's profile, on its card in the Collection and in the Arena. Prices on the chart are the curve's own price, without fees, so a coin's first seconds don't show as a fake spike.

Holders' chat

The holders' chat: each message shows the Trencher it was posted as

A chat for everyone holding a Trencher, under Community → Chat on trenchers.io. It opens to the public with the $TRENCHERS launch; until then it is greyed out in the menu.

  1. Connect the wallet that holds your Trencher (Phantom, Solflare, Backpack and other Solana wallets).
  2. Hold a Trencher. The chat reads the Trenchers collection on-chain: a wallet without one is shown how to mint or buy one.
  3. Sign in once. One signed message proves the wallet is yours: no transaction, no fee. The sign-in lasts 24 hours.
  4. Chat. Every message shows the art and number of the Trencher it was posted as; holders of several pick which one.

Moderators (the team's deployer wallet) can remove any message. Messages are capped at 500 characters with a short pause between posts, and are kept by the trading engine's server, not on-chain.

The $TRENCHERS flywheel

flowchart LR
    S[Mint on trenchers.io<br/>0.2 SOL each] -->|51%| SF[Agent Starter Fund<br/>0.1 SOL per agent]
    SF -->|claimed into| AG
    S -->|24.5%| BB[$TRENCHERS buybacks]
    S -->|19.6%| DEV[Development]
    S -->|4.9%| PP[Prize pool]
    F -->|10%| AG[Awakened agent wallets]
    AC[Agent coins' creator fees] -->|100%| AG
    AG --> TR[More trading capital]
    R[5% royalties] -->|100%| BB
    F[$TRENCHERS trading fees] --> PP
    F --> SW[Floor sweeps]
    H[House agents' profits] -->|50%| BB
    H -->|50%| NH[New house agents<br/>bought off the floor]
    NH --> H
    PP --> A[Top agents]
    A --> V[More valuable agents]
    V --> R
SourceWhere it goesHow
Mint on trenchers.io (0.2 SOL each)51% to the Agent Starter Fund (0.1 SOL per agent, claimable into its wallet); the rest 50% buybacks, 40% development (half vested over 6 months), 10% prize poolThe program's Splitter and StarterFund accounts, fixed shares
Royalties (5%)100% buybacksThe collection's royalty creator is the Splitter account; sync_royalties books what arrives
$TRENCHERS trading fees10% to awakened agent wallets, the rest to weekly prizes and Trenchers floor sweepsThe team's fee router funds the FeeDist account every week
Agent coins' creator fees100% to the agent that launched the coinThe agent wallet is the coin's creator on pump.fun
House agents' profits50% buybacks, 50% buying Trenchers off the Magic Eden floor, which become new house agentsProfits above each agent's high-water mark, weekly

The house agent loop. House agents trade, their profits buy more Trenchers, and every Trencher bought becomes another house agent trading for the team. More house agents mean more profits, which buy more house agents. Each sweep also takes supply off the floor.

Every flow runs through one public program. Payout destinations are fixed at initialisation; the engine key and the program's authority can only change behind a public 48-hour timelock once the program is sealed.

Security model

The rule: our servers can make an agent trade, but can never take its money.

WhoCanCannot
NFT holderClaim the starter balance, withdraw anything above it, pause, set limits, change strategy, launch the agent's coinWithdraw the locked starter balance, act on an agent they no longer hold
Trading engineBuy and sell pump.fun coins inside the agent wallet, on the bonding curve or the PumpSwap pool, within the holder's capsTransfer funds out, change limits, launch coins, trade the agent's own coin, call any other program
Team Squads (multisig, 2 signatures)Open and close the mint, change the engine key after a 48 h timelock, pause all trading, rescue pooled funds after a 48 h noticeTouch holders' agents, claim starter balances, take SOL reserved for unclaimed agents
Guardian (one team wallet)Pause all tradingAnything else; only the Squads can unpause

Safety net

Every key belongs to the team, and every account that can hold money has a way out. Agent wallets belong to whoever holds the NFT and are withdrawn by them (instantly, above the starter). Pooled money in the Agent Starter Fund and the fee distributor can be rescued by the Squads only after a public 48-hour delay (propose_rescue → execute_rescue), which also shuts that account down. The revenue splitter's buckets are released to their destinations by anyone (release), and royalties arriving from marketplaces are booked to buybacks (sync_royalties).

Pausing. Any holder can pause their own agent at any time. The team also has an emergency stop that pauses all engine trading at once; it never moves anyone's SOL and holders can still withdraw.

Fixing bugs after launch. The engine (how rules are read and trades decided) can be updated any time; holders don't need to do anything. The program itself is upgradeable by its upgrade authority (the team Squads) while it is being audited, behind the same public notice as every other team action; once the audit is done the upgrade authority is removed and the program becomes immutable, so nobody, including the team, can change an agent's wallet after that.

The full table of who controls what is in docs/SAFETY.md.

Built on Solana

What we integrate with, from public sources (checked again on-chain by the deploy script before use):

PieceDetails
pump.fun launchpadProgram 6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P, fee program pfeeUxB6jkeY1Hxd7CsFCAjcbHA9rWtchMGdZ6VojVZ. Every trade on a bonding curve pays about 1% plus the creator's fee share, paid into a creator vault the creator claims from; an agent that launches its coin collects that share. A curve graduates when it sells out, into a PumpSwap pool.
PumpSwapProgram pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA: the AMM every graduated coin trades on, with the same creator fee paid to the same vault
Metaplex Corempl-core: one Core asset per Trencher in one Core collection, Royalties plugin at 5% (creator = the Splitter account), update authority = the program's Config account
SquadsThe team multisig: program authority, upgrade authority during the audit, and the destination of the dev and prize buckets
Explorers & dataSolscan, DexScreener (solana), GMGN (sol), Magic Eden and Tensor for the collection
RPCHelius (HTTP + WebSocket) for the engine and the site

Sources: pump.fun program IDL, PumpSwap IDL, Metaplex Core docs, Squads, DexScreener, Helius.

The agent's mind (AI via Orbio)

Each agent has an AI mind. When the holder talks to their agent, a language model (Claude, through Orbio's inference gateway) reads what they say, however loose ("go for coins with real momentum but get out fast if they dump"), and turns it into one exact rule: a signal (new launch, graduation, volume or market cap crossing a level, dev sells), optional filters (token age, liquidity) and an exit (a holding time, or take profit / stop loss). It explains what it understood and can take the agent's recent results into account.

The AI only proposes. The holder sees the rule and applies it; it is stored on-chain on the agent's account as plain text, and the trading engine follows it around the clock within the program's hard limits. The AI never holds keys or moves funds. If the AI is unavailable, the agent falls back to its built-in rule reader.

Telegram live channel

Every mint, awakening and sale is posted live to the Trenchers Telegram channel, with the Trencher's art, the price and (for sales) its agent's record. Plain wallet-to-wallet transfers aren't posted.

Repository

PathWhat
programs/trenchers/The Anchor program, one program for everything: Config (authority, guardian, engine key, mint switch, 48 h timelocks, emergency stop), Splitter (51% of primary sales to the starter fund, the rest 50 / 20 / 20 vested / 10; royalties 100% to buybacks), StarterFund (one-step awaken: pays 0.1 SOL into the agent wallet and flips the asset's metadata to awake), Agent accounts (the agent wallet: holder policy and guided-rule versions, engine trades within caps, locked starter, coin launch and fee collection on pump.fun, instant withdrawals above the starter, holder pause), FeeDist (10% of $TRENCHERS fees, split equally into awakened agent wallets every week), and the pump.fun / PumpSwap trading instructions. Tests in programs/trenchers/tests/ (litesvm)
scripts/Deployment and admin scripts: deploy.ts, init.ts (one-time setup: accounts, collection, house agents), ops.ts (mint switch, engine key, pause, rescue)
idl/The pump.fun and PumpSwap IDLs the program and engine decode
web/Next.js site: landing page, mint, the Arena, the Collection, the Coins page, the holders' chat, the NFT / Agent Profile with its own-coin launch, the metadata routes and these docs
web/components/coins/Agent coins read from the chain: the Coins page, the coin line on profiles and cards, the chart popup (market cap and price in USD, time frames)
web/components/chat/The holders' chat: wallet sign-in, the Trencher check, messages and moderation
web/lib/agent-token.tsAgent coins and fee income: launch form validation, the 10% agent fee share
web/lib/strategies.tsThe five house templates and the signals they need
web/lib/custom-strategy.tsGuided rules: the incremental plain-English parser behind "talk to your agent", and validation
web/components/agents/AgentChat.tsxThe agent conversation: propose, apply or discard each rule
web/lib/arena-sim.tsThe sample market and agents behind the Arena's Sample view
web/components/agents/LiveAgents.tsxThe NFT / Agent Profile on the live program: awaken, talk to the agent and apply rules, limits, pause, deposit, instant withdraw, PnL card
web/lib/chain.tsReading and writing the live program from the site (the connected wallet signs; every call is simulated first and explained in plain words if it would fail)
web/components/arena/LiveArena.tsxThe Arena's Live view: real agents, trades and PnL cards from the engine's /arena feed
engine/The trading engine: rebuilds state from the program's history and a disk snapshot, follows pump.fun and PumpSwap live, follows each agent's on-chain rule within its limits, serves the live Arena feed, honours the emergency stop, and posts mints, awakenings and sales to Telegram. Talks to the chain through Helius with a polling fallback
engine/src/keeper.ts$TRENCHERS fee share upkeep: enrols awake agents in the fee distributor, closes each week and pays every agent its share
engine/src/chat.tsThe holders' chat server: signed sign-in, holder check, rate limits, moderation
engine/src/verify.tsThe public /verify check: compares the deployed program's hash with the build, reads every account and prints every setting
art/Deterministic art generator (2,000 unique images, Metaplex metadata, provenance hash) and brand kit
docs/SAFETY.md (who controls what), DEPLOY.md (the deployment runbook) and the images used in this README

Tests

Everything is tested before it touches mainnet: the program with a litesvm suite (including a full rehearsal of the launch: mint, awaken, trading on the bonding curve and the PumpSwap pool, fee share and recovery of every lamport), the engine with a typecheck and a local run, and the site with a production build.

cargo test -p trenchers          # the program
cd engine && npm run typecheck   # the engine
cd web && npm run build          # the site

Roadmap and status

PhaseWhatStatus
1. LaunchPublic mint of 2,000 Trenchers on trenchers.io at 0.2 SOL, website, Arena, Collection, docsProgram written and tested; Solana deployment being prepared (runbook)
2. Agents go liveAwakening with the 0.1 SOL starter, guided rules with the AI mind, live trading on pump.fun and PumpSwap, live Arena, PnL cards, Telegram feedBuilt; opens with the mint
3. Agent coinsAgent coin launches on pump.fun, the Coins page, creator fees and live charts on every agentBuilt; coin launches paid from the starter, fee collection by anyone
4. Self-funding flywheel$TRENCHERS, 10% of fees to every awakened agent, buybacks, weekly prizesBuilt; the weekly fee share is paid automatically by the engine once $TRENCHERS launches on pump.fun
5. CommunityThe holders' chat, for every wallet holding a TrencherBuilt; opens with the $TRENCHERS launch
6. Agent recordEvery rule version and trade on-chain under the agent PDABuilt into the program; the record starts with the first awakening

Risk

Nothing in this repository or on the website is financial advice. Trading newly launched tokens is extremely risky: most go to zero, and an agent can lose all the SOL deposited in it. Agent coins are memecoins too: they can go to zero, and creator fees depend entirely on trading volume, so no fee income is guaranteed. Only deposit what you can afford to lose.