payment-skill 1.0.0

package/src/api/bunq.ts

@@ -0,0 +1,257 @@
+/**
+ * Payment Skill - Bunq API Client
+ * 
+ * Handles all Bunq API interactions
+ */
+
+import axios, { AxiosInstance } from 'axios';
+import { BunqConfig } from '../types';
+
+export class BunqClient {
+  private client: AxiosInstance;
+  private config: BunqConfig;
+  private baseURL: string;
+
+  constructor(config: BunqConfig) {
+    this.config = config;
+    this.baseURL = 'https://api.bunq.com/v1';
+    
+    this.client = axios.create({
+      baseURL: this.baseURL,
+      headers: {
+        'X-Bunq-Client-Request-Id': this.generateRequestId(),
+        'X-Bunq-Geolocation': '0 0 0 0 NL',
+        'X-Bunq-Language': 'en_US',
+        'X-Bunq-Region': 'en_US',
+        'Content-Type': 'application/json'
+      }
+    });
+
+    // Add API key to requests
+    this.client.interceptors.request.use((config) => {
+      config.headers['X-Bunq-Client-Authentication'] = this.config.apiKey;
+      return config;
+    });
+  }
+
+  private generateRequestId(): string {
+    return `${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+  }
+
+  // User Management
+  async getUser(userId: string) {
+    const response = await this.client.get(`/user/${userId}`);
+    return response.data;
+  }
+
+  // Monetary Accounts
+  async getMonetaryAccounts(userId: string) {
+    const response = await this.client.get(`/user/${userId}/monetary-account`);
+    return response.data;
+  }
+
+  async getMonetaryAccount(userId: string, accountId: string) {
+    const response = await this.client.get(`/user/${userId}/monetary-account/${accountId}`);
+    return response.data;
+  }
+
+  async getAccountBalance(userId: string, accountId: string) {
+    const response = await this.client.get(`/user/${userId}/monetary-account/${accountId}`);
+    return response.data;
+  }
+
+  // Payments
+  async createPayment(
+    userId: string,
+    accountId: string,
+    amount: string,
+    currency: string,
+    counterpartyIban: string,
+    counterpartyName: string,
+    description: string
+  ) {
+    const response = await this.client.post(
+      `/user/${userId}/monetary-account/${accountId}/payment`,
+      {
+        amount: {
+          value: amount,
+          currency: currency
+        },
+        counterparty_alias: {
+          type: 'IBAN',
+          value: counterpartyIban,
+          name: counterpartyName
+        },
+        description: description
+      }
+    );
+    return response.data;
+  }
+
+  async getPayments(userId: string, accountId: string, limit: number = 100) {
+    const response = await this.client.get(
+      `/user/${userId}/monetary-account/${accountId}/payment?count=${limit}`
+    );
+    return response.data;
+  }
+
+  async getPayment(userId: string, accountId: string, paymentId: string) {
+    const response = await this.client.get(
+      `/user/${userId}/monetary-account/${accountId}/payment/${paymentId}`
+    );
+    return response.data;
+  }
+
+  // Request Inquiries (Payment Requests)
+  async createRequestInquiry(
+    userId: string,
+    accountId: string,
+    amount: string,
+    currency: string,
+    counterpartyAlias: any,
+    description: string,
+    allowBunqme: boolean = false
+  ) {
+    const response = await this.client.post(
+      `/user/${userId}/monetary-account/${accountId}/request-inquiry`,
+      {
+        amount_inquired: {
+          value: amount,
+          currency: currency
+        },
+        counterparty_alias: counterpartyAlias,
+        description: description,
+        allow_bunqme: allowBunqme
+      }
+    );
+    return response.data;
+  }
+
+  async getRequestInquiries(userId: string, accountId: string) {
+    const response = await this.client.get(
+      `/user/${userId}/monetary-account/${accountId}/request-inquiry`
+    );
+    return response.data;
+  }
+
+  async getRequestInquiry(userId: string, accountId: string, inquiryId: string) {
+    const response = await this.client.get(
+      `/user/${userId}/monetary-account/${accountId}/request-inquiry/${inquiryId}`
+    );
+    return response.data;
+  }
+
+  async cancelRequestInquiry(userId: string, accountId: string, inquiryId: string) {
+    const response = await this.client.put(
+      `/user/${userId}/monetary-account/${accountId}/request-inquiry/${inquiryId}`,
+      { status: 'CANCELLED' }
+    );
+    return response.data;
+  }
+
+  // Draft Payments
+  async createDraftPayment(
+    userId: string,
+    accountId: string,
+    payments: any[]
+  ) {
+    const response = await this.client.post(
+      `/user/${userId}/monetary-account/${accountId}/draft-payment`,
+      { payments }
+    );
+    return response.data;
+  }
+
+  async getDraftPayments(userId: string, accountId: string) {
+    const response = await this.client.get(
+      `/user/${userId}/monetary-account/${accountId}/draft-payment`
+    );
+    return response.data;
+  }
+
+  async deleteDraftPayment(userId: string, accountId: string, draftId: string) {
+    const response = await this.client.delete(
+      `/user/${userId}/monetary-account/${accountId}/draft-payment/${draftId}`
+    );
+    return response.data;
+  }
+
+  // Counterparties
+  async createCounterparty(
+    userId: string,
+    name: string,
+    type: string,
+    value: string
+  ) {
+    const response = await this.client.post(`/user/${userId}/counterparty`, {
+      name,
+      alias: {
+        type,
+        value,
+        name
+      }
+    });
+    return response.data;
+  }
+
+  async getCounterparties(userId: string) {
+    const response = await this.client.get(`/user/${userId}/counterparty`);
+    return response.data;
+  }
+
+  // Schedules (Recurring Payments)
+  async createSchedule(
+    userId: string,
+    accountId: string,
+    payment: any,
+    schedule: any
+  ) {
+    const response = await this.client.post(
+      `/user/${userId}/monetary-account/${accountId}/schedule`,
+      {
+        payment,
+        schedule
+      }
+    );
+    return response.data;
+  }
+
+  async getSchedules(userId: string, accountId: string) {
+    const response = await this.client.get(
+      `/user/${userId}/monetary-account/${accountId}/schedule`
+    );
+    return response.data;
+  }
+
+  async deleteSchedule(userId: string, accountId: string, scheduleId: string) {
+    const response = await this.client.delete(
+      `/user/${userId}/monetary-account/${accountId}/schedule/${scheduleId}`
+    );
+    return response.data;
+  }
+
+  // Cards
+  async getCards(userId: string) {
+    const response = await this.client.get(`/user/${userId}/card`);
+    return response.data;
+  }
+
+  // Export
+  async exportStatement(
+    userId: string,
+    accountId: string,
+    dateStart: string,
+    dateEnd: string,
+    format: 'CSV' | 'PDF' | 'MT940' = 'CSV'
+  ) {
+    const response = await this.client.post(
+      `/user/${userId}/monetary-account/${accountId}/export-statement`,
+      {
+        date_start: dateStart,
+        date_end: dateEnd,
+        regional_format: format
+      }
+    );
+    return response.data;
+  }
+}

package/src/api/wise.ts

@@ -0,0 +1,204 @@
+/**
+ * Payment Skill - Wise API Client
+ * 
+ * Handles all Wise API interactions
+ */
+
+import axios, { AxiosInstance } from 'axios';
+import { WiseConfig } from '../types';
+
+export class WiseClient {
+  private client: AxiosInstance;
+  private config: WiseConfig;
+
+  constructor(config: WiseConfig) {
+    this.config = config;
+    const baseURL = config.environment === 'production' 
+      ? 'https://api.wise.com' 
+      : 'https://api.sandbox.transferwise.tech';
+    
+    this.client = axios.create({
+      baseURL,
+      headers: {
+        'Authorization': `Bearer ${config.apiKey}`,
+        'Content-Type': 'application/json'
+      }
+    });
+  }
+
+  // Profile Management
+  async getProfiles() {
+    const response = await this.client.get('/v2/profiles');
+    return response.data;
+  }
+
+  async getProfile(profileId: string) {
+    const response = await this.client.get(`/v2/profiles/${profileId}`);
+    return response.data;
+  }
+
+  // Balance Management
+  async getBalances(profileId: string) {
+    const response = await this.client.get(`/v4/profiles/${profileId}/balances`);
+    return response.data;
+  }
+
+  async getBalance(profileId: string, balanceId: string) {
+    const response = await this.client.get(`/v4/profiles/${profileId}/balances/${balanceId}`);
+    return response.data;
+  }
+
+  // Quote Management
+  async createQuote(
+    profileId: string,
+    sourceCurrency: string,
+    targetCurrency: string,
+    sourceAmount?: number,
+    targetAmount?: number
+  ) {
+    const body: any = {
+      sourceCurrency,
+      targetCurrency
+    };
+    
+    if (sourceAmount) {
+      body.sourceAmount = sourceAmount;
+    } else if (targetAmount) {
+      body.targetAmount = targetAmount;
+    }
+
+    const response = await this.client.post(`/v3/profiles/${profileId}/quotes`, body);
+    return response.data;
+  }
+
+  async getQuote(profileId: string, quoteId: string) {
+    const response = await this.client.get(`/v3/profiles/${profileId}/quotes/${quoteId}`);
+    return response.data;
+  }
+
+  // Recipient Management
+  async createRecipient(
+    profileId: string,
+    currency: string,
+    accountHolderName: string,
+    details: any
+  ) {
+    const response = await this.client.post(`/v1/accounts`, {
+      profile: profileId,
+      currency,
+      type: 'iban',
+      accountHolderName,
+      details
+    });
+    return response.data;
+  }
+
+  async getRecipients(profileId: string) {
+    const response = await this.client.get(`/v1/accounts?profile=${profileId}`);
+    return response.data;
+  }
+
+  async getRecipient(accountId: string) {
+    const response = await this.client.get(`/v1/accounts/${accountId}`);
+    return response.data;
+  }
+
+  async deleteRecipient(accountId: string) {
+    const response = await this.client.delete(`/v1/accounts/${accountId}`);
+    return response.data;
+  }
+
+  // Transfer Management
+  async createTransfer(
+    profileId: string,
+    quoteId: string,
+    targetAccountId: string,
+    reference?: string
+  ) {
+    const body: any = {
+      targetAccount: targetAccountId,
+      quoteUuid: quoteId
+    };
+    
+    if (reference) {
+      body.reference = reference;
+    }
+
+    const response = await this.client.post(`/v1/transfers`, body);
+    return response.data;
+  }
+
+  async getTransfer(transferId: string) {
+    const response = await this.client.get(`/v1/transfers/${transferId}`);
+    return response.data;
+  }
+
+  async cancelTransfer(transferId: string) {
+    const response = await this.client.put(`/v1/transfers/${transferId}/cancel`);
+    return response.data;
+  }
+
+  async getTransfers(profileId: string, status?: string, limit: number = 100) {
+    const params: any = { profile: profileId, limit };
+    if (status) {
+      params.status = status;
+    }
+    const response = await this.client.get(`/v1/transfers`, { params });
+    return response.data;
+  }
+
+  // Transfer Requirements
+  async getTransferRequirements(
+    profileId: string,
+    quoteId: string,
+    targetAccountId: string
+  ) {
+    const response = await this.client.post(`/v1/transfer-requirements`, {
+      targetAccount: targetAccountId,
+      quoteUuid: quoteId
+    });
+    return response.data;
+  }
+
+  // Fund Transfer
+  async fundTransfer(profileId: string, transferId: string) {
+    const response = await this.client.post(
+      `/v3/profiles/${profileId}/transfers/${transferId}/payments`,
+      { type: 'BALANCE' }
+    );
+    return response.data;
+  }
+
+  // Bank Account Details
+  async getBankAccountDetails(profileId: string, balanceId: string) {
+    const response = await this.client.get(
+      `/v4/profiles/${profileId}/balances/${balanceId}/bank-details`
+    );
+    return response.data;
+  }
+
+  // Webhook Management
+  async createWebhook(profileId: string, name: string, triggerOn: string[], url: string) {
+    const response = await this.client.post(`/v3/profiles/${profileId}/subscriptions`, {
+      name,
+      triggerOn,
+      delivery: {
+        version: '2.0.0',
+        url
+      }
+    });
+    return response.data;
+  }
+
+  async getWebhooks(profileId: string) {
+    const response = await this.client.get(`/v3/profiles/${profileId}/subscriptions`);
+    return response.data;
+  }
+
+  async deleteWebhook(profileId: string, subscriptionId: string) {
+    const response = await this.client.delete(
+      `/v3/profiles/${profileId}/subscriptions/${subscriptionId}`
+    );
+    return response.data;
+  }
+}

package/src/cli.ts

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+/**
+ * Payment Skill CLI
+ * 
+ * Main entry point for the payment-skill command line interface
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { configCommands } from './commands/config';
+import { providerCommands } from './commands/provider';
+import { wiseCommands } from './commands/wise';
+import { bunqCommands } from './commands/bunq';
+import { transactionCommands } from './commands/transaction';
+import { merchantCommands } from './commands/merchant';
+import { limitCommands } from './commands/limits';
+import { emergencyCommands } from './commands/emergency';
+import { serverCommands } from './commands/server';
+import { templateCommands } from './commands/template';
+import { payCommand } from './commands/pay';
+
+const program = new Command();
+
+program
+  .name('payment-skill')
+  .description('Self-hosted payment orchestration for OpenClaw')
+  .version('1.0.0')
+  .option('-v, --verbose', 'Enable verbose output')
+  .option('-j, --json', 'Output in JSON format')
+  .option('-c, --config <path>', 'Path to config file')
+  .option('--dry-run', 'Simulate without executing')
+  .hook('preAction', (thisCommand) => {
+    const options = thisCommand.opts();
+    if (options.verbose) {
+      console.log(chalk.gray('Verbose mode enabled'));
+    }
+  });
+
+// Add command groups
+program.addCommand(configCommands);
+program.addCommand(providerCommands);
+program.addCommand(wiseCommands);
+program.addCommand(bunqCommands);
+program.addCommand(transactionCommands);
+program.addCommand(merchantCommands);
+program.addCommand(limitCommands);
+program.addCommand(emergencyCommands);
+program.addCommand(serverCommands);
+program.addCommand(templateCommands);
+program.addCommand(payCommand);
+
+// Global error handler
+program.exitOverride();
+
+try {
+  program.parse();
+} catch (error: any) {
+  if (error.code === 'commander.help') {
+    process.exit(0);
+  } else if (error.code === 'commander.version') {
+    process.exit(0);
+  } else {
+    console.error(chalk.red('Error:'), error.message);
+    process.exit(1);
+  }
+}