Authentication
StreamingFast Substreams authentication reference
A StreamingFast authentication token is required for connecting to the Substreams server.
An authentication token is a JSON Web Token (JWT) that will grant access to the StreamingFast infrastructure.
The API key is required for obtaining an authentication token. Register for an authentication key at
app.streamingfast.io. The StreamingFast team is generally available on Discord and can assist with API key generation there as well.
An authentication token must be requested after successfully obtaining the API key.
Use the following command to request the authentication token using the StreamingFast API key.
curl -s https://auth.streamingfast.io/v1/auth/issue --data-binary '{"api_key":"your-secret-key"}'
The token should be set as an ENV variable through the terminal using the following command. Note, be sure to surround the token in quotes as seen in the code below.
export SUBSTREAMS_API_TOKEN="your_token"
By default the
substreams run command will check the SUBSTREAMS_API_TOKEN environment variable for the StreamingFast authentication token.Note:
Authentication Token Env Flag
The default behavior of the
substreams run command can use a custom ENV var name that has the Authentication token with the flag --substreams-api-token-envvar.The following
bash function can be run from the command line to obtain a token. The following function can be placed in the .bashrc file, located in the computer's home directory. # Ask us on Discord for a key
export STREAMINGFAST_KEY=server_YOUR_KEY_HERE
function sftoken {
export FIREHOSE_API_TOKEN=$(curl https://auth.streamingfast.io/v1/auth/issue -s --data-binary '{"api_key":"'$STREAMINGFAST_KEY'"}' | jq -r .token)
export SUBSTREAMS_API_TOKEN=$FIREHOSE_API_TOKEN
echo Token set on FIREHOSE_API_TOKEN and SUBSTREAMS_API_TOKEN
}
Issue the following command to the terminal to load the key into the
SUBSTREAMS_API_TOKEN environment variable.sftoken
Last modified 1mo ago