ETethereal
LinkedSigner

Refreshes the expiry of a linked signer (signed by EOA, supports expired signers)

Changed on
post/v1/linked-signer/refresh

Request

Request body

signaturestring hex required

Hex-encoded EIP-712 signature authorizing this request

Example request

{
  "data": {
    "nonce": "2687929537462333",
    "sender": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "signedAt": 1712019600,
    "signer": "0x1Db3439a222C519ab44bb1144fC28167b4Fa6EE6",
    "subaccount": "0x7072696d61727900000000000000000000000000000000000000000000000000",
    "subaccountId": "9036443a-441a-4a66-87f2-bd5c44cdca7a"
  }
}

Response

blockNumberstring

Block number the signer has been linked on. Undefined means it has not be processed

category'TRADE_SESSION' | 'API'

Category of the linked signer: API or TRADE_SESSION

createdAtinteger required

Link signer submission timestamp (ms since Unix Epoch)

expiresAtinteger required

Signer expiry timestamp (ms since Unix Epoch)

idstring required

Id representing the linked signer

linkedAtinteger

Onchain linkage timestamp (ms since Unix Epoch)

namestring

Optional name for the linked signer

revokedAtinteger

Onchain revocation timestamp (ms since Unix Epoch)

revokedBlockNumberstring

Block number the signer has been revoked on. Undefined means it has not be processed

signerstring hex required

Address of the signer linked with the subaccount (non-checksummed)

status'PENDING' | 'ACTIVE' | 'PENDING_REVOKE' | 'REVOKED' | 'REJECTED' required

Status of the signer

Example response

{
  "blockNumber": "123062737",
  "category": "TRADE_SESSION",
  "createdAt": 1712019600000,
  "expiresAt": 1713229200000,
  "id": "9036443a-441a-4a66-87f2-bd5c44cdca7a",
  "linkedAt": 1712019615000,
  "name": "Delegated signer",
  "revokedAt": 1712019600000,
  "revokedBlockNumber": "123062737",
  "signer": "0x1Db3439a222C519ab44bb1144fC28167b4Fa6EE6",
  "status": "PENDING"
}

Changes

  • 63e8937ff6f7Revision changes
    • info

      added the non-success response with the status

  • dc14c1586dfaRevision changes
    • info

      the response's property default value Bad Request was removed for the status

    • info

      the response's property default value Forbidden was removed for the status

    • info

      the response's property default value Not Found was removed for the status

    • info

      the response's property default value Too Many Requests was removed for the status

    • info

      the response's property default value Unauthorized was removed for the status

    • info

      the response's property default value Unprocessable Entity was removed for the status

    • info

      the response's property default value 400 was removed for the status

    • info

      the response's property default value 401 was removed for the status

    • info

      the response's property default value 403 was removed for the status

    • info

      the response's property default value 404 was removed for the status

    • info

      the response's property default value 422 was removed for the status

    • info

      the response's property default value 429 was removed for the status

    • info

      response property message list-of-types was narrowed by removing types array from media type application/json of response 400