@0block.io/sdk 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -9,7 +9,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

@@ -22,7 +22,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.3.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",