import { execSync, spawn } from 'child_process'; import fs from 'fs'; import path from 'path'; import os from 'os'; import { fileURLToPath } from 'url'; import inquirer from 'inquirer'; import dotenv from 'dotenv'; import crypto from 'crypto'; import { mnemonicToAccount } from 'viem/accounts'; import { Vercel } from '@vercel/sdk'; const __dirname = path.dirname(fileURLToPath(import.meta.url)); const projectRoot = path.join(__dirname, '..'); // Load environment variables in specific order dotenv.config({ path: '.env' }); async function validateSeedPhrase(seedPhrase) { try { const account = mnemonicToAccount(seedPhrase); return account.address; } catch (error) { throw new Error('Invalid seed phrase'); } } async function lookupFidByCustodyAddress(custodyAddress, apiKey) { if (!apiKey) { throw new Error('Neynar API key is required'); } const lowerCasedCustodyAddress = custodyAddress.toLowerCase(); const response = await fetch( `https://api.neynar.com/v2/farcaster/user/bulk-by-address?addresses=${lowerCasedCustodyAddress}&address_types=custody_address`, { headers: { accept: 'application/json', 'x-api-key': apiKey, }, } ); if (!response.ok) { throw new Error(`Failed to lookup FID: ${response.statusText}`); } const data = await response.json(); if ( !data[lowerCasedCustodyAddress]?.length || !data[lowerCasedCustodyAddress][0].custody_address ) { throw new Error('No FID found for this custody address'); } return data[lowerCasedCustodyAddress][0].fid; } async function generateFarcasterMetadata( domain, fid, accountAddress, seedPhrase, webhookUrl ) { const trimmedDomain = domain.trim(); const header = { type: 'custody', key: accountAddress, fid, }; const encodedHeader = Buffer.from(JSON.stringify(header), 'utf-8').toString( 'base64' ); const payload = { domain: trimmedDomain, }; const encodedPayload = Buffer.from(JSON.stringify(payload), 'utf-8').toString( 'base64url' ); const account = mnemonicToAccount(seedPhrase); const signature = await account.signMessage({ message: `${encodedHeader}.${encodedPayload}`, }); const encodedSignature = Buffer.from(signature, 'utf-8').toString( 'base64url' ); const tags = process.env.NEXT_PUBLIC_MINI_APP_TAGS?.split(','); return { accountAssociation: { header: encodedHeader, payload: encodedPayload, signature: encodedSignature, }, frame: { version: '1', name: process.env.NEXT_PUBLIC_MINI_APP_NAME, iconUrl: `https://${trimmedDomain}/icon.png`, homeUrl: `https://${trimmedDomain}`, imageUrl: `https://${trimmedDomain}/api/opengraph-image`, buttonTitle: process.env.NEXT_PUBLIC_MINI_APP_BUTTON_TEXT, splashImageUrl: `https://${trimmedDomain}/splash.png`, splashBackgroundColor: '#f7f7f7', webhookUrl: webhookUrl?.trim(), description: process.env.NEXT_PUBLIC_MINI_APP_DESCRIPTION, primaryCategory: process.env.NEXT_PUBLIC_MINI_APP_PRIMARY_CATEGORY, tags, }, }; } async function loadEnvLocal() { try { if (fs.existsSync('.env.local')) { const { loadLocal } = await inquirer.prompt([ { type: 'confirm', name: 'loadLocal', message: 'Found .env.local - would you like to load its values in addition to .env values? (except for SEED_PHRASE, values will be written to .env)', default: true, }, ]); if (loadLocal) { console.log('Loading values from .env.local...'); const localEnv = dotenv.parse(fs.readFileSync('.env.local')); const allowedVars = [ 'SEED_PHRASE', 'NEXT_PUBLIC_MINI_APP_NAME', 'NEXT_PUBLIC_MINI_APP_DESCRIPTION', 'NEXT_PUBLIC_MINI_APP_PRIMARY_CATEGORY', 'NEXT_PUBLIC_MINI_APP_TAGS', 'NEXT_PUBLIC_MINI_APP_BUTTON_TEXT', 'NEXT_PUBLIC_ANALYTICS_ENABLED', 'NEYNAR_API_KEY', 'NEYNAR_CLIENT_ID', ]; const envContent = fs.existsSync('.env') ? fs.readFileSync('.env', 'utf8') + '\n' : ''; let newEnvContent = envContent; for (const [key, value] of Object.entries(localEnv)) { if (allowedVars.includes(key)) { process.env[key] = value; if (key !== 'SEED_PHRASE' && !envContent.includes(`${key}=`)) { newEnvContent += `${key}="${value}"\n`; } } } fs.writeFileSync('.env', newEnvContent); console.log('āœ… Values from .env.local have been written to .env'); } } } catch (error) { console.log('Note: No .env.local file found'); } } async function checkRequiredEnvVars() { console.log('\nšŸ“ Checking environment variables...'); console.log('Loading values from .env...'); await loadEnvLocal(); const requiredVars = [ { name: 'NEXT_PUBLIC_MINI_APP_NAME', message: 'Enter the name for your frame (e.g., My Cool Mini App):', default: process.env.NEXT_PUBLIC_MINI_APP_NAME, validate: input => input.trim() !== '' || 'Mini app name cannot be empty', }, { name: 'NEXT_PUBLIC_MINI_APP_BUTTON_TEXT', message: 'Enter the text for your frame button:', default: process.env.NEXT_PUBLIC_MINI_APP_BUTTON_TEXT ?? 'Launch Mini App', validate: input => input.trim() !== '' || 'Button text cannot be empty', }, ]; const missingVars = requiredVars.filter( varConfig => !process.env[varConfig.name] ); if (missingVars.length > 0) { console.log("\nāš ļø Some required information is missing. Let's set it up:"); for (const varConfig of missingVars) { const { value } = await inquirer.prompt([ { type: 'input', name: 'value', message: varConfig.message, default: varConfig.default, validate: varConfig.validate, }, ]); process.env[varConfig.name] = value; const envContent = fs.existsSync('.env') ? fs.readFileSync('.env', 'utf8') : ''; if (!envContent.includes(`${varConfig.name}=`)) { const newLine = envContent ? '\n' : ''; fs.appendFileSync( '.env', `${newLine}${varConfig.name}="${value.trim()}"` ); } } } // Check for seed phrase if (!process.env.SEED_PHRASE) { console.log('\nšŸ”‘ Mini App Manifest Signing'); console.log('A signed manifest helps users trust your mini app.'); const { seedPhrase } = await inquirer.prompt([ { type: 'password', name: 'seedPhrase', message: 'Enter your Farcaster custody account seed phrase to sign the mini app manifest\n(optional -- leave blank to create an unsigned mini app)\n\nSeed phrase:', default: null, }, ]); if (seedPhrase) { process.env.SEED_PHRASE = seedPhrase; const { storeSeedPhrase } = await inquirer.prompt([ { type: 'confirm', name: 'storeSeedPhrase', message: 'Would you like to store this seed phrase in .env.local for future use?', default: false, }, ]); if (storeSeedPhrase) { fs.appendFileSync('.env.local', `\nSEED_PHRASE="${seedPhrase}"`); console.log('āœ… Seed phrase stored in .env.local'); } else { console.log('ā„¹ļø Seed phrase will only be used for this deployment'); } } } } async function getGitRemote() { try { const remoteUrl = execSync('git remote get-url origin', { cwd: projectRoot, encoding: 'utf8', }).trim(); return remoteUrl; } catch (error) { return null; } } async function checkVercelCLI() { try { execSync('vercel --version', { stdio: 'ignore', shell: process.platform === 'win32', }); return true; } catch (error) { return false; } } async function installVercelCLI() { console.log('Installing Vercel CLI...'); execSync('npm install -g vercel', { stdio: 'inherit', shell: process.platform === 'win32', }); } async function getVercelToken() { try { // Try to get token from Vercel CLI config const configPath = path.join(os.homedir(), '.vercel', 'auth.json'); if (fs.existsSync(configPath)) { const authConfig = JSON.parse(fs.readFileSync(configPath, 'utf8')); return authConfig.token; } } catch (error) { console.warn('Could not read Vercel token from config file'); } // Try environment variable if (process.env.VERCEL_TOKEN) { return process.env.VERCEL_TOKEN; } // Try to extract from vercel whoami try { const whoamiOutput = execSync('vercel whoami', { encoding: 'utf8', stdio: 'pipe', }); // If we can get whoami, we're logged in, but we need the actual token // The token isn't directly exposed, so we'll need to use CLI for some operations console.log('āœ… Verified Vercel CLI authentication'); return null; // We'll fall back to CLI operations } catch (error) { throw new Error( 'Not logged in to Vercel CLI. Please run this script again to login.' ); } } async function loginToVercel() { console.log('\nšŸ”‘ Vercel Login'); console.log('You can either:'); console.log('1. Log in to an existing Vercel account'); console.log('2. Create a new Vercel account during login\n'); console.log('If creating a new account:'); console.log('1. Click "Continue with GitHub"'); console.log('2. Authorize GitHub access'); console.log('3. Complete the Vercel account setup in your browser'); console.log('4. Return here once your Vercel account is created\n'); console.log( '\nNote: you may need to cancel this script with ctrl+c and run it again if creating a new vercel account' ); const child = spawn('vercel', ['login'], { stdio: 'inherit', }); await new Promise((resolve, reject) => { child.on('close', code => { resolve(); }); }); console.log('\nšŸ“± Waiting for login to complete...'); console.log( "If you're creating a new account, please complete the Vercel account setup in your browser first." ); for (let i = 0; i < 150; i++) { try { execSync('vercel whoami', { stdio: 'ignore' }); console.log('āœ… Successfully logged in to Vercel!'); return true; } catch (error) { if (error.message.includes('Account not found')) { console.log('ā„¹ļø Waiting for Vercel account setup to complete...'); } await new Promise(resolve => setTimeout(resolve, 2000)); } } console.error('\nāŒ Login timed out. Please ensure you have:'); console.error('1. Completed the Vercel account setup in your browser'); console.error('2. Authorized the GitHub integration'); console.error('Then try running this script again.'); return false; } async function setVercelEnvVarSDK(vercelClient, projectId, key, value) { try { let processedValue; if (typeof value === 'object') { processedValue = JSON.stringify(value); } else { processedValue = value.toString(); } // Get existing environment variables const existingVars = await vercelClient.projects.getEnvironmentVariables({ idOrName: projectId, }); const existingVar = existingVars.envs?.find( env => env.key === key && env.target?.includes('production') ); if (existingVar) { // Update existing variable await vercelClient.projects.editEnvironmentVariable({ idOrName: projectId, id: existingVar.id, requestBody: { value: processedValue, target: ['production'], }, }); console.log(`āœ… Updated environment variable: ${key}`); } else { // Create new variable await vercelClient.projects.createEnvironmentVariable({ idOrName: projectId, requestBody: { key: key, value: processedValue, type: 'encrypted', target: ['production'], }, }); console.log(`āœ… Created environment variable: ${key}`); } return true; } catch (error) { console.warn( `āš ļø Warning: Failed to set environment variable ${key}:`, error.message ); return false; } } async function setVercelEnvVarCLI(key, value, projectRoot) { try { // Remove existing env var try { execSync(`vercel env rm ${key} production -y`, { cwd: projectRoot, stdio: 'ignore', env: process.env, }); } catch (error) { // Ignore errors from removal } let processedValue; if (typeof value === 'object') { processedValue = JSON.stringify(value); } else { processedValue = value.toString(); } // Create temporary file const tempFilePath = path.join(projectRoot, `${key}_temp.txt`); fs.writeFileSync(tempFilePath, processedValue, 'utf8'); // Use appropriate command based on platform let command; if (process.platform === 'win32') { command = `type "${tempFilePath}" | vercel env add ${key} production`; } else { command = `cat "${tempFilePath}" | vercel env add ${key} production`; } execSync(command, { cwd: projectRoot, stdio: 'pipe', // Changed from 'inherit' to avoid interactive prompts shell: true, env: process.env, }); fs.unlinkSync(tempFilePath); console.log(`āœ… Set environment variable: ${key}`); return true; } catch (error) { const tempFilePath = path.join(projectRoot, `${key}_temp.txt`); if (fs.existsSync(tempFilePath)) { fs.unlinkSync(tempFilePath); } console.warn( `āš ļø Warning: Failed to set environment variable ${key}:`, error.message ); return false; } } async function setEnvironmentVariables( vercelClient, projectId, envVars, projectRoot ) { console.log('\nšŸ“ Setting up environment variables...'); const results = []; for (const [key, value] of Object.entries(envVars)) { if (!value) continue; let success = false; // Try SDK approach first if we have a Vercel client if (vercelClient && projectId) { success = await setVercelEnvVarSDK(vercelClient, projectId, key, value); } // Fallback to CLI approach if (!success) { success = await setVercelEnvVarCLI(key, value, projectRoot); } results.push({ key, success }); } // Report results const failed = results.filter(r => !r.success); if (failed.length > 0) { console.warn(`\nāš ļø Failed to set ${failed.length} environment variables:`); failed.forEach(r => console.warn(` - ${r.key}`)); console.warn( '\nYou may need to set these manually in the Vercel dashboard.' ); } return results; } async function deployToVercel(useGitHub = false) { try { console.log('\nšŸš€ Deploying to Vercel...'); // Ensure vercel.json exists const vercelConfigPath = path.join(projectRoot, 'vercel.json'); if (!fs.existsSync(vercelConfigPath)) { console.log('šŸ“ Creating vercel.json configuration...'); fs.writeFileSync( vercelConfigPath, JSON.stringify( { buildCommand: 'next build', framework: 'nextjs', }, null, 2 ) ); } // Set up Vercel project console.log('\nšŸ“¦ Setting up Vercel project...'); console.log( 'An initial deployment is required to get an assigned domain that can be used in the mini app manifest\n' ); console.log( '\nāš ļø Note: choosing a longer, more unique project name will help avoid conflicts with other existing domains\n' ); execSync('vercel', { cwd: projectRoot, stdio: 'inherit', shell: process.platform === 'win32', }); // Load project info const projectJson = JSON.parse( fs.readFileSync('.vercel/project.json', 'utf8') ); const projectId = projectJson.projectId; // Get Vercel token and initialize SDK client let vercelClient = null; try { const token = await getVercelToken(); if (token) { vercelClient = new Vercel({ bearerToken: token, }); console.log('āœ… Initialized Vercel SDK client'); } } catch (error) { console.warn( 'āš ļø Could not initialize Vercel SDK, falling back to CLI operations' ); } // Get project details console.log('\nšŸ” Getting project details...'); let domain; let projectName; if (vercelClient) { try { const project = await vercelClient.projects.get({ idOrName: projectId, }); projectName = project.name; domain = `${projectName}.vercel.app`; console.log('🌐 Using project name for domain:', domain); } catch (error) { console.warn( 'āš ļø Could not get project details via SDK, using CLI fallback' ); } } // Fallback to CLI method if SDK failed if (!domain) { const inspectOutput = execSync( `vercel project inspect ${projectId} 2>&1`, { cwd: projectRoot, encoding: 'utf8', } ); const nameMatch = inspectOutput.match(/Name\s+([^\n]+)/); if (nameMatch) { projectName = nameMatch[1].trim(); domain = `${projectName}.vercel.app`; console.log('🌐 Using project name for domain:', domain); } else { const altMatch = inspectOutput.match(/Found Project [^/]+\/([^\n]+)/); if (altMatch) { projectName = altMatch[1].trim(); domain = `${projectName}.vercel.app`; console.log('🌐 Using project name for domain:', domain); } else { throw new Error( 'Could not determine project name from inspection output' ); } } } // Generate mini app metadata if we have a seed phrase let miniAppMetadata; let fid; if (process.env.SEED_PHRASE) { console.log('\nšŸ”Ø Generating mini app metadata...'); const accountAddress = await validateSeedPhrase(process.env.SEED_PHRASE); fid = await lookupFidByCustodyAddress( accountAddress, process.env.NEYNAR_API_KEY ?? 'FARCASTER_V2_FRAMES_DEMO' ); const webhookUrl = process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID ? `https://api.neynar.com/f/app/${process.env.NEYNAR_CLIENT_ID}/event` : `https://${domain}/api/webhook`; miniAppMetadata = await generateFarcasterMetadata( domain, fid, accountAddress, process.env.SEED_PHRASE, webhookUrl ); console.log('āœ… Mini app metadata generated and signed'); } // Prepare environment variables const nextAuthSecret = process.env.NEXTAUTH_SECRET || crypto.randomBytes(32).toString('hex'); const vercelEnv = { NEXTAUTH_SECRET: nextAuthSecret, AUTH_SECRET: nextAuthSecret, NEXTAUTH_URL: `https://${domain}`, NEXT_PUBLIC_URL: `https://${domain}`, ...(process.env.NEYNAR_API_KEY && { NEYNAR_API_KEY: process.env.NEYNAR_API_KEY, }), ...(process.env.NEYNAR_CLIENT_ID && { NEYNAR_CLIENT_ID: process.env.NEYNAR_CLIENT_ID, }), ...(miniAppMetadata && { MINI_APP_METADATA: miniAppMetadata }), ...Object.fromEntries( Object.entries(process.env).filter(([key]) => key.startsWith('NEXT_PUBLIC_') ) ), }; // Set environment variables await setEnvironmentVariables( vercelClient, projectId, vercelEnv, projectRoot ); // Deploy the project if (useGitHub) { console.log('\nSetting up GitHub integration...'); execSync('vercel link', { cwd: projectRoot, stdio: 'inherit', env: process.env, }); console.log('\nšŸ“¦ Deploying with GitHub integration...'); } else { console.log('\nšŸ“¦ Deploying local code directly...'); } execSync('vercel deploy --prod', { cwd: projectRoot, stdio: 'inherit', env: process.env, }); // Verify actual domain after deployment console.log('\nšŸ” Verifying deployment domain...'); let actualDomain = domain; if (vercelClient) { try { const deployments = await vercelClient.deployments.list({ projectId: projectId, limit: 1, }); if (deployments.deployments?.[0]?.url) { actualDomain = deployments.deployments[0].url; console.log('🌐 Verified actual domain:', actualDomain); } } catch (error) { console.warn( 'āš ļø Could not verify domain via SDK, using assumed domain' ); } } // Update environment variables if domain changed if (actualDomain !== domain) { console.log('šŸ”„ Updating environment variables with correct domain...'); const webhookUrl = process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID ? `https://api.neynar.com/f/app/${process.env.NEYNAR_CLIENT_ID}/event` : `https://${actualDomain}/api/webhook`; const updatedEnv = { NEXTAUTH_URL: `https://${actualDomain}`, NEXT_PUBLIC_URL: `https://${actualDomain}`, }; if (miniAppMetadata) { const updatedMetadata = await generateFarcasterMetadata( actualDomain, fid, await validateSeedPhrase(process.env.SEED_PHRASE), process.env.SEED_PHRASE, webhookUrl ); updatedEnv.MINI_APP_METADATA = updatedMetadata; } await setEnvironmentVariables( vercelClient, projectId, updatedEnv, projectRoot ); console.log('\nšŸ“¦ Redeploying with correct domain...'); execSync('vercel deploy --prod', { cwd: projectRoot, stdio: 'inherit', env: process.env, }); domain = actualDomain; } console.log('\n✨ Deployment complete! Your mini app is now live at:'); console.log(`🌐 https://${domain}`); console.log( '\nšŸ“ You can manage your project at https://vercel.com/dashboard' ); } catch (error) { console.error('\nāŒ Deployment failed:', error.message); process.exit(1); } } async function main() { try { console.log('šŸš€ Vercel Mini App Deployment (SDK Edition)'); console.log( 'This script will deploy your mini app to Vercel using the Vercel SDK.' ); console.log('\nThe script will:'); console.log('1. Check for required environment variables'); console.log('2. Set up a Vercel project (new or existing)'); console.log('3. Configure environment variables in Vercel using SDK'); console.log('4. Deploy and build your mini app\n'); // Check if @vercel/sdk is installed try { await import('@vercel/sdk'); } catch (error) { console.log('šŸ“¦ Installing @vercel/sdk...'); execSync('npm install @vercel/sdk', { cwd: projectRoot, stdio: 'inherit', }); console.log('āœ… @vercel/sdk installed successfully'); } await checkRequiredEnvVars(); const remoteUrl = await getGitRemote(); let useGitHub = false; if (remoteUrl) { console.log('\nšŸ“¦ Found GitHub repository:', remoteUrl); const { useGitHubDeploy } = await inquirer.prompt([ { type: 'confirm', name: 'useGitHubDeploy', message: 'Would you like to deploy from the GitHub repository?', default: true, }, ]); useGitHub = useGitHubDeploy; } else { console.log('\nāš ļø No GitHub repository found.'); const { action } = await inquirer.prompt([ { type: 'list', name: 'action', message: 'What would you like to do?', choices: [ { name: 'Deploy local code directly', value: 'deploy' }, { name: 'Set up GitHub repository first', value: 'setup' }, ], default: 'deploy', }, ]); if (action === 'setup') { console.log('\nšŸ‘‹ Please set up your GitHub repository first:'); console.log('1. Create a new repository on GitHub'); console.log('2. Run these commands:'); console.log(' git remote add origin '); console.log(' git push -u origin main'); console.log('\nThen run this script again to deploy.'); process.exit(0); } } if (!(await checkVercelCLI())) { console.log('Vercel CLI not found. Installing...'); await installVercelCLI(); } if (!(await loginToVercel())) { console.error('\nāŒ Failed to log in to Vercel. Please try again.'); process.exit(1); } await deployToVercel(useGitHub); } catch (error) { console.error('\nāŒ Error:', error.message); process.exit(1); } } main();