SolStack Documentation — Solana Bundler & Launch Terminal

01 · Fundamentals

Introduction to SolStack #

SolStack is an all-in-one Solana token creation, multi-wallet management, and atomic launch bundler platform designed for token creators, project leads, and decentralized teams.

When launching a token on Solana liquidity curves (such as Pump.fun), standard sequential transactions expose creators to severe frontrunning, MEV sandwich attacks, and third-party sniper bots that purchase supply before creator transactions can land. SolStack solves this by bundling your token creation and multiple sniper wallet purchases together into the exact same block.

⚡

Atomic Single-Block Launch

Your token mint instruction and all designated wallet buys execute in a unified block, guaranteeing clean initial distribution with zero bot interference.

🛡️

W1 → W2 → W3 Routing

Fund dozens of project wallets from a single deposit without clustering or linking them on-chain, preserving authentic wallet separation.

◫

VAMP Metadata Importer

Instantly mirror or import verified token assets, names, symbols, and descriptions directly from any existing Solana mint address.

User Focus

This manual is written directly for SolStack users. Keep SolStack open in one browser tab and this documentation in another for an immediate, step-by-step companion guide through every screen and option.

02 · Architecture

How Bundling & Disperse Works #

To achieve optimal token launches without on-chain wallet clustering, SolStack utilizes two core mechanisms: Atomic Launch Bundles and the Simple W1 → W2 → W3 Funding Protocol.

1. The Atomic Launch Bundle

On Solana, transactions that are submitted independently get ordered by validators sequentially or by priority fee auction. If a creator deploys a token in Transaction A and buys with Wallet 1 in Transaction B, high-frequency bots will sandwich between Transaction A and Transaction B.

With SolStack's Bundle Mode, your token launch is assembled into a coordinated transaction cluster. The token is minted by the designated DEV wallet and simultaneously purchased across your selected project wallets at the absolute starting curve price before public traders or bots can enter.

2. The Simple W1 → W2 → W3 Funding Protocol

Before launching, your project wallets must hold SOL to pay for network rent, gas fees, and token buys. If you send SOL directly from your personal wallet or exchange to 10 sniper wallets, bubble maps (such as Bubblemaps.io) will clearly link all 10 wallets to your single source address.

SolStack prevents this linkage using an automated 3-tier routing process:

W1 → W2 → W3 Disperse Architecture Atomic Solana Instruction Sets

TIER 1 · W1

Temporary Deposit

A single-use disposable keypair generated for your order. You send your total SOL budget here once.

→

TIER 2 · W2

Ephemeral Routers

Unique intermediary keypairs created per destination route. Bundled in memory to break cluster linkage.

→

TIER 3 · W3

Project Wallets

Your target DEV and sniper wallets. Funds arrive clean, ready to execute token buys.

Automated Route Bundling

Each route transfers from W1 → W2 and W2 → W3 in a single versioned transaction. Solana validators process both transfers together, ensuring clean non-clustered distribution without manual transfers.

03 · Interface

Dashboard & Workspace Navigation #

The SolStack application provides a clean, streamlined dark terminal interface centered around fast project execution and real-time wallet tracking.

Top Navigation Bar

The persistent top navigation bar is accessible from all primary views:

SolStack Brand Logo: Click to immediately return to the main dashboard.
Dashboard: Overview of account statistics, live SOL price, net launch volume, and recent project history.
Projects: Dedicated workspace to filter, resume, or delete your token creation projects.
Wallets: Comprehensive wallet manager with creation, importing, live balance queries, key inspection, and disperse history.
+ Create Project Button: Opens the 4-step project creation wizard as a centered floating panel over your current view.
Profile Popover (Discord): Displays your connected Discord avatar, username, and account sign-out option.

Dashboard Metrics & Flow Panels

Welcome & Metric Cards

Displays your display name, current system date, total Tokens launched all-time count, and connected SOL balance.

Net Flow Panel

Tracks SOL launch volume across the last 30 days and today. Includes a live green heartbeat pulse indicator.

Project History Panel

Displays chronological records of your launched tokens with direct access to view project details or start new drafts.

Status Bar (Footer)

The fixed footer at the bottom of the screen displays official resource links (Docs, Discord) alongside a live, auto-updating SOL Price Ticker in USD.

04 · Wallets

Wallets Workspace #

The Wallets page (wallets.html) is where you generate, import, fund, and organize the Solana keypairs dedicated to each token project.

Horizontal Project Picker Rail

Wallets in SolStack are organized per project. At the top of the Wallets workspace, the horizontal project picker lets you smoothly switch between your token projects using your mouse wheel or touch scroll. Click the + New button anytime to open a new project.

Workspace Subtabs

Wallets (Count): View, search, inspect keys, and delete keypairs assigned to the active project.
Disperse History: Review past and active W1 → W2 → W3 funding runs, monitor pending deposit countdowns, and export complete transaction backups.

Action Command Bar Explained

Button	Action Name	What It Does & How It Works
`◆ DEV`	Set DEV	Assigns the single selected wallet as the project's primary DEV wallet. The DEV wallet is responsible for deploying the token and receives the prominent teal DEV badge.
`+ CREATE`	Create Wallets	Opens a dialog to generate between 1 and 10 real Solana keypairs in a single batch. Wallets are named sequentially with your project's prefix (e.g. Aqua Falcon Wallet 01).
`↧ IMPORT`	Import Wallets	Opens a modal to import existing private keys. Supports Base58 strings, byte arrays (`[12, 45, ...]`), or `privateKey\|Label` format (one per line).
`⚡ FUND`	Fund / Disperse	Opens the Simple W1 → W2 → W3 disperse funding dialog to automatically split and transfer SOL across selected wallets without cluster linkability.
`⇧ EXPORT`	Export Wallets	Downloads a `solstack-wallets.txt` file containing the private keys and labels of all selected wallets (or all wallets if none selected).
`⟳ BALANCES`	Check Balances	Queries live on-chain balances from the Solana RPC for all project wallets simultaneously and updates the display in real-time.
`$ COLLECT`	Collect	Placeholder for sweeping remaining balances from project wallets back to your main treasury.

Individual Wallet Rows

Each wallet row contains vital information and controls:

Selection Checkbox: Select individual wallets for bulk deletion, exporting, or DEV assignment.
Index / DEV Badge: Displays DEV in bright teal for the creator wallet, or a sequential two-digit order index (01, 02, 03...).
Wallet Label & Type: Displays the custom or generated name, with subtitles indicating Primary DEV wallet, Project wallet, or Imported wallet.
Public Address: Truncated Solana address. Click the address to instantly copy the full public key to your clipboard.
Live SOL Balance: The confirmed on-chain balance held by this wallet.
Keys Button: Opens the Wallet Security modal showing the Public Key and Base58 Private Key with one-click copy buttons.
Delete Button: Removes the wallet from the project with confirmation. Deleted wallets are automatically archived server-side.

Assigning the DEV Wallet

Every launch project requires exactly one DEV wallet. To change which wallet acts as DEV, select its checkbox in the wallet list and click the ◆ DEV command button.

05 · Funding Guide

Funding & Disperse Guide (Step-by-Step) #

Distribute SOL across your project wallets smoothly, securely, and without creating detectable on-chain clusters.

Step-by-Step Disperse Workflow

1

Open Disperse Modal

Trigger

Click the ⚡ FUND button in the Wallets workspace toolbar or click ⚡ Fund on Step 2 of the Project Creation Wizard.

2

Choose Amount & Distribution Mode

Configuration

Enter the SOL amount and select how funds should be calculated across wallets:

Split Total Evenly: You enter a fixed gross budget (e.g. 2.5 SOL). SolStack calculates the network routing fees and divides the net payout equally across all selected destinations.
Per Wallet Amount: You specify the exact SOL amount each wallet must receive (e.g. 0.25 SOL per wallet). SolStack adds the routing fees to determine your exact required deposit.

3

Select Destination Wallets

Recipients

Use the checkboxes in the destination list to choose which wallets to fund. You can include or exclude the DEV wallet and use Select All / Deselect All.

4

Create Order & Deposit SOL

Execution

Click ⚡ Create Disperse Order. SolStack generates a dedicated temporary W1 deposit address with a QR code and a 180-second (3-minute) countdown window. Scan the QR code or copy the W1 address from your Phantom, Solflare, or exchange wallet and transfer the required SOL.

5

Automated Detection & Dispatch

On-Chain Delivery

SolStack automatically polls Solana RPC every 1.5 seconds. As soon as your deposit confirms at W1, the bundled routing instructions dispatch immediately through ephemeral W2 keypairs to your destination wallets. The modal updates live to SUCCESS.

Budget-Capped Distribution

Ideal when you have an exact budget of SOL (e.g. 5.0 SOL) and want to fund 10 wallets. The routing fees (~0.0001 SOL per route) are subtracted from the gross deposit so your deposit never exceeds your budget.

Formula

Net Payout Per Wallet = (Total Deposit - Network Routing Fees) / Destination Count

Fixed-Allocation Distribution

Ideal when every sniper wallet must hold an exact amount of SOL for its launch buy (e.g. exactly 0.50 SOL per sniper). SolStack computes the gross deposit by adding the tiny routing fees on top.

Formula

Total Required Deposit = (Per Wallet SOL * Destination Count) + Network Routing Fees

180-Second Deposit Timer & Key Safety

Funding orders remain open for 180 seconds. Always send funds with reasonable priority fees from your funding wallet so the transaction confirms before the timer expires.

Safety Feature: In the active order screen, click 💾 Export Temp Wallet or visit Disperse History → 💾 Backup (W1, W2, W3) to download the complete private keys JSON. Even if you close your browser or experience internet loss, your funds can never be trapped.

06 · Project Setup

Step 1: Token Metadata & VAMP #

Clicking + Create Project opens the 4-step launch wizard. Step 1 configures the public token metadata, branding, and platform settings.

Form Fields & Validation

Field	Status	Constraints	Description
Name	Required	Max 40 characters	The public name of your token as displayed on Pump.fun and DEX aggregators.
Symbol	Required	Max 10 characters	Ticker symbol (automatically converted to uppercase, e.g. `SOLSTACK`).
Description	Optional	Max 500 characters	Project narrative, roadmap teaser, or token backstory.
Website	Optional	Valid URL	Official project website link (e.g. `https://solstack.space`).
X URL	Optional	Valid URL	Official X (Twitter) profile link (e.g. `https://x.com/solstack`).
Telegram	Optional	Valid URL	Community chat or announcements channel link (e.g. `https://t.me/solstack`).
Token Image	Recommended	PNG, JPG, GIF, WEBP · Up to 5 MB	Square token icon or animated GIF. Drag and drop directly onto the upload card.
Platform	Preset	Pump.fun (Active)	SolStack is natively optimized for Pump.fun bonding curves.
Quote Currency	Preset	SOL	Primary Solana base quote currency for the launch curve.
Mode	Selectable	Classic vs Mayhem	Curve initialization preset. `Classic` is standard bonding curve behavior.

The VAMP Tool (Token Cloning / Forking)

The VAMP button (located at the top right of Step 1) allows you to clone public on-chain metadata from any existing Solana mint address into your project in seconds.

1

Click VAMP Button

Click ◫ VAMP in the Step 1 heading to open the VAMP Metadata modal.

2

Paste Mint Address

Paste any valid Solana token contract address and click Load metadata.

3

Review & Apply

A preview card will render displaying the token's image, name, symbol, and description. Click Use metadata to automatically fill all corresponding fields in your draft.

07 · Allocations

Step 2: Project Wallets & Buy Amounts #

Step 2 brings the wallet management workspace directly into the wizard. Here you configure which wallets will participate in the launch and how much SOL each wallet will spend.

Wizard Mini-Actions

+ Create wallet: Quick-generate new Solana keypairs without leaving the creation flow.
↧ Import: Paste private keys for existing funded wallets you wish to use.
⚡ Fund: Launches the W1 → W2 → W3 Disperse modal directly from the wizard to fund your wallets immediately.
⟳ Balances: Refreshes live on-chain balances from Solana RPC to ensure all wallets have sufficient SOL.

Setting the "SOL buy" Amount

Every wallet row features an explicit SOL buy numeric field. Enter the exact amount of SOL that this specific wallet should spend during the bundle execution.

DEV Wallet Buy: The amount of SOL spent by the token creator wallet upon initialization.
Sniper Wallets Buy: The amounts spent by each subsequent wallet in the bundle.
0 SOL Buys: If a wallet is assigned 0 or left blank, it will not participate in the buy block.

Balance vs Buy Amount Validation

A wallet cannot spend more SOL than its confirmed on-chain balance. Always ensure each wallet holds enough SOL to cover its SOL buy amount + network transaction fee + account rent reserve (~0.003 SOL).

08 · Execution Strategy

Step 3: Buy Mode Selection #

Step 3 allows you to define how your project wallets will interact with the Solana blockchain during deployment.

Bundle Mode

Bundles all project-wallet buy instructions together into the exact same launch block as token initialization.

Maximum initial curve impact
Zero exposure to sniper bots or MEV frontrunners
Uniform initial entry pricing across all wallets

Dev Buy Only Mode

Launches the token using only the designated DEV wallet. Secondary project wallets are excluded from the initial block.

Minimal initial market cap
Allows manual secondary buys after launch
Lower overall initial SOL commitment

09 · Review

Step 4: Overview & Pre-Flight Review #

The Overview step gives you a complete summary of all project metadata, social links, wallet allocations, and platform configurations before any transactions are signed.

Pre-Flight Review Checklist

Component	What to Verify	Visual Location
Token Card	Verify token image, name spelling, uppercase symbol, and description.	Top metadata preview article
Social Links	Confirm that Website, X URL, and Telegram links point to the correct destinations.	Review links definition list
Wallet Count	Ensure all intended project wallets are detected.	Left metric card (`Wallets`)
Total Buy	Verify the aggregate SOL that will be spent across all participating wallets.	Center metric card (`Total Buy`)
Dev Buy	Confirm the specific buy amount allocated to the DEV creator wallet.	Right metric card (`Dev Buy`)
Platform & Mode	Confirm platform is `Pump.fun` and Buy mode is `Bundle`.	Bottom launch summary strip

Automated Balance Pre-Scan

When navigating to Step 4, SolStack automatically queries Solana RPC in the background to scan the on-chain balances of every project wallet, ensuring there are no funding shortfalls before you deploy.

10 · Execution

Deploy & Execute Bundle #

Once Step 4 is verified, clicking Deploy Token opens the real-time execution modal.

Execution Lifecycle States

The deploy modal guides you through each stage of the broadcast:

1. READY TO DEPLOY: Pre-flight verification modal showing total buy in SOL, wallet count, and a final confirmation button.
2. DEPLOYING TOKEN...: Transactions are compiled, cryptographically signed by your wallets, and submitted to the Solana RPC. The status dot pulses amber.
3. TOKEN DEPLOYED: All transactions have landed and been confirmed by Solana validators. The status badge turns green.

Real-Time Transaction Results

When execution completes, the modal displays an itemized row for every wallet:

Wallet Name: The identifier of the wallet (e.g. Dev Wallet or Wallet 02).
Status: Shows Confirmed in green, or Skipped if no buy was assigned.
Solscan Link (Solscan ↗): Clickable link directly opening the transaction signature on Solscan.io to view confirmed block height, gas used, and token transfer logs.

11 · Post-Launch

After Execution & Project Tracking #

What happens after transactions land on-chain, and how to manage your launched token.

Project State Transition

Once deployed, your project transitions from Pending to Deployed:

Projects Workspace: The project card displays a green Deployed badge, timestamp of deployment, and historical records.
Dashboard Net Flow: The SOL spent during your launch is tracked on the Net Flow launch volume panel.

Exporting Private Keys for Trading

To manage or sell tokens acquired by your project wallets:

Navigate to the Wallets workspace.
Select the project from the top horizontal project picker.
Click ↥ EXPORT to download all private keys as solstack-wallets.txt, or click Keys on any individual wallet row to copy its Base58 private key.
Import the private keys into your preferred trading terminal (Photon, BullX, Trojan, Axiom, Phantom, or Solflare) to manage positions.

12 · Safety

Critical Warnings & Costly Mistakes #

Avoid these frequent mistakes that can result in failed launches, stuck orders, or missed blocks.

1. Always Account for Solana Account Rent & Fees

On Solana, every wallet requires a minimum balance (~0.002039 SOL) for account rent exemption, plus ~0.0005 SOL to pay transaction message fees. If a wallet has exactly 0.50 SOL balance and you assign a 0.50 SOL buy, the transaction will fail due to insufficient funds for gas. Always leave at least 0.003 to 0.005 SOL buffer per wallet.

2. Never Close Browser Without Exporting Keys

When creating projects and generating test wallets, always click ↥ EXPORT in the Wallets tab to save a local solstack-wallets.txt copy of your private keys. If you clear browser cookies or localStorage without exporting, your wallet records will need to be re-imported from backup.

3. Ensure Your Funder W1 Deposit Lands Before the Timer Expires

Funding orders run on a 180-second window. If you send funds from a centralized exchange (e.g. Binance, Coinbase) that imposes withdrawal approval delays of 5–10 minutes, the order will expire before funds arrive on-chain. Always fund W1 from a personal self-custody wallet (Phantom, Solflare) with immediate broadcast.

4. Verify DEV Wallet Assignment Before Deploying

Check the DEV chip on Step 2. If the DEV wallet is assigned to an empty wallet or a wallet with 0 SOL, token creation cannot execute. Confirm that your intended creator wallet carries the teal DEV badge.

13 · Reference

Troubleshooting & FAQ #

Solutions to common issues encountered during funding, metadata validation, or deployment.

My Disperse order expired before I could deposit SOL. What happens to my funds?

If you did not send SOL, no action is required — simply create a new disperse order.

If you sent SOL but the transaction arrived after the 180-second timer reached zero, your funds are safe at the temporary W1 address. Go to Wallets → Disperse History, find the order, and click 💾 Backup (W1, W2, W3). The downloaded file contains the Base58 private key of W1. Import this private key into Phantom or Solflare to access and recover your deposit immediately.

Why is the "Next" button disabled on Step 1: Metadata?

Ensure that both Name (max 40 chars) and Symbol (max 10 chars) are filled. If an image file was uploaded, verify that its size does not exceed 5 MB.

Why does Step 2 say "Create or import at least 1 wallet to continue"?

A project requires at least one wallet to act as the DEV creator. Click + Create wallet in the mini-actions bar or ↧ Import to add a wallet.

How can I verify that my wallets were funded without cluster links?

In the Disperse History tab, expand any completed order. Each route displays an independent Solana transaction signature linking W1 to a temporary W2 address, and W2 to W3. When examined on blockchain visualization tools, your personal funding wallet never appears as a direct cluster parent to your project wallets.

Can I edit or resume a pending project later?

Yes. In the Projects tab, all unlaunched projects appear under the Pending filter. Click the Resume button on any project card to immediately reopen the wizard with all saved metadata, wallet allocations, and draft choices restored.