はじめに

初めまして。 CryptoGamesというブロックチェーンゲーム企業でエンジニアをしている cardene（かるでね） です！ スマートコントラクトを書いたり、フロントエンド・バックエンド・インフラと幅広く触れています。

CryptoGamesCryptoGamesは、ブロックチェーン技術を活用したゲーム・Web3事業を展開する企業です。トレーディングカード、NFT、RWA領域を中心に、新しいエンターテインメント体験を創出しています。cryptogames.co.jp

代表的なゲームはクリプトスペルズというブロックチェーンゲームです。

日本最大級ブロックチェーンゲーム(NFTゲーム)「CryptoSpells」日本初のブロックチェーンTCG、CryptoSpells。cryptospells.jp

今回は、ERC20規格と互換性を持ちながら、トークンコントラクトの標準インターフェースと動作を提案しているERC777についてまとめていきます！

以下にまとめられているものを翻訳・要約・補足しながらまとめていきます。

ERC-777: Token StandardEthereum Improvement Proposals

概要

このEIPは、トークンのコントラクトに関する標準的なインターフェースを提案しています。 これにより、既存のERC20規格との互換性を保ちながら、トークンを取り扱う時により多くの機能と柔軟性を提供することができます。

具体的には、この提案では以下のポイントが含まれています。

トークンの代理送信（オペレーター機能）

この提案では、他のユーザーやコントラクトがあなたの代わりにトークンを送信するための機能を定義しています。 これにより、例えばユーザーの追加の許可を必要とせずに友達があなたのトークンを送信できるようになります。

トークンの制御強化（送受信フック）

トークン保有者は、トークンが送信されたり受信されたりする時に、特定のアクションを実行するための「フック」を設定できるようになります。 これにより、トークンを受け取った後、自動的に何かアクションを起こすことが可能です。

ERC-1820の活用

この提案は、ERC1820と呼ばれる仕組みを利用しています。 これにより、トークンがどのコントラクトやアドレスに送信されたかを通知することが容易になります。 また、これによって過去にデプロイされたコントラクトともスムーズに連携できます。

まとめると、このEIPはトークンを取り扱う際に、他の人が代理で送信したり、トークンの送受信に関するカスタムなアクションを設定したりすることができる新しい方法を提案しています。 同時に、過去の規格との互換性も考慮されています。

動機

この新しい標準は、既に使われているERC20トークン規格を改善することを目指しています。 改善による主な利点は以下の通りです。

  1. 送金の統一哲学 提案されている新しい標準は、Ether（イーサ）の送金哲学と同じ考え方を持っています。 つまり、トークンはsend(dest, value, data)という方法で送ることができます。

  2. トークン送金と受信のコントロール コントラクトと通常のアドレスの両方が、tokensToSendフックを登録することで、送るトークンを制御し、必要に応じて送金を拒否することができます（拒否はフック関数内でエラーを返すことで行われます）。

  3. トークン受信のコントロール コントラクトと通常のアドレスの両方が、tokensReceivedフックを登録することで、受け取るトークンを制御し、必要に応じて受信を拒否することができます（拒否はフック関数内でエラーを返すことで行われます）。

  4. 一括送金と通知 tokensReceivedフックを使うことで、トークンをコントラクトに送金し、同時にコントラクトに通知することができます。 これによって、ERC20のような二度の呼び出し（approve/transferFrom）を必要とせずに済みます。

  5. オペレーターの承認と取り消し トークン保有者は、代理でトークンを送金できるオペレーターを「承認」または「取り消し」できます。 これらのオペレーターは、取引所や小切手処理システム、自動課金システムなど、特定のコントラクトを指します。

オペレーター 取引所や小切手処理システム、自動課金システムなどの特定のコントラクトを指しています。

具体的に説明すると、トークン保有者は、自分の代わりにトークンを送信できる特定のコントラクトを「オペレーター」として承認することができます。 これは、取引所で取引を行う場合や、自動的な支払い処理が必要な場合に役立ちます。 例えば、以下のような状況を考えてられます。

  1. 取引所 トークン保有者が取引所でトークンを売買する場合、取引所はそのトークンを保有者の代わりに送信することがあります。 このとき、取引所は「オペレーター」として認められており、保有者の許可なしにトークンを移動できます。

  2. 小切手処理システム あるコントラクトが小切手のような支払いを処理するシステムを運営しているとします。 トークン保有者は、このシステムに対しても同様に「オペレーター」として認可を与えることができ、自動的に支払いが行われる仕組みを作ることができます。

  3. 自動課金システム 月額のサービス料や使用料を自動的に支払うシステムも同様です。 トークン保有者は、特定のコントラクトに対して「オペレーター」としての権限を与えることで、毎月自動的にトークンが送信され、料金が支払われるようになります。

これらの「オペレーター」は、トークン保有者が特定のコントラクトに対して送信の権限を与えることで、自動的なトークンの送受信や支払い処理を行うための仕組みを指しています。

  1. トランザクションデータとオペレーターデータの利用 トークンの取引には、保有者とオペレーター間で情報を伝えるためのdataおよびoperatorDataというデータ領域が含まれています。

トークンの取引には、トークン保有者とオペレーター（特定のコントラクトなど）の間で情報をやり取りするための仕組みがあります。 これは、dataおよびoperatorDataという特別なデータ領域を使って実現されます。

具体的な例を挙げて説明します。

  1. data トークン保有者とオペレーターは、トークンの取引に関する情報をdataという領域に含めることができます。 これにより、トークンの送信や受信に関連する追加の情報を伝えることができます。 例えば、取引の目的や詳細な説明などが含まれます。

  2. operatorData operatorDataは、オペレーターがトークンの取引を行う際に、オペレーター自身からトークン保有者に対して情報を伝えるための領域です。 これにより、オペレーターがなぜトークンを送信する必要があるのか、その理由や詳細な情報を伝えることができます。

まとめると、dataおよびoperatorDataは、トークンの取引に関する補足的な情報を伝えるための領域です。 トークンの送信や受信だけでなく、取引の目的や理由、詳細な情報などを含めることができるため、より透明性と柔軟性を提供する役割を果たしています。

  1. 古いウォレットの互換性 tokensReceivedフック関数を持たない古いウォレットとも互換性を持つよう、プロキシコントラクトを使ってtokensReceivedフックを実装することができます。

古いウォレットには、新しいトークン標準であるtokensReceivedフック関数が実装されていない可能性があります。 しかし、この新しい標準を採用したトークンを古いウォレットでも使用できるようにする方法があります。 それが、プロキシコントラクトを使ってtokensReceivedフックを実装することです。

プロキシコントラクトは、既存のウォレットと処理を実行するコントラクトとの中継処理を行います。 プロキシコントラクトは新しい標準のトークンとやり取りする際に、tokensReceivedフックを備えています。 これにより、古いウォレットが新しい標準のトークンを正しく受け取り、適切に処理できるようになります。

具体的な説明をすると、次のような流れになります：

  1. プロキシコントラクトの作成 新しい標準のトークンを使う際には、まずプロキシコントラクトを作成します。 このプロキシコントラクトは、tokensReceivedフックを実装しているため、新しいトークンとのやり取りを正しく処理できます。

  2. 古いウォレットとのやり取り 古いウォレットは、新しい標準のトークンとの代わりに、プロキシコントラクトとやり取りします。 この際、プロキシコントラクトがtokensReceivedフックを持っているため、トークンの送信や受信が適切に処理されます。

  3. プロキシコントラクトの役割 プロキシコントラクトは、古いウォレットと新しいトークンとの橋渡しを行う役割を果たします。 古いウォレットは、実際にはプロキシコントラクトを操作しているため、新しい標準に適合するような振る舞いが実現されます。

プロキシコントラクトは古いウォレットと新しいトークンとの間でコミュニケーションを円滑にするための仕組みです。 古いウォレットが新しい標準のトークンを適切に取り扱えるようにし、互換性を確保する役割を果たします。

仕様

ERC777Tokenコントラクト

javascript
interface ERC777Token {
    function name() external view returns (string memory);
    function symbol() external view returns (string memory);
    function totalSupply() external view returns (uint256);
    function balanceOf(address holder) external view returns (uint256);
    function granularity() external view returns (uint256);

    function defaultOperators() external view returns (address[] memory);
    function isOperatorFor(
        address operator,
        address holder
    ) external view returns (bool);
    function authorizeOperator(address operator) external;
    function revokeOperator(address operator) external;

    function send(address to, uint256 amount, bytes calldata data) external;
    function operatorSend(
        address from,
        address to,
        uint256 amount,
        bytes calldata data,
        bytes calldata operatorData
    ) external;

    function burn(uint256 amount, bytes calldata data) external;
    function operatorBurn(
        address from,
        uint256 amount,
        bytes calldata data,
        bytes calldata operatorData
    ) external;

    event Sent(
        address indexed operator,
        address indexed from,
        address indexed to,
        uint256 amount,
        bytes data,
        bytes operatorData
    );
    event Minted(
        address indexed operator,
        address indexed to,
        uint256 amount,
        bytes data,
        bytes operatorData
    );
    event Burned(
        address indexed operator,
        address indexed from,
        uint256 amount,
        bytes data,
        bytes operatorData
    );
    event AuthorizedOperator(
        address indexed operator,
        address indexed holder
    );
    event RevokedOperator(address indexed operator, address indexed holder);
}

  1. インターフェースの実装 トークンコントラクトは、上記のERC777Tokenインターフェースを実装する必要があります。 この実装は、以下に記載されている仕様に従う必要があります。

  2. ERC-1820への登録 トークンコントラクトは、自身のアドレスをERC1820を介してERC777Tokenインターフェースに登録しなければなりません。 これは、ERC1820レジストリのsetInterfaceImplementer関数を呼び出すことによって行います。 その際、アドレスとしてトークンコントラクトのアドレスを、implementerとしても同じくトークンコントラクトのアドレスを使用し、インターフェースハッシュとしてERC777Tokenのkeccak256ハッシュ（0xac7fbab5f54a3ca8194167523c6753bfeb96a445279294b6125b68cce2177054）を使用します。

トークンコントラクトは、自身のアドレスをERC777Tokenインターフェースに登録する必要があります。 これは、ERC1820レジストリのsetInterfaceImplementer関数を呼び出すことで実現されます。 具体的な手順を説明します。

  1. トークンコントラクトのアドレスを登録 トークンコントラクトは、自身のアドレスをERC777Tokenインターフェースに登録するために、ERC1820レジストリのsetInterfaceImplementer関数を呼び出します。

  2. アドレスとimplementerの指定 setInterfaceImplementer関数を呼び出す際、以下の情報を指定します。

    • address
      • トークンコントラクトのアドレス。
    • implementer
      • 同じくトークンコントラクトのアドレス。
    • interface hash
      • ERC777Tokenのkeccak256ハッシュ。（0xac7fbab5f54a3ca8194167523c6753bfeb96a445279294b6125b68cce2177054）

これにより、ERC1820レジストリはトークンコントラクトのアドレスに対して、ERC777Tokenインターフェースを実装しているという情報を持つことになります。 これによって、他のコントラクトやアドレスがトークンコントラクトとのやり取りを行う際、ERC1820を通じてインターフェースの情報を確認することができます。

まとめると、トークンコントラクトはERC1820を使用して自身のアドレスをERC777Tokenインターフェースに登録し、他のコントラクトやアドレスがトークンコントラクトとやり取りする際に、正しいインターフェース情報を提供する仕組みを確立します。

  1. ERC777関数の切り替え コントラクトがERC777関数を有効または無効にするスイッチがある場合、そのスイッチがトリガーされるたびに、トークンはERC777Tokenインターフェースをトークンコントラクトのアドレスに対して登録または登録解除する必要があります。 登録解除は、setInterfaceImplementerを呼び出すことで行います。 具体的には、アドレスとしてトークンコントラクトのアドレス、インターフェースハッシュとしてERC777Tokenのkeccak256ハッシュ、implementerとして0x0を使用します。

  2. 取引時の金額と残高 トークンコントラクトとのやり取りでは、すべての金額と残高は符号なし整数（unsigned integers）として扱われます。 内部的には、すべての値がトークンの1E-18の単位で格納されます。 表示単位（エンドユーザーに表示するための単位）は、内部の単位の1018分です。

  3. 内部の単位と表示単位 内部の単位は、weiに似ており、表示単位はetherに似ています。 これは、ERC20のdecimals関数が18を返すのと同等です。 例えば、ユーザーの残高が500,000,000,000,000,000（0.5×1018）である場合、ユーザーインターフェースはユーザーに0.5トークンを表示しなければなりません。 ユーザーが0.3トークンを送信したい場合、コントラクトは300,000,000,000,000,000（0.3×1018）という金額で呼び出される必要があります。

  1. 符号なし整数（unsigned integers）の使用 トークンコントラクトとのやり取りでは、すべての金額や残高は符号なし整数として扱われます。 符号なし整数は負の値を表現せず、非負の整数のみを取り扱うデータ型です。 これにより、取引や計算において正確な数値処理が行えます。

  2. 内部の単位（1E-18）の使用 トークンの内部的な表現では、すべての値がトークンの1E-18の単位で格納されます。 これは、非常に小さな値で、トークンの最小単位を示しています。 この単位により、高い精度で小数点以下の取引や計算が可能になります。

  3. 表示単位の理解 エンドユーザーに対してトークンの残高や金額を表示する際には、内部の単位をエンドユーザーが理解しやすいように変換します。 表示単位は、内部の単位の1018分です。 これにより、エンドユーザーにとって分かりやすい形でトークンの量を表示することができます。

具体例を考えてみましょう。

  • 内部の単位（1E-18）でトークン残高が1000000000000000000（1トークン）の場合、エンドユーザーには表示単位で1トークンとして表示されます。
  • エンドユーザーが0.5トークンを送信したい場合、トークンコントラクトに対しては内部の単位で500000000000000000を指定する必要があります。

まとめると、トークンのやり取りでは正確な数値処理と高い精度が保たれ、エンドユーザーには分かりやすい表示が提供されるために、内部の単位（1E-18）と表示単位（1018分）が使われています。

  1. ABIから生成されるユーザーインターフェース トークンコントラクトのABIから生成されるユーザーインターフェースは、内部の単位を使用して表示される場合があります。 ただし、これが明確に示される必要があります。 例えば、uint256型として表示することで、内部の単位が使用されていることがわかるようにします。

まとめると、トークンコントラクトは特定の仕様に従ってERC777Tokenインターフェースを実装し、ERC1820を通じて自身を登録します。 また、金額や残高は内部の単位と表示単位という2つの単位を使用して取り扱われ、プロキシコントラクトを使って古いウォレットでも正しく動作するような仕組みがあります。

関数

name

識別子: 06fdde03

javascript
function name() external view returns (string memory)

トークンの名前を取得する関数。 例えば、「MyToken」といった名前が返されます。

symbol

識別子: 95d89b41

javascript
function symbol() external view returns (string memory)

トークンのシンボルを取得する関数。 例えば、「MYT」といったシンボルが返されます。

totalSupply

識別子: 18160ddd

javascript
function totalSupply() external view returns (uint256)

発行されたトークンの総数を取得する関数。 balanceOf関数によって返されたすべてのアドレスの残高の合計と等しくなる必要があります。 また、すべてのMintedイベントで定義されたすべての発行済みトークンの合計から、すべてのBurnedイベントで定義されたすべてのバーン済みトークンの合計を引いたものに等しくなる必要があります。

balanceOf

識別子: 70a08231

javascript
function balanceOf(address holder) external view returns (uint256)

特定のアドレスのトークン残高を取得する関数。 0以上の値を返す必要があります。

引数

  • holder
    • トークン残高を取得したいアドレス。

granularity

識別子: 556f0dc7

javascript
function granularity() external view returns (uint256)

トークンの分割できない最小単位を取得する関数。 分割単位は内部の単位で、いつでもトークンを発行したり送信したり焼却したりする際に使用される、最も小さなトークンの単位です。

以下のルールが分割単位に関して適用されます。

  1. 分割単位の値は、トークンの作成時に設定されなます。
  2. 分割単位の値は一度設定されたら変更できません。
  3. 分割単位の値は1以上です。
  4. すべての残高は分割単位の倍数です。
  5. 任意のトークンの発行、送信、焼却操作は分割単位の倍数で実行されます。 分割単位の倍数でない操作は無効であり、トランザクションはリバートされます。

⚠️ 注意 ほとんどのトークンは完全に分割可能であるべきです。 トークンをいかなる分数も許可しない理由がない限り、この関数は通常1を返すべきです。

まとめると、granularity関数はトークンの最小単位を示し、トークンの発行や送信、焼却の際に使用される単位を定義します。 この単位は、トークンの性質を確定させる重要な要素であり、ルールに従って運用される必要があります。 また、ERC20互換性においてもdecimals関数が重要であり、この関数によって小数点以下の桁数が定義されます。

オペレーター

オペレーターは、特定の保有者の代わりにトークンを送信したり焼却したりすることが許可されているアドレスです。

オペレーターの許可とイベント

  • アドレスが特定の保有者のオペレーターになると、AuthorizedOperatorイベントが発行されます。
    • AuthorizedOperatorイベントでは、オペレーター（トピック 1）と保有者（トピック 2）はそれぞれオペレーターと保有者のアドレスになります。
  • 保有者がオペレーターを取り消す場合、RevokedOperatorイベントが発行されます。
    • RevokedOperatorイベントでも、オペレーター（トピック 1）と保有者（トピック 2）はそれぞれオペレーターと保有者のアドレスになります。
  • 注意
    • 保有者は同時に複数のオペレーターを持つことができます。

デフォルトオペレーター

  • トークンはデフォルトオペレーターを定義することができます。
  • デフォルトオペレーターは、すべての保有者の代わりに自動的にトークンを送信または焼却できるオペレーターです。
  • デフォルトオペレーターを定義する際には、AuthorizedOperatorイベントは発行されません。
  • 以下のルールがデフォルトオペレーターに適用されます。
    • トークンコントラクトは作成時にデフォルトオペレーターを定義します。
    • デフォルトオペレーターは不変でなければなりません。
      • つまり、トークンコントラクトはデフォルトオペレーターを追加または削除してはいけません。

一般的なオペレーターのルール

  • アドレスは常に自身のオペレーターである必要があります。
    • したがって、アドレスは自身のオペレーターとして取り消すことはありません。
  • アドレスが特定の保有者のオペレーターである場合、isOperatorFor関数はtrueを返します。
  • アドレスが特定の保有者のオペレーターでない場合、、isOperatorFor関数はfalseを返します。

イベントの発生

  • 保有者がアドレスをオペレーターとして許可すると、AuthorizedOperatorイベントが発行されます。
  • 保有者がアドレスをオペレーターから取り消すと、RevokedOperatorイベントが発行されます。

⚠️ 注意

  • 保有者は既に許可されたオペレーターを再度許可できます。
    • これは毎回AuthorizedOperatorイベントが発行されます。
  • 保有者は既に取り消されたオペレーターを再度取り消すことができます。
    • これは毎回RevokedOperatorイベントが発行されます。

AuthorizedOperator

javascript
event AuthorizedOperator(address indexed operator, address indexed holder)

オペレータに設定された時に発行されるイベント。

パラメータ

  • operator
    • オペレーターアドレス。
  • holder
    • トークン保有者のアドレス。
    • オペレーターを許可したアドレス。

RevokedOperator

javascript
event RevokedOperator(address indexed operator, address indexed holder)

オペレータが取り消された時に発行されるイベント。

パラメータ

  • operator
    • オペレーターアドレス。
  • holder
    • トークン保有者のアドレス。
    • オペレーターの許可を取り消したアドレス。

オペレータを管理するために、後述のdefaultOperators、authorizeOperator、revokeOperator、 isOperatorFor関数を実装する必要があります。 トークンコントラクトは、オペレータを管理するために他の関数を実装できます。

defaultOperators

識別子: 06e48538

javascript
function defaultOperators() external view returns (address[] memory)

デフォルトのオペレーターの配列を取得する関数。 デフォルトのオペレーターが存在しない時、空の配列を返します。

authorizeOperator

識別子: 959b8c3f

javascript
function authorizeOperator(address operator) external

msg.senderのアドレスのオペレータを設定する関数。 トークン保有者（msg.sender）は常に自身のオペレーターであり、この権利は取り消すことはありません。 したがって、この関数が保有者（msg.sender）を自身のオペレーターとして設定しようとした場合（つまり、オペレーターがmsg.senderと等しい場合）、この関数はリバート（取引を元に戻す）します。

引数

  • operator
    • オペレーターに設定するアドレス。

revokeOperator

識別子: fad8b32a

javascript
function revokeOperator(address operator) external

msg.senderのアドレスのオペレータ権限を取り除く関数。 トークン保有者（msg.sender）は常に自身のオペレーターであり、この権利は取り消すことはありません。 したがって、この関数が保有者（msg.sender）を自身のオペレーターから取り除こうとした場合（つまり、オペレーターがmsg.senderと等しい場合）、この関数はリバート（取引を元に戻す）します。

引数

  • operator
    • オペレーターから取り消すアドレス。

isOperatorFor

識別子: d95b6371

javascript
function isOperatorFor(
    address operator,
    address holder
) external view returns (bool)

特定のアドレスがトークン保有者アドレスのオペレータか確認する関数。

引数

  • operator
    • オペレーターか確認したいアドレス。
  • holder
    • トークンの保有者アドレス。

戻り値 トークン保有者アドレスのオペレーターかどうかのbool値。

⚠️ 注意 どのアドレスが指定された所持者のオペレータであるかを知るには、各デフォルトオペレータの所持者アドレスを仕様してisOperatorForを呼び出し、その所持者のAuthorizedOperator、RevokedOperatorイベントを解析しなければならない。

トークンの送付

オペレーターが保有者から受取アドレスへトークンを特定の量と関連データ、オペレーターデータと共に送信する場合、トークンコントラクトは以下のルールを適用します。

  1. 任意の許可されたオペレーターは、トークンを受取アドレスに送れます（ただし0x0には送れません）。
  2. トークンの保有者の残高は送信するトークンの量だけ減少します。
  3. 受取アドレスの残高は送信されるトークンの量だけ増加します。
  4. トークンの保有者の残高は、送信後も0以上の値になるように調整されます。 送信前のトークン保有者の残高は送信予定のトークン量よりも多いか確認します。
  5. トークンコントラクトは、Sentイベントを発行します。
  6. オペレーターは、オペレーターデータに情報を含めることができます。
  7. トークンの保有者がERC1820を介してERC777TokensSenderの実装を登録している場合、トークンコントラクトは保有者のtokensToSendフックを呼び出す必要があります。

tokensToSend

このフックは、保有者がトークンを送信する際にトークンコントラクトによって呼び出される「カスタムコードの断片」です。 保有者はこのフックを使用して、トークンの送信前に追加のロジックや処理を行うことができます。 例えば、トークンの送信に特別な条件を設定したり、追加のデータをトランザクションに含めたりすることができます。

保有者がtokensToSendフックを登録している場合、トークンコントラクトはトークンの送信操作を実行する前に、保有者のこのフックを呼び出します。 保有者はその中で必要な処理やチェックを行い、トークンの送信を続行するかどうかを決定できます。 トークンコントラクトはこのフックの結果に基づいて、トークンの送信操作の実行を決定します。

この仕組みにより、保有者はトークンの送信に関する追加のロジックをカスタマイズできるため、より柔軟なトークン取引が可能となります。

  1. 受取アドレスがERC1820を介してERC777TokensRecipientの実装を登録している場合、トークンコントラクトは受取アドレスのtokensReceivedフックを呼び出す必要があります。
  2. 送信の時に使用されるデータとオペレーターデータは、送信プロセス全体で変更されないことが必要です。 そのため、同じデータとオペレーターデータが両方のフックの呼び出しおよびSentイベントの発行に使用されます。

送信プロセスにおいて、トークンの送信が行われる際には、特定のデータとオペレーターデータが関与します。 これらのデータは、トークンの送信の際にトークンコントラクトや関連するコードによって使用されます。 重要なのは、このデータが送信プロセス全体で変更されず、一貫性を保つことです。

例えば、保有者がトークンを送信する場合を考えてみましょう。 保有者は特定の受取アドレスにトークンを送信し、その際に関連するデータやオペレーターデータを指定します。 このデータは、トークンの送信において必要な情報や処理内容を表しています。

ここで大切なのは、このデータが送信プロセスの中で変更されないことです。 なぜなら、保有者が用意したデータが送信プロセスの途中で変わってしまうと、予期せぬ結果が生じる可能性があるからです。 例えば、トークンの送信操作の途中でデータが変更されると、送信の内容が一致しないために取引が予期せぬ動作を起こす可能性があります。

したがって、データとオペレーターデータは送信プロセス全体で変更されないようにする必要があります。 これを実現するために、同じデータとオペレーターデータが保有者のtokensToSendフックの呼び出し、受取人のtokensReceivedフックの呼び出し、そしてSentイベントの発行に使用されます。 これによって、送信プロセス全体で一貫性が保たれ、信頼性のあるトークン取引が確保されるのです。

これにより、オペレーターによるトークンの送信プロセスが明確に定義され、信頼性のあるトークン取引が確保されます。

トークンコントラクトは、以下のいずれかの場合にトークンの送信処理を失敗させます。

  • オペレーターアドレスが保有者の許可されたオペレーターでない。
  • トークン保有者の残高または受け取りアドレスの残高が、トークンコントラクトで定義されたトークンの最小単位の倍数ではない。
  • 受け取りアドレスがコントラクトであり、ERC1820を介してERC777TokensRecipientインターフェースを実装していない。
  • トークン保有者または受け取りアドレスのアドレスが0x0の場合。
  • いずれかの残高が負の値（0未満）になる。
  • 保有者のtokensToSendフックが失敗した場合。
  • 受け取りアドレスのtokensReceivedフックが失敗した場合。

トークンコントラクトは、多くの保有者から多くの受け取りアドレスにトークンを送信したり、その逆を行う場合があります。 この時に以下の条件を満たす必要があります。

  • 前述の送信ルールは、すべての保有者と受け取りアドレスに適用されます。
  • 増加した残高の合計は、送信されたトークン量と等しくなければなりません。
  • 減少した残高の合計は、送信されたトークン量と等しくなければなりません。
  • 各保有者と受け取りアドレスのペアごとに、対応する金額でSentイベントが発行されます。
  • Sentイベントからの金額の合計は、送信されたトークン量と等しくなければなりません。

⚠️ 注意

  • 送金に手数料を適用するような仕組みは、実質的に複数の受取りアドレスへの送信と見なされます。
    • つまり、トークンの送信先と手数料の受取りアドレスが含まれる場合、これは複数のアドレスへの送信とみなされます。
  • トークンの移動は、一連のアクションとして連鎖させることができます。
    • 例えば、あるコントラクトがトークンを受け取ると、それを別のアドレスにさらに送信する場合です。
    • この場合、前述の送信ルールは各送信ごとに適用されます。
    • つまり、各送信ごとに残高の増減やイベントの発行が行われ、それぞれの送信がルールに従って処理されます。
  • トークンの量をゼロ（0）として送信することは許可されており、通常の送信と同様に扱われます。
    • この場合、トークンは実際には送信されませんが、トランザクションが正常に処理されるために必要な操作として認識されます。

トークンの実装要件について、以下のポイントを分かりやすく説明します。

  1. tokensToSendフックとtokensReceivedフックの呼び出し順序 トークンを送信する際、トークンコントラクトはまずtokensToSendフックを呼び出します。 このフックは、トランザクションが送信される前に実行されます。 その後、トークンの送信に応じて保有者の残高が減少し、受け取りアドレスの残高が増加します。 そして、tokensReceivedフックが呼び出されます。 このフックはトランザクションが完了した後に実行されます。

  2. データフィールドとoperatorDataフィールド トークンの送信時には、データフィールドに保有者から提供される情報が含まれます。 これは、通常のETH送金トランザクションのデータフィールドと同様です。 tokensToSend()フックとtokensReceived()フックのどちらか、または両方は、この情報を使用してトランザクションを受け入れるか拒否するかを判断するために使用できます。 また、operatorDataフィールドも似たような役割を果たしますが、これはオペレーターによって提供されるものです。 オペレーターはこのフィールドを使用して特定の情報を伝えることができます。 ただし、受け取りアドレスは通常、operatorDataを無視するか、実行してもログに記録するだけです。

これにより、トークンの送信プロセスが順番に実行されることや、データの提供と処理、そしてオペレーターが情報を伝える仕組みが明確に定義され、信頼性のあるトークンの取引が実現されます。

Sentイベント

javascript
event Sent(
    address indexed operator,
    address indexed from,
    address indexed to,
    uint256 amount,
    bytes data,
    bytes operatorData
)

オペレーターアドレスによって、送信元アドレスから送信先アドレスへトークンの量を送信するイベント。

パラメーター

  • operator
    • オペレーターアドレス。
  • from
    • トークンの保有者アドレス。
  • to
    • トークンの受け取りアドレス。
  • amount
    • 送信されたトークンの数量。
  • data
    • 保有者から提供された情報。
  • operatorData
    • オペレーターによって提供された情報。

以下に説明するsend関数とoperatorSend関数は、トークンの送信を実行するために実装する必要があります。 トークンコントラクトは、他のトークンの送信を行うための関数を実装することもできます。

send

識別子: 9bd9bbc6

javascript
function send(address to, uint256 amount, bytes calldata data) external

トークンの量をmsg.senderのアドレスからアドレスtoへ送る関数。

オペレーターと保有者は、両方ともmsg.senderと同じアドレスである必要があります。

パラメーター

  • to
    • トークンの受け取りアドレス。
  • amount
    • 送信するトークンの数量。
  • data
    • 保有者から提供された情報。

operatorSend

識別子: 62ad1b83

javascript
function operatorSend(
    address from,
    address to,
    uint256 amount,
    bytes calldata data,
    bytes calldata operatorData
) external

アドレスfromからアドレスtoへ、指定されたトークン量を代理で送信する関数。

⚠️ 注意 オペレーターアドレスがアドレスfromの許可されたオペレーターでない場合、送信プロセスは取り消されます。

fromとmsg.senderは同じアドレスである場合があります。 つまり、アドレスは自身のためにoperatorSendを呼び出すことができます。 この呼び出しは、トークンの送信に加えて、オペレーターがoperatorDataの明示的な値を指定することができる点を除いて、送信と同等である必要があります（送信関数ではこれは実行できません）。

パラメーター:

  • from
    • トークン保有者のアドレス。
  • to
    • トークンの受け取りアドレス。
  • amount
    • 送信するトークンの数量。
  • data
    • 保有者から提供された情報。
  • operatorData
    • オペレーターから提供された情報。

トークンのミント

トークンの発行（Minting）とは、新しいトークンを生成するプロセスのことです。 ERC777では、トークンの発行を行うための特定の関数を定義していません。 これは、各トークンごとに発行プロセスが異なるため、標準を柔軟に利用できるようにするためです。

ただし、受取り先にトークンを発行する際には次のルールを守る必要があります。

  • 任意の受取り先アドレス（ただし0x0ではない）に対してトークンを発行できます。
  • 総供給量は発行されるトークンの数量だけ増加します。
  • アドレス0x0の残高は減少させてはいけません。
  • 受け取りアドレスの残高は発行されるトークンの数量だけ増加しなければなりません。
  • トークンコントラクトは、正しい値でMintedイベントを発行する必要があります（Mintedイベントの定義に従う）。
  • 受け取りアドレスがERC1820を介してERC777TokensRecipientの実装を登録している場合、トークンコントラクトは受取り先のtokensReceivedフックを呼び出す必要があります。
  • データとオペレーターデータは、トークンの発行プロセス全体で変更されない必要があります。
    • そのため、tokensReceivedフックを呼び出す際とMintedイベントを発行する際には同じデータとオペレーターデータを使用します。

トークンの発行時に、次のいずれかの場合にトークンコントラクトはトランザクションを中止します。

  • 発行後の受取り先の残高が、トークンコントラクトで定義された最小単位の倍数でない場合。
  • 受け取りアドレスがコントラクトであり、ERC1820を介してERC777TokensRecipientインターフェースを実装していない場合。
  • 受取り先のアドレスが0x0の場合。
  • 受取り先のtokensReceivedフックが失敗する場合。

トークンコントラクトの作成時における初期トークン供給量は、初期供給を受けるアドレス（複数の場合もあります）に対してトークンが発行されます。 したがって、少なくとも1つ以上のMintedイベントが発行され、受取り側のtokensReceivedフックが呼び出される必要があります。

ERC20互換性の要件は以下です。

  1. トークンの発行時にSentイベントを発行してはいけません。 ただし、トークンコントラクトがERC20と互換性を持つ場合、Transferイベントを発行します。 このTransferイベントのfromパラメータは0x0に設定されます。 この動作はERC20標準で定義されています。

  2. トークンコントラクトは一度に複数の受け取りアドレスに対してトークンを発行することができます。 この場合、次のルールが適用されます。

    • 前述の発行ルールはすべての受け取りアドレスに適用されます。
    • すべての残高の増加の合計は、合計発行量と一致しなければなりません。
    • 各受け取りアドレスごとに対応する数量のMintedイベントが発行されます。
    • Mintedイベントからのすべての数量の合計は、合計発行量と一致しなければなりません。

  3. トークンの発行量がゼロ（0）の場合でも通常の発行と同じように扱われます。

  4. 送信や焼却の際にはデータが保有者から提供されますが、トークンの発行の場合には適用されません。 この場合、データはトークンコントラクトまたはオペレーターによって提供されることがあります。 これにより、特定のデータを期待する保有者に正常な発行を保証できます。

  5. operatorDataフィールドには、オペレーターから提供される情報が含まれます。 通常のETH送信トランザクションのデータフィールドと類似しています。 tokensReceived()フックはこの情報を使用してトランザクションを拒否するかどうかを決定できます。

Mintedイベント

javascript
event Minted(
    address indexed operator,
    address indexed to,
    uint256 amount,
    bytes data,
    bytes operatorData
)

トークンの発行が行われ、一定量のトークンが受け取りアドレスによってオペレーターアドレスによって発行された時に発行されるイベント。

パラメーター

  • operator
    • 発行を実行したアドレス。
  • to
    • トークンを受け取るアドレス。
  • amount
    • 発行されたトークンの数量。
  • data
    • 受け取りアドレスに関する提供された情報。
  • operatorData
    • オペレーターによって提供された情報。

トークンのバーン

トークンのバーンとは、既存のトークンを廃棄する行為です。 ERC777では、トークンをバーンするために明示的に2つの関数（burnおよびoperatorBurn）が定義されています。 これらの関数は、ウォレットやDAppでバーンプロセスを統合するためのものです。 ただし、トークンコントラクトは何らかの理由で一部またはすべての保有者がトークンをバーンするのを防ぐことがあります。 トークンコントラクトは他のトークンをバーンするための関数を定義することもできます。

以下のルールは、保有者のトークンをバーンする際に守るべきルールです。

  • 任意の保有者アドレス（0x0を除く）からトークンをバーンできます。
  • 総供給量はバーンされたトークンの数量だけ減少します。
  • 0x0の残高は増加しません。
  • 保有者の残高はバーンされたトークンの数量だけ減少します。
  • トークンコントラクトは、正しい値でBurnedイベントを発行します（Burnedイベントの定義に従う）。
  • 保有者がERC1820を介してERC777TokensSenderの実装を登録している場合、トークンコントラクトは保有者のtokensToSendフックを呼び出す必要があります。
  • operatorDataはバーンプロセス全体で不変である必要があります。
    • したがって、同じoperatorDataはtokensToSendフックを呼び出すためとBurnedイベントを発行するために使用されます。

トークンをバーンする際に、以下の場合にトークンコントラクトはトランザクションを取り消す必要があります。

  • オペレーターアドレスが保有者に対して許可されたオペレーターでない場合。
  • バーン後の保有者の残高が、トークンコントラクトで定義された最小単位の倍数ではない場合。
  • 保有者の残高がバーンするトークンの数量よりも少ない場合（つまり、保有者の残高が負の値になる場合）。
  • 保有者のアドレスが0x0の場合。
  • 保有者のtokensToSendフックがトランザクションを取り消す場合。

ERC20互換性要件 バーン時にSentイベントを発行してはいけませんが、トークンコントラクトがERC20対応している場合、toパラメータを0x0に設定したTransferイベントを発行します。 ERC20標準はトークンのバーンの概念を定義していませんが、これは一般的に受け入れられているプラクティスです。

トークンコントラクトは複数の保有者のトークンを一度にバーンすることができます。 この場合以下のルールが適用されます。

  • 前述のバーンルールは各保有者に適用されます。
  • すべての残高の減少の合計は、合計バーン量と等しくなければなりません。
  • 各保有者ごとに対応する数量のBurnedイベントが発行されます。
  • Burnedイベントからのすべての数量の合計は、合計バーン量と等しいです。
  • トークンのバーン量がゼロ（0）の場合、通常のバーン処理と同じように扱われます。
  • データフィールドには、保有者から提供される情報が含まれており、通常のETH送信トランザクションのデータフィールドと類似しています。
  • tokensToSend()フック、tokensReceived()フック、または両方がこの情報を使用してトランザクションを拒否するかどうかを決定するために使用できます。
  • operatorDataフィールドは、データフィールドに類似していますが、オペレーターによって提供されます。

Burnedイベント

javascript
event Burned(
    ddress indexed operator,
    address indexed from,
    uint256 amount,
    bytes data,
    bytes operatorData
);

バーンのプロセスにおいて、オペレーターアドレスによって指定された量のトークンが発行元アドレスからバーンされた時に発行されるイベント。

パラメーター

  • operator
    • バーンを実行したアドレス。
  • from
    • バーンされたトークンの保有者アドレス。
  • amount
    • バーンされたトークンの数量。
  • data
    • 保有者から提供された情報。
  • operatorData
    • オペレーターから提供された情報。

burn

識別子: fe9d9303

javascript
function burn(uint256 amount, bytes calldata data) external

msg.senderから指定された量のトークンをバーンする関数。

引数

  • amount
    • バーンするトークンの数量。
  • data
    • 保有者から提供された情報。

operatorBurn

識別子: fc673c4f

javascript
function operatorBurn(
    address from,
    uint256 amount,
    bytes calldata data,
    bytes calldata operatorData
) external

オペレーターがfromアドレスのトークンを指定された量だけバーンする関数。

注意 オペレーターアドレスがアドレス「from」の許可されたオペレーターでない場合、バーンプロセスは取り消されます。 オペレーターはoperatorDataを介して任意の情報を渡すことができます。 ただし、operatorDataはオペレーターによってのみ提供される必要があります。 fromとmsg.senderが同じアドレスである場合があります。 つまり、アドレスは自分自身のためにoperatorBurnを呼び出すことができます。 この呼び出しは、バーンに追加してオペレーターがoperatorDataの明示的な値を指定できる点で、バーン関数と同等である必要があります。

パラメーター

  • from
    • バーンするトークンの保有者アドレス。
  • amount
    • バーンするトークンの数量。
  • data
    • 保有者から提供された情報。
  • operatorData
    • オペレーターから提供される情報。

ERC777TokensSender・tokensToSendフック

ERC777TokensSenderは、特定の保有者の残高を減少させるリクエスト（送信およびバーン）を通知するためのものです。 自分のアドレスからのトークンの減少に関する通知を受け取りたい任意のアドレス（通常のアドレスまたはコントラクト）は、以下に説明するERC777TokensSenderインターフェースを実装したコントラクトのアドレスをERC1820を介して登録することができます。

これは、ERC1820レジストリ上でsetInterfaceImplementer関数を呼び出すことによって行われます。 このとき、保有者のアドレスをアドレスとし、ERC1820ERC777TokensSenderERC1820のkeccak256ハッシュ（0x29ddb589b1fb5fc7cf394961c1adf5f8c6454761adf795e67fe149f658abe895）をインターフェースハッシュとし、ERC777TokensSenderを実装したコントラクトのアドレスをimplementerとして指定します。

注意 通常のアドレスは、そのアドレス自体ではなく、その代わりにコントラクトのアドレスを登録することができます。 ただし、その代わりのコントラクトのアドレスは、必ずそのコントラクト自体で以下のインターフェースを実装している必要があります。

javascript
interface ERC777TokensSender {
    function tokensToSend(
        address operator,
        address from,
        address to,
        uint256 amount,
        bytes calldata userData,
        bytes calldata operatorData
    ) external;
}

tokensToSend

識別子: 75ab9782

javascript
function tokensToSend(
    address operator,
    address from,
    address to,
    uint256 amount,
    bytes calldata userData,
    bytes calldata operatorData
) external

指定されたオペレーターアドレスによって、送信またはバーン（toが0x0の場合）プロセスによって、fromアドレスからtoアドレスにトークンの数量を送信またはバーンするリクエストを送る関数

パラメーター

  • operator
    • トークンの送信、バーン処理を実行したオペレーターアドレス。
  • from
    • トークンが送信された保有者のアドレス。
  • to
    • 送信の場合はトークンの受信者のアドレス（バーンの場合は0x0）。
  • amount
    • 保有者の残高が減少するトークンの数量。
  • data
    • 保有者によって提供された情報。
  • operatorData
    • オペレーターによって提供された情報。

以下のルールがtokensToSendフックを呼び出すときに適用されます。

  • tokensToSendフックは、送信およびバーンプロセスに対して必ず呼び出されます。
  • tokensToSendフックは、状態が更新される前に呼び出されます。
    • つまり、残高が減少する前に呼び出されます。
  • operatorは、送信またはバーンプロセスをトリガーしたアドレスです。
  • fromは、送信またはバーンされるトークンの保有者アドレスです。
  • toは、送信の場合はトークンの受け取りアドレスである必要があります。
    • バーンの場合は0x0である必要があります。
  • amountは、保有者が送信またはバーンしたトークンの数量です。
  • dataは、送信またはバーンプロセスに提供された追加情報（ある場合）です。
  • operatorDataは、残高の減少をトリガーしたアドレスによって提供された追加情報です。

保有者は、送信またはバーンプロセスをリバートすることでブロックすることができます（つまり、自身のアカウントからのトークンの引き出しを拒否することができます）。

注意 トークン保有者は、同じERC777TokensSenderの実装を使用することができます。 1つのアドレスは、任意の時点で最大で1つの実装を登録できます。 したがって、ERC777TokensSenderは異なるトークンコントラクトから呼び出される可能性があるため、その点を考慮して実装する必要があります。 tokensToSend呼び出しのmsg.senderは、トークンコントラクトのアドレスであることが期待されます。

ERC20互換性の要件 このフックはERC20より優先され、ERC20のtransferおよびtransferFromイベントを実行する前に呼び出す必要があります。 transferから呼び出される場合、operatorはfromと同じアドレスである必要があります。 transferFromから呼び出される場合、operatorはtransferFromを呼び出したアドレスである必要があります。

ERC777TokensRecipient・tokensReceivedフック

ERC777TokensRecipientは、特定の受け取りアドレスの残高の増加（送信およびマイント）を通知するためのものです。 自分のアドレスへのトークンのクレジットの通知を受け取りたい任意のアドレス（通常のアドレスまたはコントラクト）は、以下に説明するERC777TokensRecipientインターフェースを実装したコントラクトのアドレスをERC1820を介して登録することができます。

これは、ERC1820レジストリ上でsetInterfaceImplementer関数を呼び出すことによって行われます。 このとき、受け取りアドレスをアドレスとし、ERC777TokensRecipientのkeccak256ハッシュ（0xb281fc8c12954d22544db45de3159a39272895b169a852b314f9cc762e44c53b）をインターフェースハッシュとし、ERC777TokensRecipientを実装したコントラクトのアドレスをimplementerとして登録します。

javascript
interface ERC777TokensRecipient {
    function tokensReceived(
        address operator,
        address from,
        address to,
        uint256 amount,
        bytes calldata data,
        bytes calldata operatorData
    ) external;
}

受け取りアドレスがERC777TokensRecipientの実装を登録していないコントラクトの場合、トークンコントラクトは次の動作をします。

  • もしtokensReceivedフックがmintまたは送信呼び出しから呼ばれた場合、トークンコントラクトはリバートする必要があります。
  • もしtokensReceivedフックがERC20の転送やtransferFrom呼び出しから呼ばれた場合、トークンコントラクトはトランザクションの処理を継続します。

注意 通常のアドレスは、自身の代わりにインターフェースを実装しているコントラクトのアドレスを登録することができます。 ただし、コントラクトは自身のアドレスまたは他のコントラクトのアドレスを登録する必要があります。 ただし、登録されたアドレスは自身の代わりにインターフェースを実装している必要があります。

tokensReceived

識別子: 0023de29

javascript
function tokensReceived(
    address operator,
    address from,
    address to,
    uint256 amount,
    bytes calldata data,
    bytes calldata operatorData
) external

指定されたfromアドレスからtoアドレスに、オペレーターアドレスによって指定されたトークン量を送信またはmint（fromが0x0の場合）するリクエストを実行する関数。 この機能は、mint、送信、またはERC20の転送プロセスの外部から呼び出すことはできません。

パラメータ

  • operator
    • トークンの残高増加を実行したオペレーターアドレス（送信またはマイントを介して）。
  • from
    • トークン保有者のアドレス（mintの場合は0x0）。
  • to
    • トークンを受け取る受け取りアドレス。
  • amount
    • 受け取りアドレスの残高が増加するトークンの数量。
  • data
    • 保有者によって提供された情報。
  • operatorData
    • オペレーターによって提供された情報。

以下のルールがtokensReceivedフックを呼び出す時に適用されます。

  • tokensReceivedフックは、すべての送信およびmintプロセスに対して呼び出される必要があります。
  • tokensReceivedフックは、状態が更新された後に呼び出されます。
    • つまり、残高が増加した後に呼び出されます。
  • operatorは、送信またはmintプロセスをトリガーしたアドレスです。
  • fromは、送信の場合はトークンが送信される保有者のアドレスです。
  • fromは、mintの場合は0x0です。
  • toは、トークンを受け取る受け取りアドレスです。
  • amountは、受け取りアドレスが送信またはmintしたトークンの数量です。
  • dataは、送信またはmintプロセスに提供された追加情報です。
  • operatorDataは、残高の増加をトリガーしたアドレスによって提供された追加情報です。
  • トークン保有者は、送信またはmintプロセスをリバートすることでブロックすることができます（トークンの受け取りを拒否することができます）。

注意 複数のトークン保有者は、同じERC777TokensRecipientの実装を使用できます。 1つのアドレスは、任意の時点で最大で1つの実装を登録できます。 したがって、ERC777TokensRecipientは異なるトークンコントラクトから呼び出される可能性があるため、その点を考慮して実装する必要があります。 tokensReceivedを呼び出したmsg.senderは、トークンコントラクトのアドレスであることが期待されます。

ERC20互換性の要件 このフックはERC20より優先され、ERC20のtransferおよびtransferFromイベントを実行する前に呼び出す必要があります。 transferから呼び出される場合、operatorはfromと同じアドレスである必要があります。 transferFromから呼び出される場合、operatorはtransferFromを呼び出したアドレスである必要があります。

補足

ERC777という規格には、いくつかの重要な理念と概念が含まれています。

不足点の解決と後方互換性の維持

ERC777は、従来のトークン規格であるERC20の一部の不足点を解決し、同時にERC20との後方互換性を保とうとするものです。 ERC20の中には、トークンの送信に関する問題があったり、正確な情報の不足があったりすることがあります。 ERC777はこれらの課題を改善し、新しい機能を導入しつつ、既存のアプリケーションやスマートコントラクトとの連携を図ります。

ライフサイクルの明確化

ERC777は、トークンのライフサイクルを明確に定義しています。 これは、トークンの生成（mint）、送信、破棄（burn）など、トークンがどのように扱われるかを詳細に規定しています。 これにより、トークンの価値や流通に関する情報の整合性が保たれます。

データとoperatorDataの使用

トークンのmint、送信、バーンのプロセスでは、データとoperatorDataフィールドを使用できます。 これらのフィールドは、トークンの移動に関する情報を含むため、より多くのコンテキストを提供します。 例えば、送信者や受け取りアドレスが特定の情報をトークンの移動と共に送信することができます。

フックの導入

ERC777では、トークンの送信プロセスを効率的かつ柔軟にするためにフックが導入されています。 フックは、トークンの移動プロセスに関連するアクションをカスタマイズするために使用されます。 例えば、トークンを受け取る際に特定の処理を行ったり、トークンの送信時に特定の条件をチェックしたりできます。

保有者のコントロールの強化

ERC777は、保有者がトークンの移動を制御するための仕組みを提供します。 保有者は、トークンを特定のアドレスに送信することを許可したり拒否したりすることができます。 これにより、保有者はより細かいレベルでトークンの取引を制御できます。

ERC1820レジストリの活用

ERC1820レジストリを使用することで、保有者はフックを登録できます。 このレジストリは、トークンの移動に関連する処理をカスタマイズするためのコントラクトと保有者を関連付けるために使用されます。 これにより、柔軟性が高まり、異なるトークンとの統合が容易になります。

オペレーターの概念

ERC777では、トークンの送信を行うためのオペレーターという概念が導入されています。 保有者は、自身のトークンを他のアドレスに移動させるためのオペレーターを指定できます。 また、保有者はオペレーターを任意に取り消すこともできます。

後方互換性

このEIPによるERC777規格は、従来のERC20トークン規格との後方互換性を保ちつつ、新たな機能と柔軟性を導入しています。

送信と操作の名称

ERC777では、トークンの送信にはsendとoperatorSendが使われます。 これは、従来のERC20ではtransferとtransferFromが使われていました。 これにより、どのトークン規格が使用されているかの混乱を避けることができます。

ERC20関数の実装

ERC777では、トークンが完全にERC20と互換性があるように、transfer、transferFrom、approve、allowanceなどのERC20関数の実装を許可しています。 これにより、既存のERC20関数を使用しながら、新しい機能を追加できます。

小数点の実装

ERC777では、トークンの小数点以下の桁数を示すdecimals()関数を実装できます。 これは、ERC20との後方互換性を維持するためのオプションです。 実装される場合、常に18を返す必要があります。

同時実装

トークンコントラクトは、ERC20とERC777を同時に実装できます。 name、symbol、balanceOf、totalSupplyなどのビュー関数や内部データの実装は、両方の規格で共有できます。 ただし、ERC777には必須の関数（name、symbol、balanceOf、totalSupply）がありますが、decimalsはERC777の規格には含まれていません。

フックの優先順位

新たにERC20関数を実装する場合でも、tokensToSendとtokensReceivedフックはERC20関数よりも優先されます。 したがって、ERC20のtransferやtransferFromを呼び出している場合でも、トークンコントラクトはERC1820を通じてfromアドレスとtoアドレスがそれぞれtokensToSendとtokensReceivedフックを実装しているかどうかを確認します。 いずれかのフックが実装されている場合、必ずそれを呼び出します。 なお、コントラクトにtokensReceivedフックが実装されていない場合でも、transfer呼び出しは受け入れられるべきですが、この場合、トークンがロックされる可能性が高くなります。

イベントの発行

ERC777規格では、トークンの送信、mint、バーンの際にはSent、Minted、Burnedイベントが必ず発行されます。 また、トークンコントラクトがERC20TokenインターフェースをERC1820を介して実装している場合、mintとバーンの際にはTransferイベントを発行します。 送信の際には（ERC20の標準で定義されている通り）必ずTransferイベントを発行します。 したがって、トークンの移動に関しては、ERC20のTransferイベントとERC777のSent、Minted、Burnedイベントが共に発行されることがあります。 ただし、開発者はこれらのイベントを別々の移動として考えず、それぞれの規格に基づいて適切に扱う必要があります。

テストと参考実装

以下のGithubリポジトリに格納されています。

GitHub - 0xjac/ERC777: New Standard for Ethereum TokenNew Standard for Ethereum Token. Contribute to 0xjac/ERC777 development by creating an account on GitHub.GitHub

引用

Jacques Dafflon mail@0xjac.com, Jordi Baylina jordi@baylina.cat, Thomas Shababi tom@truelevel.io, "ERC-777: Token Standard," Ethereum Improvement Proposals, no. 777, November 2017. [Online serial]. Available: https://eips.ethereum.org/EIPS/eip-777.

最後に

今回は「ERC20規格と互換性を持ちながら、トークンコントラクトの標準インターフェースと動作を提案しているERC777」についてまとめてきました！ いかがだったでしょうか？

質問などがある方は以下のTwitterのDMなどからお気軽に質問してください！

Twitter @cardene777