ERC-1363 پے ایبل ٹوکن اسٹینڈرڈ

pragma solidity ^0.8.0;

/* *
 * @title ERC1363
 * @dev ERC-20 ٹوکنز کے لیے ایک ایکسٹینشن انٹرفیس جو ایک ہی ٹرانزیکشن میں `transfer` یا `transferFrom` کے بعد وصول کنندہ (recipient) کنٹریکٹ پر، یا `approve` کے بعد خرچ کرنے والے (spender) کنٹریکٹ پر کوڈ چلانے (executing) کو سپورٹ کرتا ہے۔ */
interface ERC1363 is ERC20, ERC165 {
  /* * NOTE: اس انٹرفیس کے لیے 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 mechanism) کا استعمال کرتے ہوئے `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 mechanism) کا استعمال کرتے ہوئے `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 جب بھی ERC-1363 ٹوکنز اس کنٹریکٹ میں `ERC1363::transferAndCall` یا `ERC1363::transferFromAndCall` کے ذریعے
   * `operator` کی طرف سے `from` سے منتقل کیے جاتے ہیں، تو یہ فنکشن کال ہوتا ہے۔
   *
   * NOTE: ٹرانسفر کو قبول کرنے کے لیے، اسے لازمی طور پر
   * `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) دیتا ہے، تو یہ فنکشن کال ہوتا ہے۔
   *
   * NOTE: منظوری کو قبول کرنے کے لیے، اسے لازمی طور پر
   * `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);
}