minibus client

Minibus API client and CLI tool.

Install

npm install @web3-storage/minibus

Usage

import { Minibus } from '@web3-storage/minibus'
import { fromString } from 'uint8arrays'
import { sha256 } from 'multiformats/hashes/sha2'
import { CID } from 'multiformats/cid'
import * as raw from 'multiformats/codecs/raw'
import fetch from '@web-std/fetch'

const minibus = new Minibus({
  endpoint: `https://minibus.web3.storage`,
  headers: { Authorization: `Basic ${token}` },
  fetch
})

const data = fromString(`TEST DATA ${Date.now()}`)
const hash = await sha256.digest(data)
const cid = CID.create(1, raw.code, hash)

await minibus.put(cid, data)

const dataOrUndefined = await minibus.get(cid)
if (!dataOrUndefined) throw new Error('not found')

CLI

Install the module globally to use as a CLI tool:

npm install -g @web3-storage/minibus

$ minibus --help

  Usage
    $ minibus <command> [options]

  Available Commands
    token      Save an API token to use for all requests.
    put-car    Upload blocks from a CAR file to Minibus.
    get        Fetch a block from Minibus

  For more info, run any command with the `--help` flag
    $ minibus token --help
    $ minibus put-car --help

  Options
    -v, --version    Displays current version
    -h, --help       Displays this message

  Examples
    $ minibus get bafkreigh2akiscaildcqabsyg3dfr6chu3fgpregiymsck7e7aqa4s52zy
    $ minibus put-car path/to/file.car

Contributing

Feel free to join in. All welcome. Open an issue!

License

Dual-licensed under MIT + Apache 2.0