@sip-protocol/sdk 0.7.0 → 0.7.2

package/dist/index.mjs

@@ -52,6 +52,7 @@ import {
   SettlementRegistry,
   SettlementRegistryError,
   SmartRouter,
+  SolanaSameChainExecutor,
   SolanaWalletAdapter,
   SuiStealthService,
   SwapStatus,
@@ -74,8 +75,6 @@ import {
   base58ToHex,
   bytesToHex,
   checkAptosStealthAddress,
-  checkEd25519StealthAddress,
-  checkStealthAddress,
   checkSuiStealthAddress,
   commit,
   commitZero,
@@ -100,6 +99,7 @@ import {
   createPrivateVoting,
   createProductionSIP,
   createSIP,
+  createSameChainExecutor,
   createSealedBidAuction,
   createShieldedIntent,
   createShieldedPayment,
@@ -112,14 +112,11 @@ import {
   createZcashNativeBackend,
   createZcashShieldedService,
   createZcashSwapService,
-  decodeStealthMetaAddress,
   decodeTaprootAddress,
   decryptMemo,
   decryptWithViewing,
   deriveAptosStealthPrivateKey,
-  deriveEd25519StealthPrivateKey,
   deriveOracleId,
-  deriveStealthPrivateKey,
   deriveSuiStealthPrivateKey,
   deriveViewingKey,
   deserializeAttestationMessage,
@@ -128,10 +125,7 @@ import {
   detectEthereumWallets,
   detectSolanaWallets,
   ed25519PublicKeyToAptosAddress,
-  ed25519PublicKeyToNearAddress,
-  ed25519PublicKeyToSolanaAddress,
   ed25519PublicKeyToSuiAddress,
-  encodeStealthMetaAddress,
   encryptForViewing,
   featureNotSupportedError,
   formatStablecoinAmount,
@@ -141,13 +135,9 @@ import {
   generateBlinding,
   generateCosmosStealthAddress,
   generateCosmosStealthMetaAddress,
-  generateEd25519StealthAddress,
-  generateEd25519StealthMetaAddress,
   generateIntentId,
   generatePdfReport,
   generateRandomBytes,
-  generateStealthAddress,
-  generateStealthMetaAddress,
   generateSuiStealthAddress,
   generateViewingKey,
   getActiveOracles,
@@ -155,7 +145,6 @@ import {
   getBrowserInfo,
   getChainNumericId,
   getChainsForStablecoin,
-  getCurveForChain,
   getDefaultRpcEndpoint,
   getDerivationPath,
   getEthereumProvider,
@@ -169,6 +158,7 @@ import {
   getStablecoin,
   getStablecoinInfo,
   getStablecoinsForChain,
+  getSupportedSameChainChains,
   getSupportedStablecoins,
   getTimeRemaining,
   getXOnlyPublicKey,
@@ -178,51 +168,31 @@ import {
   hexToBytes,
   hexToNumber,
   isBrowser,
-  isEd25519Chain,
   isExpired,
-  isNonNegativeAmount,
   isPaymentExpired,
   isPrivate,
   isPrivateWalletAdapter,
+  isSameChainSupported,
   isStablecoin,
   isStablecoinOnChain,
-  isValidAmount,
   isValidAptosAddress,
-  isValidChainId,
-  isValidCompressedPublicKey,
   isValidCosmosAddress,
-  isValidEd25519PublicKey,
-  isValidHex,
-  isValidHexLength,
-  isValidNearAccountId,
-  isValidNearImplicitAddress,
-  isValidPrivacyLevel,
-  isValidPrivateKey,
-  isValidScalar,
-  isValidSlippage,
-  isValidSolanaAddress,
-  isValidStealthMetaAddress,
   isValidSuiAddress,
   isValidTaprootAddress,
-  nearAddressToEd25519PublicKey,
   normalizeAddress,
   normalizeSuiAddress,
   notConnectedError,
   proveOwnership,
-  publicKeyToEthAddress,
   registerWallet,
   removeOracle,
   schnorrSign,
   schnorrSignHex,
   schnorrVerify,
   schnorrVerifyHex,
-  secureWipe,
-  secureWipeAll,
   serializeAttestationMessage,
   serializeIntent,
   serializePayment,
   signAttestationMessage,
-  solanaAddressToEd25519PublicKey,
   solanaPublicKeyToHex,
   stealthKeyToCosmosAddress,
   subtractBlindings,
@@ -239,21 +209,68 @@ import {
   trackIntent,
   trackPayment,
   updateOracleStatus,
+  verifyAttestation,
+  verifyCommitment,
+  verifyOpening,
+  verifyOracleSignature,
+  verifyOwnership,
+  walletRegistry
+} from "./chunk-G33LB27A.mjs";
+import {
+  ProofGenerationError
+} from "./chunk-HOR7PM3M.mjs";
+import {
+  checkEd25519StealthAddress,
+  checkStealthAddress,
+  claimStealthPayment,
+  createAnnouncementMemo,
+  decodeStealthMetaAddress,
+  deriveEd25519StealthPrivateKey,
+  deriveStealthPrivateKey,
+  ed25519PublicKeyToNearAddress,
+  ed25519PublicKeyToSolanaAddress,
+  encodeStealthMetaAddress,
+  estimatePrivateTransferFee,
+  generateEd25519StealthAddress,
+  generateEd25519StealthMetaAddress,
+  generateStealthAddress,
+  generateStealthMetaAddress,
+  getCurveForChain,
+  getStealthBalance,
+  hasTokenAccount,
+  isEd25519Chain,
+  isNonNegativeAmount,
+  isValidAmount,
+  isValidChainId,
+  isValidCompressedPublicKey,
+  isValidEd25519PublicKey,
+  isValidHex,
+  isValidHexLength,
+  isValidNearAccountId,
+  isValidNearImplicitAddress,
+  isValidPrivacyLevel,
+  isValidPrivateKey,
+  isValidScalar,
+  isValidSlippage,
+  isValidSolanaAddress,
+  isValidStealthMetaAddress,
+  nearAddressToEd25519PublicKey,
+  parseAnnouncement,
+  publicKeyToEthAddress,
+  scanForPayments,
+  secureWipe,
+  secureWipeAll,
+  sendPrivateSPLTransfer,
+  solanaAddressToEd25519PublicKey,
   validateAsset,
   validateCreateIntentParams,
   validateIntentInput,
   validateIntentOutput,
   validateScalar,
   validateViewingKey,
-  verifyAttestation,
-  verifyCommitment,
-  verifyOpening,
-  verifyOracleSignature,
-  verifyOwnership,
-  walletRegistry,
   withSecureBuffer,
   withSecureBufferSync
-} from "./chunk-3OVABDRH.mjs";
+} from "./chunk-L2K34JCU.mjs";
 import {
   CryptoError,
   EncryptionNotImplementedError,
@@ -261,7 +278,6 @@ import {
   IntentError,
   NetworkError,
   ProofError,
-  ProofGenerationError,
   ProofNotImplementedError,
   SIPError,
   ValidationError,
@@ -269,7 +285,18 @@ import {
   hasErrorCode,
   isSIPError,
   wrapError
-} from "./chunk-HGU6HZRC.mjs";
+} from "./chunk-6WGN57S2.mjs";
+import {
+  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 {
   ATTESTATION_VERSION,
@@ -297,6 +324,7 @@ export {
   IntentError,
   IntentStatus,
   LedgerWalletAdapter,
+  MEMO_PROGRAM_ID,
   MockEthereumAdapter,
   MockLedgerAdapter,
   MockProofProvider,
@@ -326,7 +354,12 @@ export {
   ReportStatus,
   SIP,
   SIPError,
+  SIP_MEMO_PREFIX,
   SIP_VERSION,
+  SOLANA_EXPLORER_URLS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_TOKEN_MINTS,
   STABLECOIN_ADDRESSES,
   STABLECOIN_DECIMALS,
   STABLECOIN_INFO,
@@ -334,6 +367,7 @@ export {
   SettlementRegistry,
   SettlementRegistryError,
   SmartRouter,
+  SolanaSameChainExecutor,
   SolanaWalletAdapter,
   SuiStealthService,
   SwapStatus,
@@ -361,10 +395,12 @@ export {
   checkEd25519StealthAddress,
   checkStealthAddress,
   checkSuiStealthAddress,
+  claimStealthPayment,
   commit,
   commitZero,
   computeAttestationHash,
   computeTweakedKey,
+  createAnnouncementMemo,
   createCommitment,
   createEthereumAdapter,
   createKeySpendOnlyOutput,
@@ -384,6 +420,7 @@ export {
   createPrivateVoting,
   createProductionSIP,
   createSIP,
+  createSameChainExecutor,
   createSealedBidAuction,
   createShieldedIntent,
   createShieldedPayment,
@@ -417,6 +454,7 @@ export {
   ed25519PublicKeyToSuiAddress,
   encodeStealthMetaAddress,
   encryptForViewing,
+  estimatePrivateTransferFee,
   featureNotSupportedError,
   formatStablecoinAmount,
   fromHex,
@@ -450,16 +488,22 @@ export {
   getPaymentTimeRemaining,
   getPrivacyConfig,
   getPrivacyDescription,
+  getExplorerUrl as getSolanaExplorerUrl,
   getSolanaProvider,
   getStablecoin,
   getStablecoinInfo,
   getStablecoinsForChain,
+  getStealthBalance,
+  getSupportedSameChainChains,
   getSupportedStablecoins,
   getTimeRemaining,
+  getTokenDecimals,
+  getTokenMint,
   getXOnlyPublicKey,
   hasEnoughOracles,
   hasErrorCode,
   hasRequiredProofs,
+  hasTokenAccount,
   hash,
   hexToNumber,
   isBrowser,
@@ -470,6 +514,7 @@ export {
   isPrivate,
   isPrivateWalletAdapter,
   isSIPError,
+  isSameChainSupported,
   isStablecoin,
   isStablecoinOnChain,
   isValidAmount,
@@ -494,16 +539,19 @@ export {
   normalizeAddress,
   normalizeSuiAddress,
   notConnectedError,
+  parseAnnouncement,
   proveOwnership,
   publicKeyToEthAddress,
   registerWallet,
   removeOracle,
+  scanForPayments,
   schnorrSign,
   schnorrSignHex,
   schnorrVerify,
   schnorrVerifyHex,
   secureWipe,
   secureWipeAll,
+  sendPrivateSPLTransfer,
   serializeAttestationMessage,
   serializeIntent,
   serializePayment,

package/dist/proofs/noir.mjs

@@ -4,9 +4,11 @@ import {
   validity_proof_default
 } from "../chunk-3INS3PR5.mjs";
 import {
-  ProofError,
   ProofGenerationError
-} from "../chunk-HGU6HZRC.mjs";
+} from "../chunk-HOR7PM3M.mjs";
+import {
+  ProofError
+} from "../chunk-6WGN57S2.mjs";
 import "../chunk-UJCSKKID.mjs";
 
 // src/proofs/noir.ts

package/dist/solana-5EMCTPTS.mjs

@@ -0,0 +1,46 @@
+import {
+  claimStealthPayment,
+  createAnnouncementMemo,
+  estimatePrivateTransferFee,
+  getStealthBalance,
+  hasTokenAccount,
+  parseAnnouncement,
+  scanForPayments,
+  sendPrivateSPLTransfer
+} from "./chunk-DLDWZFYC.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-Q4NAVBTS.mjs

@@ -0,0 +1,46 @@
+import {
+  claimStealthPayment,
+  createAnnouncementMemo,
+  estimatePrivateTransferFee,
+  getStealthBalance,
+  hasTokenAccount,
+  parseAnnouncement,
+  scanForPayments,
+  sendPrivateSPLTransfer
+} from "./chunk-L2K34JCU.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.0",
+  "version": "0.7.2",
   "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",
@@ -36,6 +36,18 @@
     "dist",
     "src"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts --watch",
+    "lint": "eslint --ext .ts src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "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"
+  },
   "dependencies": {
     "@aztec/bb.js": "3.0.0-nightly.20251104",
     "@ethereumjs/rlp": "^10.1.0",
@@ -45,7 +57,9 @@
     "@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": "0.2.1"
+    "@sip-protocol/types": "^0.2.1",
+    "@solana/web3.js": "^1.95.0",
+    "@solana/spl-token": "^0.4.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "1.6.1",
@@ -62,17 +76,5 @@
     "stealth-addresses",
     "zcash"
   ],
-  "license": "MIT",
-  "scripts": {
-    "build": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts --watch",
-    "lint": "eslint --ext .ts src/",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "test": "vitest",
-    "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"
-  }
-}
+  "license": "MIT"
+}

package/src/chains/solana/constants.ts

@@ -0,0 +1,101 @@
+/**
+ * Solana Chain Constants
+ *
+ * Token mints, RPC endpoints, and configuration for Solana same-chain privacy.
+ */
+
+/**
+ * Common SPL token mint addresses on Solana mainnet
+ */
+export const SOLANA_TOKEN_MINTS = {
+  /** USD Coin (USDC) - Circle's stablecoin */
+  USDC: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  /** Tether USD (USDT) */
+  USDT: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+  /** Wrapped SOL (for SPL token operations with native SOL) */
+  WSOL: 'So11111111111111111111111111111111111111112',
+} as const
+
+/**
+ * Token decimals for Solana tokens
+ */
+export const SOLANA_TOKEN_DECIMALS: Record<string, number> = {
+  SOL: 9,
+  WSOL: 9,
+  USDC: 6,
+  USDT: 6,
+}
+
+/**
+ * RPC endpoints for Solana clusters
+ */
+export const SOLANA_RPC_ENDPOINTS = {
+  'mainnet-beta': 'https://api.mainnet-beta.solana.com',
+  mainnet: 'https://api.mainnet-beta.solana.com',
+  devnet: 'https://api.devnet.solana.com',
+  testnet: 'https://api.testnet.solana.com',
+  localnet: 'http://localhost:8899',
+} as const
+
+/**
+ * Solana cluster types
+ */
+export type SolanaCluster = keyof typeof SOLANA_RPC_ENDPOINTS
+
+/**
+ * Explorer URLs for transaction viewing
+ */
+export const SOLANA_EXPLORER_URLS = {
+  'mainnet-beta': 'https://solscan.io',
+  mainnet: 'https://solscan.io',
+  devnet: 'https://solscan.io?cluster=devnet',
+  testnet: 'https://solscan.io?cluster=testnet',
+  localnet: 'http://localhost:3000',
+} as const
+
+/**
+ * Memo program ID for Solana
+ */
+export const MEMO_PROGRAM_ID = 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr'
+
+/**
+ * SIP announcement memo prefix
+ * Format: SIP:1:<ephemeral_pubkey_base58>:<view_tag_hex>
+ */
+export const SIP_MEMO_PREFIX = 'SIP:1:'
+
+/**
+ * Estimated transaction fee in lamports
+ * Includes base fee + rent for ATA creation
+ */
+export const ESTIMATED_TX_FEE_LAMPORTS = 5000n
+
+/**
+ * Estimated ATA rent in lamports (for creating Associated Token Account)
+ */
+export const ATA_RENT_LAMPORTS = 2039280n
+
+/**
+ * Get explorer URL for a transaction
+ */
+export function getExplorerUrl(
+  signature: string,
+  cluster: SolanaCluster = 'mainnet-beta'
+): string {
+  const baseUrl = SOLANA_EXPLORER_URLS[cluster]
+  return `${baseUrl}/tx/${signature}`
+}
+
+/**
+ * Get token mint address from symbol
+ */
+export function getTokenMint(symbol: string): string | undefined {
+  return SOLANA_TOKEN_MINTS[symbol as keyof typeof SOLANA_TOKEN_MINTS]
+}
+
+/**
+ * Get token decimals from symbol
+ */
+export function getTokenDecimals(symbol: string): number {
+  return SOLANA_TOKEN_DECIMALS[symbol] ?? 9 // Default to 9 (SOL decimals)
+}

package/src/chains/solana/index.ts

@@ -0,0 +1,87 @@
+/**
+ * Solana Same-Chain Privacy Module
+ *
+ * Provides privacy-preserving SPL token transfers using stealth addresses.
+ *
+ * @example Sender flow
+ * ```typescript
+ * import { sendPrivateSPLTransfer } from '@sip-protocol/sdk'
+ *
+ * const result = await sendPrivateSPLTransfer({
+ *   connection,
+ *   sender: wallet.publicKey,
+ *   senderTokenAccount: senderATA,
+ *   recipientMetaAddress: recipientMeta,
+ *   mint: USDC_MINT,
+ *   amount: 5_000_000n,
+ *   signTransaction: wallet.signTransaction,
+ * })
+ * ```
+ *
+ * @example Recipient flow
+ * ```typescript
+ * import { scanForPayments, claimStealthPayment } from '@sip-protocol/sdk'
+ *
+ * // Scan for incoming payments
+ * const payments = await scanForPayments({
+ *   connection,
+ *   viewingPrivateKey,
+ *   spendingPublicKey,
+ * })
+ *
+ * // Claim a payment
+ * const result = await claimStealthPayment({
+ *   connection,
+ *   stealthAddress: payments[0].stealthAddress,
+ *   ephemeralPublicKey: payments[0].ephemeralPublicKey,
+ *   viewingPrivateKey,
+ *   spendingPrivateKey,
+ *   destinationAddress: myWallet,
+ *   mint: USDC_MINT,
+ * })
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+// Constants
+export {
+  SOLANA_TOKEN_MINTS,
+  SOLANA_TOKEN_DECIMALS,
+  SOLANA_RPC_ENDPOINTS,
+  SOLANA_EXPLORER_URLS,
+  MEMO_PROGRAM_ID,
+  SIP_MEMO_PREFIX,
+  ESTIMATED_TX_FEE_LAMPORTS,
+  ATA_RENT_LAMPORTS,
+  getExplorerUrl,
+  getTokenMint,
+  getTokenDecimals,
+  type SolanaCluster,
+} from './constants'
+
+// Types
+export type {
+  SolanaPrivateTransferParams,
+  SolanaPrivateTransferResult,
+  SolanaScanParams,
+  SolanaScanResult,
+  SolanaClaimParams,
+  SolanaClaimResult,
+  SolanaAnnouncement,
+} from './types'
+export { parseAnnouncement, createAnnouncementMemo } from './types'
+
+// Transfer functions
+export {
+  sendPrivateSPLTransfer,
+  estimatePrivateTransferFee,
+  hasTokenAccount,
+} from './transfer'
+
+// Scan and claim functions
+export {
+  scanForPayments,
+  claimStealthPayment,
+  getStealthBalance,
+} from './scan'