メインコンテンツへスキップ
Change page

ERC-1155 マルチトークン規格

最終編集者: @HiroyukiNaito(opens in a new tab), 2023年8月15日

はじめに

さまざまな種類のトークンを管理するコントラクトにおける標準的なインターフェイスです。 デプロイされたひとつのコントラクトには、代替性トークン、非代替性トークン、あるいはその他の種類のトークン(例:半代替性トークン)を含めることができます。

マルチトークン規格とは何か?

この規格は、代替性か非代替性かを問わず、あらゆる種類のトークンを表現し、管理できるスマートコントラクトのインターフェイスを開発するというシンプルな発想に基づいて策定されたものです。 このため、ERC-1155規格に基づくトークンは、ERC-20およびERC-721トークンと同一の機能を提供し、この両方を同時に提供することすら可能です。 このため、ERC-20およびERC-721の両規格における機能や効率性が向上し、明らかな実装エラーを訂正することができます。

ERC-1155トークンの詳細な説明については、EIP-1155(opens in a new tab)を参照してください。

前提知識

このページをよく理解するには、まずトークン規格ERC-20ERC-721について理解しておく必要があります。

ERC-1155の機能と特長:

  • バッチ転送:1回の呼び出しで複数のアセットを転送します。
  • バッチ残高:1回の呼び出しで、複数の資産の残高を取得します。
  • バッチ承認:ひとつのアドレスに対するすべてのトークンを承認します。
  • フック:トークンのフックを受け取ります。
  • NFTに対応:供給トークンの数が1の場合、NFTとして扱います。
  • 安全な転送ルール:セキュアな転送のためのルールセットです。

バッチ転送

この規格におけるバッチ転送は、通常のERC-20の場合とほぼ同様です。 まず、通常のERC-20規格におけるtransferFrom関数を確認しておきましょう:

1// ERC-20
2function transferFrom(address from, address to, uint256 value) external returns (bool);
3
4// ERC-1155
5function safeBatchTransferFrom(
6 address _from,
7 address _to,
8 uint256[] calldata _ids,
9 uint256[] calldata _values,
10 bytes calldata _data
11) external;
すべて表示
コピー

ERC-1155における唯一の違いは、値を配列として渡し、さらにIDの配列も渡す点です。 例えば、ids=[3, 6, 13]values=[100, 200, 5]と指定した場合、以下のような転送が実行されます。

  1. id3では、_fromから_toに100トークンを転送。
  2. id6では、_fromから_toに200トークンを転送。
  3. id13では、_fromから_toにi5トークンを転送。

ERC-1155では、transferは存在せず、transferFromのみ利用できます。 通常のtransferのように使用するには、 関数を呼び出すアドレスをfrom addressとして設定すればよいです。

バッチ残高

同様に、ERC-20におけるbalanceOfの呼び出しも、バッチ処理に対応した機能が追加されています。 確認のために、まずERC-20の関数を見ておきましょう:

1// ERC-20
2function balanceOf(address owner) external view returns (uint256);
3
4// ERC-1155
5function balanceOfBatch(
6 address[] calldata _owners,
7 uint256[] calldata _ids
8) external view returns (uint256[] memory);
コピー

残高の呼び出しがよりシンプルになり、1回の呼び出しで複数の残高を取得できるようになりました。 所有者の配列と、その後にトークンIDの配列を指定すればよいです。

例えば、_ids=[3, 6, 13]_owners=[0xbeef..., 0x1337..., 0x111111...]を与えると、戻り値は次のようになります:

1[
2 balanceOf(0xbeef...),
3 balanceOf(0x1337...),
4 balanceOf(0x1111...)
5]
コピー

バッチ承認

1// ERC-1155
2function setApprovalForAll(
3 address _operator,
4 bool _approved
5) external;
6
7function isApprovedForAll(
8 address _owner,
9 address _operator
10) external view returns (bool);
すべて表示
コピー

承認プロセスは、ERC-20とは若干異なります。 特定の金額を承認するのではなく、setApprovalForAllの関数を通じて承認/非承認を決定するオペレーターを指定します。

isApprovedForAllの関数を使って、現在の承認状態を読み込むことができます。 推測されたとおり、これはAll or Nothing型の操作です。 承認するトークンの数やトークンの種類を指定することはできません。

これは、シンプルさを実現するために敢えて採用された設計です。 ひとつのアドレスに対し、すべて承認することだけが可能です。

受信フック

1function onERC1155BatchReceived(
2 address _operator,
3 address _from,
4 uint256[] calldata _ids,
5 uint256[] calldata _values,
6 bytes calldata _data
7) external returns(bytes4);
コピー

ERC-1155は、EIP-165(opens in a new tab)に対応しているため、スマートコントラクトに対する受信フックのみ対応しています。 このフック関数は、合い言葉として事前に定義されたbytes4の値(以下の形式を持つ)を返す必要があります。

1bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))
コピー

受信側のコントラクトがこの値を返すと、コントラクトがこの転送を受け入れ、ERC-1155のトークンに対する処理方法を理解していると見なされます。 これにより、コントラクト内部で未処理のトークンが溜まっていくことがなくなります!

NFTのサポート

供給されるトークンの数が1である場合、このトークンは事実上非代替性トークン(NFT)だと言えます。 ERC-721規格と同じように、メタデータのURLを定義することが可能です。 このURLは、クライアントによる読み取り/変更が可能です。こちら(opens in a new tab)をご覧ください。

安全転送ルール

すでに他の記事において、いくつかの安全転送ルールについて紹介しました。 ここでは、最も重要なルールについて確認しておきましょう:

  1. 発信者は、_fromのトークンを支払う行為に対して承認を受けているか、_fromと同一でなければなりません。
  2. 以下に該当する場合、転送の呼び出しは取り消されます:
    1. _toのアドレスが0である。
    2. _idsの長さが_valuesの長さと一致しない。
    3. _idsにおけるトークン(複数可)の保有者(複数可)における残高(複数可)のいずれかが、受信者に送信された_valuesにおける当該の額(複数可)よりも少ない。
    4. その他のエラーが発生した。

注記:フックを含むすべてのバッチ関数は、バッチ処理ではない通常バージョンの関数としても存在します。 これは、実際にはひとつの資産のみを転送するケースが最も一般的になると予想されるために、ガスの効率性を考慮した設計上の選択です。 この記事では、安全転送ルールの場合も含めて、簡潔な説明のためにバッチ関数のみを取り上げました。 各関数の名称は、「Batch」を削除すれば同一です。

参考文献

この記事は役に立ちましたか?