Skip to content

API Documentation

ConnectionManager

connect()

public connect(host: string, name = "main")

Connect to the given connection.

Parameters

Type Name Required Description
string host Yes Node URL
string name No Network name

Return value

Connection

disconnect()

public disconnect(name?: string)

Disconnect from the given connection.

Parameters

Type Name Required Description
string name No Network Name

Return value

void

connection()

public connection(name?: string)

Get a connection instance.

Parameters

Type Name Required Description
string name No Network Name

Return value

Connection

getDefaultConnection()

public getDefaultConnection()

Get the default connection name.

Return value

string

setDefaultConnection()

public setDefaultConnection(name: string)

Set the default connection name.

Parameters

Type Name Required Description
string name No Network Name

Return value

void

getConnections()

public getConnections()

Return all of the created connections.

Return value

Record<string, Connection>

Connection

constructor()

public constructor(private readonly host: string)

Create a new Connection class instance.

Parameters

Type Name Required Description
string host Yes Node URL

api()

public api<T = any>(name: string)

Instantiate new Api.

Parameters

Type Name Required Description
string name Yes Network name

Return value

T

Type Name Required Description
string host Yes Node URL

withOptions()

public withOptions(opts: Record<string, any>)

Apply options to future connection requests.

Parameters

Type Name Required Description
string opts Yes Connection options

Return value

this

get()

public async get<T = any>(url: string, opts?: Record<string, any>)

Send a GET request with query parameters.

Parameters

Type Name Required Description
string url Yes Endpoint
Record opts? No Query parameters

Return value

Promise<IResponse<T>>

post()

public async post<T = any>(url: string, opts?: Record<string, any>): Promise<IResponse<T>>

Send a POST request with JSON-encoded parameters.

Parameters

Type Name Required Description
string url Yes Endpoint
Record opts? No Query parameters

Return value

Promise<IResponse<T>>

RequestError

constructor()

public constructor(error)

Create a new RequestError class instance.

Parameters

Type Name Required Description
string error Yes Error

Resources\Blockchain

blockchain()

public async blockchain<T = any>(query?: Record<string, any>)

Get all blockchains.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

public async search<T = any>(payload?: Record<string, any>)

Filter all blockchains by the given parameters.

Parameters

Type Name Required Description
Record payload No Search parameters

Return value

Promise<IResponse<T>>

Resources\Blocks

all()

public async all<T = any>(query?: Record<string, any>)

Get all blocks.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

first()

public async first<T = any>(query?: Record<string, any>)

Get the first block.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

last()

public async last<T = any>(query?: Record<string, any>)

Get the last (most recent) block.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

get()

public async get<T = any>(id: string)

Get a block by the given id.

Parameters

Type Name Required Description
string id Yes Block ID

Return value

Promise<IResponse<T>>

transactions()

public async transactions<T = any>(id: string, query?: Record<string, any>)

Get all transactions by the given block.

Parameters

Type Name Required Description
string id Yes Block ID
Record query No Query parameters

Return value

Promise<IResponse<T>>

missed()

public async missed<T = any>(payload?: Record<string, any>)

Shows all the missed blocks by all delegates in the last 30 days

Parameters

Type Name Required Description
Record payload No Search parameters

Return value

Promise<IResponse<T>>

Resources\Locks

all()

public async all<T = any>(query?: Record<string, any>)

Get all locks.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

get()

public async get<T = any>(id: string)

Get a lock by the given id.

Parameters

Type Name Required Description
string id Yes Bridgechain identifier

Return value

Promise<IResponse<T>>

unlocked()

public async unlocked<T = any>(payload?: Record<string, any>)

Search for unlocked locks.

Parameters

Type Name Required Description
Record payload No Search parameters

Return value

Promise<IResponse<T>>

Resources\Delegates

all()

public async all<T = any>(query?: Record<string, any>)

Get all accounts.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

get()

public async get<T = any>(id: string)

Get a delegate by the given id.

Parameters

Type Name Required Description
string id Yes Delegate identifier

Return value

Promise<IResponse<T>>

blocks()

public async blocks<T = any>(id: string, query?: Record<string, any>)

Get all blocks for the given delegate.

Parameters

Type Name Required Description
string id Yes Delegate identifier
Record query No Query parameters

Return value

Promise<IResponse<T>>

missed()

public async missed<T = any>(id: string, query?: Record<string, any>)

List Recent Missed Blocks of a Delegate

Parameters

Type Name Required Description
string id Yes Delegate identifier
Record query No Query parameters

Return value

Promise<IResponse<T>>

voters()

public async voters<T = any>(id: string, query?: Record<string, any>)

Get all voters for the given delegate.

Parameters

Type Name Required Description
string id Yes Delegate identifier
Record query No Query parameters

Return value

Promise<IResponse<T>>

Resources\Node

configuration()

public async configuration<T = any>()

Get the node configuration.

Return value

Promise<IResponse<T>>

status()

public async status<T = any>()

Get the node status.

Return value

Promise<IResponse<T>>

syncing()

public async syncing<T = any>()

Get the node syncing status.

Return value

Promise<IResponse<T>>

crypto()

public async crypto<T = any>()

Get the node crypto configuration.

Return value

Promise<IResponse<T>>

fees()

public async fees<T = any>(days: number)

Get the node fee statistics.

Parameters

Type Name Required Description
number days Yes Days

Return value

Promise<IResponse<T>>

Resources\Peers

all()

public async all<T = any>(query?: Record<string, any>)

Get all peers.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

get()

public async get<T = any>(ip: string)

Get a peer by the given IP address.

Parameters

Type Name Required Description
string ip Yes IP address

Return value

Promise<IResponse<T>>

Resources\Rounds

delegates()

public async delegates<T = any>(id: number)

Get delegates for a round.

Parameters

Type Name Required Description
number id yes Round number

Return value

Promise<IResponse<T>>

Resources\Transactions

create()

public async create<T = any>(payload: object[])

Create a new transaction.

Parameters

Type Name Required Description
object[] payload Yes Transaction(s) to broadcast

Return value

Promise<IResponse<T>>

get()

public async get<T = any>(id: string)

Get a transaction by the given id.

Parameters

Type Name Required Description
string id Yes Transaction ID

Return value

Promise<IResponse<T>>

all()

public async all<T = any>(query?: Record<string, any>)

Get all transactions.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

allUnconfirmed()

public async allUnconfirmed<T = any>(query?: Record<string, any>)

Get all unconfirmed transactions.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

getUnconfirmed()

public async getUnconfirmed<T = any>(id: string)

Get an unconfirmed transaction by the given id.

Parameters

Type Name Required Description
string id Yes Transaction ID

Return value

Promise<IResponse<T>>

schemas()

public async search<T = any>(payload: Record<string, any>)

Get a list of transaction schemas.

Parameters

Type Name Required Description
Record payload Yes Search parameters

Return value

Promise<IResponse<T>>

types()

public async types<T = any>()

Get a list of valid transaction types.

Return value

Promise<IResponse<T>>

fees()

public async fees<T = any>(): Promise<IResponse<T>>

Get the node fee statistics.

Return value

Promise<IResponse<T>>

Resources\Votes

all()

public async all<T = any>(query?: Record<string, any>)

Get all votes.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

get()

public async get<T = any>(id: string)

Get a vote by the given id.

Parameters

Type Name Required Description
string id Yes Vote ID

Return value

Promise<IResponse<T>>

Resources\Wallets

all()

public async all<T = any>(query?: Record<string, any>)

Get all wallets.

Parameters

Type Name Required Description
Record query No Query parameters

Return value

Promise<IResponse<T>>

get()

public async get<T = any>(id: string)

Get a wallet by the given id.

Parameters

Type Name Required Description
string id Yes Wallet identifier

Return value

Promise<IResponse<T>>

locks()

public async locks<T = any>(id: string, query?: Record<string, any>)

Get a wallet by the given id.

Parameters

Type Name Required Description
string id Yes Wallet identifier
Record query No Search parameters

Return value

Promise<IResponse<T>>

transactions()

public async transactions<T = any>(id: string, query?: Record<string, any>)

Get all transactions for the given wallet.

Parameters

Type Name Required Description
string id Yes Wallet identifier
Record query Yes Query parameters

Return value

Promise<IResponse<T>>

transactionsReceived()

public async transactionsReceived<T = any>(id: string, query?: Record<string, any>)

Get all transactions received by the given wallet.

Parameters

Type Name Required Description
string id Yes Wallet identifier
Record query Yes Query parameters

Return value

Promise<IResponse<T>>

transactionsSent()

public async transactionsSent<T = any>(id: string, query?: Record<string, any>)

Get all transactions sent by the given wallet.

Parameters

Type Name Required Description
string id Yes Wallet identifier
Record query Yes Query parameters

Return value

Promise<IResponse<T>>

votes()

public async votes<T = any>(id: string)

Get all votes by the given wallet.

Parameters

Type Name Required Description
string id Yes Wallet identifier

Return value

Promise<IResponse<T>>

top()

public async top<T = any>(query?: Record<string, any>)

Get all wallets sorted by balance in descending order.

Parameters

Type Name Required Description
Record query Yes Query parameters

Return value

Promise<IResponse<T>>