Go-Methoden für Tokenkonvertierung
Blockchain App Builder generiert automatisch Methoden, mit denen Sie fungible Token konvertieren können, die den Token Taxonomy Framework-Standard verwenden.
Die Tokenkonvertierungsmethoden umfassen das Konzept des Exchange Pools. Das Exchange Pool-Konto wird durch andere Token-Konten finanziert. Wenn Sie Token prägen, können Sie angeben, dass ein Prozentsatz der abgebauten Token auf das Exchange-Pool-Konto übertragen wird.
Tokenkonvertierungsprozess
Ein typischer Ablauf zum Konvertieren von Token führt folgende Schritte aus:- Rufen Sie die Methode
InitializeExchangePoolUser
auf, um den Exchange Pool-Benutzer zu initialisieren. - Rufen Sie die Methode
CreateExchangePoolAccounts
auf, um Exchange Pool-Konten zu erstellen. Erstellen Sie ein Exchange-Pool-Konto für jeden Typ von fungiblem Token, von dem Sie konvertieren oder in das Sie konvertieren möchten. - Rufen Sie die Methode
AddConversionRate
auf, um die Konvertierungsrate für jedes Tokenpaar festzulegen, zwischen dem Sie konvertieren möchten. - Finanzieren Sie die Exchange-Pool-Tokenkonten auf eine der folgenden Arten:
- Übertragen Sie Token mithilfe der standardmäßigen Übertragungsmethoden auf die Tokenkonten des Exchange-Pools.
- Rufen Sie die Methode
MintWithFundingExchangePoolToken
auf, wenn Sie Token prägen, die einen Prozentsatz der abgebauten Token auf ein Exchange-Poolkonto übertragen können.
- Rufen Sie die Methode
TokenConversion
auf, um zwischen zwei fungiblen Token zu konvertieren. Ein einzelner Benutzer kann Token zwischen zwei seiner Token-Konten konvertieren, oder ein Benutzerpaar kann Token direkt von einem Konto in ein anderes konvertieren. - Der Exchange-Poolbenutzer kann die Kontensalden und Kontotransaktionen des Exchange-Pools anzeigen.
- Rufen Sie die Methode
GetAccount
auf, um die Salden der einzelnen Exchange Pool-Tokenkonten anzuzeigen. - Rufen Sie die Methoden
GetAccountTransactionHistory
undGetAccountTransactionHistoryWithFilters
auf, um Kontotransaktionen für jedes Exchange-Pool-Tokenkonto anzuzeigen.
- Rufen Sie die Methode
Automatisch generierte Tokenkonvertierungsmethoden
Blockchain App Builder generiert automatisch Methoden, um zwischen verschiedenen Arten von fungiblen Token zu konvertieren. Controller-Methoden müssen öffentlich sein, damit sie aufgerufen werden können. Öffentliche Methodennamen beginnen mit einem Großbuchstaben. Methodennamen, die mit einem Kleinbuchstaben beginnen, sind privat.
-
InitializeExchangePoolUser
- Diese Methode initialisiert den Exchange Pool-Benutzer, bei dem es sich um eine einmalige Aktivität handelt. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
CreateExchangePoolAccounts
- Diese Methode erstellt Exchange-Pool-Tokenkonten für ein bestimmtes Array von Token-IDs. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
AddConversionRate
- Diese Methode fügt eine Konvertierungsrate für ein Tokenpaar hinzu. Die Tokenkonvertierungsrate kann bis zu acht Dezimalstellen angegeben werden. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
GetConversionRate
- Diese Methode ruft die aktuelle Konvertierungsrate für ein Tokenpaar ab. Diese Methode kann von der
Token Admin
des Chaincodes, einem beliebigenOrg Admin
und einem beliebigen Tokenkontoeigentümer aufgerufen werden. -
UpdateConversionRate
- Mit dieser Methode wird die aktuelle Konvertierungsrate für ein Tokenpaar aktualisiert. Die Tokenkonvertierungsrate kann bis zu acht Dezimalstellen angegeben werden. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
MintWithFundingExchangePool
- Mit dieser Methode werden Token im Konto des Anrufers basierend auf der angegebenen Token-ID und Menge abgebildet. Ein Prozentsatz der Token aus der Prägemenge wird dann auf das Token-Konto des Exchange-Pools übertragen.
-
TokenConversion
- Diese Methode konvertiert Token aus dem Account des Aufrufers in den Account, der durch die Werte
to_token_id
,to_org_id
undto_user_id
angegeben wird. Diese Methode kann von derToken Admin
des Chaincodes und von jedem Tokenkontoinhaber aufgerufen werden. Ein Exchange Pool-Benutzer kann diese Methode nicht aufrufen. -
GetConversionHistory
- Diese Methode gibt die Tokenkonvertierungshistorie für einen angegebenen Tokenaccount zurück. Diese Methode kann von der
Token Admin
des Chaincodes, einerOrg Admin
der angegebenen Organisation und vom Tokenkontoeigentümer aufgerufen werden. -
GetConversionRateHistory
- Diese Methode gibt die Tokenkonvertierungsratenhistorie für ein Tokenpaar zurück. Diese Methode kann von der
Token Admin
des Chaincodes, einem beliebigenOrg Admin
und einem beliebigen Tokenkontoeigentümer aufgerufen werden. -
GetExchangePoolUser
- Diese Methode gibt die Werte
org_id
unduser_id
für den Exchange Pool-Benutzer zurück. Diese Methode kann nur von einemToken Admin
des Chaincodes aufgerufen werden.
-
InitializeExchangePoolUser
- Diese Methode initialisiert den Exchange Pool-Benutzer, bei dem es sich um eine einmalige Aktivität handelt. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
CreateExchangePoolAccounts
- Diese Methode erstellt Exchange-Pool-Tokenkonten für ein bestimmtes Array von Token-IDs. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
AddConversionRate
- Diese Methode fügt eine Konvertierungsrate für ein Tokenpaar hinzu. Die Tokenkonvertierungsrate kann bis zu acht Dezimalstellen angegeben werden. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
GetConversionRate
- Diese Methode ruft die aktuelle Konvertierungsrate für ein Tokenpaar ab. Diese Methode kann von der
Token Admin
oderToken Auditor
, einerOrg Admin
oderOrg Auditor
der angegebenen Organisation oder von einem beliebigen Tokenkontoeigentümer aufgerufen werden. -
UpdateConversionRate
- Mit dieser Methode wird die aktuelle Konvertierungsrate für ein Tokenpaar aktualisiert. Die Tokenkonvertierungsrate kann bis zu acht Dezimalstellen angegeben werden. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
MintWithFundingExchangePool
- Mit dieser Methode werden Token im Konto des Anrufers basierend auf der angegebenen Token-ID und Menge abgebildet. Ein Prozentsatz der Token aus der Prägemenge wird dann auf das Token-Konto des Exchange-Pools übertragen.
-
TokenConversion
- Diese Methode konvertiert Token aus dem Account des Aufrufers in den Account, der durch die Werte
to_token_id
,to_org_id
undto_user_id
angegeben wird. Diese Methode kann von derToken Admin
des Chaincodes und von jedem Tokenkontoinhaber aufgerufen werden. Ein Exchange Pool-Benutzer kann diese Methode nicht aufrufen. -
GetConversionHistory
- Diese Methode gibt die Tokenkonvertierungshistorie für einen angegebenen Tokenaccount zurück. Diese Methode kann von der
Token Admin
oderToken Auditor
, einerOrg Admin
oderOrg Auditor
der angegebenen Organisation und vom angegebenen Kontoinhaber aufgerufen werden. -
GetConversionRateHistory
- Diese Methode gibt die Tokenkonvertierungsratenhistorie für ein Tokenpaar zurück. Diese Methode kann von
Token Admin
,Token Auditor
,Org Admin
,Org Auditor
oder einem beliebigen Tokenkontoeigentümer aufgerufen werden. -
GetExchangePoolUser
- Diese Methode gibt die Werte
org_id
unduser_id
für den Exchange Pool-Benutzer zurück. Diese Methode kann nur mit einerToken Admin
oderToken Auditor
des Chaincodes aufgerufen werden.
SDK-Methoden für Tokenkonvertierung
-
InitializeExchangePoolUser
- Diese Methode initialisiert den Exchange Pool-Benutzer, bei dem es sich um eine einmalige Aktivität handelt. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
CreateExchangePoolAccounts
- Diese Methode erstellt Exchange-Pool-Tokenkonten für ein bestimmtes Array von Token-IDs. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
AddConversionToken
- Diese Methode fügt Token mit einer neuen Konvertierungsrate für ein angegebenes Token hinzu. Die Tokenkonvertierungsrate kann bis zu acht Dezimalstellen angegeben werden. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
Get
- Diese Methode ruft die aktuelle Konvertierungsrate für ein Tokenpaar ab. Diese Methode kann von der
Token Admin
des Chaincodes und von jedem Tokenkontoinhaber aufgerufen werden. -
UpdateTokenConversionRate
- Mit dieser Methode wird die aktuelle Konvertierungsrate für ein Tokenpaar aktualisiert. Die Tokenkonvertierungsrate kann bis zu acht Dezimalstellen angegeben werden. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
MintWithFundingExchangePool
- Mit dieser Methode werden Token im Konto des Anrufers basierend auf der angegebenen Token-ID und Menge abgebildet. Ein Prozentsatz der Token aus der Prägemenge wird dann auf das Token-Konto des Exchange-Pools übertragen.
-
TokenConversion
- Diese Methode konvertiert Token aus dem Account des Aufrufers in den Account, der durch die Werte
to_token_id
,to_org_id
undto_user_id
angegeben wird. Diese Methode kann von derToken Admin
des Chaincodes und von jedem Tokenkontoinhaber aufgerufen werden. Ein Exchange Pool-Benutzer kann diese Methode nicht aufrufen. -
GetTokenConversionHistory
- Diese Methode gibt die Tokenkonvertierungshistorie für einen angegebenen Tokenaccount zurück. Diese Methode kann von der
Token Admin
des Chaincodes und vom Tokenkontoinhaber aufgerufen werden. -
history
- Diese Methode gibt die Tokenkonvertierungsratenhistorie für ein Tokenpaar zurück. Diese Methode kann von der
Token Admin
des Chaincodes, einem beliebigenOrg Admin
und einem beliebigen Tokenkontoeigentümer aufgerufen werden. -
GetExchangePoolUser
- Diese Methode gibt die Werte
org_id
unduser_id
für den Exchange Pool-Benutzer zurück. Diese Methode kann nur von einemToken Admin
des Chaincodes aufgerufen werden.