@guiie/buda-mcp 1.4.2 → 1.5.1

package/src/types.ts

@@ -145,3 +145,213 @@ export interface OhlcvCandle {
   volume: number;
   trade_count: number;
 }
+
+// ----- Pagination -----
+
+export interface PaginationMeta {
+  current_page: number;
+  total_count: number;
+  total_pages: number;
+}
+
+// ----- Account (private) -----
+
+export interface MeResponse {
+  me: {
+    id: number;
+    email: string;
+    name: string | null;
+    monthly_transacted: Amount;
+    pubsub_key: string | null;
+  };
+}
+
+// ----- Single Balance (private) -----
+
+export interface SingleBalanceResponse {
+  balance: Balance;
+}
+
+// ----- Network Fees (private) -----
+
+export interface Fee {
+  name: string;
+  fee_type: string;
+  base_fee: Amount;
+  percent: string | null;
+}
+
+export interface FeesResponse {
+  fees: Fee[];
+}
+
+// ----- Deposits (private) -----
+
+export interface Deposit {
+  id: number;
+  state: string;
+  currency: string;
+  amount: Amount;
+  fee: Amount;
+  created_at: string;
+  updated_at: string;
+  transfer_account_id: number | null;
+  transaction_hash: string | null;
+}
+
+export interface DepositsResponse {
+  deposits: Deposit[];
+  meta: PaginationMeta;
+}
+
+export interface SingleDepositResponse {
+  deposit: Deposit;
+}
+
+// ----- Withdrawals (private) -----
+
+export interface Withdrawal {
+  id: number;
+  state: string;
+  currency: string;
+  amount: Amount;
+  fee: Amount;
+  address: string | null;
+  tx_hash: string | null;
+  bank_account_id: number | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface WithdrawalsResponse {
+  withdrawals: Withdrawal[];
+  meta: PaginationMeta;
+}
+
+export interface SingleWithdrawalResponse {
+  withdrawal: Withdrawal;
+}
+
+// ----- Receive Addresses (private) -----
+
+export interface ReceiveAddress {
+  id: number;
+  address: string;
+  currency: string;
+  created_at: string;
+  label: string | null;
+}
+
+export interface ReceiveAddressesResponse {
+  receive_addresses: ReceiveAddress[];
+}
+
+export interface SingleReceiveAddressResponse {
+  receive_address: ReceiveAddress;
+}
+
+// ----- Remittances (private) -----
+
+export interface Remittance {
+  id: number;
+  state: string;
+  currency: string;
+  amount: Amount;
+  recipient_id: number | null;
+  created_at: string;
+  expires_at: string | null;
+}
+
+export interface RemittancesResponse {
+  remittances: Remittance[];
+  meta: PaginationMeta;
+}
+
+export interface SingleRemittanceResponse {
+  remittance: Remittance;
+}
+
+// ----- Remittance Recipients (private) -----
+
+export interface RemittanceRecipient {
+  id: number;
+  name: string;
+  bank: string;
+  account_number: string;
+  currency: string;
+  country: string | null;
+}
+
+export interface RemittanceRecipientsResponse {
+  remittance_recipients: RemittanceRecipient[];
+  meta: PaginationMeta;
+}
+
+export interface SingleRemittanceRecipientResponse {
+  remittance_recipient: RemittanceRecipient;
+}
+
+// ----- Quotations (public) -----
+
+export interface Quotation {
+  id: number | null;
+  type: string;
+  market_id: string;
+  amount: Amount;
+  limit: Amount | null;
+  base_balance_change: Amount;
+  quote_balance_change: Amount;
+  fee_amount: Amount;
+  order_amount: Amount;
+}
+
+export interface QuotationResponse {
+  quotation: Quotation;
+}
+
+// ----- Banks (public) -----
+
+export interface Bank {
+  id: string;
+  name: string;
+  country: string | null;
+}
+
+export interface BanksResponse {
+  banks: Bank[];
+}
+
+// ----- Cancel All Orders (private) -----
+
+export interface CancelAllOrdersResponse {
+  canceled_count: number;
+}
+
+// ----- Lightning (private) -----
+
+export interface LightningWithdrawal {
+  id: number;
+  state: string;
+  amount: Amount;
+  fee: Amount;
+  payment_hash: string;
+  created_at: string;
+}
+
+export interface LightningWithdrawalResponse {
+  lightning_withdrawal: LightningWithdrawal;
+}
+
+export interface LightningInvoice {
+  id: number;
+  payment_request: string;
+  amount: Amount;
+  description: string | null;
+  expires_at: string;
+  state: string;
+  created_at: string;
+}
+
+export interface LightningInvoiceResponse {
+  lightning_network_invoice: LightningInvoice;
+}

package/src/utils.ts

@@ -5,7 +5,9 @@ import type { Amount, OhlcvCandle } from "./types.js";
  * All numeric strings are cast to float via parseFloat.
  */
 export function flattenAmount(amount: Amount): { value: number; currency: string } {
-  return { value: parseFloat(amount[0]), currency: amount[1] };
+  const value = parseFloat(amount[0]);
+  if (isNaN(value)) throw new Error(`Invalid amount value: "${amount[0]}"`);
+  return { value, currency: amount[1] };
 }
 
 /**

package/src/validation.ts

@@ -14,3 +14,48 @@ export function validateMarketId(id: string): string | null {
   }
   return null;
 }
+
+const CURRENCY_RE = /^[A-Z0-9]{2,10}$/i;
+
+/**
+ * Validates a currency code (e.g. "BTC", "CLP", "USDC").
+ * Returns an error message string if invalid, or null if valid.
+ */
+export function validateCurrency(id: string): string | null {
+  if (!CURRENCY_RE.test(id)) {
+    return (
+      `Invalid currency "${id}". ` +
+      `Expected 2–10 alphanumeric characters (e.g. "BTC", "CLP", "USDC").`
+    );
+  }
+  return null;
+}
+
+// Per-currency address format rules.
+// Unknown currencies pass through (undefined rule) — the exchange validates those.
+const ADDRESS_RULES: Record<string, RegExp> = {
+  BTC:  /^(bc1[a-z0-9]{6,87}|[13][a-zA-HJ-NP-Z0-9]{25,34})$/,
+  ETH:  /^0x[0-9a-fA-F]{40}$/,
+  USDC: /^0x[0-9a-fA-F]{40}$/,
+  USDT: /^0x[0-9a-fA-F]{40}$/,
+  LTC:  /^(ltc1[a-z0-9]{6,87}|[LM3][a-zA-HJ-NP-Z0-9]{25,34})$/,
+  BCH:  /^(bitcoincash:)?[qp][a-z0-9]{41}$/,
+  XRP:  /^r[1-9A-HJ-NP-Za-km-z]{24,33}$/,
+};
+
+/**
+ * Validates a crypto withdrawal address against known per-currency formats.
+ * Returns an error message string if the address is invalid, or null if valid
+ * (including null for unknown currencies, where the exchange is the last line of defence).
+ */
+export function validateCryptoAddress(address: string, currency: string): string | null {
+  const rule = ADDRESS_RULES[currency.toUpperCase()];
+  if (!rule) return null;
+  if (!rule.test(address)) {
+    return (
+      `Invalid ${currency.toUpperCase()} address format. ` +
+      `Double-check the destination address — crypto withdrawals are irreversible.`
+    );
+  }
+  return null;
+}

package/src/version.ts

@@ -3,6 +3,14 @@ import { fileURLToPath } from "url";
 import { dirname, join } from "path";
 
 const _dir = dirname(fileURLToPath(import.meta.url));
-export const VERSION: string = (
-  JSON.parse(readFileSync(join(_dir, "../package.json"), "utf8")) as { version: string }
-).version;
+
+let _version = "unknown";
+try {
+  _version = (
+    JSON.parse(readFileSync(join(_dir, "../package.json"), "utf8")) as { version: string }
+  ).version;
+} catch {
+  // package.json not found in deployment — use fallback
+}
+
+export const VERSION: string = _version;

package/test/run-all.ts

@@ -3,9 +3,25 @@
  * and prints a summary of the results.
  *
  * Run with: npm run test:integration
+ * Auth tools (balances, orders, DMS) are tested automatically if a .env file with
+ * BUDA_API_KEY and BUDA_API_SECRET exists in the project root (already in .gitignore).
  * Skipped automatically when the Buda API is unreachable (CI without network).
  */
 
+// Load .env if present (never committed — see .gitignore)
+import { existsSync, readFileSync } from "fs";
+if (existsSync(".env")) {
+  for (const line of readFileSync(".env", "utf8").split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    const val = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
+    if (key && !(key in process.env)) process.env[key] = val;
+  }
+}
+
 // Connectivity pre-check — skip gracefully instead of failing CI when the API is unreachable.
 try {
   await fetch("https://www.buda.com/api/v2/markets.json", {