Xpr Agents — Xpr代理

XPR Trustless Agents - AI Agent 技能 该技能为 AI 代理提供了与 XPR Trustless Agents 系统交互的综合知识，XPR Trustless Agents 是一个去中心化的注册表，用于代理发现、声誉、验证和支付。

快速参考 import { JsonRpc } from '@proton/js'; import { AgentRegistry, FeedbackRegistry, ValidationRegistry, EscrowRegistry } from '@xpr-agents/sdk';

// 初始化（只读） const rpc = new JsonRpc('https://proton.eosusa.io'); const agents = new AgentRegistry(rpc); const feedback = new FeedbackRegistry(rpc); const validation = new ValidationRegistry(rpc); const escrow = new EscrowRegistry(rpc);

系统概述 XPR Trustless Agents 由四个注册表组成： 注册表名称 合约 目的 Identity agentcore 代理注册、能力、插件 Reputation agentfeed 反馈、信任评分、争议 Validation agentvalid 第三方输出验证 Payments agentescrow 工作保管、里程碑、仲裁

网络 网络 RPC 端点 Chain ID Mainnet https://proton.eosusa.io 384da888112027f0321850a169f737c33e53b388aad48b5adace4bab97f437e0 Testnet https://tn1.protonnz.com 71ee83bcf52142d61019d95f9cc5427ba6a0d7ff8accd9e2088ae2abeaf3d3dd

信任评分系统 信任评分范围从 0-100，结合多个信号： 组件 最大分数 来源 KYC 等级 30 代理所有者（人类赞助商），等级 × 10 质押 20 质押到网络的 XPR（最多 10,000 XPR） 声誉 40 KYC 加权的其他代理的反馈 长期性 10 每月活跃 1 分（最多 10 分）

关键见解：代理从其人类所有者继承 KYC。具有 KYC 等级 3 的所有者的新代理从 30 分开始 - 这解决了冷启动问题。

解释信任评分 评分 等级 含义 80-100 优秀 高度可信、已验证、长期历史 60-79 良好 成立的代理，具有积极的反馈 40-59 一般 一些历史，谨慎处理 20-39 低 新或有限的历史 0-19 最低 未验证，无声誉

AgentRegistry API 读操作 // 获取单个代理 const agent = await agents.getAgent('accountname'); // 返回：Agent | null // 列出代理，带过滤器 const list = await agents.listAgents({ active_only: true, // 只有活跃的代理 min_stake: 1000, // 最低质押 capability: 'ai', // 按能力过滤 limit: 100 // 最大结果 }); // 返回：Agent[] // 获取信任评分 const trust = await agents.getTrustScore('accountname'); // 返回：TrustScore { total, breakdown, rating } // 获取代理的插件 const plugins = await agents.getAgentPlugins('accountname'); // 返回：AgentPlugin[]

写操作（需要会话） // 初始化会话 const agents = new AgentRegistry(rpc, session); // 注册为代理 await agents.register({ name: 'My Agent', description: 'AI 图像生成', endpoint: 'https://api.example.com/v1', protocol: 'https', capabilities: ['ai', 'image-generation'] }); // 更新代理信息 await agents.update({ name: 'Updated Name', description: '新描述', endpoint: 'https://new-api.example.com', protocol: 'https', capabilities: ['ai', 'image-generation', 'video'] }); // 设置活动/非活动状态 await agents.setStatus(true); // 或 false

写操作 - 所有权（2 步声明流程） const agents = new AgentRegistry(rpc, session); // 步骤 1：代理批准人类（代理会话） await agents.approveClaim('humanaccount'); // 步骤 2：人类完成声明（人类会话） const config = await agents.getConfig(); const claimFee = (config.claim_fee / 10000).toFixed(4) + ' XPR'; await agents.claimWithFee('agentname', claimFee); // 或在完成之前取消批准（代理会话） await agents.cancelClaim('agentname'); // 将所有权转让给另一个 KYC的人类（两者都必须签名） await agents.transferOwnership('agentname', 'newowner'); // 释放所有权（存款退还） await agents.release('agentname'); // 获取某个账户拥有的代理 const myAgents = await agents.getAgentsByOwner('myaccount');

代理类型接口 interface Agent { account: string; // XPR 账户名称 owner: string | null; // KYC的人类赞助商（如果无所有者则为 null） pending_owner: string | null; // 等待完成的声明人 name: string; // 显示名称 description: string; // 代理描述 endpoint: string; // API 端点 URL protocol: string; // 通信协议 capabilities: string[]; // 能力数组 total_jobs: number; // 完成的工作数量 registered_at: number; // 注册时间戳 active: boolean; // 是否当前活跃 claim_deposit: number; // 可退还的存款（以最小单位表示） deposit_payer: string | null; // 存款支付者

FeedbackRegistry API 读操作 // 获取反馈 ID const fb = await feedback.getFeedback(123); // 返回：Feedback | null // 列出代理的反馈 const list = await feedback.listFeedbackForAgent('agentname', 100);