dcorejs-lib

    1.6.2 • Public • Published

    dcorejs-lib

    This library is combined forks of graphenejs-lib and graphenejs-ws.

    The library was created as a combination of forks of graphenejs-lib and graphenejs-ws with necessary corrections. Can be used to construct, sign and broadcast transactions in JavaScript, and to easily obtain data from the blockchain via public APIs.

    npm version npm downloads

    Setup

    To obtain the library use npm:

    npm install dcorejs-lib
    

    Usage

    The following examples will provide you basics of dcorejs-lib library usage, like is manipulation and doing fetches of DCore blockchain objects.

    Initialization

    Moreover, it includes connection to DCore daemon APIs.

        var {Apis, ChainConfig} = require('dcorejs-lib');
        var dcoreWsAddress = 'wss://dcore.address.com';
        
        ChainConfig.networks.decent = {
            chainId: 'your_dcore_chain_id'
        };
        
        Apis.instance(dcoreWsAddress, true).init_promise
            .then(result => {
                // now connected to DCore daemon, can run some commands
            })
            .catch(err => {
                // error connecting to DCore daemon ws interface
            });

    Chain

    The module provides utility methods which handles DCore blockchain objects.

        var {Apis, ChainStore, FetchChain} = require('dcorejs-lib');
        
        Apis.instance().init_promise
            .then(res => {
                ChainStore.init()
                    .then(() => {
                        FetchChain('getAccount', '1.2.30')
                            .then(res => {
                                // object successfully fetched, process DCore network object
                            })
                            .catch(err => {
                                // error fetching object from DCore blockchain
                            });
                    })
                    .catch(err => {
                        // error initializing chain store
                    });
            })
            .catch(err => {
                // error connecting to DCore daemon ws interface
            });

    Private keys

    Generate a new private key from a seed (e.g. a brainkey).

        var {PrivateKey, key} = require("dcorejs-lib");
        
        let seed = "THIS IS A TERRIBLE BRAINKEY SEED WORD SEQUENCE";
        let pkey = PrivateKey.fromSeed( key.normalize_brainKey(seed) );
        
        console.log("\nPrivate key:", pkey.toWif());
        console.log("Public key :", pkey.toPublicKey().toString(), "\n");

    Transactions

    Following example show the way of broadcasting transfer operation transaction into DCore network.

        var {Apis, TransactionHelper, ChainStore, FetchChain, Aes, TransactionBuilder} = require('dcorejs-lib');
     
        var amount = 0.11;
        var fromAccountId = 'sender_account_name';
        var toAccountId = 'receiver_account_name';
        var memoMessage = 'some memo for receiver';
        
        Apis.instance().init_promise
            .then(res => {
                ChainStore.init()
                    .then(() => {
                       Promise.all([
                           FetchChain('getAccount', fromAccountId),
                           FetchChain('getAccount', toAccountId),
                           FetchChain('getAsset', 'DCT'),
                       ])
                       .then(result => {
                           var [fromAccount, toAccount, amountAsset] = result;
                           
                           var privateKey = fromAccount.get('owner').get('key_auths').get(0).get(0);
                           var senderMemoKey = fromAccount.get('options').get('memo_key');
                           var receiverMemoKey = toAccount.get('options').get('memo_key');
                           var nonce = TransactionHelper.unique_nonce_uint64();
                           
                           var memo = {
                               from: senderMemoKey,
                               to: receiverMemoKey,
                               nonce: nonce,
                               message: Aes.encrypt_with_checksum(privateKey, receiverMemoKey, nonce, memoMessage),
                           };
                           
                           var tb = new TransactionBuilder();
                           tb.add_type_operation('transfer', {
                               fee: {
                                   amount: 0,
                                   asset_id: amountAsset.get('id')
                               },
                               from: fromAccount.get('id'),
                               to: toAccount.get('id'),
                               amount: {
                                   amount: amount, 
                                   asset_id: amountAsset.get('id')
                               },
                               memo: memo
                           });
                           tb.set_required_fees()
                            .then(() => {
                                tr.add_signer(privateKey, privateKey.toPublicKey().toPublicKeyString());
                                tr.broadcast()
                                    .then(() => {
                                        // transaction successfully broadcasted to DCore network
                                    })
                                    .catch(err => {
                                        // error broadcasting transaction
                                    });
                            })
                            .catch(err => {
                                // error setting transaction fees
                            });
                       });
                    });
            })
            .catch(err => {
                // error connecting to DCore daemon ws interface
            });

    Keywords

    none

    Install

    npm i dcorejs-lib

    DownloadsWeekly Downloads

    2

    Version

    1.6.2

    License

    MIT

    Unpacked Size

    1.39 MB

    Total Files

    49

    Last publish

    Collaborators

    • peter.vanderka
    • peter.student