This tool allows you to generate reports that detail an endpoint's standard relayer API HTTP specification compliance. The tool will perform a Postman collection run and either print a report to the console or save it to disk as a json file. SRA report can also output a Postman collection file and Postman environment file in order to facilitate replication and debugging of collection runs using the Postman native app.
The tool currently performs the following checks for each endpoint:
application/jsonContent-Type header validation
Features to come:
/orderbookendpoint should return orders in order of price)
yarn add -g @0xproject/sra-report
sra-report Options: --help Show help [boolean] --version Show version number [boolean] --endpoint-url, -e API endpoint url to test for standard relayer API compliance [string] [required] --output, -o, --out The relative path to write the report generated by the collection run, prints to console by default [string] --network-id, -n ID of the network that the API is serving orders from [number] [default: 1] --environment, --env The relative path to a postman environment file for the collection run [string] --export-collection, --ec The relative path to write the postman collection file used by the collection run [string] --export-environment, --ee The relative path to write the postman environment file used by the collection run [string]
sra-report --endpoint-url 'http://api.example.com'
sra-report --endpoint-url 'http://api.example.com' --output 'path/to/report.json'
sra-report --endpoint-url 'http://kovan.api.example.com' --network-id 42
sra-report --endpoint-url 'http://.api.example.com' --export-collection 'path/to/collection.json' --export-environment 'path/to/environment.json'
sra-report --endpoint-url 'http://.api.example.com' --environment 'path/to/custom/environment.json'
When testing your standard relayer API endpoint in development, it may be useful to modify the Postman environment file generated by this tool such that specific query parameters are used during the collection run. For example, by default, this tool will grab the first order it can from the
/orders endpoint and use properties from that order as query parameters for the rest of the run. Another example is the tool will default to the WETH and ZRX token contracts when querying some endpoints but you may want to specify these.
In order to provide a custom environment to the tool, perform the following steps:
We welcome improvements and fixes from the wider community! To report bugs within this package, please create an issue in this repository.
Please read our contribution guidelines before getting started.
If you don't have yarn workspaces enabled (Yarn < v1.0) - enable them:
yarn config set workspaces-experimental true
Then install dependencies
To build this package and all other monorepo packages that it depends on, run the following from the monorepo root directory:
PKG=@0xproject/sra-report yarn build
Or continuously rebuild on change:
PKG=@0xproject/sra-report yarn watch