PredIQt.JS (front-end library)

PredIQt JavaScript/TypeScript Client Library

General purpose library for the PredIQt

Installation

Using yarn:

yarn add @everipedia/prediqt-js

or using npm:

npm install --save @everipedia/prediqt-js

Quick Start

API initialization

Frontend usage

import { Prediqt } from "@everipedia/prediqt-js"

const nodeEndpoint = "https://api.kylin.alohaeos.com"; // you can use any other node endpoint

const client = new Prediqt(
    { createApi: { signatureProvider, nodeEndpoint }}, // create signatureProvider with eosjs or based on it libs
    auth,                                              // (optional) Array with authorization objects, you can set it later with setAuth method
    contracts                                          // (optional) Object that takes prediqt, prediqtMarket, iqToken, prediqtBank contracts' names
);

// or you can pass created api

import { Api, JsonRpc } from "eosjs";

const rpc = new JsonRpc(nodeEndpoint);
const api = new Api({ rpc, signatureProvider });       // create rpc and signatureProvider with eosjs or based on it libs

const client = new Prediqt(
    { customApi: api },
    ...                                                // the same parameters
);

Server usage

... 

// or you can pass created api

const { Prediqt } = require("@everipedia/prediqt-js");
const { Api, JsonRpc } = require("eosjs");
const fetch = require("isomorphic-fetch");

const rpc = new JsonRpc(nodeEndpoint, { fetch });
const api = new Api({ rpc, signatureProvider });       // create rpc and signatureProvider with eosjs or based on it libs

const client = new Prediqt(
    { customApi: api },
    ...                                                // the same parameters
);

Graph API initialization

import { PrediqtGraph } from "@everipedia/prediqt-js";

const apiEndponit = "https://prediqt-api-kylin.azurewebsites.net/graphql"; // endpoint for mainnet - https://prediqt-api-mainnet.azurewebsites.net/graphql 

const graphClient = new PrediqtGraph(apiEndponit);

API

Utils methods

setAuth

Set authorization to execute transactions

Parameters

• auth Array[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)

  • auth[].actor string
  • auth[].permission string

resetAuth

Reset authorization to execute transactions

Methods that require authorization

setFee

Set a fee for the platform (admin only)

Parameters

• fee Object

  • fee.id number
  • fee.fee number

acceptMarket

Accept a proposed market

Parameters

• resolver string
• marketId number

claimShares

Claim shares for a particular market

Parameters

• user string
• marketId number

cancelOrder

Cancel an order

Parameters

• nameId string takes "yes" or "no"
• user string
• marketId number
• id number

createMarket

Create a Market

Parameters

• data Object

  • data.creator string
  • data.resolver string
  • data.ipfs string
  • data.timeIn number
  • data.transferToken string

deleteMarket

Delete an existing Market

Parameters

• marketId number

limitOrder

Open an order for shares in a market

Parameters

• data Object

  • data.nameId string takes "yes" or "no"
  • data.user string
  • data.marketId number
  • data.shares number
  • data.limit string
  • data.transferToken string
  • data.referral string
  • data.buy boolean

marketInvalid

Set a market as invalid (only resolver)

Parameters

• marketId number
• memo string

marketResolve

Set the outcome of a market (only resolver)

Parameters

• data Object

  • data.resolver string
  • data.marketId number
  • data.shareType boolean
  • data.memo string

marketResolveOracle

Set the outcome of a market (only resolver)

Parameters

• data Object

  • data.account string
  • data.marketId number
  • data.vote number

proposeMarket

Propose a market to be part of the active markets

Parameters

• creator string
• resolver string
• ipfs string
• timeIn number
• transferToken string
• transferMemo string

rejectMarket

Reject a proposed market (resolver only)

Parameters

• resolver string
• marketId number

setResolver

Change resolver for a market (admin only)

Parameters

• resolver string
• marketId number

withdraw

Withdraw from user balance

Parameters

• user string
• quantity string

syncBank

Sync Bank

transferShares

Transfer shares to user

Parameters

• data Object

  • data.from string
  • data.to string
  • data.shares number
  • data.shareType boolean
  • data.marketId number

cancelShares

Cancel transferred shares

Parameters

• data Object

  • data.from string
  • data.sharedId string
  • data.marketId number

buyShares

Buy shares

Parameters

• data Object

  • data.from string
  • data.price string
  • data.shares number
  • data.shareType boolean
  • data.marketId number
  • data.transferToken string

sellShares

Sell shares

Parameters

• data Object

  • data.from string
  • data.shares number
  • data.shareType boolean
  • data.marketId number
  • data.price string

proposeMultiSig

Propose MultiSignature

Parameters

• data Object

  • data.proposalName string
  • data.proposer string
  • data.requested Array[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)

Methods that don't require authorization

getFees

Get fees related to the contract

Parameters

• limit number (optional, default 100)
• offset number (optional, default 0)

getShares

Get shares related to a market

Parameters

• marketId number
• limit number (optional, default 100)
• offset number (optional, default 0)

getReferrals

Get referral shares related to a market

Parameters

• marketId number
• limit number (optional, default 100)
• offset number (optional, default 0)

getMarkets

Get markets

Parameters

• tableKey string (optional, default "")
• limit number (optional, default 100)
• offset number (optional, default 0)

getMarket

Get a single market

Parameters

• marketId number

getOrders

Get orders for a market

Parameters

• data Object

  • data.nameId string takes "yes" or "no"
  • data.marketId number
  • data.tableKey string (optional, default "")
  • data.limit number (optional, default 100)
  • data.offset number (optional, default 0)

getBalance

Get balance of an user

Parameters

• username string
• symbol string

getIqBalance

Get IQ balance of an user

Parameters

• username string

getUserResources

Get resources of an user

Parameters

• username string

searchInOracles

Search user in table of oracles

Parameters

• username string

getAccount

Get account data of an user

Parameters

• username string

Graph API

getProposedMarkets

Get proposed markets

Parameters

• skip number
• count number
• creator string (optional, default "")
• filterUrlParam Object?

  • filterUrlParam.paramName string
  • filterUrlParam.paramValue string

getMarkets

Get markets

Parameters

• excludeInvalidIpfs boolean
• skip number
• count number
• isVerified string
• creator string
• filterUrlParam Object?

  • filterUrlParam.paramName string
  • filterUrlParam.paramValue string

getMarket

Get market

Parameters

• marketId number

getMarketPage

Get market page

Parameters

• marketId number
• loggedInUser string?

getPlatformFees

Get platform fees

getCategoriesAndTags

Get categories and tags

getDappInfo

Get information about dapp

getUserProfile

Get user's profile

Parameters

• username string

getShareHolders

Get shareholders

Parameters

• marketId number
• loggedInUser string

getChainInfo

Get info about node's backlog

Embed market

To embed a market in your page, you just need to add code like:

<iframe src="https://prediqt.everipedia.org/embedded?marketId=54" width="100%" height="350" />