How to set up your endorsement server

Learn how to set up your endorsement server

The open-source DFlow endorsement server contains all the instructions to get your endorsement server up and running. Once you have an endorsement server up and running, you must set your endorsement key in the DFlow Dashboard before creating auctions.

How to rotate endorsement key

As a best security practice (or in case your endorsement key is leaked), you can rotate your endorsement key without downtime by doing the following:

  1. Create a new endorsement key
  2. Add your new endorsement key to your DFlow account
  3. Run a new instance of the endorsement server that uses the new endorsement key
  4. Shut down your old instance of the endorsement server
  5. Remove your old endorsement key from your DFlow account

πŸ‘

Zero-downtime endorsement key rotation

DFlow only accepts endorsements that were signed by an endorsement key that is currently in your DFlow account. To avoid having any of users' requests rejected due to a mismatched endorsement key during key rotation, you must add your new endorsement key to your DFlow account before running the new instance of the endorsement server that uses the new endorsement key. You must remove your old endorsement key from your DFlow account after shutting down your old instance of the endorsement server that uses the old endorsement key.


What’s Next

Once your endorsement server is up and running, you must create auctions before sending orders to DFlow. Learn how to manage auctions.