pacifica-js-sdk 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+
+# Pacifica JS SDK
+
+Official JavaScript/TypeScript SDK for [Pacifica](https://pacifica.fi).
+Converted from the official [Python SDK](https://github.com/pacifica-fi/python-sdk).
+
+## Installation
+
+```bash
+npm install pacifica-js-sdk
+```
+
+## Usage
+
+Create a `.env` file with your private key (optional for public data):
+```
+PRIVATE_KEY=your_base58_private_key
+```
+
+Run the example:
+```bash
+npx tsx examples/usage.ts
+```
+
+## Code Example
+
+```typescript
+import { PacificaClient } from './src';
+
+const client = new PacificaClient({
+    privateKey: "YOUR_BASE58_PRIVATE_KEY",
+    network: "testnet"
+});
+
+// REST API
+const subaccounts = await client.listSubaccounts();
+
+// WebSocket API
+await client.connect();
+await client.createMarketOrderWs({
+    symbol: "BTC",
+    side: "bid",
+    amount: "0.1"
+});
+```
+
+## Features
+
+- Full WebSocket trading support (Market, Limit, Cancel, Cancel All)
+- REST API support
+- Automatic request signing matching Python SDK logic
+- TypeScript support

package/dist/client.d.ts

@@ -0,0 +1,117 @@
+import { EventEmitter } from 'events';
+export interface PacificaClientConfig {
+    privateKey?: string;
+    network?: 'mainnet' | 'testnet';
+}
+export declare class PacificaClient extends EventEmitter {
+    private keypair?;
+    private restUrl;
+    private wsUrl;
+    private ws;
+    private wsConnected;
+    private pendingRequests;
+    private axiosInstance;
+    constructor(config: PacificaClientConfig);
+    connect(): Promise<void>;
+    close(): void;
+    private handleWsMessage;
+    private sendWsRequest;
+    private signAndPreparePayload;
+    /**
+     * Subscribe to a data source
+     */
+    subscribe(source: string, params?: any): Promise<void>;
+    /**
+     * Create a market order via WebSocket
+     */
+    createMarketOrderWs(params: {
+        symbol: string;
+        side: 'bid' | 'ask';
+        amount: string;
+        reduce_only?: boolean;
+        slippage_percent?: string;
+        client_order_id?: string;
+    }): Promise<any>;
+    /**
+     * Create a limit order via WebSocket
+     */
+    createLimitOrderWs(params: {
+        symbol: string;
+        side: 'bid' | 'ask';
+        amount: string;
+        price: string;
+        reduce_only?: boolean;
+        client_order_id?: string;
+        tif?: string;
+    }): Promise<any>;
+    /**
+     * Cancel an order via WebSocket
+     */
+    cancelOrderWs(params: {
+        symbol: string;
+        order_id?: string;
+        client_order_id?: string;
+    }): Promise<any>;
+    /**
+     * Cancel all orders via WebSocket
+     */
+    cancelAllOrdersWs(params: {
+        symbol?: string;
+        all_symbols?: boolean;
+        exclude_reduce_only?: boolean;
+    }): Promise<any>;
+    /**
+     * Helper to send signed REST requests
+     */
+    private sendRestRequest;
+    /**
+     * Create a market order via REST
+     */
+    createMarketOrderRest(params: {
+        symbol: string;
+        side: 'bid' | 'ask';
+        amount: string;
+        reduce_only?: boolean;
+        slippage_percent?: string;
+        client_order_id?: string;
+    }): Promise<any>;
+    /**
+     * Create a limit order via REST
+     */
+    createLimitOrderRest(params: {
+        symbol: string;
+        side: 'bid' | 'ask';
+        amount: string;
+        price: string;
+        reduce_only?: boolean;
+        client_order_id?: string;
+        tif?: string;
+    }): Promise<any>;
+    /**
+     * Cancel an order via REST
+     */
+    cancelOrderRest(params: {
+        symbol: string;
+        order_id?: string;
+        client_order_id?: string;
+    }): Promise<any>;
+    /**
+     * Cancel all orders via REST
+     */
+    cancelAllOrdersRest(params: {
+        all_symbols?: boolean;
+        exclude_reduce_only?: boolean;
+    }): Promise<any>;
+    /**
+     * List subaccounts via REST
+     */
+    listSubaccounts(): Promise<any>;
+    /**
+     * Get exchange information including all available markets
+     */
+    getMarkets(): Promise<any>;
+    /**
+     * Get current prices for all markets
+     */
+    getPrices(): Promise<any>;
+}

package/dist/client.js

@@ -0,0 +1,284 @@
+import { Keypair } from "@solana/web3.js";
+import { WebSocket } from "ws";
+import axios from "axios";
+import bs58 from "bs58";
+import { v4 as uuidv4 } from 'uuid';
+import { EventEmitter } from 'events';
+import { MAINNET_REST_URL, MAINNET_WS_URL, TESTNET_REST_URL, TESTNET_WS_URL, DEFAULT_EXPIRY_WINDOW } from "./config.js";
+import { signMessage } from "./utils.js";
+export class PacificaClient extends EventEmitter {
+    constructor(config) {
+        super();
+        this.ws = null;
+        this.wsConnected = null;
+        this.pendingRequests = new Map();
+        if (config.privateKey) {
+            this.keypair = Keypair.fromSecretKey(bs58.decode(config.privateKey));
+        }
+        if (config.network === 'testnet') {
+            this.restUrl = TESTNET_REST_URL;
+            this.wsUrl = TESTNET_WS_URL;
+        }
+        else {
+            this.restUrl = MAINNET_REST_URL;
+            this.wsUrl = MAINNET_WS_URL;
+        }
+        this.axiosInstance = axios.create({
+            baseURL: this.restUrl,
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+    }
+    // WebSocket Management
+    async connect() {
+        if (this.ws?.readyState === WebSocket.OPEN)
+            return;
+        this.ws = new WebSocket(this.wsUrl);
+        this.wsConnected = new Promise((resolve, reject) => {
+            const onOpen = () => {
+                this.ws?.removeListener('error', onError);
+                resolve();
+                this.emit('connected');
+            };
+            const onError = (err) => {
+                this.ws?.removeListener('open', onOpen);
+                reject(err);
+            };
+            this.ws?.once('open', onOpen);
+            this.ws?.once('error', onError);
+        });
+        this.ws.on('message', (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.handleWsMessage(message);
+            }
+            catch (err) {
+                console.error('Failed to parse WS message:', err);
+            }
+        });
+        this.ws.on('close', () => {
+            this.ws = null;
+            this.wsConnected = null;
+            this.emit('disconnected');
+        });
+        await this.wsConnected;
+    }
+    close() {
+        if (this.ws) {
+            this.ws.close();
+        }
+    }
+    handleWsMessage(message) {
+        if (message.id && this.pendingRequests.has(message.id)) {
+            const { resolve, reject } = this.pendingRequests.get(message.id);
+            if (message.error) {
+                reject(new Error(message.error.message || JSON.stringify(message.error)));
+            }
+            else {
+                resolve(message.result || message);
+            }
+            this.pendingRequests.delete(message.id);
+        }
+        else {
+            // Handle subscriptions or unsolicited messages
+            this.emit('message', message);
+        }
+    }
+    async sendWsRequest(method, payload) {
+        await this.connect();
+        const id = uuidv4();
+        const message = {
+            id,
+            params: {
+                [method]: payload
+            }
+        };
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, { resolve, reject });
+            this.ws.send(JSON.stringify(message));
+            // Timeout after 30 seconds
+            setTimeout(() => {
+                if (this.pendingRequests.has(id)) {
+                    this.pendingRequests.delete(id);
+                    reject(new Error('Request timed out'));
+                }
+            }, 30000);
+        });
+    }
+    signAndPreparePayload(type, payload) {
+        if (!this.keypair) {
+            throw new Error("Private key is required for signing requests");
+        }
+        const timestamp = Date.now(); // Milliseconds
+        const expiry_window = DEFAULT_EXPIRY_WINDOW;
+        const header = {
+            timestamp,
+            expiry_window,
+            type
+        };
+        const { signature } = signMessage(header, payload, this.keypair);
+        return {
+            account: this.keypair.publicKey.toBase58(),
+            signature,
+            timestamp,
+            expiry_window,
+            ...payload
+        };
+    }
+    /**
+     * Subscribe to a data source
+     */
+    async subscribe(source, params = {}) {
+        await this.connect();
+        const message = {
+            method: "subscribe",
+            params: {
+                source,
+                ...params
+            }
+        };
+        this.ws.send(JSON.stringify(message));
+    }
+    // WebSocket Trading Operations
+    /**
+     * Create a market order via WebSocket
+     */
+    async createMarketOrderWs(params) {
+        const payload = {
+            symbol: params.symbol,
+            side: params.side,
+            amount: params.amount,
+            reduce_only: params.reduce_only ?? false,
+            slippage_percent: params.slippage_percent ?? "0.5",
+            client_order_id: params.client_order_id ?? uuidv4()
+        };
+        const signedPayload = this.signAndPreparePayload("create_market_order", payload);
+        return this.sendWsRequest("create_market_order", signedPayload);
+    }
+    /**
+     * Create a limit order via WebSocket
+     */
+    async createLimitOrderWs(params) {
+        const payload = {
+            symbol: params.symbol,
+            side: params.side,
+            amount: params.amount,
+            price: params.price,
+            reduce_only: params.reduce_only ?? false,
+            client_order_id: params.client_order_id ?? uuidv4(),
+            tif: params.tif || "GTC"
+        };
+        // Note: The method name in WS params is 'create_order', but type is 'create_order'
+        const signedPayload = this.signAndPreparePayload("create_order", payload);
+        return this.sendWsRequest("create_order", signedPayload);
+    }
+    /**
+     * Cancel an order via WebSocket
+     */
+    async cancelOrderWs(params) {
+        const payload = {
+            symbol: params.symbol
+        };
+        if (params.order_id)
+            payload.order_id = params.order_id;
+        if (params.client_order_id)
+            payload.client_order_id = params.client_order_id;
+        const signedPayload = this.signAndPreparePayload("cancel_order", payload);
+        return this.sendWsRequest("cancel_order", signedPayload);
+    }
+    /**
+     * Cancel all orders via WebSocket
+     */
+    async cancelAllOrdersWs(params) {
+        const payload = {
+            all_symbols: params.all_symbols ?? true,
+            exclude_reduce_only: params.exclude_reduce_only ?? false
+        };
+        // Note: symbol is not used if all_symbols is true? Python code sends just these two.
+        const signedPayload = this.signAndPreparePayload("cancel_all_orders", payload);
+        return this.sendWsRequest("cancel_all_orders", signedPayload);
+    }
+    // REST API Methods
+    /**
+     * Helper to send signed REST requests
+     */
+    async sendRestRequest(endpoint, type, payload) {
+        const signedPayload = this.signAndPreparePayload(type, payload);
+        const response = await this.axiosInstance.post(endpoint, signedPayload);
+        return response.data;
+    }
+    /**
+     * Create a market order via REST
+     */
+    async createMarketOrderRest(params) {
+        const payload = {
+            symbol: params.symbol,
+            side: params.side,
+            amount: params.amount,
+            reduce_only: params.reduce_only ?? false,
+            slippage_percent: params.slippage_percent ?? "0.5",
+            client_order_id: params.client_order_id ?? uuidv4()
+        };
+        return this.sendRestRequest('/orders/create_market', "create_market_order", payload);
+    }
+    /**
+     * Create a limit order via REST
+     */
+    async createLimitOrderRest(params) {
+        const payload = {
+            symbol: params.symbol,
+            side: params.side,
+            amount: params.amount,
+            price: params.price,
+            reduce_only: params.reduce_only ?? false,
+            client_order_id: params.client_order_id ?? uuidv4(),
+            tif: params.tif || "GTC"
+        };
+        return this.sendRestRequest('/orders/create', "create_order", payload);
+    }
+    /**
+     * Cancel an order via REST
+     */
+    async cancelOrderRest(params) {
+        const payload = {
+            symbol: params.symbol
+        };
+        if (params.order_id)
+            payload.order_id = params.order_id;
+        if (params.client_order_id)
+            payload.client_order_id = params.client_order_id;
+        return this.sendRestRequest('/orders/cancel', "cancel_order", payload);
+    }
+    /**
+     * Cancel all orders via REST
+     */
+    async cancelAllOrdersRest(params) {
+        const payload = {
+            all_symbols: params.all_symbols ?? true,
+            exclude_reduce_only: params.exclude_reduce_only ?? false
+        };
+        return this.sendRestRequest('/orders/cancel_all', "cancel_all_orders", payload);
+    }
+    /**
+     * List subaccounts via REST
+     */
+    async listSubaccounts() {
+        return this.sendRestRequest('/account/subaccount/list', "list_subaccounts", {});
+    }
+    // Public REST Methods
+    /**
+     * Get exchange information including all available markets
+     */
+    async getMarkets() {
+        const response = await this.axiosInstance.get('/info');
+        return response.data;
+    }
+    /**
+     * Get current prices for all markets
+     */
+    async getPrices() {
+        const response = await this.axiosInstance.get('/info/prices');
+        return response.data;
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+export declare const MAINNET_REST_URL = "https://api.pacifica.fi/api/v1";
+export declare const MAINNET_WS_URL = "wss://ws.pacifica.fi/ws";
+export declare const TESTNET_REST_URL = "https://test-api.pacifica.fi/api/v1";
+export declare const TESTNET_WS_URL = "wss://test-ws.pacifica.fi/ws";
+export declare const DEFAULT_EXPIRY_WINDOW = 5000;

package/dist/config.js

@@ -0,0 +1,5 @@
+export const MAINNET_REST_URL = "https://api.pacifica.fi/api/v1";
+export const MAINNET_WS_URL = "wss://ws.pacifica.fi/ws";
+export const TESTNET_REST_URL = "https://test-api.pacifica.fi/api/v1";
+export const TESTNET_WS_URL = "wss://test-ws.pacifica.fi/ws";
+export const DEFAULT_EXPIRY_WINDOW = 5000;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./config.js";
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./client.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./config.js";
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./client.js";

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export interface SignatureHeader {
+    timestamp: number;
+    expiry_window: number;
+    type: string;
+}
+export interface SignaturePayload {
+    [key: string]: any;
+}
+export interface RequestHeader {
+    account: string;
+    signature: string;
+    timestamp: number;
+    expiry_window: number;
+}
+export interface SignedRequest extends RequestHeader, SignaturePayload {
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+import { Keypair } from "@solana/web3.js";
+import { SignatureHeader, SignaturePayload } from "./types.js";
+/**
+ * Sorts object keys recursively to match Python's behavior
+ */
+export declare function sortJsonKeys(value: any): any;
+/**
+ * Prepares the message string for signing
+ */
+export declare function prepareMessage(header: SignatureHeader, payload: SignaturePayload): string;
+/**
+ * Signs the message using the provided keypair
+ */
+export declare function signMessage(header: SignatureHeader, payload: SignaturePayload, keypair: Keypair): {
+    message: string;
+    signature: string;
+};

package/dist/utils.js

@@ -0,0 +1,48 @@
+import bs58 from "bs58";
+import nacl from "tweetnacl";
+/**
+ * Sorts object keys recursively to match Python's behavior
+ */
+export function sortJsonKeys(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(sortJsonKeys);
+    }
+    if (typeof value === 'object') {
+        const sorted = {};
+        Object.keys(value)
+            .sort()
+            .forEach(key => {
+            sorted[key] = sortJsonKeys(value[key]);
+        });
+        return sorted;
+    }
+    return value;
+}
+/**
+ * Prepares the message string for signing
+ */
+export function prepareMessage(header, payload) {
+    const data = {
+        ...header,
+        data: payload
+    };
+    const sortedData = sortJsonKeys(data);
+    // JSON.stringify without arguments produces compact JSON (no spaces)
+    // which matches Python's separators=(",", ":")
+    return JSON.stringify(sortedData);
+}
+/**
+ * Signs the message using the provided keypair
+ */
+export function signMessage(header, payload, keypair) {
+    const message = prepareMessage(header, payload);
+    const messageBytes = new TextEncoder().encode(message);
+    const signatureBytes = nacl.sign.detached(messageBytes, keypair.secretKey);
+    return {
+        message,
+        signature: bs58.encode(signatureBytes)
+    };
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "pacifica-js-sdk",
+  "version": "1.0.0",
+  "description": "Official JavaScript/TypeScript SDK for Pacifica",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "pacifica",
+    "sdk",
+    "crypto",
+    "trading",
+    "solana",
+    "defi"
+  ],
+  "author": "Pacifica",
+  "license": "ISC",
+  "dependencies": {
+    "@solana/web3.js": "^1.98.4",
+    "axios": "^1.13.6",
+    "bs58": "^6.0.0",
+    "tweetnacl": "^1.0.3",
+    "uuid": "^13.0.0",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.18.1",
+    "dotenv": "^17.3.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}