Table of Contents

• Library
• Requirements
  • Node
  • Browser Support
• Installation
• Documentation
  • checksumAddress()
  • isAddress()
  • isChecksumAddress()
  • isHex()
  • isPrefixedHex()
  • isUnprefixedHex()
  • prefixHex()
  • unprefixHex()
• Contributors
• License

Library

Bdash is a collection of utility functions missing from lodash (javascript's most loved utility library) for decentralised applications (DApps). Bdash is meant to used alongside libraries like lodash in your apps/libraries.

Requirements

Node

The app requires Node.js and npm (npm comes prebundled with node). The source code is written in ES2015 so Node.js V6+ is recommended. Node.js version can be checked using the node -v cli command.

Browser Support

| Chrome | Safari | IE* / Edge | Firefox | Opera | | ------ | ------ | ---------- | ------- | ----- | | Yes | Yes | 9+ | Yes | Yes |

Installation

This module is distributed via npm which is bundled with node and should be installed as one of your project's dependencies

Using npm

> npm install --save @appliedblockchain/bdash

Using yarn

> yarn add @appliedblockchain/bdash

Documentation

checksumAddress()

Convert a address to a checksum address.

Arguments

| Argument | Type | Default | Optional | |:--------:|----------|---------|----------| | address | string | – | No |

Returns

(string): Retuns checksummed address.

Example

import { checksumAddress } from '@appliedblockchain/bdash'

checksumAddress('0xa15fa373a93f40696b7ec9231411a862529318a7')
// -> 0xa15fa373a93f40696B7eC9231411a862529318A7

isAddress()

Check if given a value is a valid wallet address.

Arguments

| Argument | Type | Default | Optional | |:--------:|--------|---------|----------| | value | * | – | No |

Returns

(boolean): Returns true if value is a valid ethereum address else false.

Example

import { isAddress } from '@appliedblockchain/bdash'

isAddress('0xa15fa373a93f40696b7ec9231411a862529318a7')
// -> true

isAddress('0xa15fa373a93f4069')
// -> false

isChecksumAddress()

Checks if given value is a checksummed ethereum address.

Arguments

| Argument | Type | Default | Optional | |:--------:|--------|---------|----------| | value | * | – | No |

Returns

(boolean): Returns true if value is a valid checksummed ethereum address else false.

Example

import { isAddress } from '@appliedblockchain/bdash'

isChecksumAddress('0xa15fa373a93f40696B7eC9231411a862529318A7')
// -> true

isChecksumAddress('0xa15fa373a93f40696b7ec9231411a862529318a7')
// -> false

isHex()

Checks if given value is a hexidecimal string.

Arguments

| Argument | Type | Default | Optional | |:--------:|--------|---------|----------| | value | * | – | No |

Returns

(boolean): Returns true if value is a hexidecimal string else false.

Example

import { isHex } from '@appliedblockchain/bdash'

isHex('0xa15f')
// -> true

isHex('a15f')
// -> true

isHex('a15')
// -> false

isPrefixedHex()

Checks if given value is a hexidecimal string that is prefixed (0x).

Arguments

| Argument | Type | Default | Optional | |:--------:|--------|---------|----------| | value | * | – | No |

Returns

(boolean): Returns true if value is a prefixed hexidecimal string else false.

Example

import { isPrefixedHex } from '@appliedblockchain/bdash'

isPrefixedHex('0xa15f')
// -> true

isPrefixedHex('a15f')
// -> false

isUnprefixedHex()

Checks if given value is a hexidecimal string that is not prefixed (0x).

Arguments

| Argument | Type | Default | Optional | |:--------:|--------|---------|----------| | value | * | – | No |

Returns

(boolean): Returns true if value is a unprefixed hexidecimal string else false.

Example

import { isUnprefixedHex } from '@appliedblockchain/bdash'

isUnprefixedHex('0xa15f')
// -> false

isUnprefixedHex('a15f')
// -> true

prefixHex()

Prefix a hexidecimal string.

Arguments

| Argument | Type | Default | Optional | |:--------:|----------|---------|----------| | hex | string | – | No |

Returns

(string): Returns prefixed hexidecimal string.

Example

import { prefixHex } from '@appliedblockchain/bdash'

prefixHex('a15f')
// -> 0xa15f

unprefixHex()

Unprefix a hexidecimal string.

Arguments

| Argument | Type | Default | Optional | |:--------:|----------|---------|----------| | hex | string | – | No |

Returns

(string): Returns unprefixed hexidecimal string.

Example

import { unprefixHex } from '@appliedblockchain/bdash'

unprefixHex('0xa15f')
// -> a15f

Contributors

Mirek Rusin

Tahseen Malik

License

MIT