logiqical 0.0.9 → 0.0.11

package/README.md

@@ -1,6 +1,6 @@
 # logiqical
 
-The complete SDK for AI agents trading on Avalanche. Swaps, staking, launchpad, DEX — one package, zero config.
+The complete SDK for AI agents trading on Avalanche. Swaps, staking, launchpad, token launches, DEX — one package, zero config.
 
 ## Install
 
@@ -22,6 +22,12 @@ const bal = await client.swap.getBalances("0xYourWallet");
 // Discover trending launchpad tokens
 const hot = await client.launchpad.getTopVolume("24h");
 
+// Launch your own token on Arena
+const launch = await client.launchpad.launch(wallet, "My Token", "MTK", imageBase64);
+
+// Buy a graduated token via Arena DEX
+const buy = await client.launchpad.buildBuy(wallet, tokenId, "0.1");
+
 // Swap any token pair
 const tx = await client.dex.buildSwap(wallet, "AVAX", "USDC", "1.0");
 
@@ -50,8 +56,9 @@ await client.broadcast(signedTx);
 | `buildBuyAndStake(wallet, avax, slippage?)` | Buy + stake in one flow |
 | `buildUnstake(wallet, amount)` | Unstake and claim rewards |
 
-### `client.launchpad` — Token Discovery & Trading
+### `client.launchpad` — Token Discovery, Trading & Launch
 
+#### Discovery
 | Method | Description |
 |--------|-------------|
 | `getRecent(count?, type?)` | Latest launched tokens |
@@ -59,6 +66,10 @@ await client.broadcast(signedTx);
 | `getGraduating(count?)` | Tokens about to graduate to DEX |
 | `getGraduated(count?)` | Already graduated tokens |
 | `search(query)` | Find by name, symbol, or address |
+
+#### Intelligence
+| Method | Description |
+|--------|-------------|
 | `getToken(tokenId?, address?)` | Full token profile + stats |
 | `getHolders(address?, tokenId?, count?)` | Top holders with PnL |
 | `getActivity(tokenId?, address?, count?)` | Recent trade history |
@@ -67,8 +78,19 @@ await client.broadcast(signedTx);
 | `getPortfolio(wallet)` | Your tracked positions |
 | `getMarketCap(tokenId)` | Market cap breakdown |
 | `getOverview()` | Platform stats |
-| `buildBuy(wallet, tokenId, avax, slippage?)` | Buy launchpad token |
-| `buildSell(wallet, tokenId, amount, slippage?)` | Sell (`"max"` for all) |
+
+#### Trading
+| Method | Description |
+|--------|-------------|
+| `buildBuy(wallet, tokenId, avax, slippage?)` | Buy launchpad token (auto-routes graduated tokens via Arena DEX) |
+| `buildSell(wallet, tokenId, amount, slippage?)` | Sell (`"max"` for all, auto-routes graduated) |
+
+#### Token Launch
+| Method | Description |
+|--------|-------------|
+| `launch(wallet, name, symbol, imageBase64?, paymentToken?, initialBuyAvax?)` | Full token launch — uploads image, creates Arena community, returns createToken tx |
+| `uploadImage(imageBase64, fileType?)` | Upload token image to Arena CDN |
+| `buildCreate(wallet, name, symbol, paymentToken?, initialBuyAvax?)` | Build only the createToken tx |
 
 ### `client.dex` — Swap Any Avalanche Token
 
@@ -88,6 +110,39 @@ await client.broadcast(signedTx);
 | `client.health()` | API health check |
 | `client.getInstructions()` | Full agent documentation |
 
+## Token Launch Flow
+
+Agents can launch their own tokens on Arena with a single SDK call:
+
+```typescript
+import { readFileSync } from "fs";
+
+const imageBase64 = readFileSync("token-logo.jpg").toString("base64");
+
+const result = await client.launchpad.launch(
+  "0xYourWallet",
+  "My Token",        // token name
+  "MTK",             // ticker symbol
+  imageBase64,       // token image (optional)
+  "arena",           // "arena" or "avax" paired
+);
+
+// result.transaction — unsigned createToken tx to sign & broadcast
+// result.community — Arena community metadata
+// result.imageUrl — hosted image URL
+// result.instructions — step-by-step next actions
+```
+
+## Graduated Token Trading
+
+Tokens that graduate from the bonding curve automatically trade via Arena's DEX router. The SDK handles this seamlessly — `buildBuy` and `buildSell` detect graduation and route through Arena's Uniswap V4 pools + Yield Yak aggregator.
+
+```typescript
+// Works for both bonding curve AND graduated tokens
+const buy = await client.launchpad.buildBuy(wallet, tokenId, "0.5");
+// → Routes via bonding curve OR Arena DEX automatically
+```
+
 ## How It Works
 
 1. **Install** — `npm install logiqical`
@@ -115,14 +170,15 @@ const client = new LogiqicalClient({
 - **JSDoc everywhere** — AI agents understand methods from hover info
 - **Zero dependencies** — uses native `fetch` (Node 18+)
 - **CJS + ESM** — works with `require()` and `import`
-- **30+ methods** across 4 modules
+- **35+ methods** across 4 modules
+- **Token launches** — create tokens on Arena with image upload
+- **Smart routing** — graduated tokens auto-route via Arena DEX
 
 ## Built on
 
 - [Avalanche C-Chain](https://avax.network)
-- [LFJ DEX](https://lfj.gg)
-- [Pharaoh DEX](https://pharaoh.exchange)
-- [Arena](https://arenatrade.ai)
+- [Arena](https://arena.social)
+- [Arena DEX Router](https://snowtrace.io/address/0xDE9D7290959b6060860b983b32f2d65b2701EBC2)
 
 ## License
 

package/dist/index.d.mts

@@ -195,6 +195,32 @@ interface LaunchpadSellResponse {
     summary?: string;
     note?: string;
 }
+interface ArenaCommunity {
+    id: string;
+    signer: string;
+    isTemporary: boolean;
+    name: string;
+    tokenName: string;
+    ticker: string;
+    photoURL: string;
+    paymentToken: string;
+    contractAddress: string | null;
+    createdOn: string;
+}
+interface LaunchTokenResponse {
+    community: ArenaCommunity;
+    imageUrl: string;
+    transaction: UnsignedTx;
+    nextTokenId: string;
+    instructions: string[];
+}
+interface UploadImageResponse {
+    imageUrl: string;
+}
+interface BuildCreateResponse {
+    transaction: UnsignedTx;
+    nextTokenId: string;
+}
 interface DexTokenEntry {
     symbol: string;
     address: string;
@@ -407,6 +433,36 @@ declare class LaunchpadModule {
      * @param offset - Pagination offset
      */
     getTrades(count?: number, offset?: number): Promise<GlobalTradesResponse>;
+    /**
+     * Launch a new token on Arena — uploads image, creates community, and returns the unsigned createToken transaction.
+     *
+     * @param wallet - Creator wallet address
+     * @param name - Token name (also used as community name)
+     * @param symbol - Token ticker symbol
+     * @param imageBase64 - Token image as base64 string (optional)
+     * @param paymentToken - "avax" or "arena" (default: "arena")
+     * @param initialBuyAvax - AVAX amount for initial buy at creation (default: "0")
+     */
+    launch(wallet: string, name: string, symbol: string, imageBase64?: string, paymentToken?: "avax" | "arena", initialBuyAvax?: string): Promise<LaunchTokenResponse>;
+    /**
+     * Upload a token image to Arena's CDN and get the hosted URL.
+     * Use this before launch() if you want to preview the image URL first.
+     *
+     * @param imageBase64 - Image as base64 string
+     * @param fileType - MIME type (default: "image/jpeg")
+     */
+    uploadImage(imageBase64: string, fileType?: string): Promise<UploadImageResponse>;
+    /**
+     * Build only the createToken transaction (no image or community creation).
+     * Useful if you want to handle image upload and community creation separately.
+     *
+     * @param wallet - Creator wallet address
+     * @param name - Token name
+     * @param symbol - Token ticker symbol
+     * @param paymentToken - "avax" or "arena" (default: "arena")
+     * @param initialBuyAvax - AVAX for initial buy (default: "0")
+     */
+    buildCreate(wallet: string, name: string, symbol: string, paymentToken?: "avax" | "arena", initialBuyAvax?: string): Promise<BuildCreateResponse>;
     /**
      * Build unsigned transaction to buy a launchpad token with AVAX.
      *
@@ -549,4 +605,4 @@ declare class LogiqicalAuthError extends LogiqicalError {
     constructor(endpoint: string);
 }
 
-export { type BalancesResponse, type BroadcastResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx };
+export { type ArenaCommunity, type BalancesResponse, type BroadcastResponse, type BuildCreateResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchTokenResponse, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx, type UploadImageResponse };

package/dist/index.d.ts

@@ -195,6 +195,32 @@ interface LaunchpadSellResponse {
     summary?: string;
     note?: string;
 }
+interface ArenaCommunity {
+    id: string;
+    signer: string;
+    isTemporary: boolean;
+    name: string;
+    tokenName: string;
+    ticker: string;
+    photoURL: string;
+    paymentToken: string;
+    contractAddress: string | null;
+    createdOn: string;
+}
+interface LaunchTokenResponse {
+    community: ArenaCommunity;
+    imageUrl: string;
+    transaction: UnsignedTx;
+    nextTokenId: string;
+    instructions: string[];
+}
+interface UploadImageResponse {
+    imageUrl: string;
+}
+interface BuildCreateResponse {
+    transaction: UnsignedTx;
+    nextTokenId: string;
+}
 interface DexTokenEntry {
     symbol: string;
     address: string;
@@ -407,6 +433,36 @@ declare class LaunchpadModule {
      * @param offset - Pagination offset
      */
     getTrades(count?: number, offset?: number): Promise<GlobalTradesResponse>;
+    /**
+     * Launch a new token on Arena — uploads image, creates community, and returns the unsigned createToken transaction.
+     *
+     * @param wallet - Creator wallet address
+     * @param name - Token name (also used as community name)
+     * @param symbol - Token ticker symbol
+     * @param imageBase64 - Token image as base64 string (optional)
+     * @param paymentToken - "avax" or "arena" (default: "arena")
+     * @param initialBuyAvax - AVAX amount for initial buy at creation (default: "0")
+     */
+    launch(wallet: string, name: string, symbol: string, imageBase64?: string, paymentToken?: "avax" | "arena", initialBuyAvax?: string): Promise<LaunchTokenResponse>;
+    /**
+     * Upload a token image to Arena's CDN and get the hosted URL.
+     * Use this before launch() if you want to preview the image URL first.
+     *
+     * @param imageBase64 - Image as base64 string
+     * @param fileType - MIME type (default: "image/jpeg")
+     */
+    uploadImage(imageBase64: string, fileType?: string): Promise<UploadImageResponse>;
+    /**
+     * Build only the createToken transaction (no image or community creation).
+     * Useful if you want to handle image upload and community creation separately.
+     *
+     * @param wallet - Creator wallet address
+     * @param name - Token name
+     * @param symbol - Token ticker symbol
+     * @param paymentToken - "avax" or "arena" (default: "arena")
+     * @param initialBuyAvax - AVAX for initial buy (default: "0")
+     */
+    buildCreate(wallet: string, name: string, symbol: string, paymentToken?: "avax" | "arena", initialBuyAvax?: string): Promise<BuildCreateResponse>;
     /**
      * Build unsigned transaction to buy a launchpad token with AVAX.
      *
@@ -549,4 +605,4 @@ declare class LogiqicalAuthError extends LogiqicalError {
     constructor(endpoint: string);
 }
 
-export { type BalancesResponse, type BroadcastResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx };
+export { type ArenaCommunity, type BalancesResponse, type BroadcastResponse, type BuildCreateResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchTokenResponse, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx, type UploadImageResponse };

package/dist/index.js

@@ -327,6 +327,53 @@ var LaunchpadModule = class {
     await this.auth();
     return this.http.get("/launchpad/trades", { count, offset });
   }
+  // ── Token Launch ──
+  /**
+   * Launch a new token on Arena — uploads image, creates community, and returns the unsigned createToken transaction.
+   *
+   * @param wallet - Creator wallet address
+   * @param name - Token name (also used as community name)
+   * @param symbol - Token ticker symbol
+   * @param imageBase64 - Token image as base64 string (optional)
+   * @param paymentToken - "avax" or "arena" (default: "arena")
+   * @param initialBuyAvax - AVAX amount for initial buy at creation (default: "0")
+   */
+  async launch(wallet, name, symbol, imageBase64, paymentToken = "arena", initialBuyAvax = "0") {
+    await this.auth();
+    return this.http.post("/launchpad/launch", {
+      wallet,
+      name,
+      symbol,
+      imageBase64,
+      paymentToken,
+      initialBuyAvax
+    });
+  }
+  /**
+   * Upload a token image to Arena's CDN and get the hosted URL.
+   * Use this before launch() if you want to preview the image URL first.
+   *
+   * @param imageBase64 - Image as base64 string
+   * @param fileType - MIME type (default: "image/jpeg")
+   */
+  async uploadImage(imageBase64, fileType = "image/jpeg") {
+    await this.auth();
+    return this.http.post("/launchpad/upload-image", { imageBase64, fileType });
+  }
+  /**
+   * Build only the createToken transaction (no image or community creation).
+   * Useful if you want to handle image upload and community creation separately.
+   *
+   * @param wallet - Creator wallet address
+   * @param name - Token name
+   * @param symbol - Token ticker symbol
+   * @param paymentToken - "avax" or "arena" (default: "arena")
+   * @param initialBuyAvax - AVAX for initial buy (default: "0")
+   */
+  async buildCreate(wallet, name, symbol, paymentToken = "arena", initialBuyAvax = "0") {
+    await this.auth();
+    return this.http.get("/launchpad/build/create", { wallet, name, symbol, paymentToken, initialBuyAvax });
+  }
   // ── Trading ──
   /**
    * Build unsigned transaction to buy a launchpad token with AVAX.

package/dist/index.mjs

@@ -295,6 +295,53 @@ var LaunchpadModule = class {
     await this.auth();
     return this.http.get("/launchpad/trades", { count, offset });
   }
+  // ── Token Launch ──
+  /**
+   * Launch a new token on Arena — uploads image, creates community, and returns the unsigned createToken transaction.
+   *
+   * @param wallet - Creator wallet address
+   * @param name - Token name (also used as community name)
+   * @param symbol - Token ticker symbol
+   * @param imageBase64 - Token image as base64 string (optional)
+   * @param paymentToken - "avax" or "arena" (default: "arena")
+   * @param initialBuyAvax - AVAX amount for initial buy at creation (default: "0")
+   */
+  async launch(wallet, name, symbol, imageBase64, paymentToken = "arena", initialBuyAvax = "0") {
+    await this.auth();
+    return this.http.post("/launchpad/launch", {
+      wallet,
+      name,
+      symbol,
+      imageBase64,
+      paymentToken,
+      initialBuyAvax
+    });
+  }
+  /**
+   * Upload a token image to Arena's CDN and get the hosted URL.
+   * Use this before launch() if you want to preview the image URL first.
+   *
+   * @param imageBase64 - Image as base64 string
+   * @param fileType - MIME type (default: "image/jpeg")
+   */
+  async uploadImage(imageBase64, fileType = "image/jpeg") {
+    await this.auth();
+    return this.http.post("/launchpad/upload-image", { imageBase64, fileType });
+  }
+  /**
+   * Build only the createToken transaction (no image or community creation).
+   * Useful if you want to handle image upload and community creation separately.
+   *
+   * @param wallet - Creator wallet address
+   * @param name - Token name
+   * @param symbol - Token ticker symbol
+   * @param paymentToken - "avax" or "arena" (default: "arena")
+   * @param initialBuyAvax - AVAX for initial buy (default: "0")
+   */
+  async buildCreate(wallet, name, symbol, paymentToken = "arena", initialBuyAvax = "0") {
+    await this.auth();
+    return this.http.get("/launchpad/build/create", { wallet, name, symbol, paymentToken, initialBuyAvax });
+  }
   // ── Trading ──
   /**
    * Build unsigned transaction to buy a launchpad token with AVAX.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logiqical",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "TypeScript SDK for AI agents to trade on Avalanche — swaps, staking, launchpad, DEX",
   "main": "dist/index.js",
   "module": "dist/index.mjs",