web3-validator
TypeScript icon, indicating that this package has built-in type declarations

2.0.6 • Public • Published

web3.js

web3-validator

ES VersionNode VersionNPM PackageDownloads

This is a sub-package of web3.js.

web3-validator contains functions for validating objects.

Installation

You can install the package either using NPM or using Yarn

Using NPM

npm install web3-validator

Using Yarn

yarn add web3-validator

Getting Started

Usage

You can use the validator by importing as and using to validate;

import { validator } from 'web3-validator';

// To validate and throw
validator.validate(['uint8', 'string'], [val1, val2]);

// To validate and return error
const errors = validator.validate(['uint8', 'string'], [val1, val2], { silent: true });

To see more examples of schema you can use to validate check following file.

Following eth types are supported to validate.

TypeInput AsDescription
uintnumber, string, HexStringUnsigned integer, all ethereum compatible variants are also supported e.g. uint8, uint256. You can also use array specifiers as uint[] or uint[2]
intnumber, string, HexStringSigned integer, all ethereum compatible variants are also supported e.g. int8, int256. You can also use array specifiers as int[] or int[2]
bytesHexString, Uint8ArrayRaw bytes. You can also use fixed length bytes as bytes[2]

| string | string | String values | | address | string, HexString | Ethereum network compatible address | | bloom | string, HexString | Check if a given string is a Eth bloom | | tuple | array | You can specify any tuple as nested arrays. e.g. ['uint', 'string']. For a custom tuple or array tuple you can use syntax e.g. ['tuple[3]', ['uint', 'string']] |

For the ethereum compatible data values should be passed as arrays e.g. for schema ['uint', 'string'] value should be passed as [2, 'my-string'].

You can also pass full ABI schema for the validation. e.g.

[{ "name": "owner", "type": "address" }]

The implementation of the validator is extension of JSON-Schema-Draft07 with a custom keyword eth. So you can use JSON-Schema compatible schema to validate any object based data as well.

Prerequisites

Package.json Scripts

ScriptDescription
cleanUses rimraf to remove dist/
buildUses tsc to build package and dependent packages
lintUses eslint to lint package
lint:fixUses eslint to check and fix any warnings
formatUses prettier to format the code
testUses jest to run unit tests
test:integrationUses jest to run tests under /test/integration
test:unitUses jest to run tests under /test/unit

Readme

Keywords

none

Package Sidebar

Install

npm i web3-validator

Weekly Downloads

188,042

Version

2.0.6

License

LGPL-3.0

Unpacked Size

957 kB

Total Files

184

Last publish

Collaborators

  • mpetrunic
  • gregthegreek
  • alexey_krasnoperov
  • jdevcs