@zubari/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Zubari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,324 @@
+# @zubari/sdk
+
+Multi-chain self-custodial wallet SDK for the Web3 creator economy. Manage Bitcoin, Ethereum, TON, TRON, Solana, and Lightning (Spark) from a single BIP-39 seed phrase.
+
+[![npm version](https://img.shields.io/npm/v/@zubari/sdk.svg)](https://www.npmjs.com/package/@zubari/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+
+## Features
+
+- **Multi-Chain Support**: Ethereum, Bitcoin, TON, TRON, Solana, and Lightning (Spark)
+- **Single Seed Phrase**: Derive addresses for all chains from one BIP-39 mnemonic
+- **Self-Custodial**: Your keys, your crypto - encrypted locally with AES-256-GCM
+- **Creator Economy Protocols**: NFTs, Tips, Subscriptions, and Payouts
+- **TypeScript First**: Full type safety with comprehensive type definitions
+- **React Hooks**: Ready-to-use hooks for React applications
+- **Tether WDK Integration**: Powered by Tether's Wallet Development Kit
+
+## Installation
+
+```bash
+# npm
+npm install @zubari/sdk
+
+# yarn
+yarn add @zubari/sdk
+
+# pnpm
+pnpm add @zubari/sdk
+```
+
+## Quick Start
+
+### Create a New Wallet
+
+```typescript
+import { WalletManager } from '@zubari/sdk';
+
+// Initialize wallet manager
+const wallet = new WalletManager({
+  network: 'testnet', // or 'mainnet'
+});
+
+// Create a new wallet with password protection
+const { seed, address } = await wallet.createWallet('your-secure-password');
+
+console.log('Seed phrase (SAVE THIS!):', seed);
+console.log('Ethereum address:', address);
+
+// Derive addresses for all supported chains
+const addresses = await wallet.deriveAllAddressesWithWdk();
+
+console.log('Multi-chain addresses:', addresses);
+// {
+//   ethereum: '0x...',
+//   bitcoin: 'tb1q...',
+//   ton: 'UQ...',
+//   tron: 'T...',
+//   solana: '...',
+//   spark: 'sp1...'
+// }
+```
+
+### Import Existing Wallet
+
+```typescript
+import { WalletManager } from '@zubari/sdk';
+
+const wallet = new WalletManager({ network: 'testnet' });
+
+// Import from seed phrase
+const { address } = await wallet.importWallet(
+  'your twelve word seed phrase goes here ...',
+  'your-secure-password'
+);
+
+// Unlock and derive all addresses
+await wallet.unlock('your-secure-password');
+const addresses = await wallet.deriveAllAddressesWithWdk();
+```
+
+### React Hook Usage
+
+```tsx
+import { useWalletManager } from '@zubari/sdk/react';
+
+function WalletComponent() {
+  const {
+    state,
+    createWallet,
+    unlock,
+    lock,
+    deriveAllAddresses,
+  } = useWalletManager({ network: 'testnet' });
+
+  const handleCreate = async () => {
+    const { seed, address } = await createWallet('password123');
+    console.log('Created wallet:', address);
+  };
+
+  return (
+    <div>
+      <p>Status: {state.isLocked ? 'Locked' : 'Unlocked'}</p>
+      <p>Address: {state.address}</p>
+      <button onClick={handleCreate}>Create Wallet</button>
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### WalletManager
+
+The main class for wallet operations.
+
+```typescript
+import { WalletManager } from '@zubari/sdk';
+
+const wallet = new WalletManager({
+  network: 'testnet' | 'mainnet',
+  rpcUrl?: string,          // Custom RPC URL
+  enabledChains?: string[], // Chains to enable
+  apiUrl?: string,          // Backend API URL (optional)
+});
+```
+
+#### Methods
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| `createWallet(password)` | Create new wallet with encrypted seed | `{ seed, address }` |
+| `importWallet(seed, password)` | Import existing seed phrase | `{ address }` |
+| `unlock(password)` | Unlock wallet | `{ address }` |
+| `lock()` | Lock wallet (clear seed from memory) | `void` |
+| `deleteWallet()` | Delete wallet from storage | `Promise<void>` |
+| `deriveAllAddressesWithWdk()` | Derive real addresses using WDK | `MultiChainAddresses` |
+| `deriveAllAddressesAsync()` | Derive with fallback strategies | `MultiChainAddresses` |
+| `fetchBalance()` | Get ETH balance | `string` |
+| `getState()` | Get wallet state | `WalletState` |
+
+### ZubariWallet
+
+High-level wallet class with multi-chain transaction support.
+
+```typescript
+import { ZubariWallet } from '@zubari/sdk';
+
+const zubariWallet = new ZubariWallet({
+  seed: 'your seed phrase',
+  network: 'testnet',
+});
+
+// Send ETH
+const tx = await zubariWallet.sendEth({
+  to: '0x...',
+  amount: '0.1',
+});
+
+// Send Bitcoin
+const btcTx = await zubariWallet.sendBitcoin({
+  to: 'tb1q...',
+  amount: '0.001',
+});
+```
+
+### WdkService
+
+Native Tether WDK integration for address derivation.
+
+```typescript
+import { WdkService } from '@zubari/sdk/services';
+
+const wdk = new WdkService({ network: 'testnet' });
+
+// Generate seed phrase
+const seed = await wdk.generateSeedPhrase();
+
+// Initialize and derive addresses
+await wdk.initialize(seed);
+const addresses = await wdk.deriveAllAddresses();
+```
+
+### Protocols
+
+Creator economy protocols for monetization.
+
+```typescript
+import {
+  ZubariNFTProtocol,
+  ZubariTipsProtocol,
+  ZubariSubscriptionProtocol,
+  ZubariPayoutsProtocol,
+} from '@zubari/sdk/protocols';
+
+// NFT Protocol - Lazy minting with EIP-712 signatures
+const nft = new ZubariNFTProtocol(wallet, config);
+const voucher = await nft.createLazyMintVoucher(metadata);
+const mintedNFT = await nft.redeemVoucher(voucher);
+
+// Tips Protocol - Send tips to creators
+const tips = new ZubariTipsProtocol(wallet, config);
+await tips.sendTip({ to: '0x...', amount: '1.0', token: 'ETH' });
+
+// Subscription Protocol
+const subs = new ZubariSubscriptionProtocol(wallet, config);
+await subs.subscribe(planId);
+
+// Payouts Protocol
+const payouts = new ZubariPayoutsProtocol(wallet, config);
+await payouts.claimEarnings();
+```
+
+### Storage
+
+Secure storage adapters for different platforms.
+
+```typescript
+import {
+  createSecureStorage,
+  WebEncryptedStorageAdapter,
+  MemoryStorageAdapter,
+} from '@zubari/sdk/storage';
+
+// Auto-detect platform (Web, React Native, Node.js)
+const storage = createSecureStorage();
+
+// Or use specific adapter
+const webStorage = new WebEncryptedStorageAdapter('app-prefix');
+await webStorage.initialize('encryption-password');
+```
+
+### Utilities
+
+```typescript
+import {
+  formatAddress,
+  formatBalance,
+  isValidAddress,
+  normalizeAddress,
+} from '@zubari/sdk';
+
+formatAddress('0x1234...5678');     // '0x1234...5678'
+formatBalance(1000000000000000000n); // '1.0000'
+isValidAddress('0x...');            // true/false
+normalizeAddress('0xABC...');       // '0xabc...'
+```
+
+## Supported Chains
+
+| Chain | Derivation Path | Address Format | Testnet |
+|-------|-----------------|----------------|---------|
+| Ethereum | m/44'/60'/0'/0/0 | 0x... | Sepolia |
+| Bitcoin | m/84'/0'/0'/0/0 | bc1q.../tb1q... | Testnet |
+| TON | m/44'/607'/0' | UQ.../EQ... | Testnet |
+| TRON | m/44'/195'/0'/0/0 | T... | Shasta |
+| Solana | m/44'/501'/0'/0' | Base58 | Devnet |
+| Spark | m/44'/998'/0'/0/0 | sp1... | Testnet |
+
+## Security
+
+- **AES-256-GCM** encryption for seed storage
+- **PBKDF2** key derivation (100,000 iterations)
+- Seeds cleared from memory on lock
+- Platform-native secure storage (Keychain/Keystore)
+- No private keys transmitted over network
+
+## Requirements
+
+- Node.js >= 18.0.0
+- React >= 18.0.0 (for React hooks, optional)
+
+## TypeScript Support
+
+Full TypeScript support with exported types:
+
+```typescript
+import type {
+  WalletState,
+  WalletManagerConfig,
+  NetworkType,
+  MultiChainAddresses,
+  NFTMetadata,
+  LazyMintVoucher,
+  TipData,
+  SubscriptionPlan,
+  SwapQuote,
+} from '@zubari/sdk';
+```
+
+## Subpath Exports
+
+Import specific modules for better tree-shaking:
+
+```typescript
+// Core wallet only
+import { WalletManager } from '@zubari/sdk/wallet';
+
+// Protocols only
+import { ZubariNFTProtocol } from '@zubari/sdk/protocols';
+
+// Services only
+import { WdkService } from '@zubari/sdk/services';
+
+// Storage only
+import { createSecureStorage } from '@zubari/sdk/storage';
+
+// React hooks only
+import { useWalletManager } from '@zubari/sdk/react';
+```
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [GitHub Repository](https://github.com/anthropics/zubari-wallet)
+- [Documentation](https://docs.zubari.io)
+- [Tether WDK](https://docs.wallet.tether.io)

package/dist/SecureStorage-jO783AhC.d.mts

@@ -0,0 +1,89 @@
+/**
+ * Secure Storage Interface
+ * Platform-agnostic interface for secure key storage
+ */
+interface SecureStorageAdapter {
+    /**
+     * Store a value securely
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * Retrieve a value
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * Remove a value
+     */
+    removeItem(key: string): Promise<void>;
+    /**
+     * Check if a key exists
+     */
+    hasItem(key: string): Promise<boolean>;
+    /**
+     * Clear all stored values
+     */
+    clear(): Promise<void>;
+}
+/**
+ * iOS Keychain Storage Adapter
+ * Uses react-native-keychain for iOS Keychain access
+ */
+declare class KeychainStorageAdapter implements SecureStorageAdapter {
+    private serviceName;
+    constructor(serviceName?: string);
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Android Keystore Storage Adapter
+ * Uses Android Keystore for secure storage
+ */
+declare class KeystoreStorageAdapter implements SecureStorageAdapter {
+    private alias;
+    constructor(alias?: string);
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Web Encrypted LocalStorage Adapter
+ * Uses Web Crypto API for encryption with localStorage
+ */
+declare class WebEncryptedStorageAdapter implements SecureStorageAdapter {
+    private encryptionKey;
+    private storagePrefix;
+    constructor(storagePrefix?: string);
+    /**
+     * Initialize with a password-derived key
+     */
+    initialize(password: string): Promise<void>;
+    private getSalt;
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * In-Memory Storage Adapter (for testing)
+ */
+declare class MemoryStorageAdapter implements SecureStorageAdapter {
+    private storage;
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Secure Storage Factory
+ * Creates appropriate storage adapter based on platform
+ */
+declare function createSecureStorage(): SecureStorageAdapter;
+
+export { KeychainStorageAdapter as K, MemoryStorageAdapter as M, type SecureStorageAdapter as S, WebEncryptedStorageAdapter as W, KeystoreStorageAdapter as a, createSecureStorage as c };

package/dist/SecureStorage-jO783AhC.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Secure Storage Interface
+ * Platform-agnostic interface for secure key storage
+ */
+interface SecureStorageAdapter {
+    /**
+     * Store a value securely
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * Retrieve a value
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * Remove a value
+     */
+    removeItem(key: string): Promise<void>;
+    /**
+     * Check if a key exists
+     */
+    hasItem(key: string): Promise<boolean>;
+    /**
+     * Clear all stored values
+     */
+    clear(): Promise<void>;
+}
+/**
+ * iOS Keychain Storage Adapter
+ * Uses react-native-keychain for iOS Keychain access
+ */
+declare class KeychainStorageAdapter implements SecureStorageAdapter {
+    private serviceName;
+    constructor(serviceName?: string);
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Android Keystore Storage Adapter
+ * Uses Android Keystore for secure storage
+ */
+declare class KeystoreStorageAdapter implements SecureStorageAdapter {
+    private alias;
+    constructor(alias?: string);
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Web Encrypted LocalStorage Adapter
+ * Uses Web Crypto API for encryption with localStorage
+ */
+declare class WebEncryptedStorageAdapter implements SecureStorageAdapter {
+    private encryptionKey;
+    private storagePrefix;
+    constructor(storagePrefix?: string);
+    /**
+     * Initialize with a password-derived key
+     */
+    initialize(password: string): Promise<void>;
+    private getSalt;
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * In-Memory Storage Adapter (for testing)
+ */
+declare class MemoryStorageAdapter implements SecureStorageAdapter {
+    private storage;
+    setItem(key: string, value: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    hasItem(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Secure Storage Factory
+ * Creates appropriate storage adapter based on platform
+ */
+declare function createSecureStorage(): SecureStorageAdapter;
+
+export { KeychainStorageAdapter as K, MemoryStorageAdapter as M, type SecureStorageAdapter as S, WebEncryptedStorageAdapter as W, KeystoreStorageAdapter as a, createSecureStorage as c };

package/dist/SwapService-C0G8IXW2.d.mts

@@ -0,0 +1,35 @@
+import { S as SwapQuote, T as TxResult } from './index-BLuxEdLp.mjs';
+
+/**
+ * SwapService - DEX integration via Velora
+ *
+ * Handles token swaps with slippage protection,
+ * quote fetching, and earnings conversion.
+ */
+declare class SwapService {
+    private readonly _chainId;
+    private readonly isTestnet;
+    constructor(chainId: number, isTestnet?: boolean);
+    /**
+     * Get a swap quote
+     */
+    getQuote(tokenIn: string, tokenOut: string, amountIn: bigint): Promise<SwapQuote>;
+    /**
+     * Execute a swap with slippage protection
+     */
+    executeSwap(quote: SwapQuote, slippageToleranceBps?: number): Promise<TxResult>;
+    /**
+     * Convert earnings to USDT, keeping some ETH for gas
+     */
+    convertEarningsToStable(ethBalance: bigint, reserveForGas?: bigint): Promise<TxResult>;
+    /**
+     * Check if a swap route exists
+     */
+    hasRoute(tokenIn: string, tokenOut: string): Promise<boolean>;
+    /**
+     * Get supported tokens for swapping
+     */
+    getSupportedTokens(): Promise<string[]>;
+}
+
+export { SwapService as S };

package/dist/SwapService-DZD0OJI_.d.ts

@@ -0,0 +1,35 @@
+import { S as SwapQuote, T as TxResult } from './index-BLuxEdLp.js';
+
+/**
+ * SwapService - DEX integration via Velora
+ *
+ * Handles token swaps with slippage protection,
+ * quote fetching, and earnings conversion.
+ */
+declare class SwapService {
+    private readonly _chainId;
+    private readonly isTestnet;
+    constructor(chainId: number, isTestnet?: boolean);
+    /**
+     * Get a swap quote
+     */
+    getQuote(tokenIn: string, tokenOut: string, amountIn: bigint): Promise<SwapQuote>;
+    /**
+     * Execute a swap with slippage protection
+     */
+    executeSwap(quote: SwapQuote, slippageToleranceBps?: number): Promise<TxResult>;
+    /**
+     * Convert earnings to USDT, keeping some ETH for gas
+     */
+    convertEarningsToStable(ethBalance: bigint, reserveForGas?: bigint): Promise<TxResult>;
+    /**
+     * Check if a swap route exists
+     */
+    hasRoute(tokenIn: string, tokenOut: string): Promise<boolean>;
+    /**
+     * Get supported tokens for swapping
+     */
+    getSupportedTokens(): Promise<string[]>;
+}
+
+export { SwapService as S };