Skip to main content

Table of Contents

Module spoon_ai.identity.attestation

Attestation and Trust Score Management Handles verifiable credentials and reputation calculations

AttestationManager Objects​

class AttestationManager()

Manages verifiable attestations for agents

create_attestation​

def create_attestation(issuer_did: str,
                       subject_did: str,
                       claim: Dict,
                       evidence: Optional[str] = None) -> Attestation

Create a verifiable attestation

Arguments:

  • issuer_did - DID of the attestation issuer
  • subject_did - DID of the agent being attested
  • claim - Attestation claim data
  • evidence - Optional supporting evidence

Returns:

Signed Attestation object

verify_attestation​

def verify_attestation(attestation: Attestation) -> bool

Verify attestation signature

submit_reputation_on_chain​

def submit_reputation_on_chain(subject_did: str, score: int,
                               evidence: str) -> str

Submit reputation score to on-chain registry

Arguments:

  • subject_did - DID of agent being rated
  • score - Score between -100 and 100
  • evidence - Evidence for the score

Returns:

Transaction hash

submit_validation_on_chain​

def submit_validation_on_chain(subject_did: str, is_valid: bool,
                               reason: str) -> str

Submit validation for an agent

Arguments:

  • subject_did - DID of agent being validated
  • is_valid - Whether agent is valid
  • reason - Reason for validation decision

Returns:

Transaction hash

TrustScoreCalculator Objects​

class TrustScoreCalculator()

Calculates trust scores for agents

calculate_trust_score​

def calculate_trust_score(did: str) -> Dict

Calculate comprehensive trust score

Returns:

Dict with trust score components:

  • reputation_score: -100 to 100
  • validation_status: bool
  • trust_level: "high" | "medium" | "low" | "untrusted"
  • confidence: 0 to 1

get_reputation_breakdown​

def get_reputation_breakdown(did: str, limit: int = 10) -> List[Dict]

Get detailed reputation submissions

get_validation_breakdown​

def get_validation_breakdown(did: str, limit: int = 10) -> List[Dict]

Get detailed validation submissions