clawcontract 0.1.0

package/dist/deployer/deploy.js

@@ -0,0 +1,60 @@
+import { ethers } from 'ethers';
+import { getChain } from '../config/chains.js';
+import { compileContract } from './compiler.js';
+export async function estimateGas(sourceFile, chainKey, privateKey) {
+    const chain = getChain(chainKey);
+    const { abi, bytecode } = await compileContract(sourceFile);
+    const provider = new ethers.JsonRpcProvider(chain.rpcUrl, {
+        name: chain.name,
+        chainId: chain.chainId,
+    });
+    const wallet = new ethers.Wallet(privateKey, provider);
+    const factory = new ethers.ContractFactory(abi, bytecode, wallet);
+    const deployTx = await factory.getDeployTransaction();
+    const gasLimit = await provider.estimateGas({
+        ...deployTx,
+        from: wallet.address,
+    });
+    const feeData = await provider.getFeeData();
+    const gasPrice = feeData.gasPrice ?? 0n;
+    const totalCostWei = gasLimit * gasPrice;
+    const bufferCostWei = (totalCostWei * 120n) / 100n;
+    return {
+        gasLimit,
+        gasPrice,
+        totalCostWei,
+        totalCostBNB: ethers.formatEther(totalCostWei),
+        totalCostWithBuffer: ethers.formatEther(bufferCostWei),
+    };
+}
+export async function deployContract(options) {
+    const { sourceFile, chainKey, constructorArgs = [], privateKey } = options;
+    const chain = getChain(chainKey);
+    const compiled = await compileContract(sourceFile);
+    const provider = new ethers.JsonRpcProvider(chain.rpcUrl, {
+        name: chain.name,
+        chainId: chain.chainId,
+    });
+    const wallet = new ethers.Wallet(privateKey, provider);
+    const factory = new ethers.ContractFactory(compiled.abi, compiled.bytecode, wallet);
+    const contract = await factory.deploy(...constructorArgs);
+    const confirmations = chain.isTestnet ? 1 : 3;
+    const receipt = await contract.deploymentTransaction().wait(confirmations);
+    if (!receipt) {
+        throw new Error('Deployment transaction failed: no receipt returned');
+    }
+    const contractAddress = await contract.getAddress();
+    return {
+        contractAddress,
+        transactionHash: receipt.hash,
+        blockNumber: receipt.blockNumber,
+        gasUsed: receipt.gasUsed.toString(),
+        deployer: wallet.address,
+        chainKey,
+        explorerUrl: `${chain.explorerUrl}/address/${contractAddress}`,
+        standardJsonInput: compiled.standardJsonInput,
+        solcLongVersion: compiled.solcLongVersion,
+        fullyQualifiedName: compiled.fullyQualifiedName,
+    };
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deployer/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/deployer/deploy.ts"],"names":[],"mappings":"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"}

package/dist/deployer/hardhat-config-template.d.ts

@@ -0,0 +1,2 @@
+export declare function getHardhatConfigContent(): string;
+//# sourceMappingURL=hardhat-config-template.d.ts.map

package/dist/deployer/hardhat-config-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardhat-config-template.d.ts","sourceRoot":"","sources":["../../src/deployer/hardhat-config-template.ts"],"names":[],"mappings":"AAAA,wBAAgB,uBAAuB,IAAI,MAAM,CAkBhD"}

package/dist/deployer/hardhat-config-template.js

@@ -0,0 +1,20 @@
+export function getHardhatConfigContent() {
+    return `
+import { HardhatUserConfig } from "hardhat/config";
+
+const config: HardhatUserConfig = {
+  solidity: {
+    version: "0.8.20",
+    settings: {
+      optimizer: {
+        enabled: true,
+        runs: 200,
+      },
+    },
+  },
+};
+
+export default config;
+`.trimStart();
+}
+//# sourceMappingURL=hardhat-config-template.js.map

package/dist/deployer/hardhat-config-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardhat-config-template.js","sourceRoot":"","sources":["../../src/deployer/hardhat-config-template.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB;IACrC,OAAO;;;;;;;;;;;;;;;;CAgBR,CAAC,SAAS,EAAE,CAAC;AACd,CAAC"}

package/dist/deployer/index.d.ts

@@ -0,0 +1,7 @@
+export type { CompileResult } from './compiler.js';
+export { compileContract } from './compiler.js';
+export type { DeployOptions, DeployResult, GasEstimate } from './deploy.js';
+export { estimateGas, deployContract } from './deploy.js';
+export type { DeploymentRecord } from './metadata.js';
+export { saveDeployment, loadDeployment, loadAllDeployments, deleteDeployment } from './metadata.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/deployer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deployer/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/deployer/index.js

@@ -0,0 +1,4 @@
+export { compileContract } from './compiler.js';
+export { estimateGas, deployContract } from './deploy.js';
+export { saveDeployment, loadDeployment, loadAllDeployments, deleteDeployment } from './metadata.js';
+//# sourceMappingURL=index.js.map

package/dist/deployer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/deployer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/deployer/metadata.d.ts

@@ -0,0 +1,16 @@
+export interface DeploymentRecord {
+    contractAddress: string;
+    abi: readonly Record<string, unknown>[];
+    chainKey: string;
+    contractName: string;
+    sourceFile: string;
+    deployer: string;
+    transactionHash: string;
+    blockNumber: number;
+    deployedAt: string;
+}
+export declare function saveDeployment(record: DeploymentRecord, outputDir: string): void;
+export declare function loadDeployment(address: string, outputDir: string): DeploymentRecord | undefined;
+export declare function loadAllDeployments(outputDir: string): DeploymentRecord[];
+export declare function deleteDeployment(address: string, outputDir: string): boolean;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/deployer/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/deployer/metadata.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAuOD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,GAChB,IAAI,CAkEN;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,SAAS,CA4B9B;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA6BxE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA6E5E"}

package/dist/deployer/metadata.js

@@ -0,0 +1,315 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+const DEPLOYMENTS_DIR = '.deployments';
+const LEGACY_FILE = '.deployments.json';
+const LEGACY_BACKUP = '.deployments.v1.json.bak';
+function deploymentsRoot(outputDir) {
+    return path.resolve(outputDir, DEPLOYMENTS_DIR);
+}
+function indexPath(outputDir) {
+    return path.join(deploymentsRoot(outputDir), 'index.json');
+}
+function abiFilePath(outputDir, hash) {
+    return path.join(deploymentsRoot(outputDir), 'abis', `${hash}.json`);
+}
+function recordFilePath(outputDir, chainKey, contractName, address) {
+    return path.join(deploymentsRoot(outputDir), 'records', chainKey, contractName, `${address}.json`);
+}
+// ---------------------------------------------------------------------------
+// ABI hashing
+// ---------------------------------------------------------------------------
+function hashAbi(abi) {
+    return crypto.createHash('sha256').update(JSON.stringify(abi)).digest('hex');
+}
+// ---------------------------------------------------------------------------
+// Index helpers
+// ---------------------------------------------------------------------------
+function emptyIndex() {
+    return { version: 2, byAddress: {}, byChain: {} };
+}
+function readIndex(outputDir) {
+    const p = indexPath(outputDir);
+    if (!fs.existsSync(p)) {
+        return emptyIndex();
+    }
+    return JSON.parse(fs.readFileSync(p, 'utf-8'));
+}
+function atomicWriteJson(filePath, data) {
+    const content = JSON.stringify(data, null, 2);
+    const tmpFile = path.join(os.tmpdir(), `deploy-${Date.now()}-${Math.random().toString(36).slice(2)}.json`);
+    fs.writeFileSync(tmpFile, content, 'utf-8');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    try {
+        fs.renameSync(tmpFile, filePath);
+    }
+    catch {
+        fs.copyFileSync(tmpFile, filePath);
+        fs.unlinkSync(tmpFile);
+    }
+}
+// ---------------------------------------------------------------------------
+// Migration from v1 flat file
+// ---------------------------------------------------------------------------
+function migrateIfNeeded(outputDir) {
+    const legacyPath = path.resolve(outputDir, LEGACY_FILE);
+    const root = deploymentsRoot(outputDir);
+    if (!fs.existsSync(legacyPath) || fs.existsSync(root)) {
+        return;
+    }
+    const raw = fs.readFileSync(legacyPath, 'utf-8');
+    let records;
+    try {
+        records = JSON.parse(raw);
+    }
+    catch {
+        return; // corrupted legacy file – skip migration
+    }
+    // Bootstrap empty directory structure
+    fs.mkdirSync(root, { recursive: true });
+    const index = emptyIndex();
+    for (const record of records) {
+        const abiH = hashAbi(record.abi);
+        // Write ABI file if not already present
+        const abiPath = abiFilePath(outputDir, abiH);
+        if (!fs.existsSync(abiPath)) {
+            fs.mkdirSync(path.dirname(abiPath), { recursive: true });
+            fs.writeFileSync(abiPath, JSON.stringify({ abi: record.abi }, null, 2), 'utf-8');
+        }
+        // Write record file
+        const stored = {
+            version: 2,
+            contractAddress: record.contractAddress,
+            abiHash: abiH,
+            chainKey: record.chainKey,
+            contractName: record.contractName,
+            sourceFile: record.sourceFile,
+            deployer: record.deployer,
+            transactionHash: record.transactionHash,
+            blockNumber: record.blockNumber,
+            deployedAt: record.deployedAt,
+        };
+        const recPath = recordFilePath(outputDir, record.chainKey, record.contractName, record.contractAddress);
+        fs.mkdirSync(path.dirname(recPath), { recursive: true });
+        fs.writeFileSync(recPath, JSON.stringify(stored, null, 2), 'utf-8');
+        // Update index
+        const addrLower = record.contractAddress.toLowerCase();
+        index.byAddress[addrLower] = {
+            chainKey: record.chainKey,
+            contractName: record.contractName,
+        };
+        if (!index.byChain[record.chainKey]) {
+            index.byChain[record.chainKey] = {};
+        }
+        const chainBucket = index.byChain[record.chainKey];
+        if (!chainBucket[record.contractName]) {
+            chainBucket[record.contractName] = {
+                latestAddress: record.contractAddress,
+                addresses: [],
+            };
+        }
+        const entry = chainBucket[record.contractName];
+        if (!entry.addresses.includes(record.contractAddress)) {
+            entry.addresses.push(record.contractAddress);
+        }
+        entry.latestAddress = record.contractAddress;
+    }
+    // Write index
+    atomicWriteJson(indexPath(outputDir), index);
+    // Rename legacy file to backup
+    const backupPath = path.resolve(outputDir, LEGACY_BACKUP);
+    try {
+        fs.renameSync(legacyPath, backupPath);
+    }
+    catch {
+        fs.copyFileSync(legacyPath, backupPath);
+        fs.unlinkSync(legacyPath);
+    }
+}
+// ---------------------------------------------------------------------------
+// Reconstruct a full DeploymentRecord from stored record + ABI file
+// ---------------------------------------------------------------------------
+function hydrateRecord(stored, outputDir) {
+    const abiPath = abiFilePath(outputDir, stored.abiHash);
+    const abiData = JSON.parse(fs.readFileSync(abiPath, 'utf-8'));
+    return {
+        contractAddress: stored.contractAddress,
+        abi: abiData.abi,
+        chainKey: stored.chainKey,
+        contractName: stored.contractName,
+        sourceFile: stored.sourceFile,
+        deployer: stored.deployer,
+        transactionHash: stored.transactionHash,
+        blockNumber: stored.blockNumber,
+        deployedAt: stored.deployedAt,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function saveDeployment(record, outputDir) {
+    migrateIfNeeded(outputDir);
+    const root = deploymentsRoot(outputDir);
+    fs.mkdirSync(root, { recursive: true });
+    // 1. Write ABI file (deduplicated by content hash)
+    const abiH = hashAbi(record.abi);
+    const abiPath = abiFilePath(outputDir, abiH);
+    if (!fs.existsSync(abiPath)) {
+        fs.mkdirSync(path.dirname(abiPath), { recursive: true });
+        fs.writeFileSync(abiPath, JSON.stringify({ abi: record.abi }, null, 2), 'utf-8');
+    }
+    // 2. Write record file (no ABI inline)
+    const stored = {
+        version: 2,
+        contractAddress: record.contractAddress,
+        abiHash: abiH,
+        chainKey: record.chainKey,
+        contractName: record.contractName,
+        sourceFile: record.sourceFile,
+        deployer: record.deployer,
+        transactionHash: record.transactionHash,
+        blockNumber: record.blockNumber,
+        deployedAt: record.deployedAt,
+    };
+    const recPath = recordFilePath(outputDir, record.chainKey, record.contractName, record.contractAddress);
+    fs.mkdirSync(path.dirname(recPath), { recursive: true });
+    fs.writeFileSync(recPath, JSON.stringify(stored, null, 2), 'utf-8');
+    // 3. Update index.json (atomic write)
+    const index = readIndex(outputDir);
+    const addrLower = record.contractAddress.toLowerCase();
+    index.byAddress[addrLower] = {
+        chainKey: record.chainKey,
+        contractName: record.contractName,
+    };
+    if (!index.byChain[record.chainKey]) {
+        index.byChain[record.chainKey] = {};
+    }
+    const chainBucket = index.byChain[record.chainKey];
+    if (!chainBucket[record.contractName]) {
+        chainBucket[record.contractName] = {
+            latestAddress: record.contractAddress,
+            addresses: [],
+        };
+    }
+    const entry = chainBucket[record.contractName];
+    if (!entry.addresses.includes(record.contractAddress)) {
+        entry.addresses.push(record.contractAddress);
+    }
+    entry.latestAddress = record.contractAddress;
+    atomicWriteJson(indexPath(outputDir), index);
+}
+export function loadDeployment(address, outputDir) {
+    migrateIfNeeded(outputDir);
+    const index = readIndex(outputDir);
+    const needle = address.toLowerCase();
+    const entry = index.byAddress[needle];
+    if (!entry) {
+        return undefined;
+    }
+    const recPath = recordFilePath(outputDir, entry.chainKey, entry.contractName, 
+    // We need the original-cased address stored in the record file name.
+    // The index stores the chainKey+contractName; iterate addresses to find the
+    // matching one (case-insensitive) so we get the correct filename.
+    findOriginalAddress(index, entry.chainKey, entry.contractName, needle));
+    if (!fs.existsSync(recPath)) {
+        return undefined;
+    }
+    const stored = JSON.parse(fs.readFileSync(recPath, 'utf-8'));
+    return hydrateRecord(stored, outputDir);
+}
+export function loadAllDeployments(outputDir) {
+    migrateIfNeeded(outputDir);
+    const index = readIndex(outputDir);
+    const results = [];
+    for (const [addrLower, entry] of Object.entries(index.byAddress)) {
+        const originalAddr = findOriginalAddress(index, entry.chainKey, entry.contractName, addrLower);
+        const recPath = recordFilePath(outputDir, entry.chainKey, entry.contractName, originalAddr);
+        if (!fs.existsSync(recPath)) {
+            continue;
+        }
+        const stored = JSON.parse(fs.readFileSync(recPath, 'utf-8'));
+        results.push(hydrateRecord(stored, outputDir));
+    }
+    return results;
+}
+export function deleteDeployment(address, outputDir) {
+    migrateIfNeeded(outputDir);
+    const index = readIndex(outputDir);
+    const needle = address.toLowerCase();
+    const entry = index.byAddress[needle];
+    if (!entry) {
+        return false;
+    }
+    const { chainKey, contractName } = entry;
+    const originalAddr = findOriginalAddress(index, chainKey, contractName, needle);
+    // 1. Read record to get abiHash, then delete record file
+    const recPath = recordFilePath(outputDir, chainKey, contractName, originalAddr);
+    const stored = JSON.parse(fs.readFileSync(recPath, 'utf-8'));
+    const { abiHash } = stored;
+    fs.unlinkSync(recPath);
+    // 2. Remove from byAddress
+    delete index.byAddress[needle];
+    // 3. Update byChain
+    const chainBucket = index.byChain[chainKey];
+    if (chainBucket) {
+        const contractEntry = chainBucket[contractName];
+        if (contractEntry) {
+            contractEntry.addresses = contractEntry.addresses.filter((a) => a.toLowerCase() !== needle);
+            if (contractEntry.addresses.length === 0) {
+                delete chainBucket[contractName];
+            }
+            else if (contractEntry.latestAddress.toLowerCase() === needle) {
+                contractEntry.latestAddress =
+                    contractEntry.addresses[contractEntry.addresses.length - 1];
+            }
+        }
+        if (Object.keys(chainBucket).length === 0) {
+            delete index.byChain[chainKey];
+        }
+    }
+    // 4. Garbage-collect ABI file if no remaining record references it
+    let abiStillReferenced = false;
+    for (const [remainingLower, remainingEntry] of Object.entries(index.byAddress)) {
+        const remainingOriginal = findOriginalAddress(index, remainingEntry.chainKey, remainingEntry.contractName, remainingLower);
+        const remainingRecPath = recordFilePath(outputDir, remainingEntry.chainKey, remainingEntry.contractName, remainingOriginal);
+        if (fs.existsSync(remainingRecPath)) {
+            const remainingStored = JSON.parse(fs.readFileSync(remainingRecPath, 'utf-8'));
+            if (remainingStored.abiHash === abiHash) {
+                abiStillReferenced = true;
+                break;
+            }
+        }
+    }
+    if (!abiStillReferenced) {
+        const abiPath = abiFilePath(outputDir, abiHash);
+        if (fs.existsSync(abiPath)) {
+            fs.unlinkSync(abiPath);
+        }
+    }
+    // 5. Persist updated index
+    atomicWriteJson(indexPath(outputDir), index);
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Internal helper – resolve original-cased address from index
+// ---------------------------------------------------------------------------
+function findOriginalAddress(index, chainKey, contractName, lowerAddress) {
+    const chainBucket = index.byChain[chainKey];
+    if (chainBucket) {
+        const contractEntry = chainBucket[contractName];
+        if (contractEntry) {
+            for (const addr of contractEntry.addresses) {
+                if (addr.toLowerCase() === lowerAddress) {
+                    return addr;
+                }
+            }
+        }
+    }
+    // Fallback – use lowercased version (shouldn't happen in a consistent store)
+    return lowerAddress;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/deployer/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/deployer/metadata.ts"],"names":[],"mappings":"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"}

package/dist/deployer/wallet.d.ts

@@ -0,0 +1,6 @@
+export declare function resolvePrivateKey(): string;
+export declare function getWalletInfo(privateKey: string): {
+    address: string;
+    privateKey: string;
+};
+//# sourceMappingURL=wallet.d.ts.map

package/dist/deployer/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/deployer/wallet.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,IAAI,MAAM,CAe1C;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAIzF"}

package/dist/deployer/wallet.js

@@ -0,0 +1,21 @@
+import { ethers } from 'ethers';
+import chalk from 'chalk';
+export function resolvePrivateKey() {
+    const envKey = process.env.PRIVATE_KEY;
+    if (envKey && envKey.trim()) {
+        return envKey.startsWith('0x') ? envKey : `0x${envKey}`;
+    }
+    const wallet = ethers.Wallet.createRandom();
+    const generatedKey = wallet.privateKey;
+    console.log(chalk.yellow('\n  ⚠ No PRIVATE_KEY found — auto-generated a new wallet:'));
+    console.log(chalk.yellow(`    Address:     ${wallet.address}`));
+    console.log(chalk.yellow(`    Private Key: ${generatedKey}`));
+    console.log(chalk.yellow('    Save this key to your .env file to reuse this wallet.\n'));
+    return generatedKey;
+}
+export function getWalletInfo(privateKey) {
+    const normalized = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`;
+    const wallet = new ethers.Wallet(normalized);
+    return { address: wallet.address, privateKey: normalized };
+}
+//# sourceMappingURL=wallet.js.map

package/dist/deployer/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/deployer/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC;IAEvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2DAA2D,CAAC,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,YAAY,EAAE,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6DAA6D,CAAC,CAAC,CAAC;IAEzF,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAC7D,CAAC"}

package/dist/generator/index.d.ts

@@ -0,0 +1,19 @@
+export type { ContractTemplate } from "./templates/index.js";
+export { TEMPLATES, findTemplateByKeyword, fillTemplate, } from "./templates/index.js";
+export { createLLMClient } from "./llm.js";
+export type { LLMClient } from "./llm.js";
+export { extractContractName, sanitizeFileName, writeFileUnique, ensureOutputDir } from "./utils.js";
+export interface GenerateOptions {
+    description: string;
+    outputDir: string;
+    useAI: boolean;
+}
+export interface GenerateResult {
+    filePath: string;
+    contractName: string;
+    source: string;
+    templateUsed: string | null;
+    aiGenerated: boolean;
+}
+export declare function generateContract(options: GenerateOptions): Promise<GenerateResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAYA,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErG,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAiCzB"}

package/dist/generator/index.js

@@ -0,0 +1,33 @@
+import { createLLMClient } from "./llm.js";
+import { extractContractName, sanitizeFileName, writeFileUnique, ensureOutputDir, } from "./utils.js";
+export { TEMPLATES, findTemplateByKeyword, fillTemplate, } from "./templates/index.js";
+export { createLLMClient } from "./llm.js";
+export { extractContractName, sanitizeFileName, writeFileUnique, ensureOutputDir } from "./utils.js";
+export async function generateContract(options) {
+    const { description, outputDir, useAI } = options;
+    const llm = createLLMClient();
+    const aiAvailable = useAI && llm.isAvailable();
+    let source;
+    let templateUsed = null;
+    let aiGenerated = false;
+    if (aiAvailable) {
+        source = await llm.generateContract(description);
+        aiGenerated = true;
+    }
+    else {
+        throw new Error("AI generation is unavailable. " +
+            "Set the OPENROUTER_API_KEY environment variable to enable contract generation.");
+    }
+    await ensureOutputDir(outputDir);
+    const contractName = extractContractName(source);
+    const fileName = sanitizeFileName(contractName);
+    const filePath = await writeFileUnique(outputDir, fileName, source);
+    return {
+        filePath,
+        contractName,
+        source,
+        templateUsed,
+        aiGenerated,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgBrG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAwB;IAExB,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAElD,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,KAAK,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;IAE/C,IAAI,MAAc,CAAC;IACnB,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACjD,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,gCAAgC;YAC9B,gFAAgF,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAEjC,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEpE,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,MAAM;QACN,YAAY;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/generator/llm.d.ts

@@ -0,0 +1,10 @@
+export type LLMProvider = "openrouter";
+export interface LLMClient {
+    isAvailable(): boolean;
+    provider(): LLMProvider | null;
+    customizeContract(template: string, description: string): Promise<string>;
+    generateContract(description: string): Promise<string>;
+    suggestFixes(code: string, issues: string[]): Promise<string>;
+}
+export declare function createLLMClient(): LLMClient;
+//# sourceMappingURL=llm.d.ts.map

package/dist/generator/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/generator/llm.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,WAAW,IAAI,OAAO,CAAC;IACvB,QAAQ,IAAI,WAAW,GAAG,IAAI,CAAC;IAC/B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;AAqFD,wBAAgB,eAAe,IAAI,SAAS,CAQ3C"}