@blockrun/llm 3.0.0 → 3.1.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.
    *
@@ -4806,6 +4920,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.
      *
@@ -2584,6 +2647,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.
      *
@@ -2584,6 +2647,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.
    *
@@ -4699,6 +4813,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.1.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",