Skip to content

blockfrost/blockfrost-haskell

Repository files navigation

GitHub Actions Hackage blockfrost-api Hackage blockfrost-client Hackage blockfrost-pretty Made by Five Binaries

blockfrost-haskell


Haskell SDK for Blockfrost.io API.

AboutGetting startedInstallationUsage


About

The repository provides an API definition, data types, client and utilities for working with Blockfrost. We are striving to provide beginner-friendly interface while adding a bit of type safety, especially when working with monetary values.

Packages

Getting started

To use this SDK, you first need to log in to blockfrost.io, create your project and retrieve the API token.


Installation

Packages are available on Hackage, you only need to add blockfrost-client to your package dependencies.

Haddocks available on Hackage:

  • Hackage blockfrost-api
  • Hackage blockfrost-client
  • Hackage blockfrost-pretty

Development setup

You can either work within this repository using plain cabal or in combination with nix.

cabal

If you already have GHC and cabal installed:

git clone https://github.com/blockfrost/blockfrost-haskell
cd blockfrost-haskell
cabal update
cabal build all
cabal repl blockfrost-client

Note: Due to TLS support, you might need to provide zlib headers if compilation of http-client-tls fails. (On NixOS this is nix-shell -p zlib.dev).

nix

Using nix-shell, you can obtain a preconfigured environment with GHC and cabal:

git clone https://github.com/blockfrost/blockfrost-haskell
cd blockfrost-haskell
nix-shell
cabal build all
cabal repl blockfrost-client

Usage

See blockfrost-client for a tutorial and usage examples.

Readme of blockfrost-api contains a short primer for working with Blockfrost types, data samples and monetary values.