Modifier در سالیدیتی راهی برای تعریف شرط‌های تکرارشونده است تا بدون تکرار کد، روی چند تابع اعمال شوند؛ دقیقا مثل onlyOwner که قبل از اجرای تابع بررسی می‌کند فقط مالک اجازه دسترسی دارد. برای استفاده، یک modifier با منطق بررسی می‌نویسید و با افزودن نام آن به امضای تابع، اجرای تابع را مشروط می‌کنید. علامت _ در بدنه modifier جای بدنه اصلی تابع است و ترتیب اجرای کد را مشخص می‌کند.

Modifier چیست و دقیقا چگونه کار می‌کند؟

Modifier یک بلوک کد قابل استفاده مجدد است که می‌تواند قبل و/یا بعد از بدنه تابع اجرا شود. داخل modifier با استفاده از require یا خطای سفارشی، شروط دسترسی، اعتبارسنجی ورودی و سایر قواعد مشترک را پیاده می‌کنید. در هنگام فراخوانی تابع، کد modifier جایگزین امضا شده و درست پیش از رسیدن به بدنه تابع (یا پس از آن، بسته به جایگاه _)، اجرا می‌شود.

  • علامت ویژه _ فقط یک بار در هر modifier مجاز است و نشان دهنده محل اجرای بدنه تابع است.
  • اگر چند modifier روی یک تابع باشند، از چپ به راست اجرا می‌شوند.
  • می‌توانید modifierها را پارامتری کنید تا شرط را بر اساس ورودی‌ها پیکربندی کنید.

مثال پایه onlyOwner با خطای سفارشی (بهینه از نظر گس)

هدف: تعریف مالک قرارداد و محدود کردن برخی توابع فقط به مالک.

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

contract OwnableLite {
    address public owner;

    error NotOwner();

    constructor() {
        owner = msg.sender;
    }

    modifier onlyOwner() {
        if (msg.sender != owner) revert NotOwner();
        _;
    }

    function transferOwnership(address newOwner) external onlyOwner {
        require(newOwner != address(0), "zero address");
        owner = newOwner;
    }
}

contract Vault is OwnableLite {
    event Deposited(address indexed from, uint256 amount);
    event Withdrawn(address indexed to, uint256 amount);

    function deposit() external payable {
        require(msg.value > 0, "no ether");
        emit Deposited(msg.sender, msg.value);
    }

    function withdraw(address payable to, uint256 amount) external onlyOwner {
        require(address(this).balance >= amount, "insufficient");
        to.transfer(amount);
        emit Withdrawn(to, amount);
    }
}

بررسی نتیجه: هر تلاشی برای اجرای withdraw توسط غیرمالک، با خطای NotOwner بازگشت می‌خورد. تست ساده: بعد از دیپلوی، آدرس دیگری را فراخواننده withdraw کنید تا خطا را ببینید؛ سپس با آدرس مالک تست موفق را انجام دهید.

Modifier پارامتری: اعتبارسنجی ورودی یا شرایط پویا

این الگو برای شرایطی مثل حداقل مبلغ، محدودیت اندازه آرایه یا نقش‌های پویا کاربردی است.

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

error InsufficientValue(uint256 required, uint256 got);

contract Paygate {
    modifier costs(uint256 priceWei) {
        if (msg.value < priceWei) revert InsufficientValue(priceWei, msg.value);
        _;
    }

    function buy() external payable costs(0.1 ether) {
        // منطق خرید
    }
}

نکته: خطاهای سفارشی (custom errors) نسبت به پیام رشته‌ای require در زمان بازگشت، گس کمتری مصرف می‌کنند.

ترکیب چند modifier و اهمیت ترتیب اجرا

وقتی چند modifier دارید، از چپ به راست اجرا می‌شوند. اگر یکی revert کند، بقیه اجرا نمی‌شوند. ترتیب را آگاهانه انتخاب کنید تا پیام خطا و اثرات جانبی مطابق انتظار باشد.

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

contract Sale {
    bool public paused;

    error Paused();

    modifier whenNotPaused() {
        if (paused) revert Paused();
        _;
    }

    modifier costs(uint256 priceWei) {
        require(msg.value >= priceWei, "under price");
        _;
    }

    function togglePause() external { paused = !paused; }

    // نخست حالت توقف را بررسی کن، سپس هزینه
    function mint() external payable whenNotPaused costs(0.05 ether) {
        // ضرب توکن
    }
}

اگر costs را قبل از whenNotPaused بگذارید، هنگام توقف هم ابتدا پیام under price را می‌گیرید که برای کاربر گمراه‌کننده است.

کد قبل و بعد از بدنه تابع: جایگاه _

با قرار دادن کد قبل یا بعد از _ می‌توانید رفتارهای پیش و پس از اجرا بسازید؛ مثلا شمارش دفعات یا پاکسازی.

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

contract Hooks {
    uint256 public calls;

    // شمارش پس از اجرای تابع
    modifier countAfter() {
        _;
        unchecked { calls++; }
    }

    function doWork() external countAfter {
        // کار اصلی
    }
}

بهتر است modifier را برای منطق سبک نگه دارید. عملیات پیچیده پس از اجرا می‌تواند ریسک خطا یا هزینه گس غیرمنتظره ایجاد کند.

نکات امنیتی و خطاهای رایج

  • منطق سنگین یا فراخوانی خارجی در modifier ممنوع: modifier باید سبک و قابل استدلال باشد. فراخوانی خارجی در modifier می‌تواند الگوی Checks-Effects-Interactions را مخدوش کند و سطح حمله را افزایش دهد. برای تعاملات خارجی از توابع داخلی استفاده کنید و در صورت نیاز الگوی ضدحمله را با راهنمای ReentrancyGuard در سالیدیتی مرور کنید.
  • یک بار _ کافی است: تلاش برای چند _ در یک modifier پترن قابل نگهداری و مورد پشتیبانی نیست.
  • از tx.origin استفاده نکنید: برای کنترل دسترسی، msg.sender مرجع درست است. tx.origin می‌تواند شما را در برابر حملات فیشینگ قراردادها آسیب‌پذیر کند.
  • خطای قابل فهم بازگردانید: از custom errors یا پیام‌های کوتاه و گویا استفاده کنید تا دیباگ ساده و هزینه کمتر باشد.
  • ترتیب modifiers اهمیت دارد: ابتدا ارزان‌ترین و محتمل‌ترین شرط شکست را بگذارید تا گس کمتری هدر برود و پیام خطا درست باشد.
  • زمان‌محورها با احتیاط: اگر modifier زمان‌محور نوشتید (مثلا onlyBefore(deadline))، بدانید block.timestamp کمی قابل دستکاری است و برای امنیت سطح بالا کافی نیست.

الگوهای پیشرفته با modifier

کنترل نقش‌ها (RBAC) با modifier پارامتری

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

contract Roles {
    mapping(bytes32 => mapping(address => bool)) public hasRole;
    error MissingRole(bytes32 role, address account);

    modifier onlyRole(bytes32 role) {
        if (!hasRole[role][msg.sender]) revert MissingRole(role, msg.sender);
        _;
    }

    function grantRole(bytes32 role, address account) external onlyRole(keccak256("ADMIN")) {
        hasRole[role][account] = true;
    }
}

نکته: برای درخواست‌های خارج از زنجیره می‌توانید مجوز را با امضای معتبر بررسی کنید. آموزش گام به گام را در آموزش امضای EIP-712 در سالیدیتی ببینید.

allowlist کم‌هزینه با Merkle Proof

به جای نگه داشتن همه آدرس‌ها در زنجیره، ریشه مرکل را ذخیره و در modifier اثبات را اعتبارسنجی کنید.

منطق کامل ساخت و تایید را می‌توانید در آموزش Merkle Proof در سالیدیتی دنبال کنید؛ فقط کافی است کد تایید را داخل modifier onlyWhitelisted بگذارید و روی توابع ضرب یا claim اعمال کنید.

چگونه درست بودن modifier را بررسی کنیم؟

  • تست واحد «باید شکست بخورد»: با آدرس غیرمجاز تابع محدود شده را فرابخوانید و انتظار revert دقیق (خطای سفارشی یا پیام) داشته باشید.
  • تست واحد «باید موفق شود»: با آدرس مجاز همان تابع را اجرا کنید و اثر وضعیت یا رخداد را بررسی کنید.
  • تست ترتیب: وقتی چند modifier دارید، با سناریوهای مختلف مطمئن شوید پیام بازگشت و گس مطابق انتظار است.
  • تست فازی ورودی: برای modifierهای پارامتری (مقادیر حداقل/حداکثر)، کرانه‌ها را آزمایش کنید.

چه زمانی modifier بنویسیم و چه زمانی تابع داخلی؟

  • modifier مناسب است وقتی: شرط کوتاه، خالص، تکرارشونده و مربوط به «اجازه اجرای تابع» باشد (دسترسی، توقف/شروع، محدودیت مقدار).
  • تابع داخلی مناسب است وقتی: منطق چندمرحله‌ای، شامل تعامل خارجی، تغییر وضعیت پیچیده یا نیازمند reuse در جاهای غیر از شروع/پایان تابع دارید.

چک لیست سریع ساخت یک modifier ایمن

  1. نام روشن و معنی‌دار انتخاب کنید (onlyOwner، whenNotPaused، costs).
  2. در صورت امکان از custom errors استفاده کنید.
  3. منطق را سبک و بدون فراخوانی خارجی نگه دارید.
  4. اگر چند modifier دارید، ترتیب را آگاهانه مشخص کنید.
  5. برای شرایط پویا، نسخه پارامتری بنویسید.
  6. در تست‌ها سناریوهای موفق و شکست را پوشش دهید.

گام بعدی

اگر به دنبال مسیری منظم برای یادگیری عمیق سالیدیتی هستید، تمرین‌های مربوط به کنترل دسترسی، امنیت قرارداد و الگوهای طراحی را در آموزش جامع سالیدیتی + 5 پروژه عملی دنبال کنید.

سالیدیتی را با ۵ پروژه عملی یاد بگیر
از مفاهیم پایه تا نوشتن، تست و دیپلوی قرارداد هوشمند: To Do List، انتخابات، قرارداد پیمانکاری، توکن ERC20 و NFT. حدود ۵۰ جلسه، با پشتیبانی تیکتی مستقیم با مدرس.
۷,۹۰۰,۰۰۰تومان
یا 4 قسط با اسنپ‌پی؛ هر قسط ۱,۹۷۵,۰۰۰تومان
مشاهده سرفصل‌ها و ثبت‌نام