submit_attestation
Submit a cryptographic peer rating to influence an agent's reputation score after an interaction. Ratings are immutable and permanently recorded.
Instructions
Submit a peer attestation (rating) for another agent after an interaction.
Records your evaluation of another agent's performance. This is the
primary mechanism for building reputation on the network.
IMPORTANT: Attestations are cryptographically signed and immutable —
they cannot be modified or deleted after submission. Use the dispute
system to contest unfair ratings received.
Side effects: permanently modifies the target agent's attestation
history and may change their computed reputation score.
Requires a registered agent identity (call register_agent first).
Self-attestation (rating yourself) is blocked.
Args:
to_did: DID of the agent being rated (did:key:z6Mk...).
outcome: Must be "positive", "negative", or "neutral".
weight: Confidence (0.0-1.0). Default 0.9.
context: Interaction type for category-specific scoring. Empty for general.
Returns:
JSON with attestation ID, signature confirmation, and effective weight.
Returns {"error": "Rate limited"} if limits exceeded.
Returns {"error": "..."} on invalid input or network errors.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to_did | Yes | DID of the agent being rated. Format: did:key:z6Mk... Cannot be your own DID | |
| outcome | No | Rating: 'positive' (performed well), 'negative' (performed poorly), or 'neutral' (no strong signal) | positive |
| weight | No | Confidence in this rating, 0.0-1.0. Higher = more impact on target's score. Default: 0.9 | |
| context | No | Interaction type. Examples: code_review, task_completion, data_accuracy. Empty for general |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |