POST
/
2022-06-09
/
wallets
/
{walletLocator}
/
signatures

Headers

X-API-KEY
string
required

API key required for authentication

x-idempotency-key
string

Unique key to prevent duplicate signature creation

Path Parameters

walletLocator
string
required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<walletType>
  • userId:<userId>:<walletType>
  • userId:<userId>:<walletType> (white label user example)
  • phoneNumber:<phoneNumber>:<walletType>
  • twitter:<handle>:<walletType>
  • x:<handle>:<walletType>

Body

application/json

Input schema for creating a new signature. The parameters vary based on the signature type.

params
object
required

Parameters for an EVM signature

type
enum<string>
required
Available options:
evm-message

Response

201 - application/json

Complete signature response including status, signing requirements, and wallet type specific data

createdAt
number
required

ISO timestamp when the signature was created

id
string
required

Unique identifier for the signature

params
object
required

Type-specific signature parameters

status
enum<string>
required

Current status of the signature

Available options:
awaiting-approval,
pending,
failed,
success
type
enum<string>
required

The type of signature

Available options:
evm-message,
solana-message,
evm-typed-data,
aptos-message,
cardano-message,
sui-message
approvals
object

Complete approval data including requirements, pending and submitted signatures

completedAt
number

ISO timestamp when the transaction reached finality

error
any

Error message if the signature fails

outputSignature
string

The wallet's output signature of the request