recover pack 4.1 workspace and release tooling

.env.example

@@ -1,11 +1,9 @@
-cat > ~/tips-ecosystem/.env.example << 'EOF'
-# Private Key (DO NOT COMMIT .env FILE)
-PRIVATE_KEY=your_private_key_here
-
-# Network RPC URLs
-MAINNET_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY
-TESTNET_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
-
-# Etherscan API Key (for verification)
-ETHERSCAN_API_KEY=your_etherscan_api_key
-EOF
+# Private key for deployment scripts
+PRIVATE_KEY=your_private_key_here
+
+# Network RPC URLs
+MAINNET_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY
+TESTNET_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
+
+# Block explorer verification
+ETHERSCAN_API_KEY=your_etherscan_api_key

.gitignore

@@ -1,16 +1,10 @@
-cat > ~/tips-ecosystem/.gitignore << 'EOF'
 # Dependencies
 node_modules/
 
 # Hardhat
 cache/
 artifacts/
 
-# Build artifacts
-.next/
-dist/
-build/
-
 # Environment
 .env
 .env.local
@@ -36,4 +30,12 @@ coverage.json
 # Temporary
 tmp/
 temp/
-EOF
+
+# Next.js and packaged outputs
+.next/
+dist/
+apps/*/node_modules/
+apps/*/dist/
+rail1-pack41/cache/
+rail1-pack41/out/
+rail1-pack41/broadcast/

README.MD

@@ -1,26 +1,24 @@
-cat > ~/tips-ecosystem/README.md << 'EOF'
-# Tips Ecosystem L1
-
-Decentralized Tipping Blockchain - A complete ecosystem for content creator tips and rewards.
-
-## 🚀 Features
-
-- **TipCoin (TPC)**: Native ERC20 token (1 Billion supply)
-- **USDTC**: Stablecoin for USD-pegged tips
-- **TrustedForwarder**: Gasless meta-transaction support
-- **TipsNameService**: Human-readable address names
-
-## 📦 Installation
-
-```bash
-# Clone repository
-git clone https://github.com/TheArchitect/tips-ecosystem.git
-cd tips-ecosystem
-
-# Install dependencies
-npm install
-
-# Copy environment file
-cp .env.example .env
-
-# Edit .env with your private key and RPC URLs
+# Tipschain Ecosystem
+
+Recovered workspace for the Tipschain production stack.
+
+## Included surfaces
+- `apps/wallet-web/` for the wallet web app
+- `apps/dex-web/` for the DEX web app
+- `extension/tipswallet-extension/` for the browser extension source snapshot
+- `rail1-pack41/` for the Pack 4.1 rail contracts and services
+
+## Root release commands
+```bash
+npm run wallet:lint
+npm run wallet:build
+npm run dex:lint
+npm run dex:build
+npm run release:4.1
+```
+
+## Notes
+- The Git base was restored from `tipspay-dev/tipschain-ecosystem`.
+- Wallet source was recovered from a newer local `TipsWallet` checkout.
+- DEX source was recovered from `tipspay-dev/TipspayDEX`.
+- Extension and `rail1-pack41` were recovered from local backup/download snapshots.

README.md

@@ -1,26 +1,24 @@
-cat > ~/tips-ecosystem/README.md << 'EOF'
-# Tips Ecosystem L1
+# Tipschain Ecosystem
 
-Decentralized Tipping Blockchain - A complete ecosystem for content creator tips and rewards.
+Recovered workspace for the Tipschain production stack.
 
-## 🚀 Features
-
-- **TipCoin (TPC)**: Native ERC20 token (1 Billion supply)
-- **USDTC**: Stablecoin for USD-pegged tips
-- **TrustedForwarder**: Gasless meta-transaction support
-- **TipsNameService**: Human-readable address names
-
-## 📦 Installation
+## Included surfaces
+- `apps/wallet-web/` for the wallet web app
+- `apps/dex-web/` for the DEX web app
+- `extension/tipswallet-extension/` for the browser extension source snapshot
+- `rail1-pack41/` for the Pack 4.1 rail contracts and services
 
+## Root release commands
 ```bash
-# Clone repository
-git clone https://github.com/TheArchitect/tips-ecosystem.git
-cd tips-ecosystem
-
-# Install dependencies
-npm install
-
-# Copy environment file
-cp .env.example .env
-
-# Edit .env with your private key and RPC URLs
+npm run wallet:lint
+npm run wallet:build
+npm run dex:lint
+npm run dex:build
+npm run release:4.1
+```
+
+## Notes
+- The Git base was restored from `tipspay-dev/tipschain-ecosystem`.
+- Wallet source was recovered from a newer local `TipsWallet` checkout.
+- DEX source was recovered from `tipspay-dev/TipspayDEX`.
+- Extension and `rail1-pack41` were recovered from local backup/download snapshots.

apps/dex-web/.env.example

@@ -0,0 +1,9 @@
+# GEMINI_API_KEY: Required for Gemini AI API calls.
+# AI Studio automatically injects this at runtime from user secrets.
+# Users configure this via the Secrets panel in the AI Studio UI.
+GEMINI_API_KEY="MY_GEMINI_API_KEY"
+
+# APP_URL: The URL where this applet is hosted.
+# AI Studio automatically injects this at runtime with the Cloud Run service URL.
+# Used for self-referential links, OAuth callbacks, and API endpoints.
+APP_URL="MY_APP_URL"

apps/dex-web/.gitignore

@@ -0,0 +1,8 @@
+node_modules/
+build/
+dist/
+coverage/
+.DS_Store
+*.log
+.env*
+!.env.example

apps/dex-web/README.md

@@ -0,0 +1,20 @@
+<div align="center">
+<img width="1200" height="475" alt="GHBanner" src="https://github.com/user-attachments/assets/0aa67016-6eaf-458a-adb2-6e31a0763ed6" />
+</div>
+
+# Run and deploy your AI Studio app
+
+This contains everything you need to run your app locally.
+
+View your app in AI Studio: https://ai.studio/apps/18fc0ba5-a21f-4b07-8f0c-768bf359d906
+
+## Run Locally
+
+**Prerequisites:**  Node.js
+
+
+1. Install dependencies:
+   `npm install`
+2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
+3. Run the app:
+   `npm run dev`

apps/dex-web/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-nova",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/index.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

apps/dex-web/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>My Google AI Studio App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+

apps/dex-web/metadata.json

@@ -0,0 +1,5 @@
+{
+  "name": "Tipschain DEX",
+  "description": "A high-performance Uniswap-style DEX for Tipschain with V1, V2, and V3 liquidity pools. Features swap, liquidity management, and real-time blockchain integration.",
+  "requestFramePermissions": []
+}