@soroswap/sdk 0.0.1

package/README.md

@@ -0,0 +1,389 @@
+# Soroswap SDK
+
+Official TypeScript SDK for [Soroswap.Finance](https://soroswap.finance) - The first DEX and exchange aggregator built on Stellar, powered by smart contracts on Soroban.
+
+## 🌟 Features
+
+- **🔐 Automatic Authentication**: Handles login, token refresh, and session management
+- **💱 Trading Operations**: Get quotes, send transactions, and access multiple protocols
+- **💧 Liquidity Management**: Add/remove liquidity and track positions
+- **📊 Market Data**: Access pools, prices, and asset information
+- **🔒 Server-Side Focused**: Secure handling of credentials and sensitive operations
+- **📝 TypeScript Support**: Full type safety with comprehensive interfaces
+- **⚡ Token Caching**: In-memory token management with automatic refresh
+- **🧪 Well Tested**: Comprehensive unit test coverage
+
+## 🚀 Installation
+
+```bash
+pnpm install soroswap-sdk
+```
+
+## 📖 Quick Start
+
+```typescript
+import { SoroswapSDK } from 'soroswap-sdk';
+
+// Initialize the SDK
+const soroswapClient = new SoroswapSDK({
+  email: 'your-email@example.com',
+  password: 'your-password',
+  defaultNetwork: 'mainnet', // or 'testnet'
+});
+
+// Get a quote for a swap
+const quote = await soroswapClient.quote({
+  assetIn: 'CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA',
+  assetOut: 'CDTKPWPLOURQA2SGTKTUQOWRCBZEORB4BWBOMJ3D3ZTQQSGE5F6JBQLV',
+  amount: '10000000',
+  tradeType: 'EXACT_IN',
+  protocols: ['soroswap', 'aqua'],
+  from: 'YOUR_WALLET_ADDRESS',
+  to: 'RECIPIENT_ADDRESS'
+});
+
+// Sign the transaction with your preferred signer
+const signedXdr = await yourSigner.sign(quote.xdr);
+
+// Send the signed transaction
+const result = await soroswapClient.send(signedXdr, 100);
+console.log('Transaction hash:', result.hash);
+```
+
+## 🔧 Configuration
+
+### SDK Configuration Options
+
+```typescript
+interface SoroswapSDKConfig {
+  email: string;              // Your Soroswap account email
+  password: string;           // Your Soroswap account password
+  defaultNetwork?: Network;  // 'mainnet' | 'testnet' (defaults to 'mainnet')
+  timeout?: number;          // Request timeout in ms (defaults to 30000)
+}
+```
+
+### Environment Variables
+
+For better security, you can use environment variables:
+
+```typescript
+const sdk = new SoroswapSDK({
+  email: process.env.SOROSWAP_EMAIL!,
+  password: process.env.SOROSWAP_PASSWORD!,
+  defaultNetwork: process.env.NODE_ENV === 'production' ? 'mainnet' : 'testnet'
+});
+```
+
+## 📚 API Reference
+
+### Authentication
+
+The SDK handles authentication automatically, but you can also manage it manually:
+
+```typescript
+// Check authentication status
+const isAuth = sdk.isAuthenticated();
+
+// Get user information
+const userInfo = sdk.getUserInfo();
+
+// Logout (clears tokens)
+sdk.logout();
+
+// Register a new user
+await sdk.register({
+  username: 'newuser',
+  email: 'user@example.com',
+  password: 'SecurePassword123!'
+});
+```
+
+### Trading Operations
+
+#### Get Available Protocols
+
+```typescript
+const protocols = await sdk.getProtocols('mainnet');
+// Returns: ['soroswap', 'phoenix', 'aqua']
+```
+
+#### Get Quote
+
+```typescript
+const quote = await sdk.quote({
+  assetIn: 'TOKEN_A_CONTRACT',
+  assetOut: 'TOKEN_B_CONTRACT',
+  amount: '1000000',
+  tradeType: 'EXACT_IN',
+  protocols: ['soroswap', 'aqua'],
+  slippageTolerance: '50', // 0.5% in basis points
+  maxHops: 2,
+  feeBps: 30, // Optional fee in basis points
+  referralId: 'REFERRAL_WALLET_ADDRESS' // Required if feeBps is provided
+});
+```
+
+#### Send Signed Transaction
+
+```typescript
+const result = await sdk.send(signedXdr, 100); // fee in stroops
+```
+
+### Pool Operations
+
+#### Get Pools
+
+```typescript
+// Get all pools for specific protocols
+const pools = await sdk.getPools(
+  'mainnet',
+  ['soroswap', 'aqua'],
+  ['SOROSWAP', 'STELLAR_EXPERT'] // Optional asset list filter
+);
+
+// Get specific pool for token pair
+const pool = await sdk.getPoolByTokens(
+  'TOKEN_A_CONTRACT',
+  'TOKEN_B_CONTRACT',
+  'mainnet',
+  ['soroswap']
+);
+```
+
+### Liquidity Operations
+
+#### Add Liquidity
+
+```typescript
+const addLiquidityTx = await sdk.addLiquidity({
+  assetA: 'TOKEN_A_CONTRACT',
+  assetB: 'TOKEN_B_CONTRACT',
+  amountA: '1000000',
+  amountB: '2000000',
+  to: 'YOUR_WALLET_ADDRESS',
+  slippageTolerance: '50' // 0.5%
+});
+
+// Sign and send the transaction
+const signedXdr = await yourSigner.sign(addLiquidityTx.xdr);
+const result = await sdk.send(signedXdr, 100);
+```
+
+#### Remove Liquidity
+
+```typescript
+const removeLiquidityTx = await sdk.removeLiquidity({
+  assetA: 'TOKEN_A_CONTRACT',
+  assetB: 'TOKEN_B_CONTRACT',
+  liquidity: '500000',
+  amountA: '450000',
+  amountB: '900000',
+  to: 'YOUR_WALLET_ADDRESS',
+  slippageTolerance: '50'
+});
+```
+
+#### Get User Positions
+
+```typescript
+const positions = await sdk.getUserPositions(
+  'USER_WALLET_ADDRESS',
+  'mainnet'
+);
+```
+
+### Market Data
+
+#### Get Asset Prices
+
+```typescript
+// Single asset price
+const price = await sdk.getPrice(
+  'TOKEN_CONTRACT_ADDRESS',
+  'mainnet',
+  'USD'
+);
+
+// Multiple asset prices
+const prices = await sdk.getPrice([
+  'TOKEN_A_CONTRACT',
+  'TOKEN_B_CONTRACT'
+], 'mainnet', 'USD');
+```
+
+#### Get Asset Lists
+
+```typescript
+// Get all available asset lists
+const assetLists = await sdk.getAssetList();
+
+// Get specific asset list
+const soroswapAssets = await sdk.getAssetList('SOROSWAP');
+```
+
+### System Information
+
+#### Health Check
+
+```typescript
+const health = await sdk.checkHealth();
+```
+
+#### Get Contract Addresses
+
+```typescript
+const factoryAddress = await sdk.getContractAddress('mainnet', 'factory');
+const routerAddress = await sdk.getContractAddress('mainnet', 'router');
+const aggregatorAddress = await sdk.getContractAddress('mainnet', 'aggregator');
+```
+
+#### Get Testnet Tokens
+
+```typescript
+const testnetTokens = await sdk.getTokens();
+```
+
+## 🔐 Security Best Practices
+
+1. **Environment Variables**: Store credentials in environment variables, not in code
+2. **Server-Side Only**: This SDK is designed for server-side use only
+3. **Token Management**: The SDK handles token refresh automatically
+4. **Error Handling**: Always wrap API calls in try-catch blocks
+
+```typescript
+try {
+  const quote = await sdk.quote(quoteParams);
+  // Handle success
+} catch (error) {
+  console.error('Quote failed:', error.message);
+  // Handle error
+}
+```
+
+## 🏗️ Development
+
+### Building
+
+```bash
+pnpm run build
+```
+
+### Testing
+
+The SDK includes two types of tests:
+
+#### Unit Tests (Mocked)
+Fast tests that mock all external dependencies:
+
+```bash
+# Run unit tests (default)
+pnpm test
+
+# Run with coverage
+pnpm run test:coverage
+
+# Watch mode for development
+pnpm run test:watch
+```
+
+#### Integration Tests (Real API)
+Tests that actually call the Soroswap API:
+
+```bash
+# Set up credentials first
+export SOROSWAP_EMAIL="your-email@example.com"
+export SOROSWAP_PASSWORD="your-password"
+
+# Run integration tests
+pnpm run test:integration
+
+# Run both unit and integration tests
+pnpm run test:all
+```
+
+**Note**: Integration tests require valid Soroswap credentials and may fail due to network issues or API changes. See [Integration Test Documentation](./tests/integration/README.md) for detailed setup.
+
+### Linting
+
+```bash
+pnpm run lint
+pnpm run lint:fix
+```
+
+## 🌐 Frontend Integration Considerations
+
+While this SDK is server-side focused, you can create secure frontend integrations:
+
+### Recommended Architecture
+
+```typescript
+// Backend API endpoint
+app.post('/api/quote', async (req, res) => {
+  try {
+    const quote = await soroswapSDK.quote(req.body);
+    // Only return the XDR and quote data, not sensitive info
+    res.json({
+      xdr: quote.xdr,
+      trade: quote.trade,
+      priceImpact: quote.priceImpact
+    });
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+});
+
+// Frontend widget
+async function getQuote(quoteParams) {
+  const response = await fetch('/api/quote', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(quoteParams)
+  });
+  return response.json();
+}
+```
+
+## 📊 Type Definitions
+
+The SDK exports comprehensive TypeScript types:
+
+```typescript
+import {
+  SoroswapSDKConfig,
+  Network,
+  TradeType,
+  QuoteDto,
+  QuoteResponse,
+  Pool,
+  UserPosition,
+  PriceData,
+  // ... and many more
+} from 'soroswap-sdk';
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Please read our contributing guidelines and submit pull requests to help improve the SDK.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- [Soroswap.Finance](https://soroswap.finance)
+- [Documentation](https://docs.soroswap.finance)
+- [API Documentation](https://api.soroswap.finance)
+- [GitHub Repository](https://github.com/soroswap/sdk)
+
+## 📞 Support
+
+For support and questions:
+- Create an issue on [GitHub](https://github.com/soroswap/sdk/issues)
+- Join our [Discord community](https://discord.gg/soroswap)
+- Follow us on [Twitter](https://twitter.com/SoroswapFinance)
+
+---
+
+Built with ❤️ by the Soroswap team for the Stellar ecosystem. 

package/dist/auth/auth-manager.d.ts

@@ -0,0 +1,57 @@
+import { HttpClient } from '../clients/http-client';
+import { AuthLoginDto, AuthRegisterDto, AuthResponse } from '../types';
+/**
+ * Authentication manager handles login, registration, and token refresh
+ */
+export declare class AuthManager {
+    private tokenCache;
+    private credentials;
+    private httpClient;
+    constructor(credentials: AuthLoginDto);
+    /**
+     * Set HTTP client (injected dependency)
+     */
+    setHttpClient(httpClient: HttpClient): void;
+    /**
+     * Get current valid access token, refreshing if necessary
+     */
+    getValidAccessToken(): Promise<string>;
+    /**
+     * Login with credentials
+     */
+    login(): Promise<AuthResponse>;
+    /**
+     * Register new user
+     */
+    register(userData: AuthRegisterDto): Promise<{
+        message: string;
+    }>;
+    /**
+     * Refresh access token using refresh token
+     */
+    refreshTokens(): Promise<AuthResponse>;
+    /**
+     * Get current user information
+     */
+    getUserInfo(): {
+        username: string;
+        role: string;
+    } | null;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Logout (clear tokens)
+     */
+    logout(): void;
+    /**
+     * Get token provider function for HTTP client
+     */
+    getTokenProvider(): () => Promise<string | null>;
+    /**
+     * Update credentials (for switching users)
+     */
+    updateCredentials(credentials: AuthLoginDto): void;
+}
+//# sourceMappingURL=auth-manager.d.ts.map

package/dist/auth/auth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/auth/auth-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EAEb,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,UAAU,CAA2B;gBAEjC,WAAW,EAAE,YAAY;IAKrC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAI3C;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IA6B5C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IA6BpC;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQvE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAuC5C;;OAEG;IACH,WAAW,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIxD;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,gBAAgB,IAAI,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWhD;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI;CAInD"}

package/dist/auth/auth-manager.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthManager = void 0;
+const token_cache_1 = require("../cache/token-cache");
+/**
+ * Authentication manager handles login, registration, and token refresh
+ */
+class AuthManager {
+    constructor(credentials) {
+        this.httpClient = null; // Will be injected
+        this.credentials = credentials;
+        this.tokenCache = new token_cache_1.TokenCache();
+    }
+    /**
+     * Set HTTP client (injected dependency)
+     */
+    setHttpClient(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Get current valid access token, refreshing if necessary
+     */
+    async getValidAccessToken() {
+        // Check if we have valid tokens
+        if (this.tokenCache.hasValidTokens()) {
+            return this.tokenCache.getAccessToken();
+        }
+        // Check if we need to refresh
+        if (this.tokenCache.needsRefresh() && this.tokenCache.getRefreshToken()) {
+            try {
+                await this.refreshTokens();
+                const token = this.tokenCache.getAccessToken();
+                if (token) {
+                    return token;
+                }
+            }
+            catch (error) {
+                console.log("🚀 | getValidAccessToken | error:", error);
+                // Token refresh failed, attempting new login
+            }
+        }
+        // Login fresh
+        await this.login();
+        const token = this.tokenCache.getAccessToken();
+        if (!token) {
+            throw new Error('Failed to obtain access token after login');
+        }
+        return token;
+    }
+    /**
+     * Login with credentials
+     */
+    async login() {
+        if (!this.httpClient) {
+            throw new Error('HTTP client not initialized');
+        }
+        try {
+            const response = await this.httpClient.post('/login', this.credentials);
+            // Calculate expiration time (assume 1 hour if not provided)
+            const expiresIn = 60 * 60 * 1000; // 1 hour in milliseconds
+            const expiresAt = Date.now() + expiresIn;
+            // Store tokens in cache
+            const tokenData = {
+                access_token: response.access_token,
+                refresh_token: response.refresh_token,
+                expires_at: expiresAt,
+                username: response.username,
+                role: response.role,
+            };
+            this.tokenCache.setTokens(tokenData);
+            return response;
+        }
+        catch (error) {
+            this.tokenCache.clear();
+            throw error;
+        }
+    }
+    /**
+     * Register new user
+     */
+    async register(userData) {
+        if (!this.httpClient) {
+            throw new Error('HTTP client not initialized');
+        }
+        return this.httpClient.post('/register', userData);
+    }
+    /**
+     * Refresh access token using refresh token
+     */
+    async refreshTokens() {
+        if (!this.httpClient) {
+            throw new Error('HTTP client not initialized');
+        }
+        const refreshToken = this.tokenCache.getRefreshToken();
+        if (!refreshToken) {
+            throw new Error('No refresh token available');
+        }
+        try {
+            // Use refresh token as bearer token
+            const response = await this.httpClient.post('/refresh', {}, {
+                headers: {
+                    Authorization: `Bearer ${refreshToken}`
+                }
+            });
+            // Calculate expiration time
+            const expiresIn = 60 * 60 * 1000; // 1 hour in milliseconds
+            const expiresAt = Date.now() + expiresIn;
+            // Update tokens in cache
+            const tokenData = {
+                access_token: response.access_token,
+                refresh_token: response.refresh_token,
+                expires_at: expiresAt,
+                username: response.username,
+                role: response.role,
+            };
+            this.tokenCache.setTokens(tokenData);
+            return response;
+        }
+        catch (error) {
+            this.tokenCache.clear();
+            throw error;
+        }
+    }
+    /**
+     * Get current user information
+     */
+    getUserInfo() {
+        return this.tokenCache.getUserInfo();
+    }
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated() {
+        return this.tokenCache.hasValidTokens();
+    }
+    /**
+     * Logout (clear tokens)
+     */
+    logout() {
+        this.tokenCache.clear();
+    }
+    /**
+     * Get token provider function for HTTP client
+     */
+    getTokenProvider() {
+        return async () => {
+            try {
+                return await this.getValidAccessToken();
+            }
+            catch (error) {
+                console.log("🚀 | return | error:", error);
+                return null;
+            }
+        };
+    }
+    /**
+     * Update credentials (for switching users)
+     */
+    updateCredentials(credentials) {
+        this.credentials = credentials;
+        this.tokenCache.clear(); // Clear existing tokens
+    }
+}
+exports.AuthManager = AuthManager;
+//# sourceMappingURL=auth-manager.js.map

package/dist/auth/auth-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.js","sourceRoot":"","sources":["../../src/auth/auth-manager.ts"],"names":[],"mappings":"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"}

package/dist/cache/token-cache.d.ts

@@ -0,0 +1,48 @@
+import { TokenData } from '../types';
+/**
+ * In-memory token cache with automatic expiration handling
+ * Stores access and refresh tokens with timestamps
+ */
+export declare class TokenCache {
+    private tokenData;
+    /**
+     * Store token data in cache
+     */
+    setTokens(tokenData: TokenData): void;
+    /**
+     * Get current access token if valid
+     */
+    getAccessToken(): string | null;
+    /**
+     * Get refresh token
+     */
+    getRefreshToken(): string | null;
+    /**
+     * Get user information
+     */
+    getUserInfo(): {
+        username: string;
+        role: string;
+    } | null;
+    /**
+     * Check if we have valid tokens
+     */
+    hasValidTokens(): boolean;
+    /**
+     * Check if we need to refresh tokens
+     */
+    needsRefresh(): boolean;
+    /**
+     * Clear all cached tokens
+     */
+    clear(): void;
+    /**
+     * Get token expiration time
+     */
+    getExpirationTime(): number | null;
+    /**
+     * Check if tokens exist (regardless of expiration)
+     */
+    hasTokens(): boolean;
+}
+//# sourceMappingURL=token-cache.d.ts.map

package/dist/cache/token-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-cache.d.ts","sourceRoot":"","sources":["../../src/cache/token-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAA0B;IAE3C;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIrC;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAgB/B;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,WAAW,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWxD;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,YAAY,IAAI,OAAO;IAWvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}