/** * Onboarding Wizard * * 5-step guided flow: Create Account -> Add Wallet -> Alert Rules -> Notifications -> Done */ import { useState, useEffect } from "react"; import { useNavigate } from "react-router-dom"; import { useAuth } from "../contexts/AuthContext"; import { createAddress, getAddresses } from "../api/addresses"; import { createAlert } from "../api/alerts"; import { updateNotificationConfig, testNotificationChannels, } from "../api/notificationConfig"; import Input from "../components/Input"; import Button from "../components/Button"; import "./Onboarding.css"; const STEPS = [ "Create Account", "Add Wallet", "Alert Rules", "Notifications", "Done", ]; export default function Onboarding() { const { currentUser, signup } = useAuth(); const navigate = useNavigate(); const [step, setStep] = useState(1); const [loading, setLoading] = useState(false); const [error, setError] = useState(""); const [skipWarning, setSkipWarning] = useState(""); const [testResults, setTestResults] = useState(null); const [testLoading, setTestLoading] = useState(false); const [data, setData] = useState({ email: "", password: "", confirmPassword: "", walletAddress: "", walletLabel: "", createdAddressId: null, alertIncomingTx: false, alertOutgoingTx: false, alertLargeTransfer: false, largeTransferThreshold: "", alertBalanceBelow: false, balanceBelowThreshold: "", discordWebhookUrl: "", slackWebhookUrl: "", notificationEmail: "", alertsCreated: [], notificationConfigured: false, }); function set(field, value) { setData((prev) => ({ ...prev, [field]: value })); } useEffect(() => { if (!currentUser) return; getAddresses() .then((addresses) => { if (addresses.length > 0) { navigate("/addresses", { replace: true }); } }) .catch(() => {}); }, [currentUser, navigate]); // ── Step handlers ───────────────────────────────────────────────────────── async function handleStep1() { setError(""); if (!data.email || !data.password || !data.confirmPassword) { setError("Please fill in all fields"); return; } if (data.password !== data.confirmPassword) { setError("Passwords do not match"); return; } if (data.password.length < 6) { setError("Password must be at least 6 characters"); return; } if (!currentUser) { try { setLoading(true); await signup(data.email, data.password); } catch (err) { if (err.code === "auth/email-already-in-use") { setError("Email already in use. Try logging in instead."); } else if (err.code === "auth/invalid-email") { setError("Invalid email address"); } else if (err.code === "auth/weak-password") { setError("Password is too weak"); } else { setError("Failed to create account: " + err.message); } setLoading(false); return; } finally { setLoading(false); } } setStep(2); } async function handleStep2() { setError(""); if (!data.walletAddress) { setError("Please enter a wallet address"); return; } if (!/^0x[0-9a-fA-F]{40}$/.test(data.walletAddress)) { setError("Invalid ETH address (must be 0x followed by 40 hex characters)"); return; } try { setLoading(true); const created = await createAddress({ address: data.walletAddress, label: data.walletLabel || undefined, }); set("createdAddressId", created.id); setStep(3); } catch (err) { setError(err.message); } finally { setLoading(false); } } async function handleStep3() { setError(""); const rules = []; if (data.alertIncomingTx) rules.push({ type: "incoming_tx" }); if (data.alertOutgoingTx) rules.push({ type: "outgoing_tx" }); if (data.alertLargeTransfer) { if (!data.largeTransferThreshold) { setError("Please enter a threshold for large transfers"); return; } rules.push({ type: "large_transfer", threshold: data.largeTransferThreshold }); } if (data.alertBalanceBelow) { if (!data.balanceBelowThreshold) { setError("Please enter a threshold for balance below"); return; } rules.push({ type: "balance_below", threshold: data.balanceBelowThreshold }); } if (rules.length === 0) { setStep(4); return; } try { setLoading(true); const created = []; for (const rule of rules) { const result = await createAlert(data.createdAddressId, rule); created.push(result); } set("alertsCreated", created); setStep(4); } catch (err) { setError(err.message); } finally { setLoading(false); } } async function handleStep4() { setError(""); const hasAny = data.discordWebhookUrl || data.slackWebhookUrl || data.notificationEmail; if (!hasAny) { setStep(5); return; } try { setLoading(true); await updateNotificationConfig({ notification_enabled: true, discord_webhook_url: data.discordWebhookUrl || undefined, slack_webhook_url: data.slackWebhookUrl || undefined, email: data.notificationEmail || undefined, }); set("notificationConfigured", true); setStep(5); } catch (err) { setError(err.message); } finally { setLoading(false); } } async function handleTestChannels() { setTestLoading(true); setTestResults(null); try { const results = await testNotificationChannels(); setTestResults(results); } catch (err) { setTestResults({ error: err.message }); } finally { setTestLoading(false); } } // ── Progress bar ────────────────────────────────────────────────────────── function ProgressBar() { return (
{STEPS.map((label, i) => { const stepNum = i + 1; const done = step > stepNum; const active = step === stepNum; const dotClass = done ? "progress-bar__dot--done" : active ? "progress-bar__dot--active" : "progress-bar__dot--pending"; return (
{i > 0 && (
)}
{done ? "\u2713" : stepNum}
{label}
); })}
); } // ── Step content ────────────────────────────────────────────────────────── function Step1() { return ( <>

Create your account

set("email", v)} disabled={loading} placeholder="you@example.com" /> set("password", v)} disabled={loading} placeholder="At least 6 characters" /> set("confirmPassword", v)} disabled={loading} placeholder="Repeat your password" className="form-field--last" /> ); } function Step2() { return ( <>

Add a wallet address

Enter the Ethereum address you want to monitor.

set("walletAddress", v)} disabled={loading} placeholder="0x..." /> set("walletLabel", v)} disabled={loading} placeholder="e.g. My main wallet" className="form-field--last" /> ); } function Step3() { return ( <>

Configure alert rules

Choose which events trigger notifications. You can change these later.

set("alertIncomingTx", v)} label="Incoming transaction" /> set("alertOutgoingTx", v)} label="Outgoing transaction" /> set("alertLargeTransfer", v)} label="Large transfer" > {data.alertLargeTransfer && (
set("largeTransferThreshold", v)} placeholder="Threshold (ETH)" min="0" step="0.01" />
)}
set("alertBalanceBelow", v)} label="Balance below" > {data.alertBalanceBelow && (
set("balanceBelowThreshold", v)} placeholder="Threshold (ETH)" min="0" step="0.01" />
)}
); } function Step4() { return ( <>

Set up notifications

Add at least one channel so you receive alerts. All fields are optional.

set("discordWebhookUrl", v)} disabled={loading} placeholder="https://discord.com/api/webhooks/..." />
set("slackWebhookUrl", v)} disabled={loading} placeholder="https://hooks.slack.com/services/..." />
set("notificationEmail", v)} disabled={loading} placeholder="you@example.com" className="form-field--last" /> ); } function Step5() { const alertCount = data.alertsCreated.length; const hasNotif = data.notificationConfigured; return ( <>

You're all set!

Summary

  • Wallet address added:{" "} {data.walletAddress} {data.walletLabel && ` (${data.walletLabel})`}
  • Alert rules configured:{" "} {alertCount > 0 ? `${alertCount} rule${alertCount !== 1 ? "s" : ""}` : "None (skipped)"}
  • Notification channels:{" "} {hasNotif ? "Configured" : "Not set up (skipped)"}
{hasNotif && (
{testResults && (
{testResults.error ? (

{testResults.error}

) : (
    {Object.entries(testResults).map(([channel, result]) => (
  • {result.success ? "\u2713" : "\u2717"} {channel}:{" "} {result.message || (result.success ? "OK" : "Failed")}
  • ))}
)}
)}
)} ); } // ── Shared helpers ──────────────────────────────────────────────────────── function CheckboxRow({ checked, onChange, label, children }) { return (
{children}
); } // ── Footer navigation ───────────────────────────────────────────────────── function Footer() { if (step === 5) return null; const canSkip = step === 3 || step === 4; const canBack = step > 1; async function handleNext() { setSkipWarning(""); if (step === 1) await handleStep1(); else if (step === 2) await handleStep2(); else if (step === 3) await handleStep3(); else if (step === 4) await handleStep4(); } function handleSkip() { setError(""); setSkipWarning(""); setStep((s) => s + 1); } function handleBack() { setError(""); setSkipWarning(""); setStep((s) => s - 1); } return (
{canBack && ( )}
{canSkip && ( )}
); } // ── Render ──────────────────────────────────────────────────────────────── const stepContent = { 1: , 2: , 3: , 4: , 5: , }; return (

Koin Ping

{error && (
{error}
)} {skipWarning && (
{skipWarning}
)}
{stepContent[step]}
{step === 1 && (

Already have an account?{" "} Log in here

)}
); }