$ cat docs/getting-started.md
Documentation
Everything you need to get started with ForgeTools — setup guides, feature overviews, fees, referrals, and FAQ.
> Getting Started
New to ForgeTools? Start here.
From zero to your first token launch in three steps.
Download the extension
Get the ForgeTools Chrome extension from the download page.
$ open /download
Create your wallet and deposit SOL
Generate a pool wallet inside the extension, then send SOL to fund your first launch.
$ forge wallet create && forge wallet top-up
Deploy your first token from a tweet
Right-click any tweet on X.com and select 'Deploy Token'. Fill in name, symbol, image, and launch.
$ forge deploy --from tweet (47ms)
> Extension Guide
What the extension can do
Tweet Deploy
Right-click any tweet to launch a token tied to that moment. Name, symbol, image, and SOL allocation — all in one flow.
- Context menu on any tweet on X.com
- Pre-filled name and symbol from tweet author
- Custom image upload or auto-generated
- Deploy to Pump.fun in one click
Manual Controls
Full buy, sell, fund, and withdraw controls from the Chrome side panel — no terminal, no switching tabs.
- Buy and sell any Pump.fun token
- Fund pool wallets from your main wallet
- Withdraw SOL to any Solana address
- Live position overview with unrealized PnL
Wallet Management
Create up to 100 pool wallets for bundled launches. Coordinated multi-wallet buys execute atomically in a single transaction.
- Up to 100 pool wallets per account
- Smart SOL distribution based on wallet balances
- Atomic bundle execution — all buys land or none do
- Automatic rotation between deploys
> Hosted Telegram
Operator-only for this release
ForgeLaunch and ForgeAI remain hosted Telegram workflows for qualified accounts. They are not advertised as a public customer command path alongside the extension.
- Access is allowlisted and provisioned out-of-band.
- The first public release uses the ForgeTools extension and shipped product clients; do not rely on Telegram for onboarding.
- See forgetools.top/docs for the current public/private boundary statement.
$ forge telegram --status
> access: private / allowlisted
> onboarding: extension-first
> public marketing path: extension + docs + download
> Private web companion
Portfolio and referrals (extension-linked)
A private web companion may be available at app.forgetools.top for qualified accounts. It is not a public marketing onboarding surface for this release; use the extension and docs as the public path.
Positions & P&L
View open positions across pool wallets when the companion is enabled for your account.
Trade History
Fee-bearing activity with per-transaction fee breakdown when linked from the extension.
Extension-linked access
Connection flows are initiated from the extension for eligible sessions — not a standalone public login requirement.
$ open https://app.forgetools.top
> session: extension-linked (when offered)
> wallets: 16 active
> open positions: 4 tokens
> realized PnL (30d): +18.4 SOL
> unrealized PnL: +3.2 SOL
> Fee Structure
Transparent pricing
1%
Per trade
Applied to supported fee-bearing operations, subject to the minimum fee floor. Deducted in SOL at execution time.
$0
Subscription
No monthly fee. No seat fee. Pay only when you trade.
Shown
In history
Every fee is itemised in your transaction history in the extension and optional private web companion.
> Referral Program
Earn from referred users
Generate a referral code in the extension and earn a percentage of your referred users' fees — paid in SOL, claimable anytime.
Tier 1
20%
Earn 20% of ForgeTools fees from users you referred while you have 1–4 active referrals.
Tier 2
25%
Earn 25% of ForgeTools fees while you have 5–14 active referrals.
Tier 3
30%
Earn 30% of ForgeTools fees while you have 15+ active referrals.
$ forge referral create
> code: FORGE-A4X9
> tier: 1 (20%)
> referred users: 14
> accumulated: 0.84 SOL
$ forge referral claim
> withdrawn 0.84 SOL → your wallet
> FAQ
Common questions
Is my SOL safe?
Wallet keys are encrypted with AES-256-GCM and never leave the server in plaintext. The extension communicates over TLS. Your funds remain on the Solana blockchain — withdraw anytime.
$ forge security --status
> encryption: AES-256-GCM
> key storage: server-side encrypted
> transport: TLS 1.3
> withdraw: available anytime
Who controls my wallets?
ForgeTools creates and manages wallets for you. Private keys are encrypted and stored on the ForgeTools server. You don't need to export or manage keys yourself — just deposit SOL and start trading.
$ forge wallet --info
> type: managed (custodial)
> encryption: AES-256-GCM
> export: not required
> access: extension + optional private web companion
How do fees work?
ForgeTools charges 1% on supported fee-bearing operations, subject to the configured minimum fee floor. No monthly subscription required. Solana network fees (rent, priority fees) are separate and paid to the network. Itemized history is available in the extension and optional private web companion.
$ forge fees --explain
> fee rate: 1% per trade
> minimum fee floor: configured per environment
> deducted: in SOL at execution
> subscription: none
> hidden fees: none
Are there hidden fees?
No. The 1% ForgeTools fee plus the minimum fee floor are the ForgeTools charges. Jito tips and Solana rent are network costs, not ForgeTools charges. Every fee is itemized in your transaction history.
$ forge fees --breakdown
> ForgeTools fee: 1% per trade (minimum fee floor applies)
> network fees: Solana rent + priority
> Jito tips: network cost (bundling)
> other: none
Can I withdraw anytime?
Yes. Use the Withdraw flow in the extension (or optional private web companion) to sweep funds from pool wallets to any external Solana address. No lock-up periods, no withdrawal fees from ForgeTools.
$ forge withdraw --all
> destination: your-wallet.sol
> amount: 4.82 SOL
> status: CONFIRMED (1.2s)
What happens if ForgeTools goes down?
Your funds remain in your wallets on the Solana blockchain. They don't disappear. Use forgetools.top/docs for recovery guidance and support routing.
$ forge status --check
> funds: on-chain (Solana)
> recovery: see docs
> blockchain: always accessible
What's a bundled launch?
Multiple wallets buy a token in a single atomic transaction. Either all buys succeed or none do. This prevents front-running and ensures coordinated entry across all your wallets.
$ forge deploy --bundle --wallets 12
> mint: creating token...
> bundle: 12 buys coordinated
> landed: slot 284,991,032 (47ms)
> status: CONFIRMED
How many wallets can I have?
Up to 100 pool wallets for multi-wallet operations like bundled launches and distributed buying. Create and manage them from the extension.
$ forge wallets --status
> pool wallets: 24 active
> max allowed: 100
> total balance: 14.82 SOL
Can I use ForgeTools on mobile?
The public path for this release is desktop Chrome with the ForgeTools extension (and optional standalone Windows product clients). Hosted Telegram and private web companion access are optional for qualified accounts and are not required to trade through the extension.
$ forge platforms --list
> extension: Chrome desktop (public path)
> telegram: private access only
> web companion: private / extension-linked
What tokens and chains does ForgeTools support?
Solana only. Specifically tokens on Pump.fun (bonding curve) and PumpSwap (post-migration AMM). ForgeTools handles the transition between the two automatically.
$ forge chains --supported
> Solana: Pump.fun + PumpSwap
> migration: auto-detected
> other chains: not supported
How does the referral program work?
Share your referral code. You earn 20% of ForgeTools fees for 1–4 active referrals, 25% for 5–14, and 30% for 15+. Claim flows are available from the extension and optional private web companion.
$ forge referral --info
> your code: FORGE-A4X9
> tier: 1 (20%)
> referred users: 14
> claimable: 0.84 SOL
> Troubleshooting
Common issues
Extension won't load
- >Make sure you extracted the ZIP file before loading it.
- >In chrome://extensions, enable Developer Mode (top right toggle).
- >Click "Load unpacked" and select the extracted folder.
- >If already loaded, click the refresh icon on the extension card.
- >Check that no other wallet extensions are conflicting.
Deposit not showing
- >Deposits usually arrive within 60 seconds.
- >Verify you sent at least 0.05 SOL to the correct address.
- >Check your sending wallet to confirm the transaction was sent.
- >If using an exchange, withdrawals can take 5–15 minutes.
- >Still not showing after 15 minutes? See forgetools.top/docs for troubleshooting.
Transaction failed
- >"Transaction expired" — network was congested, the system retries automatically.
- >"Wallet busy" — a previous transaction is still confirming, wait a few seconds.
- >"Bundle service unavailable" — Jito is temporarily down, retries happen automatically.
- >If a transaction keeps failing, check your SOL balance covers the amount plus fees.
Private web companion issues
- >Make sure the extension is installed and you are signed in.
- >Open the private web companion from in-product links when available.
- >If you see "Session expired", reconnect from the extension.
- >Clear your browser cache if the page will not load.
Updating the extension
- >Download the latest version from the download page.
- >In chrome://extensions, click the refresh icon on ForgeTools.
- >Or: remove the old version, then "Load unpacked" with the new folder.
- >Your wallet and settings are preserved across updates.