🚧 WIP: This tool is in active development, and can experience breaking changes

Flare

Flare is the Command Line Interface for developers on Solana. Below is a breakdown of the various commands included within Flare. If you run into any issues while operating Flare, please open an issue on this repo or contact a contributor from Anthias Labs here.

Installation

1. Download the right binary from releases, or build it yourself (see below)
2. Optionally, rename it to flare for convenience.
3. Place it into the PATH to have it available everywhere in your system.
4. Run it with flare in the terminal.

Building

Please make sure you have Cargo in your system.

1. Clone the repo with git clone https://github.com/Anthias-Labs/flare.git
2. Move into the folder: cd flare
3. Build the project: cargo build
4. Move into the binary location cd target/debug
5. Run the compiled binary with ./flare

Usage

Read the documentation and find some project examples here.

To test the tool and see some example usage:

1. Write a mnemonic with some balance in devnet to a .mnemonic file in root.
2. Run ./example-usage.sh. This will build the tool and test every command.

Functions

Chain and Transaction Interactions:

flare send: allows sending SOL to an account

flare balance: checks SOL balance for a given address

flare epoch: get the current epoch number

flare block-height: get the current epoch number

flare call: calls an arbitrary Anchor program method

flare read-account: reads and deserializes an arbitrary account

flare fetch-idl: fetches the published IDL from an Anchor program

Wallet Management:

flare wallet-create: generates keypair and mnemonic for a new wallet

flare wallet-recover: gets keypair from a given mnemonic

Utils (Additional):

flare sign: sign an arbitrary message with a given private key

flare address-derive: derives address from a keypair file

flare generate-pda: generates Program Derived Address from program address and seeds

Roadmap

• Reading wallet SOL balance from chain
• Reading epoch/block height
• Sending SOL transactions between accounts
• Creating wallets and recovering from mnemonic
• Signing arbitrary messages
• Adding CLI options for handling different cluster RPCs
• Calling methods and reading state from on-chain programs
• Adding utils for common operations
• File-based wallet and config management (storage and read)
• Add support for multiple signers on an instruction
• Add support for Program Derived Addresses
• Improve documentation and error messages

About

Flare is the first tool from Solstice, the toolkit for developers on Solana. The development of Flare was originally funded by a grant from the Solana Foundation to Anthias Labs in January of 2024. Flare’s public launch is scheduled for April of 2024.

Anthias Labs is a boutique blockchain r&d firm focused on public goods tooling and actionable research. To see more about us, feel free to review here.

Acknowledgements

Flare would not be possible without support from many parties over many moons. Acknowledgments of the contributors to Flare will be shared soon.

Contributing

To contribute to Flare, please reach out to the current contributors in our main Contributor Discord.