@snowflake-so/snowflake-cli NPM

Snowflake CLI

Snowflake CLI provides you a set of commands to interact with the Solana on-chain cron jobs.

Read this article to know more about the CLI: https://medium.com/@snowflake_so/snowflake-cli-is-here-be75840bfbf3

Installation

Install with NPM

npm install -g @snowflake-so/snowflake-cli

Or with Yarn

yarn add -G @snowflake-so/snowflake-cli

How to use the CLI?

Usage: snowflake [options] [command]

Snowflake CLI to interact with Snowflake SDK

Options:
  -V, --version   output the version number
  -h, --help      display help for command

Commands:
  config          Configure Snowflake CLI
  job             Manage job
  jobs            Manage jobs
  account         Manage wallet account
  help [command]  display help for command

Development Guide

To create a new command, go to src/command and create a new command following the structure of current commands config.ts or job.ts.

Add a new command to the command instruction in the index.ts

Command List

1. Utility Command

--help (-h): Provides help information

--version (-v): Prints the version number

2. Get configuration

Usage: snowflake config get [options]

Get Snowflake CLI configuration

Options:
  -h, --help  display help for command

config get: Prints the configuration file

3. Set configuration

Usage: snowflake config set [options]

Set Snowflake CLI configuration

Options:
  --url <RPC_URL>              Set URL to Solana RPC endpoint
  --keypair <PATH_TO_KEYPAIR>  Set path to keypair
  -h, --help                   display help for command

config set: Sets the configuration file

Flags

--url <URL>: Solana Cluster endpoint (mainnet-beta, devnet, testnet)
--keypair <PATH_TO_KEYPAIR>: Path to keypair

4. Read command

job get [publicKey]

Parameters

publicKey: Public key of a job

5. Read all command

Usage: snowflake jobs get [options]

Get global jobs

Options:
  --latest                 Get latest job
  --limit <LIMIT>          Limit number of jobs
  --offset <OFFSET>        Offset number of jobs
  --owner <OWNER_ADDRESS>  Get jobs by owner
  -p, --pretty             Pretty print
  -f, --fields [FIELDS]    Fields to display
  -h, --help               display help for command

jobs get: Get all Jobs

Flags

--limit <LIMIT>: Limit number of jobs fetched
--offset <OFFSET>: Offset number of jobs fetched
--owner <OWNER_ADDRESS>: Fetch jobs of provided owner address
-p, --pretty: Prettify the output data
-f, --fields: Specify the fields of the output data

6. Delete

Usage: snowflake job delete [options] [publicKey]

Delete a job

Arguments:
  publicKey   Public key of the job

Options:
  -h, --help  display help for command

job delete [publicKey]: Deletes a job

Parameters

publicKey: Public key of a job

7. Manage user fee account

Usage: snowflake account [options] [command]

Manage wallet account

Options:
  -h, --help        display help for command

Commands:
  pda [publicKey]   Get user account information
  deposit [amount]  Deposit to user fee account
  help [command]    display help for command

account pda [publicKey]: Get information of the user fee account (Program Derived Address)