Technical Documentation

Installation

npm install @moonwareos/sdk
# or
yarn add @moonwareos/sdk

Initialize SDK

import { MoonwareOS } from '@moonwareos/sdk'

const moonware = new MoonwareOS({
  network: 'mainnet', // or 'devnet'
  apiKey: process.env.MOONWARE_API_KEY,
  relayPreference: 'global', // or 'regional'
  privacyLevel: 'maximum' // 'standard' | 'maximum'
})

Create Private Payment

// Generate one-time payment link
const payment = await moonware.moonPay.create({
  amount: '10 USDC',
  token: 'USDC',
  recipient: 'optional-moon-id',
  autoSweep: true,
  expiresIn: 3600 // seconds
})

console.log(payment.link) // moonware.xyz/pay/xxx
console.log(payment.stealthAddress) // One-time address

Send Private Transaction

// Route through ShadowNet with stealth address
const tx = await moonware.shadowNet.send({
  to: recipientAddress,
  amount: '1 SOL',
  stealth: true,
  hops: 5, // Number of relay hops (3-7)
  priority: 'speed' // 'speed' | 'anonymity'
})

// Wait for confirmation
await tx.confirm()
console.log('Transaction private:', tx.signature)

Encrypted Messaging

// Send HPKE-encrypted message
await moonware.darkrelay.send({
  to: recipientMoonID,
  message: 'Your encrypted content',
  hpke: true,
  commitment: true // Anchor on-chain
})

// Receive messages
const messages = await moonware.darkrelay.receive({
  moonID: yourMoonID,
  decrypt: true
})

Advanced: MPC Key Management

// Distribute key across MPC nodes
const mpcKey = await moonware.mpc.createKey({
  threshold: 3,
  totalShares: 5,
  autoRotate: true,
  rotationInterval: 86400 // 24 hours
})

// Sign transaction with MPC
const signature = await moonware.mpc.sign({
  keyId: mpcKey.id,
  message: transactionHash,
  participants: ['node1', 'node2', 'node3']
})

Privacy Verification

// Check anonymity status
const status = await moonware.privacy.getStatus()

console.log({
  anonymityScore: status.score, // 0-100
  metadataLeaks: status.leaks, // []
  activeRelays: status.relays, // 100+
  stealthAddresses: status.addresses // ∞
})