Entwicklung von Smart Contracts mit den IBM Blockchain Platform Developer Tools

Muss ich meinen Smart Contract für Fabric 2.x aktualisieren?

Achtung! Die IBM Support for Hyperledger Fabric Extension for VS Code (VS Code-Erweiterung), auf die in der Dokumentation verwiesen wird, ist ein Open-Source-Projekt, das nicht mehr aktiv ist und daher nicht offiziell von IBM unterstützt wird. Weitere Informationen finden Sie im Alternativen zur VS Code-Erweiterung.

Obwohl Unterstützung für Fabric 2.x -Netze zur Plattform hinzugefügt wurde, können Sie Ihre vorhandenen Smart Contracts weiterhin auf Ihren Peers ausführen, die ein v1.4 -Image auf einem Kanal mit einer Anwendungsfunktionalitätsstufe von 1.4 oder niedriger ausführen. Wenn Sie später ein Upgrade Ihres Peers auf ein v2.x -Image durchführen und die Funktionalitätsstufe Ihrer Kanalanwendung auf 2.xaktualisieren möchten, müssen Sie möglicherweise Ihren vorhandenen Smart Contract aktualisieren. Wenn Sie für das Peer-Image und die Kanalanwendungsfunktionalität ein Upgrade auf Version 2.x durchgeführt haben, kann der ursprüngliche Smart Contract jedoch nicht mehr aktualisiert werden. Wenn eine Aktualisierung erforderlich wird, müssen Sie den Smart Contract stattdessen im neuen .tar.gz- oder .tgz-Format mit Version 2 der VS Code-Erweiterung erneut paketieren und dann im Kanal die Definition mit dem neuen Smart Contract-Lebenszyklusprozess vorschlagen.

Beachten Sie die folgenden Hinweise:

Knoten -Wenn Ihr Smart Contract in Node geschrieben wurde, müssen Sie ihn möglicherweise aktualisieren. Standardmäßig erstellt ein Fabric v1.4-Peer eine Node v8-Laufzeit; ein Fabric v2.x-Peer erstellt eine Node v12-Laufzeit. Damit der Smart Contract mit einer Node-Laufzeit der Version 12 funktioniert, müssen die Node-Module fabric-contract-api und fabric-shim mindestens Version 1.4.5 aufweisen. Wenn Sie einen Smart Contract verwenden, der ursprünglich für die Ausführung mit Fabric 1.4 erstellt wurde, aktualisieren Sie die Node-Module, indem Sie den folgenden Befehl ausführen, bevor Sie den Smart Contract auf einem Fabric v2.x-Peer ausführen. Weitere Informationen finden Sie unter Support and compatibility for fabric-chaincode-node .

npm install --save fabric-contract-api@latest-1.4 fabric-shim@latest-1.4

Go -Da Fabric v2.x -Peers keinen "shim" haben (die externen Abhängigkeiten, die die Ausführung von Smart Contracts in früheren Fabric-Versionen ermöglicht haben), müssen Sie den Shim anschaffen und anschließend alle in Golang (Go) geschriebenen Smart Contracts, die das Go-SDKverwenden, neu packen. "Shim-Vendoring" bedeutet, dass Sie die Abhängigkeiten in Ihr Projekt kopieren. Ohne diese Bereitstellung und erneute Paketierung kann der Go-Smart Contract auf einem Peer, der Version 2.x eines Fabric-Image verwendet, nicht ausgeführt werden. Wenn Sie die IBM Developer Tools verwenden, um Ihren Smart Contract zu entwickeln und zu packen, führen die Tools das Anbietering für Sie durch. Dieser Prozess ist weder für Smart Contracts erforderlich, die in Java oder Node.jsgeschrieben sind, noch für Smart Contracts, die Go contract-apiverwenden.

Java -Die Datei build.gradle für den Smart Contract muss aktualisiert werden:

1. Wenn der Smart Contract das shadowjar-Plug-in der Version 2.x verwendet, ist eine Aktualisierung auf Version 5 mithilfe des folgenden Codes erforderlich:

   plugins {
       id 'com.github.johnrengelman.shadow' version '5.1.0'
       id 'java'
   }
   

2. Der Abschnitt repositories der Datei muss maven URL für jitpackenthalten. Beispiel:

       repositories {
       ...
       maven {
           url 'https://jitpack.io'
       }
   }
   

Initialisierungsfunktionen -Wenn der Smart Contract mit den Low-Level-APIs geschrieben wurde, die von der Fabric-Chaincode-Shim-API bereitgestellt werden, muss Ihr Smart Contract eine Init -Funktion enthalten, die zum Initialisieren des Chaincodes verwendet wird. Diese Funktion ist zwar für die Smart Contract-Schnittstelle erforderlich, muss aber nicht unbedingt von den Anwendungen aufgerufen werden. Da Sie die Konsole nicht zum Bereitstellen eines Smart Contract verwenden können, der eine Init -Funktion enthält, müssen Sie diese Initialisierungslogik in den Smart Contract selbst verschieben und separat aufrufen. Beispiel: Vom Smart Contract kann ein reservierter Schlüssel verwendet werden, um zu überprüfen, ob der Smart Contract bereits initialisiert wurde. Ist dies nicht der Fall, rufen Sie die Initialisierungslogik auf; andernfalls fahren Sie normal fort. Wenn Ihr Smart Contract die Funktion Init enthalten muss, können Sie sie nur mithilfe des Fabric-Befehls peer lifecycle chaincode install oder mithilfe des IBM Hyperledger Fabric Ansible Collectionbereitstellen. Weitere Informationen zur Verwendung einer Init -Funktion mit dem Fabric-Chaincode-Lebenszyklus finden Sie auch in der Fabric-Dokumentation .

Smart Contract neu packen - Achtung! Die IBM Support for Hyperledger Fabric Extension for VS Code (VS Code-Erweiterung), auf die in der Dokumentation verwiesen wird, ist ein Open-Source-Projekt, das nicht mehr aktiv ist und daher nicht offiziell von IBM unterstützt wird. Weitere Informationen finden Sie im Alternativen zur VS Code-Erweiterung.

Nachdem Sie Ihren Smart Contract aktualisiert haben, verwenden Sie v2 der VS Code-Erweiterung, um Ihren Smart Contract neu zu packen .

Smart Contract-Paket exportieren, importieren und löschen

Achtung! Die IBM Support for Hyperledger Fabric Extension for VS Code (VS Code-Erweiterung), auf die in der Dokumentation verwiesen wird, ist ein Open-Source-Projekt, das nicht mehr aktiv ist und daher nicht offiziell von IBM unterstützt wird. Weitere Informationen finden Sie im Alternativen zur VS Code-Erweiterung.

Nachdem Sie ein Smart-Contract-Projekt paketiert haben, können Sie es aus Visual Studio Code exportieren:

1. Klicken Sie im IBM Blockchain Platform mit der rechten Maustaste auf das Smart Contract-Paket und wählen Sie Paket exportieren.
2. Wählen Sie das Verzeichnis aus, in dem die Datei mit Ihrem Smart Contract-Paket gespeichert werden soll, und klicken Sie auf Exportieren.

Sie können auch ein bestehendes Smart-Contract-Paket in den Bereich der IBM Blockchain Platform importieren:

1. Klicken Sie in der Anzeige Smart Contracts auf das Überlaufmenü und wählen Sie Paket importieren aus.
2. Navigieren Sie zu dem Smart Contract-Paket, das Sie importieren möchten, und klicken Sie auf Importieren.

Sie können auch auf Paket löschen klicken, um das Smart Contract-Paket aus der Liste der Pakete zu entfernen.

Vorkonfiguriertes Hyperledger Fabric-Netz bereitstellen

Bevor Sie einen Smart Contract bereitstellen können, führen Sie die folgenden Schritte aus, um das vorkonfigurierte Netz bereitzustellen:

1. Vergewissern Sie sich, dass auf Ihrer Maschine Docker ausgeführt wird.
2. Öffnen Sie die Registerkarte IBM Blockchain Platform in VS Code.
3. Klicken Sie im Teilfenster Fabric-Umgebungen auf 1 Org Local Fabric. Falls Docker aktiv ist, müsste die lokale Instanz gestartet werden, sobald die Hyperledger Fabric-Images heruntergeladenworden sind.
4. Klicken Sie im Teilfenster Fabric-Gateways auf 1 Org-Local-Fabric- Org1 Gateway , um eine Verbindung zum lokalen Netz herzustellen.

Die VS Code-Erweiterung erstellt ein grundlegendes Fabric-Netz, das einen Anordnungsknoten, einen Peer und eine Zertifizierungsstelle umfasst. Der Peer ist einem Kanal mit dem Namen mychannel zugeordnet. Die Liste der Knoten, Organisationen und Kanäle, die zu dem Netz gehören, wird im Teilfenster Fabric-Umgebungen angezeigt. Vor diesen Knoten finden Sie die Liste der auf Ihren Kanälen bereitgestellten Smart Contracts. Achtung! Die IBM Support for Hyperledger Fabric Extension for VS Code (VS Code-Erweiterung), auf die in der Dokumentation verwiesen wird, ist ein Open-Source-Projekt, das nicht mehr aktiv ist und daher nicht offiziell von IBM unterstützt wird. Weitere Informationen finden Sie im Alternativen zur VS Code-Erweiterung.

Führen Sie die folgenden Schritte aus, um eine neue Organisation oder ein neues Organisationsnetz zu erstellen:

1. Vergewissern Sie sich, dass auf Ihrer Maschine Docker ausgeführt wird.
2. Bewegen Sie den Mauszeiger über das Teilfenster Fabric-Umgebungen und klicken Sie auf + und Umgebung hinzufügen.
3. Wählen Sie Neu von Vorlage erstellen aus.
4. Wählen Sie 1 Org-Vorlage (1 CA, 1 Peer, 1 Kanal) aus. Sie können alternativ auch ein größeres Netz oder einen Privaten Datenvertrag generieren, indem Sie 2 Org-Vorlagen (2 CAs, 2 Peers, 1 Kanal) auswählen.
5. Wählen Sie V2_0 aus, wenn Sie aufgefordert werden, die für das Netz zu verwendende Kanalfunktionsversion auszuwählen. Wenn die Kanalfunktionalität der Version 1 verwendet werden soll, wählen Sie stattdessen die andere Option aus.

Dies wird einige Minuten in Anspruch nehmen, bis ein lokales Fabric-Netz mit Umgebung, Gateways und Wallets erstellt wird.

Smart Contract bereitstellen (Kanalanwendungsfunktion V2)

Smart Contracts können über die Bereitstellungsansichtimplementiert werden. In dieser Ansicht werden alle Bereitstellungsschritte durchgeführt (Installieren, Genehmigen, Festschreiben), die für den Smart Contract-Lebenszyklus in Kanälen erforderlich sind, für die die Anwendungsfunktionalität der Version 2.0 oder eine höheren Version aktiviert ist.

Führen Sie die folgenden Schritte aus, wenn Ihr Kanal mit Anwendungsfunktionalität V2 oder höher und einem .tar.gz Smart Contract-Paket konfiguriert ist.

Gehen Sie wie folgt vor, um die Bereitstellungsansicht zu starten:

1. Überprüfen Sie, ob Sie im Teilfenster Fabric-Umgebungen mit dem Netz verbunden sind.
2. Erweitern Sie den Kanal, in dem Sie Ihren Smart Contract implementieren wollen.
3. Klicken Sie auf + Smart Contract implementieren.

In der Bereitstellungsansicht wird ein Smart Contract in drei Schritten bereitgestellt.

Smart Contract bereitstellen (Kanalanwendungsfunktion V1)

Führen Sie die folgenden Schritte aus, wenn Sie einen Kanal, der mit der Anwendungsfunktion v1.x konfiguriert ist, und ein Smart Contract-Paket im .cds -Format haben.

Gehen Sie wie folgt vor, um die Bereitstellungsansicht zu starten:

1. Überprüfen Sie, ob Sie im Teilfenster Fabric-Umgebungen mit dem Netz verbunden sind.
2. Erweitern Sie den Kanal, in dem Sie Ihren Smart Contract implementieren wollen.
3. Klicken Sie auf + Smart Contract implementieren.

In der Bereitstellungsansicht wird ein Smart Contract in drei Schritten bereitgestellt.

Mit Smart Contract interagieren

Nachdem ein Smart Contract in einem Kanal bereitgestellt wurde, können Sie über das Teilfenster Fabric-Gateways Transaktionen an die Funktionen in Ihrem Smart Contract übergeben:

1. Stellen Sie sicher, dass Ihr Smart Contract auf einem Kanal bereitgestellt wird und dass Sie mit dem Netz verbunden sind.
2. Erweitern Sie im Teilfenster Fabric-Gateways die Dropdown-Liste Kanäle. Klicken Sie auf den Kanal, für den der Smart Contract instanziiert oder festgeschrieben ist.
3. Erweitern Sie den Smart Contract, mit dem Sie interagieren möchten. Die Liste der Transaktionen, die unter Ihrem Smart Contract aufgeführt ist, wird angezeigt.
4. Klicken Sie mit der rechten Maustaste auf die zu übergebende Transaktion und wählen Sie die Option Transaktion übergeben aus. Wenn Sie beispielsweise das Smart Contract-Beispiel für Wertpapiere ("Bonds") erstellt und paketiert haben, dann klicken Sie auf createBond.
5. Geben Sie alle von der Transaktion benötigten Argumente ein und drücken Sie die Eingabetaste. Geben Sie beispielsweise ["bond01","100"] ein, um Ihren ersten Bond zu erstellen.
6. (Optional) Geben Sie alle Argumente ein, die als transiente Daten übergeben werden sollen. Transiente Daten werden nicht auf dem Kanal-Ledger gespeichert, um die Daten privat zu halten.

Anwendungen mit vorkonfiguriertem Netz verbinden

Sie können Ihre Clientanwendungen testen, indem Sie sie mit dem vorkonfigurierten Netz verbinden und Transaktionen an Ihren Smart Contract übergeben.

Zuerst müssen Sie Ihr Verbindungsprofil exportieren:

1. Stellen Sie sicher, dass das Netz im Teilfenster Fabric-Umgebungen ausgeführt wird.
2. Klicken Sie mit der rechten Maustaste auf das Gateway in der Anzeige Fabric-Gateways und wählen Sie Verbindungsprofil exportieren aus.

Anschließend können Sie die Fabric-SDKs und das Verbindungsprofil benutzen, um Ihre Administratoridentität mit dem Benutzernamen admin und dem Kennwort adminpw einzutragen. Dann können Sie diese Identität verwenden, um Ihren Smart Contract aufzurufen oder weitere Benutzer zu registrieren und einzutragen.

Rufen Sie einen Smart Contract auf, der auf Ihren Kanälen instanziiert oder festgeschrieben wurde.

Sie können Ihr Verbindungsprofil von der Fabric Operations Console herunterladen, um ein Gateway im Teilfenster Fabric Gateways zu erstellen. Anschließend können Sie das Gateway verwenden, um die Smart Contracts aufzurufen, für Ihren Kanal bereitgestellt wurden.

Öffnen Sie die Fabric Operations Console, die Ihrer Instanz von IBM Support for Hyperledger Fabriczugeordnet ist. Navigieren Sie zur Registerkarte Organisationen und klicken Sie auf die Kachel MSP der Organisation für die Organisation, mit der Ihre Clientanwendung interagiert. Klicken Sie auf Verbindungsprofil erstellen , um eine Seitenanzeige zu öffnen, in der Sie Ihr Verbindungsprofil erstellen und in Ihr lokales Dateisystem herunterladen . Anschließend erstellen Sie eine Anwendungsidentität mithilfe Ihrer Zertifizierungsstelle und speichern die enrollID und den geheimen Schlüssel.

Stellen Sie mithilfe der folgenden Schritte eine Verbindung zu IBM Support for Hyperledger Fabric über VS Code her:

1. Öffnen Sie die Registerkarte IBM Blockchain Platform.
2. Bewegen Sie den Mauszeiger über das Teilfenster Fabric-Gateways und klicken Sie auf +.
3. Wählen Sie Gateway über ein Verbindungsprofil erstellen aus.
4. Geben Sie einen Namen für die Verbindung ein.
5. Geben Sie den vollständig qualifizierten Dateipfad Ihres Verbindungsprofils ein. Ihre Verbindung sollte jetzt in der Verbindungsliste unter 1 Org Local Fabric angezeigt werden.
6. Bewegen Sie den Mauszeiger über das Teilfenster Fabric-Wallets und klicken Sie auf +.
7. Wählen Sie unter den verfügbaren Optionen Neue Wallet erstellen und Identität hinzufügen aus. Geben Sie einen Namen für Ihre Wallet und Ihre Identität an.
8. Geben Sie die MSP-ID Ihrer Organisation ein.
9. Klicken Sie auf die Option Gateway auswählen und Registrierungs-ID und geheimen Schlüssel angeben und wählen Sie das Gateway aus, das Sie zuvor erstellt haben.
10. Geben Sie die Eintragungs-ID und den geheimen Schlüssel der Anwendungsidentität ein, die Sie mit der Konsole erstellt haben. Im Teilfenster Fabric-Wallets wird eine neue Identität erstellt.
11. Sie können jetzt eine Verbindung zu Ihrer Instanz von IBM Support for Hyperledger Fabricherstellen. Klicken Sie auf den Verbindungsnamen und wählen Sie den Namen der Wallet aus, die Sie erstellt haben. Sie können die von Ihnen erstellte Wallet auch dem Gateway zuordnen. Klicken Sie hierzu mit der rechten Maustaste auf das Gateway und wählen Sie dann Wallet zuordnen aus. Auf diese Weise kann die Verbindung bei jedem Verbindungsvorgang die gleiche Wallet verwenden.

Nachdem Sie eine Verbindung zu IBM Support for Hyperledger Fabric über VS Code hergestellt haben, können Sie die Liste der Kanäle überprüfen, an denen Ihre Organisationspeers unter dem Gateway teilnehmen. Unter jedem Kanal können Sie die Liste der Smart Contracts, die in jedem Kanal instanziiert oder festgeschrieben werden, und die Transaktionen in jedem Smart Contract überprüfen. Sie können Transaktionen an Ihr Netz übergeben, indem Sie mit der rechten Maustaste auf eine Funktion klicken und dann Transaktion übergeben auswählen und die erforderlichen Argumente übergeben. Sie können auch eine Testdatei für die Smart Contracts generieren, die auf Ihren Kanälen instanziiert werden.

Smart Contract über VS Code implementieren

Achtung! Die IBM Support for Hyperledger Fabric Extension for VS Code (VS Code-Erweiterung), auf die in der Dokumentation verwiesen wird, ist ein Open-Source-Projekt, das nicht mehr aktiv ist und daher nicht offiziell von IBM unterstützt wird. Weitere Informationen finden Sie im Alternativen zur VS Code-Erweiterung.

Sie können auch das Netz IBM Support for Hyperledger Fabric in das Teilfenster Fabric-Umgebungen der Erweiterung importieren. Anschließend können Sie die VS Code-Erweiterung verwenden, um Smart Contracts in Ihrem Netzwerk bereitzustellen.

Sie können Knoten über Ihre Konsole exportieren und anschließend über eine andere Konsole importieren. Mit dem gleichen Prozess können Sie Knoten über Ihre Konsole exportieren und anschließend in das Teilfenster Fabric-Umgebungen importieren. Die einfachste Möglichkeit besteht darin, mit der Erweiterung die Konsole zu ermitteln und die Knoten zu importieren.

1. Navigieren Sie zur Registerkarte Einstellungen in der linken Navigationsleiste. Sie können einen Abschnitt namens Massendatenverwaltung überprüfen, der zwei Schaltflächen enthält. Die Schaltfläche Exportieren öffnet ein Teilfenster auf der rechten Seite.
2. Aktivieren Sie das Kontrollkästchen zum Exportieren Ihrer Identitäten. Die anderen Optionen können Sie abwählen.
3. Klicken Sie auf Exportieren, um die Identitäten als ZIP-Datei in Ihr lokales Dateisystem herunterzuladen. Extrahieren Sie die Datei, nachdem der Download abgeschlossen ist.

Anschließend können Sie die Knoten Ihres Netzes in die Erweiterung importieren.

Wallets und Benutzer hinzufügen

Führen Sie die folgenden Schritte aus, um eine neue Wallet mithilfe eines Zertifikats und eines privaten Schlüssels zu erstellen:

1. Bewegen Sie den Mauszeiger über das Teilfenster Fabric-Wallets und klicken Sie auf +.
2. Wählen Sie unter den verfügbaren Optionen Neue Wallet erstellen und Identität hinzufügen aus. Geben Sie einen Namen für Ihre Wallet und Ihre Identität an.
3. Geben Sie die MSP-ID Ihrer Organisation ein.
4. Wählen Sie die Option zum Hinzufügen eines Zertifikats und eines privaten Schlüssels aus.
5. Wenn Sie ein Zertifikat und einen privaten Schlüssel verwenden, suchen Sie nach diesem Zertifikat und dem privaten Schlüssel.

Zu den bereits erstellten Wallets können auch neue Benutzer hinzugefügt werden:

1. Klicken Sie im Teilfenster Fabric-Wallets mit der rechten Maustaste auf eine Wallet und wählen Sie dann Identität hinzufügen aus.
2. Geben Sie einen Namen für die Identität und eine MSP-ID an.
3. Sie können eine JSON-Datei hochladen sowie ein Zertifikat und einen privaten Schlüssel angeben oder eine Eintragungs-ID und einen geheimen Schlüssel.
   • Wenn Sie eine Verbindung zu einem Netz in IBM Support for Hyperledger Fabricherstellen, können Sie eine Identität aus Ihrer Fabric Operations Console herunterladen, indem Sie entweder eine Identität aus Ihrer Wallet exportieren oder eine Identität mithilfe Ihrer Zertifizierungsstelle registrieren und exportieren. Sie können die JSON-Datei dann direkt in VS Code hochladen.
   • Wenn Sie ein Zertifikat und einen privaten Schlüssel verwenden, suchen Sie nach diesem Zertifikat und dem privaten Schlüssel.
   • Wenn Sie eine Eintragungs-ID und einen geheimen Schlüssel verwenden, wählen Sie das Gateway aus, bei dem die Eintragung erfolgen soll, und geben Sie die Eintragungs-ID und den geheimen Schlüssel ein.