SUITED TOOLS TERMINAL

The terminal combines a real-time NFT mint stream, a multi-mode contract sniper, a full-featured DEX trading terminal, a holder-only encrypted messenger, custom price alert monitors, and a shareable PNL card generator • all inside a single cyberpunk interface.

Supported Wallets

Network Configuration

Key Contracts

Multi-layer auth combining a cinematic video intro, EIP-6963 multi-wallet discovery, and on-chain ERC-721 holder verification. No backend database, no API key • the gate is 100% on-chain.

Video Intro Sequence

• Fullscreen viewport (100vw × 100vh) with poster frame • dual-format sources (MP4 + QuickTime)
• Auto-plays muted on mount (browser autoplay policy compliant)
• CRT scanline overlay effect for terminal aesthetic
• Video progress bar with animated fill and timecode HUD
• Auto-pauses at 0.6s before end to reveal the authentication HUD
• Controls: Mute/Unmute, Skip to Wallet Gate, Replay Intro

Wallet Discovery (EIP-6963)

1. Dispatches eip6963:requestProvider event on module load
2. Listens for eip6963:announceProvider events from installed extensions
3. Each wallet announces info (uuid, name, icon, rdns) and provider (EIP-1193)
4. Results merged with legacy detection (window.ethereum, etc.)
5. Wallets sorted: detected first • 350ms delayed re-scan catches late injections
6. Selected wallet ID saved to localStorage for auto-reconnect

On-Chain Verification

Continuous Enforcement

• Account change listener • listens to accountsChanged events. Switching to a 0-balance wallet terminates the session.
• Periodic re-verification • every 20 seconds via verifySuitedApeBalance. If balance drops to 0, gate re-engages.
• Skip intro on re-gate • video intro is skipped, user goes directly to wallet selection.

Real-time on-chain event stream displaying every ERC-721 NFT mint on Robinhood Chain. Scans Transfer(address(0) → to, tokenId) logs directly from the chain via JSON-RPC.

Stream Filters

Mint Event Row

• NFT Thumbnail • from on-chain tokenURI with multi-gateway IPFS fallback
• Collection Name + Token ID
• Batch Badge • ×N for multi-mint, 🐋 SWEEP ×N for 3+ mints
• Method Pill • decoded 4-byte selector (e.g. "SeaDrop: mintPublic()")
• Price • "FREE MINT" or exact ETH amount
• SNIPE Button • loads collection into the Sniper Deck

Controls

• Pause / Resume • freezes live polling
• Force Refresh • immediate RPC scan
• Block Window • dropdown: 3K / 9K / 22K blocks

Load any Robinhood Chain NFT contract address and execute mints using one of four calldata execution modes. A smart pre-flight solver automatically selects the best mint method before execution.

Loading a Target

• Manual input • paste any 0x... address and click "LOAD CA"
• From Live Mint Tape or Trending Radar • click any row or card to auto-load

On load: name(), symbol(), totalSupply(), maxSupply(), SeaDrop getPublicDrop(), latest mint TX analysis, tokenURI(), OpenSea catalog lookup, Suited Ape Free Mint eligibility check.

Calldata Execution Modes

Smart Pre-Flight Solver

1. Checks if the holder has an unused Suited Ape token ID for a free mint
2. If yes, auto-switches to the free mint method
3. Verifies exact SeaDrop mint price matches calldata value
4. Falls back through methods until one passes eth_call simulation

Action Buttons

Execution Console

Terminal-style log with color-coded entries: info, ok, warn, err. Each entry timestamped [HH:MM:SS]. Auto-scrolls to latest.

Schedule a mint to fire automatically at the exact second a SeaDrop collection opens its public phase. Persistent countdown timer ticks down to the on-chain startTime, and at 00:00:00 the terminal fires the transaction through your wallet.

Arming

• Block-0 Deploys Radar • click "AUTO-SNIPE" on any upcoming deployment
• Sniper Deck Countdown Banner • "ARM AUTO-SNIPE" button on loaded collections with future startTime

Trigger Sequence

1. Marks as triggered • one-shot, will not fire again
2. Plays alert sound • ascending 3-note arpeggio via Web Audio API
3. Block-readiness loop • up to 6 attempts (850ms apart, ~5s) verifying chain block timestamp
4. Builds SeaDrop mintPublic calldata • exact mint price × quantity as msg.value
5. Broadcasts via eth_sendTransaction
6. Quantity fallback • if multi-qty fails, auto-retries with qty = 1
7. Logs result • TX hash + explorer link, or decoded revert reason

Visual States

3-pane trading interface combining a market scanner (DexScreener), interactive price charts (dual engine: DexScreener embed or custom HTML5 Canvas), live on-chain trade decoding, and a full swap execution panel.

Market Scanner

Chart Engine • DexScreener Embed

Full DexScreener iframe with dark theme • configurable candle interval • readout bar with 5M TX, 1H TX, 5M Volume, Last Sync.

Chart Engine • RPC Canvas

• Custom HTML5 Canvas candlestick chart with high-DPI support
• Green (#ccff00) bullish / Red (#ff2e54) bearish candles
• Area chart mode with gradient fill (toggleable)
• EMA overlays: 9-period (cyan) and 21-period (amber)
• Volume bars, live spot price line, crosshair, OHLCV readout, mouse wheel zoom
• Timeframes: 1M, 5M, 15M, 1H, 4H, 1D

Live On-Chain Trades

Decoded from Uniswap V3/V4 Swap event logs + GeckoTerminal API. Columns: TIME, TYPE (BUY/SELL), PRICE, AMOUNT, QUOTE, TOTAL USD, MAKER, TX. Up to 30 recent trades, color-coded by direction.

Handles all on-chain token trading. 5 DEX protocols, dual-path quoting (Relay.link primary, multi-DEX fallback), Permit2 approvals, and pre-flight simulation.

Supported Protocols

Quote Pipeline

Step 1 • Relay.link (Primary)

1. Posts quote to api.relay.link/quote with user address, chain, tokens, amounts, slippage
2. Tries multiple slippage levels: user-set, max(user-set, 3%), and 10%
3. Each quote verified via eth_call simulation before acceptance

Step 2 • Multi-DEX Fallback

1. Builds ALL candidate TXs across Flap, V4, V3, V2 simultaneously
2. Pass 1 (Strict): minOut = 85% of estimated output, validates via eth_call in parallel
3. Pass 2 (Relaxed): if all strict fail, retries with minOut = 1 raw unit

Permit2 Approval Flow

Slippage

Real-time wallet portfolio on Robinhood Chain. Scans for all ERC-20 holdings, live USD valuations, 1-click quick sell, and PNL card generation per position.

Position Discovery

1. Known DexScreener pairs • checks discovered pairs for wallet balances
2. Transfer log scan • searches Transfer logs in last 28,000 blocks (~7.5h)
3. Parallel balanceOf calls • queries all candidate tokens in parallel
4. Cross-reference DexScreener • matches tokens for live pricing

1-Click Quick Sell

Each sell: resolves verified swap quote → handles ERC-20 approval if needed (Permit2) → broadcasts via wallet → portfolio refreshes after execution.

Custom price alerts for any Robinhood Chain token. Polls DexScreener every 3.5s, triggers sound notifications, displays visual toast alerts, and auto-injects executable trade cards into Holder Chat.

7 Condition Types

Instant Arm Presets

Trigger Sequence

1. Status changes to triggered (one-shot)
2. Sound alert • 3-note arpeggio via Web Audio API (buy: 587/880/1175 Hz, sell: 880/659/988 Hz)
3. Toast banner • "🎯 MONITOR TRIGGERED: $SYMBOL" with "VIEW CHART" button
4. Chat injection • executable trade card sent to configured channel

Real-time messaging for verified Suited Ape holders. Messenger-style floating dock with 4 group channels, private wallet-to-wallet DMs, in-chat 1-click trade execution, emoji reactions, nicknames, and monitor alert auto-injection.

Channels

Message Types

In-Chat Execution

DEX Trades: Buy/Sell toggle, amount presets (0.01/0.025/0.05/0.1 ETH for buy, 25%/50%/100% for sell), on-chain balance reading, full swap pipeline, SIM button, TX hash on success, entry price saved for PNL.

NFT Mints: Quantity presets (1x/2x/5x/10x), full mint pipeline, sold-out and WL-only detection, TX hash on success.

Features

• Reactions • 👍 🔥 🚀 💎 🦍 on every message (click to toggle, counts displayed)
• Nicknames • max 24 chars, persisted server-side, format: Nickname • Ape #ID
• Contacts Drawer • live/total holder count, search, activity labels
• Private DMs • wallet-to-wallet, auto-opens on incoming
• Admin • /clear, /clearall (admin wallet only)

1200×675 HD shareable images showing your trading P&L. Designed for X/Twitter, Discord and Telegram with cyberpunk visuals and your Suited Ape identity.

How to Generate

• DEX Token Info Header • "FLEX PNL" camera icon
• My Bag Portfolio • camera icon on any position card
• Holder Chat • "FLEX PNL" on any token call card

Editable Parameters

Canvas Design

• Deep cyberpunk gradient with perspective tactical grid
• Outer neon border with HUD corner brackets
• "SUITED TOOLS TERMINAL" header + chain badge
• Token pair title (54px bold) + position badge
• Massive ROI readout (116px JetBrains Mono with glow shadow)
• Entry/Mark price boxes side by side
• Suited Ape identity card: 236×236 avatar, nickname, verified badge, wallet
• Green (#ccff00) for profit, Red (#ff2e54) for loss

Export

On-chain inspector for the full 2,222-supply Suited Ape Society collection. Look up any Ape by token ID and view its owner, IPFS metadata, and traits directly from Robinhood Chain RPC.

Layout

• Search Form • number input (1–2222) + "INSPECT APE #N" button
• Quick Access • preset buttons: #1, #7, #42, #100, #420, #777, #1337, #2222
• Vault Detail Grid • displays on load

Inspection Data

Single-page React app (Vite + TypeScript) with zero external wallet SDK dependencies. All blockchain interactions implemented from scratch in pure TypeScript.

Stack

RPC Engine • Batch Queue

1. Individual rpcCall() requests pushed into a pending queue
2. Queue auto-flushes: 12 requests = immediate, or 14ms idle = flush whatever is queued
3. Batched as single JSON-RPC batch POST
4. eth_getLogs bypasses batch queue (too large)

Retry: 3-attempt strategy with primary endpoint → fallback to direct RPC → exponential backoff (320ms × attempt + jitter) on 429/5xx.

Multicall3

• Pure TypeScript encoder/decoder for aggregate3(Call3[]) • no ABI library
• Chunked into groups of 210 to stay within gas limits
• allowFailure: true ensures single failed calls don't revert the batch

Data Flow

Polling Intervals

ABI Decoding (Zero-Dependency)

• decodeAbiString() • ABI-encoded string values (offset → length → bytes → UTF-8)
• decodeSeaDropPublicDropHex() • 5-field struct: mintPrice, startTime, endTime, maxPerWallet, feeBps
• decodeRevertErrorData() • known error selectors → human-readable messages
• 30+ known 4-byte selectors mapped to function names
• V3/V4 Swap event decoding with signed int256 handling

IPFS Resolution

1. gateway.pinata.cloud/ipfs/{CID}
2. dweb.link/ipfs/{CID}
3. ipfs.decentralized-content.com/ipfs/{CID}
4. /api/ipfs/{CID} (VPS proxy)

Falls back to <video> for MP4 NFTs. Arweave URIs via arweave.net. Data URIs decoded inline.

LocalStorage Keys

Backend Services (VPS)

Security

• Holder gate • all execution requires ≥ 1 Suited Ape verified on-chain
• No private keys • signing delegated to browser wallet
• No external SDKs • no wagmi, ethers.js, Web3Modal (eliminates supply-chain risk)
• Pre-flight simulation • every swap/mint simulated via eth_call before broadcasting
• Rate limit handling • retry logic with exponential backoff on 429