@veilo/sdk-core 0.5.0 → 0.7.0

package/dist/cjs/predictions/client.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JupiterPredictionClient = exports.JupiterPredictionApiError = exports.POLYMARKET_CLOB_API_URL = exports.JUPITER_PREDICTION_API_URL = void 0;
+exports.deserializePredictionTransaction = deserializePredictionTransaction;
+const web3_js_1 = require("@solana/web3.js");
+exports.JUPITER_PREDICTION_API_URL = "https://api.jup.ag/prediction/v1";
+exports.POLYMARKET_CLOB_API_URL = "https://clob.polymarket.com";
+class JupiterPredictionApiError extends Error {
+    constructor(status, responseBody) {
+        const body = typeof responseBody === "object" && responseBody !== null
+            ? responseBody
+            : undefined;
+        const message = typeof responseBody === "string" && responseBody
+            ? responseBody
+            : typeof body?.message === "string"
+                ? body.message
+                : typeof body?.error === "string"
+                    ? body.error
+                    : `Jupiter Prediction API request failed: ${status}`;
+        super(message);
+        this.name = "JupiterPredictionApiError";
+        this.status = status;
+        this.code = typeof body?.error === "string" ? body.error : undefined;
+        this.responseBody = responseBody;
+    }
+}
+exports.JupiterPredictionApiError = JupiterPredictionApiError;
+/** Typed client for the unsigned Jupiter Prediction transaction API. */
+class JupiterPredictionClient {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = normalizeBaseUrl(config.baseUrl ?? exports.JUPITER_PREDICTION_API_URL, "baseUrl");
+        this.polymarketBaseUrl = normalizeBaseUrl(config.polymarketBaseUrl ?? exports.POLYMARKET_CLOB_API_URL, "polymarketBaseUrl");
+        this.fetcher = config.fetch ?? fetch;
+    }
+    async listEvents(params = {}) {
+        const query = new URLSearchParams({ status: params.status ?? "live" });
+        if (params.category)
+            query.set("category", params.category);
+        return (await this.request(`/events?${query}`)).data;
+    }
+    async getEvent(eventId) {
+        return this.request(`/events/${encodeURIComponent(eventId)}`);
+    }
+    async listPositions(ownerPubkey) {
+        return (await this.request(`/positions?ownerPubkey=${encodeURIComponent(ownerPubkey)}`)).data;
+    }
+    async listHistory(ownerPubkey) {
+        return (await this.request(`/history?ownerPubkey=${encodeURIComponent(ownerPubkey)}`)).data;
+    }
+    async getPosition(positionPubkey) {
+        return this.request(`/positions/${encodeURIComponent(positionPubkey)}`);
+    }
+    async placeOrder(request) {
+        return this.request("/orders", { method: "POST", body: request });
+    }
+    async getOrderStatus(orderPubkey) {
+        return this.request(`/orders/status/${encodeURIComponent(orderPubkey)}`);
+    }
+    async closePosition(positionPubkey, ownerPubkey) {
+        return this.request(`/positions/${encodeURIComponent(positionPubkey)}`, {
+            method: "DELETE",
+            body: { ownerPubkey },
+        });
+    }
+    async closeAllPositions(ownerPubkey, minSellPriceSlippageBps = 300) {
+        return this.request("/positions", {
+            method: "DELETE",
+            body: { ownerPubkey, minSellPriceSlippageBps },
+        });
+    }
+    async claimPosition(positionPubkey, ownerPubkey) {
+        return this.request(`/positions/${encodeURIComponent(positionPubkey)}/claim`, { method: "POST", body: { ownerPubkey } });
+    }
+    async getPriceHistory(clobTokenId, interval) {
+        const fidelity = {
+            "1d": 5,
+            "1w": 30,
+            "1m": 180,
+            max: 180,
+        };
+        const query = new URLSearchParams({
+            market: clobTokenId,
+            interval,
+            fidelity: String(fidelity[interval]),
+        });
+        const response = await this.fetcher(`${this.polymarketBaseUrl}/prices-history?${query}`);
+        const body = await readResponseBody(response);
+        if (!response.ok) {
+            throw new JupiterPredictionApiError(response.status, body);
+        }
+        return body.history ?? [];
+    }
+    async request(path, options = {}) {
+        const response = await this.fetcher(`${this.baseUrl}${path}`, {
+            method: options.method ?? "GET",
+            headers: {
+                "x-api-key": this.apiKey,
+                ...(options.body === undefined
+                    ? {}
+                    : { "Content-Type": "application/json" }),
+            },
+            body: options.body === undefined ? undefined : JSON.stringify(options.body),
+        });
+        const body = await readResponseBody(response);
+        if (!response.ok) {
+            throw new JupiterPredictionApiError(response.status, body);
+        }
+        return body;
+    }
+}
+exports.JupiterPredictionClient = JupiterPredictionClient;
+/** Decode an unsigned transaction returned by Jupiter for wallet signing. */
+function deserializePredictionTransaction(response) {
+    if (!response.transaction) {
+        throw new TypeError("Prediction transaction must not be empty");
+    }
+    return web3_js_1.VersionedTransaction.deserialize(decodeBase64(response.transaction));
+}
+function normalizeBaseUrl(value, label) {
+    const normalized = value.trim().replace(/\/+$/, "");
+    if (!normalized)
+        throw new TypeError(`${label} must not be empty`);
+    return normalized;
+}
+async function readResponseBody(response) {
+    const body = await response.text();
+    if (!body)
+        return {};
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return body;
+    }
+}
+function decodeBase64(encoded) {
+    if (typeof Buffer !== "undefined") {
+        return new Uint8Array(Buffer.from(encoded, "base64"));
+    }
+    const binary = atob(encoded);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index++) {
+        bytes[index] = binary.charCodeAt(index);
+    }
+    return bytes;
+}

package/dist/cjs/predictions/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./keys.js";
+export * from "./pdas.js";
+export * from "./client.js";
+export * from "./relayer.js";

package/dist/cjs/predictions/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./keys.js"), exports);
+__exportStar(require("./pdas.js"), exports);
+__exportStar(require("./client.js"), exports);
+__exportStar(require("./relayer.js"), exports);

package/dist/cjs/predictions/keys.d.ts

@@ -0,0 +1,14 @@
+import { Keypair } from "@solana/web3.js";
+export interface PredictionKeyBundle {
+    withdrawalId: Uint8Array;
+    withdrawalIdHex: string;
+    ephemeral: Keypair;
+    claimantPublicKey: string;
+    claimantSecretKey: string;
+}
+export declare function derivePredictionEphemeralKeypair(spendingKey: Uint8Array, nonce: number): Keypair;
+export declare function derivePredictionWithdrawalId(spendingKey: Uint8Array, nonce: number): Uint8Array;
+export declare function predictionWithdrawalIdToHex(withdrawalId: Uint8Array): string;
+export declare function predictionWithdrawalIdFromHex(value: string): Uint8Array;
+/** Derive every client-held key field needed across a prediction lifecycle. */
+export declare function derivePredictionKeyBundle(spendingKey: Uint8Array, nonce: number): PredictionKeyBundle;

package/dist/cjs/predictions/keys.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivePredictionEphemeralKeypair = derivePredictionEphemeralKeypair;
+exports.derivePredictionWithdrawalId = derivePredictionWithdrawalId;
+exports.predictionWithdrawalIdToHex = predictionWithdrawalIdToHex;
+exports.predictionWithdrawalIdFromHex = predictionWithdrawalIdFromHex;
+exports.derivePredictionKeyBundle = derivePredictionKeyBundle;
+const sha256_1 = require("@noble/hashes/sha256");
+const web3_js_1 = require("@solana/web3.js");
+const encoding_js_1 = require("../identity/encoding.js");
+function derivePredictionEphemeralKeypair(spendingKey, nonce) {
+    (0, encoding_js_1.assertBytes)(spendingKey, 32, "spending key");
+    if (!Number.isSafeInteger(nonce) || nonce < 0) {
+        throw new RangeError("prediction nonce must be a non-negative safe integer");
+    }
+    return web3_js_1.Keypair.fromSeed((0, sha256_1.sha256)((0, encoding_js_1.concatBytes)((0, encoding_js_1.utf8)("prediction_ephemeral"), spendingKey, (0, encoding_js_1.uint64Le)(BigInt(nonce), "prediction nonce"))));
+}
+function derivePredictionWithdrawalId(spendingKey, nonce) {
+    (0, encoding_js_1.assertBytes)(spendingKey, 32, "spending key");
+    return (0, sha256_1.sha256)((0, encoding_js_1.concatBytes)((0, encoding_js_1.utf8)("prediction_withdrawal_v1"), spendingKey, (0, encoding_js_1.uint32Le)(nonce, "prediction nonce")));
+}
+function predictionWithdrawalIdToHex(withdrawalId) {
+    (0, encoding_js_1.assertBytes)(withdrawalId, 32, "prediction withdrawal ID");
+    return (0, encoding_js_1.bytesToHex)(withdrawalId);
+}
+function predictionWithdrawalIdFromHex(value) {
+    return (0, encoding_js_1.hexToBytes)(value, 32, "prediction withdrawal ID");
+}
+/** Derive every client-held key field needed across a prediction lifecycle. */
+function derivePredictionKeyBundle(spendingKey, nonce) {
+    const withdrawalId = derivePredictionWithdrawalId(spendingKey, nonce);
+    const ephemeral = derivePredictionEphemeralKeypair(spendingKey, nonce);
+    return {
+        withdrawalId,
+        withdrawalIdHex: predictionWithdrawalIdToHex(withdrawalId),
+        ephemeral,
+        claimantPublicKey: ephemeral.publicKey.toBase58(),
+        claimantSecretKey: (0, encoding_js_1.encodeBase58)(ephemeral.secretKey),
+    };
+}

package/dist/cjs/predictions/pdas.d.ts

@@ -0,0 +1,6 @@
+import { PublicKey } from "@solana/web3.js";
+export declare function derivePredictionSlotPda(params: {
+    programId: PublicKey;
+    mint: PublicKey;
+    withdrawalId: Uint8Array;
+}): PublicKey;

package/dist/cjs/predictions/pdas.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivePredictionSlotPda = derivePredictionSlotPda;
+const web3_js_1 = require("@solana/web3.js");
+const encoding_js_1 = require("../identity/encoding.js");
+function derivePredictionSlotPda(params) {
+    (0, encoding_js_1.assertBytes)(params.withdrawalId, 32, "prediction withdrawal ID");
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        (0, encoding_js_1.utf8)("prediction_slot_v1"),
+        params.mint.toBytes(),
+        params.withdrawalId,
+    ], params.programId)[0];
+}

package/dist/cjs/predictions/relayer.d.ts

@@ -0,0 +1,3 @@
+import type { PredictionOpenRequest, PredictionOpenResponse, PredictionReissueRequest, PredictionReissueResponse } from "./types.js";
+export declare function submitPredictionOpen(data: PredictionOpenRequest): Promise<PredictionOpenResponse>;
+export declare function submitPredictionReissue(data: PredictionReissueRequest): Promise<PredictionReissueResponse>;

package/dist/cjs/predictions/relayer.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitPredictionOpen = submitPredictionOpen;
+exports.submitPredictionReissue = submitPredictionReissue;
+const internal_js_1 = require("../relayer/internal.js");
+function submitPredictionOpen(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitPredictionOpen(data);
+}
+function submitPredictionReissue(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitPredictionReissue(data);
+}

package/dist/cjs/predictions/types.d.ts

@@ -0,0 +1,178 @@
+import type { TransactNote } from "../relayer/types.js";
+export interface PredictionOpenRequest {
+    notes: TransactNote[];
+    /** USDC stake, raw 6-decimal units. */
+    depositAmount: string;
+    /** 32-byte prediction-slot withdrawal ID, hex. */
+    withdrawalId: string;
+    /** Deterministic ephemeral wallet and open-proof claimant, base58. */
+    claimantPublicKey: string;
+    userPublicKey: string;
+}
+export interface PredictionOpenResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature: string;
+        ephemeralWallet: string;
+        ephemeralTokenAccount: string;
+        changeAmount: string;
+        fee: string;
+        feeBps: number;
+        totalDebited: string;
+    };
+}
+export interface PredictionReissueRequest {
+    withdrawalId: string;
+    claimantSecretKey: string;
+    /** Kept for API compatibility; the relayer reads the real chain balance. */
+    reissueAmount: string;
+    veiloPublicKey: string;
+    userPublicKey: string;
+}
+export interface PredictionReissueResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature: string | null;
+        reissueAmount: string;
+        fee?: string;
+        tradeHappened?: boolean;
+    };
+}
+export interface PredictionMarketPricing {
+    buyYesPriceUsd: number;
+    sellYesPriceUsd: number;
+    buyNoPriceUsd: number;
+    sellNoPriceUsd: number;
+    volume: number;
+}
+export interface PredictionMarket {
+    provider: string;
+    marketId: string;
+    status: "open" | "closed" | "cancelled";
+    result: string | null;
+    title: string;
+    openTime: number;
+    closeTime: number;
+    rulesPrimary?: string;
+    imageUrl?: string;
+    clobTokenIds?: string[];
+    pricing: PredictionMarketPricing;
+}
+export interface PredictionEvent {
+    eventId: string;
+    isActive: boolean;
+    isLive: boolean;
+    category: string;
+    subcategory: string;
+    tags: string[];
+    metadata: {
+        title: string;
+        closeTime: string;
+        imageUrl?: string;
+        series?: string;
+        slug?: string;
+    };
+    volumeUsd: string;
+    volume24hr: string;
+    closeCondition?: string;
+    markets: PredictionMarket[];
+}
+export interface PredictionPosition {
+    pubkey: string;
+    owner: string;
+    marketId: string;
+    isYes: boolean;
+    contracts: string;
+    contractsDecimal: string;
+    totalCostUsd: string;
+    sizeUsd: string;
+    valueUsd: string;
+    avgPriceUsd: string;
+    markPriceUsd: string;
+    pnlUsd: string;
+    pnlUsdPercent: number;
+    feesPaidUsd: string;
+    claimed: boolean;
+    claimable: boolean;
+    payoutUsd: string;
+    sellPriceUsd: string;
+    settlementDate: number;
+    eventMetadata: {
+        title: string;
+        category: string;
+        imageUrl?: string;
+    };
+    marketMetadata: {
+        title: string;
+        result: string | null;
+        status: string;
+    };
+}
+export interface PlacePredictionOrderRequest {
+    ownerPubkey: string;
+    marketId: string;
+    isYes: boolean;
+    isBuy: true;
+    depositAmount: string;
+    depositMint: string;
+}
+export interface PredictionTransactionResponse {
+    transaction: string;
+    txMeta: {
+        blockhash: string;
+        lastValidBlockHeight: number;
+    };
+}
+export interface PlacePredictionOrderResponse extends PredictionTransactionResponse {
+    order: {
+        orderPubkey: string;
+        positionPubkey: string;
+        contracts: number;
+    };
+}
+export type PredictionOrderStatus = "pending" | "filled" | "partiallyfilled" | "failed";
+export interface PredictionOrderStatusResponse {
+    orderPubkey: string;
+    status: PredictionOrderStatus;
+    latestEventType: string;
+    latestSignature: string;
+    history: Array<{
+        eventType: string;
+        status: string;
+        rawStatus: string;
+        timestamp: number;
+        signature: string;
+    }>;
+}
+export interface PredictionHistoryEvent {
+    id: number;
+    eventType: string;
+    signature: string;
+    timestamp: number;
+    marketId: string;
+    isYes: boolean;
+    isBuy: boolean;
+    contractsDecimal: string;
+    avgFillPriceUsd?: string;
+    totalCostUsd?: string;
+    netProceedsUsd?: string;
+    realizedPnl?: string;
+    payoutAmountUsd?: string;
+    eventMetadata: {
+        title: string;
+        category?: string;
+        imageUrl?: string;
+    };
+    marketMetadata: {
+        title: string;
+        result: string | null;
+        status: string;
+    };
+}
+export type PredictionPriceInterval = "1d" | "1w" | "1m" | "max";
+export interface PredictionPricePoint {
+    t: number;
+    p: number;
+}

package/dist/cjs/predictions/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/program.d.ts

@@ -1,6 +1,8 @@
 import { Program, Idl, Wallet } from "@coral-xyz/anchor";
 import { Connection, PublicKey } from "@solana/web3.js";
+import { PRIVACY_POOL_CURRENT_IDL, PRIVACY_POOL_IDLS, PRIVACY_POOL_LEGACY2_IDL, PRIVACY_POOL_LEGACY_IDL } from "./idl/index.js";
 export declare const PRIVACY_POOL_IDL: Idl;
+export { PRIVACY_POOL_CURRENT_IDL, PRIVACY_POOL_IDLS, PRIVACY_POOL_LEGACY_IDL, PRIVACY_POOL_LEGACY2_IDL, };
 /** Deployed program ID extracted from the bundled IDL. */
 export declare const PRIVACY_POOL_PROGRAM_ID: PublicKey;
 /**

package/dist/cjs/program.js

@@ -1,18 +1,19 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PRIVACY_POOL_PROGRAM_ID = exports.PRIVACY_POOL_IDL = void 0;
+exports.PRIVACY_POOL_PROGRAM_ID = exports.PRIVACY_POOL_LEGACY2_IDL = exports.PRIVACY_POOL_LEGACY_IDL = exports.PRIVACY_POOL_IDLS = exports.PRIVACY_POOL_CURRENT_IDL = exports.PRIVACY_POOL_IDL = void 0;
 exports.createVeiloProgram = createVeiloProgram;
 exports.createReadonlyVeiloProgram = createReadonlyVeiloProgram;
 const anchor_1 = require("@coral-xyz/anchor");
 const web3_js_1 = require("@solana/web3.js");
-const privacy_pool_js_1 = __importDefault(require("./idl/privacy_pool.js"));
+const index_js_1 = require("./idl/index.js");
+Object.defineProperty(exports, "PRIVACY_POOL_CURRENT_IDL", { enumerable: true, get: function () { return index_js_1.PRIVACY_POOL_CURRENT_IDL; } });
+Object.defineProperty(exports, "PRIVACY_POOL_IDLS", { enumerable: true, get: function () { return index_js_1.PRIVACY_POOL_IDLS; } });
+Object.defineProperty(exports, "PRIVACY_POOL_LEGACY2_IDL", { enumerable: true, get: function () { return index_js_1.PRIVACY_POOL_LEGACY2_IDL; } });
+Object.defineProperty(exports, "PRIVACY_POOL_LEGACY_IDL", { enumerable: true, get: function () { return index_js_1.PRIVACY_POOL_LEGACY_IDL; } });
 // Re-export so consumers can access the raw IDL if needed
-exports.PRIVACY_POOL_IDL = privacy_pool_js_1.default;
+exports.PRIVACY_POOL_IDL = index_js_1.PRIVACY_POOL_CURRENT_IDL;
 /** Deployed program ID extracted from the bundled IDL. */
-exports.PRIVACY_POOL_PROGRAM_ID = new web3_js_1.PublicKey(privacy_pool_js_1.default.address);
+exports.PRIVACY_POOL_PROGRAM_ID = new web3_js_1.PublicKey(index_js_1.PRIVACY_POOL_CURRENT_IDL.address);
 /**
  * Create an Anchor `Program` instance for the Veilo Privacy Pool.
  *

package/dist/cjs/prover.d.ts

@@ -3,8 +3,10 @@ import { type SwapProofBuilder } from "./proofs/swap.js";
 /**
  * Circuit artifact paths required by snarkjs.
  *
- * These files are large (10-100 MB) and should NOT be bundled in npm.
- * Host them on GitHub Releases, IPFS, or a CDN and download at runtime.
+ * These files are large (10-100 MB) and are NOT bundled in the npm package —
+ * `files` ships `dist/` only. Optional: omit them and the prover resolves a
+ * local copy (see `resolveCircuitArtifacts`). Supply them explicitly whenever
+ * the defaults cannot apply, which includes every browser build.
  *
  * For Node.js: pass file system paths (e.g. "./circuits/transaction.wasm").
  * For browsers: pass Uint8Array buffers or URLs that fetch returns as ArrayBuffer.
@@ -15,6 +17,27 @@ export interface CircuitArtifacts {
     /** Path or buffer for the Groth16 proving key (.zkey) */
     zkeyPath: string | Uint8Array;
 }
+/** The circuits this package can resolve artifacts for. */
+export type CircuitName = "transaction" | "swap";
+/**
+ * Resolve circuit artifacts from disk when the caller did not supply them.
+ *
+ * Search order, first hit wins:
+ *
+ *   1. $VEILO_CIRCUITS_DIR                  explicit override
+ *   2. <package>/circuits                   populated by `npm run copy:circuits`
+ *   3. <cwd>/circuits
+ *   4. <cwd>/node_modules/@veilo/sdk-core/circuits
+ *
+ * NODE ONLY, AND DELIBERATELY LAZY. `node:fs` is imported inside the call, not
+ * at module scope: this module is reachable from the package root export, and a
+ * top-level `node:fs` import throws at bundle time in browser builds with no
+ * Node polyfill — the same reason `random.ts` avoids `node:crypto`. Browsers
+ * must pass `CircuitArtifacts` explicitly; there is nothing to resolve there.
+ *
+ * @throws when no candidate directory holds both files, listing what it tried
+ */
+export declare function resolveCircuitArtifacts(circuit: CircuitName): Promise<CircuitArtifacts>;
 /**
  * Create a proof builder function for the transaction circuit.
  *
@@ -41,9 +64,9 @@ export interface CircuitArtifacts {
  * const proof = await prover(circuitInputs);
  * ```
  */
-export declare function createTransactionProver(artifacts: CircuitArtifacts): TransactionProofBuilder;
+export declare function createTransactionProver(artifacts?: CircuitArtifacts): TransactionProofBuilder;
 /** Create a proof builder for the current `swap.circom` witness shape. */
-export declare function createSwapProver(artifacts: CircuitArtifacts): SwapProofBuilder;
+export declare function createSwapProver(artifacts?: CircuitArtifacts): SwapProofBuilder;
 /**
  * Verify a Groth16 proof against public signals and a verification key.
  *