create-avalanche-app 0.1.5 → 0.1.7

package/dist/index.js

@@ -10,7 +10,7 @@ import { existsSync, readdirSync } from "fs";
 import path from "path";
 import * as p from "@clack/prompts";
 import pc from "picocolors";
-var VERSION = "0.1.5";
+var VERSION = "0.1.7";
 var AVAKIT_DEP_VERSION = "0.1.2";
 function parseArgs(argv) {
   const opts = { yes: false, local: false, install: true };
@@ -72,7 +72,7 @@ function printHelp() {
       "",
       "Options:",
       "  -t, --template <id>     minimal | nft-mint | token-gated-app | erc20-token |",
-      "                          icm-messenger | eerc-token | l1-launch",
+      "                          icm-messenger | eerc-token | l1-launch | token-bridge",
       "  -w, --wallet <id>       web3auth | injected   (default: web3auth)",
       "  -c, --chain <id>        fuji | c-chain        (default: fuji)",
       "      --pm <manager>      pnpm | npm | yarn | bun",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { existsSync, readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport * as p from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { type ChainId, listTemplates, scaffoldApp, type WalletId } from \"./api.js\";\n\nconst VERSION = \"0.1.5\";\n\n// The @avakit/* dependency version stamped into scaffolded apps' package.json\n// (as `^AVAKIT_DEP_VERSION`). Kept separate from the CLI's own VERSION: it must\n// resolve every published @avakit package, so it tracks the LOWEST current\n// @avakit version (core 0.1.2 · react 0.1.3 → ^0.1.2 satisfies both). Bump only\n// when the minimum @avakit version a fresh app needs goes up.\nconst AVAKIT_DEP_VERSION = \"0.1.2\";\n\ntype PackageManager = \"pnpm\" | \"npm\" | \"yarn\" | \"bun\";\n\ninterface Options {\n  projectName?: string;\n  template?: string;\n  wallet?: WalletId;\n  chain?: ChainId;\n  pm?: PackageManager;\n  yes: boolean;\n  local: boolean;\n  install: boolean;\n}\n\nfunction parseArgs(argv: string[]): Options {\n  const opts: Options = { yes: false, local: false, install: true };\n  const rest = argv.slice(2);\n  for (let i = 0; i < rest.length; i++) {\n    const arg = rest[i];\n    const next = () => rest[++i];\n    switch (arg) {\n      case \"--yes\":\n      case \"-y\":\n        opts.yes = true;\n        break;\n      case \"--local\":\n        opts.local = true;\n        break;\n      case \"--no-install\":\n        opts.install = false;\n        break;\n      case \"--template\":\n      case \"-t\":\n        opts.template = next();\n        break;\n      case \"--wallet\":\n      case \"-w\":\n        opts.wallet = next() as WalletId;\n        break;\n      case \"--chain\":\n      case \"-c\":\n        opts.chain = next() as ChainId;\n        break;\n      case \"--pm\":\n        opts.pm = next() as PackageManager;\n        break;\n      case \"--version\":\n      case \"-v\":\n        process.stdout.write(`${VERSION}\\n`);\n        process.exit(0);\n        break;\n      case \"--help\":\n      case \"-h\":\n        printHelp();\n        process.exit(0);\n        break;\n      default:\n        if (arg && !arg.startsWith(\"-\") && !opts.projectName) {\n          opts.projectName = arg;\n        }\n    }\n  }\n  return opts;\n}\n\nfunction printHelp(): void {\n  process.stdout.write(\n    [\n      \"create-avalanche-app — scaffold a batteries-included Avalanche dapp\",\n      \"\",\n      \"Usage:  npm create avalanche-app@latest [name] [options]\",\n      \"\",\n      \"Options:\",\n      \"  -t, --template <id>     minimal | nft-mint | token-gated-app | erc20-token |\",\n      \"                          icm-messenger | eerc-token | l1-launch\",\n      \"  -w, --wallet <id>       web3auth | injected   (default: web3auth)\",\n      \"  -c, --chain <id>        fuji | c-chain        (default: fuji)\",\n      \"      --pm <manager>      pnpm | npm | yarn | bun\",\n      \"  -y, --yes               skip prompts (non-interactive)\",\n      \"      --no-install        do not install dependencies\",\n      \"      --local             link @avakit/* via workspace (repo dev only)\",\n      \"  -v, --version           print version\",\n      \"  -h, --help              print this help\",\n      \"\",\n    ].join(\"\\n\"),\n  );\n}\n\nfunction isValidName(name: string): boolean {\n  return /^[a-z0-9][a-z0-9._-]*$/.test(name);\n}\n\nasync function resolveOptions(\n  opts: Options,\n): Promise<Required<Omit<Options, \"yes\" | \"local\" | \"install\">>> {\n  const templates = listTemplates();\n  const templateIds = templates.map((t) => t.id);\n\n  if (opts.yes) {\n    const projectName = opts.projectName ?? \"my-avax-app\";\n    return {\n      projectName,\n      template: opts.template && templateIds.includes(opts.template) ? opts.template : \"minimal\",\n      wallet: opts.wallet ?? \"web3auth\",\n      chain: opts.chain ?? \"fuji\",\n      pm: opts.pm ?? \"pnpm\",\n    };\n  }\n\n  p.intro(pc.bgCyan(pc.black(\" create-avalanche-app \")));\n\n  const projectName =\n    opts.projectName ??\n    (await p.text({\n      message: \"Project name?\",\n      placeholder: \"my-avax-app\",\n      defaultValue: \"my-avax-app\",\n      validate: (v) => (!v || isValidName(v) ? undefined : \"Use lowercase letters, digits, - . _\"),\n    }));\n  if (p.isCancel(projectName)) cancel();\n\n  const template =\n    opts.template ??\n    (await p.select({\n      message: \"Template?\",\n      options: templates.map((t) => ({ value: t.id, label: t.title, hint: t.description })),\n      initialValue: \"minimal\",\n    }));\n  if (p.isCancel(template)) cancel();\n\n  const wallet =\n    opts.wallet ??\n    (await p.select({\n      message: \"Wallet provider?\",\n      options: [\n        { value: \"web3auth\", label: \"Social login (Web3Auth)\", hint: \"free, recommended\" },\n        { value: \"injected\", label: \"Browser wallet (Core / MetaMask)\" },\n      ],\n      initialValue: \"web3auth\",\n    }));\n  if (p.isCancel(wallet)) cancel();\n\n  const chain =\n    opts.chain ??\n    (await p.select({\n      message: \"Target chain?\",\n      options: [\n        { value: \"fuji\", label: \"Avalanche Fuji (testnet)\", hint: \"recommended\" },\n        { value: \"c-chain\", label: \"Avalanche C-Chain (mainnet)\" },\n      ],\n      initialValue: \"fuji\",\n    }));\n  if (p.isCancel(chain)) cancel();\n\n  const pm =\n    opts.pm ??\n    (await p.select({\n      message: \"Package manager?\",\n      options: ([\"pnpm\", \"npm\", \"yarn\", \"bun\"] as const).map((m) => ({ value: m, label: m })),\n      initialValue: \"pnpm\",\n    }));\n  if (p.isCancel(pm)) cancel();\n\n  return {\n    projectName: projectName as string,\n    template: template as string,\n    wallet: wallet as WalletId,\n    chain: chain as ChainId,\n    pm: pm as PackageManager,\n  };\n}\n\nfunction cancel(): never {\n  p.cancel(\"Cancelled.\");\n  process.exit(0);\n}\n\nasync function main(): Promise<void> {\n  const opts = parseArgs(process.argv);\n  const resolved = await resolveOptions(opts);\n\n  const targetDir = path.resolve(process.cwd(), resolved.projectName);\n  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {\n    process.stderr.write(\n      pc.red(`\\nDirectory \"${resolved.projectName}\" already exists and is not empty.\\n`),\n    );\n    process.exit(1);\n  }\n\n  const spin = opts.yes ? null : p.spinner();\n  spin?.start(\"Scaffolding project\");\n  const { files } = await scaffoldApp({\n    projectName: resolved.projectName,\n    targetDir,\n    template: resolved.template,\n    wallet: resolved.wallet,\n    chain: resolved.chain,\n    local: opts.local,\n    avakitVersion: AVAKIT_DEP_VERSION,\n  });\n  spin?.stop(`Created ${files.length} files`);\n\n  if (opts.install) {\n    const installSpin = opts.yes ? null : p.spinner();\n    installSpin?.start(`Installing dependencies with ${resolved.pm}`);\n    const result = spawnSync(resolved.pm, [\"install\"], {\n      cwd: targetDir,\n      stdio: opts.yes ? \"inherit\" : \"ignore\",\n    });\n    if (result.status === 0) {\n      installSpin?.stop(\"Dependencies installed\");\n    } else {\n      installSpin?.stop(pc.yellow(\"Install skipped/failed — run it manually\"));\n    }\n  }\n\n  const next = [\n    `cd ${resolved.projectName}`,\n    ...(opts.install ? [] : [`${resolved.pm} install`]),\n    ...(resolved.wallet === \"web3auth\"\n      ? [\"cp .env.example .env.local   # add your Web3Auth client ID\"]\n      : []),\n    `${resolved.pm} run dev`,\n  ];\n\n  if (opts.yes) {\n    process.stdout.write(`\\nDone. Next steps:\\n  ${next.join(\"\\n  \")}\\n`);\n  } else {\n    p.note(next.join(\"\\n\"), \"Next steps\");\n    p.outro(pc.green(\"Your Avalanche dapp is ready.\"));\n  }\n}\n\nmain().catch((error: unknown) => {\n  process.stderr.write(\n    `\\n${pc.red(\"Error:\")} ${error instanceof Error ? error.message : String(error)}\\n`,\n  );\n  process.exit(1);\n});\n"],"mappings":"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","names":["projectName","cancel"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { existsSync, readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport * as p from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { type ChainId, listTemplates, scaffoldApp, type WalletId } from \"./api.js\";\n\nconst VERSION = \"0.1.7\";\n\n// The @avakit/* dependency version stamped into scaffolded apps' package.json\n// (as `^AVAKIT_DEP_VERSION`). Kept separate from the CLI's own VERSION: it must\n// resolve every published @avakit package, so it tracks the LOWEST current\n// @avakit version (core 0.1.2 · react 0.1.3 → ^0.1.2 satisfies both). Bump only\n// when the minimum @avakit version a fresh app needs goes up.\nconst AVAKIT_DEP_VERSION = \"0.1.2\";\n\ntype PackageManager = \"pnpm\" | \"npm\" | \"yarn\" | \"bun\";\n\ninterface Options {\n  projectName?: string;\n  template?: string;\n  wallet?: WalletId;\n  chain?: ChainId;\n  pm?: PackageManager;\n  yes: boolean;\n  local: boolean;\n  install: boolean;\n}\n\nfunction parseArgs(argv: string[]): Options {\n  const opts: Options = { yes: false, local: false, install: true };\n  const rest = argv.slice(2);\n  for (let i = 0; i < rest.length; i++) {\n    const arg = rest[i];\n    const next = () => rest[++i];\n    switch (arg) {\n      case \"--yes\":\n      case \"-y\":\n        opts.yes = true;\n        break;\n      case \"--local\":\n        opts.local = true;\n        break;\n      case \"--no-install\":\n        opts.install = false;\n        break;\n      case \"--template\":\n      case \"-t\":\n        opts.template = next();\n        break;\n      case \"--wallet\":\n      case \"-w\":\n        opts.wallet = next() as WalletId;\n        break;\n      case \"--chain\":\n      case \"-c\":\n        opts.chain = next() as ChainId;\n        break;\n      case \"--pm\":\n        opts.pm = next() as PackageManager;\n        break;\n      case \"--version\":\n      case \"-v\":\n        process.stdout.write(`${VERSION}\\n`);\n        process.exit(0);\n        break;\n      case \"--help\":\n      case \"-h\":\n        printHelp();\n        process.exit(0);\n        break;\n      default:\n        if (arg && !arg.startsWith(\"-\") && !opts.projectName) {\n          opts.projectName = arg;\n        }\n    }\n  }\n  return opts;\n}\n\nfunction printHelp(): void {\n  process.stdout.write(\n    [\n      \"create-avalanche-app — scaffold a batteries-included Avalanche dapp\",\n      \"\",\n      \"Usage:  npm create avalanche-app@latest [name] [options]\",\n      \"\",\n      \"Options:\",\n      \"  -t, --template <id>     minimal | nft-mint | token-gated-app | erc20-token |\",\n      \"                          icm-messenger | eerc-token | l1-launch | token-bridge\",\n      \"  -w, --wallet <id>       web3auth | injected   (default: web3auth)\",\n      \"  -c, --chain <id>        fuji | c-chain        (default: fuji)\",\n      \"      --pm <manager>      pnpm | npm | yarn | bun\",\n      \"  -y, --yes               skip prompts (non-interactive)\",\n      \"      --no-install        do not install dependencies\",\n      \"      --local             link @avakit/* via workspace (repo dev only)\",\n      \"  -v, --version           print version\",\n      \"  -h, --help              print this help\",\n      \"\",\n    ].join(\"\\n\"),\n  );\n}\n\nfunction isValidName(name: string): boolean {\n  return /^[a-z0-9][a-z0-9._-]*$/.test(name);\n}\n\nasync function resolveOptions(\n  opts: Options,\n): Promise<Required<Omit<Options, \"yes\" | \"local\" | \"install\">>> {\n  const templates = listTemplates();\n  const templateIds = templates.map((t) => t.id);\n\n  if (opts.yes) {\n    const projectName = opts.projectName ?? \"my-avax-app\";\n    return {\n      projectName,\n      template: opts.template && templateIds.includes(opts.template) ? opts.template : \"minimal\",\n      wallet: opts.wallet ?? \"web3auth\",\n      chain: opts.chain ?? \"fuji\",\n      pm: opts.pm ?? \"pnpm\",\n    };\n  }\n\n  p.intro(pc.bgCyan(pc.black(\" create-avalanche-app \")));\n\n  const projectName =\n    opts.projectName ??\n    (await p.text({\n      message: \"Project name?\",\n      placeholder: \"my-avax-app\",\n      defaultValue: \"my-avax-app\",\n      validate: (v) => (!v || isValidName(v) ? undefined : \"Use lowercase letters, digits, - . _\"),\n    }));\n  if (p.isCancel(projectName)) cancel();\n\n  const template =\n    opts.template ??\n    (await p.select({\n      message: \"Template?\",\n      options: templates.map((t) => ({ value: t.id, label: t.title, hint: t.description })),\n      initialValue: \"minimal\",\n    }));\n  if (p.isCancel(template)) cancel();\n\n  const wallet =\n    opts.wallet ??\n    (await p.select({\n      message: \"Wallet provider?\",\n      options: [\n        { value: \"web3auth\", label: \"Social login (Web3Auth)\", hint: \"free, recommended\" },\n        { value: \"injected\", label: \"Browser wallet (Core / MetaMask)\" },\n      ],\n      initialValue: \"web3auth\",\n    }));\n  if (p.isCancel(wallet)) cancel();\n\n  const chain =\n    opts.chain ??\n    (await p.select({\n      message: \"Target chain?\",\n      options: [\n        { value: \"fuji\", label: \"Avalanche Fuji (testnet)\", hint: \"recommended\" },\n        { value: \"c-chain\", label: \"Avalanche C-Chain (mainnet)\" },\n      ],\n      initialValue: \"fuji\",\n    }));\n  if (p.isCancel(chain)) cancel();\n\n  const pm =\n    opts.pm ??\n    (await p.select({\n      message: \"Package manager?\",\n      options: ([\"pnpm\", \"npm\", \"yarn\", \"bun\"] as const).map((m) => ({ value: m, label: m })),\n      initialValue: \"pnpm\",\n    }));\n  if (p.isCancel(pm)) cancel();\n\n  return {\n    projectName: projectName as string,\n    template: template as string,\n    wallet: wallet as WalletId,\n    chain: chain as ChainId,\n    pm: pm as PackageManager,\n  };\n}\n\nfunction cancel(): never {\n  p.cancel(\"Cancelled.\");\n  process.exit(0);\n}\n\nasync function main(): Promise<void> {\n  const opts = parseArgs(process.argv);\n  const resolved = await resolveOptions(opts);\n\n  const targetDir = path.resolve(process.cwd(), resolved.projectName);\n  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {\n    process.stderr.write(\n      pc.red(`\\nDirectory \"${resolved.projectName}\" already exists and is not empty.\\n`),\n    );\n    process.exit(1);\n  }\n\n  const spin = opts.yes ? null : p.spinner();\n  spin?.start(\"Scaffolding project\");\n  const { files } = await scaffoldApp({\n    projectName: resolved.projectName,\n    targetDir,\n    template: resolved.template,\n    wallet: resolved.wallet,\n    chain: resolved.chain,\n    local: opts.local,\n    avakitVersion: AVAKIT_DEP_VERSION,\n  });\n  spin?.stop(`Created ${files.length} files`);\n\n  if (opts.install) {\n    const installSpin = opts.yes ? null : p.spinner();\n    installSpin?.start(`Installing dependencies with ${resolved.pm}`);\n    const result = spawnSync(resolved.pm, [\"install\"], {\n      cwd: targetDir,\n      stdio: opts.yes ? \"inherit\" : \"ignore\",\n    });\n    if (result.status === 0) {\n      installSpin?.stop(\"Dependencies installed\");\n    } else {\n      installSpin?.stop(pc.yellow(\"Install skipped/failed — run it manually\"));\n    }\n  }\n\n  const next = [\n    `cd ${resolved.projectName}`,\n    ...(opts.install ? [] : [`${resolved.pm} install`]),\n    ...(resolved.wallet === \"web3auth\"\n      ? [\"cp .env.example .env.local   # add your Web3Auth client ID\"]\n      : []),\n    `${resolved.pm} run dev`,\n  ];\n\n  if (opts.yes) {\n    process.stdout.write(`\\nDone. Next steps:\\n  ${next.join(\"\\n  \")}\\n`);\n  } else {\n    p.note(next.join(\"\\n\"), \"Next steps\");\n    p.outro(pc.green(\"Your Avalanche dapp is ready.\"));\n  }\n}\n\nmain().catch((error: unknown) => {\n  process.stderr.write(\n    `\\n${pc.red(\"Error:\")} ${error instanceof Error ? error.message : String(error)}\\n`,\n  );\n  process.exit(1);\n});\n"],"mappings":"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","names":["projectName","cancel"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-avalanche-app",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Scaffold a batteries-included Avalanche dapp: social-login onboarding, deploy-ready, AI-native.",
   "license": "MIT",
   "type": "module",

package/templates/l1-launch/CLAUDE.md

@@ -70,6 +70,44 @@ cross-chain transfer to the P-Chain), (2) a **bootstrap validator** — your mac
 It is a multi-step, multi-minute process, not one command. There is no automatic hosted explorer for
 a custom Fuji L1 — this app's built-in explorer keeps working by pointing at your Fuji L1's RPC.
 
+## AI guide: state-aware Fuji walkthrough
+
+When the user asks for help getting their L1 onto Fuji, first figure out WHERE they are, then give
+the ONE next command. Detect state like this:
+
+1. **Do they have a funded key?** Run `avalanche key list --keys <name>` (or create one:
+   `avalanche key create <name>`). Check the key's **C-Chain** balance — if it's 0, the next step is
+   the faucet: send them to `https://build.avax.network/console/primary-network/faucet` for their key's
+   C-Chain address, and wait until the balance is non-zero. Budget ~1–2 test AVAX (validators pay a
+   continuous P-Chain fee, ~1 AVAX ≈ 1 month).
+2. **Is the balance on the P-Chain?** The L1 deploy spends from the **P-Chain**, but the faucet funds
+   the **C-Chain**. If P-Chain balance is 0, next command:
+   `avalanche key transfer --key <name> --fuji --c-chain-sender --p-chain-receiver --amount <x>`
+   (the C/P selectors are the boolean flags `--c-chain-sender` / `--p-chain-receiver`, NOT
+   `--sender-blockchain c`).
+3. **Is the blockchain config created?** If `~/.avalanche-cli/subnets/<name>` doesn't exist, create it:
+   `avalanche blockchain create <name> --evm --latest --evm-chain-id <id> --evm-token <TOK>
+   --proof-of-authority --validator-manager-owner <yourAddr> --proxy-contract-owner <yourAddr>
+   --production-defaults --force`.
+4. **Deploy to Fuji.** `avalanche blockchain deploy <name> --fuji --key <name> --use-local-machine
+   --num-bootstrap-validators 1 --balance 0.1 --vmc-L1`. Notes for driving this non-interactively:
+   `--vmc-L1` pre-answers the "deploy Validator Manager into an external blockchain?" prompt; the final
+   "fund the relayer?" prompt is optional and can be skipped (the L1 still deploys — the relayer only
+   matters for cross-chain messaging). If it complains a **local deploy already exists**, the machine
+   has stale state — `avalanche network clean` (or pick a fresh `<name>`) and retry. The node
+   bootstraps to Fuji first (downloads a multi-hundred-MB archive, a few minutes) — that wait is
+   normal, not a hang.
+5. **Verify it's live.** The deploy prints an `RPC Endpoint`. Point this app at it (set
+   `l1.config.json` → `network: "fuji"`, `rpcUrl`, `blockchainIdHex`). Confirm: `cast chain-id
+   --rpc-url <rpc>` returns your chain id, `cast block-number` advances, and the blockchain is listed
+   on Fuji's P-Chain via `platform.getBlockchains` on `https://api.avax-test.network/ext/bc/P`.
+6. **Remind them of the ongoing cost:** the validator node must stay running, and its balance drains —
+   top it up (`avalanche blockchain addValidator` / increase-balance) or the L1 goes inactive. For an
+   always-on chain, run the node on a server, not a laptop.
+
+Also available with the visual version of this flow: **AvaKit Studio** (`npx @avakit/studio`) has a
+"Launch on Fuji" wizard that runs these exact steps with a balance poller and a live progress log.
+
 ## Editing the demo contract
 
 After changing `contracts/src/AvaKitToken.sol`: `cd contracts && forge build`, then copy

package/templates/l1-launch/components/demo.tsx

@@ -8,7 +8,7 @@ import {
   useAvaAccount,
   useAvaKit,
 } from "@avakit/react";
-import { Blocks, Check, Copy, Moon, Rocket, Sun } from "lucide-react";
+import { Blocks, Check, Copy, ExternalLink, Moon, Rocket, Sun, Wallet } from "lucide-react";
 import { useTheme } from "next-themes";
 import { useCallback, useEffect, useState } from "react";
 import { type Address, type Hash, formatEther, formatUnits } from "viem";
@@ -274,11 +274,109 @@ function Dashboard() {
         </div>
       </section>
 
+      <NextSteps hasToken={Boolean(token)} />
+
       {error ? <p className="text-muted-foreground text-sm break-all">{error}</p> : null}
     </>
   );
 }
 
+// Guides the user through what to do once their L1 is live: add it to a wallet,
+// get gas, deploy something, and (on Fuji) the realities of keeping it running.
+function NextSteps({ hasToken }: { hasToken: boolean }) {
+  const { provider } = useAvaKit();
+  const [added, setAdded] = useState(false);
+  const isFuji = l1.network === "fuji";
+
+  const addToWallet = useCallback(async () => {
+    if (!provider) return;
+    try {
+      await provider.request({
+        method: "wallet_addEthereumChain",
+        params: [
+          {
+            chainId: `0x${chain.id.toString(16)}`,
+            chainName: chain.name,
+            rpcUrls: [chain.rpcUrl],
+            nativeCurrency: { name: l1.token, symbol: l1.token, decimals: 18 },
+          },
+        ],
+      });
+      setAdded(true);
+      setTimeout(() => setAdded(false), 2000);
+    } catch {
+      // user rejected or wallet unavailable
+    }
+  }, [provider]);
+
+  return (
+    <section className="flex flex-col gap-3 rounded-xl border p-5">
+      <p className="text-muted-foreground text-xs uppercase tracking-wide">Next steps</p>
+      <div className="flex flex-col gap-2">
+        <StepRow n={1} done={added} label="Add this L1 to your wallet">
+          <Button size="sm" variant="outline" onClick={addToWallet}>
+            <Wallet className="size-4" />
+            {added ? "Added" : "Add network"}
+          </Button>
+        </StepRow>
+
+        <StepRow n={2} label={isFuji ? "Get gas — fund your wallet with test AVAX" : "Get gas — import the EWOQ dev key"}>
+          {isFuji ? (
+            <a
+              href="https://build.avax.network/console/primary-network/faucet"
+              target="_blank"
+              rel="noreferrer"
+              className="text-muted-foreground inline-flex items-center gap-1 text-xs underline underline-offset-4"
+            >
+              Fuji faucet <ExternalLink className="size-3" />
+            </a>
+          ) : (
+            <span className="text-muted-foreground text-xs">
+              EWOQ key is pre-funded (printed by <span className="font-mono">pnpm l1</span>).
+            </span>
+          )}
+        </StepRow>
+
+        <StepRow n={3} done={hasToken} label="Deploy your first contract (the demo token above)" />
+      </div>
+
+      {isFuji ? (
+        <p className="text-muted-foreground border-t pt-3 text-xs">
+          ⚠︎ Your L1 only produces blocks while its validator node stays running, and the
+          validator's balance drains over time (~1 AVAX ≈ 1 month) — top it up, or the chain goes
+          inactive. For an always-on L1, run the validator on a server rather than your laptop.
+        </p>
+      ) : null}
+    </section>
+  );
+}
+
+function StepRow({
+  n,
+  label,
+  done,
+  children,
+}: {
+  n: number;
+  label: string;
+  done?: boolean;
+  children?: React.ReactNode;
+}) {
+  return (
+    <div className="flex items-center justify-between gap-3">
+      <span className="flex items-center gap-2 text-sm">
+        <span
+          className={`flex size-5 items-center justify-center rounded-full border text-xs ${done ? "bg-foreground text-background" : "text-muted-foreground"}`}
+        >
+          {done ? <Check className="size-3" /> : n}
+        </span>
+        {label}
+      </span>
+      {children}
+    </div>
+  );
+}
+
 function ago(timestamp: bigint): string {
   const secs = Math.max(0, Math.floor(Date.now() / 1000) - Number(timestamp));
   if (secs < 60) return `${secs}s ago`;

package/templates/token-bridge/CLAUDE.md

@@ -0,0 +1,70 @@
+# __PROJECT_NAME__ — cross-chain token bridge with ICTT (scaffolded with AvaKit)
+
+Operational guide for AI agents (Claude Code / Cursor) working in this project.
+
+## What this is
+
+A dapp that bridges an ERC-20 between two Avalanche L1s using **Interchain Token Transfer (ICTT)**.
+It runs against a **local devnet** of two L1s that `scripts/bridge.sh` (`pnpm bridge`) spins up — with
+Interchain Messaging, a relayer, and a full ICTT bridge (a demo token + Home + Remote) deployed and
+registered automatically.
+
+## Stack
+
+Next.js 16 (App Router) · React 19 · `@avakit/react` · `@avakit/core` · viem · shadcn/ui · avalanche-cli (local devnet) · ava-labs/icm-contracts (ICTT)
+
+## How ICTT works here
+
+- **ERC20TokenHome** (on chain1) holds the real ERC-20. When you bridge, it **locks** your tokens and
+  sends an ICM message to the remote.
+- **ERC20TokenRemote** (on chain2) **is itself an ERC-20** (the "bridged" token, symbol `TOK1.b`). On
+  arrival it **mints** to the recipient. Bridging back **burns** the remote token and **unlocks** the
+  original on the home chain.
+- A **TeleporterRegistry** on each chain points the ICTT contracts at the ICM messenger predeploy
+  (`0x253b…5fcf`). The relayer (started by `pnpm bridge`) carries the messages.
+
+## Architecture
+
+- `scripts/bridge.sh` (`pnpm bridge`) — creates + deploys two L1s, then runs `deploy-bridge.mjs`.
+- `scripts/deploy-bridge.mjs` — deploys the demo ERC-20 + TeleporterRegistry + Home on chain1, a
+  TeleporterRegistry + Remote on chain2, and calls `registerWithHome`. Uses viem + the embedded
+  artifacts + the public EWOQ key. Writes all addresses to `bridge.config.json`.
+- `lib/ictt-artifacts.json` — ABIs + bytecode for TeleporterRegistry, ERC20TokenHome,
+  ERC20TokenRemote, and the demo ERC-20, compiled from `ava-labs/icm-contracts` with the optimizer.
+- `lib/ictt.ts` — turns `bridge.config.json` into AvaKit chains + the addresses/ABIs the app uses.
+- `components/demo.tsx` — the bridge UI: balances on both chains, mint, and bridge in either direction.
+
+## The bridge flow (in the UI)
+
+1. `home → remote`: `approve(home, amount)` on the demo token, then `home.send(SendTokensInput, amount)`.
+   The home locks the token; the relayer delivers; the remote mints `TOK1.b` to you on chain2.
+2. `remote → home`: `remote.send(SendTokensInput, amount)` (no approval — the remote burns its own
+   ERC-20); the relayer delivers; the home unlocks your original token on chain1.
+
+`SendTokensInput` = `{ destinationBlockchainID (bytes32), destinationTokenTransferrerAddress,
+recipient, primaryFeeTokenAddress, primaryFee, secondaryFee, requiredGasLimit, multiHopFallback }`.
+On the local devnet, fees are 0, `primaryFeeTokenAddress` is the zero address, and
+`requiredGasLimit` is 250000. `destinationBlockchainID` is the bytes32 (Avalanche) blockchain ID in
+hex — NOT the EVM chainId — via `blockchainIdOf(chain)` in `lib/ictt.ts`.
+
+## Editing / regenerating the contracts
+
+The bundled artifacts are compiled from `ava-labs/icm-contracts` (`contracts/ictt`) with solc + the
+optimizer (runs 200) — the optimizer keeps ERC20TokenHome/Remote under the 24 KB EVM code-size limit.
+To regenerate, compile those contracts with any optimizing toolchain (Hardhat or solc standard-JSON)
+and replace the `abi`/`bytecode` in `lib/ictt-artifacts.json`. (Note: `avalanche interchain
+tokenTransferrer deploy` can also deploy an ICTT bridge, but it requires a specific pinned Foundry
+build to compile under the size limit — this template ships pre-compiled bytecode to avoid that.)
+
+## Rules
+
+- shadcn/ui only; `@avakit/react` components are shadcn-styled. Black & white for now; dark/light via next-themes; both must work.
+- Animations: Framer Motion or GSAP only.
+- Amounts are 18-decimal — always convert with `parseEther` / `formatEther`.
+- Never hardcode a real private key. The EWOQ key is a PUBLIC dev key — local devnet only.
+
+## Commands
+
+- `pnpm bridge` — spin up the 2-L1 devnet + deploy the ICTT bridge (writes `bridge.config.json`)
+- `pnpm dev` — dev server (http://localhost:3000)
+- `avalanche network stop | clean` — pause | wipe the local devnet

package/templates/token-bridge/README.md

@@ -0,0 +1,39 @@
+# __PROJECT_NAME__
+
+Bridge an ERC-20 between two Avalanche L1s with **Interchain Token Transfer (ICTT)** — over a one-command local devnet. Scaffolded with [AvaKit](https://github.com/mericcintosun/AvaKit).
+
+## Getting started
+
+```bash
+# 1. spin up two L1s + a relayer + the full ICTT bridge (needs avalanche-cli)
+pnpm bridge
+#    → creates chain1 + chain2, deploys a demo ERC-20 + Home + Remote, registers them,
+#      and writes bridge.config.json
+
+# 2. run the app
+pnpm dev    # http://localhost:3000
+```
+
+Then: import the printed EWOQ dev key into your wallet (pre-funded on both chains, local-only) →
+**Mint** the demo token on chain1 → **Bridge to chain2** → watch the bridged token (`TOK1.b`) arrive.
+Swap direction to bridge it back.
+
+## How it works
+
+- **Home** (chain1) locks your ERC-20 and sends an Interchain message.
+- **Remote** (chain2) is itself an ERC-20 — it mints a bridged version on arrival, and burns it when
+  you bridge back (which unlocks the original on chain1).
+- A relayer (started by `pnpm bridge`) carries the messages; a TeleporterRegistry on each chain wires
+  the ICTT contracts to the ICM messenger.
+
+The bridge contracts are compiled from [ava-labs/icm-contracts](https://github.com/ava-labs/icm-contracts)
+and bundled as bytecode, so `pnpm bridge` deploys them with no Solidity toolchain on your machine.
+
+## Stack
+
+Next.js 16 · `@avakit/react` · `@avakit/core` · viem · shadcn/ui · avalanche-cli · ICTT
+
+## AI-native
+
+Ships with `CLAUDE.md`, `llms.txt`, and `.cursor/rules` so Claude Code / Cursor understand the ICTT
+bridge flow (Home/Remote, lock/mint/burn/unlock, `SendTokensInput`) and the conventions.

package/templates/token-bridge/app/globals.css

@@ -0,0 +1,95 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+/* Scan @avakit/react's shadcn-style classes from node_modules. */
+@source "../node_modules/@avakit/react/dist";
+
+@custom-variant dark (&:is(.dark *));
+
+/*
+ * Black & white only (oklch chroma 0 = pure grayscale). Dark/light wired from
+ * day one via next-themes. Add brand colors later by editing these tokens —
+ * components never hardcode colors.
+ */
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.3 0 0);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.985 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.7 0 0);
+  --destructive-foreground: oklch(0.205 0 0);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@layer base {
+  * {
+    border-color: var(--border);
+  }
+  body {
+    background-color: var(--background);
+    color: var(--foreground);
+  }
+}

package/templates/token-bridge/app/layout.tsx

@@ -0,0 +1,23 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import type { ReactNode } from "react";
+import { Providers } from "./providers";
+import "./globals.css";
+
+const geistSans = Geist({ variable: "--font-geist-sans", subsets: ["latin"] });
+const geistMono = Geist_Mono({ variable: "--font-geist-mono", subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: "__PROJECT_NAME__",
+  description: "Bridge an ERC-20 across two Avalanche L1s — scaffolded with AvaKit.",
+};
+
+export default function RootLayout({ children }: Readonly<{ children: ReactNode }>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body className={`${geistSans.variable} ${geistMono.variable} font-sans antialiased`}>
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  );
+}

package/templates/token-bridge/app/page.tsx

@@ -0,0 +1,5 @@
+import { Demo } from "@/components/demo";
+
+export default function Home() {
+  return <Demo />;
+}

package/templates/token-bridge/app/providers.tsx

@@ -0,0 +1,22 @@
+"use client";
+
+import { injectedAdapter, type WalletAdapter } from "@avakit/core";
+import { AvaKitProvider } from "@avakit/react";
+import { ThemeProvider } from "next-themes";
+import { type ReactNode, useMemo } from "react";
+import { homeChain, remoteChain } from "@/lib/ictt";
+
+export function Providers({ children }: { children: ReactNode }) {
+  // Local devnet: connect a browser wallet (Core / MetaMask) with the imported
+  // EWOQ dev key. Both local L1s are registered so the app can switch between
+  // them to bridge and read balances on each.
+  const adapters = useMemo<WalletAdapter[]>(() => [injectedAdapter()], []);
+
+  return (
+    <ThemeProvider attribute="class" defaultTheme="system" enableSystem disableTransitionOnChange>
+      <AvaKitProvider chains={[homeChain, remoteChain]} adapters={adapters}>
+        {children}
+      </AvaKitProvider>
+    </ThemeProvider>
+  );
+}

package/templates/token-bridge/bridge.config.json

@@ -0,0 +1,6 @@
+{
+  "configured": false,
+  "chain1": { "name": "chain1", "token": "TOK1", "evmChainId": 1001, "rpcUrl": "", "blockchainIdHex": "" },
+  "chain2": { "name": "chain2", "token": "TOK2", "evmChainId": 1002, "rpcUrl": "", "blockchainIdHex": "" },
+  "bridge": null
+}