Sign in

v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Signer

Register Signed Key

Registers an signed key and returns the developer managed signer status with an approval url.

post/v2/farcaster/signer/developer_managed/signed_key/

Request body

app_fidinteger required

The unique identifier of a farcaster user or app (unsigned integer)

deadlineinteger required

unix timestamp in seconds that controls how long the signed key request is valid for. (24 hours from now is recommended)

public_keystring required

Ed25519 public key

redirect_urlstring

Url to redirect to after the signer is approved. Note : This should only be used when requesting a signer from a native mobile application.

signaturestring required

Signature generated by the custody address of the app. Signed data includes app_fid, deadline, signer's public key

Example request

{
  "app_fid": 3,
  "public_key": "0x3daa8f99c5f760688a3c9f95716ed93dee5ed5d7722d776b7c4deac957755f22",
  "signature": "0x7867e84cb6a64bf6e1954e52884133f1114eb3fd97f63ff55fa76c77c80beb6434eea9d3736b59caa3130d63121177acc752dc8a2561e9edf700642f390f92d11b",
  "sponsor": {
    "fid": 3
  }
}

Response

Success

fidinteger

The unique identifier of a farcaster user or app (unsigned integer)

public_keystring required

Ed25519 public key

signer_approval_urlstring
status'pending_approval' | 'approved' | 'revoked' required

Example response

{
  "fid": 3,
  "public_key": "0x3daa8f99c5f760688a3c9f95716ed93dee5ed5d7722d776b7c4deac957755f22"
}