@valiron/sdk 0.1.0

package/README.md

@@ -0,0 +1,499 @@
+# @valiron/sdk
+
+Official TypeScript SDK for **Valiron** - Trust Infrastructure for AI Agent Systems
+
+Valiron verifies AI agent trustworthiness using on-chain reputation (ERC-8004) and behavioral analysis. This SDK provides routing decisions based on agent trust scores, enabling you to protect infrastructure while maintaining service availability for verified agents.
+
+## Installation
+
+```bash
+npm install @valiron/sdk
+# or
+yarn add @valiron/sdk
+# or
+pnpm add @valiron/sdk
+```
+
+## Getting Started
+
+1. **Initialize the SDK:**
+
+```typescript
+import { ValironSDK } from '@valiron/sdk';
+
+// Simple initialization (uses default production endpoint)
+const valiron = new ValironSDK();
+
+// Or with custom configuration
+const valiron = new ValironSDK({
+  endpoint: 'https://valiron-edge-proxy.onrender.com', // default
+  timeout: 5000,  // optional
+  debug: false    // optional
+});
+```
+
+> **Note:** API key authentication is not yet enforced. The `apiKey` field is
+> reserved for future use when authentication is implemented.
+
+2. **Check agent trust before processing requests:**
+
+```typescript
+const decision = await valiron.checkAgent('417');
+
+if (decision.route === 'prod') {
+  return handleRequest();
+} else {
+  return denyRequest();
+}
+```
+
+## Core Concepts
+
+### Route Decisions
+
+The SDK returns one of four routing decisions:
+
+- **`prod`** - Full access (trust tiers: AAA to BAA)
+- **`prod_throttled`** - Rate-limited access (trust tiers: BA to B)
+- **`sandbox`** - Agent under evaluation (temporary state)
+- **`sandbox_only`** - Access denied (trust tiers: CAA to C)
+
+### Trust Evaluation
+
+Valiron evaluates agents using:
+
+1. **On-chain Reputation** - ERC-8004 feedback submitted by other organizations
+2. **Behavioral Analysis** - Sandbox evaluation of rate-limit compliance, error rates, and request patterns
+3. **Credit Rating** - Moody's-style scoring system (AAA to C tiers)
+
+### Architecture
+
+```
+Request → SDK.checkAgent() → Valiron API → Route Decision → Application
+```
+
+The SDK queries Valiron's trust infrastructure, which evaluates on-chain reputation and behavioral metrics to return a routing decision. Your application implements access control based on this decision.
+
+## API Reference
+
+### Constructor
+
+```typescript
+new ValironSDK(config: ValironConfig)
+```
+
+**Config Options:**
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `apiKey` | string | No | - | API key (reserved for future use) |
+| `endpoint` | string | No | `https://valiron-edge-proxy.onrender.com` | API endpoint URL |
+| `timeout` | number | No | `5000` | Request timeout (ms) |
+| `debug` | boolean | No | `false` | Enable debug logging |
+
+### Methods
+
+#### `checkAgent(agentId: string): Promise<RoutingResponse>`
+
+Check routing decision for an ERC-8004 agent.
+
+**Returns:**
+```typescript
+{
+  route: 'prod' | 'prod_throttled' | 'sandbox' | 'sandbox_only',
+  reason: string,
+  explanation: string,
+  onChainData?: {
+    feedbackCount: number,
+    averageScore: number,
+    agentId: string
+  },
+  localReputation?: {
+    score: number,
+    tier: MoodysRating,
+    riskLevel: 'GREEN' | 'YELLOW' | 'RED',
+    graduated: boolean
+  }
+}
+```
+
+**Example:**
+```typescript
+const decision = await valiron.checkAgent('417');
+console.log(decision.route); // 'prod'
+console.log(decision.localReputation?.tier); // 'AAA'
+```
+
+---
+
+#### `checkWallet(wallet: string): Promise<RoutingResponse>`
+
+Check routing decision for a wallet address (legacy method).
+
+**Example:**
+```typescript
+const decision = await valiron.checkWallet('0x742d35Cc...');
+```
+
+---
+
+#### `getAgentProfile(agentId: string): Promise<AgentProfile>`
+
+Get complete trust profile for an agent.
+
+**Returns:**
+```typescript
+{
+  agentId: string,
+  identity: {
+    wallet: string,
+    name: string,
+    description: string,
+    image: string,
+    endpoints: string[]
+  },
+  onchainReputation: {
+    count: number,
+    averageScore: number,
+    feedbackEntries: FeedbackEntry[]
+  },
+  localReputation: {
+    score: number,
+    tier: MoodysRating,
+    riskLevel: 'GREEN' | 'YELLOW' | 'RED',
+    metrics: BehavioralMetrics
+  },
+  routing: {
+    finalRoute: RouteDecision,
+    decision: string,
+    reasons: string[]
+  }
+}
+```
+
+**Example:**
+```typescript
+const profile = await valiron.getAgentProfile('417');
+console.log(`Score: ${profile.localReputation.score}/100`);
+console.log(`Tier: ${profile.localReputation.tier}`);
+console.log(`On-chain feedback: ${profile.onchainReputation.count} entries`);
+```
+
+---
+
+#### `submitFeedback(params: SubmitFeedbackParams): Promise<{ success: boolean; txHash?: string }>`
+
+Submit feedback about an agent's behavior. Valiron handles IPFS storage and on-chain submission automatically.
+
+**Parameters:**
+```typescript
+{
+  agentId: string,
+  score: number,        // 0-100
+  outcome: 'success' | 'failure',
+  metadata?: {          // Custom metadata
+    [key: string]: any
+  }
+}
+```
+
+**Example:**
+```typescript
+await valiron.submitFeedback({
+  agentId: '417',
+  score: 95,
+  outcome: 'success',
+  metadata: {
+    taskType: 'data_processing',
+    duration: 2340,
+    recordsProcessed: 10000
+  }
+});
+```
+
+---
+
+#### `triggerSandboxTest(params: SandboxTestParams): Promise<{ success: boolean; message: string }>`
+
+Manually trigger sandbox testing for an agent.
+
+**Example:**
+```typescript
+await valiron.triggerSandboxTest({
+  agentId: '417',
+  behaviorType: 'good'
+});
+```
+
+---
+
+## Integration Examples
+
+### Express.js Middleware
+
+```typescript
+import { ValironSDK } from '@valiron/sdk';
+import express from 'express';
+
+const app = express();
+const valiron = new ValironSDK({ apiKey: process.env.VALIRON_API_KEY! });
+
+async function valironMiddleware(req, res, next) {
+  const agentId = req.headers['x-agent-id'];
+  
+  const decision = await valiron.checkAgent(agentId);
+  
+  if (decision.route === 'prod' || decision.route === 'prod_throttled') {
+    return next();
+  }
+  
+  return res.status(403).json({
+    error: 'Access denied',
+    reason: decision.reason
+  });
+}
+
+app.use('/api/protected/*', valironMiddleware);
+```
+
+### Next.js Middleware
+
+```typescript
+// middleware.ts
+import { NextRequest, NextResponse } from 'next/server';
+import { ValironSDK } from '@valiron/sdk';
+
+const valiron = new ValironSDK({ apiKey: process.env.VALIRON_API_KEY! });
+
+export async function middleware(request: NextRequest) {
+  const agentId = request.headers.get('x-agent-id');
+  const decision = await valiron.checkAgent(agentId!);
+  
+  if (decision.route === 'prod' || decision.route === 'prod_throttled') {
+    return NextResponse.next();
+  }
+  
+  return NextResponse.json(
+    { error: 'Access denied' },
+    { status: 403 }
+  );
+}
+
+export const config = {
+  matcher: '/api/protected/:path*'
+};
+```
+
+### Simple API Gateway
+
+```typescript
+import { ValironSDK } from '@valiron/sdk';
+
+const valiron = new ValironSDK({ apiKey: 'vln_xxx' });
+
+async function handleRequest(agentId: string) {
+  const decision = await valiron.checkAgent(agentId);
+  
+  switch (decision.route) {
+    case 'prod':
+      return processRequest({ rateLimit: null });
+    
+    case 'prod_throttled':
+      return processRequest({ rateLimit: '100/hour' });
+    
+    case 'sandbox':
+      return { error: 'Agent under evaluation', retryAfter: 30 };
+    
+    case 'sandbox_only':
+      return { error: 'Access denied', reason: decision.reason };
+  }
+}
+```
+
+### Integration with x402 Payment APIs
+
+Valiron integrates with **x402** payment-gated APIs (e.g., [Orthogonal](https://www.orth.sh/)). Verify trust before processing payments to prevent malicious agents from accessing paid endpoints.
+
+#### Server-Side: Validate Trust + Payment
+
+```typescript
+import { ValironSDK } from '@valiron/sdk';
+import { privateKeyToAccount } from 'viem/accounts';
+import { getAddress } from 'viem';
+import { exact } from 'x402/schemes'; // Real x402 package
+
+const valiron = new ValironSDK();
+
+async function trustThenPayment(req, res, next) {
+  const agentId = req.headers['x-agent-id'];
+  const paymentHeader = req.headers['x-payment'];
+  
+  // Step 1: Verify trust before payment
+  const { route, localReputation } = await valiron.checkAgent(agentId);
+  
+  if (route === 'sandbox_only') {
+    return res.status(403).json({
+      error: 'Agent banned',
+      reason: 'Failed behavioral trust requirements'
+    });
+  }
+  
+  if (route === 'sandbox') {
+    return res.status(403).json({
+      error: 'Agent under evaluation',
+      retryAfter: 30
+    });
+  }
+  
+  // Step 2: Verify payment (trusted agents only)
+  if (!paymentHeader) {
+    // Dynamic pricing based on trust tier
+    const pricing = {
+      'AAA': 5, 'AA': 5, 'A': 8, 'BAA': 10,
+      'BA': 25, 'B': 50, 'CAA': 100, 'CA': 100, 'C': 100
+    };
+    
+    return res.status(402).json({
+      error: 'Payment Required',
+      accepts: [{
+        scheme: 'exact',
+        network: 'base',
+        maxAmountRequired: pricing[localReputation?.tier || 'B'],
+        asset: '0x...',
+        payTo: '0x...',
+        // ... x402 payment requirements
+      }]
+    });
+  }
+  
+  // Verify payment (use x402 library)
+  const valid = await exact.evm.verifyPayment(paymentHeader);
+  if (!valid) {
+    return res.status(402).json({ error: 'Invalid payment' });
+  }
+  
+  // Step 3: Apply trust-based rate limits
+  req.rateLimit = route === 'prod' ? 1000 : 100; // requests/hour
+  next();
+}
+
+app.get('/api/premium/weather', trustThenPayment, handler);
+```
+
+#### Client-Side: Make Trusted Payments
+
+```typescript
+import { ValironSDK } from '@valiron/sdk';
+import { exact } from 'x402/schemes';
+import { privateKeyToAccount } from 'viem/accounts';
+
+const valiron = new ValironSDK();
+const account = privateKeyToAccount(process.env.PRIVATE_KEY);
+
+async function fetchPaidAPI(agentId: string, url: string) {
+  // Optional: Verify own trust status
+  const { route } = await valiron.checkAgent(agentId);
+  if (route === 'sandbox_only') {
+    throw new Error('Agent access denied');
+  }
+  
+  // Get payment requirements
+  const res = await fetch(url);
+  const { accepts } = await res.json();
+  
+  // Create x402 payment header
+  const paymentHeader = await exact.evm.createPaymentHeader(
+    account,
+    1,
+    accepts[0]
+  );
+  
+  // Retry with payment
+  const data = await fetch(url, {
+    headers: { 'X-PAYMENT': paymentHeader }
+  }).then(r => r.json());
+  
+  return data;
+}
+```
+
+**Trust + Payment Benefits:**
+- Reject untrusted agents before payment verification
+- Implement dynamic pricing based on trust tier
+- Reduce transaction overhead by filtering banned agents
+- Mitigate DDoS attacks from paid malicious requests
+
+**Compatible with:**
+- [Orthogonal](https://www.orth.sh/) x402 API marketplace
+- Any HTTP 402 Payment Required API
+
+See [examples/x402-integration.ts](examples/x402-integration.ts) for complete implementation.
+
+## TypeScript Types
+
+The SDK is fully typed. Import types as needed:
+
+```typescript
+import {
+  ValironSDK,
+  RouteDecision,
+  MoodysRating,
+  AgentProfile,
+  RoutingResponse,
+  ValironError
+} from '@valiron/sdk';
+```
+
+## Moody's Credit Rating Tiers
+
+| Tier | Score Range | Risk | Access Level |
+|------|-------------|------|--------------|
+| AAA | 98-110 | Prime | Full production |
+| AA | 92-97 | High grade | Full production |
+| A | 85-91 | Upper medium | Full production |
+| BAA | 75-84 | Medium | Full production (monitored) |
+| BA | 65-74 | Speculative | Throttled |
+| B | 50-64 | Highly speculative | Throttled |
+| CAA | 35-49 | Substantial risk | Sandbox only |
+| CA | 20-34 | Extremely speculative | Sandbox only |
+| C | 0-19 | Default risk | Sandbox only |
+
+## Error Handling
+
+```typescript
+import { ValironError } from '@valiron/sdk';
+
+try {
+  const decision = await valiron.checkAgent('123');
+} catch (error) {
+  if (error instanceof ValironError) {
+    console.error('Code:', error.code);
+    console.error('Message:', error.message);
+    console.error('Status:', error.statusCode);
+    
+    switch (error.code) {
+      case 'TIMEOUT_ERROR':
+        // Handle timeout
+        break;
+      case 'NETWORK_ERROR':
+        // Handle network issues
+        break;
+      case 'API_ERROR':
+        // Handle API errors
+        break;
+    }
+  }
+}
+```
+
+## Additional Resources
+
+- [ERC-8004 Standard](https://eips.ethereum.org/EIPS/eip-8004)
+
+## Support
+
+- **Email**: founders@valiron.io
+
+## License
+
+MIT © Valiron

package/dist/clients.d.ts

@@ -0,0 +1,90 @@
+import { ValironConfig, RoutingResponse, AgentProfile, WalletProfile, SubmitFeedbackParams, SandboxTestParams } from './types';
+/**
+ * Base client for making HTTP requests to Valiron API
+ */
+export declare class BaseClient {
+    protected endpoint: string;
+    protected apiKey?: string;
+    protected timeout: number;
+    protected debug: boolean;
+    constructor(config?: ValironConfig);
+    /**
+     * Build headers for API requests
+     */
+    private buildHeaders;
+    /**
+     * Make a GET request to Valiron API
+     */
+    protected get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    /**
+     * Make a POST request to Valiron API
+     */
+    protected post<T>(path: string, body?: any): Promise<T>;
+}
+/**
+ * Client for agent trust and routing operations
+ */
+export declare class TrustClient extends BaseClient {
+    /**
+     * Check agent routing decision
+     *
+     * This is the primary method for determining how to route requests from an agent.
+     * The Valiron system will automatically handle sandbox testing if needed.
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Routing decision with explanation
+     */
+    checkAgent(agentId: string): Promise<RoutingResponse>;
+    /**
+     * Check wallet routing decision (legacy support)
+     *
+     * @param wallet - The wallet address
+     * @returns Routing decision with explanation
+     */
+    checkWallet(wallet: string): Promise<RoutingResponse>;
+    /**
+     * Get complete agent trust profile
+     *
+     * Returns combined on-chain and off-chain reputation data
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Complete agent profile
+     */
+    getAgentProfile(agentId: string): Promise<AgentProfile>;
+    /**
+     * Get wallet profile
+     *
+     * @param wallet - The wallet address
+     * @returns Wallet profile with routing info
+     */
+    getWalletProfile(wallet: string): Promise<WalletProfile>;
+}
+/**
+ * Client for reputation feedback operations
+ */
+export declare class ReputationClient extends BaseClient {
+    /**
+     * Submit feedback about an agent's behavior
+     *
+     * Note: This submits feedback to Valiron, which then handles
+     * IPFS upload and on-chain submission on your behalf.
+     *
+     * @param params - Feedback parameters
+     */
+    submitFeedback(params: SubmitFeedbackParams): Promise<{
+        success: boolean;
+        txHash?: string;
+    }>;
+    /**
+     * Manually trigger sandbox testing for an agent
+     *
+     * Useful for testing or re-evaluation scenarios.
+     *
+     * @param params - Sandbox test parameters
+     */
+    triggerSandboxTest(params: SandboxTestParams): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=clients.d.ts.map

package/dist/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,UAAU;IACrB,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEb,MAAM,GAAE,aAAkB;IAOtC;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;cACa,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6DjF;;OAEG;cACa,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;CAwD9D;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC;;;;;;;;OAQG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3D;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3D;;;;;;;OAOG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAG/D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C;;;;;;;OAOG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlG;;;;;;OAMG;IACG,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGpG"}

package/dist/clients.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReputationClient = exports.TrustClient = exports.BaseClient = void 0;
+const types_1 = require("./types");
+/**
+ * Base client for making HTTP requests to Valiron API
+ */
+class BaseClient {
+    constructor(config = {}) {
+        this.endpoint = config.endpoint || 'https://valiron-edge-proxy.onrender.com';
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout || 5000;
+        this.debug = config.debug || false;
+    }
+    /**
+     * Build headers for API requests
+     */
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Only include Authorization header if apiKey is provided
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+    /**
+     * Make a GET request to Valiron API
+     */
+    async get(path, params) {
+        const url = new URL(path, this.endpoint);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                url.searchParams.append(key, value);
+            });
+        }
+        if (this.debug) {
+            console.log(`[Valiron SDK] GET ${url.toString()}`);
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url.toString(), {
+                method: 'GET',
+                headers: this.buildHeaders(),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({ message: response.statusText }));
+                throw new types_1.ValironError(error.message || `Request failed: ${response.statusText}`, error.code || 'API_ERROR', response.status);
+            }
+            const data = await response.json();
+            if (this.debug) {
+                console.log(`[Valiron SDK] Response:`, data);
+            }
+            return data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error.name === 'AbortError') {
+                throw new types_1.ValironError(`Request timeout after ${this.timeout}ms`, 'TIMEOUT_ERROR');
+            }
+            if (error instanceof types_1.ValironError) {
+                throw error;
+            }
+            throw new types_1.ValironError(error.message || 'Network error', 'NETWORK_ERROR');
+        }
+    }
+    /**
+     * Make a POST request to Valiron API
+     */
+    async post(path, body) {
+        const url = new URL(path, this.endpoint);
+        if (this.debug) {
+            console.log(`[Valiron SDK] POST ${url.toString()}`, body);
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url.toString(), {
+                method: 'POST',
+                headers: this.buildHeaders(),
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({ message: response.statusText }));
+                throw new types_1.ValironError(error.message || `Request failed: ${response.statusText}`, error.code || 'API_ERROR', response.status);
+            }
+            const data = await response.json();
+            if (this.debug) {
+                console.log(`[Valiron SDK] Response:`, data);
+            }
+            return data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error.name === 'AbortError') {
+                throw new types_1.ValironError(`Request timeout after ${this.timeout}ms`, 'TIMEOUT_ERROR');
+            }
+            if (error instanceof types_1.ValironError) {
+                throw error;
+            }
+            throw new types_1.ValironError(error.message || 'Network error', 'NETWORK_ERROR');
+        }
+    }
+}
+exports.BaseClient = BaseClient;
+/**
+ * Client for agent trust and routing operations
+ */
+class TrustClient extends BaseClient {
+    /**
+     * Check agent routing decision
+     *
+     * This is the primary method for determining how to route requests from an agent.
+     * The Valiron system will automatically handle sandbox testing if needed.
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Routing decision with explanation
+     */
+    async checkAgent(agentId) {
+        return this.get('/route', { agentId });
+    }
+    /**
+     * Check wallet routing decision (legacy support)
+     *
+     * @param wallet - The wallet address
+     * @returns Routing decision with explanation
+     */
+    async checkWallet(wallet) {
+        return this.get('/route', { wallet });
+    }
+    /**
+     * Get complete agent trust profile
+     *
+     * Returns combined on-chain and off-chain reputation data
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Complete agent profile
+     */
+    async getAgentProfile(agentId) {
+        return this.get(`/agent/${agentId}`);
+    }
+    /**
+     * Get wallet profile
+     *
+     * @param wallet - The wallet address
+     * @returns Wallet profile with routing info
+     */
+    async getWalletProfile(wallet) {
+        return this.get(`/wallet/${wallet}`);
+    }
+}
+exports.TrustClient = TrustClient;
+/**
+ * Client for reputation feedback operations
+ */
+class ReputationClient extends BaseClient {
+    /**
+     * Submit feedback about an agent's behavior
+     *
+     * Note: This submits feedback to Valiron, which then handles
+     * IPFS upload and on-chain submission on your behalf.
+     *
+     * @param params - Feedback parameters
+     */
+    async submitFeedback(params) {
+        return this.post('/feedback', params);
+    }
+    /**
+     * Manually trigger sandbox testing for an agent
+     *
+     * Useful for testing or re-evaluation scenarios.
+     *
+     * @param params - Sandbox test parameters
+     */
+    async triggerSandboxTest(params) {
+        return this.post('/sandbox/trigger', params);
+    }
+}
+exports.ReputationClient = ReputationClient;
+//# sourceMappingURL=clients.js.map

package/dist/clients.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,132 @@
+import { ValironConfig, RoutingResponse, AgentProfile, WalletProfile, SubmitFeedbackParams, SandboxTestParams } from './types';
+/**
+ * Valiron SDK - Official TypeScript SDK for the Trust Layer for Agentic Economy
+ *
+ * @example
+ * ```typescript
+ * import { ValironSDK } from '@valiron/sdk';
+ *
+ * const valiron = new ValironSDK({
+ *   apiKey: 'vln_your_api_key'
+ * });
+ *
+ * // Check if agent can access production
+ * const decision = await valiron.checkAgent('123');
+ * if (decision.route === 'prod') {
+ *   // Allow full production access
+ * }
+ * ```
+ */
+export declare class ValironSDK {
+    private trustClient;
+    private reputationClient;
+    constructor(config: ValironConfig);
+    /**
+     * Check agent routing decision
+     *
+     * This is the primary method for determining how to route requests from an agent.
+     * Valiron automatically handles sandbox testing if the agent hasn't been evaluated.
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Routing decision with detailed explanation
+     *
+     * @example
+     * ```typescript
+     * const result = await valiron.checkAgent('417');
+     *
+     * switch (result.route) {
+     *   case 'prod':
+     *     return handleProductionRequest();
+     *   case 'prod_throttled':
+     *     return handleThrottledRequest();
+     *   case 'sandbox':
+     *   case 'sandbox_only':
+     *     return rejectRequest();
+     * }
+     * ```
+     */
+    checkAgent(agentId: string): Promise<RoutingResponse>;
+    /**
+     * Check wallet routing decision
+     *
+     * Legacy method for wallet-based routing. Prefer `checkAgent()` for ERC-8004 agents.
+     *
+     * @param wallet - The wallet address
+     * @returns Routing decision
+     */
+    checkWallet(wallet: string): Promise<RoutingResponse>;
+    /**
+     * Get complete agent trust profile
+     *
+     * Returns comprehensive trust data including on-chain reputation,
+     * behavioral analysis scores, and routing logic.
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Complete agent profile
+     *
+     * @example
+     * ```typescript
+     * const profile = await valiron.getAgentProfile('417');
+     * console.log(`Agent score: ${profile.localReputation?.score}`);
+     * console.log(`Tier: ${profile.localReputation?.tier}`);
+     * console.log(`On-chain feedback: ${profile.onchainReputation.count} entries`);
+     * ```
+     */
+    getAgentProfile(agentId: string): Promise<AgentProfile>;
+    /**
+     * Get wallet profile
+     *
+     * @param wallet - The wallet address
+     * @returns Wallet profile with routing info
+     */
+    getWalletProfile(wallet: string): Promise<WalletProfile>;
+    /**
+     * Submit feedback about an agent's behavior
+     *
+     * This allows you to report an agent's behavior to Valiron.
+     * Valiron handles IPFS storage and on-chain submission automatically.
+     *
+     * @param params - Feedback parameters
+     * @returns Submission result with transaction hash
+     *
+     * @example
+     * ```typescript
+     * await valiron.submitFeedback({
+     *   agentId: '417',
+     *   score: 95,
+     *   outcome: 'success',
+     *   metadata: {
+     *     taskType: 'data_processing',
+     *     duration: 1234
+     *   }
+     * });
+     * ```
+     */
+    submitFeedback(params: SubmitFeedbackParams): Promise<{
+        success: boolean;
+        txHash?: string;
+    }>;
+    /**
+     * Manually trigger sandbox testing
+     *
+     * Useful for re-evaluating an agent or testing specific scenarios.
+     *
+     * @param params - Sandbox test parameters
+     * @returns Test trigger result
+     *
+     * @example
+     * ```typescript
+     * await valiron.triggerSandboxTest({
+     *   agentId: '417',
+     *   behaviorType: 'good'
+     * });
+     * ```
+     */
+    triggerSandboxTest(params: SandboxTestParams): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+export * from './types';
+export * from './clients';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,MAAM,EAAE,aAAa;IAKjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3D;;;;;;;OAOG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3D;;;;;;;;;;;;;;;;OAgBG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlG;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGpG;AAGD,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,158 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValironSDK = void 0;
+const clients_1 = require("./clients");
+/**
+ * Valiron SDK - Official TypeScript SDK for the Trust Layer for Agentic Economy
+ *
+ * @example
+ * ```typescript
+ * import { ValironSDK } from '@valiron/sdk';
+ *
+ * const valiron = new ValironSDK({
+ *   apiKey: 'vln_your_api_key'
+ * });
+ *
+ * // Check if agent can access production
+ * const decision = await valiron.checkAgent('123');
+ * if (decision.route === 'prod') {
+ *   // Allow full production access
+ * }
+ * ```
+ */
+class ValironSDK {
+    constructor(config) {
+        this.trustClient = new clients_1.TrustClient(config);
+        this.reputationClient = new clients_1.ReputationClient(config);
+    }
+    /**
+     * Check agent routing decision
+     *
+     * This is the primary method for determining how to route requests from an agent.
+     * Valiron automatically handles sandbox testing if the agent hasn't been evaluated.
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Routing decision with detailed explanation
+     *
+     * @example
+     * ```typescript
+     * const result = await valiron.checkAgent('417');
+     *
+     * switch (result.route) {
+     *   case 'prod':
+     *     return handleProductionRequest();
+     *   case 'prod_throttled':
+     *     return handleThrottledRequest();
+     *   case 'sandbox':
+     *   case 'sandbox_only':
+     *     return rejectRequest();
+     * }
+     * ```
+     */
+    async checkAgent(agentId) {
+        return this.trustClient.checkAgent(agentId);
+    }
+    /**
+     * Check wallet routing decision
+     *
+     * Legacy method for wallet-based routing. Prefer `checkAgent()` for ERC-8004 agents.
+     *
+     * @param wallet - The wallet address
+     * @returns Routing decision
+     */
+    async checkWallet(wallet) {
+        return this.trustClient.checkWallet(wallet);
+    }
+    /**
+     * Get complete agent trust profile
+     *
+     * Returns comprehensive trust data including on-chain reputation,
+     * behavioral analysis scores, and routing logic.
+     *
+     * @param agentId - The ERC-8004 agent ID
+     * @returns Complete agent profile
+     *
+     * @example
+     * ```typescript
+     * const profile = await valiron.getAgentProfile('417');
+     * console.log(`Agent score: ${profile.localReputation?.score}`);
+     * console.log(`Tier: ${profile.localReputation?.tier}`);
+     * console.log(`On-chain feedback: ${profile.onchainReputation.count} entries`);
+     * ```
+     */
+    async getAgentProfile(agentId) {
+        return this.trustClient.getAgentProfile(agentId);
+    }
+    /**
+     * Get wallet profile
+     *
+     * @param wallet - The wallet address
+     * @returns Wallet profile with routing info
+     */
+    async getWalletProfile(wallet) {
+        return this.trustClient.getWalletProfile(wallet);
+    }
+    /**
+     * Submit feedback about an agent's behavior
+     *
+     * This allows you to report an agent's behavior to Valiron.
+     * Valiron handles IPFS storage and on-chain submission automatically.
+     *
+     * @param params - Feedback parameters
+     * @returns Submission result with transaction hash
+     *
+     * @example
+     * ```typescript
+     * await valiron.submitFeedback({
+     *   agentId: '417',
+     *   score: 95,
+     *   outcome: 'success',
+     *   metadata: {
+     *     taskType: 'data_processing',
+     *     duration: 1234
+     *   }
+     * });
+     * ```
+     */
+    async submitFeedback(params) {
+        return this.reputationClient.submitFeedback(params);
+    }
+    /**
+     * Manually trigger sandbox testing
+     *
+     * Useful for re-evaluating an agent or testing specific scenarios.
+     *
+     * @param params - Sandbox test parameters
+     * @returns Test trigger result
+     *
+     * @example
+     * ```typescript
+     * await valiron.triggerSandboxTest({
+     *   agentId: '417',
+     *   behaviorType: 'good'
+     * });
+     * ```
+     */
+    async triggerSandboxTest(params) {
+        return this.reputationClient.triggerSandboxTest(params);
+    }
+}
+exports.ValironSDK = ValironSDK;
+// Export everything
+__exportStar(require("./types"), exports);
+__exportStar(require("./clients"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAA0D;AAU1D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,UAAU;IAIrB,YAAY,MAAqB;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,qBAAW,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,IAAI,0BAAgB,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAc;QACnC,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,cAAc,CAAC,MAA4B;QAC/C,OAAO,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAyB;QAChD,OAAO,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;CACF;AA7HD,gCA6HC;AAED,oBAAoB;AACpB,0CAAwB;AACxB,4CAA0B"}

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Valiron SDK Types
+ *
+ * Type definitions for the Valiron Trust Layer API
+ */
+export type RouteDecision = 'prod' | 'prod_throttled' | 'sandbox' | 'sandbox_only';
+export type RiskLevel = 'GREEN' | 'YELLOW' | 'RED';
+export type MoodysRating = 'AAA' | 'AA' | 'A' | 'BAA' | 'BA' | 'B' | 'CAA' | 'CA' | 'C';
+export interface OnChainReputation {
+    feedbackCount: number;
+    averageScore: number;
+    agentId?: string;
+    wallet?: string;
+}
+export interface LocalReputation {
+    score: number;
+    tier: MoodysRating;
+    riskLevel: RiskLevel;
+    graduated?: boolean;
+    metrics?: BehavioralMetrics;
+    ipfsCid?: string;
+    updatedAt?: number;
+}
+export interface BehavioralMetrics {
+    loops?: number;
+    totalRequests?: number;
+    respected429?: boolean;
+    errorRate?: number;
+    averageLatency?: number;
+    burstiness?: number;
+}
+export interface RoutingResponse {
+    route: RouteDecision;
+    reason: string;
+    onChainData?: OnChainReputation;
+    localReputation?: LocalReputation;
+    explanation: string;
+}
+export interface AgentIdentity {
+    agentId: string;
+    wallet: string;
+    name?: string;
+    description?: string;
+    image?: string;
+    endpoints?: string[];
+    externalUri?: string;
+}
+export interface FeedbackEntry {
+    clientAddress: string;
+    score: number;
+    timestamp: number;
+    tag1?: string;
+    tag2?: string;
+    endpoint?: string;
+    feedbackURI?: string;
+    feedbackHash?: string;
+    revoked?: boolean;
+    response?: string;
+}
+export interface AgentProfile {
+    agentId: string;
+    identity: AgentIdentity;
+    onchainReputation: {
+        count: number;
+        averageScore: number;
+        feedbackEntries: FeedbackEntry[];
+    };
+    localReputation?: LocalReputation;
+    routing: {
+        finalRoute: RouteDecision;
+        decision: string;
+        reasons: string[];
+        signals: {
+            onChainQualifies: boolean;
+            hasLocalReputation: boolean;
+            localRiskLevel?: RiskLevel;
+        };
+    };
+}
+export interface WalletProfile {
+    wallet: string;
+    agentId?: string;
+    route: RouteDecision;
+    score?: number;
+    tier?: MoodysRating;
+    onChainData?: OnChainReputation;
+    localReputation?: LocalReputation;
+}
+export interface ValironConfig {
+    /**
+     * Your Valiron API key.
+     *
+     * Note: Authentication is not yet enforced by the Valiron edge proxy,
+     * so this field is currently optional and not validated. It is kept
+     * for future compatibility when API key validation is implemented.
+     */
+    apiKey?: string;
+    /**
+     * Valiron API endpoint (defaults to production)
+     */
+    endpoint?: string;
+    /**
+     * Request timeout in milliseconds (default: 5000)
+     */
+    timeout?: number;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+}
+export interface SubmitFeedbackParams {
+    agentId: string;
+    score: number;
+    outcome: 'success' | 'failure';
+    metadata?: Record<string, any>;
+}
+export interface SandboxTestParams {
+    agentId: string;
+    behaviorType?: 'good' | 'moderate' | 'bad';
+}
+export declare class ValironError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Valiron SDK Types
+ *
+ * Type definitions for the Valiron Trust Layer API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValironError = void 0;
+class ValironError extends Error {
+    constructor(message, code, statusCode) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'ValironError';
+    }
+}
+exports.ValironError = ValironError;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA+IH,MAAa,YAAa,SAAQ,KAAK;IACrC,YACE,OAAe,EACR,IAAY,EACZ,UAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AATD,oCASC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@valiron/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for Valiron - Trust Layer for Agentic Economy",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node test/validate.mjs && node test/validate-examples.mjs",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "valiron",
+    "ai-agents",
+    "trust",
+    "reputation",
+    "erc8004",
+    "blockchain",
+    "web3"
+  ],
+  "author": "Valiron",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}