> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ondb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Latest updates and improvements to OnDB.

<Update label="2026-04-16" description="SDK v1.0, free app creation, and performance upgrades" tags={["Feature", "Update"]}>
  ## SDK v1.0, free app creation, and performance upgrades

  The OnDB TypeScript SDK is now publicly available on npm, app creation is free, and the platform is significantly faster.

  ### New features

  * **SDK publicly available on npm** — The TypeScript SDK is now published as [`@ondb/sdk`](https://www.npmjs.com/package/@ondb/sdk) under an MIT license. Install it with `npm install @ondb/sdk` and start building. [Learn more](/api-reference/client)

  * **Free app creation** — Creating a new app no longer requires a payment. You get your app ID and API keys immediately upon creation. [Learn more](/quickstart)

  * **Machine Payment Protocol (MPP)** — A new payment method using Tempo for micro-USDC payments. The platform automatically discovers MPP support and handles settlement alongside x402. [Learn more](/concepts/payment-flows)

  * **Public queries** — Materialized views and predefined queries can now be marked as public, allowing unauthenticated access. Useful for building public-facing API endpoints. [Learn more](/querying/predefined-queries)

  * **MCP tool discovery** — Predefined queries registered as AI tools are now discoverable via schema endpoints, making integration with AI agents easier. [Learn more](/ai-tools/setup)

  ### Updates

  * **Performance improvements** — Significant latency reductions across the platform, including in-memory caching for shard metadata, index configs, and collection records. Read-heavy workloads should see noticeably faster responses.

  * **Multi-pod reliability** — The payment ledger is now backed by Redis for safe operation across multiple server instances, eliminating potential double-spend issues at scale.

  * **SDK security patches** — Updated transitive dependencies to address known vulnerabilities in `axios`, `minimatch`, `picomatch`, `brace-expansion`, and `js-yaml`.
</Update>

<Update label="2026-03-19" description="SDK v4.0 and platform launch" tags={["Feature", "Release"]}>
  ## OnDB SDK v4.0 and platform launch

  Major release of the OnDB TypeScript SDK and backend platform, delivering the missing infrastructure between proprietary data and AI agents.

  ### New features

  * **Model API** — A typed, declarative interface for structured reads and writes. Use `db.model<T>(collection)` to get `findMany`, `findFirst`, `findUnique`, `create`, `createMany`, `updateDocument`, `deleteDocument`, `count`, and `aggregate` methods with full TypeScript support. [Learn more](/api-reference/types)

  * **Server-side JOINs** — Execute `joinOne` and `joinMany` operations on the backend in a single request. Supports nested JOINs and parent-field references with `$data.fieldname`. [Learn more](/querying/joins)

  * **SQL interface** — Query and insert data using SQL syntax via `db.sql()` and `db.sqlInsert()`. [Learn more](/querying/sql)

  * **Predefined queries** — Create named, parameterized queries that execute publicly without authentication. Ideal for building custom API endpoints. [Learn more](/querying/predefined-queries)

  * **Materialized views** — Define views over collections using JSON queries or SQL. Supports `live` (auto-refresh on write) and `lazy` (manual refresh) modes. [Learn more](/querying/materialized-views)

  * **Collection sharding** — Partition large collections across shards using discrete, time-range, or hash-distributed strategies. Shard-aware query routing prunes irrelevant shards automatically. [Learn more](/advanced/sharding)

  * **Agent Keys** — Keys with `Pay` permission can pay other apps inline using USDC via EIP-3009. Configure spend limits, expiration, and target app whitelists. [Learn more](/concepts/authentication)

  * **Multi-chain payments** — Pay for reads and writes across Celestia (TIA), EVM chains (Base, Ethereum, Polygon, Avalanche via USDC), and Solana using the x402 protocol. [Learn more](/concepts/payment-flows)

  * **MCP server** — Built-in Model Context Protocol server exposes your predefined queries as discoverable AI tools, with HTTP and stdio transports. [Learn more](/ai-tools/setup)

  * **Data retention policies** — Configure per-collection retention with the first 30 days free. Monitor costs across all collections. [Learn more](/advanced/transaction-tracking)

  * **Blob storage** — Upload and retrieve binary files on-chain with metadata and task tracking. [Learn more](/advanced/blob-storage)

  ### Updates

  * **Rebrand to OnDB** — All SDK classes renamed from `OnChainDB*` to `OnDB*` (e.g., `OnDBClient`, `OnDBConfig`, `OnDBError`).

  * **Currency-agnostic pricing** — `X402Quote.totalCostTia` renamed to `totalCost` to reflect multi-currency support (USDC, TIA, ETH, SOL).

  * **Flexible payment routing** — The SDK now matches the payment network returned by your callback instead of defaulting to the first option. You can choose any payment option the backend offers.

  * **Batch operations** — Store multiple records in a single request with retry strategies for partial failures. [Learn more](/advanced/batch-operations)

  * **Price index** — Collections can define price fields with per-KB, per-record, or field-value pricing models with configurable revenue splits. [Learn more](/payments/price-index)

  * **Query builder operators** — Full set of field operators including string matching, IP classification, GeoIP, CIDR range, regex, and keyword search. [Learn more](/querying/query-builder)

  * **Server-side aggregations** — `count`, `sum`, `avg`, `min`, `max`, `distinctBy`, and `groupBy` execute on the backend. [Learn more](/querying/aggregations)
</Update>