Approve Signature

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

API scope required: wallets:signatures.create

Headers

X-API-KEY

string

required

API key required for authentication

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>

signatureId

string

required

Body

application/json

Input for submitting one or more approvals

approvals

required

Array of approvals to submit for this transaction

• EVM keypair signature submission payload
• EVM passkey signature submission payload

Show child attributes

approvals.signer

string

required

The locator for the EVM signer

approvals.signature

string

required

The EVM cryptographic signature

Response

201

application/json

The signature has been successfully approved.

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

id

string

required

Unique identifier for the signature

type

enum<string>

required

The type of signature

Available options:

evm-message,

solana-message,

evm-typed-data,

aptos-message,

cardano-message,

sui-message

status

enum<string>

required

Current status of the signature

Available options:

awaiting-approval,

pending,

failed,

success

params

object

required

Type-specific signature parameters

• EVM message signature parameters
• Solana message signature parameters
• EVM typed data signature parameters

Show child attributes

params.message

string

required

The message in plain text to sign

params.chain

enum<string>

required

The chain on which the signature will be submitted

Available options:

arbitrum-sepolia,

avalanche-fuji,

curtis,

barret-testnet,

base-goerli,

base-sepolia,

bsc-testnet,

chiliz-spicy-testnet,

ethereum-goerli,

ethereum-sepolia,

hypersonic-testnet,

lightlink-pegasus,

optimism-goerli,

optimism-sepolia,

polygon-amoy,

polygon-mumbai,

crossmint-private-testnet-ethereum,

crossmint-private-testnet-polygon,

rari-testnet,

scroll-sepolia,

sei-atlantic-2-testnet,

shape-sepolia,

skale-nebula-testnet,

soneium-minato-testnet,

space-testnet,

story-testnet,

verify-testnet,

viction-testnet,

xai-sepolia-testnet,

zkatana,

zkyoto,

zora-goerli,

zora-sepolia,

mode-sepolia,

zenchain-testnet,

ethereum,

polygon,

bsc,

optimism,

arbitrum,

base,

zora,

arbitrumnova,

astar-zkevm,

apechain,

apex,

boss,

lightlink,

skale-nebula,

sei-pacific-1,

chiliz,

avalanche,

xai,

shape,

rari,

scroll,

viction,

mode,

space,

soneium,

story

params.signer

string

The locator for the signer who will submit this signature. Defaults to the wallet's admin signer.

createdAt

number

required

ISO timestamp when the signature was created

approvals

object

Complete approval data including requirements, pending and submitted signatures

Show child attributes

approvals.pending

object[]

required

List of pending signatures

Show child attributes

approvals.pending.signer

string

required

The locator of the signer that's pending approval

approvals.pending.message

string

required

The message that needs to be signed

approvals.submitted

object[]

required

Record of all submitted signatures

Show child attributes

approvals.submitted.signature

string

required

The cryptographic signature

approvals.submitted.submittedAt

number

required

When the signature was submitted

approvals.submitted.signer

string

required

The locator of the signer who submitted this signature

approvals.submitted.message

string

required

The message that was signed

approvals.submitted.metadata

object

Additional metadata about the signature submission

Show child attributes

approvals.submitted.metadata.deviceInfo

string

approvals.submitted.metadata.ipAddress

string

approvals.submitted.metadata.userAgent

string

approvals.required

number

Number of required approvals for the transaction

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