waiaas

Instructions

Implementation Reference

• packages/mcp/src/tools/list-transactions.ts:10-31 (registration)

  The tool registration and implementation for `list_transactions`. It defines the input schema and calls the `apiClient` to fetch transactions.

  export function registerListTransactions(server: McpServer, apiClient: ApiClient, walletContext?: WalletContext): void {
    server.tool(
      'list_transactions',
      withWalletPrefix('List transaction history with cursor-based pagination.', walletContext?.walletName),
      {
        limit: z.number().optional().describe('Maximum number of transactions to return'),
        cursor: z.string().optional().describe('Pagination cursor from previous response'),
        display_currency: z.string().optional().describe('Display currency for amount conversion (e.g. KRW, EUR). Defaults to server setting.'),
        wallet_id: z.string().optional().describe('Target wallet ID. Required for multi-wallet sessions; auto-resolved when session has a single wallet.'),
      },
      async (args) => {
        const params = new URLSearchParams();
        if (args.limit !== undefined) params.set('limit', String(args.limit));
        if (args.cursor !== undefined) params.set('cursor', args.cursor);
        if (args.display_currency !== undefined) params.set('display_currency', args.display_currency);
        if (args.wallet_id) params.set('walletId', args.wallet_id);
        const qs = params.toString();
        const result = await apiClient.get(`/v1/transactions${qs ? `?${qs}` : ''}`);
        return toToolResult(result);
      },
    );
  }