Register Your First Agent

import { Connection, Keypair } from '@solana/web3.js'; // Solana SDK for RPC and wallet types
import { AnchorProvider, Program, Wallet } from '@coral-xyz/anchor'; // Anchor framework for Solana programs
import { readFileSync } from 'fs'; // Node filesystem to load keypair file
import { homedir } from 'os'; // Resolve ~ to the user's home directory
import { join } from 'path'; // Build cross-platform file paths
import { IDL } from '@vouch-protocol/sdk'; // The Vouch program IDL for Anchor

// Connect to Solana devnet (switch to mainnet-beta for production)
const connection = new Connection('https://api.devnet.solana.com');

// Load keypair from file (~ does not work in Node — use homedir())
const keypair = Keypair.fromSecretKey(new Uint8Array(JSON.parse(
  readFileSync(join(homedir(), '.config/solana/id.json'), 'utf-8')
))); // Reconstruct Keypair from the Solana CLI default keypair file

// Set up Anchor provider and program
const wallet = new Wallet(keypair); // Wrap keypair in an Anchor-compatible Wallet
const provider = new AnchorProvider(connection, wallet, { commitment: 'confirmed' }); // Create the Anchor provider
const program = new Program(IDL, provider); // Instantiate the Vouch on-chain program

import crypto from 'crypto'; // Node crypto for SHA-256 hashing

// Assign the Agent Card as a variable so we can hash it
const agentCard = {
  name: "my-commerce-agent",
  description: "Handles product search and checkout",
  url: "https://example.com/agent",
  version: "1.0.0",
  capabilities: { streaming: false, pushNotifications: false },
  skills: [{
    id: "product-search",
    name: "Product Search",
    description: "Search products by keyword or category"
  }]
};

// Compute SHA-256 hash as a number[] (required by the on-chain instruction)
const cardHash = Array.from(new Uint8Array(
  crypto.createHash('sha256').update(JSON.stringify(agentCard)).digest()
)); // 32-element number[] for on-chain integrity verification

import { RegistryClient } from '@vouch-protocol/sdk'; // Vouch SDK registry helpers

const registry = new RegistryClient(program, provider); // Initialize the client with Anchor program and provider

const txSig = await registry.registerAgent({ // Submit the on-chain registration transaction
  owner: wallet.publicKey, // The wallet that owns this agent identity
  name: 'my-commerce-agent', // Human-readable agent name (stored on-chain)
  serviceCategory: { commerce: {} }, // Categorize for discovery (Anchor enum variant)
  agentCardUrl: 'https://example.com/agent-card.json', // Public URL of the A2A Agent Card
  agentCardHash: cardHash, // SHA-256 hash so verifiers can confirm card integrity
});

console.log('Registered! Tx:', txSig); // Log the Solana transaction signature

// Wait for the transaction to be confirmed on-chain
await connection.confirmTransaction(txSig, 'confirmed');

const agent = await registry.fetchAgentByOwner(wallet.publicKey); // Fetch the on-chain agent identity by wallet owner

console.log('Name:', agent.name);
console.log('Status:', Object.keys(agent.status)[0]);        // "active"
console.log('Tier:', Object.keys(agent.tier)[0]);              // "observer" — no USDC staked yet
console.log('Reputation:', agent.reputationScore);  // 250 — every agent starts at 250
console.log('Card URL:', agent.agentCardUrl); // The A2A Agent Card URL you provided

const did = RegistryClient.deriveAgentDid(wallet.publicKey); // Deterministically derive the W3C DID from the owner pubkey
console.log('DID:', did);
// did:sol:7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU