ERC-1155 Token-Standard

Einführung

Eine Standardschnittstelle für Verträge, die mehrere Token-Typen verwalten. Ein einzelner bereitgestellter Vertrag kann eine beliebige Kombination von fungiblen Token, nicht-fungiblen Token oder anderen Konfigurationen (z. B. semi-fungible Token) enthalten.

Was versteht man unter Multi-Token-Standard?

Die Idee ist einfach und zielt darauf ab, eine Smart-Contract-Schnittstelle zu schaffen, die eine beliebige Anzahl von fungiblen und nicht-fungiblen Token-Typen darstellen und kontrollieren kann. Auf diese Weise kann der ERC-1155-Token dieselben Funktionen wie ein ERC-20- und ERC-721-Token ausführen, und sogar beide gleichzeitig. Er verbessert die Funktionalität sowohl des ERC-20- als auch des ERC-721-Standards, macht sie effizienter und korrigiert offensichtliche Implementierungsfehler.

Der ERC-1155-Token wird vollständig in EIP-1155 (opens in a new tab) beschrieben.

Voraussetzungen

Um diese Seite besser zu verstehen, empfehlen wir Ihnen, sich zunächst über Token-Standards, ERC-20 und ERC-721 zu informieren.

ERC-1155 Funktionen und Merkmale:

• Batch-Übertragung: Übertragen Sie mehrere Assets in einem einzigen Aufruf.
• Batch-Guthaben: Rufen Sie die Guthaben mehrerer Assets in einem einzigen Aufruf ab.
• Batch-Genehmigung: Genehmigen Sie alle Token für eine Adresse.
• Hooks: Hook zum Empfangen von Token.
• NFT-Unterstützung: Wenn die Menge nur 1 beträgt, wird es als NFT behandelt.
• Sichere Übertragungsregeln: Regelwerk für die sichere Übertragung.

Batch-Übertragungen

Die Batch-Übertragung funktioniert sehr ähnlich wie die regulären ERC-20-Übertragungen. Schauen wir uns die reguläre ERC-20-Funktion transferFrom an:

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;
Alles anzeigen
Kopieren

Der einzige Unterschied bei ERC-1155 besteht darin, dass wir die Werte als Array übergeben und auch ein Array von IDs übergeben. Wenn beispielsweise ids=[3, 6, 13] und values=[100, 200, 5] gegeben sind, lauten die resultierenden Übertragungen:

1. Übertragung von 100 Token mit der ID 3 von _from an _to.
2. Übertragung von 200 Token mit der ID 6 von _from an _to.
3. Übertragung von 5 Token mit der ID 13 von _from an _to.

In ERC-1155 gibt es nur transferFrom, kein transfer. Um es wie ein reguläres transfer zu verwenden, setzen Sie einfach die Absenderadresse auf die Adresse, die die Funktion aufruft.

Batch-Guthaben

Der entsprechende ERC-20-Aufruf balanceOf hat ebenfalls eine Partnerfunktion mit Batch-Unterstützung. Zur Erinnerung: Dies ist die ERC-20-Version:

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);
Kopieren

Bei der Abfrage des Saldos ist es sogar noch einfacher, denn wir können mehrere Salden in einem einzigen Schritt abrufen. Wir übergeben das Array der Besitzer, gefolgt von dem Array der Token-Ids.

Wenn beispielsweise _ids=[3, 6, 13] und _owners=[0xbeef..., 0x1337..., 0x1111...] gegeben sind, lautet der Rückgabewert:

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

Batch-Genehmigung

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);
Alles anzeigen
Kopieren

Die Genehmigungen unterscheiden sich geringfügig von denen des ERC-20. Anstatt bestimmte Beträge zu genehmigen, setzen Sie einen Operator über setApprovalForAll auf „genehmigt“ oder „nicht genehmigt“.

Der aktuelle Status kann über isApprovedForAll ausgelesen werden. Wie Sie sehen können, ist es eine Alles-oder-Nichts-Operation. Sie können nicht festlegen, wie viele Token genehmigt werden und auch nicht, welche Token-Klasse.

Dies wurde absichtlich so einfach wie möglich gestaltet. Sie können alles nur für eine Adresse genehmigen.

Empfangs-Hook

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

Dank der EIP-165 (opens in a new tab)-Unterstützung unterstützt ERC-1155 Empfangs-Hooks nur für Smart Contracts. Die Haken-Funktion muss einen magischen vordefinierten Bytes4-Wert zurückgeben, der wie folgt angegeben wird:

1bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))
Kopieren

Wenn der empfangende Vertrag diesen Wert zurückgibt, wird davon ausgegangen, dass der Vertrag die Übertragung akzeptiert und weiß, wie er mit den ERC-1155-Token umgehen soll. Großartig, keine feststeckenden Token mehr in einem Vertrag!

NFT-Unterstützung

Wenn es nur eine Angebotsmenge gibt, ist der Token im Wesentlichen ein nicht-fungibler Token (NFT). Und wie bei ERC-721 üblich, können Sie eine Metadaten-URL definieren. Die URL kann von Clients gelesen und geändert werden, siehe hier (opens in a new tab).

Regel für sichere Übertragungen

In den vorangegangenen Erläuterungen haben wir bereits einige Regeln für die sichere Übertragung angesprochen. Aber schauen wir uns die wichtigsten Regeln an:

1. Der Aufrufer muss berechtigt sein, die Token für die _from-Adresse auszugeben, oder der Aufrufer muss _from sein.
2. Der Übertragungsruf muss zurückgehen, wenn
   1. Die _to-Adresse ist 0.
   2. Die Länge von _ids entspricht nicht der Länge von _values.
   3. Das Guthaben eines Inhabers für einen Token in _ids ist geringer als der entsprechende Betrag in _values, der an den Empfänger gesendet wird.
   4. Ein anderer Fehler tritt auf.

Hinweis: Alle Batch-Funktionen, einschließlich des Hooks, existieren auch als Versionen ohne Batch. Dies geschieht aus Gründen der Gaseffizienz, da die Übertragung nur eines Vermögenswerts wahrscheinlich immer noch der am häufigsten genutzte Weg sein wird. Wir haben sie der Einfachheit halber in den Erläuterungen weggelassen, einschließlich der Regeln für die sichere Übertragung. Die Namen sind identisch, Sie müssen nur das „Batch" entfernen.

Weiterführende Lektüre

• EIP-1155: Multi-Token-Standard (opens in a new tab)
• ERC-1155: Openzeppelin Docs (opens in a new tab)
• ERC-1155: GitHub-Repo (opens in a new tab)
• Alchemy NFT-API (opens in a new tab)