Sign a message with a waas account

POST /sdk/{environmentId}/waas/{walletId}/signMessage

Try it

Sign a message with a waas account

cURL

curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/signMessage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "isFormatted": true,
  "roomId": "<string>",
  "context": {
    "evmTransaction": {
      "to": "<string>",
      "chainId": 123,
      "data": "<string>",
      "gas": "<string>",
      "gasPrice": "<string>",
      "maxFeePerGas": "<string>",
      "maxPriorityFeePerGas": "<string>",
      "nonce": 123,
      "value": "<string>"
    },
    "evmUserOperation": {
      "chainId": 123,
      "entryPoint": "<string>",
      "operation": {
        "authorization": {
          "address": "<string>",
          "chainId": 123,
          "nonce": 123,
          "r": "<string>",
          "s": "<string>",
          "v": "<string>",
          "yParity": 123
        },
        "callData": "<string>",
        "callGasLimit": "<string>",
        "factory": "<string>",
        "factoryData": "<string>",
        "maxFeePerGas": "<string>",
        "maxPriorityFeePerGas": "<string>",
        "nonce": "<string>",
        "paymaster": "<string>",
        "paymasterData": "<string>",
        "paymasterPostOpGasLimit": "<string>",
        "paymasterVerificationGasLimit": "<string>",
        "preVerificationGas": "<string>",
        "sender": "<string>",
        "signature": "<string>",
        "verificationGasLimit": "<string>"
      }
    },
    "svmTransaction": {
      "chainId": "<string>",
      "method": "<string>",
      "serializedTransactions": [
        "<string>"
      ]
    },
    "suiTransaction": {
      "chainId": "An example name",
      "serializedTransaction": "<string>"
    },
    "eip7702Auth": {
      "address": "<string>",
      "chainId": 123,
      "nonce": 123
    },
    "evmMessage": "<string>",
    "svmMessage": "<string>",
    "suiMessage": "<string>",
    "evmTypedData": {
      "domain": {
        "name": "<string>",
        "version": "<string>",
        "chainId": 123,
        "verifyingContract": "0xbF394748301603f18d953C90F0b087CBEC0E1834"
      },
      "message": {},
      "primaryType": "<string>",
      "types": {}
    },
    "domain": "https://app.xyz.com"
  }
}
'

200

{
  "roomId": "<string>",
  "serverKeygenIds": [
    "<string>"
  ],
  "newServerKeygenIds": [
    "<string>"
  ],
  "walletId": "95b11417-f18f-457f-8804-68e361f9164f"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

environmentId · string · required

ID of the environment

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

walletId · string · required

UUID of the wallet

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

Sign Message Request

message · string · required

A string with a max length of 16384 characters

Maximum string length: 16384

isFormatted · boolean

roomId · string

context · object

Show child attributes

context. evmTransaction · object

Standard EVM transaction

Show child attributes

context.evmTransaction. to · string · required

Recipient address

context.evmTransaction. chainId · number · required

Chain ID

context.evmTransaction. data · string

Transaction data as hex string

context.evmTransaction. gas · string

Gas limit as hex string

context.evmTransaction. gasPrice · string

Gas price as hex string

context.evmTransaction. maxFeePerGas · string

Maximum fee per gas as hex string

context.evmTransaction. maxPriorityFeePerGas · string

Maximum priority fee per gas as hex string

context.evmTransaction. nonce · number

Transaction nonce

context.evmTransaction. value · string

Transaction value as hex string

context. evmUserOperation · object

User Operation (ERC-4337)

Show child attributes

context.evmUserOperation. chainId · number

Chain identifier needed for user operation hash calculation

context.evmUserOperation. entryPoint · string

Address of the entry point contract

context.evmUserOperation. operation · object

The actual user operation data

Show child attributes

context.evmUserOperation.operation. authorization · object

Authorization signature data (optional)

Show child attributes

context.evmUserOperation.operation.authorization. address · string

Address that signed the authorization

context.evmUserOperation.operation.authorization. chainId · number

Chain ID for the authorization signature

context.evmUserOperation.operation.authorization. nonce · number

Nonce used in the authorization signature

context.evmUserOperation.operation.authorization. r · string

R component of the ECDSA signature

context.evmUserOperation.operation.authorization. s · string

S component of the ECDSA signature

context.evmUserOperation.operation.authorization. v · string

V component of the ECDSA signature

context.evmUserOperation.operation.authorization. yParity · number

Y parity of the signature (0 or 1)

context.evmUserOperation.operation. callData · string

The data to pass to the sender during the main execution call

context.evmUserOperation.operation. callGasLimit · string

The amount of gas to allocate the main execution call

context.evmUserOperation.operation. factory · string

Account factory address (optional, only for new accounts)

context.evmUserOperation.operation. factoryData · string

Data for account factory (optional)

context.evmUserOperation.operation. maxFeePerGas · string

Maximum fee per gas

context.evmUserOperation.operation. maxPriorityFeePerGas · string

Maximum priority fee per gas

context.evmUserOperation.operation. nonce · string

Anti-replay parameter

context.evmUserOperation.operation. paymaster · string

Address of paymaster contract (optional)

context.evmUserOperation.operation. paymasterData · string

Data for paymaster (optional)

context.evmUserOperation.operation. paymasterPostOpGasLimit · string

The amount of gas to allocate for the paymaster post-operation code (optional)

context.evmUserOperation.operation. paymasterVerificationGasLimit · string

The amount of gas to allocate for the paymaster validation code (optional)

context.evmUserOperation.operation. preVerificationGas · string

Extra gas to pay the Bundler

context.evmUserOperation.operation. sender · string

The account making the operation

context.evmUserOperation.operation. signature · string

Data passed into the account to verify authorization

context.evmUserOperation.operation. verificationGasLimit · string

The amount of gas to allocate for the verification step

context. svmTransaction · object

Solana serialized transactions

Show child attributes

context.svmTransaction. chainId · string · required

Chain identifier

context.svmTransaction. method · string · required

Method identifier

context.svmTransaction. serializedTransactions · string[] · required

Array of serialized transaction strings

context. suiTransaction · object

Sui BCS serialized transaction as hex string

Show child attributes

context.suiTransaction. chainId · string · required

Maximum string length: 255

Example:

"An example name"

context.suiTransaction. serializedTransaction · string · required

A string with a max length of 16384 characters

Maximum string length: 16384

context. eip7702Auth · object

EIP-7702 auth

Show child attributes

context.eip7702Auth. address · string · required

Address that signed the authorization

context.eip7702Auth. chainId · number · required

Chain ID

context.eip7702Auth. nonce · number · required

Nonce

context. evmMessage

EVM message that can be either a plain string or an object with raw hex data

context. svmMessage · string

A string with a max length of 16384 characters

Maximum string length: 16384

context. suiMessage · string

A string with a max length of 16384 characters

Maximum string length: 16384

context. evmTypedData · object

EIP-712 typed data payload

Show child attributes

context.evmTypedData. domain · object · required

Show child attributes

context.evmTypedData.domain. name · string

context.evmTypedData.domain. version · string

context.evmTypedData.domain. chainId · number

context.evmTypedData.domain. verifyingContract · string

Valid blockchain wallet address, must be an alphanumeric string without any special characters

Maximum string length: 255

Example:

"0xbF394748301603f18d953C90F0b087CBEC0E1834"

context.evmTypedData. message · object · required

Typed data message object

context.evmTypedData. primaryType · string · required

context.evmTypedData. types · object · required

Show child attributes

context.evmTypedData.types. {key} · object[]

Show child attributes

context.evmTypedData.types.{key}. name · string · required

context.evmTypedData.types.{key}. type · string · required

context. domain · string

Maximum string length: 255

Example:

"https://app.xyz.com"

Response

200

application/json

Successfully created a room for signing message ceremony

roomId · string · required

serverKeygenIds · string[]

A base58 string with a max length of 100 characters

Maximum string length: 100

newServerKeygenIds · string[]

A base58 string with a max length of 100 characters

Maximum string length: 100

walletId · string

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"