En inofficiell guide till integration av Qubic-tjänster

Integrera Qubic i befintliga tjänster via fullnod, fjärrnod, arkivserver eller API, med varierande kontroll och komplexitet.

Qsilver - 17 februari 2024.

Introduktion

Att integrera Qubic i befintliga tjänster kan göras på fyra huvudsakliga sätt, som alla erbjuder olika nivåer av kontroll och komplexitet:

1. Kör en fullständig nod: Direktåtkomst till data i minnet för operationer.
2. Kör en fjärrnod: Förfrågan till publika fulla noder för att få de data som krävs för operationer.
3. Kör en arkivserver: Bygg ett lokalt fullständigt arkiv av alla Qubic-data för operationer.
4. Gränssnitt med Qubic API-server: Enklaste metoden, men med mindre kontroll över datatillgängligheten.

Ju lägre siffra, desto mer arbete, men desto mer kontroll över datatillgängligheten. Oavsett vilken nivå du väljer är det viktigt att förstå de kritiska skillnaderna med Qubic.

Viktiga skillnader med Qubic

För tjänster som hanterar monetära värden är de två viktigaste skillnaderna med Qubic följande:

1. Även om en txid ingår i en validerad tick är det inte säkert att den har gjort någonting.
2. Adressbalansen kan ändras utan att en specifik transaktion överförs från A till B, t.ex. genom en smart kontraktsoperation.

På grund av dessa skillnader bör Qubic-bearbetningen baseras på ändringar av adressbalansen, vilket säkerställer att ändringar genom smarta kontrakt inte förvirrar logiken.

Hantering av insättningar

För att förenkla insättningshanteringen rekommenderas att man använder normala transaktioner. Insättningar som görs med hjälp av smarta kontrakt kan ignoreras eller hanteras manuellt (med en extra avgift för att täcka kostnaderna).

1. Iterera genom alla transaktioner i varje tick och identifiera destinationsadresser som tillhör kunder.
2. Flagga dessa adresser för saldokontroll.
3. Hämta enhetsinformation för flaggade adresser för att se vilka som har fått nya medel.
4. Uppdatera den aktuella enhetsinformationen för adresser som har fått nya medel.

Saldoändringar kanske inte matchar transaktionsbeloppet på grund av txid-fel eller insättningar av smarta kontrakt. Genom att ignorera SC-insättningar säkerställs att användaren krediteras för SC-insättningar även om txid misslyckades.

Balansbaserad insättningsbehandling

Den här metoden kan kräva mer bandbredd men är användbar för tjänster i mellansegmentet genom att hundratusentals adresser pollas över nätverket via en fjärrnod. Det säkerställer att alla insättningsmetoder krediteras korrekt, vilket förbättrar användarupplevelsen.

1. Behåll de senaste validerade enhetsuppgifterna för varje användaradress.
2. I en pollningsloop jämförs de senaste enhetsuppgifterna med de validerade enhetsuppgifterna.
3. Validera de senaste enhetsuppgifterna med hjälp av Merkle-trädet.
4. Om de valideras, uppdatera de validerade enhetsuppgifterna och generera en insättningshändelse baserat på skillnaden i totala insättningar.

Behandling av uttag

Små volymer

1. Hämta validerade enhetsdata för den sändande adressen.
2. Sätt en uttagstransaktion i kö baserat på destination och belopp.
3. Generera de förväntade enhetsuppgifterna för outgoingAmount och det aktuella outgoingAmount + beloppet för uttaget.
4. Behandla kön genom att skapa och sända uttagstransaktionen.
5. Efter en viss tid kontrollerar du om entitetsdata för outgoingAmount har ändrats till det förväntade beloppet.
6. Om så är fallet markerar du uttaget som slutfört, tar bort det från kön och uppdaterar validerade enhetsdata. Om inte, försök på nytt.

Medelstora volymer

1. Använd kommandot SENDMANY SC för att gruppera upp till 25 uttag i en enda transaktion.
2. Tillämpa samma logik som för små volymer, men använd SENDMANY i stället för enkla sändningstransaktioner.
3. En enda adress som använder SENDMANY kan göra cirka 100 uttag per minut.

Stora volymer

1. Använd sendmany-appen för att skicka upp till 15 625 betalningar, som slutförs på cirka 20 ticks (~8000 uttag per minut).
2. Appen sendmany använder SENDMANY SC i en fanout med tre nivåer. Betalningarna specificeras i en .csv-fil, bearbetas för att beräkna det totala beloppet och skickas till en speciell adress.
3. När pengarna anländer fördelas de i tre generationer (25 x 25 x 25 betalningar).

sendmany-förvaret

För detaljer om sendmany-programmet, besök förvaret:

sendmany GitHub-förvar

Slutsats

Att integrera Qubic i befintliga tjänster kräver noggrant övervägande av datahanteringen, särskilt när det gäller monetära transaktioner. Genom att välja lämplig integrationsmetod och förstå de unika aspekterna av Qubic kan tjänsterna effektivt hantera insättningar och uttag i olika skalor.

Läs Qsilvers "Inofficiella" serie

• 🇸🇪Qubic Crypto Detaljer
• 🇸🇪Ett inofficiellt interimistiskt Qubic Whitepaper
• 🇸🇪En inofficiell guide till att skriva Qubic Smart Contracts
• 🇸🇪En inofficiell guide för Qubic Tjänsteintegration

För de senaste uppdateringarna, gå med i Valis Discord, följ oss på X och bokmärk vår blogg.

På denna sida

• En inofficiell guide till integration av Qubic-tjänster
• Introduktion
• Viktiga skillnader med Qubic
• Hantering av insättningar
• Balansbaserad insättningsbehandling
• Behandling av uttag
• Små volymer
• Medelstora volymer
• Stora volymer
• sendmany-förvaret
• Slutsats
• Läs Qsilvers "Inofficiella" serie

Relaterade inlägg