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, vesting 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
LIQUIDITY80% locked
CREATOR20% vested
UNLOCK1% / 30 days
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 goes to a per-token vesting contract whose beneficiary is the wallet that launched that token.

03 / Contracts

SoggyLaunchpad

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.

SoggyVesting

One immutable vesting contract per launched token. The default SOGGY economics unlock 10,000,000 tokens (1% of total supply) every 30 days until the 200,000,000 creator allocation is fully vested.

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, locked LP state and vesting. 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.