Bhindi Financial Intent Audit System

A Next.js application that provides blockchain-based auditing for AI agent financial intents through integration with Bhindi.io. This system creates an immutable audit trail for financial decisions made by autonomous AI agents.

Features

• Bhindi Agent Integration: Full compliance with Bhindi agent development specifications
• Blockchain Audit Trail: Immutable logging of financial intents on Base network
• Real-time Monitoring: Dashboard for tracking agent activities and status
• Data Integrity Verification: Cryptographic verification of logged intents
• Financial Intent Recognition: Structured parsing and categorization of financial actions

Bhindi Agent Endpoints

The application implements the required Bhindi agent endpoints:

GET /api/tools

Returns available tools for financial intent logging and auditing.

POST /api/tools/:toolName

Executes specific tools with the following available operations:

• logFinancialIntent: Log financial actions to blockchain
• updateIntentStatus: Update status of existing intents
• getAuditTrail: Retrieve complete audit history
• verifyIntentIntegrity: Verify data integrity against blockchain

POST /api/resource (Optional)

Provides contextual information about user environment and preferences.

Authentication

All agent endpoints require:

• API Key: x-api-key header for server authentication
• OAuth Token: Optional Authorization: Bearer <token> for user-specific access

Getting Started

1. Install dependencies:

npm install

2. Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

3. Start the development server:

npm run dev

4. Access the application:

• Main Dashboard: http://localhost:5000/dashboard
• Testing Interface: http://localhost:5000/testing

Environment Variables

• BHINDI_API_KEY: API key for Bhindi agent authentication
• NEXT_PUBLIC_BASE_RPC_URL: Base network RPC endpoint
• CONTRACT_ADDRESS: Deployed audit contract address
• DEFAULT_USER_ADDRESS: Default wallet address for testing

Architecture

• Frontend: Next.js with TypeScript and TailwindCSS
• Blockchain: Base network for immutable audit logging
• Agent Interface: RESTful API following Bhindi specifications
• Authentication: API key and OAuth token support

Testing

Use the testing dashboard at /testing to:

• Test Bhindi agent tool endpoints
• Simulate financial intent logging
• Verify blockchain integration
• Monitor agent execution history

Deployment

The application is ready for deployment on Replit with automatic build and hosting configuration.