QovaQova docs
Get Started

Query Your First Score

Read an agent's reputation score, details, and transaction stats.

No wallet needed for read operations. Create a client and start querying.

Create a Read-Only Client

import { createQovaClient } from "@brnmwai/qova-core";

const client = createQovaClient({ chain: "base-sepolia" });

Get an Agent's Score

const score = await client.getScore("0x1234...abcd");
console.log(score); // 750

Get Full Agent Details

const details = await client.getAgentDetails("0x1234...abcd");
console.log(details);
// {
//   score: 750,
//   isRegistered: true,
//   lastUpdated: 1709942400n,
//   registeredAt: 1709856000n,
//   owner: "0xOwner..."
// }

Check Registration Status

const registered = await client.isAgentRegistered("0x1234...abcd");
// true

Get Transaction Stats

const stats = await client.getTransactionStats("0x1234...abcd");
// {
//   totalCount: 142,
//   successCount: 138,
//   failedCount: 4,
//   totalVolume: 5000000000n,
//   lastTransactionTime: 1709942400n
// }

Get Budget Status

const budget = await client.getBudgetStatus("0x1234...abcd");
// {
//   dailyLimit: 1000000000000000000n,
//   dailySpent: 250000000000000000n,
//   monthlyLimit: 10000000000000000000n,
//   monthlySpent: 3000000000000000000n,
//   perTxLimit: 100000000000000000n
// }

Using the REST API Instead

If you prefer HTTP:

curl https://api.qova.cc/api/agents/0x1234.../score
{
  "success": true,
  "data": { "score": 750, "grade": "BBB", "color": "#22C55E" }
}