@sip-protocol/sdk 0.7.3 → 0.8.0

package/src/privacy-backends/index.ts

@@ -34,10 +34,21 @@
  *
  * ## Available Backends
  *
+ * ### Transaction Privacy (hide sender/amount/recipient)
  * - **SIPNativeBackend** — Stealth addresses + Pedersen commitments
  * - **PrivacyCashBackend** — Pool mixing (Tornado Cash-style anonymity sets)
- * - **ArciumBackend** — MPC compute privacy (coming in #481)
- * - **IncoBackend** — FHE compute privacy (coming in #482)
+ * - **ShadowWireBackend** — Pedersen Commitments + Bulletproofs (Radr Labs)
+ *
+ * ### Compute Privacy (hide contract execution)
+ * - **ArciumBackend** — MPC (Multi-Party Computation)
+ * - **IncoBackend** — FHE (Fully Homomorphic Encryption)
+ *
+ * ### TEE Privacy (hardware-based)
+ * - **MagicBlockBackend** — Intel TDX TEE (Ephemeral Rollups)
+ *
+ * ### Confidential Tokens
+ * - **CSPLClient** — C-SPL (Confidential SPL) token operations
+ * - **PrivateSwap** — Full privacy swaps (SIP + C-SPL + Arcium)
  *
  * @module privacy-backends
  */
@@ -56,14 +67,106 @@ export type {
   BackendSelectionResult,
   BackendRegistrationOptions,
   RegisteredBackend,
+  // Compute privacy types
+  CipherType,
+  ComputationStatus,
+  ComputationParams,
+  ComputationResult,
+  BackendParams,
+  // Health & circuit breaker types
+  CircuitState,
+  BackendHealthState,
+  BackendMetrics,
+  CircuitBreakerConfig,
+  // Versioning types
+  PrivacyBackendVersion,
+  VersionValidationResult,
+} from './interface'
+
+// Type guards
+export { isComputationParams, isTransferParams } from './interface'
+
+// Versioning utilities
+export {
+  CURRENT_BACKEND_VERSION,
+  MIN_SUPPORTED_VERSION,
+  validateBackendVersion,
+  getBackendVersion,
+  backendSupportsVersion,
+  isV2Backend,
+  warnIfDeprecatedVersion,
+} from './interface'
+
+// Error types
+export {
+  AllBackendsFailedError,
+  CircuitOpenError,
+  ComputationTimeoutError,
+  UnsupportedVersionError,
+  DEFAULT_CIRCUIT_BREAKER_CONFIG,
 } from './interface'
 
+// Timeout utilities
+export { withTimeout } from './interface'
+
+// Utilities
+export { deepFreeze } from './interface'
+export {
+  LRUCache,
+  DEFAULT_CACHE_SIZES,
+  DEFAULT_CACHE_TTL,
+  type LRUCacheConfig,
+  type LRUCacheStats,
+} from './lru-cache'
+
+// Health tracking
+export { BackendHealthTracker } from './health'
+
+// Rate limiting
+export {
+  RateLimiter,
+  DEFAULT_RATE_LIMIT_CONFIG,
+  RateLimitExceededError,
+  QueueFullError,
+  AcquireTimeoutError,
+  type RateLimitConfig,
+  type RateLimiterConfig,
+  type AcquireOptions,
+  type RateLimitStats,
+} from './rate-limiter'
+
 // Registry
-export { PrivacyBackendRegistry, defaultRegistry } from './registry'
+export {
+  PrivacyBackendRegistry,
+  defaultRegistry,
+  type PrivacyBackendRegistryConfig,
+} from './registry'
 
-// Backends
+// Transaction Backends
 export { SIPNativeBackend, type SIPNativeBackendConfig } from './sip-native'
 export { PrivacyCashBackend, type PrivacyCashBackendConfig } from './privacycash'
+export {
+  ShadowWireBackend,
+  createShadowWireBackend,
+  SHADOWWIRE_TOKEN_MINTS,
+  type ShadowWireBackendConfig,
+} from './shadowwire'
+
+// Mock Backend (for testing)
+export { MockBackend, createMockFactory, type MockBackendConfig } from './mock'
+
+// Compute Backends
+export { ArciumBackend, type ArciumBackendConfig } from './arcium'
+export { IncoBackend, type IncoBackendConfig } from './inco'
+
+// TEE Backend (Hardware-based Privacy)
+export {
+  MagicBlockBackend,
+  createMagicBlockBackend,
+  MAGICBLOCK_ENDPOINTS,
+  type MagicBlockBackendConfig,
+  type MagicBlockNetwork,
+} from './magicblock'
 
 // PrivacyCash types (for advanced usage)
 export {
@@ -82,5 +185,152 @@ export {
   type IPrivacyCashSDK,
 } from './privacycash-types'
 
+// Arcium types (for advanced usage)
+export {
+  ARCIUM_CLUSTERS,
+  ARCIUM_PROGRAM_IDS,
+  DEFAULT_COMPUTATION_TIMEOUT_MS,
+  ESTIMATED_COMPUTATION_TIME_MS,
+  BASE_COMPUTATION_COST_LAMPORTS,
+  COST_PER_ENCRYPTED_INPUT_LAMPORTS,
+  COST_PER_INPUT_KB_LAMPORTS,
+  BYTES_PER_KB,
+  SOLANA_SLOT_TIME_MS,
+  // New DEFAULT_* constants (preferred)
+  DEFAULT_MAX_ENCRYPTED_INPUTS,
+  DEFAULT_MAX_INPUT_SIZE_BYTES,
+  DEFAULT_MAX_TOTAL_INPUT_SIZE_BYTES,
+  DEFAULT_MAX_COMPUTATION_COST_LAMPORTS,
+  // Deprecated aliases (backward compatibility)
+  MAX_ENCRYPTED_INPUTS,
+  MAX_INPUT_SIZE_BYTES,
+  MAX_TOTAL_INPUT_SIZE_BYTES,
+  MAX_COMPUTATION_COST_LAMPORTS,
+  // Error handling
+  ArciumError,
+  isArciumError,
+  type ArciumErrorCode,
+  // Environment variable configuration
+  ARCIUM_ENV_VARS,
+  DEFAULT_RPC_ENDPOINTS,
+  getEnvVar,
+  resolveRpcUrl,
+  resolveNetwork,
+  resolveTimeout,
+  resolveCluster,
+  type ArciumNetwork,
+  type ArciumConfig,
+  type ArciumCluster,
+  type ArciumCircuit,
+  type SubmitComputationParams,
+  type ComputationOutput,
+  type ComputationInfo,
+  type EncryptionResult,
+  type DecryptionResult,
+  type IArciumClient,
+  type IArciumReader,
+  type ArciumLimitsConfig,
+  type ArciumLimitsResolved,
+} from './arcium-types'
+
+// Inco types (for advanced usage)
+export {
+  INCO_RPC_URLS,
+  INCO_CHAIN_IDS,
+  INCO_SUPPORTED_CHAINS,
+  DEFAULT_FHE_TIMEOUT_MS,
+  ESTIMATED_FHE_TIME_MS,
+  BASE_FHE_COST_WEI,
+  COST_PER_ENCRYPTED_INPUT_WEI,
+  type IncoNetwork,
+  type IncoProduct,
+  type EncryptedType,
+  type EncryptedValue,
+  type EncryptParams,
+  type DecryptParams,
+  type DecryptResult,
+  type SubmitFHEParams,
+  type FHEComputationInfo,
+  type AttestationType,
+  type AttestationRequest,
+  type AttestationResult,
+  type IIncoClient,
+  type IncoConfig,
+} from './inco-types'
+
+// C-SPL (Confidential SPL) types and client
+export {
+  CSPLClient,
+  type CSPLClientConfig,
+  type CSPLCacheConfig,
+  type CSPLCacheStats,
+} from './cspl'
+export {
+  CSPL_TOKENS,
+  CSPL_PROGRAM_IDS,
+  CSPL_OPERATION_COSTS,
+  CSPL_OPERATION_TIMES,
+  DEFAULT_SWAP_SLIPPAGE_BPS,
+  MAX_PENDING_TRANSFERS,
+  type CSPLToken,
+  type ConfidentialTokenAccount,
+  type ConfidentialBalance,
+  type ConfidentialTransferParams,
+  type ConfidentialTransferResult,
+  type WrapTokenParams,
+  type WrapTokenResult,
+  type UnwrapTokenParams,
+  type UnwrapTokenResult,
+  type ConfidentialSwapParams,
+  type ConfidentialSwapResult,
+  type ConfidentialPool,
+  type CSPLEncryptionParams,
+  type CSPLDecryptionParams,
+  type EncryptedAmount,
+  type CSPLEncryptionType,
+  type CSPLAuditorConfig,
+  type CSPLAuditorPermission,
+  type CompliantTransferParams,
+  type ICSPLClient,
+} from './cspl-types'
+
+// Private Swap (SIP Native + C-SPL + Arcium integration)
+export {
+  PrivateSwap,
+  type PrivateSwapConfig,
+  type PrivateSwapParams,
+  type PrivateSwapResult,
+  type PrivateSwapStep,
+} from './private-swap'
+
+// C-SPL Token Service (higher-level wrapper)
+export {
+  CSPLTokenService,
+  type CSPLTokenServiceConfig,
+  type WrapParams,
+  type WrapResult,
+  type UnwrapParams,
+  type UnwrapResult,
+  type ApproveParams,
+  type ApproveResult,
+  type CSPLServiceStatus,
+} from './cspl-token'
+
+// Combined Privacy Service (SIP Native + C-SPL integration)
+export {
+  CombinedPrivacyService,
+  createCombinedPrivacyServiceDevnet,
+  createCombinedPrivacyServiceMainnet,
+  type CombinedPrivacyServiceConfig,
+  type CombinedTransferParams,
+  type CombinedTransferResult,
+  type StealthAddressResult,
+  type ClaimParams,
+  type ClaimResult,
+  type CostBreakdown,
+  type PrivacyComparison,
+  type ServiceStatus,
+} from './combined-privacy'
+
 // Router
 export { SmartRouter } from './router'