dapp-client

DAPP JavaScript/TypeScript Client Library

Installation

Using Yarn:

yarn add dapp-client

or using NPM:

npm install --save dapp-client

Quick Start

CommonJS

const { DappClient } = require("dapp-client")
const fetch = require("isomorphic-fetch")

const endpoint = "https://dsp.eosn.io"
const client = new DappClient(endpoint, { fetch })

TypeScript

import { DappClient } from "dapp-client"
import fetch from "isomorphic-fetch"

const endpoint = "https://dsp.eosn.io"
const client = new DappClient(endpoint, { fetch })

Supported Endpoints

# Chain
/v1/chain/get_currency_stats
/v1/chain/get_info
/v1/chain/get_table_by_scope
/v1/chain/get_table_rows

API

Table of Contents

• DAPP
  • Examples
• DappClient
  • Parameters
  • Examples
  • get_table_package
    • Parameters
    • Examples
  • get_table_accountext
    • Parameters
    • Examples
  • get_table_rows
    • Parameters
    • Examples
  • get_table_by_scope
    • Parameters
    • Examples
  • get_currency_balance
    • Parameters
    • Examples
  • get_currency_stats
    • Parameters
    • Examples
  • get_info
    • Examples
• claimrewards
  • Parameters
  • Examples
• closeprv
  • Parameters
  • Examples
• modifypkg
  • Parameters
• refund
  • Parameters
  • Examples
• regpkg
  • Parameters
• selectpkg
  • Parameters
• stake
  • Parameters
• transfer
  • Parameters
• unstake
  • Parameters

DAPP

DAPP

Examples

import { names } from "dapp-client"

names.DAPP // => "......2ke1.o4"

DappClient

DAPP Client

Parameters

• endpoint string dsp endpoint
• options object optional params (optional, default {})
  • options.dappservices string dappservices code (optional, default "dappservices")
  • options.ipfsservice1 string ipfsservice1 code (optional, default "ipfsservice1")
  • options.fetch Fetch fetch (optional, default global.fetch)

Examples

const endpoint = "https://dsp.eosn.io"
const client = new DappClient(endpoint, { fetch })

get_table_package

Get TABLE package

Parameters

• options object optional params (optional, default {})
  • options.lower_bound string? Filters results to return the first element that is not less than provided value in set
  • options.upper_bound string? Filters results to return the first element that is greater than provided value in set
  • options.limit number Limit the result amount (optional, default 10)
  • options.show_payer boolean Show Payer (optional, default false)

Examples

const response = await client.get_table_package({limit: 500});

for (const row of response.rows) {
    console.log(row);
    // {
    //     id: 9,
    //     api_endpoint: 'https://dsp.eosn.io',
    //     package_json_uri: 'https://eosnation.io/package1.dsp-package.json',
    //     package_id: 'package1',
    //     service: 'ipfsservice1',
    //     provider: 'eosnationdsp',
    //     quota: '500.0000 QUOTA',
    //     package_period: 86400,
    //     min_stake_quantity: '10000.0000 DAPP',
    //     min_unstake_period: 3600,
    //     enabled: 1
    // }
}

get_table_accountext

Get TABLE accountext

Parameters

• options object optional params (optional, default {})
  • options.lower_bound string? Filters results to return the first element that is not less than provided value in set
  • options.upper_bound string? Filters results to return the first element that is greater than provided value in set
  • options.limit number Limit the result amount (optional, default 10)
  • options.show_payer boolean Show Payer (optional, default false)

Examples

const response = await client.get_table_accountext({limit: 500});

for (const row of response.rows) {
    console.log(row);
    // {
    //     id: 29,
    //     account: 'eosnationdsp',
    //     service: 'ipfsservice1',
    //     provider: 'eosnationdsp',
    //     quota: '0.0001 QUOTA',
    //     balance: '255101.1461 DAPP',
    //     last_usage: '1555466031000',
    //     last_reward: '1555466031000',
    //     package: 'package2',
    //     pending_package: 'package2',
    //     package_started: '1555466031000',
    //     package_end: '1555469631000'
    // }
}

get_table_rows

GET /v1/chain/get_table_rows

Returns an object containing rows from the specified table.

Parameters

• code string The name of the smart contract that controls the provided table
• scope string The account to which this data belongs
• table string The name of the table to query
• options object optional params (optional, default {})
  • options.lower_bound string? Filters results to return the first element that is not less than provided value in set
  • options.upper_bound string? Filters results to return the first element that is greater than provided value in set
  • options.limit number Limit the result amount (optional, default 10)
  • options.show_payer boolean Show Payer (optional, default false)
  • options.json boolean JSON response (optional, default true)
  • options.index_position number Position of the index used (optional, default 1)
  • options.key_type string? Type of key specified by index_position (for example - uint64_t or name)
  • options.table_key string? Table Key
  • options.encode_type string? Encode type

Examples

const response = await rpc.get_table_rows("<code>", "<scope>", "<table>");
console.log(response);

Returns Promise<GetTableRows> table rows

get_table_by_scope

GET /v1/chain/get_table_by_scope

Returns an object containing rows from the specified table.

Parameters

• code string name of the contract to return table data for
• options object optional params (optional, default {})
  • options.table string? Filter results by table
  • options.lower_bound string? Filters results to return the first element that is not less than provided value in set
  • options.upper_bound string? Filters results to return the first element that is greater than provided value in set
  • options.limit number? Limit number of results returned.
  • options.reverse boolean Reverse the order of returned results (optional, default false)

Examples

const response = await rpc.get_table_by_scope();
console.log(response);

Returns Promise<GetTableByScope> table rows

get_currency_balance

GET /v1/chain/get_currency_balance

Retrieve the stats of for a given currency

Parameters

• code string The contract that operates the currency
• account string The account to query balances for
• symbol string The symbol for the currency if the contract operates multiple currencies

Examples

const response = await rpc.get_currency_balance("eosio.token", "eosio.null", "EOS");
console.log(response);

Returns Promise<GetCurrencyBalance> table rows

get_currency_stats

GET /v1/chain/get_currency_stats

Retrieve the stats of for a given currency

Parameters

• code string The contract that operates the currency
• symbol string The symbol for the currency if the contract operates multiple currencies

Examples

const response = await rpc.get_currency_stats("eosio.token", "EOS");
console.log(response);

Returns Promise<GetCurrencyStats> table rows

get_info

GET /v1/chain/get_info

Returns an object containing various details about the blockchain.

Examples

const response = await rpc.get_info();
console.log(response);

Returns Promise<GetInfo> table rows

claimrewards

ACTION

dappservices::claimrewards

Parameters

• provider string name

Examples

claimrewards("<DSP Provider>");

closeprv

ACTION

dappservices::closeprv

Parameters

• owner string name
• service string name
• provider string name

Examples

closeprv("<Account>", "ipfsservice1", "<DSP Provider>")

modifypkg

ACTION

dappservices::modifypkg

Parameters

• provider string name
• package_id string name
• service string name
• api_endpoint string std::string
• package_json_uri string std::string

refund

ACTION

dappservices::refund

Parameters

• to string name
• provider string name
• service string name
• symcode string symbol_code

Examples

refund("<Account>", "<DSP Provider>", "ipfsserver1", "DAPP")

regpkg

ACTION

dappservices::regpkg

Parameters

• newpackage string package

selectpkg

ACTION

dappservices::selectpkg

Parameters

• owner string name
• provider string name
• service string name
• pkg string name

stake

ACTION

dappservices::stake

Parameters

• from string name
• provider string name
• service string name
• quantity string asset

transfer

ACTION

dappservices::transfer

Parameters

• from string name
• to string name
• quantity string asset
• memo string string

unstake

ACTION

dappservices::unstake

Parameters

• to string name
• provider string name
• service string name
• quantity string asset