@sip-protocol/sdk 0.7.1 → 0.7.3

package/dist/index.mjs

@@ -1,6 +1,8 @@
 import {
   ATTESTATION_VERSION,
   AptosStealthService,
+  AttestationGatedDisclosure,
+  AttestationSchema,
   AuditorKeyDerivation,
   AuditorType,
   BaseWalletAdapter,
@@ -19,6 +21,7 @@ import {
   HardwareWalletError,
   IntentBuilder,
   IntentStatus,
+  KNOWN_EXCHANGES,
   LedgerWalletAdapter,
   MockEthereumAdapter,
   MockLedgerAdapter,
@@ -38,12 +41,14 @@ import {
   OneClickSwapType,
   PaymentBuilder,
   PaymentStatus,
+  PrivacyBackendRegistry,
   PrivacyLevel,
   PrivateNFT,
   PrivateVoting,
   ProposalStatus,
   ReportStatus,
   SIP,
+  SIPNativeBackend,
   SIP_VERSION,
   STABLECOIN_ADDRESSES,
   STABLECOIN_DECIMALS,
@@ -52,9 +57,11 @@ import {
   SettlementRegistry,
   SettlementRegistryError,
   SmartRouter,
+  SmartRouter2,
   SolanaSameChainExecutor,
   SolanaWalletAdapter,
   SuiStealthService,
+  SurveillanceAnalyzer,
   SwapStatus,
   ThresholdViewingKey,
   Treasury,
@@ -70,10 +77,14 @@ import {
   addBlindings,
   addCommitments,
   addOracle,
+  analyzeAddressReuse,
+  analyzeTemporalPatterns,
   aptosAddressToAuthKey,
   attachProofs,
   base58ToHex,
   bytesToHex,
+  calculatePrivacyScore,
+  calculateSIPComparison,
   checkAptosStealthAddress,
   checkSuiStealthAddress,
   commit,
@@ -84,6 +95,7 @@ import {
   createEthereumAdapter,
   createKeySpendOnlyOutput,
   createLedgerAdapter,
+  createMockAttestation,
   createMockEthereumAdapter,
   createMockEthereumProvider,
   createMockLedgerAdapter,
@@ -105,6 +117,7 @@ import {
   createShieldedPayment,
   createSmartRouter,
   createSolanaAdapter,
+  createSurveillanceAnalyzer,
   createTaprootOutput,
   createTrezorAdapter,
   createWalletFactory,
@@ -115,6 +128,7 @@ import {
   decodeTaprootAddress,
   decryptMemo,
   decryptWithViewing,
+  defaultRegistry,
   deriveAptosStealthPrivateKey,
   deriveOracleId,
   deriveSuiStealthPrivateKey,
@@ -122,12 +136,15 @@ import {
   deserializeAttestationMessage,
   deserializeIntent,
   deserializePayment,
+  detectClusters,
   detectEthereumWallets,
+  detectExchangeExposure,
   detectSolanaWallets,
   ed25519PublicKeyToAptosAddress,
   ed25519PublicKeyToSuiAddress,
   encryptForViewing,
   featureNotSupportedError,
+  fetchAttestation,
   formatStablecoinAmount,
   fromHex,
   fromStablecoinUnits,
@@ -210,20 +227,25 @@ import {
   trackPayment,
   updateOracleStatus,
   verifyAttestation,
+  verifyAttestationSignature,
   verifyCommitment,
   verifyOpening,
   verifyOracleSignature,
   verifyOwnership,
   walletRegistry
-} from "./chunk-G33LB27A.mjs";
+} from "./chunk-3M3HNQCW.mjs";
 import {
   ProofGenerationError
 } from "./chunk-HOR7PM3M.mjs";
 import {
+  GenericProvider,
+  HeliusProvider,
   checkEd25519StealthAddress,
   checkStealthAddress,
   claimStealthPayment,
   createAnnouncementMemo,
+  createProvider,
+  createWebhookHandler,
   decodeStealthMetaAddress,
   deriveEd25519StealthPrivateKey,
   deriveStealthPrivateKey,
@@ -256,6 +278,7 @@ import {
   isValidStealthMetaAddress,
   nearAddressToEd25519PublicKey,
   parseAnnouncement,
+  processWebhookTransaction,
   publicKeyToEthAddress,
   scanForPayments,
   secureWipe,
@@ -270,7 +293,7 @@ import {
   validateViewingKey,
   withSecureBuffer,
   withSecureBufferSync
-} from "./chunk-L2K34JCU.mjs";
+} from "./chunk-2XIVXWHA.mjs";
 import {
   CryptoError,
   EncryptionNotImplementedError,
@@ -301,6 +324,8 @@ import "./chunk-UJCSKKID.mjs";
 export {
   ATTESTATION_VERSION,
   AptosStealthService,
+  AttestationGatedDisclosure,
+  AttestationSchema,
   AuditorKeyDerivation,
   AuditorType,
   BaseWalletAdapter,
@@ -318,11 +343,14 @@ export {
   ErrorCode,
   EthereumChainId,
   EthereumWalletAdapter,
+  GenericProvider,
   HardwareErrorCode,
   HardwareWalletError,
+  HeliusProvider,
   IntentBuilder,
   IntentError,
   IntentStatus,
+  KNOWN_EXCHANGES,
   LedgerWalletAdapter,
   MEMO_PROGRAM_ID,
   MockEthereumAdapter,
@@ -344,7 +372,9 @@ export {
   OneClickSwapType,
   PaymentBuilder,
   PaymentStatus,
+  PrivacyBackendRegistry,
   PrivacyLevel,
+  SmartRouter2 as PrivacySmartRouter,
   PrivateNFT,
   PrivateVoting,
   ProofError,
@@ -354,6 +384,7 @@ export {
   ReportStatus,
   SIP,
   SIPError,
+  SIPNativeBackend,
   SIP_MEMO_PREFIX,
   SIP_VERSION,
   SOLANA_EXPLORER_URLS,
@@ -370,6 +401,7 @@ export {
   SolanaSameChainExecutor,
   SolanaWalletAdapter,
   SuiStealthService,
+  SurveillanceAnalyzer,
   SwapStatus,
   ThresholdViewingKey,
   Treasury,
@@ -386,11 +418,15 @@ export {
   addBlindings,
   addCommitments,
   addOracle,
+  analyzeAddressReuse,
+  analyzeTemporalPatterns,
   aptosAddressToAuthKey,
   attachProofs,
   base58ToHex,
   bytesToHex as browserBytesToHex,
   hexToBytes as browserHexToBytes,
+  calculatePrivacyScore,
+  calculateSIPComparison,
   checkAptosStealthAddress,
   checkEd25519StealthAddress,
   checkStealthAddress,
@@ -405,6 +441,7 @@ export {
   createEthereumAdapter,
   createKeySpendOnlyOutput,
   createLedgerAdapter,
+  createMockAttestation,
   createMockEthereumAdapter,
   createMockEthereumProvider,
   createMockLedgerAdapter,
@@ -419,6 +456,7 @@ export {
   createPrivateOwnership,
   createPrivateVoting,
   createProductionSIP,
+  createProvider,
   createSIP,
   createSameChainExecutor,
   createSealedBidAuction,
@@ -426,9 +464,11 @@ export {
   createShieldedPayment,
   createSmartRouter,
   createSolanaAdapter,
+  createSurveillanceAnalyzer,
   createTaprootOutput,
   createTrezorAdapter,
   createWalletFactory,
+  createWebhookHandler,
   createZcashClient,
   createZcashNativeBackend,
   createZcashShieldedService,
@@ -437,6 +477,7 @@ export {
   decodeTaprootAddress,
   decryptMemo,
   decryptWithViewing,
+  defaultRegistry,
   deriveAptosStealthPrivateKey,
   deriveEd25519StealthPrivateKey,
   deriveOracleId,
@@ -446,7 +487,9 @@ export {
   deserializeAttestationMessage,
   deserializeIntent,
   deserializePayment,
+  detectClusters,
   detectEthereumWallets,
+  detectExchangeExposure,
   detectSolanaWallets,
   ed25519PublicKeyToAptosAddress,
   ed25519PublicKeyToNearAddress,
@@ -456,6 +499,7 @@ export {
   encryptForViewing,
   estimatePrivateTransferFee,
   featureNotSupportedError,
+  fetchAttestation,
   formatStablecoinAmount,
   fromHex,
   fromStablecoinUnits,
@@ -540,6 +584,7 @@ export {
   normalizeSuiAddress,
   notConnectedError,
   parseAnnouncement,
+  processWebhookTransaction,
   proveOwnership,
   publicKeyToEthAddress,
   registerWallet,
@@ -580,6 +625,7 @@ export {
   validateScalar,
   validateViewingKey,
   verifyAttestation,
+  verifyAttestationSignature,
   verifyCommitment,
   verifyOpening,
   verifyOracleSignature,

package/dist/solana-4O4K45VU.mjs

@@ -0,0 +1,46 @@
+import {
+  claimStealthPayment,
+  createAnnouncementMemo,
+  estimatePrivateTransferFee,
+  getStealthBalance,
+  hasTokenAccount,
+  parseAnnouncement,
+  scanForPayments,
+  sendPrivateSPLTransfer
+} from "./chunk-SF7YSLF5.mjs";
+import "./chunk-6WGN57S2.mjs";
+import {
+  ATA_RENT_LAMPORTS,
+  ESTIMATED_TX_FEE_LAMPORTS,
+  MEMO_PROGRAM_ID,
+  SIP_MEMO_PREFIX,
+  SOLANA_EXPLORER_URLS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_TOKEN_MINTS,
+  getExplorerUrl,
+  getTokenDecimals,
+  getTokenMint
+} from "./chunk-E6SZWREQ.mjs";
+import "./chunk-UJCSKKID.mjs";
+export {
+  ATA_RENT_LAMPORTS,
+  ESTIMATED_TX_FEE_LAMPORTS,
+  MEMO_PROGRAM_ID,
+  SIP_MEMO_PREFIX,
+  SOLANA_EXPLORER_URLS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_TOKEN_MINTS,
+  claimStealthPayment,
+  createAnnouncementMemo,
+  estimatePrivateTransferFee,
+  getExplorerUrl,
+  getStealthBalance,
+  getTokenDecimals,
+  getTokenMint,
+  hasTokenAccount,
+  parseAnnouncement,
+  scanForPayments,
+  sendPrivateSPLTransfer
+};

package/dist/solana-NDABAZ6P.mjs

@@ -0,0 +1,56 @@
+import {
+  GenericProvider,
+  HeliusProvider,
+  claimStealthPayment,
+  createAnnouncementMemo,
+  createProvider,
+  createWebhookHandler,
+  estimatePrivateTransferFee,
+  getStealthBalance,
+  hasTokenAccount,
+  parseAnnouncement,
+  processWebhookTransaction,
+  scanForPayments,
+  sendPrivateSPLTransfer
+} from "./chunk-2XIVXWHA.mjs";
+import "./chunk-6WGN57S2.mjs";
+import {
+  ATA_RENT_LAMPORTS,
+  ESTIMATED_TX_FEE_LAMPORTS,
+  MEMO_PROGRAM_ID,
+  SIP_MEMO_PREFIX,
+  SOLANA_EXPLORER_URLS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_TOKEN_MINTS,
+  getExplorerUrl,
+  getTokenDecimals,
+  getTokenMint
+} from "./chunk-E6SZWREQ.mjs";
+import "./chunk-UJCSKKID.mjs";
+export {
+  ATA_RENT_LAMPORTS,
+  ESTIMATED_TX_FEE_LAMPORTS,
+  GenericProvider,
+  HeliusProvider,
+  MEMO_PROGRAM_ID,
+  SIP_MEMO_PREFIX,
+  SOLANA_EXPLORER_URLS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_TOKEN_MINTS,
+  claimStealthPayment,
+  createAnnouncementMemo,
+  createProvider,
+  createWebhookHandler,
+  estimatePrivateTransferFee,
+  getExplorerUrl,
+  getStealthBalance,
+  getTokenDecimals,
+  getTokenMint,
+  hasTokenAccount,
+  parseAnnouncement,
+  processWebhookTransaction,
+  scanForPayments,
+  sendPrivateSPLTransfer
+};

package/dist/solana-ZYO63LY5.mjs

@@ -0,0 +1,46 @@
+import {
+  claimStealthPayment,
+  createAnnouncementMemo,
+  estimatePrivateTransferFee,
+  getStealthBalance,
+  hasTokenAccount,
+  parseAnnouncement,
+  scanForPayments,
+  sendPrivateSPLTransfer
+} from "./chunk-7RFRWDCW.mjs";
+import "./chunk-6WGN57S2.mjs";
+import {
+  ATA_RENT_LAMPORTS,
+  ESTIMATED_TX_FEE_LAMPORTS,
+  MEMO_PROGRAM_ID,
+  SIP_MEMO_PREFIX,
+  SOLANA_EXPLORER_URLS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_TOKEN_MINTS,
+  getExplorerUrl,
+  getTokenDecimals,
+  getTokenMint
+} from "./chunk-E6SZWREQ.mjs";
+import "./chunk-UJCSKKID.mjs";
+export {
+  ATA_RENT_LAMPORTS,
+  ESTIMATED_TX_FEE_LAMPORTS,
+  MEMO_PROGRAM_ID,
+  SIP_MEMO_PREFIX,
+  SOLANA_EXPLORER_URLS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_TOKEN_MINTS,
+  claimStealthPayment,
+  createAnnouncementMemo,
+  estimatePrivateTransferFee,
+  getExplorerUrl,
+  getStealthBalance,
+  getTokenDecimals,
+  getTokenMint,
+  hasTokenAccount,
+  parseAnnouncement,
+  scanForPayments,
+  sendPrivateSPLTransfer
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sip-protocol/sdk",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Core SDK for Shielded Intents Protocol - Privacy layer for cross-chain transactions",
   "author": "SIP Protocol <hello@sip-protocol.org>",
   "homepage": "https://sip-protocol.org",
@@ -46,7 +46,7 @@
     "test:coverage": "vitest run --coverage",
     "bench": "vitest bench --config vitest.bench.config.ts",
     "bench:json": "vitest bench --config vitest.bench.config.ts --outputJson benchmarks/results.json",
-    "demo:auction": "tsx examples/auction-demo.ts"
+    "example:auction": "tsx examples/auction-example.ts"
   },
   "dependencies": {
     "@aztec/bb.js": "3.0.0-nightly.20251104",
@@ -57,7 +57,7 @@
     "@noir-lang/noir_js": "1.0.0-beta.15",
     "@noir-lang/types": "1.0.0-beta.15",
     "@scure/base": "^2.0.0",
-    "@sip-protocol/types": "workspace:*",
+    "@sip-protocol/types": "^0.2.1",
     "@solana/web3.js": "^1.95.0",
     "@solana/spl-token": "^0.4.0"
   },

package/src/chains/solana/index.ts

@@ -85,3 +85,27 @@ export {
   claimStealthPayment,
   getStealthBalance,
 } from './scan'
+
+// RPC Providers (Infrastructure Agnostic)
+export {
+  createProvider,
+  HeliusProvider,
+  GenericProvider,
+  type SolanaRPCProvider,
+  type TokenAsset,
+  type ProviderConfig,
+  type ProviderType,
+  type GenericProviderConfig,
+  type HeliusProviderConfig,
+} from './providers'
+
+// Helius Webhook (Real-time Scanning)
+export {
+  createWebhookHandler,
+  processWebhookTransaction,
+  type HeliusWebhookTransaction,
+  type HeliusEnhancedTransaction,
+  type HeliusWebhookPayload,
+  type WebhookHandlerConfig,
+  type WebhookProcessResult,
+} from './providers'

package/src/chains/solana/providers/generic.ts

@@ -0,0 +1,160 @@
+/**
+ * Generic Solana RPC Provider
+ *
+ * Uses standard Solana RPC methods, works with any RPC endpoint
+ * including self-hosted nodes. No API key required.
+ *
+ * @example
+ * ```typescript
+ * import { GenericProvider } from '@sip-protocol/sdk'
+ * import { Connection } from '@solana/web3.js'
+ *
+ * // With existing connection
+ * const connection = new Connection('https://api.devnet.solana.com')
+ * const generic = new GenericProvider({ connection })
+ *
+ * // With endpoint string
+ * const devnet = new GenericProvider({
+ *   endpoint: 'https://api.devnet.solana.com'
+ * })
+ *
+ * const assets = await generic.getAssetsByOwner('7xK9...')
+ * ```
+ */
+
+import {
+  Connection,
+  PublicKey,
+} from '@solana/web3.js'
+import {
+  TOKEN_PROGRAM_ID,
+  getAssociatedTokenAddress,
+  getAccount,
+} from '@solana/spl-token'
+import type { SolanaRPCProvider, TokenAsset, GenericProviderConfig } from './interface'
+
+/**
+ * RPC endpoint URLs by cluster
+ */
+const CLUSTER_ENDPOINTS: Record<string, string> = {
+  'mainnet-beta': 'https://api.mainnet-beta.solana.com',
+  devnet: 'https://api.devnet.solana.com',
+  testnet: 'https://api.testnet.solana.com',
+}
+
+/**
+ * Validate a Solana address (base58)
+ * @throws Error if address is invalid
+ */
+function validateSolanaAddress(address: string, paramName: string): PublicKey {
+  try {
+    return new PublicKey(address)
+  } catch {
+    throw new Error(`Invalid Solana address for ${paramName}: ${address}`)
+  }
+}
+
+/**
+ * Generic RPC Provider implementation
+ *
+ * Uses standard Solana RPC methods. Works with any RPC endpoint.
+ * Recommended for development, testing, or self-hosted nodes.
+ */
+export class GenericProvider implements SolanaRPCProvider {
+  readonly name = 'generic'
+  private connection: Connection
+
+  constructor(config: GenericProviderConfig) {
+    // Use provided connection or create one
+    if (config.connection) {
+      this.connection = config.connection as Connection
+    } else {
+      const endpoint = config.endpoint ?? CLUSTER_ENDPOINTS[config.cluster ?? 'mainnet-beta']
+      this.connection = new Connection(endpoint, 'confirmed')
+    }
+  }
+
+  /**
+   * Get all token assets owned by an address using getParsedTokenAccountsByOwner
+   *
+   * Note: This is less efficient than Helius DAS API for large wallets,
+   * but works with any RPC endpoint.
+   */
+  async getAssetsByOwner(owner: string): Promise<TokenAsset[]> {
+    const ownerPubkey = validateSolanaAddress(owner, 'owner')
+
+    const accounts = await this.connection.getParsedTokenAccountsByOwner(
+      ownerPubkey,
+      { programId: TOKEN_PROGRAM_ID }
+    )
+
+    const assets: TokenAsset[] = []
+
+    for (const { account } of accounts.value) {
+      const parsed = account.data.parsed
+      if (parsed.type !== 'account') continue
+
+      const info = parsed.info
+      const amount = BigInt(info.tokenAmount.amount)
+
+      // Skip zero balances
+      if (amount === 0n) continue
+
+      assets.push({
+        mint: info.mint,
+        amount,
+        decimals: info.tokenAmount.decimals,
+        // Generic RPC doesn't provide symbol/name, those need metadata lookup
+        symbol: undefined,
+        name: undefined,
+        logoUri: undefined,
+      })
+    }
+
+    return assets
+  }
+
+  /**
+   * Get token balance for a specific mint
+   *
+   * Uses getAccount on the associated token address.
+   */
+  async getTokenBalance(owner: string, mint: string): Promise<bigint> {
+    // Validate addresses before trying to fetch (these errors should propagate)
+    const ownerPubkey = validateSolanaAddress(owner, 'owner')
+    const mintPubkey = validateSolanaAddress(mint, 'mint')
+
+    try {
+      const ata = await getAssociatedTokenAddress(
+        mintPubkey,
+        ownerPubkey,
+        true // allowOwnerOffCurve for PDAs
+      )
+
+      const account = await getAccount(this.connection, ata)
+      return account.amount
+    } catch {
+      // Account doesn't exist or other RPC error
+      return 0n
+    }
+  }
+
+  /**
+   * Check if provider supports real-time subscriptions
+   *
+   * Generic RPC supports WebSocket subscriptions but they're not
+   * efficient for monitoring token transfers. Returns false.
+   */
+  supportsSubscriptions(): boolean {
+    return false
+  }
+
+  /**
+   * Get the underlying Connection object
+   *
+   * Useful for advanced operations that need direct RPC access.
+   */
+  getConnection(): Connection {
+    return this.connection
+  }
+}