telegram-wallet-p2p 1.0.0

package/README.md

@@ -0,0 +1,87 @@
+# Telegram Wallet P2P SDK — Node.js / TypeScript
+
+> ⚠️ **Unofficial SDK** — This project is not affiliated with, endorsed by, or related to Telegram or Wallet.
+
+A fully typed TypeScript SDK for the [Telegram Wallet P2P API](https://docs.wallet.tg/p2p).
+
+## Features
+
+- 🔷 **TypeScript-first** — Full type safety with strict mode
+- 🌐 **Zero dependencies** — Uses native `fetch` (Node.js 18+)
+- 🔁 **Auto-retry** — Exponential backoff on rate limits and server errors
+- 📊 **Analytics** — Built-in utilities for price analysis and filtering
+- 🔑 **Safe auth** — API key passed via constructor, never logged
+
+## Installation
+
+```bash
+npm install telegram-wallet-p2p
+```
+
+## Quick Start
+
+```typescript
+import { WalletP2PClient, TradeSide } from "telegram-wallet-p2p";
+
+const client = new WalletP2PClient({
+  apiKey: process.env.WALLET_P2P_API_KEY!,
+});
+
+const response = await client.getOnlineItems({
+  cryptoCurrency: "USDT",
+  fiatCurrency: "RUB",
+  side: TradeSide.SELL,
+});
+
+for (const item of response.data) {
+  console.log(`${item.nickname}: ${item.price} ${item.fiatCurrency}`);
+}
+```
+
+## Analytics
+
+```typescript
+import { bestPrice, priceSpread, marketSummary, TradeSide } from "telegram-wallet-p2p";
+
+// Find the best sell price
+const best = bestPrice(response.data, TradeSide.SELL);
+
+// Get price statistics
+const spread = priceSpread(response.data);
+// => { min: "95.0000", max: "102.5000", avg: "98.7500", ... }
+
+// Full market summary
+const summary = marketSummary(response.data);
+```
+
+## API Reference
+
+### `new WalletP2PClient(options)`
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | required | Your Wallet P2P API key |
+| `baseUrl` | `string` | `https://p2p.walletbot.me` | API base URL |
+| `timeout` | `number` | `30000` | Request timeout in ms |
+| `maxRetries` | `number` | `3` | Retry attempts on 429/5xx |
+| `retryBaseDelay` | `number` | `1000` | Base delay in ms for exponential backoff |
+
+### `client.getOnlineItems(params)`
+
+Fetches active P2P ads. Returns `Promise<GetOnlineItemsResponse>`.
+
+## Error Handling
+
+```typescript
+import {
+  BadRequestError,       // 400 — unsupported currency
+  AuthenticationError,   // 401 — invalid API key
+  AccessDeniedError,     // 403 — access denied
+  RateLimitError,        // 429 — rate limit exceeded
+  ServerError,           // 5xx — server error
+} from "telegram-wallet-p2p";
+```
+
+## License
+
+MIT

package/dist/analytics.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Analytics utilities for P2P market data.
+ *
+ * All functions are pure and operate on arrays of OnlineItem.
+ * They do not make any API calls.
+ */
+import { TradeSide } from "./types.js";
+import type { OnlineItem, PriceSpread, MarketSummary } from "./types.js";
+/**
+ * Find the ad with the best price for the given trade side.
+ *
+ * For BUY: the lowest price (cheapest to buy crypto).
+ * For SELL: the highest price (best rate to sell crypto).
+ */
+export declare function bestPrice(items: OnlineItem[], side: TradeSide): OnlineItem | null;
+/**
+ * Calculate price spread statistics across all ads.
+ */
+export declare function priceSpread(items: OnlineItem[]): PriceSpread | null;
+/**
+ * Filter ads that accept a specific payment method.
+ */
+export declare function filterByPayment(items: OnlineItem[], method: string): OnlineItem[];
+/**
+ * Filter ads by merchant verification level.
+ */
+export declare function filterByMerchantLevel(items: OnlineItem[], level: string): OnlineItem[];
+/**
+ * Generate a comprehensive market summary from a list of ads.
+ */
+export declare function marketSummary(items: OnlineItem[]): MarketSummary;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,SAAS,CACrB,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,EAAE,SAAS,GAChB,UAAU,GAAG,IAAI,CAanB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,WAAW,GAAG,IAAI,CAuBnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,MAAM,GACf,UAAU,EAAE,CAKd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,MAAM,GACd,UAAU,EAAE,CAEd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,aAAa,CAwChE"}

package/dist/analytics.js

@@ -0,0 +1,101 @@
+/**
+ * Analytics utilities for P2P market data.
+ *
+ * All functions are pure and operate on arrays of OnlineItem.
+ * They do not make any API calls.
+ */
+import { TradeSide } from "./types.js";
+/**
+ * Find the ad with the best price for the given trade side.
+ *
+ * For BUY: the lowest price (cheapest to buy crypto).
+ * For SELL: the highest price (best rate to sell crypto).
+ */
+export function bestPrice(items, side) {
+    if (items.length === 0)
+        return null;
+    return items.reduce((best, item) => {
+        const bestVal = parseFloat(best.price);
+        const itemVal = parseFloat(item.price);
+        if (side === TradeSide.BUY) {
+            return itemVal < bestVal ? item : best;
+        }
+        else {
+            return itemVal > bestVal ? item : best;
+        }
+    });
+}
+/**
+ * Calculate price spread statistics across all ads.
+ */
+export function priceSpread(items) {
+    if (items.length === 0)
+        return null;
+    const prices = items.map((item) => parseFloat(item.price)).sort((a, b) => a - b);
+    const min = prices[0];
+    const max = prices[prices.length - 1];
+    const avg = prices.reduce((sum, p) => sum + p, 0) / prices.length;
+    const mid = Math.floor(prices.length / 2);
+    const median = prices.length % 2 !== 0
+        ? prices[mid]
+        : (prices[mid - 1] + prices[mid]) / 2;
+    return {
+        min: min.toFixed(4),
+        max: max.toFixed(4),
+        avg: avg.toFixed(4),
+        median: median.toFixed(4),
+        spread: (max - min).toFixed(4),
+        count: prices.length,
+    };
+}
+/**
+ * Filter ads that accept a specific payment method.
+ */
+export function filterByPayment(items, method) {
+    const methodLower = method.toLowerCase();
+    return items.filter((item) => item.payments.some((p) => p.toLowerCase() === methodLower));
+}
+/**
+ * Filter ads by merchant verification level.
+ */
+export function filterByMerchantLevel(items, level) {
+    return items.filter((item) => item.merchantLevel === level);
+}
+/**
+ * Generate a comprehensive market summary from a list of ads.
+ */
+export function marketSummary(items) {
+    if (items.length === 0) {
+        return {
+            totalAds: 0,
+            priceStats: null,
+            onlineCount: 0,
+            autoAcceptCount: 0,
+            paymentMethods: {},
+            merchantDistribution: {},
+            avgCompletionRate: "0",
+        };
+    }
+    const paymentMethods = {};
+    for (const item of items) {
+        for (const method of item.payments) {
+            paymentMethods[method] = (paymentMethods[method] ?? 0) + 1;
+        }
+    }
+    const merchantDistribution = {};
+    for (const item of items) {
+        merchantDistribution[item.merchantLevel] =
+            (merchantDistribution[item.merchantLevel] ?? 0) + 1;
+    }
+    const totalRate = items.reduce((sum, item) => sum + parseFloat(item.executeRate), 0);
+    return {
+        totalAds: items.length,
+        priceStats: priceSpread(items),
+        onlineCount: items.filter((item) => item.isOnline).length,
+        autoAcceptCount: items.filter((item) => item.isAutoAccept).length,
+        paymentMethods,
+        merchantDistribution,
+        avgCompletionRate: (totalRate / items.length).toFixed(4),
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * HTTP client for the Telegram Wallet P2P API.
+ *
+ * This is an UNOFFICIAL SDK. Not affiliated with Telegram or Wallet.
+ */
+import type { ClientOptions, GetOnlineItemsResponse, TradeSide } from "./types.js";
+export declare class WalletP2PClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly retryBaseDelay;
+    /**
+     * Create a new Wallet P2P API client.
+     *
+     * @example
+     * ```ts
+     * const client = new WalletP2PClient({
+     *   apiKey: process.env.WALLET_P2P_API_KEY!,
+     * });
+     * const response = await client.getOnlineItems({
+     *   cryptoCurrency: "USDT",
+     *   fiatCurrency: "RUB",
+     *   side: TradeSide.SELL,
+     * });
+     * ```
+     */
+    constructor(options: ClientOptions);
+    /**
+     * Fetch active P2P ads from the market.
+     *
+     * @param params.cryptoCurrency - Cryptocurrency code (e.g., "USDT", "BTC")
+     * @param params.fiatCurrency - Fiat currency code (e.g., "RUB", "USD")
+     * @param params.side - Trade direction: BUY or SELL
+     * @param params.page - Page number (default: 1)
+     * @param params.pageSize - Items per page (1-50, default: 10)
+     * @returns Response with status and list of online items
+     *
+     * @throws {BadRequestError} If a currency is not supported
+     * @throws {AuthenticationError} If the API key is invalid
+     * @throws {AccessDeniedError} If access is denied
+     * @throws {RateLimitError} If the rate limit is exceeded
+     * @throws {ServerError} On server-side errors
+     */
+    getOnlineItems(params: {
+        cryptoCurrency: string;
+        fiatCurrency: string;
+        side: TradeSide;
+        page?: number;
+        pageSize?: number;
+    }): Promise<GetOnlineItemsResponse>;
+    private requestWithRetry;
+    private doRequest;
+    private sleep;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EACR,aAAa,EACb,sBAAsB,EACtB,SAAS,EAEZ,MAAM,YAAY,CAAC;AAKpB,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC;;;;;;;;;;;;;;OAcG;gBACS,OAAO,EAAE,aAAa;IAYlC;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAAC,MAAM,EAAE;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,SAAS,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAerB,gBAAgB;YAsBhB,SAAS;IA+DvB,OAAO,CAAC,KAAK;CAGhB"}

package/dist/client.js

@@ -0,0 +1,144 @@
+/**
+ * HTTP client for the Telegram Wallet P2P API.
+ *
+ * This is an UNOFFICIAL SDK. Not affiliated with Telegram or Wallet.
+ */
+import { AccessDeniedError, AuthenticationError, BadRequestError, RateLimitError, ServerError, WalletP2PError, } from "./errors.js";
+const DEFAULT_BASE_URL = "https://p2p.walletbot.me";
+const ONLINE_ITEMS_PATH = "/p2p/integration-api/v1/item/online";
+export class WalletP2PClient {
+    apiKey;
+    baseUrl;
+    timeout;
+    maxRetries;
+    retryBaseDelay;
+    /**
+     * Create a new Wallet P2P API client.
+     *
+     * @example
+     * ```ts
+     * const client = new WalletP2PClient({
+     *   apiKey: process.env.WALLET_P2P_API_KEY!,
+     * });
+     * const response = await client.getOnlineItems({
+     *   cryptoCurrency: "USDT",
+     *   fiatCurrency: "RUB",
+     *   side: TradeSide.SELL,
+     * });
+     * ```
+     */
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error("apiKey must not be empty");
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeout = options.timeout ?? 30_000;
+        this.maxRetries = options.maxRetries ?? 3;
+        this.retryBaseDelay = options.retryBaseDelay ?? 1_000;
+    }
+    /**
+     * Fetch active P2P ads from the market.
+     *
+     * @param params.cryptoCurrency - Cryptocurrency code (e.g., "USDT", "BTC")
+     * @param params.fiatCurrency - Fiat currency code (e.g., "RUB", "USD")
+     * @param params.side - Trade direction: BUY or SELL
+     * @param params.page - Page number (default: 1)
+     * @param params.pageSize - Items per page (1-50, default: 10)
+     * @returns Response with status and list of online items
+     *
+     * @throws {BadRequestError} If a currency is not supported
+     * @throws {AuthenticationError} If the API key is invalid
+     * @throws {AccessDeniedError} If access is denied
+     * @throws {RateLimitError} If the rate limit is exceeded
+     * @throws {ServerError} On server-side errors
+     */
+    async getOnlineItems(params) {
+        const body = {
+            cryptoCurrency: params.cryptoCurrency,
+            fiatCurrency: params.fiatCurrency,
+            side: params.side,
+            page: params.page ?? 1,
+            pageSize: params.pageSize ?? 10,
+        };
+        return this.requestWithRetry(`${this.baseUrl}${ONLINE_ITEMS_PATH}`, body);
+    }
+    async requestWithRetry(url, body) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                return await this.doRequest(url, body);
+            }
+            catch (err) {
+                if (err instanceof RateLimitError || err instanceof ServerError) {
+                    lastError = err;
+                    if (attempt < this.maxRetries) {
+                        const delay = this.retryBaseDelay * 2 ** attempt;
+                        await this.sleep(delay);
+                    }
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        throw lastError;
+    }
+    async doRequest(url, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "X-API-Key": this.apiKey,
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (response.ok) {
+                return (await response.json());
+            }
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                // ignore parse errors
+            }
+            const errorCode = errorBody?.errorCode ?? "";
+            const errorMessage = errorBody?.errorMessage ?? response.statusText ?? "Unknown error";
+            switch (response.status) {
+                case 400:
+                    throw new BadRequestError(errorMessage, errorCode);
+                case 401:
+                    throw new AuthenticationError(errorMessage);
+                case 403:
+                    throw new AccessDeniedError(errorMessage, errorCode);
+                case 429:
+                    throw new RateLimitError(errorMessage);
+                default:
+                    if (response.status >= 500) {
+                        throw new ServerError(errorMessage, response.status, errorCode);
+                    }
+                    throw new WalletP2PError(`Unexpected status ${response.status}: ${errorMessage}`, response.status);
+            }
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err instanceof WalletP2PError)
+                throw err;
+            if (err instanceof DOMException && err.name === "AbortError") {
+                throw new WalletP2PError("Request timed out", 408);
+            }
+            throw new WalletP2PError(`HTTP request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,cAAc,GACjB,MAAM,aAAa,CAAC;AAQrB,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AACpD,MAAM,iBAAiB,GAAG,qCAAqC,CAAC;AAEhE,MAAM,OAAO,eAAe;IACP,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,OAAO,CAAS;IAChB,UAAU,CAAS;IACnB,cAAc,CAAS;IAExC;;;;;;;;;;;;;;OAcG;IACH,YAAY,OAAsB;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,cAAc,CAAC,MAMpB;QACG,MAAM,IAAI,GAAG;YACT,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAClC,CAAC;QAEF,OAAO,IAAI,CAAC,gBAAgB,CACxB,GAAG,IAAI,CAAC,OAAO,GAAG,iBAAiB,EAAE,EACrC,IAAI,CACP,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAI,GAAW,EAAE,IAAa;QACxD,IAAI,SAA4B,CAAC;QAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAI,GAAG,EAAE,IAAI,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;oBAC9D,SAAS,GAAG,GAAG,CAAC;oBAChB,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;wBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,OAAO,CAAC;wBACjD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC5B,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACJ,MAAM,GAAG,CAAC;gBACd,CAAC;YACL,CAAC;QACL,CAAC;QAED,MAAM,SAAU,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAI,GAAW,EAAE,IAAa;QACjD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC9B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACL,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,cAAc,EAAE,kBAAkB;oBAClC,MAAM,EAAE,kBAAkB;iBAC7B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC5B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;YACxC,CAAC;YAED,IAAI,SAA6C,CAAC;YAClD,IAAI,CAAC;gBACD,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;YAClE,CAAC;YAAC,MAAM,CAAC;gBACL,sBAAsB;YAC1B,CAAC;YAED,MAAM,SAAS,GAAG,SAAS,EAAE,SAAS,IAAI,EAAE,CAAC;YAC7C,MAAM,YAAY,GACd,SAAS,EAAE,YAAY,IAAI,QAAQ,CAAC,UAAU,IAAI,eAAe,CAAC;YAEtE,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACtB,KAAK,GAAG;oBACJ,MAAM,IAAI,eAAe,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;gBACvD,KAAK,GAAG;oBACJ,MAAM,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;gBAChD,KAAK,GAAG;oBACJ,MAAM,IAAI,iBAAiB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;gBACzD,KAAK,GAAG;oBACJ,MAAM,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;gBAC3C;oBACI,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;wBACzB,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;oBACpE,CAAC;oBACD,MAAM,IAAI,cAAc,CACpB,qBAAqB,QAAQ,CAAC,MAAM,KAAK,YAAY,EAAE,EACvD,QAAQ,CAAC,MAAM,CAClB,CAAC;YACV,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,GAAG,YAAY,cAAc;gBAAE,MAAM,GAAG,CAAC;YAC7C,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC3D,MAAM,IAAI,cAAc,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,IAAI,cAAc,CACpB,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7E,CAAC;QACN,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,EAAU;QACpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;CACJ"}

package/dist/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Error classes for the Telegram Wallet P2P SDK.
+ */
+/** Base error for all Wallet P2P SDK errors. */
+export declare class WalletP2PError extends Error {
+    readonly statusCode?: number;
+    constructor(message: string, statusCode?: number);
+}
+/** Raised when the API key is invalid (HTTP 401). */
+export declare class AuthenticationError extends WalletP2PError {
+    constructor(message?: string);
+}
+/** Raised when access is denied (HTTP 403). */
+export declare class AccessDeniedError extends WalletP2PError {
+    readonly errorCode?: string;
+    constructor(message?: string, errorCode?: string);
+}
+/**
+ * Raised on invalid request parameters (HTTP 400).
+ *
+ * Contains the specific errorCode from the API, e.g.:
+ * - CRYPTO_CURRENCY_NOT_SUPPORTED
+ * - FIAT_CURRENCY_NOT_SUPPORTED
+ */
+export declare class BadRequestError extends WalletP2PError {
+    readonly errorCode?: string;
+    constructor(message: string, errorCode?: string);
+}
+/** Raised when the rate limit is exceeded (HTTP 429). */
+export declare class RateLimitError extends WalletP2PError {
+    constructor(message?: string);
+}
+/** Raised on server-side errors (HTTP 5xx). */
+export declare class ServerError extends WalletP2PError {
+    readonly errorCode?: string;
+    constructor(message?: string, statusCode?: number, errorCode?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gDAAgD;AAChD,qBAAa,cAAe,SAAQ,KAAK;IACrC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKnD;AAED,qDAAqD;AACrD,qBAAa,mBAAoB,SAAQ,cAAc;gBACvC,OAAO,SAAoB;CAI1C;AAED,+CAA+C;AAC/C,qBAAa,iBAAkB,SAAQ,cAAc;IACjD,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,SAAkB,EAAE,SAAS,CAAC,EAAE,MAAM;CAK5D;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,cAAc;IAC/C,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKlD;AAED,yDAAyD;AACzD,qBAAa,cAAe,SAAQ,cAAc;gBAClC,OAAO,SAA0B;CAIhD;AAED,+CAA+C;AAC/C,qBAAa,WAAY,SAAQ,cAAc;IAC3C,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAG/B,OAAO,SAAoC,EAC3C,UAAU,SAAM,EAChB,SAAS,CAAC,EAAE,MAAM;CAMzB"}

package/dist/errors.js

@@ -0,0 +1,60 @@
+/**
+ * Error classes for the Telegram Wallet P2P SDK.
+ */
+/** Base error for all Wallet P2P SDK errors. */
+export class WalletP2PError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.name = "WalletP2PError";
+        this.statusCode = statusCode;
+    }
+}
+/** Raised when the API key is invalid (HTTP 401). */
+export class AuthenticationError extends WalletP2PError {
+    constructor(message = "Invalid API key") {
+        super(message, 401);
+        this.name = "AuthenticationError";
+    }
+}
+/** Raised when access is denied (HTTP 403). */
+export class AccessDeniedError extends WalletP2PError {
+    errorCode;
+    constructor(message = "Access denied", errorCode) {
+        super(message, 403);
+        this.name = "AccessDeniedError";
+        this.errorCode = errorCode;
+    }
+}
+/**
+ * Raised on invalid request parameters (HTTP 400).
+ *
+ * Contains the specific errorCode from the API, e.g.:
+ * - CRYPTO_CURRENCY_NOT_SUPPORTED
+ * - FIAT_CURRENCY_NOT_SUPPORTED
+ */
+export class BadRequestError extends WalletP2PError {
+    errorCode;
+    constructor(message, errorCode) {
+        super(message, 400);
+        this.name = "BadRequestError";
+        this.errorCode = errorCode;
+    }
+}
+/** Raised when the rate limit is exceeded (HTTP 429). */
+export class RateLimitError extends WalletP2PError {
+    constructor(message = "Request limit reached") {
+        super(message, 429);
+        this.name = "RateLimitError";
+    }
+}
+/** Raised on server-side errors (HTTP 5xx). */
+export class ServerError extends WalletP2PError {
+    errorCode;
+    constructor(message = "Service temporarily unavailable", statusCode = 503, errorCode) {
+        super(message, statusCode);
+        this.name = "ServerError";
+        this.errorCode = errorCode;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gDAAgD;AAChD,MAAM,OAAO,cAAe,SAAQ,KAAK;IACrB,UAAU,CAAU;IAEpC,YAAY,OAAe,EAAE,UAAmB;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;CACJ;AAED,qDAAqD;AACrD,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACnD,YAAY,OAAO,GAAG,iBAAiB;QACnC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AAED,+CAA+C;AAC/C,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACjC,SAAS,CAAU;IAEnC,YAAY,OAAO,GAAG,eAAe,EAAE,SAAkB;QACrD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CACJ;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IAC/B,SAAS,CAAU;IAEnC,YAAY,OAAe,EAAE,SAAkB;QAC3C,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CACJ;AAED,yDAAyD;AACzD,MAAM,OAAO,cAAe,SAAQ,cAAc;IAC9C,YAAY,OAAO,GAAG,uBAAuB;QACzC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IACjC,CAAC;CACJ;AAED,+CAA+C;AAC/C,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC3B,SAAS,CAAU;IAEnC,YACI,OAAO,GAAG,iCAAiC,EAC3C,UAAU,GAAG,GAAG,EAChB,SAAkB;QAElB,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Telegram Wallet P2P SDK (Unofficial)
+ *
+ * A TypeScript SDK for the Telegram Wallet P2P API.
+ * This is an UNOFFICIAL project and is not affiliated with Telegram or Wallet.
+ *
+ * Provides read-only access to P2P market data for analytics and monitoring.
+ *
+ * @packageDocumentation
+ */
+export { WalletP2PClient } from "./client.js";
+export { WalletP2PError, AuthenticationError, AccessDeniedError, BadRequestError, RateLimitError, ServerError, } from "./errors.js";
+export { TradeSide, MerchantLevel, ErrorCode, } from "./types.js";
+export type { OnlineItem, GetOnlineItemsRequest, GetOnlineItemsResponse, WalletP2PErrorResponse, ClientOptions, PriceSpread, MarketSummary, } from "./types.js";
+export { bestPrice, priceSpread, filterByPayment, filterByMerchantLevel, marketSummary, } from "./analytics.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,WAAW,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,SAAS,EACT,aAAa,EACb,SAAS,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACR,UAAU,EACV,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,aAAa,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,SAAS,EACT,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,aAAa,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * Telegram Wallet P2P SDK (Unofficial)
+ *
+ * A TypeScript SDK for the Telegram Wallet P2P API.
+ * This is an UNOFFICIAL project and is not affiliated with Telegram or Wallet.
+ *
+ * Provides read-only access to P2P market data for analytics and monitoring.
+ *
+ * @packageDocumentation
+ */
+export { WalletP2PClient } from "./client.js";
+export { WalletP2PError, AuthenticationError, AccessDeniedError, BadRequestError, RateLimitError, ServerError, } from "./errors.js";
+export { TradeSide, MerchantLevel, ErrorCode, } from "./types.js";
+export { bestPrice, priceSpread, filterByPayment, filterByMerchantLevel, marketSummary, } from "./analytics.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,WAAW,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,SAAS,EACT,aAAa,EACb,SAAS,GACZ,MAAM,YAAY,CAAC;AAYpB,OAAO,EACH,SAAS,EACT,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,aAAa,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Type definitions for the Telegram Wallet P2P API.
+ *
+ * Derived from the official OpenAPI specification.
+ * This is an UNOFFICIAL SDK — not affiliated with Telegram or Wallet.
+ */
+/** Trade direction. */
+export declare enum TradeSide {
+    BUY = "BUY",
+    SELL = "SELL"
+}
+/** Merchant verification level. */
+export declare enum MerchantLevel {
+    REGULAR_USER = "REGULAR_USER",
+    MERCHANT = "MERCHANT",
+    TRUSTED_MERCHANT = "TRUSTED_MERCHANT"
+}
+/** API error codes. */
+export declare enum ErrorCode {
+    CRYPTO_CURRENCY_NOT_SUPPORTED = "CRYPTO_CURRENCY_NOT_SUPPORTED",
+    FIAT_CURRENCY_NOT_SUPPORTED = "FIAT_CURRENCY_NOT_SUPPORTED",
+    ACCESS_DENIED = "ACCESS_DENIED",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+/**
+ * A single P2P market ad (item).
+ * Price and quantity fields are strings to preserve decimal precision.
+ */
+export interface OnlineItem {
+    /** Item (ad) ID */
+    id: string;
+    /** Item (ad) human-readable number */
+    number: string;
+    /** User ID of the item owner */
+    userId: number;
+    /** Nickname of the item owner */
+    nickname: string;
+    /** Cryptocurrency code */
+    cryptoCurrency: string;
+    /** Fiat currency code */
+    fiatCurrency: string;
+    /** Trade side: BUY or SELL */
+    side: TradeSide;
+    /** Price per unit of cryptocurrency */
+    price: string;
+    /** Available quantity */
+    lastQuantity: string;
+    /** Minimum order amount in fiat */
+    minAmount: string;
+    /** Maximum order amount in fiat. null if no maximum limit. */
+    maxAmount: string | null;
+    /** List of accepted payment method codes */
+    payments: string[];
+    /** Number of completed orders */
+    orderNum: number;
+    /** Order completion rate (0-1) */
+    executeRate: string;
+    /** Whether the user is currently online */
+    isOnline: boolean;
+    /** Merchant verification level */
+    merchantLevel: MerchantLevel;
+    /** Payment timeout in minutes */
+    paymentPeriod: number;
+    /** Whether the ad has auto-accept enabled */
+    isAutoAccept: boolean;
+}
+/** Request body for fetching online P2P ads. */
+export interface GetOnlineItemsRequest {
+    /** Cryptocurrency code (e.g., "USDT") */
+    cryptoCurrency: string;
+    /** Fiat currency code (e.g., "RUB") */
+    fiatCurrency: string;
+    /** Trade side: BUY or SELL */
+    side: TradeSide;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Items per page (default: 10, max: 50) */
+    pageSize?: number;
+}
+/** Successful response from the online items endpoint. */
+export interface GetOnlineItemsResponse {
+    /** Status of request execution */
+    status: "SUCCESS";
+    /** List of online items */
+    data: OnlineItem[];
+}
+/** Error response from the API. */
+export interface WalletP2PErrorResponse {
+    /** Error code */
+    errorCode: string;
+    /** Error details */
+    errorMessage: string;
+}
+/** Client configuration options. */
+export interface ClientOptions {
+    /** Your Wallet P2P API key. */
+    apiKey: string;
+    /** API base URL. Defaults to https://p2p.walletbot.me */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Default: 30000 */
+    timeout?: number;
+    /** Max retry attempts on transient errors. Default: 3 */
+    maxRetries?: number;
+    /** Base delay in ms for exponential backoff. Default: 1000 */
+    retryBaseDelay?: number;
+}
+/** Price spread statistics. */
+export interface PriceSpread {
+    min: string;
+    max: string;
+    avg: string;
+    median: string;
+    spread: string;
+    count: number;
+}
+/** Comprehensive market summary. */
+export interface MarketSummary {
+    totalAds: number;
+    priceStats: PriceSpread | null;
+    onlineCount: number;
+    autoAcceptCount: number;
+    paymentMethods: Record<string, number>;
+    merchantDistribution: Record<string, number>;
+    avgCompletionRate: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uBAAuB;AACvB,oBAAY,SAAS;IACjB,GAAG,QAAQ;IACX,IAAI,SAAS;CAChB;AAED,mCAAmC;AACnC,oBAAY,aAAa;IACrB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;CACxC;AAED,uBAAuB;AACvB,oBAAY,SAAS;IACjB,6BAA6B,kCAAkC;IAC/D,2BAA2B,gCAAgC;IAC3D,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,aAAa,EAAE,aAAa,CAAC;IAC7B,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAC;CACzB;AAED,gDAAgD;AAChD,MAAM,WAAW,qBAAqB;IAClC,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACnC,kCAAkC;IAClC,MAAM,EAAE,SAAS,CAAC;IAClB,2BAA2B;IAC3B,IAAI,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,sBAAsB;IACnC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC1B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,iBAAiB,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1,28 @@
+/**
+ * Type definitions for the Telegram Wallet P2P API.
+ *
+ * Derived from the official OpenAPI specification.
+ * This is an UNOFFICIAL SDK — not affiliated with Telegram or Wallet.
+ */
+/** Trade direction. */
+export var TradeSide;
+(function (TradeSide) {
+    TradeSide["BUY"] = "BUY";
+    TradeSide["SELL"] = "SELL";
+})(TradeSide || (TradeSide = {}));
+/** Merchant verification level. */
+export var MerchantLevel;
+(function (MerchantLevel) {
+    MerchantLevel["REGULAR_USER"] = "REGULAR_USER";
+    MerchantLevel["MERCHANT"] = "MERCHANT";
+    MerchantLevel["TRUSTED_MERCHANT"] = "TRUSTED_MERCHANT";
+})(MerchantLevel || (MerchantLevel = {}));
+/** API error codes. */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["CRYPTO_CURRENCY_NOT_SUPPORTED"] = "CRYPTO_CURRENCY_NOT_SUPPORTED";
+    ErrorCode["FIAT_CURRENCY_NOT_SUPPORTED"] = "FIAT_CURRENCY_NOT_SUPPORTED";
+    ErrorCode["ACCESS_DENIED"] = "ACCESS_DENIED";
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uBAAuB;AACvB,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACjB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACjB,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,mCAAmC;AACnC,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,8CAA6B,CAAA;IAC7B,sCAAqB,CAAA;IACrB,sDAAqC,CAAA;AACzC,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED,uBAAuB;AACvB,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACjB,4EAA+D,CAAA;IAC/D,wEAA2D,CAAA;IAC3D,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;AACrC,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB"}

package/package.json

@@ -0,0 +1,52 @@
+{
+    "name": "telegram-wallet-p2p",
+    "version": "1.0.0",
+    "description": "Unofficial Node.js/TypeScript SDK for the Telegram Wallet P2P API",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "lint": "eslint src/ tests/",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "telegram",
+        "wallet",
+        "p2p",
+        "crypto",
+        "api",
+        "sdk",
+        "typescript"
+    ],
+    "author": "Furkan Köykıran",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/furkankoykiran/telegram-wallet-p2p-sdk",
+        "directory": "packages/node"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "devDependencies": {
+        "typescript": "^5.4.0",
+        "vitest": "^1.6.0",
+        "@typescript-eslint/eslint-plugin": "^7.0.0",
+        "@typescript-eslint/parser": "^7.0.0",
+        "eslint": "^8.57.0"
+    }
+}