Security News
RubyGems.org Adds New Maintainer Role
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
hyperdrive
Advanced tools
A file sharing network based on rabin file chunking and append only feeds of data verified by merkle trees.
A file sharing network based on rabin file chunking and append only feeds of data verified by merkle trees.
npm install hyperdrive
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.
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')
})
})
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
MIT
FAQs
Hyperdrive is a secure, real-time distributed file system
The npm package hyperdrive receives a total of 979 weekly downloads. As such, hyperdrive popularity was classified as not popular.
We found that hyperdrive demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
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.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.
Security News
Research
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.