js-bigchaindb-driver

mirror of https://github.com/bigchaindb/js-bigchaindb-driver.git synced 2024-11-21 17:26:56 +01:00

Official BigchainDB JavaScript driver for Node.js and the browser

Go to file

michielmulders d284ced256 Tried to change permissions of all files to 664		2017-09-22 10:15:02 +02:00
docs	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
media	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
src	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
test	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
.babelrc	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
.eslintignore	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
.eslintrc.json	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
.gitignore	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
.npmignore	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
.travis.yml	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
API.md	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
CODE_OF_CONDUCT.md	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
CONTRIBUTING.rst	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
LICENSE	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
package.json	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
README.md	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
webpack.config.js	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00
yarn.lock	Tried to change permissions of all files to 664	2017-09-22 10:15:02 +02:00

README.md

Official JavaScript driver for BigchainDB with some naive helpers to get you on your way making transactions in Node.js and the browser.

Compatibility

BigchainDB Server	BigchainDB JavaScript Driver
`0.10`	`0.1.x`
`1.0`	`0.3.x`

Installation and Usage with package managers (npm/yarn)
- Example: Create a transaction
Use a pre-built image (browser only)
Documentation
Authors
License

Installation and Usage with package managers (npm/yarn)

npm install bigchaindb-driver

Example: Create a transaction

const driver = require('bigchaindb-driver')

// BigchainDB server instance or IPDB (e.g. https://test.ipdb.io/api/v1/)
const API_PATH = 'http://localhost:9984/api/v1/'

// Create a new keypair.
const alice = new driver.Ed25519Keypair()

// Construct a transaction payload
const tx = driver.Transaction.makeCreateTransaction(
    // Define the asset to store, in this example it is the current temperature
    // (in Celsius) for the city of Berlin.
    { city: 'Berlin, DE', temperature: 22, datetime: new Date().toString() },

    // Metadata contains information about the transaction itself
    // (can be `null` if not needed)
    { what: 'My first BigchainDB transaction' },

    // A transaction needs an output
    [ driver.Transaction.makeOutput(
            driver.Transaction.makeEd25519Condition(alice.publicKey))
    ],
    alice.publicKey
)

// Sign the transaction with private keys
const txSigned = driver.Transaction.signTransaction(tx, alice.privateKey)

// Send the transaction off to BigchainDB
const conn = new driver.Connection(API_PATH)

conn.postTransaction(txSigned)
    .then(() => conn.pollStatusAndFetchTransaction(txSigned.id))
    .then(retrievedTx => console.log('Transaction', retrievedTx.id, 'successfully posted.'))

Use a pre-built image (browser only)

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="utf-8">
        <title>BigchainDB boilerplate</title>
        <!-- Adjust version to your needs -->
        <script src="https://unpkg.com/bigchaindb-driver@0.3.0/dist/browser/bigchaindb-driver.window.min.js"></script>

        <script>
            // BigchainDB server instance or IPDB (e.g. https://test.ipdb.io/api/v1/)
            const API_PATH = 'http://localhost:9984/api/v1/'

            // Create a new keypair.
            const alice = new BigchainDB.Ed25519Keypair()

            // Construct a transaction payload
            const tx = BigchainDB.Transaction.makeCreateTransaction(
                // Define the asset to store, in this example it is the current temperature
                // (in Celsius) for the city of Berlin.
                { city: 'Berlin, DE', temperature: 22, datetime: new Date().toString() },

                // Metadata contains information about the transaction itself
                // (can be `null` if not needed)
                { what: 'My first BigchainDB transaction' },

                // A transaction needs an output
                [ BigchainDB.Transaction.makeOutput(
                        BigchainDB.Transaction.makeEd25519Condition(alice.publicKey))
                ],
                alice.publicKey
            )

            // Sign the transaction with private keys
            const txSigned = BigchainDB.Transaction.signTransaction(tx, alice.privateKey)

            // Send the transaction off to BigchainDB
            let conn = new BigchainDB.Connection(API_PATH)

            conn.postTransaction(txSigned)
                .then(() => conn.pollStatusAndFetchTransaction(txSigned.id))
                .then(res => {
                    const elem = document.getElementById('lastTransaction')
                    elem.href = API_PATH + 'transactions/' + txSigned.id
                    elem.innerText = txSigned.id
                    console.log('Transaction', txSigned.id, 'accepted')
                })
            // Check console for the transaction's status
        </script>
    </head>
    <body id="home">
        <h1>Hello BigchainDB</h1>
        <p>Your transaction id is: <a id="lastTransaction" target="_blank"><em>processing</em></a></p>
    </body>
</html>

BigchainDB Documentation

Speed Optimizations

This implementation plays "safe" by using JS-native (or downgradable) libraries for its crypto-related functions to keep compatibilities with the browser. If you do want some more speed, feel free to explore the following:

chloride, or its underlying sodium library
node-sha3 -- MAKE SURE to use steakknife's fork if the FIPS 202 upgrade hasn't been merged (otherwise, you'll run into all kinds of hashing problems)

Authors

inspired by js-bigchaindb-quickstart of @sohkhai [thanks]
BigchainDB dev@bigchaindb.com

License

Copyright 2017 BigchainDB GmbH

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.