Standard

Implementierungen

Was als Implementierung von A-REX Core gilt, welche Implementierungen gelistet sind, was eine Konformitätsaussage besagt und wie eine Implementierung in die Liste aufgenommen wird.

Was eine Implementierung ist

Eine Implementierung ist Software, die andere am Standard prüfen können. Sie hat eine von vier Formen:

ein Chargen-Token, der die Schnittstellen des Standards implementiert;
ein Hook: ein Regelvertrag, der IARexHook implementiert und viele Token bedienen kann;
ein Attestierungsregister: ein Begleitvertrag, der IARexAttest für einen bestehenden Token implementiert;
eine Plattform, die Token für andere betreibt, auf einer eigenen Implementierung oder auf der unverändert bereitgestellten Referenzimplementierung.

Wallets, Explorer, Indexer und andere Werkzeuge, die A-REX-Token nur lesen, können ebenfalls gelistet werden, haben aber nichts, dem sie entsprechen müssten.

Die Referenzimplementierung ist arex-contracts unter der MIT-Lizenz. Sie enthält den Token und sein Attestierungsregister (ARexToken und ARexAttestations), Beispiel-Regelverträge und die Konformitätssuite. Sie zeigt, dass sich der Standard implementieren lässt; sie ist nicht der Standard, und eine Implementierung muss ihren Code nicht wiederverwenden. Solange die Repositories privat sind, wird sie zusammen mit dem Standard über Frühen Zugang anfragen geteilt.

Gelistete Implementierungen

Die Liste folgt ADOPTERS.md im Repository des Standards, das maßgeblich ist. Die Zeilen stehen in alphabetischer Reihenfolge, und jede wird zu denselben Bedingungen gelistet.

Organisation	Rolle	Implementierung	Chain	Status	Kontakt
A-REX Foundation: A-REX Platform	`platform`	betreibt Token für Unternehmen mit der Referenzimplementierung, unverändert aus ihren Releases bereitgestellt	noch nicht in einem öffentlichen Netzwerk	`in development`	[email protected]

Die A-REX Foundation pflegt auch die Spezifikation und die Referenzimplementierung, daher ist A-REX Platform kein unabhängiger Implementierer: Sie zählt nicht für die Zwei-Implementierer-Regel, die Änderungen am Standard regelt. Noch ist kein unabhängiger Implementierer gelistet.

Die Rollen sind issuer, warehouse, lab, platform (betreibt Token für andere), wallet und indexer. Die Status sind planned, in development, pilot (echte Chargen, begrenzter Umfang), production, conformant (besteht die Konformitätssuite, mit verlinktem Bericht) und retired.

Was Konformität bedeutet

Die Konformität wird mit der Konformitätssuite geprüft, die mit der Referenzimplementierung ausgeliefert wird. Die Suite erreicht eine Implementierung nur über die Schnittstellen des Standards und einen kleinen Adapter, den ihre Autoren schreiben, und prüft deshalb jede Implementierung auf dieselbe Weise. Jeder Test nennt die Klausel, die er prüft: 87 Klauseln, 74 auf MUSS-Ebene und 13 auf SOLLTE-Ebene. Ein Lauf endet mit einem von drei Ergebnissen:

Ergebnis	Bedeutung
`CONFORMANT`	jede MUSS-Klausel ist erfüllt
`CONFORMANT (with skipped MUST clauses)`	keine MUSS-Klausel schlägt fehl, aber einige wurden übersprungen, weil die Implementierung nicht bietet, was sie brauchen
`NOT CONFORMANT`	mindestens eine MUSS-Klausel schlägt fehl

Nicht erfüllte SOLLTE-Klauseln werden gemeldet und ändern das Ergebnis nicht.

Eine Konformitätsaussage nennt die Version von A-REX Core, das Profil, die Version oder den Commit der Suite und das Datum des Laufs. Sie wird mit dem unbearbeiteten Bericht, dem geprüften Commit oder den geprüften bereitgestellten Adressen, den nicht erfüllten SOLLTE-Klauseln und jeder beabsichtigten Abweichung veröffentlicht und muss jede übersprungene MUSS-Klausel begründen. Eine Aussage gilt für eine Version des Standards: Sie wird nach einem Upgrade und für jede neue Hauptversion erneut geprüft.

Ein Bericht ist ein Nachweis dafür, wie sich eine Implementierung bei den Klauseln verhalten hat, die die Suite prüft. Klauseln, die sich on-chain nicht beobachten lassen, etwa die Regel, dass die Herkunftsreferenz keine personenbezogenen Daten enthält, bleiben der Prüfung durch Menschen überlassen; ein Bericht deckt daher nicht alles ab, was der Standard verlangt.

Eine Listung ist keine Empfehlung

Eine Zeile hält fest, was eine Organisation über ihre eigene Implementierung angibt. Sie ist keine Empfehlung, keine Zertifizierung und kein Audit der A-REX Foundation oder der Editoren des Standards, und es gibt weder eine kostenpflichtige Zertifizierung noch eine Gebühr. Der Status conformant stützt sich auf den veröffentlichten Bericht, der in der Zeile verlinkt ist; die Editoren können verlangen, dass eine Aussage korrigiert oder zurückgezogen wird, wenn der Bericht sie nicht trägt. Eine Zeile, deren Kontakt sechs Monate lang nicht antwortet oder deren Links nicht mehr funktionieren, kann nach Ankündigung als retired markiert werden.

So wird eine Implementierung gelistet

Öffnen Sie einen Pull Request, der ADOPTERS.md im Repository des Standards eine Zeile mit den Spalten der Tabelle oben hinzufügt. Solange das Repository privat ist, beantragen Sie zuerst Zugang unter Frühen Zugang anfragen.
Geben Sie einen Kontakt an, der antwortet. Gelistete Implementierer werden gebeten, vorgeschlagenen Änderungen am Standard zuzustimmen oder ihnen zu widersprechen.
Für den Status conformant verlinken Sie den Bericht Ihrer Konformitätsaussage.
Um als unabhängiger Implementierer zu zählen, erklären Sie im Pull Request, dass Ihre Organisation für diese Arbeit weder von der A-REX Foundation noch von einem anderen gelisteten Implementierer kontrolliert oder bezahlt wird.

Unabhängige Implementierer tragen die Zwei-Implementierer-Regel: Eine kleinere Änderung wird angenommen, wenn zwei von ihnen bestätigen, dass sie sie übernehmen können, und eine größere Änderung, wenn zwei von ihnen sie implementiert haben und damit die Konformitätssuite bestehen. Solange es keine zwei gibt, werden angenommene Änderungen als vorläufig gekennzeichnet.