> ## Documentation Index
> Fetch the complete documentation index at: https://crossmint-devin-1787949784-wallet-docs-two-concept-model.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Signature

> Creates a new signature for signing messages or typed data.

**API scope required**: `wallets:signatures.create`



## OpenAPI

````yaml post /2025-06-09/wallets/{walletLocator}/signatures
openapi: 3.0.0
info:
  contact:
    email: support@crossmint.com
    name: Crossmint Support
    url: https://www.crossmint.com
  description: Crossmint Wallets API
  title: Crossmint Wallets API
  version: 1.0.0
servers:
  - description: Staging environment (testnets)
    url: https://staging.crossmint.com/api
  - description: Production environment (mainnets)
    url: https://www.crossmint.com/api
security: []
tags: []
paths:
  /2025-06-09/wallets/{walletLocator}/signatures:
    post:
      summary: Create Signature
      description: |-
        Creates a new signature for signing messages or typed data.

        **API scope required**: `wallets:signatures.create`
      operationId: WalletsV2025Controller-createSignatureRequest-2
      parameters:
        - description: API key required for authentication
          in: header
          name: X-API-KEY
          required: true
          schema:
            type: string
        - description: >-
            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>`
          in: path
          name: walletLocator
          required: true
          schema:
            type: string
        - description: Unique key to prevent duplicate signature creation
          in: header
          name: x-idempotency-key
          required: false
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSignatureV2025DTO'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletsSignatureV2025ResponseDTO'
          description: The signature has been successfully created.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletV1Alpha2ErrorDTO'
          description: Returns an error if the signature type is not supported
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletV1Alpha2ErrorDTO'
          description: Returns an error if a wallet with the specified locator not found
components:
  schemas:
    CreateSignatureV2025DTO:
      description: >-
        Input schema for creating a new signature. The parameters vary based on
        the signature type.
      example:
        params:
          chain: ethereum
          message: Hello, world!
          signer: external-wallet:0xB17Ea8d34078424B9d7D126E444d5F2C3CC5c81E
        type: message
      oneOf:
        - description: Parameters for a message signature
          properties:
            params:
              description: Parameters for a message signature
              properties:
                chain:
                  description: >-
                    The chain on which the signature will be submitted. Required
                    for EVM wallets, optional for others.
                  enum:
                    - abstract
                    - abstract-testnet
                    - apechain
                    - arbitrum
                    - arbitrum-sepolia
                    - arbitrumnova
                    - arc-testnet
                    - astar-zkevm
                    - avalanche
                    - avalanche-fuji
                    - base
                    - base-goerli
                    - base-sepolia
                    - bsc
                    - bsc-testnet
                    - chiliz
                    - chiliz-spicy-testnet
                    - coti
                    - coti-testnet
                    - crossmint-private-testnet-ethereum
                    - crossmint-private-testnet-polygon
                    - curtis
                    - ethereum
                    - ethereum-goerli
                    - ethereum-sepolia
                    - flow
                    - flow-testnet
                    - hedera
                    - hedera-testnet
                    - hypersonic-testnet
                    - lightlink
                    - lightlink-pegasus
                    - mantle
                    - mantle-sepolia
                    - mode
                    - mode-sepolia
                    - optimism
                    - optimism-goerli
                    - optimism-sepolia
                    - plume
                    - plume-testnet
                    - polygon
                    - polygon-amoy
                    - polygon-mumbai
                    - rari
                    - rari-testnet
                    - robinhood-chain
                    - robinhood-chain-testnet
                    - scroll
                    - scroll-sepolia
                    - sei-atlantic-2-testnet
                    - sei-pacific-1
                    - shape
                    - shape-sepolia
                    - skale-nebula
                    - skale-nebula-testnet
                    - soneium
                    - soneium-minato-testnet
                    - space
                    - space-testnet
                    - story
                    - story-testnet
                    - tempo
                    - tempo-testnet
                    - u2u-nebulas
                    - u2u-solaris
                    - verify-testnet
                    - viction
                    - viction-testnet
                    - world-chain
                    - world-chain-sepolia
                    - xai
                    - xai-sepolia-testnet
                    - zenchain-testnet
                    - zkatana
                    - zkyoto
                    - zora
                    - zora-goerli
                    - zora-sepolia
                  type: string
                message:
                  description: The message in plain text to sign
                  type: string
                signer:
                  description: >-
                    The locator for the signer who will submit this signature.
                    Defaults to the wallet's admin signer.
                  example: passkey:cWtP7gmZbd98HbKUuGXx5Q
                  title: Signer Locator
                  type: string
              required:
                - message
              type: object
            type:
              enum:
                - message
              type: string
          required:
            - params
            - type
          title: Message Signature
          type: object
        - description: Parameters for a typed data signature
          properties:
            params:
              description: Parameters for a typed data signature
              properties:
                chain:
                  description: The chain on which the signature will be submitted
                  enum:
                    - abstract
                    - abstract-testnet
                    - apechain
                    - arbitrum
                    - arbitrum-sepolia
                    - arbitrumnova
                    - arc-testnet
                    - astar-zkevm
                    - avalanche
                    - avalanche-fuji
                    - base
                    - base-goerli
                    - base-sepolia
                    - bsc
                    - bsc-testnet
                    - chiliz
                    - chiliz-spicy-testnet
                    - coti
                    - coti-testnet
                    - crossmint-private-testnet-ethereum
                    - crossmint-private-testnet-polygon
                    - curtis
                    - ethereum
                    - ethereum-goerli
                    - ethereum-sepolia
                    - flow
                    - flow-testnet
                    - hedera
                    - hedera-testnet
                    - hypersonic-testnet
                    - lightlink
                    - lightlink-pegasus
                    - mantle
                    - mantle-sepolia
                    - mode
                    - mode-sepolia
                    - optimism
                    - optimism-goerli
                    - optimism-sepolia
                    - plume
                    - plume-testnet
                    - polygon
                    - polygon-amoy
                    - polygon-mumbai
                    - rari
                    - rari-testnet
                    - robinhood-chain
                    - robinhood-chain-testnet
                    - scroll
                    - scroll-sepolia
                    - sei-atlantic-2-testnet
                    - sei-pacific-1
                    - shape
                    - shape-sepolia
                    - skale-nebula
                    - skale-nebula-testnet
                    - soneium
                    - soneium-minato-testnet
                    - space
                    - space-testnet
                    - story
                    - story-testnet
                    - tempo
                    - tempo-testnet
                    - u2u-nebulas
                    - u2u-solaris
                    - verify-testnet
                    - viction
                    - viction-testnet
                    - world-chain
                    - world-chain-sepolia
                    - xai
                    - xai-sepolia-testnet
                    - zenchain-testnet
                    - zkatana
                    - zkyoto
                    - zora
                    - zora-goerli
                    - zora-sepolia
                  type: string
                isSmartWalletSignature:
                  description: >-
                    Whether the signature corresponds to the smart wallet or to
                    the signer. If true, the signature will be wrapped with
                    ERC6492.
                  type: boolean
                signer:
                  description: The locator for the signer who will approve this signature
                  example: passkey:cWtP7gmZbd98HbKUuGXx5Q
                  title: Signer Locator
                  type: string
                typedData:
                  properties:
                    domain:
                      properties:
                        chainId:
                          type: number
                        name:
                          type: string
                        salt:
                          description: A hex string
                          type: string
                        verifyingContract:
                          description: An EVM address string
                          type: string
                        version:
                          type: string
                      required:
                        - chainId
                        - name
                        - verifyingContract
                        - version
                      type: object
                    message:
                      additionalProperties: true
                      type: object
                    primaryType:
                      type: string
                    types:
                      additionalProperties:
                        items:
                          properties:
                            name:
                              type: string
                            type:
                              type: string
                          required:
                            - name
                            - type
                          type: object
                        type: array
                      type: object
                  required:
                    - domain
                    - message
                    - primaryType
                    - types
                  type: object
              required:
                - chain
                - typedData
              type: object
            type:
              enum:
                - typed-data
              type: string
          required:
            - params
            - type
          title: Typed Data Signature
          type: object
        - description: Parameters for signing Stellar authorization entries (SEP-45)
          properties:
            params:
              description: Parameters for signing Stellar authorization entries (SEP-45)
              properties:
                authorizationEntries:
                  description: >-
                    Base64-encoded XDR array of all authorization entries from
                    the SEP-45 challenge (4-byte BE count prefix + concatenated
                    entry XDR)
                  type: string
                signer:
                  description: >-
                    The locator for the signer who will approve this entry.
                    Defaults to the wallet's admin signer.
                  example: passkey:cWtP7gmZbd98HbKUuGXx5Q
                  title: Signer Locator
                  type: string
              required:
                - authorizationEntries
              type: object
            type:
              enum:
                - auth-entries
              type: string
          required:
            - params
            - type
          title: Auth Entries Signature
          type: object
    WalletsSignatureV2025ResponseDTO:
      properties:
        approvals:
          description: >-
            Complete approval data including requirements, pending and submitted
            signatures
          properties:
            pending:
              description: List of pending signatures
              items:
                anyOf:
                  - description: Approval entry for a quorum (multisig) admin signer
                    properties:
                      quorumApprovals:
                        description: Per-member progress of an m-of-n quorum signer
                        properties:
                          pending:
                            description: Quorum members that have not yet submitted
                            items:
                              properties:
                                message:
                                  description: The message that this member needs to sign
                                  type: string
                                signer:
                                  description: >-
                                    The full signer object of the quorum member
                                    that's pending approval
                                  oneOf:
                                    - description: Full API Key signer object
                                      properties:
                                        address:
                                          description: The address of the api key
                                          type: string
                                        locator:
                                          description: The locator of the api key signer
                                          type: string
                                        type:
                                          enum:
                                            - api-key
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: API Key Signer
                                      type: object
                                    - description: Full Device signer object
                                      properties:
                                        locator:
                                          description: The locator of the device signer
                                          type: string
                                        name:
                                          description: >-
                                            Optional human-readable name for the
                                            device signer
                                          type: string
                                        publicKey:
                                          description: The p256 public key of the device signer
                                          properties:
                                            x:
                                              type: string
                                            'y':
                                              type: string
                                          required:
                                            - x
                                            - 'y'
                                          type: object
                                        type:
                                          enum:
                                            - device
                                          type: string
                                      required:
                                        - locator
                                        - publicKey
                                        - type
                                      title: Device Signer
                                      type: object
                                    - description: Full External Wallet signer object
                                      properties:
                                        address:
                                          description: The address of the external wallet
                                          type: string
                                        locator:
                                          description: >-
                                            The locator of the external wallet
                                            signer
                                          type: string
                                        type:
                                          enum:
                                            - external-wallet
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: External Wallet Signer
                                      type: object
                                    - description: Full Passkey signer object
                                      properties:
                                        id:
                                          description: The ID of the passkey
                                          type: string
                                        locator:
                                          description: The locator of the passkey signer
                                          type: string
                                        type:
                                          enum:
                                            - passkey
                                          type: string
                                      required:
                                        - id
                                        - locator
                                        - type
                                      title: Passkey Signer
                                      type: object
                                    - properties:
                                        address:
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - server
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        email:
                                          format: email
                                          pattern: >-
                                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - email
                                          type: string
                                      required:
                                        - email
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        locator:
                                          type: string
                                        phone:
                                          type: string
                                        type:
                                          enum:
                                            - phone
                                          type: string
                                      required:
                                        - locator
                                        - phone
                                        - type
                                      type: object
                              required:
                                - message
                                - signer
                              type: object
                            type: array
                          remaining:
                            description: >-
                              Number of member approvals still outstanding to
                              reach the threshold
                            type: number
                          submitted:
                            description: Quorum members that have already submitted
                            items:
                              properties:
                                message:
                                  description: The message that this member signed
                                  type: string
                                signature:
                                  description: The cryptographic signature
                                  type: string
                                signer:
                                  description: >-
                                    The full signer object of the quorum member
                                    who submitted this signature
                                  oneOf:
                                    - description: Full API Key signer object
                                      properties:
                                        address:
                                          description: The address of the api key
                                          type: string
                                        locator:
                                          description: The locator of the api key signer
                                          type: string
                                        type:
                                          enum:
                                            - api-key
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: API Key Signer
                                      type: object
                                    - description: Full Device signer object
                                      properties:
                                        locator:
                                          description: The locator of the device signer
                                          type: string
                                        name:
                                          description: >-
                                            Optional human-readable name for the
                                            device signer
                                          type: string
                                        publicKey:
                                          description: The p256 public key of the device signer
                                          properties:
                                            x:
                                              type: string
                                            'y':
                                              type: string
                                          required:
                                            - x
                                            - 'y'
                                          type: object
                                        type:
                                          enum:
                                            - device
                                          type: string
                                      required:
                                        - locator
                                        - publicKey
                                        - type
                                      title: Device Signer
                                      type: object
                                    - description: Full External Wallet signer object
                                      properties:
                                        address:
                                          description: The address of the external wallet
                                          type: string
                                        locator:
                                          description: >-
                                            The locator of the external wallet
                                            signer
                                          type: string
                                        type:
                                          enum:
                                            - external-wallet
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: External Wallet Signer
                                      type: object
                                    - description: Full Passkey signer object
                                      properties:
                                        id:
                                          description: The ID of the passkey
                                          type: string
                                        locator:
                                          description: The locator of the passkey signer
                                          type: string
                                        type:
                                          enum:
                                            - passkey
                                          type: string
                                      required:
                                        - id
                                        - locator
                                        - type
                                      title: Passkey Signer
                                      type: object
                                    - properties:
                                        address:
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - server
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        email:
                                          format: email
                                          pattern: >-
                                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - email
                                          type: string
                                      required:
                                        - email
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        locator:
                                          type: string
                                        phone:
                                          type: string
                                        type:
                                          enum:
                                            - phone
                                          type: string
                                      required:
                                        - locator
                                        - phone
                                        - type
                                      type: object
                                submittedAt:
                                  anyOf:
                                    - description: ISO 8601 formatted timestamp
                                      type: number
                                    - type: string
                                  description: When the member signature was submitted
                              required:
                                - message
                                - signature
                                - signer
                                - submittedAt
                              type: object
                            type: array
                          threshold:
                            description: >-
                              Number of member approvals required to satisfy the
                              quorum
                            type: number
                        required:
                          - pending
                          - remaining
                          - submitted
                          - threshold
                        type: object
                      signer:
                        description: The quorum signer this approval entry belongs to
                        properties:
                          locator:
                            description: >-
                              The derived `quorum:<id>` locator of the quorum
                              signer
                            type: string
                          type:
                            enum:
                              - quorum
                            type: string
                        required:
                          - locator
                          - type
                        title: Quorum Signer Reference
                        type: object
                    required:
                      - quorumApprovals
                      - signer
                    type: object
                  - properties:
                      message:
                        description: The message that needs to be signed
                        type: string
                      signer:
                        description: The full signer object that's pending approval
                        oneOf:
                          - description: Full API Key signer object
                            properties:
                              address:
                                description: The address of the api key
                                type: string
                              locator:
                                description: The locator of the api key signer
                                type: string
                              type:
                                enum:
                                  - api-key
                                type: string
                            required:
                              - address
                              - locator
                              - type
                            title: API Key Signer
                            type: object
                          - description: Full Device signer object
                            properties:
                              locator:
                                description: The locator of the device signer
                                type: string
                              name:
                                description: >-
                                  Optional human-readable name for the device
                                  signer
                                type: string
                              publicKey:
                                description: The p256 public key of the device signer
                                properties:
                                  x:
                                    type: string
                                  'y':
                                    type: string
                                required:
                                  - x
                                  - 'y'
                                type: object
                              type:
                                enum:
                                  - device
                                type: string
                            required:
                              - locator
                              - publicKey
                              - type
                            title: Device Signer
                            type: object
                          - description: Full External Wallet signer object
                            properties:
                              address:
                                description: The address of the external wallet
                                type: string
                              locator:
                                description: The locator of the external wallet signer
                                type: string
                              type:
                                enum:
                                  - external-wallet
                                type: string
                            required:
                              - address
                              - locator
                              - type
                            title: External Wallet Signer
                            type: object
                          - description: Full Passkey signer object
                            properties:
                              id:
                                description: The ID of the passkey
                                type: string
                              locator:
                                description: The locator of the passkey signer
                                type: string
                              type:
                                enum:
                                  - passkey
                                type: string
                            required:
                              - id
                              - locator
                              - type
                            title: Passkey Signer
                            type: object
                          - properties:
                              address:
                                type: string
                              locator:
                                type: string
                              type:
                                enum:
                                  - server
                                type: string
                            required:
                              - address
                              - locator
                              - type
                            type: object
                          - properties:
                              email:
                                format: email
                                pattern: >-
                                  ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                                type: string
                              locator:
                                type: string
                              type:
                                enum:
                                  - email
                                type: string
                            required:
                              - email
                              - locator
                              - type
                            type: object
                          - properties:
                              locator:
                                type: string
                              phone:
                                type: string
                              type:
                                enum:
                                  - phone
                                type: string
                            required:
                              - locator
                              - phone
                              - type
                            type: object
                    required:
                      - message
                      - signer
                    type: object
              type: array
            required:
              description: Number of required approvals for the transaction
              type: number
            submitted:
              description: Record of all submitted signatures
              items:
                anyOf:
                  - description: Approval entry for a quorum (multisig) admin signer
                    properties:
                      quorumApprovals:
                        description: Per-member progress of an m-of-n quorum signer
                        properties:
                          pending:
                            description: Quorum members that have not yet submitted
                            items:
                              properties:
                                message:
                                  description: The message that this member needs to sign
                                  type: string
                                signer:
                                  description: >-
                                    The full signer object of the quorum member
                                    that's pending approval
                                  oneOf:
                                    - description: Full API Key signer object
                                      properties:
                                        address:
                                          description: The address of the api key
                                          type: string
                                        locator:
                                          description: The locator of the api key signer
                                          type: string
                                        type:
                                          enum:
                                            - api-key
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: API Key Signer
                                      type: object
                                    - description: Full Device signer object
                                      properties:
                                        locator:
                                          description: The locator of the device signer
                                          type: string
                                        name:
                                          description: >-
                                            Optional human-readable name for the
                                            device signer
                                          type: string
                                        publicKey:
                                          description: The p256 public key of the device signer
                                          properties:
                                            x:
                                              type: string
                                            'y':
                                              type: string
                                          required:
                                            - x
                                            - 'y'
                                          type: object
                                        type:
                                          enum:
                                            - device
                                          type: string
                                      required:
                                        - locator
                                        - publicKey
                                        - type
                                      title: Device Signer
                                      type: object
                                    - description: Full External Wallet signer object
                                      properties:
                                        address:
                                          description: The address of the external wallet
                                          type: string
                                        locator:
                                          description: >-
                                            The locator of the external wallet
                                            signer
                                          type: string
                                        type:
                                          enum:
                                            - external-wallet
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: External Wallet Signer
                                      type: object
                                    - description: Full Passkey signer object
                                      properties:
                                        id:
                                          description: The ID of the passkey
                                          type: string
                                        locator:
                                          description: The locator of the passkey signer
                                          type: string
                                        type:
                                          enum:
                                            - passkey
                                          type: string
                                      required:
                                        - id
                                        - locator
                                        - type
                                      title: Passkey Signer
                                      type: object
                                    - properties:
                                        address:
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - server
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        email:
                                          format: email
                                          pattern: >-
                                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - email
                                          type: string
                                      required:
                                        - email
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        locator:
                                          type: string
                                        phone:
                                          type: string
                                        type:
                                          enum:
                                            - phone
                                          type: string
                                      required:
                                        - locator
                                        - phone
                                        - type
                                      type: object
                              required:
                                - message
                                - signer
                              type: object
                            type: array
                          remaining:
                            description: >-
                              Number of member approvals still outstanding to
                              reach the threshold
                            type: number
                          submitted:
                            description: Quorum members that have already submitted
                            items:
                              properties:
                                message:
                                  description: The message that this member signed
                                  type: string
                                signature:
                                  description: The cryptographic signature
                                  type: string
                                signer:
                                  description: >-
                                    The full signer object of the quorum member
                                    who submitted this signature
                                  oneOf:
                                    - description: Full API Key signer object
                                      properties:
                                        address:
                                          description: The address of the api key
                                          type: string
                                        locator:
                                          description: The locator of the api key signer
                                          type: string
                                        type:
                                          enum:
                                            - api-key
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: API Key Signer
                                      type: object
                                    - description: Full Device signer object
                                      properties:
                                        locator:
                                          description: The locator of the device signer
                                          type: string
                                        name:
                                          description: >-
                                            Optional human-readable name for the
                                            device signer
                                          type: string
                                        publicKey:
                                          description: The p256 public key of the device signer
                                          properties:
                                            x:
                                              type: string
                                            'y':
                                              type: string
                                          required:
                                            - x
                                            - 'y'
                                          type: object
                                        type:
                                          enum:
                                            - device
                                          type: string
                                      required:
                                        - locator
                                        - publicKey
                                        - type
                                      title: Device Signer
                                      type: object
                                    - description: Full External Wallet signer object
                                      properties:
                                        address:
                                          description: The address of the external wallet
                                          type: string
                                        locator:
                                          description: >-
                                            The locator of the external wallet
                                            signer
                                          type: string
                                        type:
                                          enum:
                                            - external-wallet
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      title: External Wallet Signer
                                      type: object
                                    - description: Full Passkey signer object
                                      properties:
                                        id:
                                          description: The ID of the passkey
                                          type: string
                                        locator:
                                          description: The locator of the passkey signer
                                          type: string
                                        type:
                                          enum:
                                            - passkey
                                          type: string
                                      required:
                                        - id
                                        - locator
                                        - type
                                      title: Passkey Signer
                                      type: object
                                    - properties:
                                        address:
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - server
                                          type: string
                                      required:
                                        - address
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        email:
                                          format: email
                                          pattern: >-
                                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                                          type: string
                                        locator:
                                          type: string
                                        type:
                                          enum:
                                            - email
                                          type: string
                                      required:
                                        - email
                                        - locator
                                        - type
                                      type: object
                                    - properties:
                                        locator:
                                          type: string
                                        phone:
                                          type: string
                                        type:
                                          enum:
                                            - phone
                                          type: string
                                      required:
                                        - locator
                                        - phone
                                        - type
                                      type: object
                                submittedAt:
                                  anyOf:
                                    - description: ISO 8601 formatted timestamp
                                      type: number
                                    - type: string
                                  description: When the member signature was submitted
                              required:
                                - message
                                - signature
                                - signer
                                - submittedAt
                              type: object
                            type: array
                          threshold:
                            description: >-
                              Number of member approvals required to satisfy the
                              quorum
                            type: number
                        required:
                          - pending
                          - remaining
                          - submitted
                          - threshold
                        type: object
                      signer:
                        description: The quorum signer this approval entry belongs to
                        properties:
                          locator:
                            description: >-
                              The derived `quorum:<id>` locator of the quorum
                              signer
                            type: string
                          type:
                            enum:
                              - quorum
                            type: string
                        required:
                          - locator
                          - type
                        title: Quorum Signer Reference
                        type: object
                    required:
                      - quorumApprovals
                      - signer
                    type: object
                  - properties:
                      message:
                        description: The message that was signed
                        type: string
                      metadata:
                        description: Additional metadata about the signature submission
                        properties:
                          deviceInfo:
                            type: string
                          ipAddress:
                            type: string
                          userAgent:
                            type: string
                        type: object
                      signature:
                        description: The cryptographic signature
                        type: string
                      signer:
                        description: The full signer object who submitted this signature
                        oneOf:
                          - description: Full API Key signer object
                            properties:
                              address:
                                description: The address of the api key
                                type: string
                              locator:
                                description: The locator of the api key signer
                                type: string
                              type:
                                enum:
                                  - api-key
                                type: string
                            required:
                              - address
                              - locator
                              - type
                            title: API Key Signer
                            type: object
                          - description: Full Device signer object
                            properties:
                              locator:
                                description: The locator of the device signer
                                type: string
                              name:
                                description: >-
                                  Optional human-readable name for the device
                                  signer
                                type: string
                              publicKey:
                                description: The p256 public key of the device signer
                                properties:
                                  x:
                                    type: string
                                  'y':
                                    type: string
                                required:
                                  - x
                                  - 'y'
                                type: object
                              type:
                                enum:
                                  - device
                                type: string
                            required:
                              - locator
                              - publicKey
                              - type
                            title: Device Signer
                            type: object
                          - description: Full External Wallet signer object
                            properties:
                              address:
                                description: The address of the external wallet
                                type: string
                              locator:
                                description: The locator of the external wallet signer
                                type: string
                              type:
                                enum:
                                  - external-wallet
                                type: string
                            required:
                              - address
                              - locator
                              - type
                            title: External Wallet Signer
                            type: object
                          - description: Full Passkey signer object
                            properties:
                              id:
                                description: The ID of the passkey
                                type: string
                              locator:
                                description: The locator of the passkey signer
                                type: string
                              type:
                                enum:
                                  - passkey
                                type: string
                            required:
                              - id
                              - locator
                              - type
                            title: Passkey Signer
                            type: object
                          - properties:
                              address:
                                type: string
                              locator:
                                type: string
                              type:
                                enum:
                                  - server
                                type: string
                            required:
                              - address
                              - locator
                              - type
                            type: object
                          - properties:
                              email:
                                format: email
                                pattern: >-
                                  ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                                type: string
                              locator:
                                type: string
                              type:
                                enum:
                                  - email
                                type: string
                            required:
                              - email
                              - locator
                              - type
                            type: object
                          - properties:
                              locator:
                                type: string
                              phone:
                                type: string
                              type:
                                enum:
                                  - phone
                                type: string
                            required:
                              - locator
                              - phone
                              - type
                            type: object
                      submittedAt:
                        anyOf:
                          - description: ISO 8601 formatted timestamp
                            type: number
                          - type: string
                        description: When the signature was submitted
                    required:
                      - message
                      - signature
                      - signer
                      - submittedAt
                    type: object
              type: array
          type: object
        chainType:
          description: The blockchain type of the wallet
          enum:
            - aptos
            - evm
            - solana
            - stellar
            - sui
          type: string
        completedAt:
          anyOf:
            - description: ISO 8601 formatted timestamp
              type: number
            - type: string
          description: ISO timestamp when the transaction reached finality
        createdAt:
          anyOf:
            - description: ISO 8601 formatted timestamp
              type: number
            - type: string
          description: ISO timestamp when the signature was created
        error:
          description: Error message if the signature fails
        id:
          description: Unique identifier for the signature
          type: string
        outputSignature:
          description: The wallet's output signature of the request
          type: string
        params:
          anyOf:
            - description: Parameters for Stellar authorization entries signature (SEP-45)
              properties:
                authorizationEntries:
                  description: Base64-encoded XDR array of the authorization entries
                  type: string
                signer:
                  description: The full signer object who will approve this entry
                  oneOf:
                    - description: Full API Key signer object
                      properties:
                        address:
                          description: The address of the api key
                          type: string
                        locator:
                          description: The locator of the api key signer
                          type: string
                        type:
                          enum:
                            - api-key
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      title: API Key Signer
                      type: object
                    - description: Full Device signer object
                      properties:
                        locator:
                          description: The locator of the device signer
                          type: string
                        name:
                          description: Optional human-readable name for the device signer
                          type: string
                        publicKey:
                          description: The p256 public key of the device signer
                          properties:
                            x:
                              type: string
                            'y':
                              type: string
                          required:
                            - x
                            - 'y'
                          type: object
                        type:
                          enum:
                            - device
                          type: string
                      required:
                        - locator
                        - publicKey
                        - type
                      title: Device Signer
                      type: object
                    - description: Full External Wallet signer object
                      properties:
                        address:
                          description: The address of the external wallet
                          type: string
                        locator:
                          description: The locator of the external wallet signer
                          type: string
                        type:
                          enum:
                            - external-wallet
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      title: External Wallet Signer
                      type: object
                    - description: Full Passkey signer object
                      properties:
                        id:
                          description: The ID of the passkey
                          type: string
                        locator:
                          description: The locator of the passkey signer
                          type: string
                        type:
                          enum:
                            - passkey
                          type: string
                      required:
                        - id
                        - locator
                        - type
                      title: Passkey Signer
                      type: object
                    - properties:
                        address:
                          type: string
                        locator:
                          type: string
                        type:
                          enum:
                            - server
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      type: object
                    - properties:
                        email:
                          format: email
                          pattern: >-
                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                          type: string
                        locator:
                          type: string
                        type:
                          enum:
                            - email
                          type: string
                      required:
                        - email
                        - locator
                        - type
                      type: object
                    - properties:
                        locator:
                          type: string
                        phone:
                          type: string
                        type:
                          enum:
                            - phone
                          type: string
                      required:
                        - locator
                        - phone
                        - type
                      type: object
              required:
                - authorizationEntries
              title: Auth entries signature parameters
              type: object
            - description: Parameters for a message signature
              properties:
                chain:
                  description: The chain on which the signature will be submitted
                  enum:
                    - abstract
                    - abstract-testnet
                    - apechain
                    - arbitrum
                    - arbitrum-sepolia
                    - arbitrumnova
                    - arc-testnet
                    - astar-zkevm
                    - avalanche
                    - avalanche-fuji
                    - base
                    - base-goerli
                    - base-sepolia
                    - bsc
                    - bsc-testnet
                    - chiliz
                    - chiliz-spicy-testnet
                    - coti
                    - coti-testnet
                    - crossmint-private-testnet-ethereum
                    - crossmint-private-testnet-polygon
                    - curtis
                    - ethereum
                    - ethereum-goerli
                    - ethereum-sepolia
                    - flow
                    - flow-testnet
                    - hedera
                    - hedera-testnet
                    - hypersonic-testnet
                    - lightlink
                    - lightlink-pegasus
                    - mantle
                    - mantle-sepolia
                    - mode
                    - mode-sepolia
                    - optimism
                    - optimism-goerli
                    - optimism-sepolia
                    - plume
                    - plume-testnet
                    - polygon
                    - polygon-amoy
                    - polygon-mumbai
                    - rari
                    - rari-testnet
                    - robinhood-chain
                    - robinhood-chain-testnet
                    - scroll
                    - scroll-sepolia
                    - sei-atlantic-2-testnet
                    - sei-pacific-1
                    - shape
                    - shape-sepolia
                    - skale-nebula
                    - skale-nebula-testnet
                    - soneium
                    - soneium-minato-testnet
                    - space
                    - space-testnet
                    - story
                    - story-testnet
                    - tempo
                    - tempo-testnet
                    - u2u-nebulas
                    - u2u-solaris
                    - verify-testnet
                    - viction
                    - viction-testnet
                    - world-chain
                    - world-chain-sepolia
                    - xai
                    - xai-sepolia-testnet
                    - zenchain-testnet
                    - zkatana
                    - zkyoto
                    - zora
                    - zora-goerli
                    - zora-sepolia
                  type: string
                message:
                  description: The message in plain text to sign
                  type: string
                signer:
                  description: >-
                    The full signer object who will submit this signature.
                    Defaults to the wallet's admin signer.
                  oneOf:
                    - description: Full API Key signer object
                      properties:
                        address:
                          description: The address of the api key
                          type: string
                        locator:
                          description: The locator of the api key signer
                          type: string
                        type:
                          enum:
                            - api-key
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      title: API Key Signer
                      type: object
                    - description: Full Device signer object
                      properties:
                        locator:
                          description: The locator of the device signer
                          type: string
                        name:
                          description: Optional human-readable name for the device signer
                          type: string
                        publicKey:
                          description: The p256 public key of the device signer
                          properties:
                            x:
                              type: string
                            'y':
                              type: string
                          required:
                            - x
                            - 'y'
                          type: object
                        type:
                          enum:
                            - device
                          type: string
                      required:
                        - locator
                        - publicKey
                        - type
                      title: Device Signer
                      type: object
                    - description: Full External Wallet signer object
                      properties:
                        address:
                          description: The address of the external wallet
                          type: string
                        locator:
                          description: The locator of the external wallet signer
                          type: string
                        type:
                          enum:
                            - external-wallet
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      title: External Wallet Signer
                      type: object
                    - description: Full Passkey signer object
                      properties:
                        id:
                          description: The ID of the passkey
                          type: string
                        locator:
                          description: The locator of the passkey signer
                          type: string
                        type:
                          enum:
                            - passkey
                          type: string
                      required:
                        - id
                        - locator
                        - type
                      title: Passkey Signer
                      type: object
                    - properties:
                        address:
                          type: string
                        locator:
                          type: string
                        type:
                          enum:
                            - server
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      type: object
                    - properties:
                        email:
                          format: email
                          pattern: >-
                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                          type: string
                        locator:
                          type: string
                        type:
                          enum:
                            - email
                          type: string
                      required:
                        - email
                        - locator
                        - type
                      type: object
                    - properties:
                        locator:
                          type: string
                        phone:
                          type: string
                        type:
                          enum:
                            - phone
                          type: string
                      required:
                        - locator
                        - phone
                        - type
                      type: object
              required:
                - message
              title: Message signature parameters
              type: object
            - description: Parameters for a typed data signature
              properties:
                chain:
                  description: The chain on which the signature will be submitted
                  enum:
                    - abstract
                    - abstract-testnet
                    - apechain
                    - arbitrum
                    - arbitrum-sepolia
                    - arbitrumnova
                    - arc-testnet
                    - astar-zkevm
                    - avalanche
                    - avalanche-fuji
                    - base
                    - base-goerli
                    - base-sepolia
                    - bsc
                    - bsc-testnet
                    - chiliz
                    - chiliz-spicy-testnet
                    - coti
                    - coti-testnet
                    - crossmint-private-testnet-ethereum
                    - crossmint-private-testnet-polygon
                    - curtis
                    - ethereum
                    - ethereum-goerli
                    - ethereum-sepolia
                    - flow
                    - flow-testnet
                    - hedera
                    - hedera-testnet
                    - hypersonic-testnet
                    - lightlink
                    - lightlink-pegasus
                    - mantle
                    - mantle-sepolia
                    - mode
                    - mode-sepolia
                    - optimism
                    - optimism-goerli
                    - optimism-sepolia
                    - plume
                    - plume-testnet
                    - polygon
                    - polygon-amoy
                    - polygon-mumbai
                    - rari
                    - rari-testnet
                    - robinhood-chain
                    - robinhood-chain-testnet
                    - scroll
                    - scroll-sepolia
                    - sei-atlantic-2-testnet
                    - sei-pacific-1
                    - shape
                    - shape-sepolia
                    - skale-nebula
                    - skale-nebula-testnet
                    - soneium
                    - soneium-minato-testnet
                    - space
                    - space-testnet
                    - story
                    - story-testnet
                    - tempo
                    - tempo-testnet
                    - u2u-nebulas
                    - u2u-solaris
                    - verify-testnet
                    - viction
                    - viction-testnet
                    - world-chain
                    - world-chain-sepolia
                    - xai
                    - xai-sepolia-testnet
                    - zenchain-testnet
                    - zkatana
                    - zkyoto
                    - zora
                    - zora-goerli
                    - zora-sepolia
                  type: string
                isSmartWalletSignature:
                  description: >-
                    Whether the signature corresponds to the smart wallet or to
                    the signer. If true, the signature will be wrapped with
                    ERC6492.
                  type: boolean
                signer:
                  description: The full signer object who will approve this signature
                  oneOf:
                    - description: Full API Key signer object
                      properties:
                        address:
                          description: The address of the api key
                          type: string
                        locator:
                          description: The locator of the api key signer
                          type: string
                        type:
                          enum:
                            - api-key
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      title: API Key Signer
                      type: object
                    - description: Full Device signer object
                      properties:
                        locator:
                          description: The locator of the device signer
                          type: string
                        name:
                          description: Optional human-readable name for the device signer
                          type: string
                        publicKey:
                          description: The p256 public key of the device signer
                          properties:
                            x:
                              type: string
                            'y':
                              type: string
                          required:
                            - x
                            - 'y'
                          type: object
                        type:
                          enum:
                            - device
                          type: string
                      required:
                        - locator
                        - publicKey
                        - type
                      title: Device Signer
                      type: object
                    - description: Full External Wallet signer object
                      properties:
                        address:
                          description: The address of the external wallet
                          type: string
                        locator:
                          description: The locator of the external wallet signer
                          type: string
                        type:
                          enum:
                            - external-wallet
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      title: External Wallet Signer
                      type: object
                    - description: Full Passkey signer object
                      properties:
                        id:
                          description: The ID of the passkey
                          type: string
                        locator:
                          description: The locator of the passkey signer
                          type: string
                        type:
                          enum:
                            - passkey
                          type: string
                      required:
                        - id
                        - locator
                        - type
                      title: Passkey Signer
                      type: object
                    - properties:
                        address:
                          type: string
                        locator:
                          type: string
                        type:
                          enum:
                            - server
                          type: string
                      required:
                        - address
                        - locator
                        - type
                      type: object
                    - properties:
                        email:
                          format: email
                          pattern: >-
                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                          type: string
                        locator:
                          type: string
                        type:
                          enum:
                            - email
                          type: string
                      required:
                        - email
                        - locator
                        - type
                      type: object
                    - properties:
                        locator:
                          type: string
                        phone:
                          type: string
                        type:
                          enum:
                            - phone
                          type: string
                      required:
                        - locator
                        - phone
                        - type
                      type: object
                typedData:
                  properties:
                    domain:
                      properties:
                        chainId:
                          type: number
                        name:
                          type: string
                        salt:
                          description: A hex string
                          type: string
                        verifyingContract:
                          description: An EVM address string
                          type: string
                        version:
                          type: string
                      required:
                        - chainId
                        - name
                        - verifyingContract
                        - version
                      type: object
                    message:
                      additionalProperties: true
                      type: object
                    primaryType:
                      type: string
                    types:
                      additionalProperties:
                        items:
                          properties:
                            name:
                              type: string
                            type:
                              type: string
                          required:
                            - name
                            - type
                          type: object
                        type: array
                      type: object
                  required:
                    - domain
                    - message
                    - primaryType
                    - types
                  type: object
              required:
                - chain
                - typedData
              title: Typed data signature parameters
              type: object
          description: Type-specific signature parameters
        status:
          description: Current status of the signature
          enum:
            - awaiting-approval
            - failed
            - pending
            - success
          type: string
        type:
          description: The type of signature
          enum:
            - auth-entries
            - message
            - typed-data
          type: string
        walletType:
          description: The wallet type (smart or mpc)
          enum:
            - mpc
            - smart
          type: string
      required:
        - approvals
        - chainType
        - createdAt
        - id
        - params
        - status
        - type
        - walletType
      type: object
    WalletV1Alpha2ErrorDTO:
      properties:
        code:
          description: >-
            Optional stable error code identifying the specific failure case.
            Present when the backend raises a structured error that consumers
            may want to detect programmatically.
          example: DEVICE_SIGNER_NOT_SUPPORTED
          type: string
        error:
          enum:
            - true
          type: boolean
        message:
          description: Error message
          example: <error message>
          type: string
      required:
        - error
        - message
      type: object

````