@0block.io/sdk 0.2.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";
@@ -9,7 +10,7 @@ export { buildPumpfunSwapInstruction, decodeSwapData, randomOrderId, resolveFeeM
 export { buildTipInstruction, maskTipAccountInTables } from "./tip.js";
 export { buildComputeBudgetInstructions } from "./computeBudget.js";
 export { createAtaIdempotentInstruction, syncNativeInstruction, closeAccountInstruction, wrapSolInstructions, unwrapWsolInstruction, } from "./wsol.js";
-export { buildPumpfunSwapTransaction, serializeWithSignatures, toLookupTableAccount, } from "./transaction.js";
+export { buildPumpfunSwapTransaction, serializeWithSignatures, buildSubmitTemplate, toLookupTableAccount, type SubmitTemplate, } from "./transaction.js";
 export { buildLookupTableAddresses, buildInitLookupTableInstructions, type InitLookupTableResult, } from "./alt.js";
 export { applyPreset, slippagePctToBps, solToLamports, type PresetSwapInputs, type PresetSwapOutputs, } from "./presets.js";
 export { decodeSwapResultEvents } from "./events.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";
@@ -22,7 +23,7 @@ export { buildPumpfunSwapInstruction, decodeSwapData, randomOrderId, resolveFeeM
 export { buildTipInstruction, maskTipAccountInTables } from "./tip.js";
 export { buildComputeBudgetInstructions } from "./computeBudget.js";
 export { createAtaIdempotentInstruction, syncNativeInstruction, closeAccountInstruction, wrapSolInstructions, unwrapWsolInstruction, } from "./wsol.js";
-export { buildPumpfunSwapTransaction, serializeWithSignatures, toLookupTableAccount, } from "./transaction.js";
+export { buildPumpfunSwapTransaction, serializeWithSignatures, buildSubmitTemplate, toLookupTableAccount, } from "./transaction.js";
 export { buildLookupTableAddresses, buildInitLookupTableInstructions, } from "./alt.js";
 export { applyPreset, slippagePctToBps, solToLamports, } from "./presets.js";
 export { decodeSwapResultEvents } from "./events.js";

package/dist/transaction.d.ts

@@ -17,3 +17,34 @@ export declare function buildPumpfunSwapTransaction(params: BuildPumpfunSwapPara
  * requiredSigners order and return the wire-ready bytes.
  */
 export declare function serializeWithSignatures(result: BuildSwapResult, signatures: Uint8Array[]): Uint8Array;
+/**
+ * A submit template for a signer-and-submitter that is CHAIN-AGNOSTIC (e.g.
+ * sigcore): it signs `payload` and splices the raw signature into
+ * `wireTemplate` at `signatureOffset`, then broadcasts the result — with no
+ * knowledge of Solana's transaction format.
+ *
+ * The layout works because a Solana v0 transaction is
+ * `[compact-u16 sig count][sig0..sigN-1][message]`, and the bytes that get
+ * signed are exactly the `[message]` tail. `wireTemplate` is that full
+ * structure with the signature region zeroed; splicing the 64-byte signature
+ * over the zeros yields bytes identical to `serializeWithSignatures`.
+ *
+ * Single-signer only (the RAX flow): exactly one signature at a fixed offset.
+ */
+export interface SubmitTemplate {
+    /** The bytes the signer must sign (the transaction message). Hex-encoded. */
+    payloadHex: string;
+    /** Full wire transaction with the signature zeroed. Base64-encoded. */
+    wireTemplateBase64: string;
+    /** Byte offset in the template where the 64-byte signature is spliced in. */
+    signatureOffset: number;
+    /** Signature length in bytes (64 for ed25519). */
+    signatureLength: number;
+    /** The single required signer's base58 address (the user). */
+    signer: string;
+}
+/**
+ * Emit a chain-agnostic {@link SubmitTemplate} from a built single-signer
+ * transaction. The offset is derived from the wire layout, not assumed.
+ */
+export declare function buildSubmitTemplate(result: BuildSwapResult): SubmitTemplate;

package/dist/transaction.js

@@ -137,3 +137,55 @@ export function serializeWithSignatures(result, signatures) {
     }
     return result.transaction.serialize();
 }
+/** compact-u16 (shortvec) encoded length — how Solana prefixes the sig array. */
+function compactU16Length(n) {
+    if (n < 0x80)
+        return 1;
+    if (n < 0x4000)
+        return 2;
+    return 3;
+}
+/**
+ * Emit a chain-agnostic {@link SubmitTemplate} from a built single-signer
+ * transaction. The offset is derived from the wire layout, not assumed.
+ */
+export function buildSubmitTemplate(result) {
+    const header = result.transaction.message.header;
+    if (header.numRequiredSignatures !== 1) {
+        throw new Error(`submit template supports a single signer; got ${header.numRequiredSignatures}`);
+    }
+    const SIG_LEN = 64;
+    // Zeroed-signature serialization IS the template (web3.js fills missing
+    // signatures with 64 zero bytes), so no manual zeroing is needed.
+    const wireTemplate = result.transaction.serialize();
+    const signatureOffset = compactU16Length(1); // count prefix precedes sig 0
+    // Invariant: the payload (message) is the tail after [count][signature].
+    const messageStart = signatureOffset + SIG_LEN;
+    const templateTail = wireTemplate.slice(messageStart);
+    if (templateTail.length !== result.messageBytes.length ||
+        !templateTail.every((b, i) => b === result.messageBytes[i])) {
+        throw new Error("submit template layout mismatch — message tail differs");
+    }
+    return {
+        payloadHex: bytesToHex(result.messageBytes),
+        wireTemplateBase64: toBase64(wireTemplate),
+        signatureOffset,
+        signatureLength: SIG_LEN,
+        signer: result.requiredSigners[0].toBase58(),
+    };
+}
+function bytesToHex(bytes) {
+    let hex = "";
+    for (const b of bytes)
+        hex += b.toString(16).padStart(2, "0");
+    return hex;
+}
+function toBase64(bytes) {
+    // Buffer in Node; btoa fallback in the browser.
+    if (typeof Buffer !== "undefined")
+        return Buffer.from(bytes).toString("base64");
+    let binary = "";
+    for (const b of bytes)
+        binary += String.fromCharCode(b);
+    return btoa(binary);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0block.io/sdk",
-  "version": "0.2.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",