create-kozalak-l1 0.1.0

package/README.md

@@ -0,0 +1,87 @@
+# create-kozalak-l1
+
+Avalanche L1 için **denetime hazır (audit-grade) Foundry projelerini** tek
+komutla oluşturan interaktif CLI. Bir şablon seçersin, CLI kendi başına
+derlenip test edilen standalone bir Foundry projesi çıkarır; istersen
+bağımlılıkları kurar ve kontratı Fuji testnet'e deploy eder.
+
+## Kullanım
+
+```bash
+npx create-kozalak-l1
+```
+
+CLI seni adım adım yönlendirir:
+
+1. **Proje adı** — oluşturulacak klasör (argüman olarak da verebilirsin:
+   `npx create-kozalak-l1 benim-projem`).
+2. **Şablon seçimi** — aşağıdaki 5 şablondan biri.
+3. **Bağımlılıklar** — `forge install` ile pinli commit'lerden kurulum
+   (isteğe bağlı).
+4. **Deploy** — deploy edilebilir şablonlarda Fuji testnet'e tek-komut deploy
+   (isteğe bağlı; private key **yalnızca testnet cüzdanı** olmalı, disk'e
+   yazılmaz).
+
+### Şablonlar
+
+| Şablon | Ne işe yarar |
+| --- | --- |
+| `erc20-gas` | Mintable, capped arz, sahip-kontrollü ERC-20 gaz token'ı |
+| `erc721-collection` | Merkle allowlist + faz bazlı mint, royalty destekli NFT koleksiyonu |
+| `soulbound-credential` | Devredilemez, role-bazlı sertifika NFT'si |
+| `treasury-multisig` | TimelockController tabanlı gecikmeli-yürütme hazine kontratı |
+| `ictt-bridge` | Avalanche ICTT ile C-Chain ↔ L1 token köprüsü (scaffold-only) |
+
+> `ictt-bridge` iki-zincirli, çok-adımlı bir kurulum gerektirdiği için otomatik
+> deploy edilmez; CLI seni adım adım rehbere (`docs/tr/03-templateler/ictt-bridge.md`)
+> yönlendirir.
+
+### Oluşturduktan sonra
+
+```bash
+cd benim-projem
+forge install   # bağımlılıkları CLI'da kurmadıysan
+forge test
+```
+
+Deploy için proje README'sindeki adımları izle (`.env` doldur → `forge script`).
+
+## Geliştirme
+
+Bu paket kozalak-l1 mono-repo'sunun bir parçasıdır.
+
+```bash
+cd cli
+npm install
+npm run build            # TypeScript → dist/
+npm run build:templates  # cli/templates/ paketlerini repo kaynaklarından yeniden üret
+npm test                 # vitest (registry / scaffold / forge parse testleri)
+```
+
+`build:templates`, repo'nun denetlenmiş kaynaklarından (`src/templates/`,
+`test/templates/`, `script/deploy/`, `foundry.lock`) her şablon için standalone
+bir Foundry projesi assemble eder ve `cli/templates/<id>/` altına yazar. Repo
+kaynakları değişince bu komut yeniden çalıştırılır ve paketlenmiş şablonlar
+senkronlanır.
+
+### Non-interactive mod (CI / E2E)
+
+Otomasyon için prompt'lar atlanabilir:
+
+```bash
+node dist/index.js koza-e2e --template erc20-gas --yes-install --no-deploy
+```
+
+- `--template <id>` — şablon seçer ve non-interactive modu açar.
+- `--yes-install` / `--no-install` — bağımlılık kurulumunu aç/kapat.
+- `--no-deploy` — deploy'u atla (non-interactive modda deploy zaten yapılmaz,
+  çünkü private key interaktif alınır).
+
+## Yayınlama
+
+Paket henüz npm'e yayınlanmadı. `npm publish` **yakında**; o zamana kadar
+mono-repo içinden `node dist/index.js` veya `npm run dev` ile çalıştırılır.
+
+## Lisans
+
+MIT

package/dist/deploy.js

@@ -0,0 +1,63 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { runForge, parseDeployedAddress } from './forge.js';
+const TELEPORTER_MESSENGER_ADDRESS = '0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf';
+const ROUTESCAN_TESTNET_VERIFIER = 'https://api.routescan.io/v2/network/testnet/evm/43113/etherscan';
+const FUJI_CHAIN_ID = '43113';
+/**
+ * Fuji deploy için forge `script` komutunun argümanlarını üretir.
+ *
+ * `deploy()`'dan ayrıştırılmıştır ki test edilebilsin — forge no-arg
+ * `vm.startBroadcast()` kullanıyor, yani `--private-key` argv'de geçilmezse
+ * forge `PRIVATE_KEY` env var'ından OTOMATİK imzalamaz ve "No associated
+ * wallet" hatasıyla fail eder.
+ */
+export function buildDeployArgs(input) {
+    const { template, privateKey, snowtraceKey } = input;
+    const scriptRelPath = join('script', basename(template.deployScript));
+    const args = ['script', scriptRelPath, '--rpc-url', 'fuji', '--broadcast', '--private-key', privateKey];
+    if (snowtraceKey) {
+        args.push('--verify', '--verifier-url', ROUTESCAN_TESTNET_VERIFIER, '--etherscan-api-key', snowtraceKey);
+    }
+    return args;
+}
+/**
+ * Scaffold edilmiş bir projeyi Fuji testnet'e deploy eder.
+ *
+ * Sadece `template.deployable === true` olan şablonlar için çalışır (ICTT gibi
+ * çok-adımlı şablonlar scaffold-only'dir, burada deploy edilmez).
+ *
+ * `privateKey` disk'e yazılmaz; yalnızca forge alt-süreci için argv + `process.env`
+ * üzerinden geçirilir.
+ */
+export async function deploy(input) {
+    const { template, cwd, privateKey, snowtraceKey, envParams } = input;
+    if (!template.deployable) {
+        throw new Error(`Şablon "${template.id}" deploy edilemez (deployable: false). Rehber: ${template.guideDoc}`);
+    }
+    // Registry'deki deployScript repo-relative bir yol (script/deploy/X.s.sol).
+    // Scaffold edilmiş projede yapı flatten edilmiştir (build-templates.ts): script/X.s.sol.
+    const scriptFile = basename(template.deployScript);
+    const env = {
+        ...process.env,
+        PRIVATE_KEY: privateKey,
+        TELEPORTER_MESSENGER_ADDRESS,
+        ...envParams,
+    };
+    if (snowtraceKey)
+        env.SNOWTRACE_API_KEY = snowtraceKey;
+    const args = buildDeployArgs({ template, privateKey, snowtraceKey });
+    const result = runForge(args, cwd, env);
+    if (result.code !== 0) {
+        // forge compile hatası / revert reason genelde stderr'e yazılır; ikisini de göster.
+        const detail = [result.stdout, result.stderr].filter((s) => s.trim()).join('\n');
+        throw new Error(`forge script başarısız oldu (exit ${result.code}):\n${detail}`);
+    }
+    const broadcastPath = join(cwd, 'broadcast', scriptFile, FUJI_CHAIN_ID, 'run-latest.json');
+    if (!existsSync(broadcastPath)) {
+        return { address: null, explorerUrl: null };
+    }
+    const address = parseDeployedAddress(readFileSync(broadcastPath, 'utf8'));
+    const explorerUrl = address ? `https://testnet.snowtrace.io/address/${address}` : null;
+    return { address, explorerUrl };
+}

package/dist/forge.js

@@ -0,0 +1,27 @@
+import { execSync, spawnSync } from 'node:child_process';
+/** `forge --version` çalışıyor mu (Foundry kurulu mu) kontrol eder. */
+export function forgeAvailable() {
+    try {
+        execSync('forge --version', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** `forge` komutunu verilen çalışma dizininde + ortam değişkenleriyle çalıştırır. */
+export function runForge(args, cwd, env) {
+    const result = spawnSync('forge', args, { cwd, env, encoding: 'utf8' });
+    return { code: result.status ?? 1, stdout: result.stdout ?? '', stderr: result.stderr ?? '' };
+}
+/** Foundry `broadcast/.../run-latest.json` içeriğinden ilk dolu contractAddress'i çıkarır. */
+export function parseDeployedAddress(broadcastJson) {
+    try {
+        const parsed = JSON.parse(broadcastJson);
+        const tx = parsed.transactions?.find((t) => t.contractAddress);
+        return tx?.contractAddress ?? null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+/**
+ * create-kozalak-l1 — interaktif scaffold + Fuji deploy akışı.
+ *
+ * Varsayılan mod: @clack ile adım adım sorular. Non-interactive mod
+ * (`--template <id>` verilince) prompt'ları atlar; E2E ve CI içindir.
+ *
+ * Örnek (non-interactive):
+ *   create-kozalak-l1 koza-e2e --template erc20-gas --yes-install --no-deploy
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { intro, outro, cancel, select, text, password, confirm, isCancel, note, log, } from "./prompts.js";
+import { TEMPLATES, getTemplate } from "./templates.js";
+import { scaffold } from "./scaffold.js";
+import { deploy } from "./deploy.js";
+import { forgeAvailable, runForge } from "./forge.js";
+function parseArgs(argv) {
+    let projectName;
+    let templateId;
+    let install = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--template")
+            templateId = argv[++i];
+        else if (a.startsWith("--template="))
+            templateId = a.slice("--template=".length);
+        else if (a === "--yes-install")
+            install = true;
+        else if (a === "--no-install")
+            install = false;
+        else if (a === "--no-deploy") {
+            /* non-interactive modda deploy zaten yapılmaz; flag CI okunabilirliği için kabul edilir */
+        }
+        else if (!a.startsWith("-") && projectName === undefined)
+            projectName = a;
+    }
+    return { projectName, templateId, install, nonInteractive: templateId !== undefined };
+}
+/** Bir prompt sonucu iptal edildiyse temiz çıkış yapar; değilse değeri döner. */
+function unwrap(value) {
+    if (isCancel(value))
+        cancel("İşlem iptal edildi.");
+    return value;
+}
+/**
+ * Scaffold edilmiş projenin README'sinden pinli `forge install ...` komutunu
+ * çıkarır (build-templates.ts her şablona bu satırı yazar). Bulunamazsa null.
+ */
+function forgeInstallArgs(cwd) {
+    const readmePath = join(cwd, "README.md");
+    if (!existsSync(readmePath))
+        return null;
+    const line = readFileSync(readmePath, "utf8")
+        .split(/\r?\n/)
+        .find((l) => l.trim().startsWith("forge install "));
+    if (!line)
+        return null;
+    return line.trim().split(/\s+/).slice(1); // ['install', 'org/repo@rev', ...]
+}
+async function runInstall(targetDir) {
+    if (!forgeAvailable()) {
+        log.warn("forge bulunamadı — bağımlılık kurulumu atlandı. Foundry kurup projede `forge install` çalıştırın.");
+        return;
+    }
+    const args = forgeInstallArgs(targetDir);
+    if (!args) {
+        log.warn("forge install komutu README'de bulunamadı; bağımlılıkları manuel kurun.");
+        return;
+    }
+    log.step("Bağımlılıklar kuruluyor (forge install)... bu biraz sürebilir.");
+    const res = runForge(args, targetDir, process.env);
+    if (res.code === 0) {
+        log.success("Bağımlılıklar kuruldu.");
+    }
+    else {
+        log.warn(`forge install başarısız (exit ${res.code}). Projede manuel çalıştırın:\n${res.stderr || res.stdout}`);
+    }
+}
+/** Deploy adımı: private key + snowtrace + envParams sorup deploy() çağırır. */
+async function runDeploy(template, targetDir) {
+    if (!forgeAvailable()) {
+        log.warn("forge bulunamadı — deploy atlandı. Foundry kurulumundan sonra tekrar deneyin.");
+        return;
+    }
+    const privateKey = unwrap(await password({
+        message: "Deploy private key (⚠️ SADECE testnet cüzdanı — mainnet anahtarı GİRMEYİN)",
+    }));
+    const snowRaw = unwrap(await text({
+        message: "Snowtrace/Routescan API key (opsiyonel — kontrat doğrulama için, boş geçebilirsiniz)",
+        placeholder: "rs_...",
+    }));
+    const snowtraceKey = snowRaw.trim() || undefined;
+    const envParams = {};
+    for (const p of template.envParams) {
+        const label = `${p.prompt}${p.optional ? " (opsiyonel)" : ""}`;
+        const raw = unwrap(p.secret ? await password({ message: label }) : await text({ message: label, placeholder: "" }));
+        const value = raw.trim();
+        if (value)
+            envParams[p.key] = value;
+    }
+    log.step("Fuji testnet'e deploy ediliyor...");
+    try {
+        const { address, explorerUrl } = await deploy({ template, cwd: targetDir, privateKey, snowtraceKey, envParams });
+        if (address) {
+            note(`Kontrat adresi:\n${address}\n\nExplorer:\n${explorerUrl}`, "Deploy başarılı");
+        }
+        else {
+            log.warn("Deploy tamamlandı ama kontrat adresi broadcast dosyasından okunamadı.");
+        }
+    }
+    catch (e) {
+        log.error(e.message);
+    }
+}
+async function main() {
+    const cli = parseArgs(process.argv.slice(2));
+    intro();
+    // 1) Proje adı
+    let projectName = cli.projectName;
+    if (!projectName) {
+        if (cli.nonInteractive)
+            cancel("Non-interactive modda proje adı zorunludur: create-kozalak-l1 <ad> --template <id>");
+        projectName = unwrap(await text({
+            message: "Proje adı (klasör olarak oluşturulur)",
+            placeholder: "benim-l1-projem",
+            validate: (v) => (v && v.trim() ? undefined : "Proje adı boş olamaz."),
+        })).trim();
+    }
+    // 2) Şablon
+    let template;
+    if (cli.nonInteractive) {
+        template = getTemplate(cli.templateId);
+        if (!template) {
+            cancel(`Geçersiz şablon: "${cli.templateId}". Geçerli: ${TEMPLATES.map((t) => t.id).join(", ")}`);
+        }
+    }
+    else {
+        const id = unwrap(await select({
+            message: "Bir şablon seçin",
+            options: TEMPLATES.map((t) => ({ value: t.id, label: t.label, hint: t.description })),
+        }));
+        template = getTemplate(id);
+    }
+    const tmpl = template;
+    // 3) Bağımlılık kurulumu?
+    const wantInstall = cli.nonInteractive
+        ? cli.install
+        : unwrap(await confirm({ message: "Bağımlılıklar şimdi kurulsun mu? (forge install)" }));
+    // 4) Scaffold
+    const targetDir = resolve(process.cwd(), projectName);
+    log.step(`"${projectName}" oluşturuluyor (${tmpl.label})...`);
+    try {
+        await scaffold({ template: tmpl, targetDir, projectName });
+    }
+    catch (e) {
+        cancel(e.message);
+    }
+    log.success("Proje dosyaları oluşturuldu.");
+    // 5) forge install (best-effort)
+    if (wantInstall)
+        await runInstall(targetDir);
+    // 6) Deploy (yalnızca interaktif mod + deployable şablon)
+    if (!tmpl.deployable) {
+        note(`Bu şablon (ICTT köprüsü) iki-zincirli, çok-adımlı bir kurulum gerektirir; otomatik tek-komut deploy yoktur.\n\nAdım adım rehber:\n${tmpl.guideDoc}`, "Sonraki adım: ICTT kurulum rehberi");
+    }
+    else if (!cli.nonInteractive) {
+        const wantDeploy = unwrap(await confirm({ message: "Şimdi Fuji testnet'e deploy edelim mi?" }));
+        if (wantDeploy)
+            await runDeploy(tmpl, targetDir);
+    }
+    outro(`Hazır! Sonraki adımlar:\n  cd ${projectName}\n  forge test`);
+}
+main().catch((e) => {
+    cancel(e.message);
+});

package/dist/prompts.js

@@ -0,0 +1,23 @@
+/**
+ * @clack/prompts ince sarmalayıcısı.
+ *
+ * intro/outro/cancel burada sabitlenir (banner metni, exit kodu); diğer
+ * prompt fonksiyonları (select/text/password/confirm/isCancel) doğrudan
+ * @clack/prompts'tan re-export edilir. Sonraki task'lar bu modülden import
+ * eder, doğrudan @clack/prompts'a bağımlı olmaz.
+ */
+import { intro as clackIntro, outro as clackOutro, cancel as clackCancel, } from "@clack/prompts";
+/** CLI banner'ını yazdırır. */
+export const intro = () => {
+    clackIntro("create-kozalak-l1");
+};
+/** Kapanış mesajını yazdırır. */
+export const outro = (msg) => {
+    clackOutro(msg);
+};
+/** İptal mesajını yazdırır ve süreci hata koduyla sonlandırır. */
+export function cancel(msg) {
+    clackCancel(msg);
+    process.exit(1);
+}
+export { select, text, password, confirm, isCancel, note, log } from "@clack/prompts";

package/dist/scaffold.js

@@ -0,0 +1,33 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { cp, mkdir, rename } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/** Bundle edilmiş templates/ dizininin paket-relative yolu (dist'ten paket köküne çözülür). */
+export function templatesRoot() {
+    return fileURLToPath(new URL('../templates', import.meta.url));
+}
+export async function scaffold(opts) {
+    const { template, targetDir } = opts;
+    if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+        throw new Error(`Hedef dizin boş değil: ${targetDir}`);
+    }
+    await mkdir(targetDir, { recursive: true });
+    const source = join(templatesRoot(), template.id);
+    await cp(source, targetDir, { recursive: true });
+    // npm `.gitignore` dosyalarını pakete koymaz (gitignore-fallback), bu yüzden
+    // template'lerde noktasız "gitignore" olarak taşınır. Kullanıcı gerçek bir
+    // `.gitignore` alsın diye burada rename ediyoruz.
+    const gitignoreSrc = join(targetDir, 'gitignore');
+    if (existsSync(gitignoreSrc)) {
+        await rename(gitignoreSrc, join(targetDir, '.gitignore'));
+    }
+    try {
+        await execFileAsync('git', ['init'], { cwd: targetDir });
+    }
+    catch {
+        console.warn('git init başarısız oldu, scaffold dosyaları yine de oluşturuldu (git yüklü değil mi?).');
+    }
+}

package/dist/templates.js

@@ -0,0 +1,108 @@
+const OZ_REMAPPINGS = ['@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/', 'forge-std/=lib/forge-std/src/'];
+const OZ_SUBMODULES = ['forge-std', 'openzeppelin-contracts'];
+const ICTT_REMAPPINGS = [
+    ...OZ_REMAPPINGS,
+    'icm-contracts/=lib/icm-contracts/',
+    '@subnet-evm/=lib/icm-contracts/contracts/subnet-evm/',
+    '@teleporter/=lib/icm-contracts/contracts/teleporter/',
+    '@utilities/=lib/icm-contracts/contracts/utilities/',
+    '@mocks/=lib/icm-contracts/contracts/mocks/',
+    '@ictt/=lib/icm-contracts/contracts/ictt/',
+];
+const ICTT_SUBMODULES = ['forge-std', 'openzeppelin-contracts', 'icm-contracts'];
+export const TEMPLATES = [
+    {
+        id: 'erc20-gas',
+        label: 'ERC-20 Gas Token',
+        description: 'Mintable, capped arz, sahip-kontrollü ERC-20 (KozaGasToken).',
+        srcFiles: ['src/templates/erc20-gas/KozaGasToken.sol'],
+        testFiles: [
+            'test/templates/ERC20Gas.t.sol',
+            'test/templates/ERC20Gas.invariants.t.sol',
+            'test/templates/DeployERC20Gas.t.sol',
+        ],
+        deployScript: 'script/deploy/DeployERC20Gas.s.sol',
+        guideDoc: 'docs/tr/03-templateler/erc20-gas.md',
+        remappings: OZ_REMAPPINGS,
+        submodules: OZ_SUBMODULES,
+        solc: '0.8.34',
+        envParams: [],
+        deployable: true,
+    },
+    {
+        id: 'erc721-collection',
+        label: 'ERC-721 Collection',
+        description: 'Merkle allowlist + faz bazlı mint, royalty destekli NFT koleksiyonu (KozaCollection).',
+        srcFiles: ['src/templates/erc721-collection/KozaCollection.sol'],
+        testFiles: [
+            'test/templates/ERC721Collection.t.sol',
+            'test/templates/ERC721Collection.invariants.t.sol',
+            'test/templates/DeployERC721Collection.t.sol',
+        ],
+        deployScript: 'script/deploy/DeployERC721Collection.s.sol',
+        guideDoc: 'docs/tr/03-templateler/erc721-collection.md',
+        remappings: OZ_REMAPPINGS,
+        submodules: OZ_SUBMODULES,
+        solc: '0.8.34',
+        envParams: [
+            { key: 'NFT_NAME', prompt: 'Koleksiyon adı', optional: true },
+            { key: 'NFT_SYMBOL', prompt: 'Koleksiyon sembolü', optional: true },
+            { key: 'NFT_BASE_URI', prompt: 'Base URI (ipfs://.../ ile bitmeli)', optional: true },
+            { key: 'NFT_MAX_SUPPLY', prompt: 'Maksimum arz', optional: true },
+            { key: 'NFT_MINT_PRICE', prompt: 'Mint fiyatı (wei)', optional: true },
+            { key: 'NFT_ROYALTY_BPS', prompt: 'Royalty (basis points, 500 = %5)', optional: true },
+            { key: 'NFT_ROYALTY_RECEIVER', prompt: 'Royalty alıcı adresi', optional: true },
+            { key: 'NFT_OWNER', prompt: 'Sahip adresi (boş → deployer)', optional: true },
+        ],
+        deployable: true,
+    },
+    {
+        id: 'soulbound-credential',
+        label: 'Soulbound Credential',
+        description: 'Devredilemez (soulbound), role-bazlı sertifika NFT\'si (KozaCredential).',
+        srcFiles: ['src/templates/soulbound-credential/KozaCredential.sol'],
+        testFiles: [
+            'test/templates/Soulbound.t.sol',
+            'test/templates/Soulbound.invariants.t.sol',
+            'test/templates/DeployCredential.t.sol',
+        ],
+        deployScript: 'script/deploy/DeployCredential.s.sol',
+        guideDoc: 'docs/tr/03-templateler/soulbound-credential.md',
+        remappings: OZ_REMAPPINGS,
+        submodules: OZ_SUBMODULES,
+        solc: '0.8.34',
+        envParams: [],
+        deployable: true,
+    },
+    {
+        id: 'treasury-multisig',
+        label: 'Treasury Multisig (Timelock)',
+        description: 'OpenZeppelin TimelockController tabanlı, gecikmeli-yürütme hazine kontratı (KozaTreasury).',
+        srcFiles: ['src/templates/treasury-multisig/KozaTreasury.sol'],
+        testFiles: ['test/templates/Treasury.t.sol', 'test/templates/DeployTreasury.t.sol'],
+        deployScript: 'script/deploy/DeployTreasury.s.sol',
+        guideDoc: 'docs/tr/03-templateler/treasury-multisig.md',
+        remappings: OZ_REMAPPINGS,
+        submodules: OZ_SUBMODULES,
+        solc: '0.8.34',
+        envParams: [],
+        deployable: true,
+    },
+    {
+        id: 'ictt-bridge',
+        label: 'ICTT Bridge (Home + Remote)',
+        description: 'Avalanche Interchain Token Transfer ile C-Chain ↔ L1 token köprüsü (KozaTokenHome + KozaTokenRemote).',
+        srcFiles: ['src/templates/ictt-bridge/KozaTokenHome.sol', 'src/templates/ictt-bridge/KozaTokenRemote.sol'],
+        testFiles: ['test/templates/ICTTBridge.t.sol'],
+        deployScript: 'script/deploy/DeployTokenHome.s.sol',
+        guideDoc: 'docs/tr/03-templateler/ictt-bridge.md',
+        remappings: ICTT_REMAPPINGS,
+        submodules: ICTT_SUBMODULES,
+        solc: '0.8.25',
+        envParams: [],
+        deployable: false,
+    },
+];
+export function getTemplate(id) {
+    return TEMPLATES.find((t) => t.id === id);
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "create-kozalak-l1",
+  "version": "0.1.0",
+  "description": "Avalanche L1 Foundry projesi scaffold + Fuji deploy eden interaktif CLI",
+  "type": "module",
+  "bin": {
+    "create-kozalak-l1": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:templates": "tsx scripts/build-templates.ts",
+    "test": "vitest run",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "license": "MIT"
+}

package/templates/erc20-gas/.env.example

@@ -0,0 +1,19 @@
+# ============================================
+# Bu dosyayı kopyalayıp `.env` olarak adlandırın. `.env` ASLA commit edilmez.
+# ============================================
+
+# ---- Deploy Wallet (Fuji testnet) ----
+# UYARI: Mainnet private key'i ASLA buraya koyma. Sadece testnet için.
+# Production'da Foundry Cast Wallet (encrypted keystore) veya hardware wallet kullan.
+PRIVATE_KEY=
+
+# Deployer adres (sanity check, opsiyonel)
+DEPLOYER_ADDRESS=
+
+# ---- Block Explorer (Routescan) ----
+# routescan.io'dan ücretsiz `rs_` prefix'li API key al. `--verify` için gerekir.
+SNOWTRACE_API_KEY=
+
+# ---- ICM / Teleporter ----
+# Avalanche Teleporter messenger — tüm L1'lerde deterministic adres.
+TELEPORTER_MESSENGER_ADDRESS=0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf

package/templates/erc20-gas/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "lib/forge-std"]
+	path = lib/forge-std
+	url = https://github.com/foundry-rs/forge-std
+[submodule "lib/openzeppelin-contracts"]
+	path = lib/openzeppelin-contracts
+	url = https://github.com/OpenZeppelin/openzeppelin-contracts

package/templates/erc20-gas/README.md

@@ -0,0 +1,48 @@
+# ERC-20 Gas Token
+
+Mintable, capped arz, sahip-kontrollü ERC-20 (KozaGasToken).
+
+Bu, kozalak-l1 deposundan üretilmiş **standalone** bir Foundry projesidir;
+kendi başına derlenir ve test edilir.
+
+## Kurulum
+
+```bash
+forge install foundry-rs/forge-std@8987040ede9553cea20c95ad40d0455930f9c8e0 OpenZeppelin/openzeppelin-contracts@e4f70216d759d8e6a64144a9e1f7bbeed78e7079
+forge build
+forge test
+```
+
+> `forge install ...@<commit>` bağımlılıkları repo ile birebir aynı commit'lere
+> pinler (aşağıdaki tabloya bakın). `.gitmodules` ve `remappings.txt`
+> bu pinlerle uyumludur.
+
+## Deploy (Fuji testnet)
+
+```bash
+cp .env.example .env      # PRIVATE_KEY + SNOWTRACE_API_KEY doldur
+forge script script/DeployERC20Gas.s.sol \
+    --rpc-url fuji \
+    --broadcast \
+    --verify
+```
+
+> Production: `PRIVATE_KEY` yalnızca testnet olmalı; sahiplik/yönetici
+> adreslerini bir multisig'e (Safe) yönlendir, EOA bırakma.
+
+## Yeniden adlandırma
+
+Contract'ı kendi adınla yeniden adlandırmak istersen `src/`, `test/` ve
+`script/` altındaki dosyalarda contract/dosya adını birlikte güncelle
+(import'lar tek-seviye relative olduğu için tutarlı kalmalı).
+
+## Bağımlılık pinleri
+
+| Bağımlılık | Tag | Commit (pin) |
+| --- | --- | --- |
+| `forge-std` | v1.16.0 | `8987040ede9553cea20c95ad40d0455930f9c8e0` |
+| `openzeppelin-contracts` | v5.3.0 | `e4f70216d759d8e6a64144a9e1f7bbeed78e7079` |
+
+---
+
+_Bu proje `create-kozalak-l1` tarafından üretildi. Kaynak: kozalak-l1 mono-repo._

package/templates/erc20-gas/foundry.toml

@@ -0,0 +1,35 @@
+[profile.default]
+src = "src"
+out = "out"
+libs = ["lib"]
+test = "test"
+script = "script"
+# Bu şablon solc 0.8.34 pragma'sı kullanır. auto_detect_solc dosya
+# pragma'sına göre doğru derleyiciyi otomatik indirir/seçer.
+auto_detect_solc = true
+optimizer = true
+optimizer_runs = 200
+via_ir = true
+bytecode_hash = "none"
+cbor_metadata = false
+remappings = [
+    "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/",
+    "forge-std/=lib/forge-std/src/"
+]
+
+[fmt]
+line_length = 120
+tab_width = 4
+bracket_spacing = false
+int_types = "long"
+multiline_func_header = "all"
+quote_style = "double"
+number_underscore = "thousands"
+
+[rpc_endpoints]
+fuji = "https://api.avax-test.network/ext/bc/C/rpc"
+avalanche = "https://api.avax.network/ext/bc/C/rpc"
+
+[etherscan]
+fuji = { key = "${SNOWTRACE_API_KEY}", url = "https://api.routescan.io/v2/network/testnet/evm/43113/etherscan", chain = 43113 }
+avalanche = { key = "${SNOWTRACE_API_KEY}", url = "https://api.routescan.io/v2/network/mainnet/evm/43114/etherscan", chain = 43114 }

package/templates/erc20-gas/gitignore

@@ -0,0 +1,5 @@
+.env
+out/
+cache/
+broadcast/
+lib/

package/templates/erc20-gas/remappings.txt

@@ -0,0 +1,2 @@
+@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/
+forge-std/=lib/forge-std/src/