@sip-protocol/sdk 0.7.3 → 0.8.0

package/src/errors.ts

@@ -31,6 +31,8 @@ export enum ErrorCode {
   INVALID_ADDRESS = 'SIP_2007',
   MISSING_REQUIRED = 'SIP_2008',
   OUT_OF_RANGE = 'SIP_2009',
+  TOKEN_NOT_FOUND = 'SIP_2010',
+  UNSUPPORTED_CHAIN = 'SIP_2011',
 
   // Cryptographic errors (3xxx)
   CRYPTO_FAILED = 'SIP_3000',
@@ -81,6 +83,25 @@ export enum ErrorCode {
   WALLET_CONNECTION_FAILED = 'SIP_7002',
   WALLET_SIGNING_FAILED = 'SIP_7003',
   WALLET_TRANSACTION_FAILED = 'SIP_7004',
+
+  // Security errors (8xxx)
+  SECURITY_ERROR = 'SIP_8000',
+  INVALID_SIGNATURE = 'SIP_8001',
+  INVALID_AUTH = 'SIP_8002',
+  UNAUTHORIZED = 'SIP_8003',
+  RATE_LIMIT_EXCEEDED = 'SIP_8004',
+
+  // Privacy backend errors (9xxx)
+  PRIVACY_BACKEND_ERROR = 'SIP_9000',
+  ARCIUM_ERROR = 'SIP_9001',
+  ARCIUM_INVALID_NETWORK = 'SIP_9002',
+  ARCIUM_COMPUTATION_FAILED = 'SIP_9003',
+  ARCIUM_COMPUTATION_TIMEOUT = 'SIP_9004',
+  ARCIUM_CLUSTER_UNAVAILABLE = 'SIP_9005',
+  ARCIUM_CIRCUIT_NOT_FOUND = 'SIP_9006',
+  INCO_ERROR = 'SIP_9010',
+  MAGICBLOCK_ERROR = 'SIP_9020',
+  SHADOWWIRE_ERROR = 'SIP_9030',
 }
 
 // ─── Serialized Error Type ───────────────────────────────────────────────────
@@ -423,6 +444,60 @@ export class NetworkError extends SIPError {
   }
 }
 
+// ─── Security Error ──────────────────────────────────────────────────────────
+
+/**
+ * Error thrown when security/authentication checks fail
+ *
+ * Used for signature verification, authorization, and rate limiting.
+ *
+ * @example
+ * ```typescript
+ * throw new SecurityError('Invalid webhook signature', 'INVALID_SIGNATURE')
+ *
+ * // With context
+ * throw new SecurityError('Rate limit exceeded', 'RATE_LIMIT_EXCEEDED', {
+ *   context: { limit: 100, window: '1m' }
+ * })
+ * ```
+ */
+export class SecurityError extends SIPError {
+  /** Security error type for programmatic handling */
+  readonly securityType: string
+
+  constructor(
+    message: string,
+    securityType: string = 'SECURITY_ERROR',
+    options?: {
+      cause?: Error
+      context?: Record<string, unknown>
+    }
+  ) {
+    // Map security type to error code
+    let code: ErrorCode
+    switch (securityType) {
+      case 'INVALID_SIGNATURE':
+        code = ErrorCode.INVALID_SIGNATURE
+        break
+      case 'INVALID_AUTH':
+        code = ErrorCode.INVALID_AUTH
+        break
+      case 'UNAUTHORIZED':
+        code = ErrorCode.UNAUTHORIZED
+        break
+      case 'RATE_LIMIT_EXCEEDED':
+        code = ErrorCode.RATE_LIMIT_EXCEEDED
+        break
+      default:
+        code = ErrorCode.SECURITY_ERROR
+    }
+
+    super(message, code, options)
+    this.name = 'SecurityError'
+    this.securityType = securityType
+  }
+}
+
 // ─── Error Utilities ─────────────────────────────────────────────────────────
 
 /**
@@ -432,6 +507,13 @@ export function isSIPError(error: unknown): error is SIPError {
   return error instanceof SIPError
 }
 
+/**
+ * Check if an error is a security error
+ */
+export function isSecurityError(error: unknown): error is SecurityError {
+  return error instanceof SecurityError
+}
+
 /**
  * Check if an error has a specific error code
  */