Jump to

• Request
• Response

Sign Transaction or Typed Data

post

/walletservice/v1/wallets/{walletId}/sign

Sign EVM transaction payloads (and EIP-712 payloads via kind=eip712) with the specified wallet.

Request

Path Parameters

• walletId(required): integer(int64)
  Wallet identifier.

  Example:

  101

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Unified sign request. Preferred shape is { blockchainKind, kind, data }. Backward-compatible legacy transaction and JSON-RPC shapes are also accepted.

Show Source

• blockchainKind: string
  Blockchain family selector. Defaults to evm when omitted.

  Example: evm
• chainId: chainId
• data: object data
  Additional Properties Allowed: true

  Payload object. For transaction kinds this is tx data. For eip712 this may contain typed_data.
• id: id
• jsonrpc: string
  Example: 2.0
• jsonRpcMethod: string
  Legacy JSON-RPC method field accepted for backward compatibility.

  Example: eth_signTransaction
• kind: string
  Allowed Values: [ "transaction", "evm", "eip712" ]

  Signing kind. Defaults to transaction when omitted.

  Example: transaction
• method: string
  Example: eth_signTransaction
• params: array params
• rpcUrl: string (uri)
  Optional RPC endpoint used for nonce, gas, and transaction type resolution before returning the signed transaction.

  Example: http://127.0.0.1:8545

{
    "type":"object",
    "description":"Unified sign request. Preferred shape is { blockchainKind, kind, data }. Backward-compatible legacy transaction and JSON-RPC shapes are also accepted.",
    "properties":{
        "blockchainKind":{
            "type":"string",
            "description":"Blockchain family selector. Defaults to evm when omitted.",
            "example":"evm"
        },
        "kind":{
            "type":"string",
            "description":"Signing kind. Defaults to transaction when omitted.",
            "enum":[
                "transaction",
                "evm",
                "eip712"
            ],
            "example":"transaction"
        },
        "data":{
            "type":"object",
            "description":"Payload object. For transaction kinds this is tx data. For eip712 this may contain typed_data.",
            "additionalProperties":true
        },
        "jsonrpc":{
            "type":"string",
            "example":"2.0"
        },
        "method":{
            "type":"string",
            "example":"eth_signTransaction"
        },
        "params":{
            "type":"array",
            "items":{
                "type":"object"
            },
            "example":[
                {
                    "from":"0xa537b178b12E40EC07c361Fa1D5bb1f6770f7262",
                    "to":"0x2a58b1eb2f8821c3001eece71921ce977f6529ad",
                    "data":"0x",
                    "gas":21000,
                    "gasPrice":0,
                    "nonce":0,
                    "value":0,
                    "chainId":1337
                }
            ]
        },
        "id":{
            "oneOf":[
                {
                    "type":"integer",
                    "format":"int64"
                },
                {
                    "type":"string"
                }
            ],
            "example":1
        },
        "chainId":{
            "oneOf":[
                {
                    "type":"integer",
                    "format":"int64"
                },
                {
                    "type":"string"
                }
            ],
            "example":1337
        },
        "rpcUrl":{
            "type":"string",
            "format":"uri",
            "description":"Optional RPC endpoint used for nonce, gas, and transaction type resolution before returning the signed transaction.",
            "example":"http://127.0.0.1:8545"
        },
        "jsonRpcMethod":{
            "type":"string",
            "description":"Legacy JSON-RPC method field accepted for backward compatibility.",
            "example":"eth_signTransaction"
        }
    }
}

Nested Schema : chainId

Match One Schema

Show Source

• integer(int64)
• string

{
    "oneOf":[
        {
            "type":"integer",
            "format":"int64"
        },
        {
            "type":"string"
        }
    ],
    "example":1337
}

Example:

1337

Nested Schema : data

Type: object

Additional Properties Allowed: true

Payload object. For transaction kinds this is tx data. For eip712 this may contain typed_data.

Nested Schema : id

Match One Schema

Show Source

• integer(int64)
• string

{
    "oneOf":[
        {
            "type":"integer",
            "format":"int64"
        },
        {
            "type":"string"
        }
    ],
    "example":1
}

Example:

1

Nested Schema : params

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    },
    "example":[
        {
            "from":"0xa537b178b12E40EC07c361Fa1D5bb1f6770f7262",
            "to":"0x2a58b1eb2f8821c3001eece71921ce977f6529ad",
            "data":"0x",
            "gas":21000,
            "gasPrice":0,
            "nonce":0,
            "value":0,
            "chainId":1337
        }
    ]
}

Example:

[
    {
        "from":"0xa537b178b12E40EC07c361Fa1D5bb1f6770f7262",
        "to":"0x2a58b1eb2f8821c3001eece71921ce977f6529ad",
        "data":"0x",
        "gas":21000,
        "gasPrice":0,
        "nonce":0,
        "value":0,
        "chainId":1337
    }
]

Nested Schema : items

Type: object

Examples

Select an example transactionSign eip712Sign

Security

• bearerAuth: http
  Type: http

Back to Top

Response

Supported Media Types

• application/json

200 Response

Payload signed successfully.

Body ()

Root Schema : SignTransactionResponse

Type: object

Show Source

• dateSigned(required): string (date-time)
  Example: 2026-05-26T19:23:08.736547549Z
• signature(required): object signature
• walletId(required): string
  Example: 5b018c64-bde8-4927-8183-93cda4422a23

{
    "type":"object",
    "properties":{
        "walletId":{
            "type":"string",
            "example":"5b018c64-bde8-4927-8183-93cda4422a23"
        },
        "dateSigned":{
            "type":"string",
            "format":"date-time",
            "example":"2026-05-26T19:23:08.736547549Z"
        },
        "signature":{
            "type":"object",
            "properties":{
                "r":{
                    "type":"string",
                    "nullable":true,
                    "example":null
                },
                "s":{
                    "type":"string",
                    "nullable":true,
                    "example":null
                },
                "v":{
                    "type":"integer",
                    "nullable":true,
                    "example":null
                },
                "recid":{
                    "type":"integer",
                    "nullable":true,
                    "example":null
                },
                "encoded":{
                    "type":"string",
                    "description":"Signed payload hex.",
                    "example":"0xf91f0..."
                }
            },
            "required":[
                "encoded"
            ]
        }
    },
    "required":[
        "walletId",
        "dateSigned",
        "signature"
    ]
}

Nested Schema : signature

Type: object

Show Source

• encoded(required): string
  Signed payload hex.

  Example: 0xf91f0...
• r: string
  Example: oracle.doceng.json.BetterJsonNull@73194df
• recid: integer
  Example: oracle.doceng.json.BetterJsonNull@3a4621bd
• s: string
  Example: oracle.doceng.json.BetterJsonNull@12f9af83
• v: integer
  Example: oracle.doceng.json.BetterJsonNull@1f010bf0

{
    "type":"object",
    "properties":{
        "r":{
            "type":"string",
            "nullable":true,
            "example":null
        },
        "s":{
            "type":"string",
            "nullable":true,
            "example":null
        },
        "v":{
            "type":"integer",
            "nullable":true,
            "example":null
        },
        "recid":{
            "type":"integer",
            "nullable":true,
            "example":null
        },
        "encoded":{
            "type":"string",
            "description":"Signed payload hex.",
            "example":"0xf91f0..."
        }
    },
    "required":[
        "encoded"
    ]
}

Examples

Select an example transactionSignResponse eip712SignResponse

400 Response

Bad request.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

500 Response

Internal server error.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top