Norme de jeton payable ERC-1363

Introduction

Qu'est-ce que l'ERC-1363 ?

L'ERC-1363 est une interface d'extension pour les jetons ERC-20 qui prend en charge l'exécution d'une logique personnalisée sur un contrat destinataire après les transferts, ou sur un contrat dépensier après les approbations, le tout au sein d'une seule transaction.

Différences par rapport à l'ERC-20

Les opérations standard ERC-20 telles que transfer, transferFrom et approve ne permettent pas l'exécution de code sur le contrat destinataire ou dépensier sans une transaction distincte. Cela introduit de la complexité dans le développement de l'interface utilisateur et des frictions lors de l'adoption, car les utilisateurs doivent attendre que la première transaction soit exécutée pour ensuite soumettre la seconde. Ils doivent également payer le GAS deux fois.

L'ERC-1363 permet aux jetons fongibles d'effectuer des actions plus facilement et de fonctionner sans l'utilisation d'un auditeur hors chaîne. Il permet d'effectuer un rappel sur un contrat récepteur ou dépensier, après un transfert ou une approbation, en une seule transaction.

Prérequis

Pour mieux comprendre cette page, nous vous recommandons de lire d'abord ce qui suit :

Corps

L'ERC-1363 introduit une API standard pour que les jetons ERC-20 interagissent avec les contrats intelligents après transfer, transferFrom ou approve.

Cette norme fournit une fonctionnalité de base pour transférer des jetons, ainsi que pour permettre l'approbation de jetons afin qu'ils puissent être dépensés par un tiers sur la chaîne, puis effectuer un rappel sur le contrat récepteur ou dépensier.

Il existe de nombreuses utilisations proposées de contrats intelligents pouvant accepter les rappels ERC-20.

Par exemple :

Ventes participatives : les jetons envoyés déclenchent une allocation de récompense instantanée.
Services : le paiement active l'accès au service en une seule étape.
Factures : les jetons règlent les factures automatiquement.
Abonnements : l'approbation du tarif annuel active l'abonnement dès le paiement du premier mois.

Pour ces raisons, il a été initialement nommé "Jeton payable".

Le comportement de rappel étend encore son utilité, permettant des interactions transparentes comme :

Jalonnement : les jetons transférés déclenchent un verrouillage automatique dans un contrat de jalonnement.
Vote : les jetons reçus enregistrent les votes dans un système de gouvernance.
Échange : les approbations de jetons activent la logique d'échange en une seule étape.

Les jetons ERC-1363 peuvent être utilisés pour des utilitaires spécifiques dans tous les cas qui nécessitent l'exécution d'un rappel après un transfert ou une approbation reçue. L'ERC-1363 est également utile pour éviter la perte ou le verrouillage de jetons dans les contrats intelligents en vérifiant la capacité du destinataire à gérer les jetons.

Contrairement à d'autres propositions d'extension ERC-20, l'ERC-1363 ne remplace pas les méthodes transfer et transferFrom de l'ERC-20 et définit les ID d'interfaces à implémenter tout en maintenant la rétrocompatibilité avec l'ERC-20.

Provenant de l'EIP-1363 (opens in a new tab):

Méthodes

Les contrats intelligents qui implémentent la norme ERC-1363 DOIVENT implémenter toutes les fonctions de l'interface ERC1363, ainsi que les interfaces ERC20 et ERC165.

pragma solidity ^0.8.0;

/**
 * @title ERC1363
 * @dev Une interface d'extension pour les jetons ERC-20 qui prend en charge l'exécution de code sur un contrat destinataire
 * après `transfer` ou `transferFrom`, ou de code sur un contrat dépensier après `approve`, en une seule transaction.
 */
interface ERC1363 is ERC20, ERC165 {
  /*
   * NOTE : l'identifiant ERC-165 pour cette interface est 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 Déplace un montant `value` de jetons du compte de l'appelant vers `to`
   * et puis appelle `ERC1363Receiver::onTransferReceived` sur `to`.
   * @param to L'adresse à laquelle les jetons sont transférés.
   * @param value Le montant de jetons à transférer.
   * @return Une valeur booléenne indiquant que l'opération a réussi, sauf en cas d'erreur.
   */
  function transferAndCall(address to, uint256 value) external returns (bool);

  /**
   * @dev Déplace un montant `value` de jetons du compte de l'appelant vers `to`
   * et puis appelle `ERC1363Receiver::onTransferReceived` sur `to`.
   * @param to L'adresse à laquelle les jetons sont transférés.
   * @param value Le montant de jetons à transférer.
   * @param data Données supplémentaires sans format spécifié, envoyées dans l'appel à `to`.
   * @return Une valeur booléenne indiquant que l'opération a réussi, sauf en cas d'erreur.
   */
  function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev Déplace un montant `value` de jetons de `from` vers `to` en utilisant le mécanisme d'autorisation
   * et puis appelle `ERC1363Receiver::onTransferReceived` sur `to`.
   * @param from L'adresse à partir de laquelle envoyer les jetons.
   * @param to L'adresse à laquelle les jetons sont transférés.
   * @param value Le montant de jetons à transférer.
   * @return Une valeur booléenne indiquant que l'opération a réussi, sauf en cas d'erreur.
   */
  function transferFromAndCall(address from, address to, uint256 value) external returns (bool);

  /**
   * @dev Déplace un montant `value` de jetons de `from` vers `to` en utilisant le mécanisme d'autorisation
   * et puis appelle `ERC1363Receiver::onTransferReceived` sur `to`.
   * @param from L'adresse à partir de laquelle envoyer les jetons.
   * @param to L'adresse à laquelle les jetons sont transférés.
   * @param value Le montant de jetons à transférer.
   * @param data Données supplémentaires sans format spécifié, envoyées dans l'appel à `to`.
   * @return Une valeur booléenne indiquant que l'opération a réussi, sauf en cas d'erreur.
   */
  function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev Définit un montant `value` de jetons comme autorisation de `spender` sur les jetons de l'appelant
   * et puis appelle `ERC1363Spender::onApprovalReceived` sur `spender`.
   * @param spender L'adresse qui dépensera les fonds.
   * @param value Le montant des jetons à dépenser.
   * @return Une valeur booléenne indiquant que l'opération a réussi, sauf en cas d'erreur.
   */
  function approveAndCall(address spender, uint256 value) external returns (bool);

  /**
   * @dev Définit un montant `value` de jetons comme autorisation de `spender` sur les jetons de l'appelant
   * et puis appelle `ERC1363Spender::onApprovalReceived` sur `spender`.
   * @param spender L'adresse qui dépensera les fonds.
   * @param value Le montant des jetons à dépenser.
   * @param data Données supplémentaires sans format spécifié, envoyées lors de l'appel à `spender`.
   * @return Une valeur booléenne indiquant que l'opération a réussi, sauf en cas d'erreur.
   */
  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);
}

Un contrat intelligent qui veut accepter les jetons ERC-1363 via transferAndCall ou transferFromAndCall DOIT implémenter l'interface ERC1363Receiver :

/**
 * @title ERC1363Receiver
 * @dev Interface pour tout contrat qui veut prendre en charge `transferAndCall` ou `transferFromAndCall` à partir de contrats de jeton ERC-1363.
 */
interface ERC1363Receiver {
  /**
   * @dev Chaque fois que des jetons ERC-1363 sont transférés à ce contrat via `ERC1363::transferAndCall` ou `ERC1363::transferFromAndCall`
   * par `operator` depuis `from`, cette fonction est appelée.
   *
   * NOTE : pour accepter le transfert, cette fonction doit retourner
   * `bytes4(keccak256(\"onTransferReceived(address,address,uint256,bytes)\"))`
   * (c.-à-d. 0x88a7ca5c, ou son propre sélecteur de fonction).
   *
   * @param operator L'adresse qui a appelé la fonction `transferAndCall` ou `transferFromAndCall`.
   * @param from L'adresse depuis laquelle les jetons sont transférés.
   * @param value Le montant des jetons transférés.
   * @param data Données supplémentaires sans format spécifié.
   * @return `bytes4(keccak256(\"onTransferReceived(address,address,uint256,bytes)\"))` si le transfert est autorisé, sauf en cas d'erreur.
   */
  function onTransferReceived(address operator, address from, uint256 value, bytes calldata data) external returns (bytes4);
}

Un contrat intelligent qui veut accepter les jetons ERC-1363 via approveAndCall DOIT implémenter l'interface ERC1363Spender :

/**
 * @title ERC1363Spender
 * @dev Interface pour tout contrat qui veut prendre en charge `approveAndCall` à partir de contrats de jeton ERC-1363.
 */
interface ERC1363Spender {
  /**
   * @dev Chaque fois qu'un `owner` de jetons ERC-1363 approuve ce contrat via `ERC1363::approveAndCall`
   * pour dépenser ses jetons, cette fonction est appelée.
   *
   * NOTE : pour accepter l'approbation, cette fonction doit retourner
   * `bytes4(keccak256(\"onApprovalReceived(address,uint256,bytes)\"))`
   * (c.-à-d. 0x7b04a2d0, ou son propre sélecteur de fonction).
   *
   * @param owner L'adresse qui a appelé la fonction `approveAndCall` et qui possédait auparavant les jetons.
   * @param value Le montant des jetons à dépenser.
   * @param data Données supplémentaires sans format spécifié.
   * @return `bytes4(keccak256(\"onApprovalReceived(address,uint256,bytes)\"))` si l'approbation est autorisée, sauf en cas d'erreur.
   */
  function onApprovalReceived(address owner, uint256 value, bytes calldata data) external returns (bytes4);
}