Was kommt nach der Blockchain? Teil 4 Beispiele Hashgraph

Der Service AccountRecordQuery() liefert alle Datensätze für ein Konto für Ein- und Auszahlungen, die in den letzten 24 Stunden über dem vom Benutzer festgelegten Schwellenwert lagen. Die Abfrageantwort enthält den Header und die Konto-ID sowie die einzelnen Transaction Records.

Die Implementierung dieser Abfrage ist relativ simpel, wie das folgende Beispiel zeigt:

public static CryptoGetAccountRecordsResponse getAccountRecords(
 AccountId accountId, 
 Client client) throws HederaException 
{
 // Create AccountRecordsQuery() object
 var query = new AccountRecordsQuery(client)
 .setAccountId(accountId);

 CryptoGetAccountRecordsResponse respons = query.execute();
 return respons;
}

Im Datensatz zur obigen Transaktion (je 5000 tℏ aus 10291 und 62402 an 69192) können die einzelnen Buchungen genau aufgeschlüsselt werden. Nachfolgend werden nur die wichtigsten Teile aus dem gesamte Transaction Record für den jeweiligen Account gezeigt, um die Buchungen einfach nachzuvollziehen.

Für den Account 10291 hatten wir vor und nach dem Transfer der 5000 tℏ folgende Beträge.

Vor Übertragung:
     balance 10291: 98507842535
 
Nach Übertragung:
     balance 10291: 98507699945
 
In dem zugehörigen Transaction Record ist erkennbar, dass neben den 5000 tℏ noch Fees in Höhe von 136326 tℏ und 1264 tℏ angefallen sind. Die Summe der Abzüge führt dann zu dem obigen Ergebnis nach dem Transfer.

…
 accountAmounts {
 accountID {
 accountNum: 10291
 }
 amount: -136326
 }
…
 accountAmounts {
 accountID {
 accountNum: 10291
 }
 amount: -1264
 }
…
 accountAmounts {
 accountID {
 accountNum: 10291
 }
 amount: -5000
 }
…

Für den zweiten Account, von dem 5000 tℏ abgebucht werden, sieht es ähnlich aus. Es wurden 5000 tℏ abgebucht und 127 tℏ Fees sind angefallen.

Vor Übertragung:
     balance 62402: 985535

Nach Übertragung:
     balance 62402: 980408

…
 accountAmounts {
 accountID {
 accountNum: 62402
 }
 amount: -5000
 }
 accountAmounts {
 accountID {
 accountNum: 62402
 }
 amount: -127
 }
…

Der „Gewinner“ ist der dritte Account als der Empfänger der 10.000 tℏ. Wie man sieht, sind aber nach der Transaktion nicht alle 10.000 tℏ vorhanden.

Vor Übertragung:
     balance 69192: 30619

Nach Übertragung:
     balance 69192: 40492

Im zugehörigen Transaction Record ist erkennbar, dass zwar alle 10.000 tℏ transferiert, aber gleichzeitig wieder 127 tℏ als Fees abgezogen wurden.

accountAmounts {
 accountID {
 accountNum: 69192
 }
 amount: 10000
 }
 accountAmounts {
 accountID {
 accountNum: 69192
 }
 amount: -127
 }
…

Es wurden hier nicht alle Cryptocurrency Account Queries oder Transaktionen als Beispiele betrachtet, da diese alle sehr ähnlich verwendet werden. In der Dokumentation finden sich alle Transaktionen und Queries. Dort sind alle Methoden einzeln mit Beispiel-Implementierungen aufgeführt. Die Herausforderung besteht aktuell noch darin, zu ergründen, ob und wie alle Parameter wirklich funktionieren und wie stabil die Implementierungen sind. Nachfolgend ein Beispiel aus dieser Rubrik.

Der Service CryptoTransferTransaction() des nachfolgenden Beispiel-Codes wäre das Rückgabeobjekt vom Typ CryptoTransferTransaction.

new CryptoTransferTransaction(client)
 .addSender(senderAccounts[0], 100)
 .addRecipient(recipientAccountId, 100)
 .setTransactionFee(10000);

Wenn wir jetzt eine kleine Änderung vornehmen und das Ganze noch signieren mit .sign(), was man aufgrund der Dokumentation als erstes versuchen wird, dann führt die Methode sign() zu einem Objekt vom Typ Transaction.

new CryptoTransferTransaction(client)
 .addSender(senderAccounts[0], 100)
 .addSender(senderAccounts[1], 100)
 .addRecipient(recipientAccountId, 200)
 .setTransactionFee(10000)
 .sign(key[1]);

Der Versuch für mehrere Accounts, die die Transaktion signieren müssen, einen Transfer auszuführen, wird bei dieser Implementierung zur Laufzeit mit einer Exception scheitern - auch wenn es erstmal keine Compiler-Fehler gibt.

Die Lösung dieses Problems erschließt sich erst, wenn man sich die Implementierung im SDK genauer ansieht. Da die Transaktion von allen Beteiligten zu signieren ist, muss die Transaktion erst „gebaut“ werden, um anschließend signierbar zu sein. Dies ist im folgenden Code veranschaulicht.

cryptoTransferTransaction ctx = new CryptoTransferTransaction(client)
 .addSender(senderAccounts[0], 100)
 .addSender(senderAccounts[1], 100)
 .addRecipient(recipientAccountId, 200)
 .setTransactionFee(10000)

Transaction tx = ct.build();

tx.sign(key[1]);

public static TransactionReceipt createFile(
 Client client, 
 byte[] fileContents, 
 long duration, 
 Ed25519PrivateKey[] keys) throws HederaException
{
 FileCreateTransaction ftx;
 Transaction tx;

 //create new FileCreateTransaction 
 ftx = new FileCreateTransaction(client);
 ftx.setExpirationTime(Instant.now().plus(Duration.ofSeconds(duration)));
 for (int i=0; i< keys.length; i++) { 
 ftx.addKey((keys[i]).getPublicKey());
 }
 ftx.setContents(fileContents);
 ftx.setTransactionFee(42_000_000 * keys.length);
  
 //build FileCreateTransaction 
 tx = ftx.build();
  
 //sign transaction
 for (int i=1; i< keys.length; i++) {
 tx.sign(keys[i]);
 }
 TransactionReceipt receipt = tx.executeForReceipt();
 return receipt; 
}

public static TransactionReceipt createLargeFile(
 byte[] fileContents, 
 long duration, Ed25519PrivateKey[] key) throws HederaException 
{
 final int FILE_PART_SIZE = 1000; // 1K bytes
 …
 int numParts = fileContents.length / FILE_PART_SIZE;
 int remainder = fileContents.length % FILE_PART_SIZE;
 …
 //find first parts of the file
 firstPartBytes = Helper.copyBytes(0, FILE_PART_SIZE, fileContents);
 ….
 // create the new file
 TransactionReceipt receipt = createFile(firstPartBytes, duration, key);
 …
 // append the all parts
 for (int i = 1; i < numParts; i++) {
 byte[] partBytes = Helper.copyBytes(
 i * FILE_PART_SIZE,
 FILE_PART_SIZE, 
 fileContents);
 …
 appendReceipt = appendFile(partBytes, myFileId);
 …
 }
 // append the rest of the file
 …
 return receipt;
}

public static TransactionReceipt appendFile(
 byte[] fileContents, 
 FileId fileId) throws HederaException
{
 var client = Helper.createHederaClient();
 var tx = new FileAppendTransaction(client)
 .setFileId(fileId)
 .setContents(fileContents)
 .setTransactionFee(42_000_000);

 TransactionReceipt receipt = tx.executeForReceipt();
 return receipt;
}

…
var tx = new FileInfoQuery(client)
 .setFileId(fileID);

FileInfo info = tx.execute();
… 

keys: [302a300506032b6570032100ebeba69760b5b7d52c27867cbc857dee741722d9adf0df1dfebf819d0c321c0b, 302a300506032b65700321008cbb4189fcb252cf0a6f1bd32b7a35cf4b31691e58ba2731deb37e220a81f536]
file experation time: 2019-09-18T14:49:27Z
file size: 10
file Id: 0.0.61974
file deleted: false

…
 FileDeleteTransaction dftx = new FileDeleteTransaction(client);
 dftx.setFileId(fileID);
 dftx.setTransactionFee(6_000_000 *2);
 dftx.build();
 Transaction tx = dftx.sign(key);
…