v1

latestOpenAPI 3.0.12026-07-2699111970.1 KB

Approve Signature

Submit approval for a signature to sign a message or typed data.

API scope required: wallets:signatures.create

post/2025-06-09/wallets/{walletLocator}/signatures/{signatureId}/approvals

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

<walletAddress>
email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
chainType[:<walletType>]:alias:<alias>

signatureIdstring required

Headers

X-API-KEYstring required

API key required for authentication

Request body

Example request

{
  "approvals": [
    {
      "signature": {
        "r": "0x1234...",
        "s": "0x5678..."
      }
    }
  ]
}

Response

The signature has been successfully approved.

idstring required

Unique identifier for the signature

type'message' | 'typed-data' | 'auth-entries' required

The type of signature

chainType'evm' | 'solana' | 'aptos' | 'sui' | 'stellar' required

The blockchain type of the wallet

walletType'smart' | 'mpc' required

The wallet type (smart or mpc)

status'awaiting-approval' | 'pending' | 'failed' | 'success' required

Current status of the signature

{"stackTrail":"components:schemas:WalletsSignatureV2025ResponseDTO:properties:error","oasType":"schema","type":"unknown","description":"Error message if the signature fails"}

outputSignaturestring

The wallet's output signature of the request