@soroswap/sdk 0.1.0 → 0.1.2

package/README.md

@@ -5,12 +5,12 @@ Official TypeScript SDK for [Soroswap.Finance](https://soroswap.finance) - The f
 ## 🌟 Features
 
 - **🔐 Automatic Authentication**: Handles login, token refresh, and session management
-- **💱 Trading Operations**: Get quotes, send transactions, and access multiple protocols
+- **💱 Trading Operations**: Get quotes, build transactions, send them to the network
 - **💧 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
+- **⚡ Access Token Caching**: In-memory access token management with automatic refresh
 - **🧪 Well Tested**: Comprehensive unit test coverage
 
 ## 🚀 Installation
@@ -22,32 +22,36 @@ pnpm install soroswap-sdk
 ## 📖 Quick Start
 
 ```typescript
-import { SoroswapSDK } from 'soroswap-sdk';
+import { SoroswapSDK, SupportedNetworks, SupportedProtocols, TradeType } from '@soroswap/sdk';
 
 // Initialize the SDK
 const soroswapClient = new SoroswapSDK({
   email: 'your-email@example.com',
-  password: 'your-password',
-  defaultNetwork: 'mainnet', // or 'testnet'
+  password: 'your-password'
 });
 
 // Get a quote for a swap
 const quote = await soroswapClient.quote({
   assetIn: 'CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA',
   assetOut: 'CDTKPWPLOURQA2SGTKTUQOWRCBZEORB4BWBOMJ3D3ZTQQSGE5F6JBQLV',
-  amount: '10000000',
-  tradeType: 'EXACT_IN',
-  protocols: ['soroswap', 'aqua'],
+  amount: 10000000n, // Note: Amount must be a BigInt
+  tradeType: TradeType.EXACT_IN,
+  protocols: [SupportedProtocols.SDEX, SupportedProtocols.SOROSWAP, SupportedProtocols.AQUA],
+});
+
+// Build the transaction XDR from the quote
+const buildResponse = await soroswapClient.build({
+  quote,
   from: 'YOUR_WALLET_ADDRESS',
   to: 'RECIPIENT_ADDRESS'
 });
 
 // Sign the transaction with your preferred signer
-const signedXdr = await yourSigner.sign(quote.xdr);
+const signedXdr = await yourSigner.sign(buildResponse.xdr);
 
 // Send the signed transaction
-const result = await soroswapClient.send(signedXdr, 100);
-console.log('Transaction hash:', result.hash);
+const result = await soroswapClient.send(signedXdr, false); // launchtube = false
+console.log('Transaction result:', result);
 ```
 
 ## 🔧 Configuration
@@ -56,10 +60,10 @@ console.log('Transaction hash:', result.hash);
 
 ```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)
+  email: string;                    // Your Soroswap account email
+  password: string;                 // Your Soroswap account password
+  defaultNetwork?: SupportedNetworks;  // SupportedNetworks.MAINNET | SupportedNetworks.TESTNET
+  timeout?: number;                // Request timeout in ms (defaults to 30000) you might want to adjust this if using launchtube
 }
 ```
 
@@ -68,10 +72,12 @@ interface SoroswapSDKConfig {
 For better security, you can use environment variables:
 
 ```typescript
-const sdk = new SoroswapSDK({
+const soroswapClient = new SoroswapSDK({
   email: process.env.SOROSWAP_EMAIL!,
   password: process.env.SOROSWAP_PASSWORD!,
-  defaultNetwork: process.env.NODE_ENV === 'production' ? 'mainnet' : 'testnet'
+  defaultNetwork: process.env.NODE_ENV === 'production' 
+    ? SupportedNetworks.MAINNET 
+    : SupportedNetworks.TESTNET
 });
 ```
 
@@ -79,24 +85,11 @@ const sdk = new SoroswapSDK({
 
 ### Authentication
 
-The SDK handles authentication automatically, but you can also manage it manually:
+The SDK handles authentication automatically:
 
 ```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!'
-});
+const isAuth = soroswapClient.isAuthenticated();
 ```
 
 ### Trading Operations
@@ -104,30 +97,48 @@ await sdk.register({
 #### Get Available Protocols
 
 ```typescript
-const protocols = await sdk.getProtocols('mainnet');
-// Returns: ['soroswap', 'phoenix', 'aqua']
+const protocols = await soroswapClient.getProtocols(SupportedNetworks.MAINNET);
+// Returns: ['sdex', 'soroswap', 'phoenix', 'aqua']
 ```
 
 #### Get Quote
 
 ```typescript
-const quote = await sdk.quote({
+const quote = await soroswapClient.quote({
   assetIn: 'TOKEN_A_CONTRACT',
   assetOut: 'TOKEN_B_CONTRACT',
-  amount: '1000000',
-  tradeType: 'EXACT_IN',
-  protocols: ['soroswap', 'aqua'],
+  amount: 1000000n, // BigInt required
+  tradeType: TradeType.EXACT_IN,
+  protocols: [SupportedProtocols.SOROSWAP, SupportedProtocols.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
 });
 ```
 
+#### Build Transaction
+
+After getting a quote, build the transaction XDR:
+
+```typescript
+const buildResponse = await soroswapClient.build({
+  quote: quote,
+  from: 'YOUR_WALLET_ADDRESS',
+  to: 'RECIPIENT_ADDRESS', // Optional, defaults to 'from'
+  referralId: 'REFERRAL_WALLET_ADDRESS' // Required if quote includes feeBps
+});
+
+// buildResponse.xdr contains the transaction ready for signing
+```
+
 #### Send Signed Transaction
 
 ```typescript
-const result = await sdk.send(signedXdr, 100); // fee in stroops
+const result = await soroswapClient.send(
+  signedXdr,           // The signed transaction XDR
+  false,               // launchtube: boolean (default false)
+  SupportedNetworks.MAINNET  // Optional network override
+);
 ```
 
 ### Pool Operations
@@ -136,18 +147,18 @@ const result = await sdk.send(signedXdr, 100); // fee in stroops
 
 ```typescript
 // Get all pools for specific protocols
-const pools = await sdk.getPools(
-  'mainnet',
-  ['soroswap', 'aqua'],
-  ['SOROSWAP', 'STELLAR_EXPERT'] // Optional asset list filter
+const pools = await soroswapClient.getPools(
+  SupportedNetworks.MAINNET,
+  [SupportedProtocols.SOROSWAP, SupportedProtocols.AQUA],
+  [SupportedAssetLists.SOROSWAP] // Optional asset list filter
 );
 
 // Get specific pool for token pair
-const pool = await sdk.getPoolByTokens(
+const pool = await soroswapClient.getPoolByTokens(
   'TOKEN_A_CONTRACT',
   'TOKEN_B_CONTRACT',
-  'mainnet',
-  ['soroswap']
+  SupportedNetworks.MAINNET,
+  [SupportedProtocols.SOROSWAP]
 );
 ```
 
@@ -155,25 +166,46 @@ const pool = await sdk.getPoolByTokens(
 
 #### Add Liquidity
 
+**Important**: Before adding liquidity, you should fetch the existing pool to calculate the proper token proportions. The amounts must maintain the current pool ratio, otherwise the transaction will fail during simulation.
+
 ```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%
-});
+// First, get the current pool to understand the ratio
+const pools = await soroswapClient.getPoolByTokens(
+  'TOKEN_A_CONTRACT',
+  'TOKEN_B_CONTRACT',
+  SupportedNetworks.MAINNET,
+  [SupportedProtocols.SOROSWAP]
+);
+
+if (pools.length > 0) {
+  const pool = pools[0];
+  const ratio = Number(pool.reserveB) / Number(pool.reserveA);
+  
+  // Calculate proportional amounts
+  const amountA = '1000000';
+  const amountB = (Number(amountA) * ratio).toString();
+  
+  const addLiquidityTx = await soroswapClient.addLiquidity({
+    assetA: 'TOKEN_A_CONTRACT',
+    assetB: 'TOKEN_B_CONTRACT',
+    amountA: amountA,
+    amountB: amountB,
+    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);
+  // Sign and send the transaction
+  const signedXdr = await yourSigner.sign(addLiquidityTx.xdr);
+  const result = await soroswapClient.send(signedXdr, false);
+}
 ```
 
+> **Note**: All liquidity transactions are simulated before execution. If the amounts don't match the required proportions or if there are insufficient funds, the transaction will return an error during simulation.
+
 #### Remove Liquidity
 
 ```typescript
-const removeLiquidityTx = await sdk.removeLiquidity({
+const removeLiquidityTx = await soroswapClient.removeLiquidity({
   assetA: 'TOKEN_A_CONTRACT',
   assetB: 'TOKEN_B_CONTRACT',
   liquidity: '500000',
@@ -187,9 +219,9 @@ const removeLiquidityTx = await sdk.removeLiquidity({
 #### Get User Positions
 
 ```typescript
-const positions = await sdk.getUserPositions(
+const positions = await soroswapClient.getUserPositions(
   'USER_WALLET_ADDRESS',
-  'mainnet'
+  SupportedNetworks.MAINNET
 );
 ```
 
@@ -199,49 +231,36 @@ const positions = await sdk.getUserPositions(
 
 ```typescript
 // Single asset price
-const price = await sdk.getPrice(
+const prices = await soroswapClient.getPrice(
   'TOKEN_CONTRACT_ADDRESS',
-  'mainnet',
-  'USD'
+  SupportedNetworks.MAINNET
 );
 
 // Multiple asset prices
-const prices = await sdk.getPrice([
+const prices = await soroswapClient.getPrice([
   'TOKEN_A_CONTRACT',
   'TOKEN_B_CONTRACT'
-], 'mainnet', 'USD');
+], SupportedNetworks.MAINNET);
 ```
 
 #### Get Asset Lists
 
 ```typescript
-// Get all available asset lists
-const assetLists = await sdk.getAssetList();
+// Get all available asset lists metadata
+const assetListsInfo = await soroswapClient.getAssetList();
 
 // Get specific asset list
-const soroswapAssets = await sdk.getAssetList('SOROSWAP');
+const soroswapAssets = await soroswapClient.getAssetList(SupportedAssetLists.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();
+const factoryAddress = await soroswapClient.getContractAddress(SupportedNetworks.MAINNET, 'factory');
+const routerAddress = await soroswapClient.getContractAddress(SupportedNetworks.MAINNET, 'router');
+const aggregatorAddress = await soroswapClient.getContractAddress(SupportedNetworks.MAINNET, 'aggregator');
 ```
 
 ## 🔐 Security Best Practices
@@ -253,10 +272,11 @@ const testnetTokens = await sdk.getTokens();
 
 ```typescript
 try {
-  const quote = await sdk.quote(quoteParams);
+  const quote = await soroswapClient.quote(quoteParams);
+  const buildResponse = await soroswapClient.build({ quote, from: walletAddress });
   // Handle success
 } catch (error) {
-  console.error('Quote failed:', error.message);
+  console.error('Quote/build failed:', error.message);
   // Handle error
 }
 ```
@@ -321,12 +341,22 @@ While this SDK is server-side focused, you can create secure frontend integratio
 // Backend API endpoint
 app.post('/api/quote', async (req, res) => {
   try {
-    const quote = await soroswapSDK.quote(req.body);
+    const quote = await soroswapClient.quote(req.body);
+    const buildResponse = await soroswapClient.build({
+      quote,
+      from: req.body.walletAddress
+    });
+    
     // Only return the XDR and quote data, not sensitive info
     res.json({
-      xdr: quote.xdr,
-      trade: quote.trade,
-      priceImpact: quote.priceImpact
+      xdr: buildResponse.xdr,
+      quote: {
+        trade: quote.trade,
+        priceImpact: quote.priceImpact,
+        assetIn: quote.assetIn,
+        assetOut: quote.assetOut,
+        tradeType: quote.tradeType
+      }
     });
   } catch (error) {
     res.status(500).json({ error: error.message });
@@ -334,7 +364,7 @@ app.post('/api/quote', async (req, res) => {
 });
 
 // Frontend widget
-async function getQuote(quoteParams) {
+async function getQuoteAndBuild(quoteParams) {
   const response = await fetch('/api/quote', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
@@ -350,25 +380,51 @@ The SDK exports comprehensive TypeScript types:
 
 ```typescript
 import {
+  SoroswapSDK,
   SoroswapSDKConfig,
-  Network,
+  SupportedNetworks,
+  SupportedProtocols,
+  SupportedAssetLists,
   TradeType,
-  QuoteDto,
+  QuoteRequest,
   QuoteResponse,
+  BuildQuoteRequest,
+  BuildQuoteResponse,
   Pool,
   UserPosition,
   PriceData,
+  AssetList,
+  AssetListInfo,
   // ... and many more
 } from 'soroswap-sdk';
 ```
 
-## 🤝 Contributing
+### Example: Working with Types
 
-We welcome contributions! Please read our contributing guidelines and submit pull requests to help improve the SDK.
+```typescript
+import { 
+  QuoteRequest, 
+  TradeType, 
+  SupportedProtocols,
+  ExactInBuildTradeReturn 
+} from 'soroswap-sdk';
 
-## 📄 License
+const quoteRequest: QuoteRequest = {
+  assetIn: 'TOKEN_A',
+  assetOut: 'TOKEN_B',
+  amount: 1000000n,
+  tradeType: TradeType.EXACT_IN,
+  protocols: [SupportedProtocols.SOROSWAP]
+};
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+const quote = await soroswapClient.quote(quoteRequest);
+
+// Type-safe access to quote properties
+if (quote.tradeType === TradeType.EXACT_IN) {
+  const exactInQuote = quote as ExactInBuildTradeReturn;
+  console.log('Expected output:', exactInQuote.trade.expectedAmountOut);
+}
+```
 
 ## 🔗 Links
 
@@ -377,13 +433,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - [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. 
+Built with ❤️ by the Soroswap team.

package/dist/types/assets.d.ts

@@ -1,6 +1,6 @@
 export interface AssetInfo {
-    code: string;
-    issuer: string;
+    code?: string;
+    issuer?: string;
     contract?: string;
     name?: string;
     org?: string;

package/dist/types/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/types/assets.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/types/assets.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types/common.d.ts

@@ -21,7 +21,6 @@ export declare enum SupportedProtocols {
     SOROSWAP = "soroswap",
     PHOENIX = "phoenix",
     AQUA = "aqua",
-    COMET = "comet",
     SDEX = "sdex"
 }
 export interface SoroswapSDKConfig {

package/dist/types/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AACA,oBAAY,SAAS;IACnB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAGD,oBAAY,mBAAmB;IAC7B,QAAQ,8EAA8E;IACtF,cAAc,gEAAgE;IAC9E,MAAM,qDAAqD;IAC3D,IAAI,0EAA0E;CAC/E;AAED,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AACA,oBAAY,SAAS;IACnB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAGD,oBAAY,mBAAmB;IAC7B,QAAQ,8EAA8E;IACtF,cAAc,gEAAgE;IAC9E,MAAM,qDAAqD;IAC3D,IAAI,0EAA0E;CAC/E;AAED,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,IAAI,SAAS;IAEb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/common.js

@@ -31,7 +31,7 @@ var SupportedProtocols;
     SupportedProtocols["SOROSWAP"] = "soroswap";
     SupportedProtocols["PHOENIX"] = "phoenix";
     SupportedProtocols["AQUA"] = "aqua";
-    SupportedProtocols["COMET"] = "comet";
+    // COMET = 'comet',
     SupportedProtocols["SDEX"] = "sdex";
 })(SupportedProtocols || (exports.SupportedProtocols = SupportedProtocols = {}));
 //# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,kCAAqB,CAAA;IACrB,oCAAuB,CAAA;AACzB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAED,mBAAmB;AACnB,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,6GAAsF,CAAA;IACtF,qGAA8E,CAAA;IAC9E,kFAA2D,CAAA;IAC3D,qGAA8E,CAAA;AAChF,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B;AAED,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,+CAAyB,CAAA;IACzB,uCAAiB,CAAA;AACnB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;AACrB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B;AAED,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,yCAAmB,CAAA;IACnB,mCAAa,CAAA;IACb,qCAAe,CAAA;IACf,mCAAa,CAAA;AACf,CAAC,EANW,kBAAkB,kCAAlB,kBAAkB,QAM7B"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,kCAAqB,CAAA;IACrB,oCAAuB,CAAA;AACzB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAED,mBAAmB;AACnB,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,6GAAsF,CAAA;IACtF,qGAA8E,CAAA;IAC9E,kFAA2D,CAAA;IAC3D,qGAA8E,CAAA;AAChF,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B;AAED,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,+CAAyB,CAAA;IACzB,uCAAiB,CAAA;AACnB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;AACrB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B;AAED,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,yCAAmB,CAAA;IACnB,mCAAa,CAAA;IACb,mBAAmB;IACnB,mCAAa,CAAA;AACf,CAAC,EANW,kBAAkB,kCAAlB,kBAAkB,QAM7B"}

package/dist/types/quote.d.ts

@@ -6,10 +6,11 @@ export interface QuoteRequest {
     tradeType: TradeType;
     protocols: SupportedProtocols[];
     parts?: number;
-    slippageTolerance?: string;
+    slippageTolerance?: number;
     maxHops?: number;
     assetList?: SupportedAssetLists[];
     feeBps?: number;
+    gaslessTrustline?: boolean;
 }
 export interface BuildQuoteRequest {
     quote: QuoteResponse;
@@ -20,37 +21,6 @@ export interface BuildQuoteRequest {
 export interface BuildQuoteResponse {
     xdr: string;
 }
-export interface CommonBuildTradeReturnFields {
-    assetIn: string;
-    assetOut: string;
-    priceImpact: {
-        numerator: bigint;
-        denominator: bigint;
-    };
-    platform: SupportedPlatforms;
-    feeBps?: number;
-    feeAmount?: bigint;
-}
-export interface ExactInBuildTradeReturn extends CommonBuildTradeReturnFields {
-    tradeType: TradeType.EXACT_IN;
-    trade: {
-        amountIn: bigint;
-        amountOutMin: bigint;
-        expectedAmountOut?: bigint;
-        path: string[];
-        poolHashes?: string[];
-    };
-}
-export interface ExactOutBuildTradeReturn extends CommonBuildTradeReturnFields {
-    tradeType: TradeType.EXACT_OUT;
-    trade: {
-        amountOut: bigint;
-        amountInMax: bigint;
-        expectedAmountIn?: bigint;
-        path: string[];
-        poolHashes?: string[];
-    };
-}
 export interface DistributionReturn {
     protocol_id: SupportedProtocols;
     path: string[];
@@ -58,25 +28,108 @@ export interface DistributionReturn {
     is_exact_in: boolean;
     poolHashes?: string[];
 }
-export interface ExactInSplitBuildTradeReturn extends CommonBuildTradeReturnFields {
-    tradeType: TradeType.EXACT_IN;
-    trade: {
-        amountIn: bigint;
-        amountOutMin: bigint;
-        expectedAmountOut?: bigint;
-        distribution: DistributionReturn[];
+export interface BaseExactInTrade {
+    amountIn: bigint;
+    amountOutMin: bigint;
+}
+export interface ExactInTradeWithPath extends BaseExactInTrade {
+    path: string[];
+    distribution?: never;
+}
+export interface ExactInTradeWithDistribution extends BaseExactInTrade {
+    path?: never;
+    distribution: DistributionReturn[];
+}
+export type ExactInTrade = ExactInTradeWithPath | ExactInTradeWithDistribution;
+export interface BaseExactOutTrade {
+    amountOut: bigint;
+    amountInMax: bigint;
+}
+export interface ExactOutTradeWithPath extends BaseExactOutTrade {
+    path: string[];
+    distribution?: never;
+}
+export interface ExactOutTradeWithDistribution extends BaseExactOutTrade {
+    path?: never;
+    distribution: DistributionReturn[];
+}
+export type ExactOutTrade = ExactOutTradeWithPath | ExactOutTradeWithDistribution;
+export interface HorizonPath {
+    asset_type: string;
+    asset_code: string;
+    asset_issuer: string;
+}
+export interface HorizonBaseStrictPaths {
+    source_asset_type: string;
+    source_amount: string;
+    max_source_amount?: string;
+    source_asset_code?: string;
+    source_asset_issuer?: string;
+    destination_asset_type: string;
+    destination_amount: string;
+    min_destination_amount?: string;
+    destination_asset_code?: string;
+    destination_asset_issuer?: string;
+    path: HorizonPath[];
+}
+export interface HorizonTrustlineStrictPaths extends HorizonBaseStrictPaths {
+    trustlineStuff?: {
+        totalOut?: string;
+        expectedOut?: string;
+        minimumOut?: string;
+        swapPath?: HorizonBaseStrictPaths;
+        repayIn?: string;
+        maxRepayIn?: string;
+        repayPath?: HorizonBaseStrictPaths;
+        trustlineCostAssetIn?: string;
+        trustlineCostAssetOut?: string;
+        finalExpectedIn?: string;
+        finalMaximumIn?: string;
+        expectedSwapIn?: string;
+        maximumSwapIn?: string;
+        expectedTrustlineCostIn?: string;
+        maximumTrustlineCostIn?: string;
+        trustlineCostPath?: HorizonBaseStrictPaths;
+        trustlineEquivalentAssetOut?: string;
     };
 }
-export interface ExactOutSplitBuildTradeReturn extends CommonBuildTradeReturnFields {
-    tradeType: TradeType.EXACT_OUT;
-    trade: {
-        amountOut: bigint;
-        amountInMax: bigint;
-        expectedAmountIn?: bigint;
-        distribution: DistributionReturn[];
+export type HorizonStrictPaths = HorizonBaseStrictPaths | HorizonTrustlineStrictPaths;
+export interface RoutePlan {
+    swapInfo: {
+        protocol: SupportedProtocols;
+        path: string[];
     };
+    percent: string;
+}
+export interface PlatformFee {
+    feeBps: number;
+    feeAmount: bigint;
+}
+export interface TrustlineInfo {
+    trustlineCostAssetIn: string;
+    trustlineCostAssetOut: string;
+}
+interface BaseQuoteResponse {
+    assetIn: string;
+    amountIn: bigint;
+    assetOut: string;
+    amountOut: bigint;
+    otherAmountThreshold: bigint;
+    priceImpactPct: string;
+    platform: SupportedPlatforms;
+    routePlan: RoutePlan[];
+    trustlineInfo?: TrustlineInfo;
+    platformFee?: PlatformFee;
+    gaslessTrustline?: boolean;
+}
+export interface ExactInQuoteResponse extends BaseQuoteResponse {
+    tradeType: TradeType.EXACT_IN;
+    rawTrade: ExactInTrade | HorizonStrictPaths;
+}
+export interface ExactOutQuoteResponse extends BaseQuoteResponse {
+    tradeType: TradeType.EXACT_OUT;
+    rawTrade: ExactOutTrade | HorizonStrictPaths;
 }
-export type BuildTradeReturn = ExactInBuildTradeReturn | ExactOutBuildTradeReturn;
-export type BuildSplitTradeReturn = ExactInSplitBuildTradeReturn | ExactOutSplitBuildTradeReturn;
-export type QuoteResponse = BuildTradeReturn | BuildSplitTradeReturn;
+export type QuoteResponse = ExactInQuoteResponse | ExactOutQuoteResponse;
+export {};
 //# sourceMappingURL=quote.d.ts.map

package/dist/types/quote.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soroswap/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Official TypeScript SDK for Soroswap.Finance API - DEX and exchange aggregator on Stellar",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",