@gala-chain/launchpad-sdk 6.0.0 → 7.0.0-beta.1

package/EXAMPLES.md

@@ -35,10 +35,10 @@ Q: What operation am I performing?
 │   └── Use tokenName: sdk.buy({ tokenName: 'anime', amount: '100', type: 'native' })
 │
 ├── Swapping on DEX (GALA, GUSDC, graduated tokens)?
-│   └── Use tokenClassKey: sdk.executeSwap('GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0xa0b...', ...)
+│   └── Use tokenClassKey: sdk.dex.swaps.swap('GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0xa0b...', fee, { exactIn: '100', amountOutMinimum: '...' }) — queued, then await result.confirm()
 │
 ├── Managing liquidity positions on DEX?
-│   └── Use tokenClassKey: sdk.addSwapLiquidityByPrice({ token0: 'GALA|Unit|none|none', ... })
+│   └── Use tokenClassKey: sdk.dex.positions.addLiquidityByPrice({ token0: 'GALA|Unit|none|none', ... })
 │
 ├── Transferring tokens?
 │   ├── Launchpad token? → sdk.transferToken({ tokenName: 'anime', ... })
@@ -72,9 +72,9 @@ const WETH = 'GETH|Unit|none|eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2';
 
 | ❌ Wrong | ✅ Correct | Why |
 |----------|------------|-----|
-| `sdk.executeSwap('GALA', ...)` | `sdk.executeSwap('GALA\|Unit\|none\|none', ...)` | DEX requires full tokenClassKey |
+| `sdk.dex.swaps.swap('anime', ...)` (a launchpad tokenName) | `sdk.dex.swaps.swap('GALA\|Unit\|none\|none', ...)` or a registered symbol like `'GALA'` | DEX resolves registered symbols or full tokenClassKeys via `sdk.dex.symbols.list()` — it does not accept a bonding-curve `tokenName` |
 | `sdk.buy({ tokenName: 'ANIME\|Unit\|...' })` | `sdk.buy({ tokenName: 'anime' })` | Bonding curve uses simple names |
-| `sdk.getSwapQuoteExactInput('anime', ...)` | Get tokenClassKey from pool, then use it | DEX needs resolved tokenClassKey |
+| `sdk.dex.quoting.quoteExactInput('anime', ...)` | Get tokenClassKey from pool, then use it | DEX needs resolved tokenClassKey |
 | Assuming `buy()` works for graduated tokens | Check `isGraduated`, use DEX if true | Graduated tokens are on DEX |
 
 ### Detecting Graduation Status
@@ -106,11 +106,11 @@ if (isGraduated) {
 | `calculateBuyAmount()` | ✅ | ❌ | Pre-trade calculation |
 | `calculateSellAmount()` | ✅ | ❌ | Pre-trade calculation |
 | `fetchPools()` | ✅ | ❌ | Query bonding curve pools |
-| `executeSwap()` | ❌ | ✅ | DEX only |
-| `getSwapQuoteExactInput()` | ❌ | ✅ | DEX quotes |
-| `getSwapQuoteExactOutput()` | ❌ | ✅ | DEX quotes |
-| `addSwapLiquidityByPrice()` | ❌ | ✅ | LP operations |
-| `removeSwapLiquidity()` | ❌ | ✅ | LP operations |
+| `dex.swaps.swap()` | ❌ | ✅ | DEX only — queued RequestTrade, call `.confirm()` |
+| `dex.quoting.quoteExactInput()` | ❌ | ✅ | DEX quotes |
+| `dex.quoting.quoteExactOutput()` | ❌ | ✅ | DEX quotes |
+| `dex.positions.addLiquidityByPrice()` | ❌ | ✅ | LP operations |
+| `dex.positions.removeLiquidity()` | ❌ | ✅ | LP operations |
 | `fetchTokenPrice()` | ✅ | ✅ | Smart router auto-detects |
 | `transferToken()` | ✅ | ✅ | Both work (different paths) |
 | `lockTokens()` | ✅ | ✅ | Both work |
@@ -134,11 +134,11 @@ npm install @gala-chain/launchpad-sdk
 import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
 
 // Read-only mode (no wallet required)
-const sdk = createLaunchpadSDK({ environment: 'production' });
+const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // Full-access mode (with wallet for trading)
 const sdkWithWallet = createLaunchpadSDK({
-  environment: 'production',
+  env: 'prod',
   privateKey: process.env.WALLET_PRIVATE_KEY
 });
 ```
@@ -281,31 +281,31 @@ npm run demo:liquidity:ticks
 import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
 
 const sdk = createLaunchpadSDK({
-  environment: 'production'
+  env: 'prod'
 });
 
 // Query operations work without wallet
-const pools = await sdk.fetchDexPools({ search: 'GALA' });
-const prices = await sdk.fetchTokenSpotPrice('GALA');
+const pools = await sdk.dex.pools.getPools();
+const prices = await sdk.fetchTokenPrice({ tokenName: 'GALA' });
 ```
 
 **Full-Access Mode** (with wallet for trading):
 
 ```typescript
 const sdk = createLaunchpadSDK({
-  environment: 'production',
+  env: 'prod',
   privateKey: process.env.WALLET_PRIVATE_KEY
 });
 
-// Now you can execute trades
-const result = await sdk.executeSwap('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '100', ...);
+// Now you can submit trades (queued RequestTrade; await result.confirm() for the applied trade)
+const result = await sdk.dex.swaps.swap('GALA|Unit|none|none', 'GUSDC|Unit|none|none', 3000, { exactIn: '100' });
 ```
 
 **Dynamic Wallet Configuration:**
 
 ```typescript
 // Start in read-only mode
-const sdk = createLaunchpadSDK({ environment: 'production' });
+const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // Later, upgrade to full-access
 sdk.setWallet('your-private-key');
@@ -331,12 +331,12 @@ Provide liquidity to GalaSwap DEX pools and earn trading fees.
 import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
 
 const sdk = createLaunchpadSDK({
-  environment: 'production',
+  env: 'prod',
   privateKey: process.env.WALLET_PRIVATE_KEY
 });
 
-// Get all positions with automatic pagination (recommended)
-const positions = await sdk.getAllSwapUserLiquidityPositions('eth|0x...');
+// Get all current-contract positions for the owner
+const positions = await sdk.dex.positions.getUserPositions('eth|0x...');
 
 console.log(`Total positions: ${positions.length}`);
 
@@ -347,14 +347,14 @@ let totalFees = 0;
 positions.forEach(pos => {
   totalLiquidity += parseFloat(pos.liquidity || '0');
 
-  const fee0 = parseFloat(pos.feeAmount0 || '0');
-  const fee1 = parseFloat(pos.feeAmount1 || '0');
+  const fee0 = parseFloat(pos.fees0 || '0');
+  const fee1 = parseFloat(pos.fees1 || '0');
   totalFees += fee0 + fee1;
 
   console.log(`
-    Pool: ${pos.token0}/${pos.token1}
+    Pool: ${pos.token0Symbol}/${pos.token1Symbol}
     Liquidity: ${pos.liquidity}
-    Fees: ${pos.feeAmount0} ${pos.token0} + ${pos.feeAmount1} ${pos.token1}
+    Fees: ${pos.fees0} ${pos.token0Symbol} + ${pos.fees1} ${pos.token1Symbol}
   `);
 });
 
@@ -366,40 +366,40 @@ console.log(`Total Fees Earned: ${totalFees}`);
 
 ```typescript
 // Create position with user-friendly price range (v3.33.0+ requires delimited token format)
-const result = await sdk.addSwapLiquidityByPrice({
+const submitted = await sdk.dex.positions.addLiquidityByPrice({
   token0: 'GALA|Unit|none|none',
   token1: 'GUSDC|Unit|none|none',
   fee: 3000,              // 0.30% fee tier
   minPrice: '0.95',       // Active range: 0.95 - 1.05
   maxPrice: '1.05',
-  amount0Desired: '1000', // Provide 1000 GALA
-  amount1Desired: '1000', // Provide 1000 GUSDC
-  amount0Min: '900',      // Slippage protection (optional)
-  amount1Min: '900'
+  amount: '1000',         // Amount of the token below
+  amountIsToken0: true,   // Provide 1000 GALA (token0)
 });
 
-console.log(`Position created: ${result.positionId}`);
-console.log(`Liquidity provided: ${result.liquidity}`);
-console.log(`Amount0 used: ${result.amount0Used} GALA`);
-console.log(`Amount1 used: ${result.amount1Used} GUSDC`);
+console.log(`Submitted: ${submitted.transactionId} (mode: ${submitted.mode})`);
 
-// Wait for confirmation
-await result.wait();
-console.log('✓ Position confirmed on blockchain');
+// Wait for confirmation — resolves the created/refreshed position
+const position = await submitted.confirm();
+console.log(`✓ Position confirmed. Liquidity: ${position?.liquidity}`);
 ```
 
 ### Collect Fees Periodically
 
 ```typescript
-// Harvest accumulated fees without closing position
-const result = await sdk.collectSwapPositionFees({
-  ownerAddress: 'eth|0x...',
-  positionId: 'position-id-uuid'
+// Harvest accumulated fees without closing position (the contract does not support partial collection)
+const submitted = await sdk.dex.positions.collectPositionFees({
+  token0: 'GALA|Unit|none|none',
+  token1: 'GUSDC|Unit|none|none',
+  fee: 3000,
+  tickLower: position.tickLower,
+  tickUpper: position.tickUpper,
 });
 
+const collected = await submitted.confirm();
+
 console.log(`Collected fees:`);
-console.log(`  ${result.amount0Collected} GALA`);
-console.log(`  ${result.amount1Collected} GUSDC`);
+console.log(`  ${collected?.fees0} GALA`);
+console.log(`  ${collected?.fees1} GUSDC`);
 
 // Position remains active and continues earning fees
 ```
@@ -408,31 +408,32 @@ console.log(`  ${result.amount1Collected} GUSDC`);
 
 ```typescript
 // Step 1: Preview what you'll receive
-const estimate = await sdk.getSwapEstimateRemoveLiquidity(
-  'GALA',
-  'GUSDC',
-  3000,
-  position.liquidity,
-  position.tickLower,
-  position.tickUpper
-);
+const estimate = await sdk.dex.positions.estimateRemoveLiquidity({
+  token0: 'GALA|Unit|none|none',
+  token1: 'GUSDC|Unit|none|none',
+  fee: 3000,
+  tickLower: position.tickLower,
+  tickUpper: position.tickUpper,
+  liquidity: position.liquidity,
+});
 
 console.log(`Will receive:`);
-console.log(`  ${estimate.amount0} ${estimate.token0Symbol}`);
-console.log(`  ${estimate.amount1} ${estimate.token1Symbol}`);
-
-// Step 2: Remove full liquidity
-const result = await sdk.removeSwapLiquidity({
-  ownerAddress: 'eth|0x...',
-  positionId: position.positionId,
-  liquidity: position.liquidity,  // Full amount to close
-  amount0Min: estimate.amount0,   // Use estimated amounts
-  amount1Min: estimate.amount1,
-  deadline: Math.floor(Date.now() / 1000) + 3600  // 1 hour deadline
+console.log(`  ${estimate.amount0} GALA`);
+console.log(`  ${estimate.amount1} GUSDC`);
+
+// Step 2: Remove full liquidity (omitting both amount0/amount1 closes the position)
+const submitted = await sdk.dex.positions.removeLiquidity({
+  token0: 'GALA|Unit|none|none',
+  token1: 'GUSDC|Unit|none|none',
+  fee: 3000,
+  tickLower: position.tickLower,
+  tickUpper: position.tickUpper,
 });
 
+const closed = await submitted.confirm();
+
 console.log(`Position closed!`);
-console.log(`Withdrawn: ${result.amount0Withdrawn} GALA + ${result.amount1Withdrawn} GUSDC`);
+console.log(`Withdrawn: ${estimate.amount0} GALA + ${estimate.amount1} GUSDC`);
 ```
 
 **Liquidity Demos (12 total):**
@@ -472,7 +473,7 @@ Trade tokens that are still in bonding curve pools (pre-graduation).
 
 ```typescript
 const sdk = createLaunchpadSDK({
-  environment: 'production',
+  env: 'prod',
   privateKey: process.env.WALLET_PRIVATE_KEY
 });
 
@@ -558,69 +559,68 @@ Trade graduated tokens on the GalaSwap DEX.
 ### Get Swap Quote
 
 ```typescript
-const sdk = createLaunchpadSDK({ environment: 'production' });
+const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // Quote for exact input (how many GUSDC for 100 GALA?)
 // v3.33.0+ requires delimited token format
-const quoteInput = await sdk.getSwapQuoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '100');
+const quoteInput = await sdk.dex.quoting.quoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '100');
 
-console.log(`Spend 100 GALA → Receive ~${quoteInput.estimatedOutput} GUSDC`);
-console.log(`Price impact: ${(quoteInput.priceImpact * 100).toFixed(2)}%`);
-console.log(`Suggested fee tier: ${quoteInput.feeTier} bps`);
+console.log(`Spend 100 GALA → Receive ~${quoteInput.amountOut} GUSDC`);
+console.log(`Price impact: ${quoteInput.priceImpact ?? 'n/a'}`);
+console.log(`Fee tier: ${quoteInput.feeTier} bps`);
 
 // Quote for exact output (how much GALA to get 100 GUSDC?)
-const quoteOutput = await sdk.getSwapQuoteExactOutput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '100');
+const quoteOutput = await sdk.dex.quoting.quoteExactOutput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '100');
 
-console.log(`Need ${quoteOutput.inputAmount} GALA → Get 100 GUSDC`);
-console.log(`Price impact: ${(quoteOutput.priceImpact * 100).toFixed(2)}%`);
+console.log(`Need ${quoteOutput.amountIn} GALA → Get 100 GUSDC`);
+console.log(`Price impact: ${quoteOutput.priceImpact ?? 'n/a'}`);
 ```
 
-### Execute Swap
+### Submit and Confirm a Swap
 
 ```typescript
 const sdk = createLaunchpadSDK({
-  environment: 'production',
+  env: 'prod',
   privateKey: process.env.WALLET_PRIVATE_KEY
 });
 
 // Step 1: Get quote (v3.33.0+ requires delimited token format)
-const quote = await sdk.getSwapQuoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '100');
+const quote = await sdk.dex.quoting.quoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '100');
 
-// Step 2: Execute swap with 1% slippage protection
-const result = await sdk.executeSwap(
+// Step 2: Submit the queued RequestTrade with 1% slippage protection
+const submitted = await sdk.dex.swaps.swap(
   'GALA|Unit|none|none',
   'GUSDC|Unit|none|none',
-  '100',
-  quote.estimatedOutput,
   quote.feeTier,
-  0.01  // 1% slippage
+  { exactIn: '100', amountOutMinimum: quote.amountOut }  // amountOutMinimum should include your own slippage buffer
 );
 
-console.log(`Swap initiated: ${result.transactionId}`);
-console.log(`Expected output: ~${quote.estimatedOutput} GUSDC`);
+console.log(`Swap queued: ${submitted.transactionId} (mode: ${submitted.mode})`);
+console.log(`Expected output: ~${quote.amountOut} GUSDC`);
 
-// Step 3: Wait for confirmation
-await result.wait();
+// Step 3: Wait for the applied trade, or catch the chain's rejection
+const applied = await submitted.confirm();
 
-console.log(`✓ Swap completed!`);
-console.log(`Received: ${result.outputAmount} GUSDC`);
+console.log(`✓ Swap applied!`);
+console.log(`Applied transaction: ${applied.transactionId}`);
+console.log(`Result: ${JSON.stringify(applied.result)}`);
 ```
 
 ### Discover DEX Pools
 
 ```typescript
-// Find high-TVL pools
-const pools = await sdk.fetchDexPools({
-  search: 'GALA',
-  sortBy: 'tvl',
-  sortOrder: 'desc',
-  limit: 10
-});
-
-pools.pools.forEach(pool => {
-  console.log(`${pool.poolPair}: $${pool.tvl.toLocaleString()} TVL`);
-  console.log(`  24h Volume: $${pool.volume1d.toLocaleString()}`);
-  console.log(`  APR: ${pool.apr1d.toFixed(2)}%`);
+// Fetch every current-contract pool, then filter/sort client-side
+const pools = await sdk.dex.pools.getPools();
+
+const topGalaPools = pools
+  .filter(pool => pool.token0 === 'GALA' || pool.token1 === 'GALA')
+  .sort((a, b) => (b.tvlUsd ?? 0) - (a.tvlUsd ?? 0))
+  .slice(0, 10);
+
+topGalaPools.forEach(pool => {
+  console.log(`${pool.poolName}: $${(pool.tvlUsd ?? 0).toLocaleString()} TVL`);
+  console.log(`  24h Volume: $${(pool.volume1d ?? 0).toLocaleString()}`);
+  console.log(`  APR: ${(pool.apr1d ?? 0).toFixed(2)}%`);
 });
 ```
 
@@ -645,7 +645,7 @@ Competitive DEX leaderboard system with achievement tracking and platform-wide v
 ### Fetch All Seasons
 
 ```typescript
-const sdk = createLaunchpadSDK({ environment: 'production' });
+const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // Get all available competitive seasons
 const seasons = await sdk.fetchAllDexSeasons();
@@ -723,48 +723,57 @@ Liquidity provider fee workflows with multi-wallet testing.
 
 ```typescript
 const sdk = createLaunchpadSDK({
-  environment: 'production',
+  env: 'prod',
   privateKey: process.env.WALLET_PRIVATE_KEY
 });
 
 // Step 1: Create liquidity position (v3.33.0+ requires delimited token format)
-const position = await sdk.addSwapLiquidityByPrice({
+const positionTx = await sdk.dex.positions.addLiquidityByPrice({
   token0: 'GALA|Unit|none|none',
   token1: 'GUSDC|Unit|none|none',
   fee: 3000,
   minPrice: '0.95',
   maxPrice: '1.05',
-  amount0Desired: '1000',
-  amount1Desired: '1000'
+  amount: '1000',
+  amountIsToken0: true,
 });
 
-await position.wait();
-console.log(`Position created: ${position.positionId}`);
+const position = await positionTx.confirm();
+if (!position) throw new Error('Position confirmation returned null');
+console.log(`Position confirmed. Ticks: ${position.tickLower}..${position.tickUpper}`);
 
-// Step 2: Execute swaps to generate fees
+// Step 2: Submit swaps to generate fees (each is a queued RequestTrade; confirm each)
 for (let i = 0; i < 10; i++) {
-  const swap = await sdk.executeSwap('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '10', ...);
-  await swap.wait();
+  const swapTx = await sdk.dex.swaps.swap('GALA|Unit|none|none', 'GUSDC|Unit|none|none', 3000, { exactIn: '10' });
+  await swapTx.confirm();
   console.log(`Swap ${i + 1} completed`);
 }
 
 // Step 3: Check accumulated fees
-const positionData = await sdk.getSwapLiquidityPositionById(
-  'eth|0x...',
-  position.positionId
-);
+const positionData = await sdk.dex.positions.getPosition({
+  token0: 'GALA|Unit|none|none',
+  token1: 'GUSDC|Unit|none|none',
+  fee: 3000,
+  owner: 'eth|0x...',
+  tickLower: position.tickLower,
+  tickUpper: position.tickUpper,
+});
 
 console.log(`Fees accumulated:`);
-console.log(`  ${positionData.feeAmount0} GALA`);
-console.log(`  ${positionData.feeAmount1} GUSDC`);
+console.log(`  ${positionData?.fees0} GALA`);
+console.log(`  ${positionData?.fees1} GUSDC`);
 
 // Step 4: Collect fees
-const collected = await sdk.collectSwapPositionFees({
-  ownerAddress: 'eth|0x...',
-  positionId: position.positionId
+const collectTx = await sdk.dex.positions.collectPositionFees({
+  token0: 'GALA|Unit|none|none',
+  token1: 'GUSDC|Unit|none|none',
+  fee: 3000,
+  tickLower: position.tickLower,
+  tickUpper: position.tickUpper,
 });
 
-console.log(`✓ Collected: ${collected.amount0Collected} + ${collected.amount1Collected}`);
+const collected = await collectTx.confirm();
+console.log(`✓ Collected: ${collected?.fees0} GALA + ${collected?.fees1} GUSDC`);
 ```
 
 ### High-Volume Fee Testing
@@ -777,9 +786,12 @@ const swapAmount = '50'; // 50 GALA per swap
 console.log(`Generating ${highVolumeSwaps} swaps...`);
 
 for (let i = 0; i < highVolumeSwaps; i++) {
-  const quote = await sdk.getSwapQuoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', swapAmount);
-  const swap = await sdk.executeSwap('GALA|Unit|none|none', 'GUSDC|Unit|none|none', swapAmount, quote.estimatedOutput, quote.feeTier, 0.01);
-  await swap.wait();
+  const quote = await sdk.dex.quoting.quoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', swapAmount);
+  const swapTx = await sdk.dex.swaps.swap('GALA|Unit|none|none', 'GUSDC|Unit|none|none', quote.feeTier, {
+    exactIn: swapAmount,
+    amountOutMinimum: quote.amountOut,
+  });
+  await swapTx.confirm();
 
   if ((i + 1) % 10 === 0) {
     console.log(`${i + 1}/${highVolumeSwaps} swaps completed`);
@@ -806,29 +818,19 @@ Monitor pool and token creation events using WebSocket event watchers.
 
 ### Watch for DEX Pool Creation
 
+`sdk.onDexPoolCreation()` no longer exists. Current-contract pool-creation events are pushed
+over the GDEX stream via `sdk.getGdexStreamService().subscribePoolCreated()`:
+
 ```typescript
-const sdk = createLaunchpadSDK({ environment: 'production' });
-
-// Monitor for 60 seconds
-const unsubscribe = sdk.onDexPoolCreation(
-  (pool) => {
-    console.log(`🆕 New pool: ${pool.poolPair}`);
-    console.log(`   TVL: $${pool.tvl.toFixed(2)}`);
-    console.log(`   24h Volume: $${pool.volume1d.toFixed(2)}`);
-    console.log(`   Fee tier: ${pool.fee}%`);
-  },
-  {
-    minTVL: 1000,                    // Only pools with $1k+ TVL
-    tokens: ['GALA', 'GUSDC'],       // Only these token pairs
-    intervalMs: 30000                // Poll every 30 seconds
-  }
-);
+const sdk = createLaunchpadSDK({ env: 'prod' });
 
-// Stop watching after 60 seconds
-setTimeout(() => {
-  unsubscribe();
-  console.log('Stopped watching for new pools');
-}, 60000);
+const gdexStream = sdk.getGdexStreamService();
+const subscription = await gdexStream.subscribePoolCreated((event) => {
+  console.log('🆕 New pool created:', event);
+});
+
+// Stop watching
+await subscription.unsubscribe();
 ```
 
 ### Watch for Launchpad Token Creation
@@ -869,7 +871,7 @@ Live streaming and real-time chat features for token communities.
 
 ```typescript
 const sdk = createLaunchpadSDK({
-  environment: 'production',
+  env: 'prod',
   privateKey: process.env.WALLET_PRIVATE_KEY,
   streamWebSocketUrl: 'wss://stream.example.com'
 });
@@ -981,18 +983,18 @@ await sdk.connectStreamWebSocket({
 ### Portfolio & Balances
 
 ```typescript
-const sdk = createLaunchpadSDK({ environment: 'production' });
+const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // GALA balance
 const galaBalance = await sdk.fetchGalaBalance('eth|0x...');
 console.log(`GALA: ${galaBalance.balance}`);
 
 // Token balance on DEX
-const assets = await sdk.getSwapUserAssets('eth|0x...');
+const assets = await sdk.dex.assets.getUserAssets('eth|0x...');
 
 console.log('DEX Assets:');
-assets.forEach(asset => {
-  console.log(`  ${asset.symbol}: ${asset.balance}`);
+assets.tokens.forEach(asset => {
+  console.log(`  ${asset.symbol}: ${asset.quantity}`);
 });
 
 // Tokens you hold
@@ -1108,7 +1110,7 @@ Common error patterns and solutions.
 
 ```typescript
 try {
-  const quote = await sdk.getSwapQuoteExactInput('GALA', 'INVALID', '100');
+  const quote = await sdk.dex.quoting.quoteExactInput('GALA', 'INVALID', '100');
 } catch (error) {
   if (error.message.includes('Pool not found')) {
     console.log('Token pair not available on DEX');
@@ -1127,7 +1129,7 @@ try {
 ```typescript
 import { ValidationError } from '@gala-chain/launchpad-sdk';
 
-const sdk = createLaunchpadSDK({ environment: 'production' });
+const sdk = createLaunchpadSDK({ env: 'prod' });
 // No wallet configured
 
 try {
@@ -1144,15 +1146,16 @@ try {
 
 ```typescript
 try {
-  const quote = await sdk.getSwapQuoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '10000');
-  const result = await sdk.executeSwap(
-    'GALA',
-    'GUSDC',
-    '10000',
-    quote.estimatedOutput,
+  const quote = await sdk.dex.quoting.quoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|none', '10000');
+  const slippageTolerance = 0.01; // 1%
+  const amountOutMinimum = (Number(quote.amountOut) * (1 - slippageTolerance)).toString();
+  const submitted = await sdk.dex.swaps.swap(
+    'GALA|Unit|none|none',
+    'GUSDC|Unit|none|none',
     quote.feeTier,
-    0.01  // 1% slippage tolerance
+    { exactIn: '10000', amountOutMinimum },
   );
+  const applied = await submitted.confirm();
 } catch (error) {
   if (error.message.includes('slippage')) {
     console.log('Price moved beyond slippage tolerance');

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Gala Launchpad Team
+
+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.