@ton-pay/api 0.1.0

package/README.md

@@ -0,0 +1,72 @@
+# @ton-pay/api
+
+Core API functions for TonPay SDK - create transfers, check status, and verify webhooks.
+
+## Documentation
+
+Full documentation: https://docs.tonpay.tech
+
+## Installation
+
+```bash
+npm install @ton-pay/api
+```
+
+## Usage
+
+```typescript
+import {
+  createTonPayTransfer,
+  getTonPayTransferByReference,
+  getTonPayTransferByBodyHash,
+  verifySignature,
+  TON,
+  USDT,
+} from "@ton-pay/api";
+
+// Create a TonPay transfer
+const transfer = await createTonPayTransfer(
+  {
+    amount: 10.5,
+    asset: TON,
+    recipientAddr: "EQC...",
+    senderAddr: "EQC...",
+    commentToSender: "Payment for order #123",
+    commentToRecipient: "Thank you!",
+  },
+  {
+    chain: "mainnet",
+    apiKey: "your-api-key",
+  }
+);
+
+// Get transfer status by reference
+const transferInfo = await getTonPayTransferByReference(transfer.reference, {
+  chain: "mainnet",
+  apiKey: "your-api-key",
+});
+
+// Verify webhook signature
+const isValid = verifySignature(webhookPayload, signature, apiSecret);
+```
+
+## API
+
+### Transfer Functions
+
+- `createTonPayTransfer(params, options)` - Create a new TON Pay transfer
+- `getTonPayTransferByReference(reference, options)` - Get transfer info by reference
+- `getTonPayTransferByBodyHash(bodyHash, options)` - Get transfer info by body hash
+
+### Webhook Utils
+
+- `verifySignature(payload, signature, apiSecret)` - Verify webhook signature
+
+### Constants
+
+- `TON` - TON coin identifier
+- `USDT` - USDT jetton identifier
+
+## License
+
+Apache License 2.0

package/dist/index.d.mts

@@ -0,0 +1,202 @@
+type Chain = "mainnet" | "testnet";
+
+type APIOptions = {
+    chain?: Chain;
+    apiKey?: string;
+};
+
+/**
+ * @param amount - in human readable format, 10.5 for example
+ * @param asset - jetton master address or TON coin address for TON transfer
+ * @param recipientAddr - recipient wallet address. Optional if API key is provided - defaults to the merchant's wallet address from the admin panel
+ * @param senderAddr - payer wallet address
+ * @param queryId - only for Jetton
+ * @param commentToSender - a comment that will be displayed in the user's wallet when signing a transaction
+ * @param commentToRecipient - a comment that will be displayed in the recipient's wallet when receiving a transaction
+ */
+type CreateTonPayTransferParams = {
+    amount: number;
+    asset: string;
+    recipientAddr?: string;
+    senderAddr: string;
+    queryId?: number;
+    commentToSender?: string;
+    commentToRecipient?: string;
+};
+/**
+ * @param message - a built message that will be sent to the recipient's wallet
+ * @param bodyBase64Hash - a hash of the transaction message content in Base64 format
+ * @param reference - a reference ID for the transaction, used for tracking the transaction
+ */
+type CreateTonPayTransferResponse = {
+    message: {
+        address: string;
+        amount: string;
+        payload: string;
+    };
+    bodyBase64Hash: string;
+    reference: string;
+};
+
+/**
+ * Creates a message for TON Pay transfer
+ * @param params - the parameters for the transfer
+ * @param options - the options for the transfer
+ * @returns the message for the transfer and data for tracking the transfer
+ */
+declare const createTonPayTransfer: (params: CreateTonPayTransferParams, options?: APIOptions) => Promise<CreateTonPayTransferResponse>;
+
+/**
+ * @param amount - the amount of the transfer in human readable format
+ * @param rawAmount - the amount of the transfer in base units
+ * @param senderAddr - the address of the sender wallet
+ * @param recipientAddr - the address of the recipient wallet
+ * @param asset - the address of the asset
+ * @param assetTicker - the ticker of the asset (e.g. "USDT")
+ * @param status - the status of the transfer ("success" or "failed")
+ * @param reference - the reference of the transfer
+ * @param bodyBase64Hash - the hash of the body of the transfer in Base64 format
+ * @param txHash - the hash of the transaction
+ * @param traceId - the id of the trace
+ * @param commentToSender - the comment to the sender wallet
+ * @param commentToRecipient - the comment to the recipient wallet
+ * @param date - the date of the transfer
+ * @param errorCode - the error code of the transfer
+ * @param errorMessage - the error message of the transfer
+ */
+type CompletedTonPayTransferInfo = {
+    amount: string;
+    rawAmount: string;
+    senderAddr: string;
+    recipientAddr: string;
+    asset: string;
+    assetTicker?: string;
+    status: string;
+    reference: string;
+    bodyBase64Hash: string;
+    txHash: string;
+    traceId: string;
+    commentToSender?: string;
+    commentToRecipient?: string;
+    date: string;
+    errorCode?: number;
+    errorMessage?: string;
+};
+
+/**
+ * Gets a TON Pay transfer by reference
+ * @param reference - the reference of the transfer
+ * @param options - the options for the transfer
+ * @returns the transfer information
+ */
+declare const getTonPayTransferByBodyHash: (bodyHash: string, options?: APIOptions) => Promise<CompletedTonPayTransferInfo>;
+
+/**
+ * Gets a TON Pay transfer by reference
+ * @param reference - the reference of the transfer
+ * @param options - the options for the transfer
+ * @returns the transfer information
+ */
+declare const getTonPayTransferByReference: (reference: string, options?: APIOptions) => Promise<CompletedTonPayTransferInfo>;
+
+/**
+ * @param bodyHash - the hash of the transaction message content
+ */
+type GetTonPayTransferByBodyHashParams = {
+    bodyHash: string;
+};
+
+/**
+ * @param reference - the reference of the transfer
+ */
+type GetTonPayTransferByReferenceParams = {
+    reference: string;
+};
+
+/**
+ * Webhook event types
+ *
+ * @remarks
+ * - `transfer.completed` - Transfer completed (check `data.status` for success/failed)
+ * - `transfer.refunded` - Transfer was refunded (Coming Soon)
+ */
+type WebhookEventType = "transfer.completed" | "transfer.refunded";
+
+/**
+ * Base webhook payload structure
+ */
+interface BaseWebhookPayload {
+    event: WebhookEventType;
+    timestamp: string;
+}
+/**
+ * Webhook payload for transfer.completed event
+ *
+ * @remarks
+ * Sent when a transfer is completed on the blockchain.
+ * Check `data.status` field to determine if transfer was "success" or "failed".
+ */
+interface TransferCompletedWebhookPayload extends BaseWebhookPayload {
+    event: "transfer.completed";
+    data: CompletedTonPayTransferInfo;
+}
+/**
+ * Webhook payload for transfer.refunded event
+ *
+ * @remarks
+ * Coming Soon - Sent when a transfer is refunded
+ */
+interface TransferRefundedWebhookPayload extends BaseWebhookPayload {
+    event: "transfer.refunded";
+    data: unknown;
+}
+/**
+ * Union type for all webhook payloads
+ *
+ * @remarks
+ * Currently only transfer.completed is supported.
+ * Additional events will be added in future updates.
+ */
+type WebhookPayload = TransferCompletedWebhookPayload | TransferRefundedWebhookPayload;
+
+declare const USDT = "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs";
+declare const TON = "TON";
+
+/**
+ * Verifies the HMAC-SHA256 signature of a payload
+ * @param payload - Raw JSON string or object to verify
+ * @param signature - The signature from X-TonPay-Signature header
+ * @param apiSecret - Your TON Pay webhook API secret
+ * @returns true if signature is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { verifySignature } from "@ton-pay/api";
+ *
+ * // With raw string
+ * app.post("/webhook", (req, res) => {
+ *   const signature = req.headers["x-tonpay-signature"] as string;
+ *   const payload = JSON.stringify(req.body);
+ *
+ *   if (!verifySignature(payload, signature, YOUR_API_SECRET)) {
+ *     return res.status(401).json({ error: "Invalid signature" });
+ *   }
+ *
+ *   res.status(200).json({ received: true });
+ * });
+ *
+ * // With object (will be stringified automatically)
+ * app.post("/webhook", (req, res) => {
+ *   const signature = req.headers["x-tonpay-signature"] as string;
+ *
+ *   if (!verifySignature(req.body, signature, YOUR_API_SECRET)) {
+ *     return res.status(401).json({ error: "Invalid signature" });
+ *   }
+ *
+ *   res.status(200).json({ received: true });
+ * });
+ * ```
+ */
+declare function verifySignature(payload: string | object, signature: string, apiSecret: string): boolean;
+
+export { type APIOptions, type Chain, type CompletedTonPayTransferInfo, type CreateTonPayTransferParams, type CreateTonPayTransferResponse, type GetTonPayTransferByBodyHashParams, type GetTonPayTransferByReferenceParams, TON, type TransferCompletedWebhookPayload, type TransferRefundedWebhookPayload, USDT, type WebhookEventType, type WebhookPayload, createTonPayTransfer, getTonPayTransferByBodyHash, getTonPayTransferByReference, verifySignature };

package/dist/index.d.ts

@@ -0,0 +1,202 @@
+type Chain = "mainnet" | "testnet";
+
+type APIOptions = {
+    chain?: Chain;
+    apiKey?: string;
+};
+
+/**
+ * @param amount - in human readable format, 10.5 for example
+ * @param asset - jetton master address or TON coin address for TON transfer
+ * @param recipientAddr - recipient wallet address. Optional if API key is provided - defaults to the merchant's wallet address from the admin panel
+ * @param senderAddr - payer wallet address
+ * @param queryId - only for Jetton
+ * @param commentToSender - a comment that will be displayed in the user's wallet when signing a transaction
+ * @param commentToRecipient - a comment that will be displayed in the recipient's wallet when receiving a transaction
+ */
+type CreateTonPayTransferParams = {
+    amount: number;
+    asset: string;
+    recipientAddr?: string;
+    senderAddr: string;
+    queryId?: number;
+    commentToSender?: string;
+    commentToRecipient?: string;
+};
+/**
+ * @param message - a built message that will be sent to the recipient's wallet
+ * @param bodyBase64Hash - a hash of the transaction message content in Base64 format
+ * @param reference - a reference ID for the transaction, used for tracking the transaction
+ */
+type CreateTonPayTransferResponse = {
+    message: {
+        address: string;
+        amount: string;
+        payload: string;
+    };
+    bodyBase64Hash: string;
+    reference: string;
+};
+
+/**
+ * Creates a message for TON Pay transfer
+ * @param params - the parameters for the transfer
+ * @param options - the options for the transfer
+ * @returns the message for the transfer and data for tracking the transfer
+ */
+declare const createTonPayTransfer: (params: CreateTonPayTransferParams, options?: APIOptions) => Promise<CreateTonPayTransferResponse>;
+
+/**
+ * @param amount - the amount of the transfer in human readable format
+ * @param rawAmount - the amount of the transfer in base units
+ * @param senderAddr - the address of the sender wallet
+ * @param recipientAddr - the address of the recipient wallet
+ * @param asset - the address of the asset
+ * @param assetTicker - the ticker of the asset (e.g. "USDT")
+ * @param status - the status of the transfer ("success" or "failed")
+ * @param reference - the reference of the transfer
+ * @param bodyBase64Hash - the hash of the body of the transfer in Base64 format
+ * @param txHash - the hash of the transaction
+ * @param traceId - the id of the trace
+ * @param commentToSender - the comment to the sender wallet
+ * @param commentToRecipient - the comment to the recipient wallet
+ * @param date - the date of the transfer
+ * @param errorCode - the error code of the transfer
+ * @param errorMessage - the error message of the transfer
+ */
+type CompletedTonPayTransferInfo = {
+    amount: string;
+    rawAmount: string;
+    senderAddr: string;
+    recipientAddr: string;
+    asset: string;
+    assetTicker?: string;
+    status: string;
+    reference: string;
+    bodyBase64Hash: string;
+    txHash: string;
+    traceId: string;
+    commentToSender?: string;
+    commentToRecipient?: string;
+    date: string;
+    errorCode?: number;
+    errorMessage?: string;
+};
+
+/**
+ * Gets a TON Pay transfer by reference
+ * @param reference - the reference of the transfer
+ * @param options - the options for the transfer
+ * @returns the transfer information
+ */
+declare const getTonPayTransferByBodyHash: (bodyHash: string, options?: APIOptions) => Promise<CompletedTonPayTransferInfo>;
+
+/**
+ * Gets a TON Pay transfer by reference
+ * @param reference - the reference of the transfer
+ * @param options - the options for the transfer
+ * @returns the transfer information
+ */
+declare const getTonPayTransferByReference: (reference: string, options?: APIOptions) => Promise<CompletedTonPayTransferInfo>;
+
+/**
+ * @param bodyHash - the hash of the transaction message content
+ */
+type GetTonPayTransferByBodyHashParams = {
+    bodyHash: string;
+};
+
+/**
+ * @param reference - the reference of the transfer
+ */
+type GetTonPayTransferByReferenceParams = {
+    reference: string;
+};
+
+/**
+ * Webhook event types
+ *
+ * @remarks
+ * - `transfer.completed` - Transfer completed (check `data.status` for success/failed)
+ * - `transfer.refunded` - Transfer was refunded (Coming Soon)
+ */
+type WebhookEventType = "transfer.completed" | "transfer.refunded";
+
+/**
+ * Base webhook payload structure
+ */
+interface BaseWebhookPayload {
+    event: WebhookEventType;
+    timestamp: string;
+}
+/**
+ * Webhook payload for transfer.completed event
+ *
+ * @remarks
+ * Sent when a transfer is completed on the blockchain.
+ * Check `data.status` field to determine if transfer was "success" or "failed".
+ */
+interface TransferCompletedWebhookPayload extends BaseWebhookPayload {
+    event: "transfer.completed";
+    data: CompletedTonPayTransferInfo;
+}
+/**
+ * Webhook payload for transfer.refunded event
+ *
+ * @remarks
+ * Coming Soon - Sent when a transfer is refunded
+ */
+interface TransferRefundedWebhookPayload extends BaseWebhookPayload {
+    event: "transfer.refunded";
+    data: unknown;
+}
+/**
+ * Union type for all webhook payloads
+ *
+ * @remarks
+ * Currently only transfer.completed is supported.
+ * Additional events will be added in future updates.
+ */
+type WebhookPayload = TransferCompletedWebhookPayload | TransferRefundedWebhookPayload;
+
+declare const USDT = "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs";
+declare const TON = "TON";
+
+/**
+ * Verifies the HMAC-SHA256 signature of a payload
+ * @param payload - Raw JSON string or object to verify
+ * @param signature - The signature from X-TonPay-Signature header
+ * @param apiSecret - Your TON Pay webhook API secret
+ * @returns true if signature is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { verifySignature } from "@ton-pay/api";
+ *
+ * // With raw string
+ * app.post("/webhook", (req, res) => {
+ *   const signature = req.headers["x-tonpay-signature"] as string;
+ *   const payload = JSON.stringify(req.body);
+ *
+ *   if (!verifySignature(payload, signature, YOUR_API_SECRET)) {
+ *     return res.status(401).json({ error: "Invalid signature" });
+ *   }
+ *
+ *   res.status(200).json({ received: true });
+ * });
+ *
+ * // With object (will be stringified automatically)
+ * app.post("/webhook", (req, res) => {
+ *   const signature = req.headers["x-tonpay-signature"] as string;
+ *
+ *   if (!verifySignature(req.body, signature, YOUR_API_SECRET)) {
+ *     return res.status(401).json({ error: "Invalid signature" });
+ *   }
+ *
+ *   res.status(200).json({ received: true });
+ * });
+ * ```
+ */
+declare function verifySignature(payload: string | object, signature: string, apiSecret: string): boolean;
+
+export { type APIOptions, type Chain, type CompletedTonPayTransferInfo, type CreateTonPayTransferParams, type CreateTonPayTransferResponse, type GetTonPayTransferByBodyHashParams, type GetTonPayTransferByReferenceParams, TON, type TransferCompletedWebhookPayload, type TransferRefundedWebhookPayload, USDT, type WebhookEventType, type WebhookPayload, createTonPayTransfer, getTonPayTransferByBodyHash, getTonPayTransferByReference, verifySignature };

package/dist/index.js

@@ -0,0 +1,91 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/common/const.ts
+var BASE_URL = "https://tonpay.tech";
+var TESTNET_BASE_URL = "https://testnet.tonpay.tech";
+
+// src/common/get-base-url.ts
+var getBaseUrl = (chain) => {
+  if (process.env.TONPAY_BASE_URL) {
+    return process.env.TONPAY_BASE_URL;
+  }
+  if (!chain || chain === "mainnet") {
+    return BASE_URL;
+  }
+  return TESTNET_BASE_URL;
+};
+
+// src/create-ton-pay-transfer/create-ton-pay-transfer.ts
+var createTonPayTransfer = async (params, options) => {
+  const baseUrl = getBaseUrl(_optionalChain([options, 'optionalAccess', _ => _.chain]));
+  const headers = {
+    "Content-Type": "application/json",
+    ..._optionalChain([options, 'optionalAccess', _2 => _2.apiKey]) ? { "x-api-key": options.apiKey } : {}
+  };
+  const response = await fetch(`${baseUrl}/api/merchant/v1/create-transfer`, {
+    method: "POST",
+    body: JSON.stringify(params),
+    headers
+  });
+  if (!response.ok) {
+    throw new Error("Failed to create TON Pay transfer", {
+      cause: response.statusText
+    });
+  }
+  return response.json();
+};
+
+// src/get-ton-pay-transfer/get-ton-pay-transfer-by-body-hash.ts
+var getTonPayTransferByBodyHash = async (bodyHash, options) => {
+  const baseUrl = getBaseUrl(_optionalChain([options, 'optionalAccess', _3 => _3.chain]));
+  const response = await fetch(
+    `${baseUrl}/api/merchant/v1/transfer?bodyHash=${bodyHash}`,
+    {
+      method: "GET"
+    }
+  );
+  if (!response.ok) {
+    throw new Error("Failed to get TON Pay transfer by body hash", {
+      cause: response.statusText
+    });
+  }
+  return response.json();
+};
+
+// src/get-ton-pay-transfer/get-ton-pay-transfer-by-reference.ts
+var getTonPayTransferByReference = async (reference, options) => {
+  const baseUrl = getBaseUrl(_optionalChain([options, 'optionalAccess', _4 => _4.chain]));
+  const response = await fetch(
+    `${baseUrl}/api/merchant/v1/transfer?reference=${reference}`,
+    {
+      method: "GET"
+    }
+  );
+  if (!response.ok) {
+    throw new Error("Failed to get TON Pay transfer by reference", {
+      cause: response.statusText
+    });
+  }
+  return response.json();
+};
+
+// src/common/assets.ts
+var USDT = "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs";
+var TON = "TON";
+
+// src/utils/verify-signature.ts
+var _crypto = require('crypto');
+function verifySignature(payload, signature, apiSecret) {
+  const payloadString = typeof payload === "string" ? payload : JSON.stringify(payload);
+  const hmac = _crypto.createHmac.call(void 0, "sha256", apiSecret);
+  hmac.update(payloadString);
+  const expectedSignature = `sha256=${hmac.digest("hex")}`;
+  return signature === expectedSignature;
+}
+
+
+
+
+
+
+
+exports.TON = TON; exports.USDT = USDT; exports.createTonPayTransfer = createTonPayTransfer; exports.getTonPayTransferByBodyHash = getTonPayTransferByBodyHash; exports.getTonPayTransferByReference = getTonPayTransferByReference; exports.verifySignature = verifySignature;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/ilya/work/tpn/ton-pay/packages/api/dist/index.js","../src/common/const.ts","../src/common/get-base-url.ts","../src/create-ton-pay-transfer/create-ton-pay-transfer.ts","../src/get-ton-pay-transfer/get-ton-pay-transfer-by-body-hash.ts","../src/get-ton-pay-transfer/get-ton-pay-transfer-by-reference.ts","../src/common/assets.ts","../src/utils/verify-signature.ts"],"names":[],"mappings":"AAAA;ACAO,IAAM,SAAA,EAAW,qBAAA;AACjB,IAAM,iBAAA,EAAmB,6BAAA;ADEhC;AACA;AEDO,IAAM,WAAA,EAAa,CAAC,KAAA,EAAA,GAAkB;AAE3C,EAAA,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,eAAA,EAAiB;AAC/B,IAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,eAAA;AAAA,EACrB;AACA,EAAA,GAAA,CAAI,CAAC,MAAA,GAAS,MAAA,IAAU,SAAA,EAAW;AACjC,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAO,gBAAA;AACT,CAAA;AFEA;AACA;AGHO,IAAM,qBAAA,EAAuB,MAAA,CAClC,MAAA,EACA,OAAA,EAAA,GAC0C;AAC1C,EAAA,MAAM,QAAA,EAAU,UAAA,iBAAW,OAAA,2BAAS,OAAK,CAAA;AACzC,EAAA,MAAM,QAAA,EAAU;AAAA,IACd,cAAA,EAAgB,kBAAA;AAAA,IAChB,mBAAI,OAAA,6BAAS,SAAA,EAAS,EAAE,WAAA,EAAa,OAAA,CAAQ,OAAO,EAAA,EAAI,CAAC;AAAA,EAC3D,CAAA;AACA,EAAA,MAAM,SAAA,EAAW,MAAM,KAAA,CAAM,CAAA,EAAA;AACnB,IAAA;AACmB,IAAA;AAC3B,IAAA;AACD,EAAA;AACiB,EAAA;AACA,IAAA;AACE,MAAA;AACjB,IAAA;AACH,EAAA;AACqB,EAAA;AACvB;AHEgC;AACA;AIxBnB;AAIgB,EAAA;AACJ,EAAA;AACX,IAAA;AACV,IAAA;AACU,MAAA;AACV,IAAA;AACF,EAAA;AACkB,EAAA;AACA,IAAA;AACE,MAAA;AACjB,IAAA;AACH,EAAA;AACqB,EAAA;AACvB;AJuBgC;AACA;AKzCnB;AAIgB,EAAA;AACJ,EAAA;AACX,IAAA;AACV,IAAA;AACU,MAAA;AACV,IAAA;AACF,EAAA;AACkB,EAAA;AACA,IAAA;AACE,MAAA;AACjB,IAAA;AACH,EAAA;AACqB,EAAA;AACvB;ALwCgC;AACA;AMrEZ;AACD;ANuEa;AACA;AOzEL;AAsCzB;AAKS,EAAA;AAEe,EAAA;AACC,EAAA;AACC,EAAA;AAEL,EAAA;AACvB;APgCgC;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/ilya/work/tpn/ton-pay/packages/api/dist/index.js","sourcesContent":[null,"export const BASE_URL = \"https://tonpay.tech\";\nexport const TESTNET_BASE_URL = \"https://testnet.tonpay.tech\";\n","import type { Chain } from \"../types/chain\";\nimport { BASE_URL, TESTNET_BASE_URL } from \"./const\";\n\nexport const getBaseUrl = (chain?: Chain) => {\n  // only for testing. do not use in production. do not use in docs\n  if (process.env.TONPAY_BASE_URL) {\n    return process.env.TONPAY_BASE_URL;\n  }\n  if (!chain || chain === \"mainnet\") {\n    return BASE_URL;\n  }\n  return TESTNET_BASE_URL;\n};\n","import { getBaseUrl } from \"../common/get-base-url\";\nimport type { APIOptions } from \"../types/api-options\";\nimport type { CreateTonPayTransferParams } from \"../types/create-ton-pay-transfer\";\nimport type { CreateTonPayTransferResponse } from \"../types/create-ton-pay-transfer\";\n\n/**\n * Creates a message for TON Pay transfer\n * @param params - the parameters for the transfer\n * @param options - the options for the transfer\n * @returns the message for the transfer and data for tracking the transfer\n */\n\nexport const createTonPayTransfer = async (\n  params: CreateTonPayTransferParams,\n  options?: APIOptions\n): Promise<CreateTonPayTransferResponse> => {\n  const baseUrl = getBaseUrl(options?.chain);\n  const headers = {\n    \"Content-Type\": \"application/json\",\n    ...(options?.apiKey ? { \"x-api-key\": options.apiKey } : {}),\n  };\n  const response = await fetch(`${baseUrl}/api/merchant/v1/create-transfer`, {\n    method: \"POST\",\n    body: JSON.stringify(params),\n    headers,\n  });\n  if (!response.ok) {\n    throw new Error(\"Failed to create TON Pay transfer\", {\n      cause: response.statusText,\n    });\n  }\n  return response.json();\n};\n","import { getBaseUrl } from \"../common/get-base-url\";\nimport type { APIOptions } from \"../types/api-options\";\nimport type { CompletedTonPayTransferInfo } from \"../types/completed-ton-pay-transfer-info\";\n\n/**\n * Gets a TON Pay transfer by reference\n * @param reference - the reference of the transfer\n * @param options - the options for the transfer\n * @returns the transfer information\n */\n\nexport const getTonPayTransferByBodyHash = async (\n  bodyHash: string,\n  options?: APIOptions\n): Promise<CompletedTonPayTransferInfo> => {\n  const baseUrl = getBaseUrl(options?.chain);\n  const response = await fetch(\n    `${baseUrl}/api/merchant/v1/transfer?bodyHash=${bodyHash}`,\n    {\n      method: \"GET\",\n    }\n  );\n  if (!response.ok) {\n    throw new Error(\"Failed to get TON Pay transfer by body hash\", {\n      cause: response.statusText,\n    });\n  }\n  return response.json();\n};\n","import { getBaseUrl } from \"../common/get-base-url\";\nimport type { APIOptions } from \"../types/api-options\";\nimport type { CompletedTonPayTransferInfo } from \"../types/completed-ton-pay-transfer-info\";\n\n/**\n * Gets a TON Pay transfer by reference\n * @param reference - the reference of the transfer\n * @param options - the options for the transfer\n * @returns the transfer information\n */\n\nexport const getTonPayTransferByReference = async (\n  reference: string,\n  options?: APIOptions\n): Promise<CompletedTonPayTransferInfo> => {\n  const baseUrl = getBaseUrl(options?.chain);\n  const response = await fetch(\n    `${baseUrl}/api/merchant/v1/transfer?reference=${reference}`,\n    {\n      method: \"GET\",\n    }\n  );\n  if (!response.ok) {\n    throw new Error(\"Failed to get TON Pay transfer by reference\", {\n      cause: response.statusText,\n    });\n  }\n  return response.json();\n};\n","export const USDT = \"EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs\";\nexport const TON = \"TON\";\n","import { createHmac } from \"crypto\";\n\n/**\n * Verifies the HMAC-SHA256 signature of a payload\n * @param payload - Raw JSON string or object to verify\n * @param signature - The signature from X-TonPay-Signature header\n * @param apiSecret - Your TON Pay webhook API secret\n * @returns true if signature is valid, false otherwise\n *\n * @example\n * ```typescript\n * import { verifySignature } from \"@ton-pay/api\";\n *\n * // With raw string\n * app.post(\"/webhook\", (req, res) => {\n *   const signature = req.headers[\"x-tonpay-signature\"] as string;\n *   const payload = JSON.stringify(req.body);\n *\n *   if (!verifySignature(payload, signature, YOUR_API_SECRET)) {\n *     return res.status(401).json({ error: \"Invalid signature\" });\n *   }\n *\n *   res.status(200).json({ received: true });\n * });\n *\n * // With object (will be stringified automatically)\n * app.post(\"/webhook\", (req, res) => {\n *   const signature = req.headers[\"x-tonpay-signature\"] as string;\n *\n *   if (!verifySignature(req.body, signature, YOUR_API_SECRET)) {\n *     return res.status(401).json({ error: \"Invalid signature\" });\n *   }\n *\n *   res.status(200).json({ received: true });\n * });\n * ```\n */\nexport function verifySignature(\n  payload: string | object,\n  signature: string,\n  apiSecret: string\n): boolean {\n  const payloadString =\n    typeof payload === \"string\" ? payload : JSON.stringify(payload);\n\n  const hmac = createHmac(\"sha256\", apiSecret);\n  hmac.update(payloadString);\n  const expectedSignature = `sha256=${hmac.digest(\"hex\")}`;\n\n  return signature === expectedSignature;\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,91 @@
+// src/common/const.ts
+var BASE_URL = "https://tonpay.tech";
+var TESTNET_BASE_URL = "https://testnet.tonpay.tech";
+
+// src/common/get-base-url.ts
+var getBaseUrl = (chain) => {
+  if (process.env.TONPAY_BASE_URL) {
+    return process.env.TONPAY_BASE_URL;
+  }
+  if (!chain || chain === "mainnet") {
+    return BASE_URL;
+  }
+  return TESTNET_BASE_URL;
+};
+
+// src/create-ton-pay-transfer/create-ton-pay-transfer.ts
+var createTonPayTransfer = async (params, options) => {
+  const baseUrl = getBaseUrl(options?.chain);
+  const headers = {
+    "Content-Type": "application/json",
+    ...options?.apiKey ? { "x-api-key": options.apiKey } : {}
+  };
+  const response = await fetch(`${baseUrl}/api/merchant/v1/create-transfer`, {
+    method: "POST",
+    body: JSON.stringify(params),
+    headers
+  });
+  if (!response.ok) {
+    throw new Error("Failed to create TON Pay transfer", {
+      cause: response.statusText
+    });
+  }
+  return response.json();
+};
+
+// src/get-ton-pay-transfer/get-ton-pay-transfer-by-body-hash.ts
+var getTonPayTransferByBodyHash = async (bodyHash, options) => {
+  const baseUrl = getBaseUrl(options?.chain);
+  const response = await fetch(
+    `${baseUrl}/api/merchant/v1/transfer?bodyHash=${bodyHash}`,
+    {
+      method: "GET"
+    }
+  );
+  if (!response.ok) {
+    throw new Error("Failed to get TON Pay transfer by body hash", {
+      cause: response.statusText
+    });
+  }
+  return response.json();
+};
+
+// src/get-ton-pay-transfer/get-ton-pay-transfer-by-reference.ts
+var getTonPayTransferByReference = async (reference, options) => {
+  const baseUrl = getBaseUrl(options?.chain);
+  const response = await fetch(
+    `${baseUrl}/api/merchant/v1/transfer?reference=${reference}`,
+    {
+      method: "GET"
+    }
+  );
+  if (!response.ok) {
+    throw new Error("Failed to get TON Pay transfer by reference", {
+      cause: response.statusText
+    });
+  }
+  return response.json();
+};
+
+// src/common/assets.ts
+var USDT = "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs";
+var TON = "TON";
+
+// src/utils/verify-signature.ts
+import { createHmac } from "crypto";
+function verifySignature(payload, signature, apiSecret) {
+  const payloadString = typeof payload === "string" ? payload : JSON.stringify(payload);
+  const hmac = createHmac("sha256", apiSecret);
+  hmac.update(payloadString);
+  const expectedSignature = `sha256=${hmac.digest("hex")}`;
+  return signature === expectedSignature;
+}
+export {
+  TON,
+  USDT,
+  createTonPayTransfer,
+  getTonPayTransferByBodyHash,
+  getTonPayTransferByReference,
+  verifySignature
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/const.ts","../src/common/get-base-url.ts","../src/create-ton-pay-transfer/create-ton-pay-transfer.ts","../src/get-ton-pay-transfer/get-ton-pay-transfer-by-body-hash.ts","../src/get-ton-pay-transfer/get-ton-pay-transfer-by-reference.ts","../src/common/assets.ts","../src/utils/verify-signature.ts"],"sourcesContent":["export const BASE_URL = \"https://tonpay.tech\";\nexport const TESTNET_BASE_URL = \"https://testnet.tonpay.tech\";\n","import type { Chain } from \"../types/chain\";\nimport { BASE_URL, TESTNET_BASE_URL } from \"./const\";\n\nexport const getBaseUrl = (chain?: Chain) => {\n  // only for testing. do not use in production. do not use in docs\n  if (process.env.TONPAY_BASE_URL) {\n    return process.env.TONPAY_BASE_URL;\n  }\n  if (!chain || chain === \"mainnet\") {\n    return BASE_URL;\n  }\n  return TESTNET_BASE_URL;\n};\n","import { getBaseUrl } from \"../common/get-base-url\";\nimport type { APIOptions } from \"../types/api-options\";\nimport type { CreateTonPayTransferParams } from \"../types/create-ton-pay-transfer\";\nimport type { CreateTonPayTransferResponse } from \"../types/create-ton-pay-transfer\";\n\n/**\n * Creates a message for TON Pay transfer\n * @param params - the parameters for the transfer\n * @param options - the options for the transfer\n * @returns the message for the transfer and data for tracking the transfer\n */\n\nexport const createTonPayTransfer = async (\n  params: CreateTonPayTransferParams,\n  options?: APIOptions\n): Promise<CreateTonPayTransferResponse> => {\n  const baseUrl = getBaseUrl(options?.chain);\n  const headers = {\n    \"Content-Type\": \"application/json\",\n    ...(options?.apiKey ? { \"x-api-key\": options.apiKey } : {}),\n  };\n  const response = await fetch(`${baseUrl}/api/merchant/v1/create-transfer`, {\n    method: \"POST\",\n    body: JSON.stringify(params),\n    headers,\n  });\n  if (!response.ok) {\n    throw new Error(\"Failed to create TON Pay transfer\", {\n      cause: response.statusText,\n    });\n  }\n  return response.json();\n};\n","import { getBaseUrl } from \"../common/get-base-url\";\nimport type { APIOptions } from \"../types/api-options\";\nimport type { CompletedTonPayTransferInfo } from \"../types/completed-ton-pay-transfer-info\";\n\n/**\n * Gets a TON Pay transfer by reference\n * @param reference - the reference of the transfer\n * @param options - the options for the transfer\n * @returns the transfer information\n */\n\nexport const getTonPayTransferByBodyHash = async (\n  bodyHash: string,\n  options?: APIOptions\n): Promise<CompletedTonPayTransferInfo> => {\n  const baseUrl = getBaseUrl(options?.chain);\n  const response = await fetch(\n    `${baseUrl}/api/merchant/v1/transfer?bodyHash=${bodyHash}`,\n    {\n      method: \"GET\",\n    }\n  );\n  if (!response.ok) {\n    throw new Error(\"Failed to get TON Pay transfer by body hash\", {\n      cause: response.statusText,\n    });\n  }\n  return response.json();\n};\n","import { getBaseUrl } from \"../common/get-base-url\";\nimport type { APIOptions } from \"../types/api-options\";\nimport type { CompletedTonPayTransferInfo } from \"../types/completed-ton-pay-transfer-info\";\n\n/**\n * Gets a TON Pay transfer by reference\n * @param reference - the reference of the transfer\n * @param options - the options for the transfer\n * @returns the transfer information\n */\n\nexport const getTonPayTransferByReference = async (\n  reference: string,\n  options?: APIOptions\n): Promise<CompletedTonPayTransferInfo> => {\n  const baseUrl = getBaseUrl(options?.chain);\n  const response = await fetch(\n    `${baseUrl}/api/merchant/v1/transfer?reference=${reference}`,\n    {\n      method: \"GET\",\n    }\n  );\n  if (!response.ok) {\n    throw new Error(\"Failed to get TON Pay transfer by reference\", {\n      cause: response.statusText,\n    });\n  }\n  return response.json();\n};\n","export const USDT = \"EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs\";\nexport const TON = \"TON\";\n","import { createHmac } from \"crypto\";\n\n/**\n * Verifies the HMAC-SHA256 signature of a payload\n * @param payload - Raw JSON string or object to verify\n * @param signature - The signature from X-TonPay-Signature header\n * @param apiSecret - Your TON Pay webhook API secret\n * @returns true if signature is valid, false otherwise\n *\n * @example\n * ```typescript\n * import { verifySignature } from \"@ton-pay/api\";\n *\n * // With raw string\n * app.post(\"/webhook\", (req, res) => {\n *   const signature = req.headers[\"x-tonpay-signature\"] as string;\n *   const payload = JSON.stringify(req.body);\n *\n *   if (!verifySignature(payload, signature, YOUR_API_SECRET)) {\n *     return res.status(401).json({ error: \"Invalid signature\" });\n *   }\n *\n *   res.status(200).json({ received: true });\n * });\n *\n * // With object (will be stringified automatically)\n * app.post(\"/webhook\", (req, res) => {\n *   const signature = req.headers[\"x-tonpay-signature\"] as string;\n *\n *   if (!verifySignature(req.body, signature, YOUR_API_SECRET)) {\n *     return res.status(401).json({ error: \"Invalid signature\" });\n *   }\n *\n *   res.status(200).json({ received: true });\n * });\n * ```\n */\nexport function verifySignature(\n  payload: string | object,\n  signature: string,\n  apiSecret: string\n): boolean {\n  const payloadString =\n    typeof payload === \"string\" ? payload : JSON.stringify(payload);\n\n  const hmac = createHmac(\"sha256\", apiSecret);\n  hmac.update(payloadString);\n  const expectedSignature = `sha256=${hmac.digest(\"hex\")}`;\n\n  return signature === expectedSignature;\n}\n"],"mappings":";AAAO,IAAM,WAAW;AACjB,IAAM,mBAAmB;;;ACEzB,IAAM,aAAa,CAAC,UAAkB;AAE3C,MAAI,QAAQ,IAAI,iBAAiB;AAC/B,WAAO,QAAQ,IAAI;AAAA,EACrB;AACA,MAAI,CAAC,SAAS,UAAU,WAAW;AACjC,WAAO;AAAA,EACT;AACA,SAAO;AACT;;;ACAO,IAAM,uBAAuB,OAClC,QACA,YAC0C;AAC1C,QAAM,UAAU,WAAW,SAAS,KAAK;AACzC,QAAM,UAAU;AAAA,IACd,gBAAgB;AAAA,IAChB,GAAI,SAAS,SAAS,EAAE,aAAa,QAAQ,OAAO,IAAI,CAAC;AAAA,EAC3D;AACA,QAAM,WAAW,MAAM,MAAM,GAAG,OAAO,oCAAoC;AAAA,IACzE,QAAQ;AAAA,IACR,MAAM,KAAK,UAAU,MAAM;AAAA,IAC3B;AAAA,EACF,CAAC;AACD,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,qCAAqC;AAAA,MACnD,OAAO,SAAS;AAAA,IAClB,CAAC;AAAA,EACH;AACA,SAAO,SAAS,KAAK;AACvB;;;ACrBO,IAAM,8BAA8B,OACzC,UACA,YACyC;AACzC,QAAM,UAAU,WAAW,SAAS,KAAK;AACzC,QAAM,WAAW,MAAM;AAAA,IACrB,GAAG,OAAO,sCAAsC,QAAQ;AAAA,IACxD;AAAA,MACE,QAAQ;AAAA,IACV;AAAA,EACF;AACA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,+CAA+C;AAAA,MAC7D,OAAO,SAAS;AAAA,IAClB,CAAC;AAAA,EACH;AACA,SAAO,SAAS,KAAK;AACvB;;;ACjBO,IAAM,+BAA+B,OAC1C,WACA,YACyC;AACzC,QAAM,UAAU,WAAW,SAAS,KAAK;AACzC,QAAM,WAAW,MAAM;AAAA,IACrB,GAAG,OAAO,uCAAuC,SAAS;AAAA,IAC1D;AAAA,MACE,QAAQ;AAAA,IACV;AAAA,EACF;AACA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,+CAA+C;AAAA,MAC7D,OAAO,SAAS;AAAA,IAClB,CAAC;AAAA,EACH;AACA,SAAO,SAAS,KAAK;AACvB;;;AC5BO,IAAM,OAAO;AACb,IAAM,MAAM;;;ACDnB,SAAS,kBAAkB;AAqCpB,SAAS,gBACd,SACA,WACA,WACS;AACT,QAAM,gBACJ,OAAO,YAAY,WAAW,UAAU,KAAK,UAAU,OAAO;AAEhE,QAAM,OAAO,WAAW,UAAU,SAAS;AAC3C,OAAK,OAAO,aAAa;AACzB,QAAM,oBAAoB,UAAU,KAAK,OAAO,KAAK,CAAC;AAEtD,SAAO,cAAc;AACvB;","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ton-pay/api",
+  "version": "0.1.0",
+  "description": "API functions for TonPay SDK",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "tsup": {
+    "entry": [
+      "src/index.ts"
+    ],
+    "format": [
+      "cjs",
+      "esm"
+    ],
+    "dts": true,
+    "splitting": true,
+    "sourcemap": true,
+    "clean": true
+  },
+  "dependencies": {},
+  "peerDependencies": {},
+  "keywords": [
+    "ton",
+    "tonpay",
+    "blockchain",
+    "transfer",
+    "api"
+  ],
+  "author": "RSquad Blockchain Lab",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RSquad/ton-pay.git",
+    "directory": "packages/api"
+  },
+  "homepage": "https://docs.tonpay.tech",
+  "bugs": {
+    "url": "https://github.com/RSquad/ton-pay/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}