Initial project setup: Add contracts, API definitions, tests, and documentation

- Add Foundry project configuration (foundry.toml, foundry.lock)
- Add Solidity contracts (TokenFactory138, BridgeVault138, ComplianceRegistry, etc.)
- Add API definitions (OpenAPI, GraphQL, gRPC, AsyncAPI)
- Add comprehensive test suite (unit, integration, fuzz, invariants)
- Add API services (REST, GraphQL, orchestrator, packet service)
- Add documentation (ISO20022 mapping, runbooks, adapter guides)
- Add development tools (RBC tool, Swagger UI, mock server)
- Update OpenZeppelin submodules to v5.0.0

api/shared/events/event-bus.ts

@@ -0,0 +1,70 @@
+/**
+ * Event bus client for publishing and subscribing to events
+ * Supports Kafka and NATS
+ */
+
+import { EventEmitter } from 'events';
+
+export interface EventEnvelope {
+  eventId: string;
+  eventType: string;
+  occurredAt: string;
+  actorRef?: string;
+  correlationId?: string;
+  payload: any;
+  signatures?: Array<{ signer: string; signature: string }>;
+}
+
+export class EventBusClient extends EventEmitter {
+  private kafkaClient: any;
+  private natsClient: any;
+  private subscribers: Map<string, Set<(data: any) => void>> = new Map();
+
+  constructor(config: { kafka?: any; nats?: any }) {
+    super();
+    // TODO: Initialize Kafka or NATS client based on config
+  }
+
+  /**
+   * Publish an event to the event bus
+   */
+  async publish(topic: string, event: EventEnvelope): Promise<void> {
+    // TODO: Publish to Kafka or NATS
+    // Validate event schema before publishing
+    this.emit('published', { topic, event });
+  }
+
+  /**
+   * Subscribe to events from a topic
+   */
+  subscribe(topic: string): AsyncIterator<any> {
+    // TODO: Return async iterator for GraphQL subscriptions
+    const iterator = this.createAsyncIterator(topic);
+    return iterator;
+  }
+
+  private createAsyncIterator(topic: string): AsyncIterator<any> {
+    // TODO: Create async iterator that yields events from topic
+    return {
+      async next() {
+        // TODO: Wait for next event from topic
+        return { done: false, value: null };
+      },
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+    };
+  }
+
+  /**
+   * Close connections
+   */
+  async close(): Promise<void> {
+    // TODO: Close Kafka/NATS connections
+  }
+}
+
+export const eventBusClient = new EventBusClient({
+  // TODO: Load config from environment
+});
+

api/shared/events/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@emoney/events",
+  "version": "1.0.0",
+  "description": "Event bus client for eMoney API",
+  "main": "event-bus.js",
+  "types": "event-bus.d.ts",
+  "dependencies": {
+    "kafkajs": "^2.2.4",
+    "nats": "^2.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}
+

api/shared/events/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["*.ts"],
+  "exclude": ["node_modules", "dist"]
+}
+