KeelsonDocs
    Judge Mode

    API reference Bonds

    Deposit PYUSD into an operator's bond, gasless

    POST/v1/bonds/{agentId}/deposits

    Relays depositWithAuthorization (EIP-3009) or depositWithPermit (EIP-2612) to the bond vault; Keelson pays the gas. The same authorization is sent once, whatever the idempotency key. An operators:write client sends either; the operator's own session (EIP-4361, from the operator console) sends a permit whose owner is a wallet it signed in with that owns the agent.

    Path parameters

    agentIdstringRequired
    The ERC-8004 agent id, a decimal integer.

    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

    Responses

    • 200Confirmed on-chain
    • 202Sent and not yet confirmed; poll Location
    • 401No valid credentials
    • 403Not allowed
    • 409The same call was submitted with other arguments
    • 422Invalid, or the call reverts: error names the contract's custom error
    • 503The relayer cannot send now: chain unavailable, gas price cap or low balance

    200 response

    idstringRequired
    chainIdintegerRequired
    keystringRequired
    <contract>.<function>:<natural id>.
    contractstringRequired
    functionNamestringRequired
    statusstringRequired
    One of pendingconfirmedrevertedrejecteddropped
    hashstring
    noncestring
    blockNumberstring
    blockHashstring
    gasUsedstring
    effectiveGasPricestring
    latencyMsinteger
    errorCodestring
    errorobject
    explorerUrlstring