The Stateless CLI is a powerful command-line interface that allows you to interact with the Stateless services for managing offerings, entrypoints, buckets, and API keys.
Before installing the CLI, ensure you have the following:
- Python 3.10 or newer
- pip installed (Python's package installer)
The CLI is available through a Python package repository, and you can download it using pip:
pip install stateless-sdkAfter installation, run the setup command to initiate the CLI. This command will also handle API key setup:
stateless-cliDuring the setup, if you don't have an API key, the CLI will direct you to the Stateless API key registration page. Once you have your API key, you can set it as an environment variable for the CLI to use.
Setting the environment variable with your API key can be done in different ways depending on your operating system.
For Unix-like operating systems (Linux, macOS):
export STATELESS_API_KEY='your_api_key_here'For Windows Command Prompt:
set STATELESS_API_KEY=your_api_key_hereFor Windows PowerShell:
$env:STATELESS_API_KEY="your_api_key_here"Replace your_api_key_here with the actual API key provided by Stateless.
To check if the CLI has been installed correctly, you can run the help command:
stateless-cli --helpThis should display a list of available commands and their descriptions.
If you installed the CLI in a custom directory or it's not available globally, you might need to update your system's PATH variable to include the directory where the CLI is installed.
Once the CLI is installed and the API key is set, you can start using it to manage various aspects of the Stateless services by calling the corresponding subcommands, like stateless-cli offerings list.
API keys are essential for both applications and providers to interact securely with the platform by authenticating access to resources. Always handle API keys with care, keeping them confidential and using them as per the platform's best practices.
stateless-cli api-keys createThe create command lets users generate a new API key. When this command is executed, the CLI will interactively prompt for the required information, including the name of the API key and the number of days until expiration. Upon completion, a confirmation message will be displayed with details of the newly created API key. Upon completion, a confirmation message will be displayed with details of the newly created API key.
stateless-cli api-keys updateThe update command allows users to modify the details of an existing API key. The CLI will prompt the user to choose an API key and then provide options to update its name and expiration date.
stateless-cli api-keys view Users can fetch details about a specific API key using this command. The CLI will prompt the user to select an API key, and then display its details.
stateless-cli api-keys listFetches and displays a list of all the API keys associated with the current account. The list will include the ID and name of each API key.
stateless-cli api-keys deleteThis command allows for the deletion of a specific API key. The user will be prompted to select an API key for deletion. Please note that this action is irreversible, and deleted keys cannot be recovered.
Offerings are the cataloged services or data streams provided by the platform, which users can utilize within their applications. These offerings may relate to specific blockchain data, services, or entry points for data access. Managing offerings is a crucial aspect for both providers, who supply these services, and consumers, who integrate them into their applications.
stateless-cli offerings listUse this command to retrieve and list all available offerings. The output displays a table listing all offerings, including their IDs, providers, chains, and the count of entry points associated with each offering.
stateless-cli offerings detail <id>Retrieve detailed information about a specific offering using this command. The CLI will prompt the user to select an offering, and the output will display a table with detailed information about the offering, including its ID, the provider name, the chain it operates on, and the URLs for each of its entry points.
stateless-cli offerings createThe create command allows data service providers to create a new offering. The CLI will interactively prompt for the required information, including the target blockchain platform for the offering.
stateless-cli offerings update <offering_id>Providers can modify the details of an existing offering using this command. The CLI will prompt the user to select an offering and then provide options to update its chain ID. If the update is successful, the command prints a confirmation message with the ID of the updated offering.
stateless-cli offerings delete <offering_id>Use this command to remove an offering from the platform. The user will be prompted to select an offering for deletion. A success message will confirm the offering has been deleted. Please note that this action is irreversible.
Buckets are designated blockchain data providers that applications using the platform's APIs elect to send their requests. The CLI offers commands to seamlessly manage these Buckets.
Prior to leveraging these commands, please ensure all prerequisites, such as API keys and configurations, are properly implemented.
stateless-cli buckets listThis command fetches and displays all the active Buckets of the current account. Users can view a comprehensive list and glean important information about each 'Bucket,' such as its ID, Name, associated Chain, and Offerings.
stateless-cli buckets createThe create command allows users to create a new Bucket associated with their account. The CLI will interactively prompt for the required information, including Bucket Name, Chain ID, and Offerings (selected from available offerings).
stateless-cli buckets update <bucket_id>This command allows users to modify the details of an existing bucket. The CLI will prompt the user to select a bucket and then provide options to update its name and associated offerings.
stateless-cli buckets view <bucket_id>Fetches detailed information about a specific Bucket based on its UUID. The CLI will prompt the user to select a bucket, and the output will display detailed information about the Bucket, including its ID, name, associated chain, and offerings.
stateless-cli buckets delete <bucket_id>This command provides the functionality to remove a Bucket from an account. The user will be prompted to select a bucket for deletion. Please note that this action will permanently delete the specified Bucket resource and all its associated data. A confirmation message will be displayed upon successful deletion.
stateless-cli buckets healthPresents a list of Buckets to select from. After selection, it shows the node status, block height, and latency for each provider within the Bucket.
stateless-cli buckets health <url>Checks the health of a specific bucket.
stateless-cli buckets health --live
stateless-cli buckets health <url> --liveBy appending the --live flag to the health check commands, the metrics will be updated in real-time, offering dynamic and up-to-date information on the nodes' status.
Entrypoints are specific URLs or access points that data providers use to provide access to an individual offering. Managing entrypoints is essential for providers to control how and where their data is accessed. This set of CLI commands is intended for providers to manage entrypoints, these details are managed by the service and not relevant to the application's usage.
stateless-cli entrypoints listRetrieves and lists all entrypoints associated with a specific offering. Users can view a table displaying each entrypoint's ID, URL, and associated region.
stateless-cli entrypoints view <entrypoint_id>Fetches information about a specific entrypoint. The CLI will prompt the user to select an entrypoint, and the output will display a JSON-formatted output detailing the entrypoint's configuration.
stateless-cli entrypoints createThe create command registers a new entrypoint. When executed, the CLI will interactively prompt for the required information, including Entrypoint URL, Offering ID, and Region ID.
stateless-cli entrypoints update <entrypoint_id>Allows for updating the configuration of an existing entrypoint. The CLI will prompt the user to select an entrypoint and then provide options to update its URL.
stateless-cli entrypoints delete <entrypoint_id>Removes an entrypoint from the registry. The user will be prompted to select an entrypoint for deletion. A message confirming the successful deletion of the entrypoint will be displayed. Please note this action is final and cannot be undone.
The help command in the gateway-cli is designed to provide users with assistance and information on how to use various commands within the CLI. It's an essential tool for both new and experienced users to quickly get help on specific commands or to get an overview of the CLI's capabilities.
stateless-cli helpThis command displays a general help message, which includes a list of all top-level commands available in the gateway-cli. It provides a brief description of what each command does to better understand the overall functionality.
When you run gateway-cli help, you will see an output similar to the following:
stateless-cli
Usage:
gateway-cli [command]
Available Commands:
buckets Manage your Buckets
offerings Handle Offerings on the platform
entrypoints Control Entrypoints for data access
api-keys Operations related to API keys
Use "stateless-cli [command] help" for more information about a command.To get detailed help on a specific command, append help after the command name:
stateless-cli [command] helpFor example:
stateless-cli buckets helpDisplays help for the buckets command, including its subcommands like list, create, update, view, and delete.
stateless-cli offerings helpShows detailed usage for the offerings command, including information on listing, creating, updating, and deleting offerings.
stateless-cli entrypoints helpProvides help specific to the entrypoints command, guiding on how to manage entrypoints.