SOLSCOPE docs
v1.0.0
Live demo Get help
● Start · Tools and accounts

Requirements
tools, accounts, keys.

What to install on your computer, what to sign up for, which keys are optional, and what running SOLSCOPE costs.

01Tools on your computer

ToolVersionWhy
Flutter SDK (includes Dart)3.41 or newer, stable (Dart 3.11+)Builds the app. pubspec.yaml declares Flutter 3.41.0 as its lower bound: the package versions locked in pubspec.lock need Dart 3.11, which ships with Flutter 3.41, and the iOS wallet-return wiring uses the scene-lifecycle API added in Flutter 3.38. Verified with Flutter 3.41.4. Install
Google ChromecurrentRuns the web build locally.
Xcode + CocoaPodsXcode 15 or newer (verified with 26.4.1)iOS builds. Needs a Mac.
Android StudioNarwhal 2025.1.1 or newerAndroid SDK Platform 36 (compileSdk = 36), JDK 17, emulator and the keytool command.

No Node.js, database or server runtime is needed: SOLSCOPE has no backend.

flutter --version
flutter doctor      # lines for platforms you don't build for may stay yellow

02Accounts

AccountNeeded for
A Solana RPC provider (Helius, QuickNode, Alchemy or your own node)Production traffic. The public fallback is rate limited.Before launch
A static host (Vercel, Netlify, Cloudflare Pages, Firebase Hosting, nginx…)The web terminal and, optionally, your admin JSON fileFor web
Apple Developer ProgramApp Store and TestFlightFor iOS
Google Play ConsoleGoogle PlayFor Android
FirebaseNot used. SOLSCOPE has no Firebase dependency (docs/FIREBASE.md).Not needed
Wallet apps in the stores

Apple guideline 3.1.5(i) requires wallet apps to come from a developer enrolled as an organisation. Enrol your company, not a personal account, if you plan to publish on iOS.

03API keys

All keys are optional for a first run. The exact names and where they go are in Configuration.

ProviderUnlocks
Your own Solana RPC URL (your provider account)Reliable reads and transaction submission; indexed reads such as the top-holder list if your endpoint serves themBefore launch
Helius (free tier)Full holder count, dev-wallet launch history, funding sourceRecommended
CoinGecko DemoA higher rate limit for the SOL reference priceOptional

Jupiter, Dexscreener and GeckoTerminal need no key. Every key above is for an account you open with that provider: you accept their terms and you pay them for anything above their free tier. None of them is included in the item price.

04What your users can run

PlatformMinimumNotes
WebCurrent browsersVerified: flutter build web --release succeeds.
iOSiOS 13.0IPHONEOS_DEPLOYMENT_TARGET in ios/Runner.xcodeproj. Store build unverified in this documentation pass.
AndroidFlutter's default minSdkandroid/app/build.gradle.kts. Store build unverified in this documentation pass.

A macos/ folder is in the source and builds; it is not a documented store target. Linux and Windows targets are not generated.

05Costs not included in the price

The item price covers the source code and this documentation. These third-party services are billed by their providers, on your own accounts. You are responsible for any usage costs incurred through your own API accounts. Check each provider's current pricing.

  • Solana RPC provider (Helius, QuickNode, Alchemy or your own node): needed for production traffic; you pay its plan above the free tier.
  • Helius API key (optional): free tier, then billed by Helius to you.
  • CoinGecko API (optional): the Demo key is free with rate limits; paid plans are billed by CoinGecko to you.
  • Jupiter API: the app uses Jupiter's keyless endpoint; if you move to a keyed Jupiter plan, it is billed by Jupiter to you.
  • Firebase (optional, not used by default): SOLSCOPE has no Firebase dependency and ships no Firebase project, ID or key. If you choose to publish your admin config through Firebase Remote Config (a small code addition, docs/FIREBASE.md) or host the web build on Firebase Hosting, it runs in your own Firebase project: Remote Config is free, Hosting has a free quota on the Spark plan, and usage above it on the Blaze (pay-as-you-go) plan is billed by Google to you. Firebase pricing.
  • Static hosting and a domain for the web build and your admin JSON: paid by you (often free for small traffic).
  • Apple Developer Program (yearly) and Google Play Console (one-time) to publish the apps: paid by you.
  • Solana network fees: paid by the wallet that signs each swap — your users, not you.

No server, database or cloud function is needed, so there is none to pay for. Who pays: you, the buyer, for every account above; your users pay only the Solana network fee of their own swaps.

06Setting up each external service

All of these are optional for a first run. Each one is an account you open in your own name.

  1. A Solana RPC endpoint (before launch)Sign up with an RPC provider such as Helius, QuickNode or Alchemy (provider guides: Helius docs, QuickNode Solana docs, Alchemy docs), create a Solana mainnet endpoint, and copy its HTTPS URL. For a web build, restrict the endpoint to your site's domain in the provider's dashboard (often called "allowed origins" or "domain allowlist"), because a web build's URL is readable by visitors. Put the URL in SOLSCOPE_RPC_URL or Setup → Data sources.
  2. Helius API keyAt dashboard.helius.dev create a free account, open API Keys in the left menu and copy the key (Helius guide: Authentication). Put it in SOLSCOPE_HELIUS_API_KEY or Setup → Data sources. For a web build, add your domain to the key's allowed domains.
  3. CoinGecko Demo keyAt coingecko.com/en/api create a Demo account, open Developer Dashboard → + Add New Key, create a key and copy it into SOLSCOPE_COINGECKO_DEMO_KEY (CoinGecko guide: Setting up your API key).
  4. Your fee account (Jupiter)No Jupiter account is needed for quotes (Jupiter guide: dev.jup.ag/docs). To be paid a fee you need a token account, not a wallet address: Setting up earnings → The fee account walks through it.
  5. Firebase (only if you choose it)Not needed to run SOLSCOPE. To read your admin config from Remote Config instead of a static JSON file, follow docs/FIREBASE.md in the package (you add firebase_core and firebase_remote_config to your own build) and Google's Remote Config guide; to host the web build there, follow Firebase Hosting. Use your own Firebase project; none ships with the item.
  6. Check itIn a build with your passcode, Setup → Data sources shows each key as Set and What is answering right now shows your RPC and whether indexed reads are served.