@agentauditai/mcp-server 0.0.0-stage → 3.0.0

package/dist/sdk/src/index.d.ts

@@ -0,0 +1,365 @@
+import type { BatchCommitter, CommitBatchParams, CommitBatchResult } from "./batch";
+export * from "./batch";
+export * from "./attribution";
+export declare const NETWORKS: {
+    readonly mantle: {
+        readonly rpc: "https://rpc.mantle.xyz";
+        readonly chainId: 5000;
+        readonly auditVault: "0xD0086f19eDb500fB9d3382f6f5EAE1C015be054b";
+        readonly vaultVersion: 1;
+        readonly incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        readonly explorer: "https://explorer.mantle.xyz";
+        readonly name: "Mantle Mainnet";
+    };
+    readonly base: {
+        readonly rpc: "https://mainnet.base.org";
+        readonly chainId: 8453;
+        readonly auditVault: "0xCeE831070aa9081422f30df5559c125aa47A75DB";
+        readonly vaultVersion: 2;
+        readonly incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        readonly explorer: "https://basescan.org";
+        readonly name: "Base Mainnet";
+    };
+    readonly arbitrum: {
+        readonly rpc: "https://arb1.arbitrum.io/rpc";
+        readonly chainId: 42161;
+        readonly auditVault: "0x30579c6bFe4401A4b07062f0cc13C08FF2D9450C";
+        readonly vaultVersion: any;
+        readonly incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        readonly explorer: "https://arbiscan.io";
+        readonly name: "Arbitrum One";
+    };
+    readonly optimism: {
+        readonly rpc: "https://mainnet.optimism.io";
+        readonly chainId: 10;
+        readonly auditVault: "0x30579c6bFe4401A4b07062f0cc13C08FF2D9450C";
+        readonly vaultVersion: any;
+        readonly incidentRegistry: "0x976b03a2417cf7926813605F427ED499fdF61e10";
+        readonly explorer: "https://optimistic.etherscan.io";
+        readonly name: "Optimism Mainnet";
+    };
+    readonly polygon: {
+        readonly rpc: "https://polygon-bor-rpc.publicnode.com";
+        readonly chainId: 137;
+        readonly auditVault: "0x6fC00423Df95a7caf6fFFDD93169b5C01480de02";
+        readonly vaultVersion: any;
+        readonly incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        readonly explorer: "https://polygonscan.com";
+        readonly name: "Polygon Mainnet";
+    };
+};
+export type NetworkName = keyof typeof NETWORKS;
+export type RiskLevel = "LOW" | "MEDIUM" | "HIGH";
+export type ComplianceLevel = "minimal" | "limited" | "high";
+export type IncidentSeverity = "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+/** Nature of harm — Art. 73§1 qualifying conditions (IncidentRegistry.HarmType) */
+export type HarmType = "DEATH" | "SERIOUS_HEALTH_HARM" | "SIGNIFICANT_PROPERTY_DAMAGE" | "FUNDAMENTAL_RIGHTS_VIOLATION" | "OTHER";
+export type IncidentStatus = "OPEN" | "REPORTED" | "UNDER_INVESTIGATION" | "RESOLVED" | "CLOSED";
+export type MetricType = "ERROR_RATE" | "DRIFT_SCORE" | "LATENCY_MS" | "COMPLIANCE_SCORE" | "CUSTOM";
+export interface AgentAuditConfig {
+    /** Agent wallet private key */
+    privateKey: string;
+    /** Target network (default: base) */
+    network?: NetworkName;
+    /** Override RPC URL */
+    rpcUrl?: string;
+    /** Override the AuditVault v2 address used by commitBatch / verifyLog */
+    auditVaultAddress?: string;
+    /** AgentRegistration contract address (Mantle primary registry) */
+    registrationAddress?: string;
+    /** Override the IncidentRegistry v2 address (Art. 73); defaults per network */
+    incidentRegistryAddress?: string;
+    /** PostMarketMonitor contract address (Art. 72) */
+    postMarketMonitorAddress?: string;
+    /**
+     * Base Builder Code (ERC-8021) appended to the calldata of this SDK's contract
+     * calls on Base / Base Sepolia only. Omitted: AgentAudit's code (`bc_pd681w25`).
+     * `false`: no suffix. A string: your own code. See README "Base Builder Code attribution".
+     */
+    builderCode?: string | false;
+}
+export interface LogActionParams {
+    agentId: number | string;
+    actionType: string;
+    payload: string | object;
+    riskLevel?: RiskLevel;
+}
+export interface LogActionResult {
+    txHash: string;
+    logIndex?: number;
+    network: NetworkName;
+    explorerUrl: string;
+}
+export interface RegisterAgentResult {
+    agentId: number;
+    txHash: string;
+    network: string;
+}
+export interface IncidentResult {
+    incidentId: number;
+    txHash: string;
+    withinDeadline?: boolean;
+}
+export interface ReportIncidentParams {
+    /** Numeric/string agent ID (hashed with keccak256) or a bytes32 hex string (used as-is) */
+    agentId: string | number;
+    severity: IncidentSeverity;
+    description: string;
+    /** Nature of harm (Art. 73§1); default "OTHER" */
+    harmType?: HarmType;
+    /** Number of persons affected (Art. 73§3); default 0 */
+    affectedPersons?: number | bigint;
+    /** Hash or IPFS CID of evidence; default keccak256(description) */
+    evidenceHash?: string;
+    /** Unix seconds, must not be in the future; default latest block timestamp */
+    occurredAt?: number;
+}
+/** IncidentRegistry v2 `incidents(id)` record */
+export interface Incident {
+    id: number;
+    agentId: string;
+    severity: IncidentSeverity;
+    harmType: HarmType;
+    status: IncidentStatus;
+    description: string;
+    evidenceHash: string;
+    affectedPersons: bigint;
+    reportedBy: string;
+    occurredAt: number;
+    registeredAt: number;
+    reportedToAuthorityAt: number;
+    authorityAddress: string;
+    authorityRef: string;
+    withinDeadline: boolean;
+    rootCauseUri: string;
+    correctionUri: string;
+}
+export declare class AgentAudit implements BatchCommitter {
+    private provider;
+    private wallet;
+    private network;
+    private networkName;
+    private auditVault;
+    private _auditVaultV2?;
+    private _registration?;
+    private _incidentRegistry?;
+    private _postMarketMonitor?;
+    private config;
+    private builderCode;
+    constructor(config: AgentAuditConfig);
+    private get registration();
+    private get auditVaultV2();
+    /**
+     * The IncidentRegistry v2 contract, after checking once per instance that the
+     * address has code implementing the v2 functions. A mismatch is cached (it
+     * will not fix itself); an RPC failure is not, so the next call retries.
+     */
+    private incidentRegistry;
+    private verifyIncidentRegistry;
+    private get postMarketMonitor();
+    /** Every state-changing call goes through here (Builder Code suffix on Base only). */
+    private send;
+    private hashPayload;
+    private riskToUint;
+    private enumIndex;
+    /** bytes32 hex is used as-is; anything else is keccak256(String(agentId)) */
+    private incidentAgentId;
+    private metricTypeToUint;
+    private explorerTx;
+    /**
+     * Log a single agent action on-chain (Art. 12, 19, 50)
+     */
+    log(params: LogActionParams): Promise<LogActionResult>;
+    /**
+     * Alias for log() — the name the LLM wrappers call in per_action mode
+     */
+    logAction(params: LogActionParams): Promise<LogActionResult>;
+    /**
+     * Log multiple actions in one transaction (gas efficient)
+     */
+    logBatch(agentId: number | string, actions: Array<{
+        actionType: string;
+        payload: string | object;
+        riskLevel?: RiskLevel;
+    }>): Promise<LogActionResult>;
+    /**
+     * Get total on-chain log count for an agent
+     */
+    getLogCount(agentId: number | string): Promise<number>;
+    /**
+     * Anchor a Merkle root of action_refs (docs/EVIDENCE_SCHEMA.md) in one tx.
+     * Usually called by BatchBuffer rather than directly.
+     */
+    commitBatch(params: CommitBatchParams): Promise<CommitBatchResult>;
+    /**
+     * Throw a descriptive error if this network/config cannot batch-anchor.
+     * Wrappers call it at construction so batch mode fails fast instead of on
+     * the first flush.
+     */
+    assertBatchAnchoring(): void;
+    /**
+     * Check an inclusion proof against a committed batch (AuditVault v2 verifyLog)
+     */
+    verifyLog(agentAddress: string, batchIndex: number, leaf: string, proof: string[]): Promise<boolean>;
+    /**
+     * Register a new AI agent on-chain (KYA standard, Art. 13, 26)
+     */
+    registerAgent(params: {
+        name: string;
+        complianceLevel?: ComplianceLevel;
+        spendLimit?: bigint;
+        auditVault?: string;
+    }): Promise<RegisterAgentResult>;
+    /**
+     * Revoke an agent
+     */
+    revokeAgent(agentId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Check if agent is active
+     */
+    isActive(agentId: number): Promise<boolean>;
+    /**
+     * Get all agent IDs for the current wallet
+     */
+    getMyAgents(): Promise<number[]>;
+    /**
+     * Register an incident on-chain (Art. 73)
+     * The registry enforces the 15/10/2 day reporting timelines (Art. 73§2)
+     */
+    reportIncident(params: ReportIncidentParams): Promise<IncidentResult>;
+    /**
+     * Mark an incident as reported to the national market surveillance authority
+     * (Art. 73§2). Only the original reporter or the registry deployer may call it.
+     * @param params.authority    Address (or identifier) of the notified authority
+     * @param params.authorityRef Authority-issued case reference
+     */
+    markReportedToAuthority(incidentId: number, params: {
+        authority: string;
+        authorityRef: string;
+    }): Promise<{
+        txHash: string;
+        withinDeadline: boolean;
+    }>;
+    /**
+     * Read an incident record (IncidentRegistry v2 `incidents(id)`)
+     */
+    getIncident(incidentId: number): Promise<Incident>;
+    /**
+     * Incident IDs registered for an agent (same agentId rules as reportIncident)
+     */
+    getAgentIncidents(agentId: string | number): Promise<number[]>;
+    /**
+     * Whether an incident is still within its Art. 73§2 reporting deadline
+     */
+    isWithinDeadline(incidentId: number): Promise<boolean>;
+    /**
+     * Enroll an agent in post-market monitoring (Art. 72)
+     */
+    enrollMonitoring(params: {
+        agentAddress: string;
+        systemName: string;
+        riskCategory: string;
+        reviewIntervalDays: number;
+    }): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Record a performance metric (Art. 72)
+     */
+    recordMetric(params: {
+        agentAddress: string;
+        metricType: MetricType;
+        metricName: string;
+        value: number;
+        threshold: number;
+        context?: string;
+        txRef?: string;
+    }): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Record periodic compliance review (Art. 72)
+     * @param complianceScore 0-10000 (e.g. 9500 = 95.00%)
+     */
+    recordReview(params: {
+        agentAddress: string;
+        complianceScore: number;
+        notes: string;
+    }): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Check if agent is overdue for review
+     */
+    isReviewDue(agentAddress: string): Promise<{
+        due: boolean;
+        overdueBySeconds: number;
+    }>;
+    /**
+     * Get current network info
+     */
+    getNetworkInfo(): {
+        rpc: "https://rpc.mantle.xyz";
+        chainId: 5000;
+        auditVault: "0xD0086f19eDb500fB9d3382f6f5EAE1C015be054b";
+        vaultVersion: 1;
+        incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        explorer: "https://explorer.mantle.xyz";
+        name: "Mantle Mainnet";
+    } | {
+        rpc: "https://mainnet.base.org";
+        chainId: 8453;
+        auditVault: "0xCeE831070aa9081422f30df5559c125aa47A75DB";
+        vaultVersion: 2;
+        incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        explorer: "https://basescan.org";
+        name: "Base Mainnet";
+    } | {
+        rpc: "https://arb1.arbitrum.io/rpc";
+        chainId: 42161;
+        auditVault: "0x30579c6bFe4401A4b07062f0cc13C08FF2D9450C";
+        vaultVersion: any;
+        incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        explorer: "https://arbiscan.io";
+        name: "Arbitrum One";
+    } | {
+        rpc: "https://mainnet.optimism.io";
+        chainId: 10;
+        auditVault: "0x30579c6bFe4401A4b07062f0cc13C08FF2D9450C";
+        vaultVersion: any;
+        incidentRegistry: "0x976b03a2417cf7926813605F427ED499fdF61e10";
+        explorer: "https://optimistic.etherscan.io";
+        name: "Optimism Mainnet";
+    } | {
+        rpc: "https://polygon-bor-rpc.publicnode.com";
+        chainId: 137;
+        auditVault: "0x6fC00423Df95a7caf6fFFDD93169b5C01480de02";
+        vaultVersion: any;
+        incidentRegistry: "0x6ad45a9B32e695e95492dC3796a5aC8543B2EA6F";
+        explorer: "https://polygonscan.com";
+        name: "Polygon Mainnet";
+    };
+    /**
+     * Base Builder Code this instance appends on Base / Base Sepolia, or null when disabled
+     */
+    getBuilderCode(): string | null;
+    /**
+     * The exact calldata suffix this instance appends on the RPC's actual chain ("0x" = none)
+     */
+    getAttributionSuffix(): Promise<string>;
+    /**
+     * Get connected wallet address
+     */
+    getAddress(): string;
+    /**
+     * Hash any payload for on-chain storage
+     */
+    hash(payload: string | object): string;
+}
+/**
+ * Create AgentAudit from environment variables
+ */
+export declare function createAgentAudit(network?: NetworkName): AgentAudit;
+export default AgentAudit;