⁦ERC-1363⁩ قابل ادائیگی ٹوکن کا معیار

pragma solidity ^0.8.0;

/**
 * @title ERC1363
 * @dev ERC-20 ٹوکنز کے لیے ایک ایکسٹینشن انٹرفیس جو ایک ہی ٹرانزیکشن میں `transfer` یا `transferFrom` کے بعد وصول کنندہ کنٹریکٹ پر، یا `approve` کے بعد خرچ کرنے والے (spender) کنٹریکٹ پر کوڈ چلانے کی سہولت فراہم کرتا ہے۔
 */
interface ERC1363 is ERC20, ERC165 {
  /*
   * نوٹ: اس انٹرفیس کے لیے ERC-165 شناخت کنندہ (identifier) 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` میں منتقل کرتا ہے
   * اور پھر `to` پر `ERC1363Receiver::onTransferReceived` کو کال کرتا ہے۔
   * @param to وہ ایڈریس جس پر ٹوکنز منتقل کیے جا رہے ہیں۔
   * @param value منتقل کیے جانے والے ٹوکنز کی مقدار۔
   * @return ایک بولین (boolean) ویلیو جو یہ ظاہر کرتی ہے کہ آپریشن کامیاب ہو گیا ہے، سوائے ایرر (throwing) کی صورت کے۔
   */
  function transferAndCall(address to, uint256 value) external returns (bool);

  /**
   * @dev کالر کے اکاؤنٹ سے ٹوکنز کی ایک `value` مقدار `to` میں منتقل کرتا ہے
   * اور پھر `to` پر `ERC1363Receiver::onTransferReceived` کو کال کرتا ہے۔
   * @param to وہ ایڈریس جس پر ٹوکنز منتقل کیے جا رہے ہیں۔
   * @param value منتقل کیے جانے والے ٹوکنز کی مقدار۔
   * @param data بغیر کسی مخصوص فارمیٹ کے اضافی ڈیٹا، جو `to` کی کال میں بھیجا جاتا ہے۔
   * @return ایک بولین (boolean) ویلیو جو یہ ظاہر کرتی ہے کہ آپریشن کامیاب ہو گیا ہے، سوائے ایرر (throwing) کی صورت کے۔
   */
  function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev الاؤنس (allowance) میکانزم کا استعمال کرتے ہوئے `from` سے `to` میں ٹوکنز کی ایک `value` مقدار منتقل کرتا ہے
   * اور پھر `to` پر `ERC1363Receiver::onTransferReceived` کو کال کرتا ہے۔
   * @param from وہ ایڈریس جہاں سے ٹوکنز بھیجنے ہیں۔
   * @param to وہ ایڈریس جس پر ٹوکنز منتقل کیے جا رہے ہیں۔
   * @param value منتقل کیے جانے والے ٹوکنز کی مقدار۔
   * @return ایک بولین (boolean) ویلیو جو یہ ظاہر کرتی ہے کہ آپریشن کامیاب ہو گیا ہے، سوائے ایرر (throwing) کی صورت کے۔
   */
  function transferFromAndCall(address from, address to, uint256 value) external returns (bool);

  /**
   * @dev الاؤنس (allowance) میکانزم کا استعمال کرتے ہوئے `from` سے `to` میں ٹوکنز کی ایک `value` مقدار منتقل کرتا ہے
   * اور پھر `to` پر `ERC1363Receiver::onTransferReceived` کو کال کرتا ہے۔
   * @param from وہ ایڈریس جہاں سے ٹوکنز بھیجنے ہیں۔
   * @param to وہ ایڈریس جس پر ٹوکنز منتقل کیے جا رہے ہیں۔
   * @param value منتقل کیے جانے والے ٹوکنز کی مقدار۔
   * @param data بغیر کسی مخصوص فارمیٹ کے اضافی ڈیٹا، جو `to` کی کال میں بھیجا جاتا ہے۔
   * @return ایک بولین (boolean) ویلیو جو یہ ظاہر کرتی ہے کہ آپریشن کامیاب ہو گیا ہے، سوائے ایرر (throwing) کی صورت کے۔
   */
  function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev کالر کے ٹوکنز پر `spender` کے الاؤنس کے طور پر ٹوکنز کی ایک `value` مقدار سیٹ کرتا ہے
   * اور پھر `spender` پر `ERC1363Spender::onApprovalReceived` کو کال کرتا ہے۔
   * @param spender وہ ایڈریس جو فنڈز خرچ کرے گا۔
   * @param value خرچ کیے جانے والے ٹوکنز کی مقدار۔
   * @return ایک بولین (boolean) ویلیو جو یہ ظاہر کرتی ہے کہ آپریشن کامیاب ہو گیا ہے، سوائے ایرر (throwing) کی صورت کے۔
   */
  function approveAndCall(address spender, uint256 value) external returns (bool);

  /**
   * @dev کالر کے ٹوکنز پر `spender` کے الاؤنس کے طور پر ٹوکنز کی ایک `value` مقدار سیٹ کرتا ہے
   * اور پھر `spender` پر `ERC1363Spender::onApprovalReceived` کو کال کرتا ہے۔
   * @param spender وہ ایڈریس جو فنڈز خرچ کرے گا۔
   * @param value خرچ کیے جانے والے ٹوکنز کی مقدار۔
   * @param data بغیر کسی مخصوص فارمیٹ کے اضافی ڈیٹا، جو `spender` کی کال میں بھیجا جاتا ہے۔
   * @return ایک بولین (boolean) ویلیو جو یہ ظاہر کرتی ہے کہ آپریشن کامیاب ہو گیا ہے، سوائے ایرر (throwing) کی صورت کے۔
   */
  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 کسی بھی ایسے کنٹریکٹ کے لیے انٹرفیس جو ERC-1363 ٹوکن کنٹریکٹس سے `transferAndCall` یا `transferFromAndCall` کو سپورٹ کرنا چاہتا ہے۔
 */
interface ERC1363Receiver {
  /**
   * @dev جب بھی `operator` کے ذریعے `from` سے اس کنٹریکٹ میں `ERC1363::transferAndCall` یا `ERC1363::transferFromAndCall` کے ذریعے ERC-1363 ٹوکنز منتقل کیے جاتے ہیں، تو یہ فنکشن کال ہوتا ہے۔
   *
   * نوٹ: منتقلی کو قبول کرنے کے لیے، اسے لازمی طور پر واپس (return) کرنا چاہیے
   * `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)"))` اگر منتقلی کی اجازت ہو، سوائے ایرر (throwing) کی صورت کے۔
   */
  function onTransferReceived(address operator, address from, uint256 value, bytes calldata data) external returns (bytes4);
}

/**
 * @title ERC1363Spender
 * @dev کسی بھی ایسے کنٹریکٹ کے لیے انٹرفیس جو ERC-1363 ٹوکن کنٹریکٹس سے `approveAndCall` کو سپورٹ کرنا چاہتا ہے۔
 */
interface ERC1363Spender {
  /**
   * @dev جب بھی کوئی ERC-1363 ٹوکنز کا `owner` اس کنٹریکٹ کو `ERC1363::approveAndCall` کے ذریعے اپنے ٹوکنز خرچ کرنے کی منظوری (approve) دیتا ہے، تو یہ فنکشن کال ہوتا ہے۔
   *
   * نوٹ: منظوری کو قبول کرنے کے لیے، اسے لازمی طور پر واپس (return) کرنا چاہیے
   * `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))`
   * (یعنی 0x7b04a2d0، یا اس کا اپنا فنکشن سلیکٹر)۔
   *
   * @param owner وہ ایڈریس جس نے `approveAndCall` فنکشن کو کال کیا اور جو پہلے ٹوکنز کا مالک تھا۔
   * @param value خرچ کیے جانے والے ٹوکنز کی مقدار۔
   * @param data بغیر کسی مخصوص فارمیٹ کے اضافی ڈیٹا۔
   * @return `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))` اگر منظوری کی اجازت ہو، سوائے ایرر (throwing) کی صورت کے。
   */
  function onApprovalReceived(address owner, uint256 value, bytes calldata data) external returns (bytes4);
}