KeelsonDocs
    Judge Mode

    API reference Merchants

    Set a merchant's payout address, gasless

    POST/v1/merchants/payout-address

    Relays setPayoutAddress to the bond vault; Keelson pays the gas.

    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
    merchantstringRequired
    payoutstringRequired
    Where slashes and warranties for the merchant are paid.
    noncestringRequired
    vault.nonces(merchant).
    deadlinestringRequired
    Unix seconds.
    merchantSignaturestringRequired
    The vault's EIP-712 PayoutAddress, by the merchant (EOA or ERC-1271).

    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