Create a new signature request.

post

https://api.woleet.io/v1/signatureRequest

Use this operation to create a new signature request.

The properties id, created and lastModified are read-only and so must not be provided: they are managed by the platform and added to the returned request.

Only the properties name and hashToSign are required: the hashToSign property must be the SHA256 hash of the data to sign. This allows not to leak the original data and to keep the actual signed data small (signing the digest is equivalent to signing the original data).

Be sure to have enough anchoring credits on your account to fulfill the signature request (each signature registered will cost you 1 anchoring credit).

Body Params

SignatureRequest object to create.

name

string

required

Name of the signature request (doesn't need to be unique).

suspended

boolean

true if the signature request is suspended, or false (or unset) if not.

When suspended, no more signature can be registered before the request is resumed.

hashToSign

string

required

SHA256 hash (ie. the fingerprint) of the original data to sign.

anchors

array of objects

List of signature anchors created for this signature request.

This property is only available to the owner of the signature request.

anchors

deadline

int64

Deadline of the signature request (in milliseconds since Unix epoch).

When not set, null or 0, no deadline is applied.

If set, signatures registered after the deadline are refused.

maxSignatures

int32

Maximum number of signatures to accept for this signature request.

When not set, null or 0, no maximum is applied.

If set, signatures coming from signees not in this list are refused.

This property and the authorizedSignees property are mutually exclusive.

This property is only available to the owner of the signature request.

authorizedSignees

array of objects

List of public keys of all signees authorized to register their signature for this signature request (no duplicate is authorized).

Currently only Bitcoin addresses are supported.

When not set or null, anybody can sign the signature request.

If set, signatures from public keys not in this list are rejected.

This property and the maxSignatures property are mutually exclusive.

This property is only available to the owner of the signature request.

authorizedSignees

Responses

400

Invalid signature request object. More details are returned in the response body as a JSON object.

200The created signature request.