Documentation Index
Fetch the complete documentation index at: https://docs.spellguard.ai/llms.txt
Use this file to discover all available pages before exploring further.
Agent Registry
After successful verification, agents receive a channel token for authenticated communication with the Verifier.
Attestation Result
interface AttestationResult {
/** Agent ID from the evidence */
agentId: string;
/** Whether the evidence was verified successfully */
verified: boolean;
/** Channel token for authenticated communication */
channelToken: string;
/** Verifier's Ed25519 session public key for signing verification */
sessionPublicKey: string;
/** Verifier's X25519 session public key for ECDH encryption */
sessionX25519PublicKey?: string;
/** When the attestation expires */
expiresAt: number;
/** Token rotation policy */
rotationPolicy?: {
/** Maximum age before rotation (milliseconds) */
maxAge: number;
/** Endpoint to call for token refresh */
refreshEndpoint: string;
};
/** Verifier's own attestation type */
verifierAttestationType?: 'nitro' | 'phala' | 'internal' | 'mock';
}
Registered Agent
interface RegisteredAgent {
/** Unique identifier for the agent */
agentId: string;
/** Agent's callback endpoint URL */
endpoint: string;
/** URL to the agent's A2A Agent Card */
agentCardUrl: string;
/** Hash of the agent's code */
codeHash: string;
/** Channel token for authenticated communication */
channelToken: string;
/** When the agent was registered */
registeredAt: number;
/** When the registration expires */
expiresAt: number;
}
Token Rotation
Channel tokens have configurable expiration. When a token is close to expiring, agents should use the refreshEndpoint to obtain a new token without re-attestation.