@blockrun/llm 2.13.0 → 3.1.0

package/README.md

@@ -83,7 +83,7 @@ Four call shapes cover every endpoint type:
 - `stream<T>(path, body?)` — async iterator over SSE chunks (chat)
 
 The per-API client classes (`LLMClient`, `ImageClient`, `VideoClient`,
-`PortraitClient`, `VoiceClient`, `MusicClient`, `SearchClient`, `XClient`,
+`PortraitClient`, `VoiceClient`, `MusicClient`, `SearchClient`, `RpcClient`,
 `PriceClient`, `SurfClient`) all remain — they will be soft-deprecated in 2.6 (rewritten as
 shims over `BlockrunClient`) and removed in 3.0.
 
@@ -593,21 +593,6 @@ console.log(result.summary);
 for (const url of result.citations ?? []) console.log(url);
 ```
 
-### X/Twitter (AttentionVC)
-
-`XClient` covers the full `/v1/x/*` endpoint family — previously the `X*`
-types were exported but there was no client to call them with.
-
-```ts
-import { XClient } from '@blockrun/llm';
-
-const x = new XClient();
-const info = await x.userInfo('elonmusk');
-const followers = await x.followers('paulg');
-const results = await x.search('x402 micropayments', { queryType: 'Latest' });
-const tweets = await x.userTweets({ username: 'vitalikbuterin', includeReplies: false });
-```
-
 ### Surf Crypto Data
 
 `SurfClient` exposes the full `/v1/surf/*` catalog — 84+ pay-per-call
@@ -684,6 +669,37 @@ const symbols = await p.listSymbols('crypto', { query: 'sol', limit: 20 });
 
 Supported `StockMarket` values: `us, hk, jp, kr, gb, de, fr, nl, ie, lu, cn, ca`.
 
+### DeFi Data, DEX Swaps & Cloud Compute
+
+Three passthrough families live directly on `LLMClient` / `SolanaLLMClient`:
+
+```ts
+const client = new LLMClient();
+
+// DefiLlama — protocols / TVL / yields / prices ($0.005/call, prices $0.001)
+const protocols = await client.defiProtocols();
+const aave = await client.defiProtocol('aave');
+const prices = await client.defiPrices(['coingecko:bitcoin', 'base:0x833589...']);
+
+// 0x DEX — swap + gasless quotes (FREE; BlockRun takes an on-chain affiliate
+// fee on executed swaps instead of x402)
+const quote = await client.dexQuote({
+  chainId: '8453', sellToken: '0x...', buyToken: '0x...',
+  sellAmount: '1000000', taker: '0xYourWallet',
+});
+const gq = await client.dexGaslessQuote({ /* ... */ });
+const res = await client.dexGaslessSubmit({ trade: { /* signed eip712 */ } });
+const status = await client.dexGaslessStatus(res.tradeHash as string);
+
+// Modal — sandboxed compute ($0.01 create CPU / $0.05 GPU, $0.001 exec)
+const sb = await client.modalSandboxCreate({ image: 'python:3.11' });
+const out = await client.modalSandboxExec(sb.sandbox_id as string, ['python', '-c', 'print(42)']);
+await client.modalSandboxTerminate(sb.sandbox_id as string);
+```
+
+Generic escape hatches: `client.defi(path, params)`, `client.dex(path, params, body?)`,
+`client.modal(path, body)`.
+
 ### Multi-chain RPC
 
 `RpcClient` wraps `POST /v1/rpc/{network}` — standard JSON-RPC 2.0 access to
@@ -737,38 +753,6 @@ gateway cache — same price, lower latency.
 
 *Testnet models use flat pricing (no token counting) for simplicity.*
 
-## X/Twitter Data (Powered by AttentionVC)
-
-Access X/Twitter user profiles, followers, and followings via [AttentionVC](https://attentionvc.ai) partner API. No API keys needed — pay-per-request via x402.
-
-```typescript
-import { LLMClient } from '@blockrun/llm';
-
-const client = new LLMClient();
-
-// Look up user profiles ($0.002/user, min $0.02)
-const users = await client.xUserLookup(['elonmusk', 'blockaborr']);
-for (const user of users.users) {
-  console.log(`@${user.userName}: ${user.followers} followers`);
-}
-
-// Get followers ($0.05/page, ~200 accounts)
-let result = await client.xFollowers('blockaborr');
-for (const f of result.followers) {
-  console.log(`  @${f.screen_name}`);
-}
-
-// Paginate through all followers
-while (result.has_next_page) {
-  result = await client.xFollowers('blockaborr', result.next_cursor);
-}
-
-// Get followings ($0.05/page)
-const followings = await client.xFollowings('blockaborr');
-```
-
-Works on both `LLMClient` (Base) and `SolanaLLMClient`.
-
 ## Standalone Search
 
 Search web, X/Twitter, and news without using a chat model:
@@ -1290,7 +1274,6 @@ The SDK caches responses to avoid duplicate payments:
 import { getCachedByRequest, saveToCache, clearCache } from '@blockrun/llm';
 
 // Automatic TTLs by endpoint:
-// - X/Twitter: 1 hour
 // - Search: 15 minutes
 // - Models: 24 hours
 // - Chat/Image: no cache (every call is unique)