@yallet/rwa-sdk 0.2.0

package/src/registry.ts

@@ -0,0 +1,236 @@
+/**
+ * Yallet RWA SDK - User Registry Module
+ *
+ * Manages registered users with their xidentity public keys
+ */
+
+import type { RegisteredUser, UserRegistry } from './types.js';
+
+// ======================================
+//  In-Memory Registry (For Development)
+// ======================================
+
+/**
+ * Simple in-memory user registry
+ * For production, implement a database-backed registry
+ */
+export class InMemoryRegistry implements UserRegistry {
+  private users: Map<string, RegisteredUser> = new Map();
+
+  async getUser(solanaAddress: string): Promise<RegisteredUser | null> {
+    return this.users.get(solanaAddress) || null;
+  }
+
+  async registerUser(user: RegisteredUser): Promise<void> {
+    this.users.set(user.solanaAddress, {
+      ...user,
+      registeredAt: user.registeredAt || Date.now(),
+    });
+  }
+
+  async updateUser(
+    solanaAddress: string,
+    updates: Partial<RegisteredUser>
+  ): Promise<void> {
+    const existing = this.users.get(solanaAddress);
+    if (!existing) {
+      throw new Error(`User not found: ${solanaAddress}`);
+    }
+    this.users.set(solanaAddress, { ...existing, ...updates });
+  }
+
+  async deleteUser(solanaAddress: string): Promise<void> {
+    this.users.delete(solanaAddress);
+  }
+
+  async listUsers(): Promise<RegisteredUser[]> {
+    return Array.from(this.users.values());
+  }
+}
+
+// ======================================
+//  HTTP Registry (For Production)
+// ======================================
+
+export interface HTTPRegistryConfig {
+  /** Base URL of the registry API */
+  baseUrl: string;
+  /** API key for authentication */
+  apiKey?: string;
+  /** Custom headers */
+  headers?: Record<string, string>;
+}
+
+/**
+ * HTTP-backed user registry
+ * Connects to a backend API for user management
+ */
+export class HTTPRegistry implements UserRegistry {
+  private config: HTTPRegistryConfig;
+
+  constructor(config: HTTPRegistryConfig) {
+    this.config = config;
+  }
+
+  private async fetch<T>(
+    path: string,
+    options: RequestInit = {}
+  ): Promise<T> {
+    const url = `${this.config.baseUrl}${path}`;
+
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      ...this.config.headers,
+    };
+
+    if (this.config.apiKey) {
+      headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+    }
+
+    const response = await fetch(url, {
+      ...options,
+      headers: { ...headers, ...options.headers },
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Registry API error: ${response.status} - ${error}`);
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  async getUser(solanaAddress: string): Promise<RegisteredUser | null> {
+    try {
+      return await this.fetch<RegisteredUser>(
+        `/users/${encodeURIComponent(solanaAddress)}`
+      );
+    } catch (err) {
+      if (err instanceof Error && err.message.includes('404')) {
+        return null;
+      }
+      throw err;
+    }
+  }
+
+  async registerUser(user: RegisteredUser): Promise<void> {
+    await this.fetch('/users', {
+      method: 'POST',
+      body: JSON.stringify(user),
+    });
+  }
+
+  async updateUser(
+    solanaAddress: string,
+    updates: Partial<RegisteredUser>
+  ): Promise<void> {
+    await this.fetch(`/users/${encodeURIComponent(solanaAddress)}`, {
+      method: 'PATCH',
+      body: JSON.stringify(updates),
+    });
+  }
+
+  async deleteUser(solanaAddress: string): Promise<void> {
+    await this.fetch(`/users/${encodeURIComponent(solanaAddress)}`, {
+      method: 'DELETE',
+    });
+  }
+
+  async listUsers(): Promise<RegisteredUser[]> {
+    return this.fetch<RegisteredUser[]>('/users');
+  }
+}
+
+// ======================================
+//  Registry Factory
+// ======================================
+
+export type RegistryType = 'memory' | 'http';
+
+export interface RegistryOptions {
+  type: RegistryType;
+  httpConfig?: HTTPRegistryConfig;
+}
+
+/**
+ * Create a user registry instance
+ *
+ * @param options - Registry options
+ * @returns UserRegistry instance
+ */
+export function createRegistry(options: RegistryOptions): UserRegistry {
+  switch (options.type) {
+    case 'memory':
+      return new InMemoryRegistry();
+    case 'http':
+      if (!options.httpConfig) {
+        throw new Error('httpConfig is required for HTTP registry');
+      }
+      return new HTTPRegistry(options.httpConfig);
+    default:
+      throw new Error(`Unknown registry type: ${options.type}`);
+  }
+}
+
+// ======================================
+//  Validation Helpers
+// ======================================
+
+/**
+ * Validate a Solana address
+ *
+ * @param address - Address to validate
+ * @returns true if valid
+ */
+export function isValidSolanaAddress(address: string): boolean {
+  // Basic validation: 32-44 characters, base58
+  const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+  return base58Regex.test(address);
+}
+
+/**
+ * Validate an xidentity public key (base64)
+ *
+ * @param xidentity - xidentity to validate
+ * @returns true if valid
+ */
+export function isValidXidentity(xidentity: string): boolean {
+  // Check if it's valid base64
+  try {
+    const decoded = atob(xidentity);
+    // X25519 public key should be 32 bytes
+    return decoded.length === 32;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Validate a registered user
+ *
+ * @param user - User to validate
+ * @returns Validation result
+ */
+export function validateUser(user: Partial<RegisteredUser>): {
+  valid: boolean;
+  errors: string[];
+} {
+  const errors: string[] = [];
+
+  if (!user.solanaAddress) {
+    errors.push('solanaAddress is required');
+  } else if (!isValidSolanaAddress(user.solanaAddress)) {
+    errors.push('Invalid Solana address format');
+  }
+
+  if (!user.xidentity) {
+    errors.push('xidentity is required');
+  } else if (!isValidXidentity(user.xidentity)) {
+    errors.push('Invalid xidentity format (must be base64-encoded 32-byte key)');
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+  };
+}