create-avalanche-app 0.1.5 → 0.1.7

package/templates/token-bridge/scripts/bridge.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+#
+# One-command local Interchain Token Transfer (ICTT) bridge.
+#
+# Spins up TWO Avalanche L1s (Subnet-EVM) with Interchain Messaging + a relayer,
+# then deploys a full ICTT bridge across them: a demo ERC-20 + a Token Home on
+# chain1, and a Token Remote on chain2, registered over ICM. Addresses land in
+# bridge.config.json so the app can bridge tokens between the two chains.
+#
+# Requires avalanche-cli. Contract deploys use viem + the bundled ICTT artifacts
+# (no Foundry, no on-machine Solidity compile) run through scripts/deploy-bridge.mjs.
+
+set -uo pipefail
+
+CHAIN1="chain1"; EVM1=1001; TOK1="TOK1"
+CHAIN2="chain2"; EVM2=1002; TOK2="TOK2"
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+CONFIG="$ROOT/bridge.config.json"
+
+say() { printf "\033[1;37m▸\033[0m %s\n" "$1"; }
+die() { printf "\033[1;31m✖\033[0m %s\n" "$1" >&2; exit 1; }
+
+if ! command -v avalanche >/dev/null 2>&1; then
+  cat >&2 <<'EOF'
+✖ avalanche-cli not found. Install it:
+
+  curl -sSfL https://raw.githubusercontent.com/ava-labs/avalanche-cli/main/scripts/install.sh | sh -s -- -b /usr/local/bin
+
+Then re-run: pnpm bridge
+EOF
+  exit 1
+fi
+
+# --- 1. Create + deploy the two L1s (ICM + relayer on by default) -----------
+create_l1() {
+  local name="$1" cid="$2" tok="$3"
+  say "Creating L1 '$name' (evm chainId $cid)…"
+  avalanche blockchain create "$name" \
+    --evm --latest --evm-chain-id "$cid" --evm-token "$tok" \
+    --test-defaults --sovereign=false --icm --force </dev/null >/dev/null 2>&1 \
+    || die "Failed to create '$name'. Try: avalanche blockchain delete $name"
+}
+create_l1 "$CHAIN1" "$EVM1" "$TOK1"
+create_l1 "$CHAIN2" "$EVM2" "$TOK2"
+
+say "Deploying '$CHAIN1' locally (this also starts the local network)…"
+avalanche blockchain deploy "$CHAIN1" --local </dev/null || die "Deploy of '$CHAIN1' failed."
+say "Deploying '$CHAIN2' locally…"
+avalanche blockchain deploy "$CHAIN2" --local </dev/null || die "Deploy of '$CHAIN2' failed."
+
+# --- 2. Discover each chain's RPC URL + hex blockchain ID -------------------
+discover() {
+  local name="$1" out
+  out="$(avalanche blockchain describe "$name" 2>/dev/null)"
+  local rpc bid
+  rpc="$(printf '%s' "$out" | grep -oE 'http://127\.0\.0\.1:[0-9]+/ext/bc/[A-Za-z0-9]+/rpc' | head -1)"
+  bid="$(printf '%s' "$out" | grep -iE 'BlockchainID \(HEX\)' | grep -oiE '0x[0-9a-f]{64}' | head -1)"
+  printf '%s\t%s' "$rpc" "$bid"
+}
+say "Reading chain details…"
+IFS=$'\t' read -r RPC1 BID1 < <(discover "$CHAIN1")
+IFS=$'\t' read -r RPC2 BID2 < <(discover "$CHAIN2")
+[ -n "$RPC1" ] && [ -n "$BID1" ] || die "Could not read '$CHAIN1' RPC/blockchain ID."
+[ -n "$RPC2" ] && [ -n "$BID2" ] || die "Could not read '$CHAIN2' RPC/blockchain ID."
+
+# --- 3. Write the partial config the deploy step reads ----------------------
+cat > "$CONFIG" <<EOF
+{
+  "configured": false,
+  "chain1": { "name": "$CHAIN1", "token": "$TOK1", "evmChainId": $EVM1, "rpcUrl": "$RPC1", "blockchainIdHex": "$BID1" },
+  "chain2": { "name": "$CHAIN2", "token": "$TOK2", "evmChainId": $EVM2, "rpcUrl": "$RPC2", "blockchainIdHex": "$BID2" },
+  "bridge": null
+}
+EOF
+
+# --- 4. Deploy the ICTT bridge (demo token + home + remote + register) ------
+say "Deploying the ICTT bridge (demo token, home, remote, registration)…"
+command -v node >/dev/null 2>&1 || die "node is required to deploy the bridge contracts."
+node "$ROOT/scripts/deploy-bridge.mjs" || die "Bridge deploy failed. Is the network healthy? Try: avalanche network status"
+
+cat <<EOF
+
+✔ Local ICTT bridge is up.
+
+Next:
+  1. Import the EWOQ dev key into your wallet (Core / MetaMask), pre-funded on both chains:
+       0x56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027
+     (public dev key, local only)
+  2. pnpm dev  →  http://localhost:3000
+  3. Mint the demo token on $CHAIN1, then bridge it to $CHAIN2 and watch it arrive.
+
+Reset:
+  avalanche network stop     # pause (keeps state)
+  avalanche network clean    # wipe (re-run pnpm bridge)
+EOF

package/templates/token-bridge/scripts/deploy-bridge.mjs

@@ -0,0 +1,107 @@
+// Deploys the ICTT bridge onto the two local L1s that scripts/bridge.sh created.
+//
+// On the home chain: a demo ERC-20, a TeleporterRegistry, and an ERC20TokenHome.
+// On the remote chain: a TeleporterRegistry and an ERC20TokenRemote, then it
+// calls registerWithHome so the remote registers with the home over ICM.
+// All addresses are written back into bridge.config.json for the app to read.
+//
+// Uses viem + the embedded ICTT artifacts (lib/ictt-artifacts.json). Runs with
+// the public EWOQ dev key, which is pre-funded on every local chain.
+
+import { readFileSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { createPublicClient, createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+
+const ROOT = fileURLToPath(new URL("..", import.meta.url));
+const CONFIG = `${ROOT}/bridge.config.json`;
+const A = JSON.parse(readFileSync(`${ROOT}/lib/ictt-artifacts.json`, "utf8"));
+const cfg = JSON.parse(readFileSync(CONFIG, "utf8"));
+
+// The TeleporterMessenger is the same fixed predeploy on every ICM-enabled L1.
+const MESSENGER = "0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf";
+const ZERO = "0x0000000000000000000000000000000000000000";
+// EWOQ: avalanche-cli's public local dev key, pre-funded on every local chain.
+const EWOQ = "0x56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027";
+const account = privateKeyToAccount(EWOQ);
+
+function clients(c) {
+  const chain = {
+    id: c.evmChainId,
+    name: c.name,
+    nativeCurrency: { name: c.token, symbol: c.token, decimals: 18 },
+    rpcUrls: { default: { http: [c.rpcUrl] } },
+  };
+  return {
+    pub: createPublicClient({ chain, transport: http(c.rpcUrl) }),
+    wal: createWalletClient({ account, chain, transport: http(c.rpcUrl) }),
+  };
+}
+
+async function deploy(c, art, args) {
+  const hash = await c.wal.deployContract({ abi: art.abi, bytecode: art.bytecode, args, account });
+  const r = await c.pub.waitForTransactionReceipt({ hash, timeout: 120000, pollingInterval: 1000 });
+  if (r.status !== "success") throw new Error("deploy reverted");
+  return r.contractAddress;
+}
+async function tx(c, params, label) {
+  const hash = await c.wal.writeContract({ ...params, account });
+  const r = await c.pub.waitForTransactionReceipt({ hash, timeout: 120000, pollingInterval: 1000 });
+  console.log(`  ${label}: ${hash} (${r.status})`);
+  if (r.status !== "success") throw new Error(`${label} reverted`);
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+async function main() {
+  const c1 = clients(cfg.chain1);
+  const c2 = clients(cfg.chain2);
+  const registryArgs = [[{ version: 1n, protocolAddress: MESSENGER }]];
+
+  console.log("Deploying demo ERC-20 on", cfg.chain1.name);
+  const demoToken = await deploy(c1, A.DemoToken, []);
+  await tx(c1, { address: demoToken, abi: A.DemoToken.abi, functionName: "mint" }, "mint 100 to deployer");
+
+  console.log("Deploying home side on", cfg.chain1.name);
+  const registry1 = await deploy(c1, A.TeleporterRegistry, registryArgs);
+  const home = await deploy(c1, A.ERC20TokenHome, [registry1, account.address, 1n, demoToken, 18]);
+
+  console.log("Deploying remote side on", cfg.chain2.name);
+  const registry2 = await deploy(c2, A.TeleporterRegistry, registryArgs);
+  const remote = await deploy(c2, A.ERC20TokenRemote, [
+    {
+      teleporterRegistryAddress: registry2,
+      teleporterManager: account.address,
+      minTeleporterVersion: 1n,
+      tokenHomeBlockchainID: cfg.chain1.blockchainIdHex,
+      tokenHomeAddress: home,
+      tokenHomeDecimals: 18,
+    },
+    `Bridged ${cfg.chain1.token}`,
+    `${cfg.chain1.token}.b`,
+    18,
+  ]);
+
+  console.log("Registering remote with home over ICM");
+  await tx(
+    c2,
+    {
+      address: remote,
+      abi: A.ERC20TokenRemote.abi,
+      functionName: "registerWithHome",
+      args: [{ feeTokenAddress: ZERO, amount: 0n }],
+    },
+    "registerWithHome",
+  );
+  await sleep(8000); // let the relayer deliver the registration
+
+  cfg.configured = true;
+  cfg.bridge = { demoToken, registry1, home, registry2, remote };
+  writeFileSync(CONFIG, `${JSON.stringify(cfg, null, 2)}\n`);
+  console.log("\nWrote bridge.config.json:");
+  console.log(JSON.stringify(cfg.bridge, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e instanceof Error ? e.message : e);
+  process.exit(1);
+});

package/templates/token-bridge/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}