SDK_DOCUMENTATION

TRUVA PROTOCOL SDK · VERSION 2.4.0 · TYPESCRIPT

VERIFIEDLAST_UPDATED: 2024-05-24

QUICK_START

1. INSTALL_PACKAGE

bash

npm install @truva/sdk @truva/core

2. INITIALIZE_CLIENT

typescript

import { TruvaClient } from '@truva/sdk';

const client = new TruvaClient({
  apiKey: process.env.TRUVA_API_KEY,
  network: 'mainnet',
  region: 'global',
});

// Validate a transaction
const result = await client.trustgate.validate({
  agentId: '0xAF2C...FFC2',
  txHash: '0xB5Fe01...',
  amount: 1500.00,
  currency: 'USDC',
});

console.log(result.status); // 'PASSED'
console.log(result.latency); // '12ms'

3. REGISTER_AN_AGENT

typescript

const agent = await client.agents.register({
  name: 'ALPHA_LIQUIDITY_BOT',
  publicKey: '0x...',
  category: 'FINANCIAL_ARBITRAGE',
  capabilities: ['SWAP_EXECUTION', 'LP_MANAGEMENT'],
  stakeAmount: 50000,
});

console.log(agent.id);     // '0xNEW...ID'
console.log(agent.tier);   // 'SANDBOX_ACCESS'
console.log(agent.status); // 'PENDING_VALIDATION'

API_REFERENCE

METHOD	ENDPOINT	DESCRIPTION	AUTH
GET	/api/v1/agents	List all registered agents	API_KEY
GET	/api/v1/agents/:id	Get agent passport by ID	API_KEY
POST	/api/v1/agents/register	Register a new agent	API_KEY + SIGNATURE
GET	/api/v1/trustgate/logs	Stream TrustGate validation logs	API_KEY
POST	/api/v1/trustgate/validate	Submit transaction for validation	API_KEY + ZK_PROOF
GET	/api/v1/reputation/:agentId	Get reputation score & history	API_KEY
POST	/api/v1/reputation/attest	Submit validator attestation	VALIDATOR_KEY
GET	/api/v1/validators/status	Current validator node status	NONE

TRUSTGATE_SDK

Real-time transaction validation with configurable risk thresholds and ZK-proof integration.

AGENT_FRAMEWORK

REPUTATION_API

Query global trust scores, validator attestations, and cross-chain reputation data.