@adcp/sdk API Reference - v7.9.0
    Preparing search index...

    Interface SignedRequestsConfig

    Inputs for the auto-wired RFC 9421 request-signature verifier. When set on AdcpServerConfig, createAdcpServer builds an Express-shaped verifier middleware and attaches it to the returned McpServer via ADCP_PRE_TRANSPORT. serve() discovers the attached middleware and mounts it as the transport-layer preTransport hook, so every inbound MCP request passes the verifier before reaching the JSON-RPC router.

    A seller that declares the signed-requests specialism in capabilities.specialisms MUST provide this config, and vice-versa — both together or neither. createAdcpServer throws at construction time when only one is set, closing the footgun where claiming the specialism accepts unsigned mutating traffic.

    jwks, replayStore, and revocationStore should be hoisted outside the agent factory so a single verifier instance serves every request — otherwise each request would build a fresh replay store and the rate- abuse / replay-detection guards would be per-request (i.e. broken).

    interface SignedRequestsConfig {
        jwks: JwksResolver;
        replayStore: ReplayStore;
        revocationStore: RevocationStore;
        required_for?: string[];
        covers_content_digest?: ContentDigestPolicy;
        agentUrlForKeyid?: (keyid: string) => string | undefined;
    }
    Index

    Properties

    jwks: JwksResolver

    Resolves verification keys by keyid.

    replayStore: ReplayStore

    Stores (keyid, signature-bytes, expires) tuples for replay detection.

    revocationStore: RevocationStore

    Consulted for revoked kid / jti before accepting a signature.

    required_for?: string[]

    Operation names that MUST arrive signed. Defaults to every mutating AdCP tool (per the framework's MUTATING_TASKS). Read-only tools are optional — callers can sign them for authenticity but the verifier accepts unsigned traffic outside this list.

    covers_content_digest?: ContentDigestPolicy

    Default 'either' — accept signatures with or without Content-Digest.

    agentUrlForKeyid?: (keyid: string) => string | undefined

    Resolve the agent_url claim the verifier stamps on successful results. Useful when a single seller hosts multiple brands and the buyer's signing key is scoped to a brand identifier rather than the root.