v0.1.5 — checkpointed ERC-20 transfer example

The SDK archive now includes examples/address-transfers-page.mjs: read one ERC-20 transfer page per invocation, keep the exact response and cursor in a checkpoint, and resume the same fixed query. A completed checkpoint makes no further request; partial coverage stays visible.

Install this release archive:

npm install https://github.com/blockvectra/data-api-js/releases/download/v0.1.5/blockvectra-data-api-0.1.5.tgz
node node_modules/@blockvectra/data-api/examples/address-transfers-page.mjs

Set BLOCKVECTRA_API_KEY, BLOCKVECTRA_CHAIN, BLOCKVECTRA_ADDRESS, BLOCKVECTRA_FROM_BLOCK, BLOCKVECTRA_TO_BLOCK and BLOCKVECTRA_STATE as described in the README before running the example. It supports a fixed window of at most 100,000 blocks and at most 20 saved pages. Pagination completion does not prove complete upstream indexing.

The runtime and TypeScript declarations are byte-identical to 0.1.4. Build, typecheck and an isolated archive-install probe pass; the probe uses mocked pages and is not a live Data API or customer test. SHA256SUMS is attached.

npm currently serves 0.1.4. This 0.1.5 GitHub archive is available through the URL above; npm publication and the existing registry-publication verifier remain pending normal publisher authentication.

Data API SDK v0.1.4

The Data API SDK now includes its runnable daily DEX price example alongside prebuilt JavaScript and TypeScript declarations. The README uses Data API-specific chain discovery and links directly to the API reference.

The runtime and generated declarations are byte-identical to v0.1.3. The package version, documentation, packaged example and repository metadata are updated.

Install from npm:

npm install @blockvectra/data-api

Or install this release archive:

npm install https://github.com/blockvectra/data-api-js/releases/download/v0.1.4/blockvectra-data-api-0.1.4.tgz

Verify the archive with the attached SHA256SUMS. The npm registry serves version 0.1.4; registry metadata, README and tarball bytes were verified, followed by a fresh install by package name.

v0.1.3 — first-call configuration and safe error handling

First-call setup now fails locally when the API key is missing or blank, without sending a request. Non-empty keys continue unchanged to the API.

Export isDataApiError to safely narrow error payloads before reading their fields. README examples compile against the current public OpenAPI types, including responses whose JSON payload is unknown.

Validation: 37 unit tests pass, 1 credentialed live test skipped; typecheck, README examples and build pass. The packed archive was installed in a separate project and checked with mock responses and TypeScript. No authenticated API request was made for this release.

Not yet published to npm; use the prebuilt archive attached here. Keep the API key in backend configuration.

Data API JavaScript SDK 0.1.2

修正 Data API 认证错误的文档与示例：缺少 x-api-key 返回 401 missing_api_key；未知、停用或撤销的 key 返回 401 invalid_api_key。未知链仍在鉴权前返回 404，空 404 不应当作认证失败。

预构建包含 JavaScript 和类型声明，无需本地编译。运行时代码及生成类型与0.1.1相同；旧版制品保留。本次根据既有 Gateway 合同更新文档，没有新增线上 API 验证。

验证：8段示例编译通过，单元测试7通过/1线上跳过，安装后真实README错误示例的5种mock情形通过。尚未发布到 npm registry。

npm install https://github.com/blockvectra/data-api-js/releases/download/v0.1.2/blockvectra-data-api-0.1.2.tgz

可用SHA256SUMS核验下载文件。

Data API JavaScript SDK 0.1.1

修正 README 中四个与公开类型不一致的字段，并把全部 8 段 TypeScript 示例接入 typecheck。

预构建包包含 JavaScript 和类型声明，安装无需本地编译。运行时代码及生成类型与 0.1.0 相同；0.1.0 制品保留。

验证：安装包安装、mock 请求和 8 段安装后示例编译通过；单元测试 7 通过、1 项线上测试跳过。没有新增线上 API 验证。本版本通过 GitHub Release 提供，尚未发布到 npm registry。

安装：

npm install https://github.com/blockvectra/data-api-js/releases/download/v0.1.1/blockvectra-data-api-0.1.1.tgz

使用 SHA256SUMS 核验下载文件。

v0.1.0 — typed Data API client

Typed ESM client for the BlockVectra Data API.

Install the prebuilt package without generating types during installation:

npm install https://github.com/blockvectra/data-api-js/releases/download/v0.1.0/blockvectra-data-api-0.1.0.tgz

import { createDataClient } from "@blockvectra/data-api";
const client = createDataClient({ apiKey: process.env.BLOCKVECTRA_API_KEY });

Keep API keys on the server. The package includes generated TypeScript declarations and the MIT license. Large integer amounts remain decimal strings. Balance data is a periodically refreshed snapshot; use meta.refreshed_at to assess its age.

The archive is built from commit 0ddfa6126152d52fa5aa60f76c376970efed2cc7 and a frozen public OpenAPI document (SHA-256 ba9ca1402cfde34d906c21652ae619b1bb3895840c8713d9ff1ef50d6a3926fd). All seven packaged files match the independently checked Git installation. Installation, import, a mocked request and installed declarations were checked; this does not verify live API responses. SHA256SUMS identifies the archive bytes.

The npm registry package is not published yet. Git installation also remains available, as documented in the README.