Netzwerkarchitektur des Protokolls
Eine CPP-kompatible Bereitstellung kann viele Gutscheine und Fonds über optionale Register, Indizes, Kursmodule und eine Routensuche auf Anwendungsebene verbinden. Jeder Fonds bleibt ein eigener Tresor mit eigener Liquidität, eigenem Eigentümer, Proxy-Administrator, eigener Konfiguration und eigenen Abhängigkeiten.
Die Grassroots Economics Foundation betreibt die öffentliche App unter cosmolocal.credit. Andere Benutzeroberflächen und Bereitstellungen können dasselbe öffentliche Protokoll verwenden. Der Betrieb der App macht GEF nicht automatisch zum Eigentümer, Herausgeber, zur Fonds-Verantwortlichen, zum Gebührenempfänger oder Garanten für jeden unten dargestellten Vertrag.
Unter Konzepte und Begriffe wird die Trennung zwischen verantwortlichen Rollen und technischen Befugnissen erläutert.
Mögliche Routen und Ausführung
Ein gemeinsamer Vermögenswert schafft einen möglichen Graphpfad, keine garantierte Route. In diesem Beispiel könnte Gutschein A in Fonds A gegen den Brücken-Vermögenswert getauscht werden. Anschließend könnte dieser in Fonds B gegen Gutschein B getauscht werden. Jeder Schritt hängt weiterhin von aktueller Token-Zulassung, Fonds-Grenzen, verfügbaren Beständen, Konfiguration von Kursen und Gebühren, Orakelzustand, Genehmigungen, Transaktionsgrenzen und der Ausführung im Netzwerk ab.
SwapRouter ruft entlang eines vorgeschlagenen Pfads lediglich die Kursfunktionen der Fonds auf. Er hält keine Gelder, genehmigt keine Tokens und führt keine Tausche aus. Eine Integration oder kompatible App kann die Kursangebote nutzen, um geordnete Genehmigungs- und Fonds-Aufrufe in einem signierten Smart-Account-Batch zu erstellen. Das bedeutet nicht, dass die aktuelle öffentliche App eine mehrstufige Ausführung anbietet. Jeder Schritt wird zunächst an die Geldbörse abgewickelt; dieselbe Geldbörse stellt dann den Zwischenwert für den nächsten Fonds bereit. Die Integration kann festlegen, dass der gesamte Batch bei einem fehlgeschlagenen Aufruf zurückgesetzt wird.
Kursangebote sind Momentaufnahmen. Eine erfolgreich berechnete Route kann trotzdem fehlschlagen oder anders abgewickelt werden, wenn sich der maßgebliche Zustand vor der Ausführung ändert. Die begrenzte Variante von SwapPool.withdraw ergänzt für einen einzelnen Schritt den Schutz durch minAmountOut und deadline. Integrationen müssen entscheiden, wie Grenzen auf die gesamte Route angewendet werden.
Fondsgebühren verbleiben zur späteren Einziehung im jeweiligen Fonds. Eine Protokollgebühr kommt zusätzlich hinzu und wird während des Tauschs direkt vom Fonds an den konfigurierten Protokollempfänger übertragen.
Innerer Aufbau eines Fonds
Register, Limiter, Quoter, Gebührenregel und Protokollgebühren-Controller sind optional. Ohne Register besteht jedes Token die Zulassungsprüfung; ohne Limiter sind Einzahlungen unbegrenzt; ohne Quoter verwendet der Fonds Rohwertparität; ohne Gebührenmodule sind die jeweiligen Gebühren null.
Die fünf versiegelbaren Felder sind feePolicy, feeAddress, quoter, tokenRegistry und tokenLimiter. Eine Versiegelung verhindert, dass der aktuelle Fonds-Eigentümer diese Adresse über ihren Setter ersetzt. Sie friert den internen Zustand der Abhängigkeit jedoch nicht ein. Die Adresse protocolFeeController und der Modus feesDecoupled werden von diesen fünf Versiegelungsbits nicht erfasst. Auch die Möglichkeit des Proxy-Administrators, den Fonds zu aktualisieren, ist von der Versiegelung getrennt.
Der Vertragseigentümer kann verfügbare Fondsliquidität an eine gewählte Adresse abheben. Im entkoppelten Gebührenmodus sind aufgelaufene Gebühren von diesem Weg ausgenommen; die Befugnis, die übrige Liquidität abzuheben, bleibt bestehen. Teilnehmer sollten Eigentümer, Proxy-Administrator, Kontrolleure der Abhängigkeiten, Versiegelungszustand, Gebührenempfänger und veröffentlichte Fondsregeln prüfen, bevor sie sich auf einen Fonds verlassen.
Den konzeptionellen Entwurf hinter diesen Verträgen – einschließlich Kuratierung, Bewertung, Begrenzung, Tausch und Governance – beschreibt das Whitepaper.