logiqical 0.0.10 → 0.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +64 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # logiqical
2
2
 
3
- The complete SDK for AI agents trading on Avalanche. Swaps, staking, launchpad, DEX — one package, zero config.
3
+ The complete SDK for AI agents trading on Avalanche. Swaps, staking, launchpad, token launches, DEX — one package, zero config.
4
4
 
5
5
  ## Install
6
6
 
@@ -22,6 +22,12 @@ const bal = await client.swap.getBalances("0xYourWallet");
22
22
  // Discover trending launchpad tokens
23
23
  const hot = await client.launchpad.getTopVolume("24h");
24
24
 
25
+ // Launch your own token on Arena
26
+ const launch = await client.launchpad.launch(wallet, "My Token", "MTK", imageBase64);
27
+
28
+ // Buy a graduated token via Arena DEX
29
+ const buy = await client.launchpad.buildBuy(wallet, tokenId, "0.1");
30
+
25
31
  // Swap any token pair
26
32
  const tx = await client.dex.buildSwap(wallet, "AVAX", "USDC", "1.0");
27
33
 
@@ -50,8 +56,9 @@ await client.broadcast(signedTx);
50
56
  | `buildBuyAndStake(wallet, avax, slippage?)` | Buy + stake in one flow |
51
57
  | `buildUnstake(wallet, amount)` | Unstake and claim rewards |
52
58
 
53
- ### `client.launchpad` — Token Discovery & Trading
59
+ ### `client.launchpad` — Token Discovery, Trading & Launch
54
60
 
61
+ #### Discovery
55
62
  | Method | Description |
56
63
  |--------|-------------|
57
64
  | `getRecent(count?, type?)` | Latest launched tokens |
@@ -59,6 +66,10 @@ await client.broadcast(signedTx);
59
66
  | `getGraduating(count?)` | Tokens about to graduate to DEX |
60
67
  | `getGraduated(count?)` | Already graduated tokens |
61
68
  | `search(query)` | Find by name, symbol, or address |
69
+
70
+ #### Intelligence
71
+ | Method | Description |
72
+ |--------|-------------|
62
73
  | `getToken(tokenId?, address?)` | Full token profile + stats |
63
74
  | `getHolders(address?, tokenId?, count?)` | Top holders with PnL |
64
75
  | `getActivity(tokenId?, address?, count?)` | Recent trade history |
@@ -67,8 +78,19 @@ await client.broadcast(signedTx);
67
78
  | `getPortfolio(wallet)` | Your tracked positions |
68
79
  | `getMarketCap(tokenId)` | Market cap breakdown |
69
80
  | `getOverview()` | Platform stats |
70
- | `buildBuy(wallet, tokenId, avax, slippage?)` | Buy launchpad token |
71
- | `buildSell(wallet, tokenId, amount, slippage?)` | Sell (`"max"` for all) |
81
+
82
+ #### Trading
83
+ | Method | Description |
84
+ |--------|-------------|
85
+ | `buildBuy(wallet, tokenId, avax, slippage?)` | Buy launchpad token (auto-routes graduated tokens via Arena DEX) |
86
+ | `buildSell(wallet, tokenId, amount, slippage?)` | Sell (`"max"` for all, auto-routes graduated) |
87
+
88
+ #### Token Launch
89
+ | Method | Description |
90
+ |--------|-------------|
91
+ | `launch(wallet, name, symbol, imageBase64?, paymentToken?, initialBuyAvax?)` | Full token launch — uploads image, creates Arena community, returns createToken tx |
92
+ | `uploadImage(imageBase64, fileType?)` | Upload token image to Arena CDN |
93
+ | `buildCreate(wallet, name, symbol, paymentToken?, initialBuyAvax?)` | Build only the createToken tx |
72
94
 
73
95
  ### `client.dex` — Swap Any Avalanche Token
74
96
 
@@ -88,6 +110,39 @@ await client.broadcast(signedTx);
88
110
  | `client.health()` | API health check |
89
111
  | `client.getInstructions()` | Full agent documentation |
90
112
 
113
+ ## Token Launch Flow
114
+
115
+ Agents can launch their own tokens on Arena with a single SDK call:
116
+
117
+ ```typescript
118
+ import { readFileSync } from "fs";
119
+
120
+ const imageBase64 = readFileSync("token-logo.jpg").toString("base64");
121
+
122
+ const result = await client.launchpad.launch(
123
+ "0xYourWallet",
124
+ "My Token", // token name
125
+ "MTK", // ticker symbol
126
+ imageBase64, // token image (optional)
127
+ "arena", // "arena" or "avax" paired
128
+ );
129
+
130
+ // result.transaction — unsigned createToken tx to sign & broadcast
131
+ // result.community — Arena community metadata
132
+ // result.imageUrl — hosted image URL
133
+ // result.instructions — step-by-step next actions
134
+ ```
135
+
136
+ ## Graduated Token Trading
137
+
138
+ 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.
139
+
140
+ ```typescript
141
+ // Works for both bonding curve AND graduated tokens
142
+ const buy = await client.launchpad.buildBuy(wallet, tokenId, "0.5");
143
+ // → Routes via bonding curve OR Arena DEX automatically
144
+ ```
145
+
91
146
  ## How It Works
92
147
 
93
148
  1. **Install** — `npm install logiqical`
@@ -115,14 +170,15 @@ const client = new LogiqicalClient({
115
170
  - **JSDoc everywhere** — AI agents understand methods from hover info
116
171
  - **Zero dependencies** — uses native `fetch` (Node 18+)
117
172
  - **CJS + ESM** — works with `require()` and `import`
118
- - **30+ methods** across 4 modules
173
+ - **35+ methods** across 4 modules
174
+ - **Token launches** — create tokens on Arena with image upload
175
+ - **Smart routing** — graduated tokens auto-route via Arena DEX
119
176
 
120
177
  ## Built on
121
178
 
122
179
  - [Avalanche C-Chain](https://avax.network)
123
- - [LFJ DEX](https://lfj.gg)
124
- - [Pharaoh DEX](https://pharaoh.exchange)
125
- - [Arena](https://arenatrade.ai)
180
+ - [Arena](https://arena.social)
181
+ - [Arena DEX Router](https://snowtrace.io/address/0xDE9D7290959b6060860b983b32f2d65b2701EBC2)
126
182
 
127
183
  ## License
128
184
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "logiqical",
3
- "version": "0.0.10",
3
+ "version": "0.0.11",
4
4
  "description": "TypeScript SDK for AI agents to trade on Avalanche — swaps, staking, launchpad, DEX",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",