clawcontract 0.1.0

package/dist/verifier/explorer-api.d.ts

@@ -0,0 +1,21 @@
+export interface SubmitVerificationOptions {
+    contractAddress: string;
+    sourceCode: string;
+    contractName: string;
+    chainKey: string;
+    constructorArgs?: string;
+    compilerVersion?: string;
+    optimizationUsed?: boolean;
+    runs?: number;
+    codeFormat?: string;
+}
+export declare function submitVerification(options: SubmitVerificationOptions): Promise<string>;
+export declare function checkVerificationStatus(guid: string, chainKey: string): Promise<{
+    success: boolean;
+    message: string;
+}>;
+export declare function pollVerificationStatus(guid: string, chainKey: string): Promise<{
+    success: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=explorer-api.d.ts.map

package/dist/verifier/explorer-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer-api.d.ts","sourceRoot":"","sources":["../../src/verifier/explorer-api.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiBD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAsDjB;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BhD;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAehD"}

package/dist/verifier/explorer-api.js

@@ -0,0 +1,92 @@
+import { getChain } from '../config/chains.js';
+const ETHERSCAN_V2_BASE = 'https://api.etherscan.io/v2/api';
+const DEFAULT_COMPILER_VERSION = 'v0.8.20+commit.a1b79de6';
+const DEFAULT_RUNS = 200;
+const MAX_RETRIES = 5;
+const INITIAL_POLL_INTERVAL_MS = 5_000;
+const SUBMIT_MAX_RETRIES = 5;
+const SUBMIT_INITIAL_DELAY_MS = 5_000;
+export async function submitVerification(options) {
+    const chain = getChain(options.chainKey);
+    const apiKey = process.env['BSCSCAN_API_KEY'];
+    if (!apiKey) {
+        throw new Error('BSCSCAN_API_KEY environment variable is not set');
+    }
+    const params = new URLSearchParams({
+        module: 'contract',
+        action: 'verifysourcecode',
+        contractaddress: options.contractAddress,
+        sourceCode: options.sourceCode,
+        codeformat: options.codeFormat ?? 'solidity-single-file',
+        contractname: options.contractName,
+        compilerversion: options.compilerVersion ?? DEFAULT_COMPILER_VERSION,
+        optimizationUsed: options.optimizationUsed === false ? '0' : '1',
+        runs: String(options.runs ?? DEFAULT_RUNS),
+        apikey: apiKey,
+    });
+    if (options.constructorArgs) {
+        params.set('constructorArguements', options.constructorArgs);
+    }
+    const url = `${ETHERSCAN_V2_BASE}?chainid=${chain.chainId}`;
+    let delay = SUBMIT_INITIAL_DELAY_MS;
+    for (let attempt = 0; attempt <= SUBMIT_MAX_RETRIES; attempt++) {
+        if (attempt > 0) {
+            await sleep(delay);
+            delay = Math.min(delay * 2, 30_000);
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: params.toString(),
+        });
+        const data = (await response.json());
+        if (data.status === '1') {
+            return data.result;
+        }
+        const isNotIndexed = data.result?.includes('Unable to locate ContractCode');
+        if (isNotIndexed && attempt < SUBMIT_MAX_RETRIES) {
+            continue;
+        }
+        throw new Error(`Verification submission failed: ${data.result}`);
+    }
+    throw new Error('Verification submission failed after maximum retries');
+}
+export async function checkVerificationStatus(guid, chainKey) {
+    const chain = getChain(chainKey);
+    const apiKey = process.env['BSCSCAN_API_KEY'];
+    if (!apiKey) {
+        throw new Error('BSCSCAN_API_KEY environment variable is not set');
+    }
+    const params = new URLSearchParams({
+        module: 'contract',
+        action: 'checkverifystatus',
+        guid,
+        apikey: apiKey,
+    });
+    const url = `${ETHERSCAN_V2_BASE}?chainid=${chain.chainId}&${params.toString()}`;
+    const response = await fetch(url);
+    const data = (await response.json());
+    if (data.result === 'Pending in queue') {
+        return { success: false, message: data.result };
+    }
+    if (data.status === '1') {
+        return { success: true, message: data.result };
+    }
+    return { success: false, message: data.result };
+}
+export async function pollVerificationStatus(guid, chainKey) {
+    let delay = INITIAL_POLL_INTERVAL_MS;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        await sleep(delay);
+        const result = await checkVerificationStatus(guid, chainKey);
+        if (result.success || (result.message !== 'Pending in queue')) {
+            return result;
+        }
+        delay = Math.min(delay * 2, 30_000);
+    }
+    return { success: false, message: 'Verification timed out after maximum retries' };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=explorer-api.js.map

package/dist/verifier/explorer-api.js.map

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

package/dist/verifier/index.d.ts

@@ -0,0 +1,20 @@
+export interface VerifyOptions {
+    contractAddress: string;
+    chainKey: string;
+    constructorArgs?: string;
+    sourceCode?: string;
+    contractName?: string;
+    compilerVersion?: string;
+    optimizationUsed?: boolean;
+    runs?: number;
+    standardJsonInput?: unknown;
+    solcLongVersion?: string;
+    fullyQualifiedName?: string;
+}
+export interface VerifyResult {
+    success: boolean;
+    message: string;
+    explorerUrl: string;
+}
+export declare function verifyContract(options: VerifyOptions): Promise<VerifyResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verifier/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAgClF"}

package/dist/verifier/index.js

@@ -0,0 +1,31 @@
+import { getChain } from '../config/chains.js';
+import { submitVerification, pollVerificationStatus } from './explorer-api.js';
+export async function verifyContract(options) {
+    const chain = getChain(options.chainKey);
+    const useStandardJson = !!options.standardJsonInput;
+    const guid = await submitVerification({
+        contractAddress: options.contractAddress,
+        sourceCode: useStandardJson
+            ? JSON.stringify(options.standardJsonInput)
+            : options.sourceCode ?? '',
+        contractName: useStandardJson
+            ? (options.fullyQualifiedName ?? options.contractName ?? '')
+            : (options.contractName ?? ''),
+        chainKey: options.chainKey,
+        constructorArgs: options.constructorArgs,
+        compilerVersion: useStandardJson
+            ? (options.solcLongVersion ? `v${options.solcLongVersion}` : options.compilerVersion)
+            : options.compilerVersion,
+        optimizationUsed: options.optimizationUsed,
+        runs: options.runs,
+        codeFormat: useStandardJson ? 'solidity-standard-json-input' : 'solidity-single-file',
+    });
+    const result = await pollVerificationStatus(guid, options.chainKey);
+    const explorerUrl = `${chain.explorerUrl}/address/${options.contractAddress}#code`;
+    return {
+        success: result.success,
+        message: result.message,
+        explorerUrl,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/verifier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verifier/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAsB/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAsB;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzC,MAAM,eAAe,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAEpD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,UAAU,EAAE,eAAe;YACzB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE;QAC5B,YAAY,EAAE,eAAe;YAC3B,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;YAC5D,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,eAAe,EAAE,eAAe;YAC9B,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;YACrF,CAAC,CAAC,OAAO,CAAC,eAAe;QAC3B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,sBAAsB;KACtF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpE,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,WAAW,YAAY,OAAO,CAAC,eAAe,OAAO,CAAC;IAEnF,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "clawcontract",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "AI-powered smart contract generator, analyzer, and deployer for BNB Chain",
+  "main": "./dist/index.js",
+  "bin": {
+    "clawcontract": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "start": "node dist/cli/index.js"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@nomicfoundation/hardhat-toolbox": "^5.0.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "dotenv": "^17.2.4",
+    "ethers": "^6.16.0",
+    "hardhat": "2.28.0",
+    "ora": "^9.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cvpfus/clawcontract.git"
+  },
+  "keywords": [
+    "smart-contract",
+    "bnb-chain",
+    "bsc",
+    "solidity",
+    "ai",
+    "web3",
+    "opbnb"
+  ],
+  "author": "cvpfus",
+  "homepage": "https://github.com/cvpfus/clawcontract#readme"
+}