How It Works

$SHOGUN is a self-replicating token on Solana. The root token spawns child tokens ("sons"). Each son can spawn more sons. Every generation pays 50% of its creator fees upward to its parent as tribute. The remaining 50% is distributed back to holders of that token as cashback. The deeper the empire grows, the more fee tributaries flow to the Shogun.

Every token in the Shogunate has a rank based on its depth in the tree:

• Shogun — Generation 0. The root. All tribute flows here. The most tribute, the most cashback for holders.
• Daimyo — Generation 1. Direct sons of the Shogun. First to receive tribute from below.
• Samurai — Generation 2. Sons of Daimyo. The empire deepens.
• Ronin — Generation 3. Sons of Samurai. Tribute still flows.
• Ashigaru — Generation 4+. Foot soldiers. The frontier of the empire.

Go to the Raise a Son page. Pick a parent token, choose a ticker name (2-10 characters), optionally upload custom art, configure your initial buy (dev buy capped at 2% of supply), connect your wallet, and pay the spawn fee (0.5 SOL). The system creates the token on pump.fun and sets up the tribute config automatically.

Every token has a fee sharing config on pump.fun. When trading generates creator fees:

• • 50% flows upward to the parent token as tribute
• • 50% stays with the token and is distributed as cashback to holders (must hold more than 100K tokens)

This cascades up the tree. A Gen 2 token pays 50% to its Gen 1 parent, which then pays 50% of its total fees (including what it received from below) to $SHOGUN.

The tribute crank runs every 60 seconds, bottom-up — deepest tokens first, so tribute accumulates properly before flowing higher.

Why hold $SHOGUN? It receives tribute from every token in the empire. The more sons that exist, the more tributaries flow to the Shogun. Holders of $SHOGUN get the largest cashback pool.

Why hold a son? Each son also collects tribute from its own children. Buying a Daimyo means you earn cashback from that Daimyo's share of tribute from all Samurai, Ronin, and Ashigaru below it.

Every token is created as a pump.fun tokenized agent with 50% buyback. When someone pays the agent (e.g., to spawn a grandchild), 50% of that payment automatically buys the parent token on the bonding curve or AMM. This creates constant buy pressure flowing upward through the tree.

When you spawn a son, part of the 0.5 SOL spawn fee goes toward an initial buy of the new token. This is capped at 2% of supply — the dev cannot take a larger position. The spawner can configure how much goes to the initial buy vs. the war chest. All parameters are transparent and on-chain.

When any token's war chest exceeds 2 SOL (above the 0.005 SOL reserve), the system automatically spawns a new son. The name is AI-generated from diverse categories. There is a 5-minute cooldown between auto-spawns per parent. The initial buy for auto-spawned sons is capped at 2% of supply — same as manual spawns.

The 50% of fees that stays with each token is distributed to holders proportionally. To qualify for cashback, you must hold more than 100,000 tokens of that specific coin. The server periodically snapshots holders and distributes SOL directly to qualifying wallets. Every distribution is logged on-chain and verifiable on Solscan.

When raising a son, you control four parameters:

You can upload your own image (PNG, JPG, WEBP — max 2MB, square recommended) when spawning. Your image is uploaded to IPFS and becomes the token's permanent avatar. If you skip this, the system generates a sumi-e style avatar automatically.

Tribute flows upward through every generation — not just one level. Each token pays 50% of all its fees, including tribute it received from below. Example with 1 SOL of fees generated at Gen 3 (Ronin):

The Shogunate is built entirely on pump.fun's official Agent Skills — four on-chain primitives that handle all the financial logic. Our server just orchestrates when things happen.

The Shogunate tree updates through two mechanisms working together:

• • Server-Sent Events (SSE) — The backend pushes instant notifications when a son is spawned, tribute is collected, or a war chest changes. The tree re-renders immediately.
• • Polling — As a fallback, the frontend refreshes data every 10 seconds. This ensures updates arrive even if the SSE connection drops.

When a new son is spawned, you will see it appear on the tree within seconds. The node animates in with ink brush effects and the tribute flow lines update automatically.

The system broadcasts seven event types in real-time:

• • token_spawned — A new son has been created
• • spawn_progress — Step-by-step updates during spawn (image gen, IPFS upload, coin creation, tribute setup)
• • tribute_collected — Fees collected and distributed up the tree
• • war_chest_updated — A token's vault balance changed
• • auto_spawn_triggered — System auto-spawned a son from accumulated fees
• • cashback_distributed — SOL distributed to qualifying holders
• • token_status_changed — Tribute config retry succeeded or failed

On the tree visualization, you will see gold particles traveling along the edges between nodes. These represent tribute flowing upward from children to parents. The particles move from the child toward the parent, pulsing with an ember glow. Tokens that have paid more tribute show brighter, more frequent particles.

Every son in the Shogunate gets a unique sumi-e style avatar, generated automatically at spawn time. The system uses AI image generation (Flux model via Replicate) with a prompt tailored to the token's rank and name. The prompt follows the temple aesthetic — ink wash painting, bold brush strokes, rank-colored accents (gold for Shogun, red for Daimyo, dark red for Samurai, gray for Ronin).

The generated image is uploaded to IPFS via Pinata — permanent, decentralized storage. The metadata JSON (name, symbol, description, image URL) is also uploaded to IPFS. This metadata URI is passed to pump.fun during coin creation. The art lives on IPFS forever, even if the website goes down.

Yes. When spawning a son, you can upload your own image (PNG, JPG, or WEBP, max 2MB). Your image is uploaded to IPFS and used as the token's avatar. If you don't upload anything, the system generates a sumi-e style avatar automatically using AI.

Completely. Every fee split, every tribute payment, every cashback distribution is on-chain and verifiable on Solscan. The sharing configs are public. The server wallet balance is displayed on the stats bar.

Yes. Every token in the Shogunate is a real pump.fun token with its own bonding curve / AMM pool. You can buy and sell any token directly from the token detail page.

Nothing special — it just stops generating fees. The tribute config remains on-chain. If trading resumes, tribute flows again. The tree is permanent.

The empire grows progressively. Currently the Shogunate supports 5 generations deep. After migration, we expand the depth limit. Then we keep going — slowly, deliberately — until we have built a true dynasty. There is no final cap. The empire grows as long as the community grows.

0.5 SOL per spawn, paid via pump.fun tokenized agent payment. This covers the initial buy of the new token (capped at 2% supply) and transaction fees. The spawner can configure the split.

One server wallet creates all tokens and cranks tribute. The wallet balance is displayed publicly on the stats bar. All transactions are verifiable on Solscan. The dev buy is capped at 2% per token — no exceptions.