bybit-p2p-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aadam Bala Idriss (ENGR ABI)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# bybit-p2p-sdk
+
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
+
+## Bybit P2P API SDK for Node.js (TypeScript)
+
+`bybit-p2p-sdk` is the unofficial Node.js SDK for Bybit's P2P API, enabling seamless integration of your software solutions with Bybit's [P2P trading platform](https://www.bybit.com/en/promo/global/p2p-introduce).
+
+- **Full Type Support**: Written in TypeScript with complete definitions.
+- **Easy Authentication**: Handles HMAC signature generation automatically.
+- **Actively Maintained**: Supports latest V5 P2P endpoints.
+
+## Features
+
+This SDK implements all key methods available for the P2P API:
+
+- Create, edit, delete, activate advertisements
+- Get pending orders, mark orders as paid, release assets
+- Get, send text messages, and upload files to chat
+- Get all public advertisements
+- And more!
+
+## Installation
+
+```bash
+npm install bybit-p2p-sdk
+```
+
+## Usage
+
+### TypeScript
+
+```typescript
+import { P2P } from 'bybit-p2p-sdk';
+
+const client = new P2P({
+    testnet: false, // Set to true for testnet
+    apiKey: "YOUR_API_KEY",
+    apiSecret: "YOUR_API_SECRET"
+});
+
+// 1. Get current balance
+const balance = await client.getCurrentBalance({ accountType: "FUND", coin: "USDT" });
+console.log(balance);
+
+// 2. Get pending orders
+const orders = await client.getPendingOrders({ page: 1, size: 10 });
+console.log(orders);
+```
+
+### Configuration
+The `P2P` constructor accepts the following config:
+
+- `testnet`: `boolean` (default: false)
+- `apiKey`: `string`
+- `apiSecret`: `string`
+- `recvWindow`: `number` (default: 20000) - Time window for request validity
+
+## Documentation
+
+This library provides a direct wrapper around Bybit's P2P REST API.
+Official Documentation: [P2P API Guide](https://bybit-exchange.github.io/docs/p2p/guide)
+
+### API Method Mapping
+
+Here is how the SDK methods map to the API endpoints:
+
+#### Advertisements
+| SDK Method | API Endpoint | Description |
+| --- | --- | --- |
+| `getOnlineAds()` | [/v5/p2p/item/online](https://bybit-exchange.github.io/docs/p2p/ad/online-ad-list) | Get public online ads |
+| `postNewAd()` | [/v5/p2p/item/create](https://bybit-exchange.github.io/docs/p2p/ad/post-new-ad) | Post a new ad |
+| `removeAd()` | [/v5/p2p/item/cancel](https://bybit-exchange.github.io/docs/p2p/ad/remove-ad) | Cancel an ad |
+| `updateAd()` | [/v5/p2p/item/update](https://bybit-exchange.github.io/docs/p2p/ad/update-list-ad) | Update or relist an ad |
+| `getAdsList()` | [/v5/p2p/item/personal/list](https://bybit-exchange.github.io/docs/p2p/ad/ad-list) | Get my ads list |
+| `getAdDetails()` | [/v5/p2p/item/info](https://bybit-exchange.github.io/docs/p2p/ad/ad-detail) | Get ad details |
+
+#### Orders
+| SDK Method | API Endpoint | Description |
+| --- | --- | --- |
+| `getOrders()` | [/v5/p2p/order/simplifyList](https://bybit-exchange.github.io/docs/p2p/order/order-list) | Get all orders |
+| `getOrderDetails()` | [/v5/p2p/order/info](https://bybit-exchange.github.io/docs/p2p/order/order-detail) | Get order details |
+| `getPendingOrders()` | [/v5/p2p/order/pending/simplifyList](https://bybit-exchange.github.io/docs/p2p/order/pending-order) | Get pending orders |
+| `markAsPaid()` | [/v5/p2p/order/pay](https://bybit-exchange.github.io/docs/p2p/order/mark-order-as-paid) | Mark order as paid |
+| `releaseAssets()` | [/v5/p2p/order/finish](https://bybit-exchange.github.io/docs/p2p/order/release-digital-asset) | Release crypto to buyer |
+| `sendChatMessage()` | [/v5/p2p/order/message/send](https://bybit-exchange.github.io/docs/p2p/order/send-chat-msg) | Send a chat message |
+| `uploadChatFile()` | [/v5/p2p/oss/upload_file](https://bybit-exchange.github.io/docs/p2p/order/upload-chat-file) | Upload a file to chat |
+| `getChatMessages()` | [/v5/p2p/order/message/listpage](https://bybit-exchange.github.io/docs/p2p/order/chat-msg) | Get chat history |
+
+#### User Info
+| SDK Method | API Endpoint | Description |
+| --- | --- | --- |
+| `getAccountInformation()` | [/v5/p2p/user/personal/info](https://bybit-exchange.github.io/docs/p2p/user/acct-info) | Get my account info |
+| `getCounterpartyInfo()` | [/v5/p2p/user/order/personal/info](https://bybit-exchange.github.io/docs/p2p/user/counterparty-user-info) | Get counterparty info |
+| `getUserPaymentTypes()` | [/v5/p2p/user/payment/list](https://bybit-exchange.github.io/docs/p2p/user/user-payment) | Get my payment methods |
+
+#### Misc
+| SDK Method | API Endpoint | Description |
+| --- | --- | --- |
+| `getCurrentBalance()` | [/v5/asset/transfer/query-account-coins-balance](https://bybit-exchange.github.io/docs/p2p/all-balance) | Get wallet balance |
+
+## Development
+
+Contributions are welcome!
+
+### Build
+```bash
+npm run build
+```
+
+### Run Examples
+```bash
+npx ts-node examples/quickstart.ts
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see our contributing guidelines:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+### Code Style
+
+- Follow TypeScript best practices
+- Use ESLint and Prettier (configured in project)
+- Write tests for new features
+- Update documentation as needed
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- **Issues**: [GitHub Issues](https://github.com/ENGR-ABI/bybit-p2p-sdk/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/ENGR-ABI/bybit-p2p-sdk/discussions)
+
+## 📞 Support
+
+For questions and support:
+- Check the [Documentation](#documentation) section
+- Open an [Issue](https://github.com/ENGR-ABI/bybit-p2p-sdk/issues)
+
+---
+
+**Built with ❤️ for traders by [ENGR-ABI](https://github.com/ENGR-ABI)**

package/dist/client.d.ts

@@ -0,0 +1,19 @@
+import { P2PConfig } from './types';
+import { P2PMethodDef } from './constants';
+export declare class P2PClient {
+    private testnet;
+    private apiKey;
+    private apiSecret;
+    private domain;
+    private tld;
+    private recvWindow;
+    private rsa;
+    private disableSslChecks;
+    private client;
+    private url;
+    constructor(config: P2PConfig);
+    private sign;
+    private sortParams;
+    request<T = any>(methodDef: P2PMethodDef, params?: any): Promise<T>;
+    private handleFileUpload;
+}

package/dist/client.js

@@ -0,0 +1,194 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.P2PClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const SUBDOMAIN_TESTNET = "api-testnet";
+const SUBDOMAIN_MAINNET = "api";
+const DOMAIN_MAIN = "bybit";
+const TLD_MAIN = "com";
+class P2PClient {
+    constructor(config) {
+        this.testnet = config.testnet || false;
+        this.apiKey = config.apiKey || "";
+        this.apiSecret = config.apiSecret || "";
+        this.domain = config.domain || DOMAIN_MAIN;
+        this.tld = config.tld || TLD_MAIN;
+        this.recvWindow = config.recvWindow || 20000;
+        this.rsa = config.rsa || false;
+        this.disableSslChecks = config.disableSslChecks || false;
+        const subdomain = this.testnet ? SUBDOMAIN_TESTNET : SUBDOMAIN_MAINNET;
+        this.url = `https://${subdomain}.${this.domain}.${this.tld}`;
+        this.client = axios_1.default.create({
+            validateStatus: () => true, // Handle all statuses manually
+            httpsAgent: this.disableSslChecks ? new (require('https').Agent)({ rejectUnauthorized: false }) : undefined
+        });
+    }
+    sign(payload, timestamp) {
+        const signString = typeof payload === 'string'
+            ? `${timestamp}${this.apiKey}${this.recvWindow}${payload}`
+            : Buffer.concat([Buffer.from(`${timestamp}${this.apiKey}${this.recvWindow}`), payload]);
+        if (this.rsa) {
+            const signer = crypto.createSign('SHA256');
+            signer.update(signString);
+            return signer.sign(this.apiSecret, 'base64');
+        }
+        else {
+            return crypto.createHmac('sha256', this.apiSecret).update(signString).digest('hex');
+        }
+    }
+    sortParams(params) {
+        const keys = Object.keys(params).sort();
+        return keys.map(key => `${key}=${params[key]}`).join('&');
+    }
+    // Helper to cast values to strings/ints recursively primarily for POST JSON
+    // Mirroring Python's _cast_values logic effectively happens by JSON.stringify
+    // But Python explicitly converts some to strings.
+    // In JS, JSON.stringify handles types well, but if the API expects strings for numbers, we might need to be careful.
+    // For now, we rely on the user passing correct types or simple JSON serialization.
+    async request(methodDef, params = {}) {
+        // Validate required params
+        for (const req of methodDef.requiredParams) {
+            if (!(req in params)) {
+                throw new Error(`Missing required parameter: ${req}`);
+            }
+        }
+        const timestamp = Date.now();
+        let payload = "";
+        let signature = "";
+        let contentType = "application/json";
+        let headers = {};
+        let requestUrl = this.url + methodDef.url;
+        let axiosConfig = {
+            method: methodDef.method === 'FILE' ? 'POST' : methodDef.method,
+            url: requestUrl,
+            headers: {}
+        };
+        if (methodDef.method === 'FILE') {
+            return this.handleFileUpload(methodDef, params, timestamp);
+        }
+        else if (methodDef.method === 'GET') {
+            const cleanParams = Object.entries(params)
+                .filter(([_, v]) => v != null)
+                .reduce((acc, [k, v]) => ({ ...acc, [k]: v }), {});
+            payload = this.sortParams(cleanParams);
+            signature = this.sign(payload, timestamp);
+            if (payload) {
+                axiosConfig.url += `?${payload}`;
+            }
+        }
+        else {
+            // POST
+            payload = JSON.stringify(params);
+            signature = this.sign(payload, timestamp);
+            axiosConfig.data = payload;
+        }
+        headers = {
+            'X-BAPI-API-KEY': this.apiKey,
+            'X-BAPI-SIGN': signature,
+            'X-BAPI-SIGN-TYPE': '2',
+            'X-BAPI-TIMESTAMP': timestamp.toString(),
+            'X-BAPI-RECV-WINDOW': this.recvWindow.toString(),
+            'Content-Type': contentType
+        };
+        axiosConfig.headers = { ...axiosConfig.headers, ...headers };
+        const response = await this.client.request(axiosConfig);
+        // Process response
+        if (response.status !== 200) {
+            // Basic error handling
+            throw new Error(`Request failed with status ${response.status}: ${JSON.stringify(response.data)}`);
+        }
+        const result = response.data;
+        const retCode = result.retCode !== undefined ? result.retCode : result.ret_code;
+        const retMsg = result.retMsg || result.ret_msg;
+        if (retCode !== 0) {
+            throw new Error(`${retMsg} (ErrCode: ${retCode})`);
+        }
+        return result;
+    }
+    async handleFileUpload(methodDef, params, timestamp) {
+        const uploadFile = params.upload_file;
+        let filename = params.filename;
+        let fileData;
+        if (Buffer.isBuffer(uploadFile)) {
+            if (!filename)
+                throw new Error("filename is required when passing raw buffer");
+            fileData = uploadFile;
+        }
+        else if (typeof uploadFile === 'string') {
+            if (!fs.existsSync(uploadFile))
+                throw new Error(`File not found: ${uploadFile}`);
+            fileData = fs.readFileSync(uploadFile);
+            if (!filename)
+                filename = path.basename(uploadFile);
+        }
+        else {
+            throw new Error("Invalid upload_file type. Must be string path or Buffer.");
+        }
+        const boundary = "boundary-for-file";
+        const mimeType = "image/png"; // Python SDK hardcodes this
+        // Manual payload construction to match signature
+        // Python: f"--{boundary}\r\nContent-Disposition: form-data; name=\"upload_file\"; filename=\"{filename}\"\r\nContent-Type: {mime_type}\r\n\r\n".encode() + data + f"\r\n--{boundary}--\r\n".encode()
+        const part1 = Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="upload_file"; filename="${filename}"\r\nContent-Type: ${mimeType}\r\n\r\n`);
+        const part2 = fileData;
+        const part3 = Buffer.from(`\r\n--${boundary}--\r\n`);
+        const payloadBuffer = Buffer.concat([part1, part2, part3]);
+        const signature = this.sign(payloadBuffer, timestamp);
+        const headers = {
+            'X-BAPI-API-KEY': this.apiKey,
+            'X-BAPI-SIGN': signature,
+            'X-BAPI-SIGN-TYPE': '2',
+            'X-BAPI-TIMESTAMP': timestamp.toString(),
+            'X-BAPI-RECV-WINDOW': this.recvWindow.toString(),
+            'Content-Type': `multipart/form-data; boundary=${boundary}`
+        };
+        const response = await this.client.post(this.url + methodDef.url, payloadBuffer, { headers });
+        if (response.status !== 200) {
+            throw new Error(`Request failed with status ${response.status}: ${JSON.stringify(response.data)}`);
+        }
+        const result = response.data;
+        if (result.retCode !== 0) {
+            throw new Error(`${result.retMsg} (ErrCode: ${result.retCode})`);
+        }
+        return result;
+    }
+}
+exports.P2PClient = P2PClient;

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+export interface P2PMethodDef {
+    url: string;
+    method: 'GET' | 'POST' | 'FILE';
+    requiredParams: string[];
+}
+export declare const P2PMethods: Record<string, P2PMethodDef>;

package/dist/constants.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.P2PMethods = void 0;
+exports.P2PMethods = {
+    GET_CURRENT_BALANCE: { url: "/v5/asset/transfer/query-account-coins-balance", method: "GET", requiredParams: ["accountType"] },
+    GET_ACCOUNT_INFORMATION: { url: "/v5/p2p/user/personal/info", method: "POST", requiredParams: [] },
+    GET_ADS_LIST: { url: "/v5/p2p/item/personal/list", method: "POST", requiredParams: [] },
+    GET_AD_DETAILS: { url: "/v5/p2p/item/info", method: "POST", requiredParams: ["itemId"] },
+    UPDATE_AD: {
+        url: "/v5/p2p/item/update", method: "POST", requiredParams: [
+            "id", "priceType", "premium", "price", "minAmount", "maxAmount", "remark",
+            "tradingPreferenceSet", "paymentIds", "actionType", "quantity", "paymentPeriod"
+        ]
+    },
+    REMOVE_AD: { url: "/v5/p2p/item/cancel", method: "POST", requiredParams: ["itemId"] },
+    GET_ORDERS: { url: "/v5/p2p/order/simplifyList", method: "POST", requiredParams: ["page", "size"] },
+    GET_PENDING_ORDERS: { url: "/v5/p2p/order/pending/simplifyList", method: "POST", requiredParams: ["page", "size"] },
+    GET_COUNTERPARTY_INFO: { url: "/v5/p2p/user/order/personal/info", method: "POST", requiredParams: ["originalUid", "orderId"] },
+    GET_ORDER_DETAILS: { url: "/v5/p2p/order/info", method: "POST", requiredParams: ["orderId"] },
+    RELEASE_ASSETS: { url: "/v5/p2p/order/finish", method: "POST", requiredParams: ["orderId"] },
+    MARK_AS_PAID: { url: "/v5/p2p/order/pay", method: "POST", requiredParams: ["orderId", "paymentType", "paymentId"] },
+    GET_CHAT_MESSAGES: { url: "/v5/p2p/order/message/listpage", method: "POST", requiredParams: ["orderId", "size"] },
+    UPLOAD_CHAT_FILE: { url: "/v5/p2p/oss/upload_file", method: "FILE", requiredParams: ["upload_file"] },
+    SEND_CHAT_MESSAGE: { url: "/v5/p2p/order/message/send", method: "POST", requiredParams: ["message", "contentType", "orderId"] },
+    POST_NEW_AD: {
+        url: "/v5/p2p/item/create", method: "POST", requiredParams: [
+            "tokenId", "currencyId", "side", "priceType", "premium", "price", "minAmount",
+            "maxAmount", "remark", "tradingPreferenceSet", "paymentIds", "quantity",
+            "paymentPeriod", "itemType"
+        ]
+    },
+    GET_ONLINE_ADS: { url: "/v5/p2p/item/online", method: "POST", requiredParams: ["tokenId", "currencyId", "side"] },
+    GET_USER_PAYMENT_TYPES: { url: "/v5/p2p/user/payment/list", method: "POST", requiredParams: [] }
+};

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+import { P2PClient } from './client';
+import * as types from './types';
+export * from './types';
+export * from './client';
+export * from './constants';
+export declare class P2P extends P2PClient {
+    /**
+     * Obtain wallet balance, query asset information of each currency.
+     * By default, currency information with assets or liabilities of 0 is not returned.
+     */
+    getCurrentBalance(params: {
+        accountType: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Get Account Information
+     */
+    getAccountInformation(): Promise<types.P2PResponse>;
+    /**
+     * Get Ads List
+     */
+    getAdsList(params?: types.GetAdsListParams): Promise<types.P2PResponse>;
+    /**
+     * Get Ad Details
+     */
+    getAdDetails(params: {
+        itemId: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Update or activate ads
+     */
+    updateAd(params: types.UpdateAdParams): Promise<types.P2PResponse>;
+    /**
+     * Remove ad
+     */
+    removeAd(params: {
+        itemId: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Get orders
+     */
+    getOrders(params?: types.GetOrdersParams): Promise<types.P2PResponse>;
+    /**
+     * Get pending orders
+     */
+    getPendingOrders(params?: types.GetOrdersParams): Promise<types.P2PResponse>;
+    /**
+     * Get counterparty info
+     */
+    getCounterpartyInfo(params: {
+        originalUid: string;
+        orderId: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Get order details
+     */
+    getOrderDetails(params: {
+        orderId: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Release digital asset
+     */
+    releaseAssets(params: {
+        orderId: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Mark order as paid
+     */
+    markAsPaid(params: {
+        orderId: string;
+        paymentType: string;
+        paymentId: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Get chat messages
+     */
+    getChatMessages(params: {
+        orderId: string;
+        size?: number;
+        startMessageId?: number;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Upload file for chats
+     */
+    uploadChatFile(params: types.UploadChatFileParams): Promise<types.P2PResponse>;
+    /**
+     * Send chat message
+     */
+    sendChatMessage(params: {
+        message: string;
+        contentType: string;
+        orderId: string;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Post new advertisement
+     */
+    postNewAd(params: types.PostNewAdParams): Promise<types.P2PResponse>;
+    /**
+     * Get online advertisements list
+     */
+    getOnlineAds(params: {
+        tokenId: string;
+        currencyId: string;
+        side: string | number;
+        [key: string]: any;
+    }): Promise<types.P2PResponse>;
+    /**
+     * Get user payment types
+     */
+    getUserPaymentTypes(): Promise<types.P2PResponse>;
+}

package/dist/index.js

@@ -0,0 +1,134 @@
+"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 });
+exports.P2P = void 0;
+const client_1 = require("./client");
+const constants_1 = require("./constants");
+__exportStar(require("./types"), exports);
+__exportStar(require("./client"), exports);
+__exportStar(require("./constants"), exports);
+class P2P extends client_1.P2PClient {
+    /**
+     * Obtain wallet balance, query asset information of each currency.
+     * By default, currency information with assets or liabilities of 0 is not returned.
+     */
+    async getCurrentBalance(params) {
+        return this.request(constants_1.P2PMethods.GET_CURRENT_BALANCE, params);
+    }
+    /**
+     * Get Account Information
+     */
+    async getAccountInformation() {
+        return this.request(constants_1.P2PMethods.GET_ACCOUNT_INFORMATION, {});
+    }
+    /**
+     * Get Ads List
+     */
+    async getAdsList(params = {}) {
+        return this.request(constants_1.P2PMethods.GET_ADS_LIST, params);
+    }
+    /**
+     * Get Ad Details
+     */
+    async getAdDetails(params) {
+        return this.request(constants_1.P2PMethods.GET_AD_DETAILS, params);
+    }
+    /**
+     * Update or activate ads
+     */
+    async updateAd(params) {
+        return this.request(constants_1.P2PMethods.UPDATE_AD, params);
+    }
+    /**
+     * Remove ad
+     */
+    async removeAd(params) {
+        return this.request(constants_1.P2PMethods.REMOVE_AD, params);
+    }
+    /**
+     * Get orders
+     */
+    async getOrders(params = {}) {
+        return this.request(constants_1.P2PMethods.GET_ORDERS, params);
+    }
+    /**
+     * Get pending orders
+     */
+    async getPendingOrders(params = {}) {
+        return this.request(constants_1.P2PMethods.GET_PENDING_ORDERS, params);
+    }
+    /**
+     * Get counterparty info
+     */
+    async getCounterpartyInfo(params) {
+        return this.request(constants_1.P2PMethods.GET_COUNTERPARTY_INFO, params);
+    }
+    /**
+     * Get order details
+     */
+    async getOrderDetails(params) {
+        return this.request(constants_1.P2PMethods.GET_ORDER_DETAILS, params);
+    }
+    /**
+     * Release digital asset
+     */
+    async releaseAssets(params) {
+        return this.request(constants_1.P2PMethods.RELEASE_ASSETS, params);
+    }
+    /**
+     * Mark order as paid
+     */
+    async markAsPaid(params) {
+        return this.request(constants_1.P2PMethods.MARK_AS_PAID, params);
+    }
+    /**
+     * Get chat messages
+     */
+    async getChatMessages(params) {
+        return this.request(constants_1.P2PMethods.GET_CHAT_MESSAGES, params);
+    }
+    /**
+     * Upload file for chats
+     */
+    async uploadChatFile(params) {
+        return this.request(constants_1.P2PMethods.UPLOAD_CHAT_FILE, params);
+    }
+    /**
+     * Send chat message
+     */
+    async sendChatMessage(params) {
+        return this.request(constants_1.P2PMethods.SEND_CHAT_MESSAGE, params);
+    }
+    /**
+     * Post new advertisement
+     */
+    async postNewAd(params) {
+        return this.request(constants_1.P2PMethods.POST_NEW_AD, params);
+    }
+    /**
+     * Get online advertisements list
+     */
+    async getOnlineAds(params) {
+        return this.request(constants_1.P2PMethods.GET_ONLINE_ADS, params);
+    }
+    /**
+     * Get user payment types
+     */
+    async getUserPaymentTypes() {
+        return this.request(constants_1.P2PMethods.GET_USER_PAYMENT_TYPES, {});
+    }
+}
+exports.P2P = P2P;

package/dist/types.d.ts

@@ -0,0 +1,122 @@
+export interface P2PConfig {
+    /**
+     * API Key
+     */
+    apiKey?: string;
+    /**
+     * API Secret
+     */
+    apiSecret?: string;
+    /**
+     * Whether to use Testnet (default: false)
+     */
+    testnet?: boolean;
+    /**
+     * Custom domain (default: bybit)
+     */
+    domain?: string;
+    /**
+     * Custom TLD (default: com)
+     */
+    tld?: string;
+    /**
+     * Receive window in ms (default: 5000)
+     */
+    recvWindow?: number;
+    /**
+     * Use RSA authentication (default: false)
+     */
+    rsa?: boolean;
+    /**
+     * Disable SSL verification (default: false) - Not recommended
+     */
+    disableSslChecks?: boolean;
+    /**
+     * Logging level (not fully implemented in this node version, serves as placeholder)
+     */
+    loggingLevel?: any;
+}
+export interface P2PResponse<T = any> {
+    retCode?: number;
+    ret_code?: number;
+    retMsg?: string;
+    ret_msg?: string;
+    result: T;
+    retExtInfo?: any;
+    ext_code?: string;
+    ext_info?: any;
+    time?: number;
+    time_now?: string;
+}
+export interface GetAdsListParams {
+    itemId?: string;
+    status?: string | number;
+    side?: string | number;
+    tokenId?: string;
+    page?: number;
+    size?: number;
+    currencyId?: string;
+    [key: string]: any;
+}
+export interface UpdateAdParams {
+    id: string;
+    priceType?: number;
+    premium?: number | string;
+    price?: number | string;
+    minAmount?: number | string;
+    maxAmount?: number | string;
+    remark?: string;
+    tradingPreferenceSet?: TradingPreferenceSet;
+    paymentIds?: string[];
+    actionType?: 'MODIFY' | 'ACTIVE';
+    quantity?: string;
+    paymentPeriod?: string | number;
+    [key: string]: any;
+}
+export interface TradingPreferenceSet {
+    hasUnPostAd?: number;
+    isKyc?: number;
+    isEmail?: number;
+    isMobile?: number;
+    hasRegisterTime?: number;
+    registerTimeThreshold?: number;
+    orderFinishNumberDay30?: number;
+    completeRateDay30?: string;
+    nationalLimit?: string;
+    hasOrderFinishNumberDay30?: number;
+    hasCompleteRateDay30?: number;
+    hasNationalLimit?: number;
+    [key: string]: any;
+}
+export interface PostNewAdParams {
+    tokenId: string;
+    currencyId: string;
+    side: string | number;
+    priceType: number;
+    premium?: number | string;
+    price?: number | string;
+    minAmount?: number | string;
+    maxAmount?: number | string;
+    remark?: string;
+    tradingPreferenceSet?: TradingPreferenceSet;
+    paymentIds?: string[];
+    quantity?: string;
+    paymentPeriod?: string | number;
+    itemType?: 'ORIGIN' | 'BULK';
+    [key: string]: any;
+}
+export interface GetOrdersParams {
+    status?: string;
+    beginTime?: string | number;
+    endTime?: string | number;
+    tokenId?: string;
+    side?: number[];
+    page?: number;
+    size?: number;
+    [key: string]: any;
+}
+export interface UploadChatFileParams {
+    upload_file: string | Buffer;
+    filename?: string;
+    [key: string]: any;
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// ... Add more generalized interfaces as needed or use `any` for less common methods
+// to keep the initial conversion manageable but extensible.

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "bybit-p2p-sdk",
+  "version": "1.0.0",
+  "description": "Bybit P2P Node.js SDK (TypeScript)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "bybit",
+    "p2p",
+    "sdk",
+    "crypto",
+    "exchange",
+    "typescript",
+    "nodejs",
+    "api"
+  ],
+  "homepage": "https://github.com/ENGR-ABI/bybit-p2p-sdk",
+  "bugs": {
+    "url": "https://github.com/ENGR-ABI/bybit-p2p-sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ENGR-ABI/bybit-p2p-sdk.git"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "author": "Aadam Bala Idriss (ENGR ABI)",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "form-data": "^4.0.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/uuid": "^9.0.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,190 @@
+import axios, { AxiosInstance, AxiosRequestConfig, Method } from 'axios';
+import * as crypto from 'crypto';
+import * as FormData from 'form-data';
+import * as fs from 'fs';
+import * as path from 'path';
+import { P2PConfig, P2PResponse } from './types';
+import { P2PMethodDef } from './constants';
+
+const SUBDOMAIN_TESTNET = "api-testnet";
+const SUBDOMAIN_MAINNET = "api";
+const DOMAIN_MAIN = "bybit";
+const TLD_MAIN = "com";
+
+export class P2PClient {
+    private testnet: boolean;
+    private apiKey: string;
+    private apiSecret: string;
+    private domain: string;
+    private tld: string;
+    private recvWindow: number;
+    private rsa: boolean;
+    private disableSslChecks: boolean;
+    private client: AxiosInstance;
+    private url: string;
+
+    constructor(config: P2PConfig) {
+        this.testnet = config.testnet || false;
+        this.apiKey = config.apiKey || "";
+        this.apiSecret = config.apiSecret || "";
+        this.domain = config.domain || DOMAIN_MAIN;
+        this.tld = config.tld || TLD_MAIN;
+        this.recvWindow = config.recvWindow || 20000;
+        this.rsa = config.rsa || false;
+        this.disableSslChecks = config.disableSslChecks || false;
+
+        const subdomain = this.testnet ? SUBDOMAIN_TESTNET : SUBDOMAIN_MAINNET;
+        this.url = `https://${subdomain}.${this.domain}.${this.tld}`;
+
+        this.client = axios.create({
+            validateStatus: () => true, // Handle all statuses manually
+            httpsAgent: this.disableSslChecks ? new (require('https').Agent)({ rejectUnauthorized: false }) : undefined
+        });
+    }
+
+    private sign(payload: string | Buffer, timestamp: number): string {
+        const signString = typeof payload === 'string'
+            ? `${timestamp}${this.apiKey}${this.recvWindow}${payload}`
+            : Buffer.concat([Buffer.from(`${timestamp}${this.apiKey}${this.recvWindow}`), payload]);
+
+        if (this.rsa) {
+            const signer = crypto.createSign('SHA256');
+            signer.update(signString);
+            return signer.sign(this.apiSecret, 'base64');
+        } else {
+            return crypto.createHmac('sha256', this.apiSecret).update(signString).digest('hex');
+        }
+    }
+
+    private sortParams(params: any): string {
+        const keys = Object.keys(params).sort();
+        return keys.map(key => `${key}=${params[key]}`).join('&');
+    }
+
+    // Helper to cast values to strings/ints recursively primarily for POST JSON
+    // Mirroring Python's _cast_values logic effectively happens by JSON.stringify
+    // But Python explicitly converts some to strings.
+    // In JS, JSON.stringify handles types well, but if the API expects strings for numbers, we might need to be careful.
+    // For now, we rely on the user passing correct types or simple JSON serialization.
+
+    async request<T = any>(methodDef: P2PMethodDef, params: any = {}): Promise<T> {
+        // Validate required params
+        for (const req of methodDef.requiredParams) {
+            if (!(req in params)) {
+                throw new Error(`Missing required parameter: ${req}`);
+            }
+        }
+
+        const timestamp = Date.now();
+        let payload = "";
+        let signature = "";
+        let contentType = "application/json";
+        let headers: any = {};
+        let requestUrl = this.url + methodDef.url;
+        let axiosConfig: AxiosRequestConfig = {
+            method: methodDef.method === 'FILE' ? 'POST' : methodDef.method as Method,
+            url: requestUrl,
+            headers: {}
+        };
+
+        if (methodDef.method === 'FILE') {
+            return this.handleFileUpload(methodDef, params, timestamp);
+        } else if (methodDef.method === 'GET') {
+            const cleanParams = Object.entries(params)
+                .filter(([_, v]) => v != null)
+                .reduce((acc, [k, v]) => ({ ...acc, [k]: v }), {});
+            payload = this.sortParams(cleanParams);
+            signature = this.sign(payload, timestamp);
+            if (payload) {
+                axiosConfig.url += `?${payload}`;
+            }
+        } else {
+            // POST
+            payload = JSON.stringify(params);
+            signature = this.sign(payload, timestamp);
+            axiosConfig.data = payload;
+        }
+
+        headers = {
+            'X-BAPI-API-KEY': this.apiKey,
+            'X-BAPI-SIGN': signature,
+            'X-BAPI-SIGN-TYPE': '2',
+            'X-BAPI-TIMESTAMP': timestamp.toString(),
+            'X-BAPI-RECV-WINDOW': this.recvWindow.toString(),
+            'Content-Type': contentType
+        };
+
+        axiosConfig.headers = { ...axiosConfig.headers, ...headers };
+
+        const response = await this.client.request(axiosConfig);
+
+        // Process response
+        if (response.status !== 200) {
+            // Basic error handling
+            throw new Error(`Request failed with status ${response.status}: ${JSON.stringify(response.data)}`);
+        }
+
+        const result = response.data;
+
+        const retCode = result.retCode !== undefined ? result.retCode : result.ret_code;
+        const retMsg = result.retMsg || result.ret_msg;
+
+        if (retCode !== 0) {
+            throw new Error(`${retMsg} (ErrCode: ${retCode})`);
+        }
+
+        return result;
+    }
+
+    private async handleFileUpload<T>(methodDef: P2PMethodDef, params: any, timestamp: number): Promise<T> {
+        const uploadFile = params.upload_file;
+        let filename = params.filename;
+        let fileData: Buffer;
+
+        if (Buffer.isBuffer(uploadFile)) {
+            if (!filename) throw new Error("filename is required when passing raw buffer");
+            fileData = uploadFile;
+        } else if (typeof uploadFile === 'string') {
+            if (!fs.existsSync(uploadFile)) throw new Error(`File not found: ${uploadFile}`);
+            fileData = fs.readFileSync(uploadFile);
+            if (!filename) filename = path.basename(uploadFile);
+        } else {
+            throw new Error("Invalid upload_file type. Must be string path or Buffer.");
+        }
+
+        const boundary = "boundary-for-file";
+        const mimeType = "image/png"; // Python SDK hardcodes this
+
+        // Manual payload construction to match signature
+        // Python: f"--{boundary}\r\nContent-Disposition: form-data; name=\"upload_file\"; filename=\"{filename}\"\r\nContent-Type: {mime_type}\r\n\r\n".encode() + data + f"\r\n--{boundary}--\r\n".encode()
+
+        const part1 = Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="upload_file"; filename="${filename}"\r\nContent-Type: ${mimeType}\r\n\r\n`);
+        const part2 = fileData;
+        const part3 = Buffer.from(`\r\n--${boundary}--\r\n`);
+
+        const payloadBuffer = Buffer.concat([part1, part2, part3]);
+
+        const signature = this.sign(payloadBuffer, timestamp);
+
+        const headers = {
+            'X-BAPI-API-KEY': this.apiKey,
+            'X-BAPI-SIGN': signature,
+            'X-BAPI-SIGN-TYPE': '2',
+            'X-BAPI-TIMESTAMP': timestamp.toString(),
+            'X-BAPI-RECV-WINDOW': this.recvWindow.toString(),
+            'Content-Type': `multipart/form-data; boundary=${boundary}`
+        };
+
+        const response = await this.client.post(this.url + methodDef.url, payloadBuffer, { headers });
+
+        if (response.status !== 200) {
+            throw new Error(`Request failed with status ${response.status}: ${JSON.stringify(response.data)}`);
+        }
+
+        const result = response.data;
+        if (result.retCode !== 0) {
+            throw new Error(`${result.retMsg} (ErrCode: ${result.retCode})`);
+        }
+        return result;
+    }
+}

package/src/constants.ts

@@ -0,0 +1,37 @@
+export interface P2PMethodDef {
+    url: string;
+    method: 'GET' | 'POST' | 'FILE';
+    requiredParams: string[];
+}
+
+export const P2PMethods: Record<string, P2PMethodDef> = {
+    GET_CURRENT_BALANCE: { url: "/v5/asset/transfer/query-account-coins-balance", method: "GET", requiredParams: ["accountType"] },
+    GET_ACCOUNT_INFORMATION: { url: "/v5/p2p/user/personal/info", method: "POST", requiredParams: [] },
+    GET_ADS_LIST: { url: "/v5/p2p/item/personal/list", method: "POST", requiredParams: [] },
+    GET_AD_DETAILS: { url: "/v5/p2p/item/info", method: "POST", requiredParams: ["itemId"] },
+    UPDATE_AD: {
+        url: "/v5/p2p/item/update", method: "POST", requiredParams: [
+            "id", "priceType", "premium", "price", "minAmount", "maxAmount", "remark",
+            "tradingPreferenceSet", "paymentIds", "actionType", "quantity", "paymentPeriod"
+        ]
+    },
+    REMOVE_AD: { url: "/v5/p2p/item/cancel", method: "POST", requiredParams: ["itemId"] },
+    GET_ORDERS: { url: "/v5/p2p/order/simplifyList", method: "POST", requiredParams: ["page", "size"] },
+    GET_PENDING_ORDERS: { url: "/v5/p2p/order/pending/simplifyList", method: "POST", requiredParams: ["page", "size"] },
+    GET_COUNTERPARTY_INFO: { url: "/v5/p2p/user/order/personal/info", method: "POST", requiredParams: ["originalUid", "orderId"] },
+    GET_ORDER_DETAILS: { url: "/v5/p2p/order/info", method: "POST", requiredParams: ["orderId"] },
+    RELEASE_ASSETS: { url: "/v5/p2p/order/finish", method: "POST", requiredParams: ["orderId"] },
+    MARK_AS_PAID: { url: "/v5/p2p/order/pay", method: "POST", requiredParams: ["orderId", "paymentType", "paymentId"] },
+    GET_CHAT_MESSAGES: { url: "/v5/p2p/order/message/listpage", method: "POST", requiredParams: ["orderId", "size"] },
+    UPLOAD_CHAT_FILE: { url: "/v5/p2p/oss/upload_file", method: "FILE", requiredParams: ["upload_file"] },
+    SEND_CHAT_MESSAGE: { url: "/v5/p2p/order/message/send", method: "POST", requiredParams: ["message", "contentType", "orderId"] },
+    POST_NEW_AD: {
+        url: "/v5/p2p/item/create", method: "POST", requiredParams: [
+            "tokenId", "currencyId", "side", "priceType", "premium", "price", "minAmount",
+            "maxAmount", "remark", "tradingPreferenceSet", "paymentIds", "quantity",
+            "paymentPeriod", "itemType"
+        ]
+    },
+    GET_ONLINE_ADS: { url: "/v5/p2p/item/online", method: "POST", requiredParams: ["tokenId", "currencyId", "side"] },
+    GET_USER_PAYMENT_TYPES: { url: "/v5/p2p/user/payment/list", method: "POST", requiredParams: [] }
+};

package/src/index.ts

@@ -0,0 +1,136 @@
+import { P2PClient } from './client';
+import { P2PMethods } from './constants';
+import * as types from './types';
+
+export * from './types';
+export * from './client';
+export * from './constants';
+
+export class P2P extends P2PClient {
+    /**
+     * Obtain wallet balance, query asset information of each currency.
+     * By default, currency information with assets or liabilities of 0 is not returned.
+     */
+    async getCurrentBalance(params: { accountType: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_CURRENT_BALANCE, params);
+    }
+
+    /**
+     * Get Account Information
+     */
+    async getAccountInformation(): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_ACCOUNT_INFORMATION, {});
+    }
+
+    /**
+     * Get Ads List
+     */
+    async getAdsList(params: types.GetAdsListParams = {}): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_ADS_LIST, params);
+    }
+
+    /**
+     * Get Ad Details
+     */
+    async getAdDetails(params: { itemId: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_AD_DETAILS, params);
+    }
+
+    /**
+     * Update or activate ads
+     */
+    async updateAd(params: types.UpdateAdParams): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.UPDATE_AD, params);
+    }
+
+    /**
+     * Remove ad
+     */
+    async removeAd(params: { itemId: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.REMOVE_AD, params);
+    }
+
+    /**
+     * Get orders
+     */
+    async getOrders(params: types.GetOrdersParams = {}): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_ORDERS, params);
+    }
+
+    /**
+     * Get pending orders
+     */
+    async getPendingOrders(params: types.GetOrdersParams = {}): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_PENDING_ORDERS, params);
+    }
+
+    /**
+     * Get counterparty info
+     */
+    async getCounterpartyInfo(params: { originalUid: string; orderId: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_COUNTERPARTY_INFO, params);
+    }
+
+    /**
+     * Get order details
+     */
+    async getOrderDetails(params: { orderId: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_ORDER_DETAILS, params);
+    }
+
+    /**
+     * Release digital asset
+     */
+    async releaseAssets(params: { orderId: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.RELEASE_ASSETS, params);
+    }
+
+    /**
+     * Mark order as paid
+     */
+    async markAsPaid(params: { orderId: string; paymentType: string; paymentId: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.MARK_AS_PAID, params);
+    }
+
+    /**
+     * Get chat messages
+     */
+    async getChatMessages(params: { orderId: string; size?: number; startMessageId?: number;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_CHAT_MESSAGES, params);
+    }
+
+    /**
+     * Upload file for chats
+     */
+    async uploadChatFile(params: types.UploadChatFileParams): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.UPLOAD_CHAT_FILE, params);
+    }
+
+    /**
+     * Send chat message
+     */
+    async sendChatMessage(params: { message: string; contentType: string; orderId: string;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.SEND_CHAT_MESSAGE, params);
+    }
+
+    /**
+     * Post new advertisement
+     */
+    async postNewAd(params: types.PostNewAdParams): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.POST_NEW_AD, params);
+    }
+
+    /**
+     * Get online advertisements list
+     */
+    async getOnlineAds(params: { tokenId: string; currencyId: string; side: string | number;[key: string]: any }): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_ONLINE_ADS, params);
+    }
+
+    /**
+     * Get user payment types
+     */
+    async getUserPaymentTypes(): Promise<types.P2PResponse> {
+        return this.request(P2PMethods.GET_USER_PAYMENT_TYPES, {});
+    }
+}

package/src/types.ts

@@ -0,0 +1,134 @@
+export interface P2PConfig {
+    /**
+     * API Key
+     */
+    apiKey?: string;
+    /**
+     * API Secret
+     */
+    apiSecret?: string;
+    /**
+     * Whether to use Testnet (default: false)
+     */
+    testnet?: boolean;
+    /**
+     * Custom domain (default: bybit)
+     */
+    domain?: string;
+    /**
+     * Custom TLD (default: com)
+     */
+    tld?: string;
+    /**
+     * Receive window in ms (default: 5000)
+     */
+    recvWindow?: number;
+    /**
+     * Use RSA authentication (default: false)
+     */
+    rsa?: boolean;
+    /**
+     * Disable SSL verification (default: false) - Not recommended
+     */
+    disableSslChecks?: boolean;
+    /**
+     * Logging level (not fully implemented in this node version, serves as placeholder)
+     */
+    loggingLevel?: any;
+}
+
+export interface P2PResponse<T = any> {
+    retCode?: number;
+    ret_code?: number;
+    retMsg?: string;
+    ret_msg?: string;
+    result: T;
+    retExtInfo?: any;
+    ext_code?: string;
+    ext_info?: any;
+    time?: number;
+    time_now?: string;
+}
+
+// Method Parameter Interfaces
+
+export interface GetAdsListParams {
+    itemId?: string;
+    status?: string | number; // 1 - Sold out, 2 - Available
+    side?: string | number; // 0 - Buy, 1 - Sell
+    tokenId?: string;
+    page?: number;
+    size?: number;
+    currencyId?: string;
+    [key: string]: any;
+}
+
+export interface UpdateAdParams {
+    id: string; // Advertisement ID
+    priceType?: number; // 0 - fixed, 1 - floating
+    premium?: number | string;
+    price?: number | string;
+    minAmount?: number | string;
+    maxAmount?: number | string;
+    remark?: string;
+    tradingPreferenceSet?: TradingPreferenceSet;
+    paymentIds?: string[];
+    actionType?: 'MODIFY' | 'ACTIVE';
+    quantity?: string;
+    paymentPeriod?: string | number;
+    [key: string]: any;
+}
+
+export interface TradingPreferenceSet {
+    hasUnPostAd?: number;
+    isKyc?: number;
+    isEmail?: number;
+    isMobile?: number;
+    hasRegisterTime?: number;
+    registerTimeThreshold?: number;
+    orderFinishNumberDay30?: number;
+    completeRateDay30?: string;
+    nationalLimit?: string;
+    hasOrderFinishNumberDay30?: number;
+    hasCompleteRateDay30?: number;
+    hasNationalLimit?: number;
+    [key: string]: any;
+}
+
+export interface PostNewAdParams {
+    tokenId: string;
+    currencyId: string;
+    side: string | number; // 0 - Buy, 1 - Sell
+    priceType: number;
+    premium?: number | string;
+    price?: number | string;
+    minAmount?: number | string;
+    maxAmount?: number | string;
+    remark?: string;
+    tradingPreferenceSet?: TradingPreferenceSet;
+    paymentIds?: string[];
+    quantity?: string;
+    paymentPeriod?: string | number;
+    itemType?: 'ORIGIN' | 'BULK';
+    [key: string]: any;
+}
+
+export interface GetOrdersParams {
+    status?: string;
+    beginTime?: string | number;
+    endTime?: string | number;
+    tokenId?: string;
+    side?: number[];
+    page?: number;
+    size?: number;
+    [key: string]: any;
+}
+
+export interface UploadChatFileParams {
+    upload_file: string | Buffer; // Path string or Buffer
+    filename?: string;
+    [key: string]: any;
+}
+
+// ... Add more generalized interfaces as needed or use `any` for less common methods
+// to keep the initial conversion manageable but extensible.