SOGGY / TECHNICAL NOTES

Proof first.
Pond second.

SOGGY is a static web launchpad plus Solidity launch contracts for Robinhood Chain. The browser reads the directory, ownership and locked LP positions from chain. Supabase only decorates token pages with creator-signed metadata.

01 / Overview

The public release has two independent folders: site/ for Vercel and contracts/ for Foundry. Deploying a contract never overwrites hand-maintained chain settings. A helper script writes only the generated contract-address file.

Important: the release intentionally contains no SOGGY launchpad address and no guessed Uniswap V3 factory/router addresses. Those are filled only after you verify and deploy them.

02 / Launch terms

SUPPLY1B fixed
POOLUniswap V3
LIQUIDITY70% locked
CREATOR25% at launch
AIRDROP5% / 17 wallets
LP FEE TIER1%
CREATOR LP FEES90%
PROTOCOL LP FEES10%

The token contract has no owner, transfer tax, blacklist, pause or extra mint path. The creator allocation is transferred outright in the launch transaction, and a further 5% is split evenly across 17 wallets fixed in the launchpad bytecode. There is no vesting contract and nothing to claim.

03 / Contracts

RobinhoodUniswapV3

Creates fixed-supply tokens, mines token ordering for the WETH pair, initializes the V3 pool, mints single-sided liquidity, holds the LP NFT, accounts for LP fees and exposes the token directory.

SoggyStockLaunchpad

Optional stock-token paired sibling. Quote assets must be explicitly whitelisted with a reference amount. Do not enable it until current Robinhood Stock Token addresses and routes are verified.

SoggyAtomicStockRouter

Optional one-signature helper for ETH ↔ stock-paired token routes. Deploy it only after the DEX router address is verified.

04 / Market data

The launchpad uses contract reads as the authority for tokens, pools, creators and locked LP state. GeckoTerminal is best-effort for 24h price/volume/trade history and its embedded candlestick chart. Blockscout is used for explorer links and holder counters. Missing indexer data renders as an em dash rather than a fabricated zero.

05 / Supabase metadata

Run site/supabase/schema.sql once in the Supabase SQL Editor. It creates soggy_token_meta and a public-read soggy-media bucket. The service-role key stays server-side on Vercel.

SUPABASE_URL=https://YOUR_PROJECT.supabase.co SUPABASE_SERVICE_ROLE_KEY=sb_secret_... SUPABASE_BUCKET=soggy-media SUPABASE_TABLE=soggy_token_meta CHAIN_RPC_URL=https://rpc.mainnet.chain.robinhood.com LAUNCHPAD_ADDRESSES=0xYOUR_SOGGY_LAUNCHPAD,0xYOUR_STOCK_LAUNCHPAD

Profile writes require a wallet signature and the API checks that signer against the creator recorded by a configured launchpad contract.

06 / Mainnet deploy

Robinhood Chain mainnet uses chain ID 4663, ETH gas, RPC https://rpc.mainnet.chain.robinhood.com and Blockscout. Deploy to testnet first.

cd contracts cp .env.example .env ./setup-foundry.sh forge build forge test # after verifying V3_FACTORY_ADDRESS + POSITION_MANAGER_ADDRESS source .env forge script script/DeployLaunchpad.s.sol:DeployLaunchpad \ --rpc-url "$CHAIN_RPC_URL" --broadcast --verify \ --verifier blockscout \ --verifier-url https://robinhoodchain.blockscout.com/api node tools/apply-deployment.mjs --write

For stock pairs, verify current Robinhood Stock Tokens, scan routes, build quote reference amounts, review the generated file, then run the whitelist script.

07 / Vercel

Set the Vercel project root to site. There is no frontend build step. Add the environment variables from site/.env.example, then deploy. After you choose a domain, set your X/GitHub URLs in site/config.js and run node tools/set-domain.mjs https://your-domain.tld.

cd site npm install vercel --prod

08 / Safety gates

  • Never deploy with a guessed V3 factory, Position Manager, router or quoter address.
  • Run forge build, unit tests and a Robinhood testnet launch before mainnet.
  • Verify every production contract on Blockscout before announcing public launch.
  • Use a dedicated deployer and treasury; never place private keys in Vercel or Git.
  • Smart-contract tests reduce risk but do not replace an independent security audit.