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" />

​