Bootstrap Superfluid config and deployments

Why:
Establish the network configuration and deterministic deploy
caches so wrapper discovery/creation is reliable and repeatable.
Centralize Superfluid core (resolver, host, CFAv1, factory) and
SEND v1 addresses in config/superfluid.ts. Add a deployments
scaffold (deployments/wrapper.*.json) for idempotent runs and
future scripts. Also improve repo hygiene for tracked docs and
dotenv handling.

Details:
- config/superfluid.ts: per-network addresses for Base mainnet,
  Base Sepolia, local fork; wrapper metadata (name/symbol/decimals)
- deployments: persistent cache of wrapper addresses
- ABIs referenced via scripts/abis helpers (used by wrapper/rewards)
- Hardhat + viem based flows
- .gitignore: stop ignoring docs/; ignore .env* but keep .env.sample tracked

Test plan:
- bunx hardhat compile (succeeds)
- bunx hardhat run scripts/wrapper/create.ts --network anvil
  (writes/reads deployments/wrapper.845337.json)
- bunx hardhat run scripts/wrapper/create.ts --network base|sepolia
  (read-only discovery path)
- git status shows no stray docs changes; .env.sample remains tracked

Author: youngkidwarrior

.gitignore

@@ -8,14 +8,11 @@ broadcast/
 /broadcast/*/31337/
 /broadcast/**/dry-run/
 
-# Docs
-docs/
-
 # Dotenv file
-.env
+.env*
+!.env.sample
 
 node_modules
-.env
 
 # Hardhat files
 /cache

PLAN.md

@@ -1,39 +1,13 @@
 # Super Send – SuperToken Wrapper (backend-only)
 
-This repository orchestrates a Superfluid-based SuperToken wrapper around the existing SEND v1 token. No lockbox/v1 token contracts live here; they remain in `~/Documents/Send/send-token-upgrade`. End users never hold or interact with the wrapper; it is for backend flows only.
+This repository orchestrates a Superfluid-based SuperToken wrapper
+(SENDx) around the existing SEND v1 token for backend-only flows using
+official Superfluid contracts/ABIs and viem via Hardhat. End users do not
+hold or interact with the wrapper directly.
 
-Addresses (per network)
-- SEND v1 (underlying)
-  - Base mainnet (8453): 0xEab49138BA2Ea6dd776220fE26b7b8E446638956
-  - Base Sepolia (84532): 0xBbB542c66a7DD7BA6893C9630B30358D610FF3ee
-  - Local Base mainnet (845337): 0xEab49138BA2Ea6dd776220fE26b7b8E446638956
-- Superfluid core
-  - Base mainnet: Resolver 0x6a214c324553F96F04eFBDd66908685525Da0E0d, Host 0x4C073B3baB6d8826b8C5b229f3cfdC1eC6E47E74, CFAv1 0x19ba78B9cDB05A877718841c574325fdB53601bb, SuperTokenFactory 0xe20B9a38E0c96F61d1bA6b42a61512D56Fea1Eb3
-  - Base Sepolia: Resolver 0x21d4E9fbB9DB742E6ef4f29d189a7C18B0b59136, Host 0x109412E3C84f0539b43d39dB691B08c90f58dC7c, CFAv1 0x6836F23d6171D74Ef62FcF776655aBcD2bcd62Ef, SuperTokenFactory 0x7447E94Dfe3d804a9f46Bf12838d467c912C8F6C
+Docs by feature:
+- Platform/environment: docs/platform.md
+- Wrapper: docs/wrapper.md
+- Rewards: docs/rewards.md
 
-Requirements
-- .env: EOA_DEPLOYER, ETHERSCAN_API_KEY
-- Bun + Node, Hardhat, Anvil for local Base fork
-
-Scripts and flows
-- Tests (Base fork):
-  ```sh
-  bun run test
-  ```
-- Local deploy orchestration (placeholder until PR4 adds wrapper script):
-  ```sh
-  ./bin/anvil-deploy
-  ```
-- Wrapper address persistence
-  - deployments/wrapper.{chainId}.json
-
-Environment flags (for later PRs)
-- CREATE_WRAPPER=true: force creating the wrapper on the fork
-- SEND_HOLDER=0x...: address to impersonate for upgrade/downgrade test
-- RUN_CFA_SMOKE=true: run optional CFA lifecycle smoke test
-
-References (Rule 3: mirror official examples; no custom Solidity)
-- SuperTokenFactory: https://docs.superfluid.finance/superfluid/protocol-developers/supertokens/supertokenfactory
-- ISuperToken: https://github.com/superfluid-finance/protocol-monorepo/blob/dev/packages/ethereum-contracts/contracts/interfaces/superfluid/ISuperToken.sol
-- CFAv1: https://docs.superfluid.finance/superfluid/developers/constant-flow-agreement-cfa
-- Hardhat + Viem: https://github.com/NomicFoundation/hardhat-viem
+For warp.dev terminal guidance and command recipes, see WARP.md.