Fallstudie 03
KYC- / Identitätsprüfungs-SDK für Web3-Unternehmen
Think & Dev / CompilotAI · Frühere Mitarbeit · SDK-Ingenieur
Ein einbettbares Widget zur Identitätsprüfung mit einem wallet-bewussten Sitzungsmodell und On-Chain-Testabdeckung für Web3-Unternehmens-Hosts.
- Form
- Einbettbares Widget
- Sitzung
- Wallet-bewusst
- Abdeckung
- On-Chain + HTTP
Problem
Unternehmens-Hosts brauchten die Identitätsprüfung in ihren eigenen Oberflächen, nicht als Weiterleitung zu einem eigenständigen KYC-Produkt. Die Sitzung musste eine Wallet verstehen, ohne die Wallet zur einzigen Identität zu machen. Die Abdeckung musste den On-Chain-Pfad einschließen, nicht nur den HTTP-Pfad, sonst wäre das Widget als Oberfläche mit einer ungetesteten Vertragskante ausgeliefert worden.
Vorgaben
Das Widget musste sich in eine Host-Anwendung einbetten, ohne deren Routing oder Designsystem zu besitzen. Der Sitzungszustand musste wallet-bewusst und host-sicher bleiben. Smart-Contract-Tests mussten gegen ein öffentliches Testnetz laufen, damit die Abdeckung wiederholbar war. Kein Teil dieses Textes beschreibt die Host-Produkte oder die Oberfläche des Prüf-Anbieters.
Architektur
Ein einbettbares Widget als Next.js-Oberfläche, mit tRPC als typisierter Grenze zwischen dem Widget und seinen Sitzungsdiensten. RainbowKit lieferte die Wallet-Verbindung. Der Host montierte das Widget; das Widget besaß den Prüffluss und die wallet-bewusste Sitzung. Hardhat-Tests übten den Vertragspfad auf Polygon Mumbai, damit die On-Chain-Kante dieselbe Art von Abdeckung hatte wie die HTTP-Kante.
Rolle
Ich habe das einbettbare Widget gebaut, die typisierte Sitzungsgrenze und das wallet-bewusste Sitzungsmodell. Ich habe die Hardhat-Suite im Mumbai-Testnetz ergänzt, damit der Vertragspfad keine ungetestete Fußnote blieb.
Ergebnisse
- Hosts konnten die Prüfung einbetten, ohne Nutzer durch eine separate Produktoberfläche zu schicken.
- Der Sitzungszustand blieb wallet-bewusst, ohne Identität auf eine einzelne Adresse zu reduzieren.
- Die On-Chain-Testabdeckung saß neben den Anwendungstests, statt in einem separaten, optionalen Repo zu leben.
Stack
- Next.js
- tRPC
- RainbowKit
- Hardhat
- Polygon Mumbai
- TypeScript
