@cascade-fyi/sati-sdk 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0] - 2026-02-12
+
+### Breaking Changes
+
+- **Feedback content fields renamed for ERC-8004 alignment**: `score` -> `value`, `tags` -> `tag1`/`tag2`, added `valueDecimals`
+  - `GiveFeedbackParams`: `score?` -> `value?`, `tags?` -> `tag1?`/`tag2?`, added `valueDecimals?`
+  - `ParsedFeedback`: `score?` -> `value?`, `tags` -> `tag1?`/`tag2?`, added `valueDecimals?`
+  - `FeedbackSearchOptions`: `minScore`/`maxScore` -> `minValue`/`maxValue`, `tags?` -> `tag1?`/`tag2?`
+  - `ReputationSummary`: `averageScore` -> `averageValue`
+  - `FeedbackContent`: `score?` -> `value?`, `tags?` -> `tag1?`/`tag2?`, added `valueDecimals?`
+- **`getReputationSummary` signature changed**: `(agentMint, tags?)` -> `(agentMint, tag1?, tag2?)`
+- **Registration file fields renamed**: `endpoints` -> `services`, `x402support` -> `x402Support`
+
 ## [0.7.0] - 2026-02-12
 
 ### Added
@@ -144,6 +157,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Compressed attestation storage via Light Protocol
 - Basic querying via Photon RPC
 
+[0.8.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.7.0...@cascade-fyi/sati-sdk@0.8.0
 [0.7.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.6.0...@cascade-fyi/sati-sdk@0.7.0
 [0.6.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.5.0...@cascade-fyi/sati-sdk@0.6.0
 [0.5.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.4.2...@cascade-fyi/sati-sdk@0.5.0

package/dist/index.cjs

@@ -2937,17 +2937,17 @@ let DataType = /* @__PURE__ */ function(DataType$1) {
 /**
 * Feedback outcome values (ERC-8004 compatible)
 *
-* For ERC-8004 score mapping:
-* - Negative(0) → 0
-* - Neutral(1) → 50
-* - Positive(2) → 100
+* Maps to ERC-8004 outcome semantics:
+* - Negative(0) - unfavorable interaction
+* - Neutral(1) - default / no strong signal
+* - Positive(2) - favorable interaction
 */
 let Outcome = /* @__PURE__ */ function(Outcome$1) {
-	/** Negative feedback (score 0) */
+	/** Negative feedback */
 	Outcome$1[Outcome$1["Negative"] = 0] = "Negative";
-	/** Neutral feedback (score 50) */
+	/** Neutral feedback (default) */
 	Outcome$1[Outcome$1["Neutral"] = 1] = "Neutral";
-	/** Positive feedback (score 100) */
+	/** Positive feedback */
 	Outcome$1[Outcome$1["Positive"] = 2] = "Positive";
 	return Outcome$1;
 }({});
@@ -4323,7 +4323,7 @@ function bytesToHex(bytes) {
 *   outcome: Outcome.Positive,
 *   dataHash: dataHash,
 *   contentType: ContentType.JSON,
-*   content: new TextEncoder().encode('{"score": 95, "tags": ["fast"]}'),
+*   content: new TextEncoder().encode('{"value": 95, "valueDecimals": 0, "tag1": "quality"}'),
 * });
 *
 * // Build counterparty message
@@ -4842,11 +4842,11 @@ const RegistrationFileSchema = zod.object({
 	image: zod.url(),
 	properties: PropertiesSchema,
 	external_url: zod.url().optional(),
-	endpoints: zod.array(EndpointSchema).optional(),
+	services: zod.array(EndpointSchema).optional(),
 	registrations: zod.array(RegistrationEntrySchema).optional(),
 	supportedTrust: zod.array(TrustMechanismSchema).optional(),
 	active: zod.boolean().optional().default(true),
-	x402support: zod.boolean().optional()
+	x402Support: zod.boolean().optional()
 });
 const MIME_TYPES = {
 	png: "image/png",
@@ -4889,11 +4889,11 @@ function buildRegistrationFile(params) {
 			category: "image"
 		},
 		...params.externalUrl && { external_url: params.externalUrl },
-		...params.endpoints?.length && { endpoints: params.endpoints },
+		...params.services?.length && { services: params.services },
 		...params.registrations?.length && { registrations: params.registrations },
 		...params.supportedTrust?.length && { supportedTrust: params.supportedTrust },
 		active: params.active ?? true,
-		...params.x402support !== void 0 && { x402support: params.x402support }
+		...params.x402Support !== void 0 && { x402Support: params.x402Support }
 	};
 	return RegistrationFileSchema.parse(file);
 }
@@ -5029,7 +5029,7 @@ var SatiAgentBuilder = class {
 			name,
 			description,
 			image,
-			endpoints: [],
+			services: [],
 			active: true
 		};
 	}
@@ -5043,9 +5043,9 @@ var SatiAgentBuilder = class {
 	}
 	/** Set a generic endpoint. */
 	setEndpoint(endpoint) {
-		if (!this._params.endpoints) this._params.endpoints = [];
-		this._params.endpoints = this._params.endpoints.filter((ep) => ep.name !== endpoint.name);
-		this._params.endpoints.push(endpoint);
+		if (!this._params.services) this._params.services = [];
+		this._params.services = this._params.services.filter((ep) => ep.name !== endpoint.name);
+		this._params.services.push(endpoint);
 		return this;
 	}
 	/**
@@ -5082,7 +5082,7 @@ var SatiAgentBuilder = class {
 	}
 	/** Remove an endpoint by name. */
 	removeEndpoint(name) {
-		if (this._params.endpoints) this._params.endpoints = this._params.endpoints.filter((ep) => ep.name !== name);
+		if (this._params.services) this._params.services = this._params.services.filter((ep) => ep.name !== name);
 		return this;
 	}
 	/** Set agent active status. */
@@ -5092,7 +5092,7 @@ var SatiAgentBuilder = class {
 	}
 	/** Set x402 payment support. */
 	setX402Support(x402) {
-		this._params.x402support = x402;
+		this._params.x402Support = x402;
 		return this;
 	}
 	/** Set supported trust mechanisms. */
@@ -6447,8 +6447,9 @@ var Sati = class {
 	* const result = await sati.giveFeedback({
 	*   payer: myKeypair,
 	*   agentMint: address("Agent..."),
-	*   score: 85,
-	*   tags: ["quality", "speed"],
+	*   value: 87,
+	*   valueDecimals: 0,
+	*   tag1: "starred",
 	*   message: "Great response time",
 	* });
 	* ```
@@ -6456,10 +6457,13 @@ var Sati = class {
 	async giveFeedback(params) {
 		const schema = this._requireFeedbackPublicSchema();
 		const payer = params.payer;
-		if (params.score !== void 0 && (!Number.isFinite(params.score) || params.score < 0 || params.score > 100)) throw new Error(`Feedback score must be a finite number between 0 and 100, got: ${params.score}`);
+		if (params.value !== void 0 && !Number.isFinite(params.value)) throw new Error(`Feedback value must be a finite number, got: ${params.value}`);
+		if (params.valueDecimals !== void 0 && (params.valueDecimals < 0 || params.valueDecimals > 18)) throw new Error(`valueDecimals must be 0-18, got: ${params.valueDecimals}`);
 		const contentObj = {};
-		if (params.score !== void 0) contentObj.score = params.score;
-		if (params.tags?.length) contentObj.tags = params.tags;
+		if (params.value !== void 0) contentObj.value = params.value;
+		if (params.valueDecimals !== void 0) contentObj.valueDecimals = params.valueDecimals;
+		if (params.tag1) contentObj.tag1 = params.tag1;
+		if (params.tag2) contentObj.tag2 = params.tag2;
 		if (params.endpoint) contentObj.endpoint = params.endpoint;
 		if (params.message) contentObj.m = params.message;
 		const content = Object.keys(contentObj).length > 0 ? new TextEncoder().encode(JSON.stringify(contentObj)) : new Uint8Array(0);
@@ -6510,10 +6514,13 @@ var Sati = class {
 	*/
 	async prepareFeedback(params) {
 		const schema = this._requireFeedbackPublicSchema();
-		if (params.score !== void 0 && (!Number.isFinite(params.score) || params.score < 0 || params.score > 100)) throw new Error(`Feedback score must be a finite number between 0 and 100, got: ${params.score}`);
+		if (params.value !== void 0 && !Number.isFinite(params.value)) throw new Error(`Feedback value must be a finite number, got: ${params.value}`);
+		if (params.valueDecimals !== void 0 && (params.valueDecimals < 0 || params.valueDecimals > 18)) throw new Error(`valueDecimals must be 0-18, got: ${params.valueDecimals}`);
 		const contentObj = {};
-		if (params.score !== void 0) contentObj.score = params.score;
-		if (params.tags?.length) contentObj.tags = params.tags;
+		if (params.value !== void 0) contentObj.value = params.value;
+		if (params.valueDecimals !== void 0) contentObj.valueDecimals = params.valueDecimals;
+		if (params.tag1) contentObj.tag1 = params.tag1;
+		if (params.tag2) contentObj.tag2 = params.tag2;
 		if (params.endpoint) contentObj.endpoint = params.endpoint;
 		if (params.message) contentObj.m = params.message;
 		const content = Object.keys(contentObj).length > 0 ? new TextEncoder().encode(JSON.stringify(contentObj)) : new Uint8Array(0);
@@ -6544,8 +6551,10 @@ var Sati = class {
 			sasSchema: schema,
 			lookupTable: this._deployedConfig?.lookupTable,
 			meta: {
-				score: params.score,
-				tags: params.tags ? [...params.tags] : void 0,
+				value: params.value,
+				valueDecimals: params.valueDecimals,
+				tag1: params.tag1,
+				tag2: params.tag2,
 				message: params.message,
 				endpoint: params.endpoint
 			}
@@ -6611,8 +6620,8 @@ var Sati = class {
 	* ```typescript
 	* const feedbacks = await sati.searchFeedback({
 	*   agentMint: address("Agent..."),
-	*   tags: ["quality"],
-	*   minScore: 70,
+	*   tag1: "starred",
+	*   minValue: 70,
 	* });
 	* ```
 	*/
@@ -6631,15 +6640,16 @@ var Sati = class {
 		const feedbacks = [];
 		for (const item of result.items) {
 			const rawContent = this._parseContentJson(item.data.content, item.data.contentType);
-			const score = rawContent?.score;
-			const tags = rawContent?.tags ?? [];
+			const value = rawContent?.value;
+			const valueDecimals = rawContent?.valueDecimals;
+			const tag1 = rawContent?.tag1;
+			const tag2 = rawContent?.tag2;
 			const message = rawContent?.m;
 			const endpoint = rawContent?.endpoint;
-			if (options?.tags?.length) {
-				if (!options.tags.every((t) => tags.includes(t))) continue;
-			}
-			if (options?.minScore !== void 0 && (score === void 0 || score < options.minScore)) continue;
-			if (options?.maxScore !== void 0 && (score === void 0 || score > options.maxScore)) continue;
+			if (options?.tag1 !== void 0 && tag1 !== options.tag1) continue;
+			if (options?.tag2 !== void 0 && tag2 !== options.tag2) continue;
+			if (options?.minValue !== void 0 && (value === void 0 || value < options.minValue)) continue;
+			if (options?.maxValue !== void 0 && (value === void 0 || value > options.maxValue)) continue;
 			const slotDiff = Number(BigInt(currentSlot) - item.raw.slotCreated);
 			const createdAt = nowSec - Math.floor(slotDiff * .4);
 			const [compressedAddress] = (0, __solana_kit.getAddressDecoder)().read(item.address, 0);
@@ -6648,8 +6658,10 @@ var Sati = class {
 				agentMint: item.data.agentMint,
 				counterparty: item.data.counterparty,
 				outcome: item.data.outcome,
-				score,
-				tags,
+				value,
+				valueDecimals,
+				tag1,
+				tag2,
 				message,
 				endpoint,
 				createdAt
@@ -6675,15 +6687,15 @@ var Sati = class {
 	/**
 	* Get reputation summary for an agent.
 	*
-	* Aggregates feedback scores, optionally filtered by tags.
+	* Aggregates feedback values, optionally filtered by tag1 and/or tag2.
 	*
 	* @example
 	* ```typescript
 	* const summary = await sati.getReputationSummary(address("Agent..."));
-	* console.log(`${summary.count} reviews, avg ${summary.averageScore}`);
+	* console.log(`${summary.count} reviews, avg ${summary.averageValue}`);
 	* ```
 	*/
-	async getReputationSummary(agentMint, tags) {
+	async getReputationSummary(agentMint, tag1, tag2) {
 		const schema = this._deployedConfig?.schemas.feedbackPublic ?? this._deployedConfig?.schemas.feedback;
 		if (!schema) throw new Error(`No feedback schema deployed for network "${this.network}"`);
 		const cacheKey = FeedbackCache.cacheKey(schema, agentMint);
@@ -6695,23 +6707,25 @@ var Sati = class {
 		if (!cached) this._feedbackCache.set(cacheKey, result);
 		if (result.items.length === 0) return {
 			count: 0,
-			averageScore: 0
+			averageValue: 0
 		};
 		let sum = 0;
 		let count = 0;
 		for (const item of result.items) {
 			const rawContent = this._parseContentJson(item.data.content, item.data.contentType);
-			const score = rawContent?.score;
-			const itemTags = rawContent?.tags ?? [];
-			if (tags?.length && !tags.every((t) => itemTags.includes(t))) continue;
-			if (score !== void 0) {
-				sum += score;
+			const value = rawContent?.value;
+			const itemTag1 = rawContent?.tag1;
+			const itemTag2 = rawContent?.tag2;
+			if (tag1 !== void 0 && itemTag1 !== tag1) continue;
+			if (tag2 !== void 0 && itemTag2 !== tag2) continue;
+			if (value !== void 0) {
+				sum += value;
 				count++;
 			}
 		}
 		return {
 			count,
-			averageScore: count > 0 ? sum / count : 0
+			averageValue: count > 0 ? sum / count : 0
 		};
 	}
 	/**
@@ -6777,10 +6791,10 @@ var Sati = class {
 		for (let i = 0; i < agents.length; i++) {
 			const identity = agents[i];
 			const regFile = regFiles[i];
-			const endpoints = regFile?.endpoints ?? [];
+			const services = regFile?.services ?? [];
 			if (options?.active !== void 0 && (regFile?.active ?? true) !== options.active) continue;
 			if (options?.endpointTypes?.length) {
-				if (!options.endpointTypes.every((type) => endpoints.some((e) => e.name.toUpperCase() === type.toUpperCase()))) continue;
+				if (!options.endpointTypes.every((type) => services.some((e) => e.name.toUpperCase() === type.toUpperCase()))) continue;
 			}
 			filtered.push({
 				identity,

package/dist/index.d.cts

@@ -1627,17 +1627,17 @@ declare enum DataType {
 /**
  * Feedback outcome values (ERC-8004 compatible)
  *
- * For ERC-8004 score mapping:
- * - Negative(0) → 0
- * - Neutral(1) → 50
- * - Positive(2) → 100
+ * Maps to ERC-8004 outcome semantics:
+ * - Negative(0) - unfavorable interaction
+ * - Neutral(1) - default / no strong signal
+ * - Positive(2) - favorable interaction
  */
 declare enum Outcome {
-  /** Negative feedback (score 0) */
+  /** Negative feedback */
   Negative = 0,
-  /** Neutral feedback (score 50) */
+  /** Neutral feedback (default) */
   Neutral = 1,
-  /** Positive feedback (score 100) */
+  /** Positive feedback */
   Positive = 2,
 }
 /**
@@ -1698,18 +1698,24 @@ interface BaseLayout {
 /**
  * Feedback schema - uses universal base layout
  *
- * Schema-specific fields (tags, score, message) go in JSON content:
- * { "score": 85, "tags": ["fast", "accurate"], "m": "Great response!" }
+ * Schema-specific fields (value, tags, message) go in JSON content:
+ * { "value": 85, "valueDecimals": 0, "tag1": "quality", "tag2": "latency", "m": "Great response!" }
  */
 interface FeedbackData extends BaseLayout {}
 /**
  * Feedback JSON content structure (optional fields in content)
  */
 interface FeedbackContent {
-  /** ERC-8004 compatible score: 0-100 */
-  score?: number;
-  /** Category tags (max 32 chars each) */
-  tags?: string[];
+  /** ERC-8004 signed fixed-point value */
+  value?: number;
+  /** Decimal places for value (0-18) */
+  valueDecimals?: number;
+  /** First tag dimension */
+  tag1?: string;
+  /** Second tag dimension */
+  tag2?: string;
+  /** Endpoint URI being reviewed */
+  endpoint?: string;
   /** Feedback message */
   m?: string;
 }
@@ -1805,8 +1811,8 @@ declare function parseValidationContent(content: Uint8Array, contentType: Conten
  *
  * Note: task_ref is deterministic: keccak256(counterparty, agent_mint)
  *
- * Schema-specific fields (score, methodology) go in JSON content:
- * { "score": 85, "methodology": "weighted_average", "components": {...} }
+ * Schema-specific fields go in JSON content:
+ * { "score": 85, "methodology": "weighted_average", "feedbackCount": 42 }
  */
 interface ReputationScoreData extends BaseLayout {}
 /**
@@ -2541,7 +2547,7 @@ interface CounterpartyMessageParams {
  *   outcome: Outcome.Positive,
  *   dataHash: dataHash,
  *   contentType: ContentType.JSON,
- *   content: new TextEncoder().encode('{"score": 95, "tags": ["fast"]}'),
+ *   content: new TextEncoder().encode('{"value": 95, "valueDecimals": 0, "tag1": "quality"}'),
  * });
  *
  * // Build counterparty message
@@ -3248,8 +3254,8 @@ interface RegistrationFile {
   properties: Properties;
   /** Project website URL */
   external_url?: string;
-  /** Service endpoints (A2A, MCP, agentWallet) */
-  endpoints?: Endpoint[];
+  /** Service endpoints (A2A, MCP, agentWallet) - ERC-8004 "services" array */
+  services?: Endpoint[];
   /** Cross-chain registration entries */
   registrations?: RegistrationEntry[];
   /** Supported trust mechanisms */
@@ -3257,7 +3263,7 @@ interface RegistrationFile {
   /** Agent operational status */
   active?: boolean;
   /** Accepts x402 payments */
-  x402support?: boolean;
+  x402Support?: boolean;
 }
 /** Input parameters for buildRegistrationFile */
 interface RegistrationFileParams {
@@ -3266,11 +3272,11 @@ interface RegistrationFileParams {
   image: string;
   imageMimeType?: string;
   externalUrl?: string;
-  endpoints?: Endpoint[];
+  services?: Endpoint[];
   registrations?: RegistrationEntry[];
   supportedTrust?: TrustMechanism[];
   active?: boolean;
-  x402support?: boolean;
+  x402Support?: boolean;
 }
 /**
  * Infer MIME type from image URL extension.
@@ -3445,13 +3451,17 @@ interface GiveFeedbackParams {
   payer: KeyPairSigner;
   /** Agent mint address to review */
   agentMint: Address$1;
-  /** Numeric score 0-100 (auto-maps to outcome if not provided) */
-  score?: number;
-  /** Tag dimensions for the feedback (1 or 2 tags) */
-  tags?: [string] | [string, string];
+  /** ERC-8004 signed fixed-point value (e.g. 87 for score, -32 for -3.2% yield) */
+  value?: number;
+  /** Decimal places for value (0-18). E.g. valueDecimals=0 means integer, =2 means 2 decimal places. Default 0. */
+  valueDecimals?: number;
+  /** First tag dimension (e.g. "starred", "uptime", "successRate") */
+  tag1?: string;
+  /** Second tag dimension (optional sub-category) */
+  tag2?: string;
   /** Human-readable feedback message */
   message?: string;
-  /** Endpoint being reviewed */
+  /** Endpoint URI being reviewed */
   endpoint?: string;
   /** Explicit outcome (defaults to Neutral if not set) */
   outcome?: Outcome;
@@ -3489,8 +3499,10 @@ interface PreparedFeedbackData {
   lookupTable?: Address$1;
   /** Original input values for reconstructing display data */
   meta: {
-    score?: number;
-    tags?: string[];
+    value?: number;
+    valueDecimals?: number;
+    tag1?: string;
+    tag2?: string;
     message?: string;
     endpoint?: string;
   };
@@ -3501,12 +3513,14 @@ interface FeedbackSearchOptions {
   agentMint?: Address$1;
   /** Filter by counterparty (reviewer) */
   counterparty?: Address$1;
-  /** Filter by tag dimensions */
-  tags?: string[];
-  /** Minimum score (inclusive) */
-  minScore?: number;
-  /** Maximum score (inclusive) */
-  maxScore?: number;
+  /** Filter by tag1 */
+  tag1?: string;
+  /** Filter by tag2 */
+  tag2?: string;
+  /** Minimum value (inclusive) */
+  minValue?: number;
+  /** Maximum value (inclusive) */
+  maxValue?: number;
   /** Include transaction hash in results (extra RPC call) */
   includeTxHash?: boolean;
 }
@@ -3520,10 +3534,14 @@ interface ParsedFeedback {
   counterparty: Address$1;
   /** Feedback outcome */
   outcome: Outcome;
-  /** Numeric score 0-100 (from JSON content) */
-  score?: number;
-  /** Tag dimensions */
-  tags: string[];
+  /** ERC-8004 signed fixed-point value */
+  value?: number;
+  /** Decimal places for value (0-18) */
+  valueDecimals?: number;
+  /** First tag dimension */
+  tag1?: string;
+  /** Second tag dimension */
+  tag2?: string;
   /** Feedback message */
   message?: string;
   /** Endpoint reviewed */
@@ -3535,10 +3553,10 @@ interface ParsedFeedback {
 }
 /** Reputation summary aggregated from feedback. */
 interface ReputationSummary {
-  /** Number of feedback attestations */
+  /** Number of feedback attestations with values */
   count: number;
-  /** Average score (0-100) across attestations with scores */
-  averageScore: number;
+  /** Average value across attestations (raw, not adjusted for valueDecimals) */
+  averageValue: number;
 }
 /** Options for searching registered agents. */
 interface AgentSearchOptions {
@@ -3651,7 +3669,7 @@ interface CreateFeedbackParams {
    * @example
    * ```typescript
    * // Small content (fits in DualSignature)
-   * content: new TextEncoder().encode('{"score":85,"tags":["fast"]}')
+   * content: new TextEncoder().encode('{"value":85,"valueDecimals":0,"tag1":"starred"}')
    *
    * // Large content (use IPFS reference)
    * contentType: ContentType.IPFS,
@@ -4232,8 +4250,9 @@ declare class Sati {
    * const result = await sati.giveFeedback({
    *   payer: myKeypair,
    *   agentMint: address("Agent..."),
-   *   score: 85,
-   *   tags: ["quality", "speed"],
+   *   value: 87,
+   *   valueDecimals: 0,
+   *   tag1: "starred",
    *   message: "Great response time",
    * });
    * ```
@@ -4281,8 +4300,8 @@ declare class Sati {
    * ```typescript
    * const feedbacks = await sati.searchFeedback({
    *   agentMint: address("Agent..."),
-   *   tags: ["quality"],
-   *   minScore: 70,
+   *   tag1: "starred",
+   *   minValue: 70,
    * });
    * ```
    */
@@ -4290,15 +4309,15 @@ declare class Sati {
   /**
    * Get reputation summary for an agent.
    *
-   * Aggregates feedback scores, optionally filtered by tags.
+   * Aggregates feedback values, optionally filtered by tag1 and/or tag2.
    *
    * @example
    * ```typescript
    * const summary = await sati.getReputationSummary(address("Agent..."));
-   * console.log(`${summary.count} reviews, avg ${summary.averageScore}`);
+   * console.log(`${summary.count} reviews, avg ${summary.averageValue}`);
    * ```
    */
-  getReputationSummary(agentMint: Address$1, tags?: string[]): Promise<ReputationSummary>;
+  getReputationSummary(agentMint: Address$1, tag1?: string, tag2?: string): Promise<ReputationSummary>;
   /**
    * Search validation attestations for an agent.
    *