Skip to content
Switch branches/tags
This branch is 2 commits ahead, 2 commits behind RangerMauve:master.
Fetch upstream

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
Oct 3, 2015


Validate Gun data with JSON-Schema.

Validation is done by is-my-json-valid

Getting started


Download the js bundle from the releases page and add it to the page. As well as attaching the required methods to Gun, it will create a GunSchema global.


Install from NPM

npm install --save gun-schema

Require the module to have it attach itself to GUN

var Gun = require("gun");


// Get a reference to your schema from wherever
// This one was taken from the is-my-json-valid page
var schema = {
    required: true,
    type: 'object',
    properties: {
        hello: {
            required: true,
            type: 'string'

var gun = Gun();

gun.schema("example", schema);

// This is valid so it'll get put into the graph"example", {
    hello: "World!"

// This will throw an error because `hello` was set as `required`"example", {
    goodbye: "World!"


After the plugin has been properly initialized, it adds the following methods on gun instances

gun.schema(name, schema, options)

Adds a new type that will be recognized by

  • name : The unique name for this type of node
  • schema : The JSON Schema definition to use for validating this type
  • options : Optional argument which gets passed down to is-my-json-valid

gun.schemas(map, options)

Adds a bunch of schemas in one go.

  • map : A map of name-schema pairs that get passed on to gun.schema()
  • options : Optional argument which gets passed down to gun.schema() to configure is-my-json-valid, value)

Similar to gun.put(), but uses the schema associated with name to ensure that value is valid.

  • name : The name of the schema that value should match
  • value : The value that should be validated before being put() into the DB.

If name does not point to a schema name that has been registered, then an error will be thrown. If value doesn't validate against the schema, then an error will be thrown with a errors property which contains the list of things that are wrong with value.


This is what gets exported by the module in CommonJS and what is added as the GunSchema global in the bundle. It takes a gun instance and adds schema functionality to it.

  • gun The gun instance to attach to. Not, this isn't the Gun constructor, but an actual instance or Gun.chain.


You can build the browser bundle yourself by cloning the repo and executing:

`npm install`
`npm install gun`
`npm run bundle`

You will then have a file called bundle.js which you can embed in a webpage. The building is facilitated by Browserify


Validate GUN DB data with JSON-Schema




No packages published