9 SKOOR AgentKit Actions

Parameters

Response Shape

{
  score: number;          // 300-850
  tier: string;           // "poor" | "fair" | "good" | "excellent" | "exceptional"
  factors: {
    paymentHistory: number;       // 0.00-1.00, weight: 20%
    compliancePosture: number;    // 0.00-1.00, weight: 20%
    accountLongevity: number;     // 0.00-1.00, weight: 20%
    behavioralIntegrity: number;  // 0.00-1.00, weight: 15%
    peerReputation: number;       // 0.00-1.00, weight: 10%
    transactionVolume: number;    // 0.00-1.00, weight: 10%
    serviceDiversity: number;     // 0.00-1.00, weight: 5%
  };
  lastUpdated: string;    // ISO 8601 timestamp
  history?: Array<{ date: string; score: number }>;
}

Parameters

Response Shape

{
  currentScore: number;
  suggestions: Array<{
    action: string;          // Action name to execute
    pointsEstimate: number;  // Estimated point gain
    effort: "low" | "medium" | "high";
    description: string;     // Human-readable description
    requiresApiKey: boolean;
    alreadyCompleted: boolean;
  }>;
  potentialScore: number;    // Score after all suggestions
}

Parameters

Response Shape

{
  success: boolean;
  tokenId: string;           // ERC-8004 token ID
  transactionHash: string;   // On-chain tx hash
  chain: string;
  pointsEarned: number;      // Always 10 for first claim
  badge: "SKOOR Wallet";     // Badge earned
  explorerUrl: string;       // Link to block explorer
}

Parameters

Response Shape

{
  status: "clear" | "held";  // Never "flagged" — see ADR-23
  screenedAt: string;        // ISO 8601
  lists: Array<{
    name: string;            // "OFAC SDN", "EU Sanctions", etc.
    result: "clear" | "held";
  }>;
  pointsEarned: number;      // 8 for first clear screening
  badge?: "SKOOR Verified";  // Earned on first clear
  expiresAt: string;         // 30 days from screening
}

Parameters

Response Shape

{
  success: boolean;
  serviceId: string;         // Unique service registration ID
  endpoint: string;
  protocol: string;
  healthStatus: "healthy" | "unknown";
  pointsEarned: number;      // 5 for first registration
  discoverable: boolean;     // Whether other agents can find this
}

Parameters

Response Shape

{
  requestsSent: number;
  counterparties: string[];  // Addresses that received requests
  estimatedPoints: {
    minimum: number;         // If all rate poorly (2 pts each)
    maximum: number;         // If all rate highly (5 pts each)
  };
  campaignId: string;        // Track this feedback campaign
  expiresAt: string;         // Feedback window (7 days)
}

Parameters

Response Shape

{
  transactionHash: string;
  status: "confirmed" | "pending" | "failed";
  amount: string;            // Atomic units
  token: string;
  chain: string;
  fee: string;               // 25 basis points
  pointsEarned: number;      // 3 per successful tx
  dailySpendRemaining: string; // Remaining daily limit
  explorerUrl: string;
}

Parameters

Response Shape

{
  jwt: string;               // Signed JWT credential
  decoded: {
    sub: string;             // Agent wallet address
    score: number;           // Current score at issuance
    tier: string;            // Current tier
    compliant: boolean;      // OFAC status
    badges: string[];        // Current badges
    iat: number;             // Issued at (Unix timestamp)
    exp: number;             // Expires at (Unix timestamp)
  };
  verifyUrl: string;         // URL to verify this credential
  jwksUrl: string;           // JWKS endpoint for key verification
}

Parameters

Response Shape

{
  startScore: number;
  endScore: number;
  delta: number;             // Points gained
  actionsExecuted: Array<{
    action: string;
    pointsGained: number;
    status: "success" | "skipped" | "failed";
    error?: string;
  }>;
  badgesEarned: string[];
  nextBadge?: {
    name: string;
    pointsNeeded: number;
  };
  nextLoopEstimate: {
    potentialGain: number;
    suggestedDelay: string;  // e.g. "24h" (wait for feedback)
  };
}