@blockrun/llm 3.0.0 → 3.2.0

package/README.md

@@ -669,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

package/dist/index.cjs

@@ -1703,6 +1703,120 @@ var LLMClient = class _LLMClient {
   async pmWalletCluster(address) {
     return this.pm(`polymarket/wallet/${address}/cluster`);
   }
+  // ============================================================
+  // DefiLlama (DeFi protocols / TVL / yields / prices)
+  // ============================================================
+  /**
+   * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+   * $0.005/call for protocols / protocol/{slug} / chains / yields;
+   * $0.001/call for prices/{coins}.
+   *
+   * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+   *               "prices/coingecko:bitcoin,base:0x..."
+   * @param params - Query parameters passed through to DefiLlama
+   */
+  async defi(path5, params) {
+    return this.getWithPaymentRaw(`/v1/defillama/${path5}`, params);
+  }
+  /** All DeFi protocols with TVL ($0.005/call). */
+  async defiProtocols() {
+    return this.defi("protocols");
+  }
+  /** Single protocol details + historical TVL ($0.005/call). */
+  async defiProtocol(slug) {
+    return this.defi(`protocol/${slug}`);
+  }
+  /** Current TVL of every chain ($0.005/call). */
+  async defiChains() {
+    return this.defi("chains");
+  }
+  /** Yield pools with APY/TVL ($0.005/call). */
+  async defiYields(params) {
+    return this.defi("yields", params);
+  }
+  /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+  async defiPrices(coins) {
+    const joined = Array.isArray(coins) ? coins.join(",") : coins;
+    return this.defi(`prices/${joined}`);
+  }
+  // ============================================================
+  // 0x DEX (swap quotes + gasless) — free passthrough
+  // ============================================================
+  /**
+   * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+   * takes an on-chain affiliate fee on executed swaps instead).
+   *
+   * @param path - "price", "quote", "gasless/price", "gasless/quote",
+   *               "gasless/submit" (POST), "gasless/status/{hash}",
+   *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+   * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+   * @param body - JSON body — pass to switch to POST (gasless/submit only)
+   */
+  async dex(path5, params, body) {
+    if (body) return this.requestWithPaymentRaw(`/v1/zerox/${path5}`, body);
+    return this.getWithPaymentRaw(`/v1/zerox/${path5}`, params);
+  }
+  /** Indicative Permit2 swap price — no commitment (free). */
+  async dexPrice(params) {
+    return this.dex("price", params);
+  }
+  /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+  async dexQuote(params) {
+    return this.dex("quote", params);
+  }
+  /** Gasless indicative price quote (free). */
+  async dexGaslessPrice(params) {
+    return this.dex("gasless/price", params);
+  }
+  /** Gasless firm quote — returns trade.eip712 to sign (free). */
+  async dexGaslessQuote(params) {
+    return this.dex("gasless/quote", params);
+  }
+  /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+  async dexGaslessSubmit(body) {
+    return this.dex("gasless/submit", void 0, body);
+  }
+  /** Poll a gasless trade's status by tradeHash (free). */
+  async dexGaslessStatus(tradeHash) {
+    return this.dex(`gasless/status/${tradeHash}`);
+  }
+  /** Chains where the Swap API is supported (free). */
+  async dexChains() {
+    return this.dex("swap/chains");
+  }
+  /** Chains where the Gasless API is supported (free). */
+  async dexGaslessChains() {
+    return this.dex("gasless/chains");
+  }
+  // ============================================================
+  // Modal Sandbox (pay-per-call cloud compute)
+  // ============================================================
+  /**
+   * Call the Modal sandbox compute API (POST passthrough).
+   *
+   * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+   *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+   * @param body - JSON body for the endpoint
+   */
+  async modal(path5, body) {
+    return this.requestWithPaymentRaw(`/v1/modal/${path5}`, body ?? {});
+  }
+  /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+  async modalSandboxCreate(body) {
+    return this.modal("sandbox/create", body);
+  }
+  /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+  async modalSandboxExec(sandboxId, command, extra) {
+    return this.modal("sandbox/exec", { sandbox_id: sandboxId, command, ...extra });
+  }
+  /** Check a sandbox's status ($0.001). */
+  async modalSandboxStatus(sandboxId) {
+    return this.modal("sandbox/status", { sandbox_id: sandboxId });
+  }
+  /** Terminate a sandbox ($0.001). */
+  async modalSandboxTerminate(sandboxId) {
+    return this.modal("sandbox/terminate", { sandbox_id: sandboxId });
+  }
   /**
    * Get current session spending.
    *
@@ -2492,11 +2606,41 @@ var VideoClient = class {
     const budgetMs = options?.budgetMs ?? DEFAULT_GENERATE_BUDGET_MS;
     return this.submitAndPoll(body, budgetMs);
   }
+  /**
+   * Generate a video from a standard Seedance `content[]` body.
+   *
+   * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+   * mainstream multimodal `content` array (text + a single reference image)
+   * used by other Seedance APIs — so callers already holding a
+   * `content[]`-shaped request can submit it unchanged. The gateway validates
+   * unsupported inputs *before* charging, then delegates to the same x402
+   * submit+poll pipeline as {@link generate}.
+   *
+   * Most SDK users should prefer {@link generate} (structured options like
+   * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+   * `content[]` payloads with no reshaping.
+   *
+   * @param content - The Seedance `content` array, e.g.
+   *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+   *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+   * @param options - `model`, `budgetMs`, and any extra top-level body fields
+   *   (`resolution`, `durationSeconds`/`duration_seconds`, `aspectRatio`, …)
+   *   forwarded verbatim.
+   */
+  async generateFromContent(content, options) {
+    if (!Array.isArray(content) || content.length === 0) {
+      throw new Error("content must be a non-empty array of Seedance content items.");
+    }
+    const { model, budgetMs, ...extra } = options ?? {};
+    const body = { content, ...extra };
+    if (model !== void 0) body.model = model;
+    return this.submitAndPoll(body, budgetMs ?? DEFAULT_GENERATE_BUDGET_MS, "/v1/videos");
+  }
   // --------------------------------------------------------------------
   // Internal: async submit + poll
   // --------------------------------------------------------------------
-  async submitAndPoll(body, budgetMs) {
-    const submitUrl = `${this.apiUrl}/v1/videos/generations`;
+  async submitAndPoll(body, budgetMs, submitPath = "/v1/videos/generations") {
+    const submitUrl = `${this.apiUrl}${submitPath}`;
     const resp402 = await this.fetchWithTimeout(submitUrl, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
@@ -4806,6 +4950,120 @@ var SolanaLLMClient = class {
   async exaAnswer(query, options) {
     return this.requestWithPaymentRaw("/v1/exa/answer", { query, ...options });
   }
+  // ============================================================
+  // DefiLlama (DeFi protocols / TVL / yields / prices)
+  // ============================================================
+  /**
+   * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+   * $0.005/call for protocols / protocol/{slug} / chains / yields;
+   * $0.001/call for prices/{coins}.
+   *
+   * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+   *               "prices/coingecko:bitcoin,base:0x..."
+   * @param params - Query parameters passed through to DefiLlama
+   */
+  async defi(path5, params) {
+    return this.getWithPaymentRaw(`/v1/defillama/${path5}`, params);
+  }
+  /** All DeFi protocols with TVL ($0.005/call). */
+  async defiProtocols() {
+    return this.defi("protocols");
+  }
+  /** Single protocol details + historical TVL ($0.005/call). */
+  async defiProtocol(slug) {
+    return this.defi(`protocol/${slug}`);
+  }
+  /** Current TVL of every chain ($0.005/call). */
+  async defiChains() {
+    return this.defi("chains");
+  }
+  /** Yield pools with APY/TVL ($0.005/call). */
+  async defiYields(params) {
+    return this.defi("yields", params);
+  }
+  /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+  async defiPrices(coins) {
+    const joined = Array.isArray(coins) ? coins.join(",") : coins;
+    return this.defi(`prices/${joined}`);
+  }
+  // ============================================================
+  // 0x DEX (swap quotes + gasless) — free passthrough
+  // ============================================================
+  /**
+   * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+   * takes an on-chain affiliate fee on executed swaps instead).
+   *
+   * @param path - "price", "quote", "gasless/price", "gasless/quote",
+   *               "gasless/submit" (POST), "gasless/status/{hash}",
+   *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+   * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+   * @param body - JSON body — pass to switch to POST (gasless/submit only)
+   */
+  async dex(path5, params, body) {
+    if (body) return this.requestWithPaymentRaw(`/v1/zerox/${path5}`, body);
+    return this.getWithPaymentRaw(`/v1/zerox/${path5}`, params);
+  }
+  /** Indicative Permit2 swap price — no commitment (free). */
+  async dexPrice(params) {
+    return this.dex("price", params);
+  }
+  /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+  async dexQuote(params) {
+    return this.dex("quote", params);
+  }
+  /** Gasless indicative price quote (free). */
+  async dexGaslessPrice(params) {
+    return this.dex("gasless/price", params);
+  }
+  /** Gasless firm quote — returns trade.eip712 to sign (free). */
+  async dexGaslessQuote(params) {
+    return this.dex("gasless/quote", params);
+  }
+  /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+  async dexGaslessSubmit(body) {
+    return this.dex("gasless/submit", void 0, body);
+  }
+  /** Poll a gasless trade's status by tradeHash (free). */
+  async dexGaslessStatus(tradeHash) {
+    return this.dex(`gasless/status/${tradeHash}`);
+  }
+  /** Chains where the Swap API is supported (free). */
+  async dexChains() {
+    return this.dex("swap/chains");
+  }
+  /** Chains where the Gasless API is supported (free). */
+  async dexGaslessChains() {
+    return this.dex("gasless/chains");
+  }
+  // ============================================================
+  // Modal Sandbox (pay-per-call cloud compute)
+  // ============================================================
+  /**
+   * Call the Modal sandbox compute API (POST passthrough).
+   *
+   * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+   *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+   * @param body - JSON body for the endpoint
+   */
+  async modal(path5, body) {
+    return this.requestWithPaymentRaw(`/v1/modal/${path5}`, body ?? {});
+  }
+  /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+  async modalSandboxCreate(body) {
+    return this.modal("sandbox/create", body);
+  }
+  /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+  async modalSandboxExec(sandboxId, command, extra) {
+    return this.modal("sandbox/exec", { sandbox_id: sandboxId, command, ...extra });
+  }
+  /** Check a sandbox's status ($0.001). */
+  async modalSandboxStatus(sandboxId) {
+    return this.modal("sandbox/status", { sandbox_id: sandboxId });
+  }
+  /** Terminate a sandbox ($0.001). */
+  async modalSandboxTerminate(sandboxId) {
+    return this.modal("sandbox/terminate", { sandbox_id: sandboxId });
+  }
   /** Get session spending. */
   getSpending() {
     return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };

package/dist/index.d.cts

@@ -1288,6 +1288,69 @@ declare class LLMClient {
     /** Discover wallets connected to a seed address via on-chain transfers and
      * identity proofs. Tier 2 ($0.005/call). */
     pmWalletCluster(address: string): Promise<Record<string, unknown>>;
+    /**
+     * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+     * $0.005/call for protocols / protocol/{slug} / chains / yields;
+     * $0.001/call for prices/{coins}.
+     *
+     * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+     *               "prices/coingecko:bitcoin,base:0x..."
+     * @param params - Query parameters passed through to DefiLlama
+     */
+    defi(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** All DeFi protocols with TVL ($0.005/call). */
+    defiProtocols(): Promise<Record<string, unknown>>;
+    /** Single protocol details + historical TVL ($0.005/call). */
+    defiProtocol(slug: string): Promise<Record<string, unknown>>;
+    /** Current TVL of every chain ($0.005/call). */
+    defiChains(): Promise<Record<string, unknown>>;
+    /** Yield pools with APY/TVL ($0.005/call). */
+    defiYields(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+    defiPrices(coins: string | string[]): Promise<Record<string, unknown>>;
+    /**
+     * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+     * takes an on-chain affiliate fee on executed swaps instead).
+     *
+     * @param path - "price", "quote", "gasless/price", "gasless/quote",
+     *               "gasless/submit" (POST), "gasless/status/{hash}",
+     *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+     * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+     * @param body - JSON body — pass to switch to POST (gasless/submit only)
+     */
+    dex(path: string, params?: Record<string, string>, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Indicative Permit2 swap price — no commitment (free). */
+    dexPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+    dexQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless indicative price quote (free). */
+    dexGaslessPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless firm quote — returns trade.eip712 to sign (free). */
+    dexGaslessQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+    dexGaslessSubmit(body: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Poll a gasless trade's status by tradeHash (free). */
+    dexGaslessStatus(tradeHash: string): Promise<Record<string, unknown>>;
+    /** Chains where the Swap API is supported (free). */
+    dexChains(): Promise<Record<string, unknown>>;
+    /** Chains where the Gasless API is supported (free). */
+    dexGaslessChains(): Promise<Record<string, unknown>>;
+    /**
+     * Call the Modal sandbox compute API (POST passthrough).
+     *
+     * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+     *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+     * @param body - JSON body for the endpoint
+     */
+    modal(path: string, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+    modalSandboxCreate(body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+    modalSandboxExec(sandboxId: string, command: string[], extra?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Check a sandbox's status ($0.001). */
+    modalSandboxStatus(sandboxId: string): Promise<Record<string, unknown>>;
+    /** Terminate a sandbox ($0.001). */
+    modalSandboxTerminate(sandboxId: string): Promise<Record<string, unknown>>;
     /**
      * Get current session spending.
      *
@@ -1635,6 +1698,31 @@ declare class VideoClient {
     generate(prompt: string, options?: VideoGenerateOptions & {
         budgetMs?: number;
     }): Promise<VideoResponse>;
+    /**
+     * Generate a video from a standard Seedance `content[]` body.
+     *
+     * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+     * mainstream multimodal `content` array (text + a single reference image)
+     * used by other Seedance APIs — so callers already holding a
+     * `content[]`-shaped request can submit it unchanged. The gateway validates
+     * unsupported inputs *before* charging, then delegates to the same x402
+     * submit+poll pipeline as {@link generate}.
+     *
+     * Most SDK users should prefer {@link generate} (structured options like
+     * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+     * `content[]` payloads with no reshaping.
+     *
+     * @param content - The Seedance `content` array, e.g.
+     *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+     *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+     * @param options - `model`, `budgetMs`, and any extra top-level body fields
+     *   (`resolution`, `durationSeconds`/`duration_seconds`, `aspectRatio`, …)
+     *   forwarded verbatim.
+     */
+    generateFromContent(content: Array<Record<string, unknown>>, options?: {
+        model?: string;
+        budgetMs?: number;
+    } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
     private absolute;
     private extractPaymentRequired;
@@ -2584,6 +2672,69 @@ declare class SolanaLLMClient {
      * const answer = await client.exaAnswer("What is the current state of AI safety research?");
      */
     exaAnswer(query: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+     * $0.005/call for protocols / protocol/{slug} / chains / yields;
+     * $0.001/call for prices/{coins}.
+     *
+     * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+     *               "prices/coingecko:bitcoin,base:0x..."
+     * @param params - Query parameters passed through to DefiLlama
+     */
+    defi(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** All DeFi protocols with TVL ($0.005/call). */
+    defiProtocols(): Promise<Record<string, unknown>>;
+    /** Single protocol details + historical TVL ($0.005/call). */
+    defiProtocol(slug: string): Promise<Record<string, unknown>>;
+    /** Current TVL of every chain ($0.005/call). */
+    defiChains(): Promise<Record<string, unknown>>;
+    /** Yield pools with APY/TVL ($0.005/call). */
+    defiYields(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+    defiPrices(coins: string | string[]): Promise<Record<string, unknown>>;
+    /**
+     * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+     * takes an on-chain affiliate fee on executed swaps instead).
+     *
+     * @param path - "price", "quote", "gasless/price", "gasless/quote",
+     *               "gasless/submit" (POST), "gasless/status/{hash}",
+     *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+     * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+     * @param body - JSON body — pass to switch to POST (gasless/submit only)
+     */
+    dex(path: string, params?: Record<string, string>, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Indicative Permit2 swap price — no commitment (free). */
+    dexPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+    dexQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless indicative price quote (free). */
+    dexGaslessPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless firm quote — returns trade.eip712 to sign (free). */
+    dexGaslessQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+    dexGaslessSubmit(body: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Poll a gasless trade's status by tradeHash (free). */
+    dexGaslessStatus(tradeHash: string): Promise<Record<string, unknown>>;
+    /** Chains where the Swap API is supported (free). */
+    dexChains(): Promise<Record<string, unknown>>;
+    /** Chains where the Gasless API is supported (free). */
+    dexGaslessChains(): Promise<Record<string, unknown>>;
+    /**
+     * Call the Modal sandbox compute API (POST passthrough).
+     *
+     * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+     *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+     * @param body - JSON body for the endpoint
+     */
+    modal(path: string, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+    modalSandboxCreate(body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+    modalSandboxExec(sandboxId: string, command: string[], extra?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Check a sandbox's status ($0.001). */
+    modalSandboxStatus(sandboxId: string): Promise<Record<string, unknown>>;
+    /** Terminate a sandbox ($0.001). */
+    modalSandboxTerminate(sandboxId: string): Promise<Record<string, unknown>>;
     /** Get session spending. */
     getSpending(): Spending;
     /** True if using sol.blockrun.ai. */

package/dist/index.d.ts

@@ -1288,6 +1288,69 @@ declare class LLMClient {
     /** Discover wallets connected to a seed address via on-chain transfers and
      * identity proofs. Tier 2 ($0.005/call). */
     pmWalletCluster(address: string): Promise<Record<string, unknown>>;
+    /**
+     * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+     * $0.005/call for protocols / protocol/{slug} / chains / yields;
+     * $0.001/call for prices/{coins}.
+     *
+     * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+     *               "prices/coingecko:bitcoin,base:0x..."
+     * @param params - Query parameters passed through to DefiLlama
+     */
+    defi(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** All DeFi protocols with TVL ($0.005/call). */
+    defiProtocols(): Promise<Record<string, unknown>>;
+    /** Single protocol details + historical TVL ($0.005/call). */
+    defiProtocol(slug: string): Promise<Record<string, unknown>>;
+    /** Current TVL of every chain ($0.005/call). */
+    defiChains(): Promise<Record<string, unknown>>;
+    /** Yield pools with APY/TVL ($0.005/call). */
+    defiYields(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+    defiPrices(coins: string | string[]): Promise<Record<string, unknown>>;
+    /**
+     * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+     * takes an on-chain affiliate fee on executed swaps instead).
+     *
+     * @param path - "price", "quote", "gasless/price", "gasless/quote",
+     *               "gasless/submit" (POST), "gasless/status/{hash}",
+     *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+     * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+     * @param body - JSON body — pass to switch to POST (gasless/submit only)
+     */
+    dex(path: string, params?: Record<string, string>, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Indicative Permit2 swap price — no commitment (free). */
+    dexPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+    dexQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless indicative price quote (free). */
+    dexGaslessPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless firm quote — returns trade.eip712 to sign (free). */
+    dexGaslessQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+    dexGaslessSubmit(body: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Poll a gasless trade's status by tradeHash (free). */
+    dexGaslessStatus(tradeHash: string): Promise<Record<string, unknown>>;
+    /** Chains where the Swap API is supported (free). */
+    dexChains(): Promise<Record<string, unknown>>;
+    /** Chains where the Gasless API is supported (free). */
+    dexGaslessChains(): Promise<Record<string, unknown>>;
+    /**
+     * Call the Modal sandbox compute API (POST passthrough).
+     *
+     * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+     *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+     * @param body - JSON body for the endpoint
+     */
+    modal(path: string, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+    modalSandboxCreate(body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+    modalSandboxExec(sandboxId: string, command: string[], extra?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Check a sandbox's status ($0.001). */
+    modalSandboxStatus(sandboxId: string): Promise<Record<string, unknown>>;
+    /** Terminate a sandbox ($0.001). */
+    modalSandboxTerminate(sandboxId: string): Promise<Record<string, unknown>>;
     /**
      * Get current session spending.
      *
@@ -1635,6 +1698,31 @@ declare class VideoClient {
     generate(prompt: string, options?: VideoGenerateOptions & {
         budgetMs?: number;
     }): Promise<VideoResponse>;
+    /**
+     * Generate a video from a standard Seedance `content[]` body.
+     *
+     * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+     * mainstream multimodal `content` array (text + a single reference image)
+     * used by other Seedance APIs — so callers already holding a
+     * `content[]`-shaped request can submit it unchanged. The gateway validates
+     * unsupported inputs *before* charging, then delegates to the same x402
+     * submit+poll pipeline as {@link generate}.
+     *
+     * Most SDK users should prefer {@link generate} (structured options like
+     * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+     * `content[]` payloads with no reshaping.
+     *
+     * @param content - The Seedance `content` array, e.g.
+     *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+     *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+     * @param options - `model`, `budgetMs`, and any extra top-level body fields
+     *   (`resolution`, `durationSeconds`/`duration_seconds`, `aspectRatio`, …)
+     *   forwarded verbatim.
+     */
+    generateFromContent(content: Array<Record<string, unknown>>, options?: {
+        model?: string;
+        budgetMs?: number;
+    } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
     private absolute;
     private extractPaymentRequired;
@@ -2584,6 +2672,69 @@ declare class SolanaLLMClient {
      * const answer = await client.exaAnswer("What is the current state of AI safety research?");
      */
     exaAnswer(query: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+     * $0.005/call for protocols / protocol/{slug} / chains / yields;
+     * $0.001/call for prices/{coins}.
+     *
+     * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+     *               "prices/coingecko:bitcoin,base:0x..."
+     * @param params - Query parameters passed through to DefiLlama
+     */
+    defi(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** All DeFi protocols with TVL ($0.005/call). */
+    defiProtocols(): Promise<Record<string, unknown>>;
+    /** Single protocol details + historical TVL ($0.005/call). */
+    defiProtocol(slug: string): Promise<Record<string, unknown>>;
+    /** Current TVL of every chain ($0.005/call). */
+    defiChains(): Promise<Record<string, unknown>>;
+    /** Yield pools with APY/TVL ($0.005/call). */
+    defiYields(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+    defiPrices(coins: string | string[]): Promise<Record<string, unknown>>;
+    /**
+     * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+     * takes an on-chain affiliate fee on executed swaps instead).
+     *
+     * @param path - "price", "quote", "gasless/price", "gasless/quote",
+     *               "gasless/submit" (POST), "gasless/status/{hash}",
+     *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+     * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+     * @param body - JSON body — pass to switch to POST (gasless/submit only)
+     */
+    dex(path: string, params?: Record<string, string>, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Indicative Permit2 swap price — no commitment (free). */
+    dexPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+    dexQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless indicative price quote (free). */
+    dexGaslessPrice(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Gasless firm quote — returns trade.eip712 to sign (free). */
+    dexGaslessQuote(params: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+    dexGaslessSubmit(body: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Poll a gasless trade's status by tradeHash (free). */
+    dexGaslessStatus(tradeHash: string): Promise<Record<string, unknown>>;
+    /** Chains where the Swap API is supported (free). */
+    dexChains(): Promise<Record<string, unknown>>;
+    /** Chains where the Gasless API is supported (free). */
+    dexGaslessChains(): Promise<Record<string, unknown>>;
+    /**
+     * Call the Modal sandbox compute API (POST passthrough).
+     *
+     * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+     *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+     * @param body - JSON body for the endpoint
+     */
+    modal(path: string, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+    modalSandboxCreate(body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+    modalSandboxExec(sandboxId: string, command: string[], extra?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Check a sandbox's status ($0.001). */
+    modalSandboxStatus(sandboxId: string): Promise<Record<string, unknown>>;
+    /** Terminate a sandbox ($0.001). */
+    modalSandboxTerminate(sandboxId: string): Promise<Record<string, unknown>>;
     /** Get session spending. */
     getSpending(): Spending;
     /** True if using sol.blockrun.ai. */

package/dist/index.js

@@ -1596,6 +1596,120 @@ var LLMClient = class _LLMClient {
   async pmWalletCluster(address) {
     return this.pm(`polymarket/wallet/${address}/cluster`);
   }
+  // ============================================================
+  // DefiLlama (DeFi protocols / TVL / yields / prices)
+  // ============================================================
+  /**
+   * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+   * $0.005/call for protocols / protocol/{slug} / chains / yields;
+   * $0.001/call for prices/{coins}.
+   *
+   * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+   *               "prices/coingecko:bitcoin,base:0x..."
+   * @param params - Query parameters passed through to DefiLlama
+   */
+  async defi(path5, params) {
+    return this.getWithPaymentRaw(`/v1/defillama/${path5}`, params);
+  }
+  /** All DeFi protocols with TVL ($0.005/call). */
+  async defiProtocols() {
+    return this.defi("protocols");
+  }
+  /** Single protocol details + historical TVL ($0.005/call). */
+  async defiProtocol(slug) {
+    return this.defi(`protocol/${slug}`);
+  }
+  /** Current TVL of every chain ($0.005/call). */
+  async defiChains() {
+    return this.defi("chains");
+  }
+  /** Yield pools with APY/TVL ($0.005/call). */
+  async defiYields(params) {
+    return this.defi("yields", params);
+  }
+  /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+  async defiPrices(coins) {
+    const joined = Array.isArray(coins) ? coins.join(",") : coins;
+    return this.defi(`prices/${joined}`);
+  }
+  // ============================================================
+  // 0x DEX (swap quotes + gasless) — free passthrough
+  // ============================================================
+  /**
+   * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+   * takes an on-chain affiliate fee on executed swaps instead).
+   *
+   * @param path - "price", "quote", "gasless/price", "gasless/quote",
+   *               "gasless/submit" (POST), "gasless/status/{hash}",
+   *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+   * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+   * @param body - JSON body — pass to switch to POST (gasless/submit only)
+   */
+  async dex(path5, params, body) {
+    if (body) return this.requestWithPaymentRaw(`/v1/zerox/${path5}`, body);
+    return this.getWithPaymentRaw(`/v1/zerox/${path5}`, params);
+  }
+  /** Indicative Permit2 swap price — no commitment (free). */
+  async dexPrice(params) {
+    return this.dex("price", params);
+  }
+  /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+  async dexQuote(params) {
+    return this.dex("quote", params);
+  }
+  /** Gasless indicative price quote (free). */
+  async dexGaslessPrice(params) {
+    return this.dex("gasless/price", params);
+  }
+  /** Gasless firm quote — returns trade.eip712 to sign (free). */
+  async dexGaslessQuote(params) {
+    return this.dex("gasless/quote", params);
+  }
+  /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+  async dexGaslessSubmit(body) {
+    return this.dex("gasless/submit", void 0, body);
+  }
+  /** Poll a gasless trade's status by tradeHash (free). */
+  async dexGaslessStatus(tradeHash) {
+    return this.dex(`gasless/status/${tradeHash}`);
+  }
+  /** Chains where the Swap API is supported (free). */
+  async dexChains() {
+    return this.dex("swap/chains");
+  }
+  /** Chains where the Gasless API is supported (free). */
+  async dexGaslessChains() {
+    return this.dex("gasless/chains");
+  }
+  // ============================================================
+  // Modal Sandbox (pay-per-call cloud compute)
+  // ============================================================
+  /**
+   * Call the Modal sandbox compute API (POST passthrough).
+   *
+   * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+   *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+   * @param body - JSON body for the endpoint
+   */
+  async modal(path5, body) {
+    return this.requestWithPaymentRaw(`/v1/modal/${path5}`, body ?? {});
+  }
+  /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+  async modalSandboxCreate(body) {
+    return this.modal("sandbox/create", body);
+  }
+  /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+  async modalSandboxExec(sandboxId, command, extra) {
+    return this.modal("sandbox/exec", { sandbox_id: sandboxId, command, ...extra });
+  }
+  /** Check a sandbox's status ($0.001). */
+  async modalSandboxStatus(sandboxId) {
+    return this.modal("sandbox/status", { sandbox_id: sandboxId });
+  }
+  /** Terminate a sandbox ($0.001). */
+  async modalSandboxTerminate(sandboxId) {
+    return this.modal("sandbox/terminate", { sandbox_id: sandboxId });
+  }
   /**
    * Get current session spending.
    *
@@ -2385,11 +2499,41 @@ var VideoClient = class {
     const budgetMs = options?.budgetMs ?? DEFAULT_GENERATE_BUDGET_MS;
     return this.submitAndPoll(body, budgetMs);
   }
+  /**
+   * Generate a video from a standard Seedance `content[]` body.
+   *
+   * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+   * mainstream multimodal `content` array (text + a single reference image)
+   * used by other Seedance APIs — so callers already holding a
+   * `content[]`-shaped request can submit it unchanged. The gateway validates
+   * unsupported inputs *before* charging, then delegates to the same x402
+   * submit+poll pipeline as {@link generate}.
+   *
+   * Most SDK users should prefer {@link generate} (structured options like
+   * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+   * `content[]` payloads with no reshaping.
+   *
+   * @param content - The Seedance `content` array, e.g.
+   *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+   *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+   * @param options - `model`, `budgetMs`, and any extra top-level body fields
+   *   (`resolution`, `durationSeconds`/`duration_seconds`, `aspectRatio`, …)
+   *   forwarded verbatim.
+   */
+  async generateFromContent(content, options) {
+    if (!Array.isArray(content) || content.length === 0) {
+      throw new Error("content must be a non-empty array of Seedance content items.");
+    }
+    const { model, budgetMs, ...extra } = options ?? {};
+    const body = { content, ...extra };
+    if (model !== void 0) body.model = model;
+    return this.submitAndPoll(body, budgetMs ?? DEFAULT_GENERATE_BUDGET_MS, "/v1/videos");
+  }
   // --------------------------------------------------------------------
   // Internal: async submit + poll
   // --------------------------------------------------------------------
-  async submitAndPoll(body, budgetMs) {
-    const submitUrl = `${this.apiUrl}/v1/videos/generations`;
+  async submitAndPoll(body, budgetMs, submitPath = "/v1/videos/generations") {
+    const submitUrl = `${this.apiUrl}${submitPath}`;
     const resp402 = await this.fetchWithTimeout(submitUrl, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
@@ -4699,6 +4843,120 @@ var SolanaLLMClient = class {
   async exaAnswer(query, options) {
     return this.requestWithPaymentRaw("/v1/exa/answer", { query, ...options });
   }
+  // ============================================================
+  // DefiLlama (DeFi protocols / TVL / yields / prices)
+  // ============================================================
+  /**
+   * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
+   * $0.005/call for protocols / protocol/{slug} / chains / yields;
+   * $0.001/call for prices/{coins}.
+   *
+   * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
+   *               "prices/coingecko:bitcoin,base:0x..."
+   * @param params - Query parameters passed through to DefiLlama
+   */
+  async defi(path5, params) {
+    return this.getWithPaymentRaw(`/v1/defillama/${path5}`, params);
+  }
+  /** All DeFi protocols with TVL ($0.005/call). */
+  async defiProtocols() {
+    return this.defi("protocols");
+  }
+  /** Single protocol details + historical TVL ($0.005/call). */
+  async defiProtocol(slug) {
+    return this.defi(`protocol/${slug}`);
+  }
+  /** Current TVL of every chain ($0.005/call). */
+  async defiChains() {
+    return this.defi("chains");
+  }
+  /** Yield pools with APY/TVL ($0.005/call). */
+  async defiYields(params) {
+    return this.defi("yields", params);
+  }
+  /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+  async defiPrices(coins) {
+    const joined = Array.isArray(coins) ? coins.join(",") : coins;
+    return this.defi(`prices/${joined}`);
+  }
+  // ============================================================
+  // 0x DEX (swap quotes + gasless) — free passthrough
+  // ============================================================
+  /**
+   * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
+   * takes an on-chain affiliate fee on executed swaps instead).
+   *
+   * @param path - "price", "quote", "gasless/price", "gasless/quote",
+   *               "gasless/submit" (POST), "gasless/status/{hash}",
+   *               "gasless/approval-tokens", "gasless/chains", "swap/chains"
+   * @param params - Query params (chainId, sellToken, buyToken, sellAmount, taker, ...)
+   * @param body - JSON body — pass to switch to POST (gasless/submit only)
+   */
+  async dex(path5, params, body) {
+    if (body) return this.requestWithPaymentRaw(`/v1/zerox/${path5}`, body);
+    return this.getWithPaymentRaw(`/v1/zerox/${path5}`, params);
+  }
+  /** Indicative Permit2 swap price — no commitment (free). */
+  async dexPrice(params) {
+    return this.dex("price", params);
+  }
+  /** Firm Permit2 swap quote with permit2.eip712 + tx data (free). */
+  async dexQuote(params) {
+    return this.dex("quote", params);
+  }
+  /** Gasless indicative price quote (free). */
+  async dexGaslessPrice(params) {
+    return this.dex("gasless/price", params);
+  }
+  /** Gasless firm quote — returns trade.eip712 to sign (free). */
+  async dexGaslessQuote(params) {
+    return this.dex("gasless/quote", params);
+  }
+  /** Submit a signed gasless trade; the 0x relayer pays gas (free). */
+  async dexGaslessSubmit(body) {
+    return this.dex("gasless/submit", void 0, body);
+  }
+  /** Poll a gasless trade's status by tradeHash (free). */
+  async dexGaslessStatus(tradeHash) {
+    return this.dex(`gasless/status/${tradeHash}`);
+  }
+  /** Chains where the Swap API is supported (free). */
+  async dexChains() {
+    return this.dex("swap/chains");
+  }
+  /** Chains where the Gasless API is supported (free). */
+  async dexGaslessChains() {
+    return this.dex("gasless/chains");
+  }
+  // ============================================================
+  // Modal Sandbox (pay-per-call cloud compute)
+  // ============================================================
+  /**
+   * Call the Modal sandbox compute API (POST passthrough).
+   *
+   * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
+   *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+   * @param body - JSON body for the endpoint
+   */
+  async modal(path5, body) {
+    return this.requestWithPaymentRaw(`/v1/modal/${path5}`, body ?? {});
+  }
+  /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+  async modalSandboxCreate(body) {
+    return this.modal("sandbox/create", body);
+  }
+  /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+  async modalSandboxExec(sandboxId, command, extra) {
+    return this.modal("sandbox/exec", { sandbox_id: sandboxId, command, ...extra });
+  }
+  /** Check a sandbox's status ($0.001). */
+  async modalSandboxStatus(sandboxId) {
+    return this.modal("sandbox/status", { sandbox_id: sandboxId });
+  }
+  /** Terminate a sandbox ($0.001). */
+  async modalSandboxTerminate(sandboxId) {
+    return this.modal("sandbox/terminate", { sandbox_id: sandboxId });
+  }
   /** Get session spending. */
   getSpending() {
     return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music, Voice) via x402 on Base and Solana",
   "main": "dist/index.cjs",