Light, modular, functional http-client for the Arweave blockchain
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.circleci
arweave @ f0d1e7b
core/src
docker
project
scripts
test/src
types/src/main/scala/co/upvest/arweave4s
.env
.gitignore
.gitmodules
COPYING
LICENSE.circe
LICENSE.sttp
README.md
build.sbt
docker-compose.yaml
logo.png
scalastyle-config.xml
version.sbt

README.md

Arweave4s

arweave4s logo

BuildStatus GitHub license Latest version

Overview

Arweave4s is a lightweight modular http client for the Arweave blockchain

The core of Arweave4s is based on the sttp http client, this allow to use it with different http backends of your choice, such as akka-http, Moniz, OkHttp, Scalaz Streams, plain Futures, synchronously and many more.

The response handling is designed to be as flexible as the backend. By providing implicit response handlers for the monad of your choice Try, Future EitherT, or plain old throw exceptions like it's 1999.

The current version implements the following endpoints

  • GET network information
  • GET full transaction via ID
  • GET specific transaction fields via ID
  • GET transaction body as HTML via ID
  • GET estimated transaction price
  • GET block via ID
  • GET block via height
  • GET current block
  • GET wallet balance via address
  • GET last transaction via address
  • GET nodes peer list
  • POST transaction to network

Additionally the client supports wallet generation and transaction signing

Quickstart

Add the following dependency

"co.upvest" %% "arweave4s-core" % "0.6.0"

then create a configuration context and weave-it-up.

 implicit val c = api.Config(host = TestHost, HttpURLConnectionBackend())
 import api.id._
 
 api.block.current()
 res1: Block = ...

Examples

Lets put some data on the Arweave blockchain!

 // Create configuration. Set the sttp's async backend for returning Futures
 implicit val _ = api.Config(host = TestHost, AsyncHttpClientFutureBackend())
 
 // Import response handler for Future
 import api.future._
 import scala.concurrent.ExecutionContext.global
 
 // Data to persist on the blockchain.
 val testData = Data("Hi Mom!".getBytes("UTF-8"))
 
 // Let's get a new wallet
 val wallet = Wallet.generate()
 for {
      // using the API method to estimate the price for the transaction in `Winstons`
      price    <- api.price.estimate(testData)
      // Get the last transaction of the sender wallet
      lastTx   <- api.address.lastTx(wallet)
      // Construct and send the transaction.
      ()       <- api.tx.submit(Transaction.Data(
            id     = Transaction.Id.generate(),
            lastTx = lastTx,
            owner  = wallet,
            data   = testData,
            reward = price)
            // Here we actually sign our transaction
            .sign(wallet)
          )
      } yield ()
      

Voilà, we persisted the data on the blockchain!

Contact

By questions, comments or suggestions feel free to get in touch by creating an PR or an issue.

For more information to Arweave protocol, check the Arweave whitepaper and visit them on Github.

Cavecats sic

Copyright 2018 Ivan Morozov, Gustav Behm, Tokn GmbH (https://upvest.co)

Arrweave4s is provided to you as free software under the MIT license. The MIT software license is attached in the COPYING file.