@veilo/sdk-core 0.5.0 → 0.6.0

package/dist/cjs/perps/constants.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JPERP_USD_DECIMALS = exports.JPERP_LONG_DECIMALS = exports.JPERP_LONG_JUPITER_MINTS = exports.JPERP_LONG_POOL_MINTS = exports.JUPITER_PERPS_DOVES_ORACLES = exports.JUPITER_PERPS_CUSTODIES = exports.JPERP_WRAPPED_SOL_MINT = exports.JPERP_NATIVE_SOL_MINT = exports.JPERP_USDC_MINT = exports.JUPITER_JLP_MINT = exports.JUPITER_PERPS_POOL = exports.JUPITER_PERPS_EVENT_AUTHORITY = exports.JUPITER_PERPS_PROGRAM_ID = void 0;
+exports.getJperpMarketPayload = getJperpMarketPayload;
+exports.JUPITER_PERPS_PROGRAM_ID = "PERPHjGBqRHArX4DySjwM6UJHiR3sWAatqfdBS2qQJu";
+exports.JUPITER_PERPS_EVENT_AUTHORITY = "37hJBDnntwqhGbK7L6M1bLyvccj4u55CCUiLPdYkiqBN";
+exports.JUPITER_PERPS_POOL = "5BUwFW4nRbftYTDMbgxykoFWqWHPzahFSNAaaaJtVKsq";
+exports.JUPITER_JLP_MINT = "27G8MtK7VtTcCHkpASjSDdkWWYfoqT6ggEuKidVJidD4";
+exports.JPERP_USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+exports.JPERP_NATIVE_SOL_MINT = "11111111111111111111111111111111";
+exports.JPERP_WRAPPED_SOL_MINT = "So11111111111111111111111111111111111111112";
+exports.JUPITER_PERPS_CUSTODIES = {
+    SOL: "7xS2gz2bTp3fwCC7knJvUWTEU9Tycczu6VhJYKgi1wdz",
+    ETH: "AQCGyheWPLeo6Qp9WpYS9m3Qj479t7R636N9ey1rEjEn",
+    BTC: "5Pv3gM9JrFFH883SWAhvJC9RPYmo8UNxuFtv5bMMALkm",
+    USDC: "G18jKKXQwBbrHeiK3C9MRXhkHsLHf7XgCSisykV46EZa",
+    USDT: "4vkNeXiYEUizLdrpdPS1eC2mccyM4NUPRtERrk6ZETkk",
+};
+exports.JUPITER_PERPS_DOVES_ORACLES = {
+    SOL: "FYq2BWQ1V5P1WFBqr3qB2Kb5yHVvSv7upzKodgQE5zXh",
+    ETH: "AFZnHPzy4mvVCffrVwhewHbFc93uTHvDSFrVH7GtfXF1",
+    BTC: "hUqAT1KQ7eW1i6Csp9CXYtpPfSAvi835V7wKi5fRfmC",
+};
+exports.JPERP_LONG_POOL_MINTS = {
+    SOL: exports.JPERP_NATIVE_SOL_MINT,
+    ETH: "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs",
+    BTC: "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh",
+};
+exports.JPERP_LONG_JUPITER_MINTS = {
+    SOL: exports.JPERP_WRAPPED_SOL_MINT,
+    ETH: exports.JPERP_LONG_POOL_MINTS.ETH,
+    BTC: exports.JPERP_LONG_POOL_MINTS.BTC,
+};
+exports.JPERP_LONG_DECIMALS = {
+    SOL: 9,
+    ETH: 8,
+    BTC: 8,
+};
+exports.JPERP_USD_DECIMALS = 6;
+/** Resolve the exact market payload duplicated by the wallet-app reference. */
+function getJperpMarketPayload(market, side) {
+    const isLong = side === "long";
+    return {
+        custody: exports.JUPITER_PERPS_CUSTODIES[market],
+        collateralCustody: exports.JUPITER_PERPS_CUSTODIES[isLong ? market : "USDC"],
+        inputMint: isLong ? exports.JPERP_LONG_POOL_MINTS[market] : exports.JPERP_USDC_MINT,
+        jupiterInputMint: isLong
+            ? exports.JPERP_LONG_JUPITER_MINTS[market]
+            : exports.JPERP_USDC_MINT,
+        dovesOracle: exports.JUPITER_PERPS_DOVES_ORACLES[market],
+    };
+}

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

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

package/dist/cjs/perps/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("./constants.js"), exports);
+__exportStar(require("./keys.js"), exports);
+__exportStar(require("./pdas.js"), exports);
+__exportStar(require("./relayer.js"), exports);

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

@@ -0,0 +1,16 @@
+import { Keypair } from "@solana/web3.js";
+export interface JperpKeyBundle {
+    withdrawalId: Uint8Array;
+    withdrawalIdHex: string;
+    claimant: Keypair;
+    claimantPublicKey: string;
+    claimantSecretKey: string;
+}
+export declare function deriveJperpWithdrawalId(spendingKey: Uint8Array, index: number): Uint8Array;
+export declare function deriveJperpClaimantKeypair(spendingKey: Uint8Array, withdrawalId: Uint8Array): Keypair;
+export declare function jperpWithdrawalIdToHex(withdrawalId: Uint8Array): string;
+export declare function jperpWithdrawalIdFromHex(value: string): Uint8Array;
+/** Derive every client-held key field needed across the jPerp lifecycle. */
+export declare function deriveJperpKeyBundle(spendingKey: Uint8Array, index: number): JperpKeyBundle;
+/** Match the client reference's per-request Jupiter PDA namespace. */
+export declare function createJperpCounter(): string;

package/dist/cjs/perps/keys.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveJperpWithdrawalId = deriveJperpWithdrawalId;
+exports.deriveJperpClaimantKeypair = deriveJperpClaimantKeypair;
+exports.jperpWithdrawalIdToHex = jperpWithdrawalIdToHex;
+exports.jperpWithdrawalIdFromHex = jperpWithdrawalIdFromHex;
+exports.deriveJperpKeyBundle = deriveJperpKeyBundle;
+exports.createJperpCounter = createJperpCounter;
+const sha256_1 = require("@noble/hashes/sha256");
+const web3_js_1 = require("@solana/web3.js");
+const encoding_js_1 = require("../identity/encoding.js");
+function deriveJperpWithdrawalId(spendingKey, index) {
+    (0, encoding_js_1.assertBytes)(spendingKey, 32, "spending key");
+    return (0, sha256_1.sha256)((0, encoding_js_1.concatBytes)((0, encoding_js_1.utf8)("jperp_withdrawal_v1"), spendingKey, (0, encoding_js_1.uint32Le)(index, "jPerp position index")));
+}
+function deriveJperpClaimantKeypair(spendingKey, withdrawalId) {
+    (0, encoding_js_1.assertBytes)(spendingKey, 32, "spending key");
+    (0, encoding_js_1.assertBytes)(withdrawalId, 32, "jPerp withdrawal ID");
+    return web3_js_1.Keypair.fromSeed((0, sha256_1.sha256)((0, encoding_js_1.concatBytes)((0, encoding_js_1.utf8)("jperp_claimant"), spendingKey, withdrawalId)));
+}
+function jperpWithdrawalIdToHex(withdrawalId) {
+    (0, encoding_js_1.assertBytes)(withdrawalId, 32, "jPerp withdrawal ID");
+    return (0, encoding_js_1.bytesToHex)(withdrawalId);
+}
+function jperpWithdrawalIdFromHex(value) {
+    return (0, encoding_js_1.hexToBytes)(value, 32, "jPerp withdrawal ID");
+}
+/** Derive every client-held key field needed across the jPerp lifecycle. */
+function deriveJperpKeyBundle(spendingKey, index) {
+    const withdrawalId = deriveJperpWithdrawalId(spendingKey, index);
+    const claimant = deriveJperpClaimantKeypair(spendingKey, withdrawalId);
+    return {
+        withdrawalId,
+        withdrawalIdHex: jperpWithdrawalIdToHex(withdrawalId),
+        claimant,
+        claimantPublicKey: claimant.publicKey.toBase58(),
+        claimantSecretKey: (0, encoding_js_1.encodeBase58)(claimant.secretKey),
+    };
+}
+/** Match the client reference's per-request Jupiter PDA namespace. */
+function createJperpCounter() {
+    return String(Math.floor(Math.random() * 1000000000000));
+}

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

@@ -0,0 +1,29 @@
+import { PublicKey } from "@solana/web3.js";
+import type { JperpSide } from "./types.js";
+export declare const JPERP_SIDE_LONG = 1;
+export declare const JPERP_SIDE_SHORT = 2;
+export declare const JPERP_CHANGE_INCREASE = 1;
+export declare const JPERP_CHANGE_DECREASE = 2;
+export declare function deriveJupiterPerpetualsPda(): PublicKey;
+export declare function deriveJperpExecutorPda(params: {
+    programId: PublicKey;
+    mint: PublicKey;
+    claimant: PublicKey;
+    withdrawalId: Uint8Array;
+}): PublicKey;
+export declare function deriveJperpSlotPda(params: {
+    programId: PublicKey;
+    mint: PublicKey;
+    withdrawalId: Uint8Array;
+}): PublicKey;
+export declare function deriveJupiterPerpPositionPda(params: {
+    executor: PublicKey;
+    custody: PublicKey;
+    collateralCustody: PublicKey;
+    side: JperpSide;
+}): PublicKey;
+export declare function deriveJupiterPerpRequestPda(params: {
+    position: PublicKey;
+    counter: bigint;
+    change: "increase" | "decrease";
+}): PublicKey;

package/dist/cjs/perps/pdas.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JPERP_CHANGE_DECREASE = exports.JPERP_CHANGE_INCREASE = exports.JPERP_SIDE_SHORT = exports.JPERP_SIDE_LONG = void 0;
+exports.deriveJupiterPerpetualsPda = deriveJupiterPerpetualsPda;
+exports.deriveJperpExecutorPda = deriveJperpExecutorPda;
+exports.deriveJperpSlotPda = deriveJperpSlotPda;
+exports.deriveJupiterPerpPositionPda = deriveJupiterPerpPositionPda;
+exports.deriveJupiterPerpRequestPda = deriveJupiterPerpRequestPda;
+const web3_js_1 = require("@solana/web3.js");
+const encoding_js_1 = require("../identity/encoding.js");
+const constants_js_1 = require("./constants.js");
+exports.JPERP_SIDE_LONG = 1;
+exports.JPERP_SIDE_SHORT = 2;
+exports.JPERP_CHANGE_INCREASE = 1;
+exports.JPERP_CHANGE_DECREASE = 2;
+function deriveJupiterPerpetualsPda() {
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("perpetuals")], new web3_js_1.PublicKey(constants_js_1.JUPITER_PERPS_PROGRAM_ID))[0];
+}
+function deriveJperpExecutorPda(params) {
+    (0, encoding_js_1.assertBytes)(params.withdrawalId, 32, "jPerp withdrawal ID");
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        (0, encoding_js_1.utf8)("jperp_executor"),
+        params.mint.toBytes(),
+        params.claimant.toBytes(),
+        params.withdrawalId,
+    ], params.programId)[0];
+}
+function deriveJperpSlotPda(params) {
+    (0, encoding_js_1.assertBytes)(params.withdrawalId, 32, "jPerp withdrawal ID");
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("jperp_slot_v1"), params.mint.toBytes(), params.withdrawalId], params.programId)[0];
+}
+function deriveJupiterPerpPositionPda(params) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        (0, encoding_js_1.utf8)("position"),
+        params.executor.toBytes(),
+        new web3_js_1.PublicKey(constants_js_1.JUPITER_PERPS_POOL).toBytes(),
+        params.custody.toBytes(),
+        params.collateralCustody.toBytes(),
+        Uint8Array.from([
+            params.side === "long" ? exports.JPERP_SIDE_LONG : exports.JPERP_SIDE_SHORT,
+        ]),
+    ], new web3_js_1.PublicKey(constants_js_1.JUPITER_PERPS_PROGRAM_ID))[0];
+}
+function deriveJupiterPerpRequestPda(params) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        (0, encoding_js_1.utf8)("position_request"),
+        params.position.toBytes(),
+        (0, encoding_js_1.uint64Le)(params.counter, "jPerp request counter"),
+        Uint8Array.from([
+            params.change === "increase"
+                ? exports.JPERP_CHANGE_INCREASE
+                : exports.JPERP_CHANGE_DECREASE,
+        ]),
+    ], new web3_js_1.PublicKey(constants_js_1.JUPITER_PERPS_PROGRAM_ID))[0];
+}

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

@@ -0,0 +1,9 @@
+import type { JperpCancelTriggerRequest, JperpCancelTriggerResponse, JperpCloseRequest, JperpDecreaseResponse, JperpOpenRequest, JperpOpenResponse, JperpRecoverNativeRequest, JperpRecoverNativeResponse, JperpRecoverSeedRequest, JperpRecoverSeedResponse, JperpReissueRequest, JperpReissueResponse, JperpSetTpslRequest, JperpUpdateTpslRequest } from "./types.js";
+export declare function submitJperpOpen(data: JperpOpenRequest): Promise<JperpOpenResponse>;
+export declare function submitJperpClose(data: JperpCloseRequest): Promise<JperpDecreaseResponse>;
+export declare function submitJperpSetTpsl(data: JperpSetTpslRequest): Promise<JperpDecreaseResponse>;
+export declare function submitJperpUpdateTpsl(data: JperpUpdateTpslRequest): Promise<JperpDecreaseResponse>;
+export declare function submitJperpCancelTrigger(data: JperpCancelTriggerRequest): Promise<JperpCancelTriggerResponse>;
+export declare function submitJperpReissue(data: JperpReissueRequest): Promise<JperpReissueResponse>;
+export declare function submitJperpRecoverSeed(data: JperpRecoverSeedRequest): Promise<JperpRecoverSeedResponse>;
+export declare function submitJperpRecoverNative(data: JperpRecoverNativeRequest): Promise<JperpRecoverNativeResponse>;

package/dist/cjs/perps/relayer.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitJperpOpen = submitJperpOpen;
+exports.submitJperpClose = submitJperpClose;
+exports.submitJperpSetTpsl = submitJperpSetTpsl;
+exports.submitJperpUpdateTpsl = submitJperpUpdateTpsl;
+exports.submitJperpCancelTrigger = submitJperpCancelTrigger;
+exports.submitJperpReissue = submitJperpReissue;
+exports.submitJperpRecoverSeed = submitJperpRecoverSeed;
+exports.submitJperpRecoverNative = submitJperpRecoverNative;
+const internal_js_1 = require("../relayer/internal.js");
+function submitJperpOpen(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpOpen(data);
+}
+function submitJperpClose(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpClose(data);
+}
+function submitJperpSetTpsl(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpSetTpsl(data);
+}
+function submitJperpUpdateTpsl(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpUpdateTpsl(data);
+}
+function submitJperpCancelTrigger(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpCancelTrigger(data);
+}
+function submitJperpReissue(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpReissue(data);
+}
+function submitJperpRecoverSeed(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpRecoverSeed(data);
+}
+function submitJperpRecoverNative(data) {
+    return (0, internal_js_1.getInternalRelayerClient)().submitJperpRecoverNative(data);
+}

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

@@ -0,0 +1,126 @@
+import type { TransactNote } from "../relayer/types.js";
+export type JperpMarket = "SOL" | "ETH" | "BTC";
+export type JperpSide = "long" | "short";
+/** Jupiter market accounts forwarded to the relayer's Perps CPI builder. */
+export interface JperpMarketPayload {
+    custody: string;
+    collateralCustody: string;
+    /** Veilo pool mint used for notes and the ZK proof. */
+    inputMint: string;
+    /** Jupiter SPL collateral mint; WSOL when inputMint is native SOL. */
+    jupiterInputMint?: string;
+    /** Optional; the relayer resolves the known market oracle when omitted. */
+    dovesOracle?: string;
+}
+export interface JperpOpenRequest extends JperpMarketPayload {
+    notes: TransactNote[];
+    depositAmount: string;
+    /** 32-byte withdrawal ID, hex. */
+    withdrawalId: string;
+    claimantPublicKey: string;
+    userPublicKey: string;
+    /** Position size in Jupiter's 1e6 USD units. */
+    sizeUsdDelta: string;
+    collateralTokenDelta: string;
+    side: JperpSide;
+    priceSlippage?: string;
+    counter: string;
+}
+export interface JperpOpenResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature: string;
+        executor: string;
+        position: string;
+        positionRequest: string;
+        changeAmount: string;
+    };
+}
+export interface JperpDecreaseBase extends JperpMarketPayload {
+    withdrawalId: string;
+    claimantSecretKey: string;
+    userPublicKey: string;
+    side: JperpSide;
+    counter: string;
+}
+export interface JperpCloseRequest extends JperpDecreaseBase {
+    collateralUsdDelta?: string;
+    sizeUsdDelta?: string;
+    entirePosition?: boolean;
+    priceSlippage?: string;
+}
+export interface JperpSetTpslRequest extends JperpDecreaseBase {
+    collateralUsdDelta?: string;
+    sizeUsdDelta?: string;
+    triggerPrice: string;
+    triggerAboveThreshold: boolean;
+    entirePosition?: boolean;
+}
+export interface JperpUpdateTpslRequest extends JperpDecreaseBase {
+    sizeUsdDelta?: string;
+    triggerPrice: string;
+}
+export interface JperpDecreaseResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature: string;
+        positionRequest: string;
+    };
+}
+export interface JperpReissueRequest {
+    withdrawalId: string;
+    claimantSecretKey: string;
+    reissueAmount: string;
+    veiloPublicKey: string;
+    userPublicKey: string;
+    poolMint?: string;
+}
+export interface JperpReissueResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature: string;
+        reissueAmount: string;
+    };
+}
+export interface JperpRecoverSeedRequest {
+    withdrawalId: string;
+    claimantPublicKey: string;
+    poolMint: string;
+    userPublicKey: string;
+}
+export interface JperpRecoverSeedResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature?: string;
+        executorWsolAta: string;
+        recoverable: string;
+    };
+}
+export type JperpCancelTriggerRequest = JperpDecreaseBase;
+export interface JperpCancelTriggerResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature: string;
+        triggerRequest: string;
+    };
+}
+export interface JperpRecoverNativeRequest {
+    withdrawalId: string;
+    claimantSecretKey: string;
+    veiloPublicKey: string;
+    userPublicKey: string;
+    poolMint?: string;
+}
+export interface JperpRecoverNativeResponse {
+    success: boolean;
+    message: string;
+    data?: {
+        txSignature: string;
+        recoverAmount: string;
+    };
+}

package/dist/cjs/perps/types.js

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

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

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

package/dist/cjs/positions/index.js

@@ -0,0 +1,20 @@
+"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("./relayer.js"), exports);

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

@@ -0,0 +1,29 @@
+import { Keypair, PublicKey } from "@solana/web3.js";
+import type { NewPositionKeys, PositionNotePayload } from "./types.js";
+export interface PositionKeyMaterial {
+    positionSecretN: bigint;
+    positionBlinding: bigint;
+    positionPubkey: bigint;
+    positionPdaKeyBytes: Uint8Array;
+}
+export interface PositionKeyBundle {
+    material: PositionKeyMaterial;
+    claimant: Keypair;
+    position: NewPositionKeys;
+}
+/** Derive the exact Poseidon key material used by private position notes. */
+export declare function derivePositionKeys(spendingKey: Uint8Array, index: number): PositionKeyMaterial;
+/** Deterministic claimant required to close or merge a position. */
+export declare function derivePositionClaimantKeypair(spendingKey: Uint8Array, positionPdaKeyBytes: Uint8Array): Keypair;
+/** Derive both local secret material and the public request payload. */
+export declare function derivePositionKeyBundle(spendingKey: Uint8Array, index: number): PositionKeyBundle;
+/** Serialize a returned open/merge position into the relayer's close shape. */
+export declare function createPositionNotePayload(params: {
+    amount: bigint | string;
+    commitment: Uint8Array | string;
+    leafIndex: number;
+    mint: PublicKey | string;
+    isToken2022: boolean;
+    treeId?: number;
+    keys: PositionKeyMaterial;
+}): PositionNotePayload;

package/dist/cjs/positions/keys.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivePositionKeys = derivePositionKeys;
+exports.derivePositionClaimantKeypair = derivePositionClaimantKeypair;
+exports.derivePositionKeyBundle = derivePositionKeyBundle;
+exports.createPositionNotePayload = createPositionNotePayload;
+const sha256_1 = require("@noble/hashes/sha256");
+const web3_js_1 = require("@solana/web3.js");
+const poseidon_js_1 = require("../poseidon.js");
+const encoding_js_1 = require("../identity/encoding.js");
+/** Derive the exact Poseidon key material used by private position notes. */
+function derivePositionKeys(spendingKey, index) {
+    (0, encoding_js_1.assertBytes)(spendingKey, 32, "spending key");
+    if (!Number.isSafeInteger(index) || index < 0) {
+        throw new RangeError("position index must be a non-negative safe integer");
+    }
+    const rootSecret = (0, poseidon_js_1.bytesToBigIntBE)((0, sha256_1.sha256)((0, encoding_js_1.concatBytes)(spendingKey, (0, encoding_js_1.utf8)("veilo_v1")))) % poseidon_js_1.BN254_FR_MODULUS;
+    const positionSecretN = (0, poseidon_js_1.poseidon2)(rootSecret, BigInt(index));
+    const positionBlinding = (0, poseidon_js_1.poseidon2)(positionSecretN, 1n);
+    const positionPubkey = (0, poseidon_js_1.poseidon1)(positionSecretN);
+    return {
+        positionSecretN,
+        positionBlinding,
+        positionPubkey,
+        positionPdaKeyBytes: (0, poseidon_js_1.bigIntToBytesBE)(positionPubkey),
+    };
+}
+/** Deterministic claimant required to close or merge a position. */
+function derivePositionClaimantKeypair(spendingKey, positionPdaKeyBytes) {
+    (0, encoding_js_1.assertBytes)(spendingKey, 32, "spending key");
+    (0, encoding_js_1.assertBytes)(positionPdaKeyBytes, 32, "position PDA key");
+    return web3_js_1.Keypair.fromSeed((0, sha256_1.sha256)((0, encoding_js_1.concatBytes)((0, encoding_js_1.utf8)("position_claimant"), spendingKey, positionPdaKeyBytes)));
+}
+/** Derive both local secret material and the public request payload. */
+function derivePositionKeyBundle(spendingKey, index) {
+    const material = derivePositionKeys(spendingKey, index);
+    const claimant = derivePositionClaimantKeypair(spendingKey, material.positionPdaKeyBytes);
+    return {
+        material,
+        claimant,
+        position: {
+            pubkey: material.positionPubkey.toString(),
+            blinding: (0, encoding_js_1.bytesToHex)((0, poseidon_js_1.bigIntToBytesBE)(material.positionBlinding)),
+            pdaKey: (0, encoding_js_1.bytesToHex)(material.positionPdaKeyBytes),
+            claimantPublicKey: claimant.publicKey.toBase58(),
+        },
+    };
+}
+/** Serialize a returned open/merge position into the relayer's close shape. */
+function createPositionNotePayload(params) {
+    if (!Number.isSafeInteger(params.leafIndex) || params.leafIndex < 0) {
+        throw new RangeError("leafIndex must be a non-negative safe integer");
+    }
+    const commitment = typeof params.commitment === "string"
+        ? (0, encoding_js_1.hexToBytes)(params.commitment, 32, "position commitment")
+        : params.commitment;
+    (0, encoding_js_1.assertBytes)(commitment, 32, "position commitment");
+    const mint = params.mint instanceof web3_js_1.PublicKey ? params.mint : new web3_js_1.PublicKey(params.mint);
+    return {
+        amount: params.amount.toString(),
+        commitment: (0, encoding_js_1.bytesToHex)(commitment),
+        privateKey: (0, encoding_js_1.bytesToHex)((0, poseidon_js_1.bigIntToBytesBE)(params.keys.positionSecretN)),
+        publicKey: params.keys.positionPubkey.toString(),
+        blinding: (0, encoding_js_1.bytesToHex)((0, poseidon_js_1.bigIntToBytesBE)(params.keys.positionBlinding)),
+        leafIndex: params.leafIndex,
+        positionPdaKey: (0, encoding_js_1.bytesToHex)(params.keys.positionPdaKeyBytes),
+        mint: mint.toBase58(),
+        isToken2022: params.isToken2022,
+        treeId: params.treeId ?? 0,
+    };
+}

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

@@ -0,0 +1,15 @@
+import { PublicKey } from "@solana/web3.js";
+export declare function derivePositionConfigPda(programId: PublicKey): PublicKey;
+export declare function derivePositionTreePda(programId: PublicKey, treeId?: number): PublicKey;
+export declare function derivePositionVaultRecordPda(programId: PublicKey, mint: PublicKey): PublicKey;
+export declare function derivePositionVaultPda(programId: PublicKey, mint: PublicKey): PublicKey;
+export declare function derivePositionPda(programId: PublicKey, positionPdaKey: Uint8Array): PublicKey;
+export declare function derivePositionNullifierMarkerPda(programId: PublicKey, mint: PublicKey, nullifier: Uint8Array): PublicKey;
+export declare function derivePositionExecutorPda(params: {
+    programId: PublicKey;
+    sourceMint: PublicKey;
+    destMint: PublicKey;
+    inputNullifier0: Uint8Array;
+    relayer: PublicKey;
+}): PublicKey;
+export declare function derivePositionSwapLegsBufferPda(programId: PublicKey, nullifier0: Uint8Array): PublicKey;

package/dist/cjs/positions/pdas.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivePositionConfigPda = derivePositionConfigPda;
+exports.derivePositionTreePda = derivePositionTreePda;
+exports.derivePositionVaultRecordPda = derivePositionVaultRecordPda;
+exports.derivePositionVaultPda = derivePositionVaultPda;
+exports.derivePositionPda = derivePositionPda;
+exports.derivePositionNullifierMarkerPda = derivePositionNullifierMarkerPda;
+exports.derivePositionExecutorPda = derivePositionExecutorPda;
+exports.derivePositionSwapLegsBufferPda = derivePositionSwapLegsBufferPda;
+const web3_js_1 = require("@solana/web3.js");
+const encoding_js_1 = require("../identity/encoding.js");
+function treeIdLe(treeId) {
+    if (!Number.isInteger(treeId) || treeId < 0 || treeId > 0xffff) {
+        throw new RangeError("position tree ID must be an unsigned 16-bit integer");
+    }
+    const bytes = new Uint8Array(2);
+    new DataView(bytes.buffer).setUint16(0, treeId, true);
+    return bytes;
+}
+function derivePositionConfigPda(programId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("position_config_v1")], programId)[0];
+}
+function derivePositionTreePda(programId, treeId = 0) {
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("position_tree_v1"), treeIdLe(treeId)], programId)[0];
+}
+function derivePositionVaultRecordPda(programId, mint) {
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("position_vault_v1"), mint.toBytes()], programId)[0];
+}
+function derivePositionVaultPda(programId, mint) {
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("position_vault_token_v1"), mint.toBytes()], programId)[0];
+}
+function derivePositionPda(programId, positionPdaKey) {
+    (0, encoding_js_1.assertBytes)(positionPdaKey, 32, "position PDA key");
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("position_pda_v1"), positionPdaKey], programId)[0];
+}
+function derivePositionNullifierMarkerPda(programId, mint, nullifier) {
+    (0, encoding_js_1.assertBytes)(nullifier, 32, "position nullifier");
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("position_nullifier_v1"), mint.toBytes(), nullifier], programId)[0];
+}
+function derivePositionExecutorPda(params) {
+    (0, encoding_js_1.assertBytes)(params.inputNullifier0, 32, "input nullifier");
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        (0, encoding_js_1.utf8)("position_executor"),
+        params.sourceMint.toBytes(),
+        params.destMint.toBytes(),
+        params.inputNullifier0,
+        params.relayer.toBytes(),
+    ], params.programId)[0];
+}
+function derivePositionSwapLegsBufferPda(programId, nullifier0) {
+    (0, encoding_js_1.assertBytes)(nullifier0, 32, "input nullifier");
+    return web3_js_1.PublicKey.findProgramAddressSync([(0, encoding_js_1.utf8)("swap_legs_v1"), nullifier0], programId)[0];
+}

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

@@ -0,0 +1,4 @@
+import type { ClosePositionRequest, ClosePositionResponse, MergePositionsRequest, MergePositionsResponse, OpenPositionRequest, OpenPositionResponse } from "./types.js";
+export declare function submitOpenPosition(data: OpenPositionRequest): Promise<OpenPositionResponse>;
+export declare function submitClosePosition(data: ClosePositionRequest): Promise<ClosePositionResponse>;
+export declare function submitMergePositions(data: MergePositionsRequest): Promise<MergePositionsResponse>;

package/dist/cjs/positions/relayer.js

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