The Minmo Console is a Next.js web application that provides role-based access to the Minmo platform. Users authenticate through the Hexclave-backed Minmo auth app and receive customized dashboards and features based on their assigned roles.
MINMO_ADMIN - Platform AdministratorsPlatform administrators have complete system access with the following features:
Platform Analytics : Cross-platform metrics, user activity, and system healthSystem Monitoring : Real-time platform status, performance metrics, and alertsGlobal Financial Overview : Platform-wide liquidity, transaction volumes, and revenue
All Users : View, edit, and manage all platform usersRole Assignment : Grant and revoke user roles across the platformAccount Management : User activation, deactivation, and account recoveryPartner Management : Create, configure, and manage partner organizations
Platform Configuration : System settings, feature flags, and global parametersSecurity Management : Access controls, audit logs, and security policiesAPI Management : Platform-wide API key oversight and managementIntegration Management : System integrations and external service configurations
Cross-Partner Analytics : Comprehensive reporting across all partners and agentsSystem Performance : Platform efficiency, uptime, and optimization metricsFinancial Reporting : Revenue, costs, and profitability analysisAudit & Compliance : Security logs, compliance reports, and regulatory data
All Agents : View and manage agents across all partner networksAll Transactions : Monitor, approve, and manage platform-wide transactionsLiquidity Management : Global liquidity pools and distributionRisk Management : Fraud detection, risk assessment, and mitigation
TEAM_MEMBER - Partner OrganizationsPartners have tenant-level access to manage their agent networks and services:
Network Overview : Agent status, connectivity, and network health metricsQuick Actions : Invite agents, create services, generate API keysRecent Activity : Latest transactions, new agents, and system updatesPerformance Metrics : Network volume trends, success rates, and efficiency
Agent List : View all agents within partner organizationAgent Invitation : Email-based agent invitation system with onboardingAgent Monitoring : Real-time agent status, connectivity, and performanceAgent Analytics : Individual and network performance metrics
Service Creation : Configure services and integrationsService Monitoring : Health, usage, and performance tracking for partner servicesIntegration Hub : Available integration types and configuration wizardsTesting Environment : Sandbox for testing integrations before deployment
Partner-Scoped Keys : Create and manage API keys for partner organizationUsage Analytics : Detailed API consumption and performance metricsSecurity Controls : IP restrictions, rate limiting, and key rotationDocumentation Access : Partner-specific API guides and examples
Network Metrics : Transaction volumes, patterns, and forecastingAgent Performance : Comparative analysis and optimization recommendationsFinancial Analytics : Revenue, costs, and profitability for partner networkCustom Reports : Exportable data for business intelligence
Partner Transactions : View all transactions within partner networkTransaction Creation : Create transactions for managed agentsTransaction Monitoring : Real-time status and performance trackingHistorical Data : Transaction history and trend analysis
├── Dashboard (Platform Overview)
├── Users (All Users)
├── OTC
│ ├── Agents (All Agents)
│ ├── Swaps (Platform-wide)
│ └── Rates (Rates and rate-source visibility)
├── Access (Partners, Services and API Key management)
├── Documentation (Interactive Docs)
├── Analytics (System Wide)
├── Settings (System Config)
├── Security & Audit
└── Support Dashboard & Tools
Copy ├── Dashboard (Network Overview)
├── OTC
│ ├── Agents (Partner Network)
│ ├── Swaps (Partner Scope)
│ └── Rates (Rates with rate-source visibility)
├── Access (Services and API Key management)
├── Documentation (Interactive Docs)
├── Analytics (Network Data)
├── Settings (Partner Profile)
└── Support
Copy
Hexclave Integration : Secure hosted authentication with Minmo app-local tokensRole-Based Access : Features and navigation adapt based on user roleData Isolation : Partners see only their network dataAPI Key Management : Role-appropriate API key creation and managementAudit Logging : All user actions logged with proper context and permissions
# Install dependencies
npm install
# Run development server
npm run dev
# Open browser to http://localhost:3000
Copy Ensure the following environment variables are configured:
NEXT_PUBLIC_API_URL=http://localhost:3001
AUTH_URL=http://localhost:3002
Copy
User navigates to console application
Redirected to the Minmo auth app for hosted authentication
Upon successful login, the console exchanges a handoff code for app-local tokens
Console application reads roles and configures appropriate interface
User sees role-specific dashboard and features
Framework : Next.js 14 with App RouterAuthentication : Hexclave-backed hosted auth with Minmo app-local tokensState Management : React Query for server state, Zustand for client stateUI Components : Custom component library with Tailwind CSSAPI Integration : RESTful API with role-based endpoint accessSecurity : Role-based rendering, permission checks, and data scoping
When developing console features:
Role Awareness : Always consider which roles should access each featureData Scoping : Ensure data is properly filtered based on user contextPermission Checks : Implement both frontend and backend permission validationUser Experience : Design intuitive interfaces that adapt to user capabilitiesSecurity : Follow security best practices for authentication and authorization