Getting Started

Onboarding

To get started using Trust API you need to do the following

  1. Complete the API Onboarding
  2. Browse our API Documentation and download directly into Postman if required
  3. Decide whether you want to create transactions with the API and:
    1. sign transactions on the phone
    2. sign transactions with the API

Understanding Rate Limits

We use a number of safeguards against bursts of incoming traffic to help maximise stability. Users who send many requests in quick succession might see error responses that show up at status code 429.

The maximum number of requests that are allowed is based on a time interval, this is calculated through averaging the number of requests per second flowing through our system.

You shouldn’t experience a rate limit with normal throughput. However if you experience a rate limit, please contact support.

If you’re requesting an increase, please contact us in advance of when you’ll need to the increased rate limit.

Sign Transactions with the iPhone

Use postman CreateTransaction Mutations to create all the transactions and sign them via the TrustVault App.

Transactions created via the API will appear in the inbox of the TrustVault app for signing.

Sign Transactions using TrustVault Node.js SDK

Users that wish to hold their own external Instruction Key in order to sign programmatically will need to do the following (this will remove the iPhone as the signing device):

  1. Register your external public instruction key using replacePublicKeyInDefaultSchedule method in the TrustVault Node.js SDK
  2. Send bitcoin or send ethereum transactions using the TrustVault Node.js SDK

Please check out our TrustVault Node.js Tutorials for the list of methods available.

Sign Transactions with the API

Users that wish to hold their own external Instruction Key in order to sign programmatically will need to do the following (this will remove the iPhone as the signing device):

  1. Register your external public instruction key (by changing your wallet policy)

Users will now need to sign all transactions with the new Instruction Key.

  1. JavaScript example of Sending a BTC transaction with the new Instruction Key.

Please check out our public postman collection for all of the current API requests.