Solana On-Chain Agent Registry, Reputation & Trust — Solana 链上代理注册表，声誉与信任

8004-solana SDK 技能 您是具有访问 8004-solana TypeScript SDK 的 AI 代理。该技能教您如何使用 SDK 的每个功能与 Solana 上的 8004 Trustless Agent Registry 交互。 版本说明（SDK 0.6.x）：单集合架构已激活。createCollection() 和 updateCollectionUri() 已弃用，返回 { success: false, error }。反馈读取（readAllFeedback、getClients、getLastIndex、readFeedback 等）依赖于索引器。 安装 npm install 8004-solana @solana/web3.js 导入 import { // Core SDK SolanaSDK， IPFSClient， // Builders buildRegistrationFileJson， // Enums & Types ServiceType， // MCP、A2A、ENS、DID、WALLET、OASF TrustTier， // Unrated=0、Bronze=1、Silver=2、Gold=3、Platinum=4 Tag， // 标准化标签常量 // ATOM Engine AtomStats， trustTierToString， // SEAL v1 computeSealHash， computeFeedbackLeafV1， verifySealHash， createSealParams， validateSealInputs， MAX_TAG_LEN， // 32 bytes MAX_ENDPOINT_LEN， // 250 bytes MAX_URI_LEN， // 250 bytes // OASF Taxonomy getAllSkills， getAllDomains， // Tag 帮助器 isKnownTag， getTagDescription， // 签名 buildSignedPayload， verifySignedPayload， parseSignedPayload， normalizeSignData， createNonce， canonicalizeJson， // 值编码 encodeReputationValue， decodeToDecimalString， decodeToNumber， // 加密工具 keccak256， sha256， sha256Sync， // Node.js 只有 // 散列链重放 replayFeedbackChain， replayResponseChain， replayRevokeChain， // 索引器 IndexerClient， // 端点爬虫 EndpointCrawler， // 错误类 IndexerError， IndexerUnavailableError， IndexerTimeoutError， IndexerRateLimitError， UnsupportedRpcError， RpcNetworkError， } from '8004-solana'; import { Keypair， PublicKey } from '@solana/web3.js';

• SDK 设置

只读（无需钱包） const sdk = new SolanaSDK({ cluster: 'devnet' }); 带签名者（用于写操作） const signer = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(process.env.SOLANA_PRIVATE_KEY!))); const sdk = new SolanaSDK({ signer }); 自定义 RPC（用于批量查询） const sdk = new SolanaSDK({ rpcUrl: 'https://your-helius-rpc.helius.dev'， signer， }); 完整配置 const sdk = new SolanaSDK({ cluster: 'devnet'， rpcUrl: 'https://...'， signer: keypair， indexerUrl: 'https://xxx.supabase.co/rest/v1'， indexerApiKey: process.env.INDEXER_API_KEY， // 如果您的索引器需要 API 密钥，请将其保存在环境变量中 useIndexer: true， indexerFallback: true， forceOnChain: false， });

IPFS 客户端 // Pinata（推荐） const ipfsPinata = new IPFSClient({ pinataEnabled: true， pinataJwt: process.env.PINATA_JWT!， }); // 本地节点 const ipfsLocal = new IPFSClient({ url: 'http://localhost:5001' });

• 注册代理

步骤 1：构建元数据 const metadata = buildRegistrationFileJson({ name: 'My Agent'， description: 'Autonomous trading agent'， image: 'ipfs://QmImageCid...'， services: [ { type: ServiceType.MCP， value: 'https://my-agent.com/mcp' }， { type: ServiceType.A2A， value: 'https://my-agent.com/a2a' }， ]， skills: ['advanced_reasoning_planning/strategic_planning']， domains: ['finance_and_business/finance']， x402Support: true， });

步骤 2：上传到 IPFS const cid = await ipfs.addJson(metadata);

步骤 3：在链上注册 const result = await sdk.registerAgent(ipfs://${cid}); // result.asset -> PublicKey（代理 NFT 地址） // result.signature -> 交易签名 // ATOM 统计信息自动初始化

步骤 4：设置运营钱包 const opWallet = Keypair.generate(); await sdk.setAgentWallet(result.asset， opWallet);

集合（v0.6.x：单集合） 所有代理自动注册到基本集合中。createCollection() 和 updateCollectionUri() 已弃用，返回 { success: false }。 const baseCollection = await sdk.getBaseCollection();

• 读取代理数据

// 加载代理 const agent = await sdk.loadAgent(assetPubkey); // agent.getOwnerPublicKey()、agent.getAgentWalletPublicKey()、agent.agent_uri 等 // 检查存在 const exists = await sdk.agentExists(assetPubkey); // 获取所有者 const owner = await sdk.getAgentOwner(assetPubkey); // 检查所有权 const isMine = await sdk.isAgentOwner(assetPubkey， myPubkey); // 链上元数据 const version = await sdk.getMetadata(assetPubkey， 'version');

批量查询（需要高级 RPC：Helius、QuickNode、Alchemy） const allAgents = await sdk.getAllAgents(); const withFeedbacks = await sdk.getAllAgents({ includeFeedbacks: true }); const myAgents = await sdk.getAgentsByOwner(ownerPubkey);

• 更新代理

// 更新元数据 URI await sdk.setAgentUri(assetPubkey， collectionPubkey， ipfs://${newCid}); // 设置链上键值元数据 await sdk.setMetadata(assetPubkey， 'version'， '2.0.0'); // 首次调用：~0.00319 SOL（PDA 租赁）。更新：~0.000005 SOL（仅事务费用） // 立即生效