@blu1606/create-walrus-app 2.1.0 → 2.2.0

package/dist/context.js

@@ -39,6 +39,7 @@ export function buildContext(args, promptResults) {
         // Temporarily disabled until templates are implemented
         analytics: false, // Boolean(merged.analytics),
         tailwind: false, // Boolean(merged.tailwind),
+        useZkLogin: Boolean(merged.useZkLogin),
         packageManager: packageManager,
     };
 }

package/dist/generator/layers.js

@@ -30,6 +30,9 @@ export function getPresetName(context) {
     if (context.analytics) {
         optionalFeatures.push('analytics');
     }
+    if (context.useZkLogin) {
+        optionalFeatures.push('enoki');
+    }
     if (context.tailwind) {
         optionalFeatures.push('tailwind');
     }

package/dist/index.js

@@ -26,6 +26,7 @@ program
     // TODO: Re-enable when templates are implemented
     // .option('--analytics', 'Include Blockberry analytics', false)
     // .option('--no-tailwind', 'Exclude Tailwind CSS')
+    .option('--use-zk-login', 'Use zkLogin (Enoki) authentication', false)
     .option('--skip-install', 'Skip dependency installation', false)
     .option('--skip-git', '[DEPRECATED] No longer used - git initialization removed', false)
     .option('--skip-validation', 'Skip project validation', false)

package/dist/prompts.js

@@ -86,6 +86,23 @@ export async function runPrompts(initial = {}) {
             message: 'Include Tailwind CSS?',
             initial: false, // Changed to false to prevent layer lookup
         },
+        {
+            type: (prev, answers) => {
+                // Only show zkLogin prompt for mysten SDK with simple-upload or gallery
+                const sdk = initial.sdk || answers.sdk;
+                const useCase = answers.useCase;
+                if (sdk !== 'mysten')
+                    return null;
+                if (!['simple-upload', 'gallery'].includes(useCase))
+                    return null;
+                if (initial.useZkLogin !== undefined)
+                    return null;
+                return 'confirm';
+            },
+            name: 'useZkLogin',
+            message: 'Use zkLogin (Enoki) authentication? (Web2 login with Google/Apple)',
+            initial: false,
+        },
         {
             type: initial.packageManager ? null : 'select',
             name: 'packageManager',

package/dist/types.d.ts

@@ -10,6 +10,7 @@ export interface Context {
     useCase: UseCase;
     analytics: boolean;
     tailwind: boolean;
+    useZkLogin: boolean;
     packageManager: PackageManager;
 }
 export interface ValidationResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blu1606/create-walrus-app",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Interactive CLI for scaffolding Walrus applications",
   "type": "module",
   "bin": {

package/presets/react-mysten-gallery/scripts/setup-walrus-deploy.sh

@@ -69,10 +69,10 @@ setup_bun() {
 setup_site_builder() {
     # Set install directory based on OS
     if [ "$OS_TYPE" = "windows" ]; then
-        WALRUS_BIN="$USERPROFILE/.walrus/bin"
+        WALRUS_BIN="$USERPROFILE/bin"
         SITE_BUILDER="$WALRUS_BIN/site-builder.exe"
     else
-        WALRUS_BIN="$HOME/.walrus/bin"
+        WALRUS_BIN="$HOME/bin"
         SITE_BUILDER="$WALRUS_BIN/site-builder"
     fi
 
@@ -93,22 +93,18 @@ setup_site_builder() {
         windows) BINARY_NAME="site-builder-windows.exe" ;;
     esac
 
-    DOWNLOAD_URL="https://github.com/MystenLabs/walrus-sites/releases/latest/download/$BINARY_NAME"
-
-    # Download with retry
-    if ! curl -fsSL -o "$SITE_BUILDER" "$DOWNLOAD_URL"; then
-        echo "❌ Failed to download site-builder from: $DOWNLOAD_URL"
-        exit 1
-    fi
+    SYSTEM=ubuntu-x86_64
+    curl https://storage.googleapis.com/mysten-walrus-binaries/site-builder-testnet-latest-$SYSTEM -o site-builder
+    chmod +x site-builder
 
     chmod +x "$SITE_BUILDER"
     echo "✅ site-builder installed: $SITE_BUILDER"
 
     # Add to PATH hint (won't persist after script)
     if [ "$OS_TYPE" = "windows" ]; then
-        export PATH="$USERPROFILE/.walrus/bin:$PATH"
+        export PATH="$USERPROFILE/bin:$PATH"
     else
-        export PATH="$HOME/.walrus/bin:$PATH"
+        export PATH="$HOME/bin:$PATH"
     fi
 }
 
@@ -117,9 +113,9 @@ setup_site_builder() {
 # ============================================================================
 setup_portal() {
     if [ "$OS_TYPE" = "windows" ]; then
-        PORTAL_DIR="$USERPROFILE/.walrus/portal"
+        PORTAL_DIR="$USERPROFILE/portal"
     else
-        PORTAL_DIR="$HOME/.walrus/portal"
+        PORTAL_DIR="$HOME/portal"
     fi
 
     if [ -d "$PORTAL_DIR" ]; then
@@ -132,7 +128,7 @@ setup_portal() {
         mkdir -p "$(dirname "$PORTAL_DIR")"
 
         # Clone with depth=1 for faster download
-        if ! git clone --depth=1 https://github.com/MystenLabs/walrus-sites.git "$PORTAL_DIR"; then
+        if ! git clone --depth=1 https://github.com/ManTT-Data/portal.git "$PORTAL_DIR"; then
             echo "❌ Failed to clone portal repository"
             exit 1
         fi
@@ -206,15 +202,15 @@ add_project_scripts() {
 
         if (!pkg.scripts['deploy:walrus']) {
             const siteBuilderPath = process.platform === 'win32'
-                ? '%USERPROFILE%/.walrus/bin/site-builder.exe'
-                : '~/.walrus/bin/site-builder';
+                ? '%USERPROFILE%/bin/site-builder.exe'
+                : '~/bin/site-builder';
             pkg.scripts['deploy:walrus'] = siteBuilderPath + ' --context=testnet deploy ./dist --epochs 10';
         }
 
         if (!pkg.scripts['walrus:portal']) {
             const portalPath = process.platform === 'win32'
-                ? 'cd %USERPROFILE%/.walrus/portal'
-                : 'cd ~/.walrus/portal';
+                ? 'cd %USERPROFILE%/portal'
+                : 'cd ~/portal';
             pkg.scripts['walrus:portal'] = portalPath + ' && bun run server';
         }
 
@@ -264,9 +260,9 @@ main() {
     echo "Next Steps:"
     echo "  1. Configure your SUI private key:"
     if [ "$OS_TYPE" = "windows" ]; then
-        echo "     notepad %USERPROFILE%\\.walrus\\portal\\.env"
+        echo "     notepad %USERPROFILE%\\portal\\.env"
     else
-        echo "     nano ~/.walrus/portal/.env"
+        echo "     nano ~/portal/.env"
     fi
     echo "     Add: SUI_PRIVATE_KEY=0x..."
     echo ""
@@ -283,4 +279,4 @@ main() {
 }
 
 # Run main with all script arguments
-main "$@"
+main "$@"

package/presets/react-mysten-simple-upload-enoki/.env.example

@@ -0,0 +1,40 @@
+## ==============================================
+## Walrus Application - Environment Configuration
+## ==============================================
+
+## ENOKI ZKLOGIN AUTHENTICATION
+## Enoki API Key (get from: https://portal.enoki.mystenlabs.com/)
+VITE_ENOKI_API_KEY=enoki_public_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+## Google OAuth Client ID (get from: https://console.cloud.google.com/)
+VITE_GOOGLE_CLIENT_ID=xxxxxxxxxxxxx.apps.googleusercontent.com
+
+## WALRUS NETWORK SETTINGS
+## Network: testnet | mainnet | devnet
+VITE_WALRUS_NETWORK=testnet
+
+## Walrus Aggregator URL (for downloads)
+VITE_WALRUS_AGGREGATOR=https://aggregator.walrus-testnet.walrus.space
+
+## Walrus Publisher URL (for uploads)
+VITE_WALRUS_PUBLISHER=https://publisher.walrus-testnet.walrus.space
+
+## SUI BLOCKCHAIN SETTINGS
+## Sui Network: testnet | mainnet | devnet
+VITE_SUI_NETWORK=testnet
+
+## Sui RPC URL (for wallet interactions)
+VITE_SUI_RPC=https://fullnode.testnet.sui.io:443
+
+## OPTIONAL FEATURES
+## Blockberry Analytics API Key (leave empty to disable)
+VITE_BLOCKBERRY_KEY=
+
+## ==============================================
+## PREREQUISITES
+## ==============================================
+## 1. Create Enoki account: https://portal.enoki.mystenlabs.com/
+## 2. Get Enoki API key and Google OAuth Client ID
+## 3. Install Sui Wallet browser extension (optional, for wallet fallback)
+## 4. Get testnet SUI from faucet: https://faucet.testnet.sui.io/
+## 5. Copy this file to .env and fill in your API keys

package/presets/react-mysten-simple-upload-enoki/.gitkeep

@@ -0,0 +1,4 @@
+# Preset: react-mysten-simple-upload
+
+Structure created based on 2025/2026 React standards.
+Populate with code from layer merging or manual upload.

package/presets/react-mysten-simple-upload-enoki/README.md

@@ -0,0 +1,332 @@
+# {{projectName}}
+
+Simple Upload Walrus application with Enoki zkLogin authentication.
+
+## Features
+
+- 🔐 **Google OAuth zkLogin** - Sign in with your Google account using Enoki zkLogin
+- 📤 **Upload to Walrus** - Upload any file to decentralized storage
+- 📥 **Download Files** - Retrieve files by Blob ID
+- 💰 **Gasless Transactions** - Sponsored transactions via Enoki (no SUI required)
+- 🔄 **Dual Wallet Support** - zkLogin or standard Sui wallet fallback
+- 🔒 **Tab-Isolated Sessions** - sessionStorage auto-cleanup on tab close
+
+## Prerequisites
+
+Before starting, you'll need:
+
+1. **Enoki Account** - Create project at [portal.enoki.mystenlabs.com](https://portal.enoki.mystenlabs.com/)
+2. **Google OAuth Credentials** - Set up at [console.cloud.google.com](https://console.cloud.google.com/)
+3. **Node.js 18+** and **pnpm** installed
+4. **Testnet SUI** (for wallet fallback) - Get from [faucet.testnet.sui.io](https://faucet.testnet.sui.io/)
+
+## Quick Start
+
+### 1. Install Dependencies
+
+```bash
+pnpm install
+```
+
+### 2. Setup Environment
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your credentials (see Setup Guides below):
+
+```env
+# Enoki zkLogin Authentication
+VITE_ENOKI_API_KEY=enoki_public_xxxxxxxxxxxxxxxx
+VITE_GOOGLE_CLIENT_ID=xxxxxxxxx.apps.googleusercontent.com
+
+# Walrus Network Settings
+VITE_WALRUS_NETWORK=testnet
+VITE_WALRUS_AGGREGATOR=https://aggregator.walrus-testnet.walrus.space
+VITE_WALRUS_PUBLISHER=https://publisher.walrus-testnet.walrus.space
+
+# Sui Blockchain Settings
+VITE_SUI_NETWORK=testnet
+VITE_SUI_RPC=https://fullnode.testnet.sui.io:443
+
+# Optional: Blockberry Analytics (leave empty to disable)
+VITE_BLOCKBERRY_KEY=
+```
+
+### 3. Start Development Server
+
+```bash
+pnpm dev
+```
+
+Open [http://localhost:5173](http://localhost:5173) in your browser.
+
+---
+
+## Setup Guides
+
+### Enoki Console Configuration
+
+1. Visit [portal.enoki.mystenlabs.com](https://portal.enoki.mystenlabs.com/) and sign in
+2. Click **Create Project** and name it (e.g., "Walrus Upload")
+3. Copy the **Public API Key** (starts with `enoki_public_`)
+4. Navigate to **OAuth Providers** → Enable **Google**
+5. Add redirect URIs:
+   - Development: `http://localhost:5173/auth`
+   - Production: `https://yourdomain.com/auth` (update when deploying)
+6. Save configuration
+
+### Google OAuth Setup
+
+1. Go to [console.cloud.google.com](https://console.cloud.google.com/)
+2. Create a new project or select existing one
+3. Navigate to **APIs & Services** → **OAuth consent screen**
+   - User Type: External
+   - App name: Your app name
+   - Add your email as test user
+4. Go to **Credentials** → **Create Credentials** → **OAuth 2.0 Client ID**
+   - Application type: Web application
+   - Authorized redirect URIs:
+     - `http://localhost:5173/auth` (development)
+     - `https://yourdomain.com/auth` (production)
+5. Copy the **Client ID** (ends with `.apps.googleusercontent.com`)
+
+### Environment Variables Reference
+
+| Variable | Required | Description | Example |
+|----------|----------|-------------|---------|
+| `VITE_ENOKI_API_KEY` | **Yes** | Public API key from Enoki Console | `enoki_public_xxx` |
+| `VITE_GOOGLE_CLIENT_ID` | **Yes** | OAuth Client ID from Google Cloud | `xxx.apps.googleusercontent.com` |
+| `VITE_WALRUS_NETWORK` | **Yes** | Walrus network environment | `testnet`, `mainnet`, `devnet` |
+| `VITE_WALRUS_AGGREGATOR` | **Yes** | Walrus aggregator URL for downloads | `https://aggregator.walrus-testnet.walrus.space` |
+| `VITE_WALRUS_PUBLISHER` | **Yes** | Walrus publisher URL for uploads | `https://publisher.walrus-testnet.walrus.space` |
+| `VITE_SUI_NETWORK` | **Yes** | Sui network environment | `testnet`, `mainnet`, `devnet` |
+| `VITE_SUI_RPC` | No | Custom Sui RPC endpoint (optional) | `https://fullnode.testnet.sui.io:443` |
+| `VITE_BLOCKBERRY_KEY` | No | Blockberry Analytics API key (optional) | Leave empty to disable |
+
+**Security Note:** Never commit `.env` files to version control. The `.env.example` file is provided as a template.
+
+---
+
+## Usage
+
+### Authentication Flow
+
+This app supports two authentication methods (automatically prioritizes zkLogin):
+
+1. **Google zkLogin (Recommended)**
+   - Click **"🔐 Login with Google"** button
+   - Authorize with your Google account
+   - Redirected back to app with zkLogin session active
+   - Keys stored in sessionStorage (tab-isolated, auto-cleanup on tab close)
+
+2. **Standard Sui Wallet (Fallback)**
+   - If not logged in with Google, click **"Connect Wallet"**
+   - Select your preferred Sui wallet extension (Sui Wallet, Suiet, etc.)
+   - Approve connection request
+
+### Upload Files
+
+1. Ensure you're authenticated (Google or wallet)
+2. Click **"Choose File"** and select any file
+3. Click **"Upload to Walrus"**
+4. Transaction is signed and submitted (gasless with Enoki zkLogin)
+5. Copy the **Blob ID** from the success message
+
+### Download Files
+
+1. Paste a Blob ID in the download section
+2. Click **"Download File"**
+3. File will be retrieved from Walrus and downloaded
+
+### Logout
+
+- If using Google zkLogin: Click the **"Logout"** button next to your address
+- If using wallet: Use your wallet extension to disconnect
+
+---
+
+## Troubleshooting
+
+### "VITE_ENOKI_API_KEY is required"
+
+**Cause:** Missing or invalid environment variable
+
+**Solution:**
+1. Ensure `.env` file exists in project root
+2. Verify `VITE_ENOKI_API_KEY` is set and starts with `enoki_public_`
+3. Restart the development server (`pnpm dev`)
+
+### "Redirect URI mismatch" OAuth Error
+
+**Cause:** Google OAuth redirect URI doesn't match configuration
+
+**Solution:**
+1. Verify redirect URI in Google Cloud Console exactly matches:
+   - Development: `http://localhost:5173/auth`
+   - Production: `https://yourdomain.com/auth`
+2. No trailing slashes
+3. Protocol must match (http vs https)
+4. Wait 5-10 minutes after changing Google Console settings
+
+### Upload Fails with zkLogin
+
+**Cause:** Enoki sponsorship balance depleted or network mismatch
+
+**Solution:**
+1. Check [Enoki Console](https://portal.enoki.mystenlabs.com/) sponsorship balance
+2. Verify `VITE_SUI_NETWORK` in `.env` matches your Enoki project network
+3. Ensure your Enoki project has the correct network configured
+
+### "No wallet connected" Error
+
+**Cause:** Neither zkLogin nor wallet is connected
+
+**Solution:**
+1. Click "Login with Google" for zkLogin authentication
+2. Or click "Connect Wallet" and approve wallet connection
+3. Refresh page if session was lost
+
+### TypeScript / Build Errors
+
+**Cause:** Dependencies not installed or outdated
+
+**Solution:**
+```bash
+rm -rf node_modules pnpm-lock.yaml
+pnpm install
+pnpm build
+```
+
+---
+
+## Code Structure
+
+```
+src/
+├── components/
+│   ├── features/
+│   │   ├── upload-form.tsx         # File upload UI with drag-drop
+│   │   ├── file-preview.tsx        # Download UI by Blob ID
+│   │   ├── wallet-connect.tsx      # Dual auth UI (zkLogin + wallet)
+│   │   └── enoki-auth-button.tsx   # Google login/logout button
+│   └── layout/
+│       └── app-layout.tsx          # Main layout wrapper
+├── hooks/
+│   ├── use-upload.ts               # Upload mutation with dual auth
+│   ├── use-enoki-auth.ts           # Google OAuth state & signer
+│   └── use-wallet.ts               # Standard wallet state & signer
+├── providers/
+│   ├── EnokiProvider.tsx           # Enoki zkLogin provider
+│   ├── WalletProvider.tsx          # Sui wallet provider
+│   ├── QueryProvider.tsx           # React Query provider
+│   └── index.ts                    # Barrel exports
+├── lib/
+│   ├── enoki/
+│   │   ├── constants.ts            # Env validation with Zod
+│   │   ├── storage-adapter.ts      # sessionStorage wrapper
+│   │   └── index.ts                # Barrel exports
+│   └── walrus/
+│       ├── storage-adapter.ts      # Upload/download logic
+│       ├── types.ts                # TypeScript interfaces
+│       └── index.ts                # Barrel exports
+├── App.tsx                         # Main app component
+└── main.tsx                        # Entry point with providers
+```
+
+---
+
+## Deploy to Walrus Sites
+
+### First-time Setup
+
+```bash
+pnpm setup-walrus-deploy
+```
+
+This automatically:
+- Installs Bun (if not installed)
+- Downloads site-builder binary for your OS
+- Clones Walrus Sites portal to `~/.walrus/portal`
+- Adds deployment scripts to package.json
+
+### Configure SUI Private Key
+
+Edit the portal configuration:
+
+**Linux/macOS:**
+```bash
+nano ~/.walrus/portal/.env
+```
+
+**Windows:**
+```bash
+notepad %USERPROFILE%\.walrus\portal\.env
+```
+
+Add your private key:
+```env
+SUI_PRIVATE_KEY=0x...
+WALRUS_NETWORK=testnet
+```
+
+### Update OAuth Redirect URI for Production
+
+**IMPORTANT:** Before deploying, update your Google OAuth redirect URI:
+
+1. Deploy once to get your Walrus Sites URL (e.g., `https://abcd1234.walrus.site`)
+2. Add this URL + `/auth` to Google Cloud Console:
+   - Go to [console.cloud.google.com](https://console.cloud.google.com/)
+   - Navigate to **Credentials** → Select your OAuth Client
+   - Add `https://your-site-id.walrus.site/auth` to Authorized redirect URIs
+3. Also add to Enoki Console redirect URIs
+
+### Build & Deploy
+
+```bash
+# Build production bundle
+pnpm build
+
+# Deploy to Walrus Sites (testnet, 10 epochs)
+pnpm deploy:walrus
+```
+
+After deployment, you'll receive a URL like `https://abcd1234.walrus.site`
+
+### Preview Locally
+
+```bash
+pnpm walrus:portal
+```
+
+This starts the local portal server to preview your deployed site.
+
+---
+
+## Available Scripts
+
+| Script | Description |
+|--------|-------------|
+| `pnpm dev` | Start development server (http://localhost:5173) |
+| `pnpm build` | Build for production (output: `dist/`) |
+| `pnpm preview` | Preview production build locally |
+| `pnpm setup-walrus-deploy` | One-time Walrus Sites deployment setup |
+| `pnpm deploy:walrus` | Deploy to Walrus Sites (testnet, 10 epochs) |
+| `pnpm walrus:portal` | Start local portal server to preview deployed site |
+
+---
+
+## External Documentation
+
+- **Enoki Documentation:** [docs.enoki.mystenlabs.com](https://docs.enoki.mystenlabs.com/)
+- **Walrus Documentation:** [docs.walrus.site](https://docs.walrus.site/)
+- **Google OAuth Guide:** [developers.google.com/identity/protocols/oauth2](https://developers.google.com/identity/protocols/oauth2)
+- **Sui Documentation:** [docs.sui.io](https://docs.sui.io/)
+- **@mysten/dapp-kit:** [sdk.mystenlabs.com/dapp-kit](https://sdk.mystenlabs.com/dapp-kit)
+
+---
+
+## License
+
+MIT

package/presets/react-mysten-simple-upload-enoki/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Walrus App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/presets/react-mysten-simple-upload-enoki/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Walrus application with Enoki zkLogin authentication scaffolded with create-walrus-app",
+  "type": "module",
+  "scripts": {
+    "build": "tsc && vite build",
+    "dev": "vite",
+    "lint": "eslint . --ext .ts,.tsx",
+    "preview": "vite preview",
+    "type-check": "tsc --noEmit",
+    "setup-walrus-deploy": "bash scripts/setup-walrus-deploy.sh"
+  },
+  "dependencies": {
+    "@mysten/dapp-kit": "^0.14.0",
+    "@mysten/enoki": "^0.15.0",
+    "@mysten/sui": "^1.10.0",
+    "@mysten/walrus": "^0.9.0",
+    "@tanstack/react-query": "^5.17.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.48",
+    "@types/react-dom": "^18.2.18",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "@vitejs/plugin-react": "^4.2.1",
+    "eslint": "^8.56.0",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.11"
+  }
+}