File-Based Secret Storage (Insecure)

For evaluation and prototyping purposes, Signatory file-based signer mode allows operation without an HSM or Key Vault service. By storing the secret key material in a JSON file, users can get Signatory up and running quickly for evaluation and development purposes.

Signatory configuration for file-based secret storage

The documentation assumes you will use the official Signatory docker image, and that you have a Linux server operably configured with docker installed.

Place the following YAML in a file /etc/signatory.yaml

# Address/Port that Signatory listens on
address: :6732
# Address/Port that Signatory serves prometheus metrics on
utility_address: :9583
# Name of vault
driver: file
file: /etc/secret.json
# List enabled public keys hashes here
# Default policy allows "block" and "endorsement" operations
log_payloads: true
# List of [generic, block, endorsement]
- generic
- block
- endorsement

The tz1Wk1Wdczh5BzyZ1uz2DW9xdFg9B5cFuGFm key corresponds to the secret key that you will put in /etc/secret.json

Contents of /etc/secret.json is:

[ { "name": "your_secret_key",
"unencrypted:edsk3DYwZpPmbNTRSdJW2wBeHoneNqjPt9Xj49Fnhcir6q47JpD5Vz" } ]

Running Signatory

Next, you want to run the signatory docker image as follows:

Remember to secure the network where Signatory is running

docker run -it --rm \
-v "$(realpath file.yaml):/app/signatory.yaml" \
-v "$(realpath tezkeys/secret_keys):/etc/secret.json" \
-p 6732:6732 \
-p 9583:9583 \
ecadlabs/signatory:latest serve -config /app/signatory.yaml

Verify that signatory is working

You can test that signatory is working, making a GET request using the Public Key Hash (PKH). Signatory will return a JSON payload containing the public key.

curl signatory:6732/keys/tz1Wk1Wdczh5BzyZ1uz2DW9xdFg9B5cFuGFm

A response such as the following should be expected:


You can test the signing functionality by making a POST request as follows:

curl -XPOST \
-d '"02111111111111111110"' \

Which should return an HTTP 200 OK with a payload similar to:


If you repeat the same signing operation more than once, you will get an error from the High-Watermark feature. This is a safety measure to prevent injection of duplicate operations.

The payload on this request resembles a Tezos endorsement that would be emitted from a Tezos Baker node.