@agether/sdk 2.6.1 → 2.8.0

package/dist/clients/ScoringClient.d.ts

@@ -1,89 +0,0 @@
-/**
- * ScoringClient — Client for the Agether backend scoring API
- *
- * Endpoints:
- *   GET  /score/:agentId          — x402-gated, compute + submit score onchain
- *   GET  /score/:agentId/current  — free, read current onchain score
- *   GET  /health                  — service health
- *   GET  /status                  — detailed status
- *   GET  /agents/:agentId/details — agent details
- */
-import { ScoreResult } from '../types';
-import { X402Config } from './X402Client';
-export interface ScoringClientConfig {
-    /** Backend base URL (e.g. http://95.179.189.214:3001) */
-    endpoint: string;
-    /** x402 config for paid scoring calls (optional — if not set, paid calls will fail) */
-    x402?: X402Config;
-}
-export declare class ScoringClient {
-    private client;
-    private x402Client?;
-    private endpoint;
-    constructor(config: ScoringClientConfig);
-    /**
-     * Request a fresh score computation.
-     *
-     * This is x402-gated: the backend returns 402, the X402Client
-     * signs an EIP-3009 payment, and the backend computes + submits
-     * the score onchain via AgentReputation.submitScore().
-     *
-     * Returns the ScoreResult with breakdown and txHash.
-     */
-    requestScore(agentId: string | bigint): Promise<ScoreResult>;
-    /**
-     * Get the current onchain score (free, no payment required).
-     */
-    getCurrentScore(agentId: string | bigint): Promise<{
-        agentId: string;
-        score: number;
-        timestamp: number;
-        signer: string;
-        fresh: boolean;
-        age: number;
-    }>;
-    /**
-     * Get detailed agent info from backend.
-     */
-    getAgentDetails(agentId: string | bigint): Promise<{
-        agentId: string;
-        owner: string;
-        account: string;
-        accountExists: boolean;
-        kyaApproved: boolean;
-        score: number;
-        scoreFresh: boolean;
-        eligible: boolean;
-    }>;
-    /**
-     * Health check.
-     */
-    getHealth(): Promise<{
-        status: string;
-        timestamp: string;
-    }>;
-    /**
-     * Detailed status (contracts, signer, chain).
-     */
-    getStatus(): Promise<{
-        status: string;
-        chain: {
-            id: number;
-            name: string;
-        };
-        contracts: Record<string, string>;
-        scoring: {
-            priceUsdc: string;
-            x402PayToAddress: string;
-        };
-        signer: string;
-    }>;
-    /**
-     * Agent count and list.
-     */
-    getAgentCount(): Promise<{
-        totalAgents: number;
-        totalAccounts: number;
-    }>;
-}
-//# sourceMappingURL=ScoringClient.d.ts.map

package/dist/clients/ScoringClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ScoringClient.d.ts","sourceRoot":"","sources":["../../src/clients/ScoringClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAgB,MAAM,UAAU,CAAC;AACrD,OAAO,EAAc,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,mBAAmB;IAgBvC;;;;;;;;OAQG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BlE;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QACvD,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IASF;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QACvD,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,OAAO,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IASF;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAKjE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,gBAAgB,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAKF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CAI/E"}

package/dist/clients/ScoringClient.js

@@ -1,93 +0,0 @@
-/**
- * ScoringClient — Client for the Agether backend scoring API
- *
- * Endpoints:
- *   GET  /score/:agentId          — x402-gated, compute + submit score onchain
- *   GET  /score/:agentId/current  — free, read current onchain score
- *   GET  /health                  — service health
- *   GET  /status                  — detailed status
- *   GET  /agents/:agentId/details — agent details
- */
-import axios from 'axios';
-import { AgetherError } from '../types';
-import { X402Client } from './X402Client';
-export class ScoringClient {
-    constructor(config) {
-        this.endpoint = config.endpoint;
-        this.client = axios.create({
-            baseURL: config.endpoint,
-            headers: { 'Content-Type': 'application/json' },
-            timeout: 30000,
-        });
-        if (config.x402) {
-            this.x402Client = new X402Client(config.x402);
-        }
-    }
-    // ════════════════════════════════════════════════════════
-    //  Score (x402-gated — computes & submits onchain)
-    // ════════════════════════════════════════════════════════
-    /**
-     * Request a fresh score computation.
-     *
-     * This is x402-gated: the backend returns 402, the X402Client
-     * signs an EIP-3009 payment, and the backend computes + submits
-     * the score onchain via AgentReputation.submitScore().
-     *
-     * Returns the ScoreResult with breakdown and txHash.
-     */
-    async requestScore(agentId) {
-        const id = agentId.toString();
-        if (!this.x402Client) {
-            throw new AgetherError('x402 config required for paid scoring. Provide x402 in ScoringClientConfig.', 'X402_NOT_CONFIGURED');
-        }
-        const result = await this.x402Client.get(`${this.endpoint}/score/${id}`);
-        if (!result.success || !result.data) {
-            throw new AgetherError(`Scoring request failed: ${result.error || 'unknown error'}`, 'SCORING_FAILED');
-        }
-        return result.data;
-    }
-    // ════════════════════════════════════════════════════════
-    //  Current Score (free — reads onchain)
-    // ════════════════════════════════════════════════════════
-    /**
-     * Get the current onchain score (free, no payment required).
-     */
-    async getCurrentScore(agentId) {
-        const response = await this.client.get(`/score/${agentId.toString()}/current`);
-        return response.data;
-    }
-    // ════════════════════════════════════════════════════════
-    //  Agent Details
-    // ════════════════════════════════════════════════════════
-    /**
-     * Get detailed agent info from backend.
-     */
-    async getAgentDetails(agentId) {
-        const response = await this.client.get(`/agents/${agentId.toString()}/details`);
-        return response.data;
-    }
-    // ════════════════════════════════════════════════════════
-    //  Service Status
-    // ════════════════════════════════════════════════════════
-    /**
-     * Health check.
-     */
-    async getHealth() {
-        const response = await this.client.get('/health');
-        return response.data;
-    }
-    /**
-     * Detailed status (contracts, signer, chain).
-     */
-    async getStatus() {
-        const response = await this.client.get('/status');
-        return response.data;
-    }
-    /**
-     * Agent count and list.
-     */
-    async getAgentCount() {
-        const response = await this.client.get('/agents/count');
-        return response.data;
-    }
-}

package/dist/clients/X402Client.d.ts

@@ -1,168 +0,0 @@
-/**
- * x402 HTTP Client — Make paid API calls via the x402 protocol (v2)
- *
- * Built on top of the official @x402/fetch + @x402/evm SDK.
- * https://docs.x402.org/getting-started/quickstart-for-buyers
- *
- * Flow:
- *   1. Client → Resource Server (normal request)
- *   2. Resource Server → 402 with PAYMENT-REQUIRED header (base64 JSON)
- *   3. @x402/fetch auto-picks PaymentRequirements, signs EIP-3009 via EVM scheme
- *   4. Client → Resource Server (retries with PAYMENT-SIGNATURE header)
- *   5. Resource Server → verifies via facilitator → settles → 200 + data
- *
- * Auto-Draw: When autoDraw is enabled and USDC balance is insufficient,
- * the client automatically borrows from Morpho Blue before paying.
- *
- * Spending Limits: Optional daily spending cap (dailySpendLimitUsdc) and
- * yield-limited spending (yieldLimitedSpending) to keep borrows within
- * theoretical collateral yield.
- *
- * Chain support: Base (8453), Base Sepolia (84532), Ethereum (1).
- */
-import type { WalletClient } from 'viem';
-/**
- * Convenience type alias for any viem-compatible WalletClient.
- * Use this when declaring variables or parameters that accept
- * viem WalletClient instances from Privy, Turnkey, MetaMask, etc.
- */
-export type AgetherViemWallet = WalletClient;
-/** Base configuration fields shared by both signing modes. */
-interface X402BaseConfig {
-    rpcUrl: string;
-    backendUrl: string;
-    agentId?: string;
-    accountAddress?: string;
-    /**
-     * Auto-draw: automatically borrow from Morpho Blue when USDC balance
-     * is insufficient for x402 payment. Requires agentId to be set.
-     * Default: false
-     */
-    autoDraw?: boolean;
-    /**
-     * Daily spending limit in USDC (e.g. '100' for $100/day).
-     * Tracks cumulative daily borrows and rejects auto-draw if exceeded.
-     */
-    dailySpendLimitUsdc?: string;
-    /**
-     * When true, auto-calculates the daily spending limit based on
-     * theoretical yield of deposited collateral. Overrides dailySpendLimitUsdc.
-     */
-    yieldLimitedSpending?: boolean;
-    /**
-     * Safety margin: borrow this much extra beyond what's needed (in USDC, e.g. '1').
-     * Helps avoid rounding issues. Default: '0.5'
-     */
-    autoDrawBuffer?: string;
-    /**
-     * ERC-7579 validator module address (e.g. Agether8004ValidationModule).
-     * Required for Safe7579 smart wallets so that `isValidSignature` calls
-     * are routed through the correct validator.  The signature is prefixed
-     * with this 20-byte address before being sent.
-     */
-    validatorModule?: string;
-}
-/** Config with SDK-managed private key (existing behavior). */
-interface X402PrivateKeyConfig extends X402BaseConfig {
-    /** Raw hex private key (with or without '0x' prefix). SDK creates the wallet internally. */
-    privateKey: string;
-    walletClient?: never;
-}
-/** Config with caller-provided viem WalletClient (custody-agnostic). */
-interface X402WalletClientConfig extends X402BaseConfig {
-    /**
-     * A viem WalletClient with an attached account (e.g. from Privy, Turnkey, MetaMask).
-     * The client **must** have an `account` property set. The SDK will use it for
-     * EIP-712 typed-data signing and will never recreate or reconnect the client.
-     */
-    walletClient: WalletClient;
-    privateKey?: never;
-}
-/**
- * X402Client configuration.
- *
- * Provide **either** `privateKey` (SDK manages wallet) **or** `walletClient`
- * (external custody provider). The two fields are mutually exclusive.
- */
-export type X402Config = X402PrivateKeyConfig | X402WalletClientConfig;
-export interface X402Response<T = unknown> {
-    success: boolean;
-    data?: T;
-    error?: string;
-    paymentInfo?: {
-        amount: string;
-        asset: string;
-        network: string;
-        txHash?: string;
-    };
-    autoDrawInfo?: {
-        borrowed: string;
-        borrowTx: string;
-        reason: string;
-    };
-}
-/** One item inside the `accepts` array returned by the resource server */
-export interface PaymentRequirements {
-    scheme: string;
-    network: string;
-    amount: string;
-    asset: string;
-    payTo: string;
-    maxTimeoutSeconds: number;
-    extra?: Record<string, unknown>;
-}
-/** Spending tracker — tracks cumulative daily borrows */
-export interface SpendingTracker {
-    /** Date string (YYYY-MM-DD UTC) */
-    date: string;
-    /** Cumulative USDC borrowed today (6 decimal raw units) */
-    totalBorrowed: bigint;
-    /** Daily limit in raw units (6 decimals), 0 = unlimited */
-    dailyLimit: bigint;
-}
-export declare class X402Client {
-    private config;
-    private paidFetch;
-    private address;
-    private _spendingTracker;
-    constructor(config: X402Config);
-    get<T = unknown>(url: string, opts?: RequestInit): Promise<X402Response<T>>;
-    post<T = unknown>(url: string, body?: unknown, opts?: RequestInit): Promise<X402Response<T>>;
-    getAddress(): string;
-    /** Get the current spending tracker state */
-    getSpendingTracker(): SpendingTracker;
-    /** Get remaining daily spending allowance in USDC (human-readable) */
-    getRemainingDailyAllowance(): string;
-    /**
-     * Pay with auto-draw: Make an x402 request with automatic Morpho borrowing.
-     *
-     * Flow:
-     * 1. Check USDC balance on AgentAccount
-     * 2. Probe the URL to discover payment amount (if 402)
-     * 3. If insufficient USDC, calculate deficit
-     * 4. Check spending limit
-     * 5. Borrow from Morpho via MorphoClient
-     * 6. Proceed with x402 payment
-     */
-    payWithAutoDraw<T = unknown>(url: string, opts?: RequestInit & {
-        morphoClient?: any;
-    }): Promise<X402Response<T>>;
-    private request;
-    /**
-     * Probe a URL to discover payment requirements without paying.
-     * Makes a request and parses the 402 PAYMENT-REQUIRED header.
-     * @returns Payment amount in raw USDC units (6 decimals), or null if not a 402.
-     */
-    private _probePaymentAmount;
-    /** Reset spending tracker if it's a new day */
-    private _resetTrackerIfNewDay;
-    /** Track a new spending amount */
-    private _trackSpending;
-    /**
-     * Check if a borrow amount is within spending limits.
-     * Considers both fixed daily limits and yield-limited spending.
-     */
-    private _checkSpendingLimit;
-}
-export {};
-//# sourceMappingURL=X402Client.d.ts.map

package/dist/clients/X402Client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"X402Client.d.ts","sourceRoot":"","sources":["../../src/clients/X402Client.ts"],"names":[],"mappings":"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"}