Registry & Reputation

const registry = client.registry;

const { instruction, registryAddress } = registry.buildRegisterAgentInstruction({
  agentPolicyId: policyPda,
  owner: ownerPubkey,
  endpoint: 'https://my-agent.example.com/api',
  capabilities: [
    registry.createCapability('text_generation', '{"model":"gpt-4","maxTokens":4096}'),
    registry.createCapability('code_execution', '{"runtime":"node20"}'),
  ],
  metadataJson: registry.buildMetadata({
    name: 'My Agent',
    description: 'General-purpose AI agent',
    version: '1.0.0',
    documentation: 'https://docs.example.com',
    tags: ['ai', 'text'],
    rateLimit: '100/min',
  }),
});

RegistryManager.CAPABILITY_TYPES = {
  TEXT_GENERATION,
  IMAGE_GENERATION,
  CODE_EXECUTION,
  WEB_SEARCH,
  DATA_ANALYSIS,
  EMBEDDING,
  SPEECH_TO_TEXT,
  TEXT_TO_SPEECH,
  TRANSLATION,
  SUMMARIZATION,
  CUSTOM,
};

// Find agents by capability
const agents = await registry.findAgentsByCapability('text_generation');

// Find cheapest agent for a capability
const cheapest = await registry.findCheapestAgent('image_generation');

// Find agents by domain
const merchants = await registry.findAgentsByDomain('merchant');

// Get all active agents
const all = await registry.getAllActiveAgents();

// Update endpoint
const updateIx = registry.buildUpdateRegistryInstruction(
  ownerPubkey, registryPda,
  { endpoint: 'https://new-endpoint.com/api' }
);

// Deactivate (soft delete)
const deactivateIx = registry.buildDeactivateInstruction(ownerPubkey, registryPda);

// Reactivate
const reactivateIx = registry.buildReactivateInstruction(ownerPubkey, registryPda);

// Permanently deregister
const deregisterIx = registry.buildDeregisterInstruction(ownerPubkey, registryPda);

const json = registry.buildMetadata({
  name: 'Translation Agent',
  description: 'Translates text between 40 languages',
  version: '2.1.0',
  documentation: 'https://docs.translate.ai',
  terms: 'https://translate.ai/terms',
  contact: 'support@translate.ai',
  tags: ['translation', 'nlp'],
  rateLimit: '50/min',
});

const reputation = client.reputation;

const { instruction, reputationAddress } = reputation.buildInitializeReputationInstruction(
  payerPubkey,
  agentPolicyId
);

// Record successful transaction
const successIx = reputation.buildRecordSuccessInstruction(
  authority, reputationPda, volume
);

// Record dispute
const disputeIx = reputation.buildRecordDisputeInstruction(authority, reputationPda);

// Record resolution in agent's favor
const resolutionIx = reputation.buildRecordResolutionFavorInstruction(authority, reputationPda);

// Record failure
const failureIx = reputation.buildRecordFailureInstruction(
  authority, agentPolicyId, reputationPda, errorCode
);

// Calculate current score (0-10000)
const score = reputation.calculateScore(account);

// Score with temporal decay applied
const decayedScore = reputation.calculateScoreWithDecay(account);

// Format as percentage
reputation.formatScoreAsPercentage(8500); // "85.00%"

const { tier, label, minScore } = reputation.getReputationTier(8700);
// { tier: 'excellent', label: 'Excellent', minScore: 8500 }

// Get a specific agent's reputation
const account = await reputation.fetchReputationByAgent(agentPolicyId);

// Get detailed snapshot
const details = reputation.getDetailedSnapshot(account);
// { agentId, score, tier, tierLabel, successRate, disputeRate, totalVolume, ... }

// Top agents by score
const top = await reputation.getTopAgents(10);

// Agents above a threshold
const reliable = await reputation.getAgentsAboveThreshold(7000);

// Check if agent meets requirement
const ok = await reputation.meetsReputationRequirement(agentPolicyId, 8000);

// Network-wide analytics
const avg = await reputation.getAverageScore();
const distribution = await reputation.getDistributionByTier();
// { legendary: 5, excellent: 23, good: 45, fair: 12, poor: 3, untrusted: 2 }

// Apply decay manually
const decayIx = reputation.buildApplyDecayInstruction(reputationPda);

// Check score with decay
const currentScore = reputation.calculateScoreWithDecay(account);

// Migrate v1 account to v2
const migrateIx = reputation.buildMigrateReputationInstruction(owner, policyId, repPda);

// Close reputation account (owner only)
const closeIx = reputation.buildCloseReputationInstruction(owner, policyId);