KeelsonDocs
    Judge Mode

    API reference Operators

    Link an ERC-8004 agent as an operator

    POST/v1/operators

    Binds the agent's cnf key to its ERC-8004 identity once its owner or agentWallet signs OperatorLink. The owner of an agent that is already linked re-links it, after a transfer for example.

    Headers

    Content-Typeapplication/jsonRequired
    idempotency-keystringRequired
    Idempotency-KeystringRequired
    1 to 255 characters. A retry with the same key returns the first answer.

    Request body

    application/json

    chainIdone ofRequired
    agentIdstringRequired
    The ERC-8004 agent id, a decimal integer.
    namestringRequired
    cnfJwkobjectRequired
    The agent's P-256 cnf key, a public JWK.
    deadlineintegerRequired
    Unix seconds, at most 15 minutes ahead.
    signaturestringRequired
    The EIP-712 OperatorLink(uint256 agentId,bytes32 cnfThumbprint,uint256 deadline) signature under the domain { name: "Keelson", version: "1", chainId }, by the agent's owner or agentWallet (EOA, ERC-1271 or ERC-6492). cnfThumbprint is the RFC 7638 SHA-256 thumbprint of cnfJwk.

    Responses

    • 201The operator is linked
    • 401No valid access token
    • 403Not signed by the agent's owner or agent wallet
    • 404No such agent in the Identity registry
    • 409The agent id is linked on another registry
    • 422Invalid, or past its deadline
    • 503The chain cannot be read

    201 response

    agentIdstringRequired
    The ERC-8004 agent id, a decimal integer.
    chainIdintegerRequired
    agentRegistrystringRequired
    ownerstringRequired
    The agent's owner in the Identity registry.