Error Codes
Complete reference for SHIELD errors.API Errors
Authentication
| Code | Message | HTTP | Resolution |
|---|---|---|---|
AUTH_001 | ”No session token” | 401 | Sign in with wallet |
AUTH_002 | ”Invalid token” | 401 | Re-authenticate |
AUTH_003 | ”Token expired” | 401 | Sign in again |
AUTH_004 | ”SIWE verification failed” | 401 | Check signature |
AUTH_005 | ”Nonce expired” | 401 | Get new nonce |
Policy Errors
| Code | Message | HTTP | Resolution |
|---|---|---|---|
POL_001 | ”Policy not found” | 404 | Check policyId |
POL_002 | ”Policy expired” | 410 | Request new link |
POL_003 | ”Max attempts reached” | 403 | Link no longer valid |
POL_004 | ”Policy revoked” | 403 | Contact sender |
POL_005 | ”Policy already exists” | 409 | Generate new policyId |
POL_006 | ”Unauthorized recipient” | 403 | Use correct wallet |
Validation
| Code | Message | HTTP | Resolution |
|---|---|---|---|
VAL_001 | ”Invalid policyId format” | 400 | Must be 0x + 64 hex |
VAL_002 | ”Invalid CID format” | 400 | Must be Qm… or bafy… |
VAL_003 | ”Invalid address” | 400 | Check Ethereum address |
VAL_004 | ”Expiry must be future” | 400 | Set later timestamp |
VAL_005 | ”Max attempts must be > 0” | 400 | Set positive number |
Rate Limiting
| Code | Message | HTTP | Resolution |
|---|---|---|---|
RATE_001 | ”Rate limit exceeded” | 429 | Wait and retry |
Server
| Code | Message | HTTP | Resolution |
|---|---|---|---|
SRV_001 | ”Internal server error” | 500 | Contact support |
SRV_002 | ”Database connection failed” | 500 | Try again later |
SRV_003 | ”IPFS upload failed” | 502 | Check Pinata status |
Contract Errors
Reverted with reason string:| Message | Meaning | When |
|---|---|---|
| ”Policy already exists” | policyId taken | createPolicy |
| ”Policy does not exist” | Invalid policyId | logAttempt |
| ”Policy is not valid” | valid flag false | logAttempt |
| ”Only the recipient can log an attempt” | Wrong caller | logAttempt |
| ”Policy has expired” | expiry passed | logAttempt |
| ”Max attempts reached” | No attempts left | logAttempt |
Wallet Errors
MetaMask
| Code | Message | Solution |
|---|---|---|
| 4001 | User rejected | Approve in wallet |
| -32603 | Internal error | Check gas settings |
| -32000 | Gas estimation failed | Increase gas limit |
WalletConnect
| Code | Message | Solution |
|---|---|---|
| WC_001 | Session expired | Reconnect wallet |
| WC_002 | Chain not supported | Switch to Base |
Decryption Errors
| Error | Cause | Solution |
|---|---|---|
| ”Decryption failed” | Wrong key | Check URL fragment |
| ”Invalid ciphertext” | Corrupted data | Re-download from IPFS |
| ”Authentication failed” | Tampered data | Content may be corrupted |
Network Errors
| Error | Cause | Solution |
|---|---|---|
| ”Failed to fetch” | Network issue | Check connection |
| ”CORS error” | Misconfiguration | Contact support |
| ”Timeout” | Slow response | Retry later |
Troubleshooting Flow
Contact Support
If error persists:- Email: shieldencrypted@gmail.com
- Include: error code, timestamp, wallet address