Custom Integration

bun add @brnmwai/qova-core viem

1. Check score     ->  Read ReputationRegistry on-chain
2. Enforce budget  ->  Read BudgetEnforcer on-chain
3. Execute action  ->  Run the agent's operation
4. Record tx       ->  Write to TransactionValidator on-chain

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

class MyIntegration {
  private client: QovaClient;

  constructor(chain: "base-sepolia" | "base" | "skale-base") {
    this.client = createQovaClient({ chain });
  }

  // Check if an agent is trusted
  async checkAgent(address: string): Promise<{
    allowed: boolean;
    score: number;
    grade: string;
  }> {
    const details = await this.client.getAgentDetails(address);
    const grade = getGrade(details.score);
    return {
      allowed: details.score >= 650,
      score: details.score,
      grade,
    };
  }

  // Gate any action behind a score check + budget check
  async executeWithTrust(
    agentAddress: string,
    action: () => Promise<void>,
    amount: bigint,
  ): Promise<void> {
    // 1. Check score (reads ReputationRegistry)
    const score = await this.client.getScore(agentAddress);
    if (score < 650) throw new Error(`Score too low: ${score}`);

    // 2. Check budget (reads BudgetEnforcer)
    const allowed = await this.client.checkBudget(agentAddress, amount);
    if (!allowed) throw new Error("Budget exceeded");

    // 3. Execute the action
    await action();

    // 4. Record it (writes to TransactionValidator)
    await this.client.recordTransaction(agentAddress, "0x...", amount, 0);
  }
}

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

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

// Read operations - no wallet needed
const score = await client.getScore("0x1234...");
const details = await client.getAgentDetails("0x1234...");
const stats = await client.getTransactionStats("0x1234...");
const budget = await client.getBudgetStatus("0x1234...");
const registered = await client.isAgentRegistered("0x1234...");

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

const unwatch = watchScoreUpdates(
  { chain: "base-sepolia" },
  (event) => {
    if (event.newScore < 300) {
      // Agent dropped to critical - take action
      revokeAccess(event.agent);
    }
  },
);