Create Signature

Creates a new signature for signing messages or typed data.

API scope required: wallets:signatures.create

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

• EVM Message Signature
• Solana Message Signature
• EVM Typed Data Signature

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

type

enum<string>

required

Available options:

evm-message

params

object

required

Parameters for an EVM signature

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.

Response

201

application/json

The signature has been successfully created.

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