@0block.io/sdk 0.3.0 → 0.4.0

package/dist/blockhash.d.ts

@@ -0,0 +1,16 @@
+export interface FetchBlockhashOptions {
+    /** Injectable fetch (tests / non-standard runtimes). Defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+}
+export interface RecentBlockhash {
+    /** The finalized blockhash to use as a transaction's recentBlockhash. */
+    blockhash: string;
+    /** Last block height at which this blockhash is still valid (0 if absent). */
+    lastValidBlockHeight: number;
+}
+/**
+ * Fetch the recent finalized blockhash from 0Block's cached public endpoint.
+ * `apiBaseUrl` is the 0Block API base (e.g. "https://<0block-host>"); the
+ * "/api/v1/blockhash" path is appended.
+ */
+export declare function fetchRecentBlockhash(apiBaseUrl: string, opts?: FetchBlockhashOptions): Promise<RecentBlockhash>;

package/dist/blockhash.js

@@ -0,0 +1,24 @@
+// 0Block public API: recent blockhash. Lets clients build transactions without
+// their own Solana read RPC — 0Block polls and caches getLatestBlockhash on the
+// server and serves it at GET {apiBaseUrl}/api/v1/blockhash (public, no key).
+/**
+ * Fetch the recent finalized blockhash from 0Block's cached public endpoint.
+ * `apiBaseUrl` is the 0Block API base (e.g. "https://<0block-host>"); the
+ * "/api/v1/blockhash" path is appended.
+ */
+export async function fetchRecentBlockhash(apiBaseUrl, opts) {
+    const fetchImpl = opts?.fetchImpl ?? fetch;
+    const base = apiBaseUrl.replace(/\/+$/, "");
+    const res = await fetchImpl(`${base}/api/v1/blockhash`);
+    if (!res.ok) {
+        throw new Error(`0Block blockhash unavailable (HTTP ${res.status})`);
+    }
+    const body = (await res.json());
+    if (!body.blockhash) {
+        throw new Error("0Block blockhash response missing blockhash");
+    }
+    return {
+        blockhash: body.blockhash,
+        lastValidBlockHeight: body.lastValidBlockHeight ?? 0,
+    };
+}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./constants.js";
 export * from "./types.js";
 export { createContext, type CreateContextParams, type TenantInit, type ZeroBlockContext, } from "./context.js";
 export { buildSendTransactionRequest, createLandingClient, withLandingTip, type LandingClient, type LandingServiceConfig, type SendTransactionOptions, } from "./landing.js";
+export { fetchRecentBlockhash, type FetchBlockhashOptions, type RecentBlockhash, } from "./blockhash.js";
 export { toPk, deriveAta, deriveOrderMarker, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
 export { type AccountFetcher, connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
 export { buildPumpfunRemainingAccounts, type PumpfunRemainingAccountsParams, } from "./venues/pumpfun.js";

package/dist/index.js

@@ -15,6 +15,7 @@ export * from "./constants.js";
 export * from "./types.js";
 export { createContext, } from "./context.js";
 export { buildSendTransactionRequest, createLandingClient, withLandingTip, } from "./landing.js";
+export { fetchRecentBlockhash, } from "./blockhash.js";
 export { toPk, deriveAta, deriveOrderMarker, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
 export { connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
 export { buildPumpfunRemainingAccounts, } from "./venues/pumpfun.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0block.io/sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Client-side transaction builder for the 0Block DEX router. Builds unsigned v0 swap transactions entirely offline \u2014 tenant-wrapped or direct \u2014 with shared address lookup tables, gateway tips, and on-chain fee-event decoding for accounting.",
   "keywords": [
     "solana",