uplo.js
v1.0.2
Published
Node wrapper for uplod of the Uplo network
Downloads
5
Readme
Nodejs Wrapper
A Highly Efficient Decentralized Storage Network
This is a Nodejs wrapper for Uplo. Use it in your apps to easily interact with the Uplo storage network via function calls instead of manual http requests.
Prerequisites
Installation
npm install uplo.js
Example Usage
import { connect } from 'uplo.js'
// Using promises...
// connect to an already running Uplo daemon on localhost:8480 and print its version
connect('localhost:8480')
.then((uplod) => {
uplod.call('/daemon/version').then((version) => console.log(version))
})
.catch((err) => {
console.error(err)
})
// Or ES7 async/await
async function getVersion() {
try {
const uplod = await connect('localhost:8480')
const version = await uplod.call('/daemon/version')
console.log('Uplod has version: ' + version)
} catch (e) {
console.error(e)
}
}
You can also forgo using connect
and use call
directly by providing an API address as the first parameter:
import { call } from 'uplo.js'
async function getVersion(address) {
try {
const version = await call(address, '/daemon/version')
return version
} catch (e) {
console.error('error getting ' + address + ' version: ' + e.toString())
}
}
console.log(getVersion('10.0.0.1:8480'))
uplo.js
can also launch a uplod instance given a path on disk to the uplod
binary. launch
takes an object defining the flags to use as its second argument, and returns the child_process
object. You are responsible for keeping track of the state of this child_process
object, and catching any errors launch
may throw.
import { launch } from 'uplo.js'
try {
// Flags are passed in as an object in the second argument to `launch`.
// if no flags are passed, the default flags will be used.
const uplodProcess = launch('/path/to/your/uplod', {
'modules': 'cghmrtw',
'profile': true,
})
// uplodProcess is a ChildProcess class. See https://nodejs.org/api/child_process.html#child_process_class_childprocess for more information on what you can do with it.
uplodProcess.on('error', (err) => console.log('uplod encountered an error ' + err))
} catch (e) {
console.error('error launching uplod: ' + e.toString())
}
The call object passed as the first argument into call() are funneled directly
into the request
library, so checkout
their options to
see how to access the full functionality of Uplo's
API
Uplod.call({
url: '/consensus/block',
method: 'GET',
qs: {
height: 0
}
})
Should log something like:
null { block:
{ parentid: '0000000000000000000000000000000000000000000000000000000000000000',
nonce: [ 0, 0, 0, 0, 0, 0, 0, 0 ],
timestamp: 1433600000,
minerpayouts: null,
transactions: [ [Object] ] } }