معيار الرمز المميز القابل للدفع ⁦ERC-1363⁩

pragma solidity ^0.8.0;

/**
 * @title ERC1363
 * @dev واجهة امتداد لرموز ERC-20 المميزة تدعم تنفيذ التعليمات البرمجية على عقد المستلم
 * بعد `transfer` أو `transferFrom`، أو التعليمات البرمجية على عقد المنفق بعد `approve`، في معاملة واحدة.
 */
interface ERC1363 is ERC20, ERC165 {
  /*
   * ملاحظة: معرف ERC-165 لهذه الواجهة هو 0xb0202a11.
   * 0xb0202a11 ===
   *   bytes4(keccak256('transferAndCall(address,uint256)')) ^
   *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^
   *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^
   *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^
   *   bytes4(keccak256('approveAndCall(address,uint256)')) ^
   *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))
   */

  /**
   * @dev ينقل مقدار `value` من الرموز المميزة من حساب المتصل إلى `to`
   * ثم يستدعي `ERC1363Receiver::onTransferReceived` على `to`.
   * @param to العنوان الذي يتم تحويل الرموز المميزة إليه.
   * @param value مقدار الرموز المميزة المراد تحويلها.
   * @return قيمة منطقية تشير إلى نجاح العملية ما لم يتم طرح خطأ.
   */
  function transferAndCall(address to, uint256 value) external returns (bool);

  /**
   * @dev ينقل مقدار `value` من الرموز المميزة من حساب المتصل إلى `to`
   * ثم يستدعي `ERC1363Receiver::onTransferReceived` على `to`.
   * @param to العنوان الذي يتم تحويل الرموز المميزة إليه.
   * @param value مقدار الرموز المميزة المراد تحويلها.
   * @param data بيانات إضافية بدون تنسيق محدد، يتم إرسالها في الاستدعاء إلى `to`.
   * @return قيمة منطقية تشير إلى نجاح العملية ما لم يتم طرح خطأ.
   */
  function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev ينقل مقدار `value` من الرموز المميزة من `from` إلى `to` باستخدام آلية السماحية
   * ثم يستدعي `ERC1363Receiver::onTransferReceived` على `to`.
   * @param from العنوان الذي سيتم إرسال الرموز المميزة منه.
   * @param to العنوان الذي يتم تحويل الرموز المميزة إليه.
   * @param value مقدار الرموز المميزة المراد تحويلها.
   * @return قيمة منطقية تشير إلى نجاح العملية ما لم يتم طرح خطأ.
   */
  function transferFromAndCall(address from, address to, uint256 value) external returns (bool);

  /**
   * @dev ينقل مقدار `value` من الرموز المميزة من `from` إلى `to` باستخدام آلية السماحية
   * ثم يستدعي `ERC1363Receiver::onTransferReceived` على `to`.
   * @param from العنوان الذي سيتم إرسال الرموز المميزة منه.
   * @param to العنوان الذي يتم تحويل الرموز المميزة إليه.
   * @param value مقدار الرموز المميزة المراد تحويلها.
   * @param data بيانات إضافية بدون تنسيق محدد، يتم إرسالها في الاستدعاء إلى `to`.
   * @return قيمة منطقية تشير إلى نجاح العملية ما لم يتم طرح خطأ.
   */
  function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev يعين مقدار `value` من الرموز المميزة كسماحية لـ `spender` على الرموز المميزة الخاصة بالمتصل
   * ثم يستدعي `ERC1363Spender::onApprovalReceived` على `spender`.
   * @param spender العنوان الذي سينفق الأموال.
   * @param value مقدار الرموز المميزة المراد إنفاقها.
   * @return قيمة منطقية تشير إلى نجاح العملية ما لم يتم طرح خطأ.
   */
  function approveAndCall(address spender, uint256 value) external returns (bool);

  /**
   * @dev يعين مقدار `value` من الرموز المميزة كسماحية لـ `spender` على الرموز المميزة الخاصة بالمتصل
   * ثم يستدعي `ERC1363Spender::onApprovalReceived` على `spender`.
   * @param spender العنوان الذي سينفق الأموال.
   * @param value مقدار الرموز المميزة المراد إنفاقها.
   * @param data بيانات إضافية بدون تنسيق محدد، يتم إرسالها في الاستدعاء إلى `spender`.
   * @return قيمة منطقية تشير إلى نجاح العملية ما لم يتم طرح خطأ.
   */
  function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);
}

interface ERC20 {
  event Transfer(address indexed from, address indexed to, uint256 value);
  event Approval(address indexed owner, address indexed spender, uint256 value);
  function transfer(address to, uint256 value) external returns (bool);
  function transferFrom(address from, address to, uint256 value) external returns (bool);
  function approve(address spender, uint256 value) external returns (bool);
  function totalSupply() external view returns (uint256);
  function balanceOf(address account) external view returns (uint256);
  function allowance(address owner, address spender) external view returns (uint256);
}

interface ERC165 {
  function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

/**
 * @title ERC1363Receiver
 * @dev واجهة لأي عقد يريد دعم `transferAndCall` أو `transferFromAndCall` من عقود الرموز المميزة ERC-1363.
 */
interface ERC1363Receiver {
  /**
   * @dev كلما تم تحويل رموز ERC-1363 المميزة إلى هذا العقد عبر `ERC1363::transferAndCall` أو `ERC1363::transferFromAndCall`
   * بواسطة `operator` من `from`، يتم استدعاء هذه الدالة.
   *
   * ملاحظة: لقبول التحويل، يجب أن تُرجع هذه الدالة
   * `bytes4(keccak256("onTransferReceived(address,address,uint256,bytes)"))`
   * (أي 0x88a7ca5c، أو محدد الدالة الخاص بها).
   *
   * @param operator العنوان الذي استدعى دالة `transferAndCall` أو `transferFromAndCall`.
   * @param from العنوان الذي يتم تحويل الرموز المميزة منه.
   * @param value مقدار الرموز المميزة المحولة.
   * @param data بيانات إضافية بدون تنسيق محدد.
   * @return `bytes4(keccak256("onTransferReceived(address,address,uint256,bytes)"))` إذا كان التحويل مسموحًا به ما لم يتم طرح خطأ.
   */
  function onTransferReceived(address operator, address from, uint256 value, bytes calldata data) external returns (bytes4);
}

/**
 * @title ERC1363Spender
 * @dev واجهة لأي عقد يريد دعم `approveAndCall` من عقود الرموز المميزة ERC-1363.
 */
interface ERC1363Spender {
  /**
   * @dev كلما وافق `owner` لرموز ERC-1363 المميزة على هذا العقد عبر `ERC1363::approveAndCall`
   * لإنفاق رموزه المميزة، يتم استدعاء هذه الدالة.
   *
   * ملاحظة: لقبول الموافقة، يجب أن تُرجع هذه الدالة
   * `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))`
   * (أي 0x7b04a2d0، أو محدد الدالة الخاص بها).
   *
   * @param owner العنوان الذي استدعى دالة `approveAndCall` وكان يمتلك الرموز المميزة مسبقًا.
   * @param value مقدار الرموز المميزة المراد إنفاقها.
   * @param data بيانات إضافية بدون تنسيق محدد.
   * @return `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))` إذا كانت الموافقة مسموحة ما لم يتم طرح خطأ.
   */
  function onApprovalReceived(address owner, uint256 value, bytes calldata data) external returns (bytes4);
}