# 1️⃣ استنساخ المستودع
git clone https://github.com/your-org/evm-audit-helpers.git
cd evm-audit-helpers

# 2️⃣ تثبيت Foundry (إذا لم يكن مثبتاً بالفعل)
curl -L https://foundry.paradigm.xyz | bash
foundryup

# 3️⃣ تثبيت التبعيات
forge install

# 4️⃣ تشغيل مجموعة الاختبار الافتراضية (تشمل فحوصات إعادة الدخول والتخزين والغاز)
forge test

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "evm-audit-helpers/src/helpers/Reentrancy.sol";

contract MyVault is ReentrancyGuard {
    mapping(address => uint256) private balances;

    function deposit() external payable nonReentrant {
        balances[msg.sender] += msg.value;
    }

    function withdraw(uint256 amount) external nonReentrant {
        require(balances[msg.sender] >= amount, "Insufficient");
        balances[msg.sender] -= amount;
        (bool ok,) = msg.sender.call{value: amount}("");
        require(ok, "Transfer failed");
    }
}

forge script scripts/reentrancy_check.sol:ReentrancyChecker --rpc-url $RPC_URL --broadcast

# إنشاء وصف JSON لتخطيط تخزين عقد مُجمَّع
cast abi-storage --contract MyUpgradeable.sol:MyUpgradeable > storage.json

# المقارنة مع تخطيط مرجعي (مثل: من إصدار سابق)
forge script scripts/storage_analyzer.sol:StorageComparator \
    --sig "compare(string memory, string memory)" storage.json reference.json

cp -r test/templates/reentrancy/ my-audit/tests/

forge test --match-contract MyContract

# .github/workflows/audit.yml
name: EVM Audit

on:
  push:
    branches: [main]
  pull_request:

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Foundry
        run: curl -L https://foundry.paradigm.xyz | bash && foundryup
      - name: Run Audit Suite
        run: |
          forge install
          forge test -vv
          forge script scripts/reentrancy_check.sol:ReentrancyChecker --rpc-url ${{ secrets.RPC_URL }}
          forge script scripts/storage_analyzer.sol:StorageComparator --sig "compare(string,string)" storage.json reference.json

# تثبيت أدوات الفحص اللغوي
npm install

# تشغيل solhint
npx solhint 'src/**/*.sol' 'test/**/*.sol'

# تنسيق تلقائي
npx prettier --write '**/*.sol'