Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

hyperdrive

Package Overview
Dependencies
Maintainers
1
Versions
273
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

hyperdrive

A file sharing network based on rabin file chunking and append only feeds of data verified by merkle trees.

  • 2.2.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
1K
decreased by-54.17%
Maintainers
1
Weekly downloads
 
Created
Source

hyperdrive

A file sharing network based on rabin file chunking and append only feeds of data verified by merkle trees.

npm install hyperdrive

build status

For a more detailed technical information on how it works see SPECIFICATION.md. If you are interested in only using the feed part of the spec see hypercore which implements that.

Usage

First create a new feed to share

var hyperdrive = require('hyperdrive')
var level = require('level')

var db = level('./hyperdrive.db')
var drive = hyperdrive(db)

var pack = drive.add('./some-folder')

pack.appendFile('my-file.txt', function (err) {
  if (err) throw err
  pack.finalize(function () {
    var link = pack.id.toString('hex')
    console.log(link, '<-- this is your hyperdrive link')
  })
})

Then to share it

var disc = require('discovery-channel')()
var hyperdrive = require('hyperdrive')
var net = require('net')
var level = require('level')
var db = levelup('./another-hyperdrive.db')
var drive = hyperdrive(db)

var link = new Buffer({your-hyperdrive-link-from-the-above-example}, 'hex')

var server = net.createServer(function (socket) {
  socket.pipe(drive.createPeerStream()).pipe(socket)
})

server.listen(0, function () {
  disc.add(link, server.address().port)
  disc.on('peer', function (hash, peer) {
    var socket = net.connect(peer.port, peer.host)
    socket.pipe(drive.createPeerStream()).pipe(socket)
  })
})

If you run this code on multiple computers you should be able to access the content in the feed by doing

var archive = drive.get(link, './folder-to-store-data-in') // the link identifies/verifies the content

archive.entry(0, function (err, entry) { // get the first entry
  console.log(entry) // prints {name: 'my-file.txt', ...}
  var stream = archive.createFileStream(0)
  stream.on('data', function (data) {
    console.log(data) // <-- file data
  })
  stream.on('end', function () {
    console.log('no more data')
  })
})

API

var drive = hyperdrive(db)

Create a new hyperdrive instance. db should be a levelup instance. You can add a folder to store the file data in as the second argument.

var stream = drive.createPeerStream()

Create a new peer replication duplex stream. This stream should be piped together with another peer stream somewhere else to start replicating the feeds

var archive = drive.add([basefolder])

Add a new archive to share. basefolder will be the root of this archive.

var archive = drive.get(id, [basefolder])

Retrive a finalized archive.

archive.on('file-download', entry, data)

Emitted when a data block if downloaded for a file.

archive.on('file-downloaded', entry)

Emitted when a file is fully downloaded.

archive.appendFile(filename, [name], [callback])

Append a file to a non-finalized archive. If you don't specify name the entry will be called filename.

archive.finalize([callback])

Finalize an archive. After an archive is finalized it will be sharable and will have a .id property.

archive.ready(callback)

Wait for the archive to be ready. Afterwards archive.entries will contain the total amount of entries available.

archive.entry(index, callback)

Read the entry metadata stored at index. An metadata entry looks like this

{
  type: 'file-or-directory',
  name: 'filename',
  mode: fileMode,
  size: fileSize,
  uid: optionalUid,
  gid: optionalGid,
  mtime: optionalMtimeInSeconds,
  ctime: optionalCtimeInSeconds
}
archive.download(index, [callback])

Downloads the file specified by index and calls the callback when done. You have to call this or create a file stream to download a file.

var rs = archive.createFileStream(index)

Create a stream to a file.

var rs = archive.createEntryStream()

Stream out all metadata entries

License

MIT

FAQs

Package last updated on 28 Jan 2016

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc