Associations

Request a challenge to sign for one address of the pair.

Returns a single-use nonce and the exact text to sign. This is a message signature, never a transaction: it moves no funds and authorises nothing else. Issued for either end of the pair whether or not Fidren holds a record for it, so the endpoint cannot be used to learn which addresses are on file.

post/v1/associations/{id}/challenge

Request

  • Base URL: https://api.fidren.net
  • URL: https://api.fidren.net/v1/associations/{id}/challenge
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

idstring required

The association public_id (assoc_ followed by 32 hex characters), or the deprecated numeric id.

Request body

addressstring required

Which of the two addresses this association names is about to sign.

Response

A challenge to sign.

noncestring required
messagestring required

The exact text to sign, built server-side so issuance and checking cannot drift apart. Deliberately different text from the dispute channel's: a signature is consent to what the message says, and one given to exercise a right of reply must not be replayable here.

formatstring required

The version of the signed message format. Stated because the bytes are a compatibility surface once they leave here: a signature can only be checked against the exact text that produced it.

expires_atstring date-time required
instructionsstring required

Changes

No recorded changes to this operation across all 1 revision of this API.