Skip to main content
Version: 30.0.x

Class: Network

Defined in: src/api/client/Network.ts:42

Handles all Network related functionality, including querying for historical events from middleware

Methods

getEventByIndexedArgs()

getEventByIndexedArgs(opts: object): Promise<EventIdentifier | null>

Defined in: src/api/client/Network.ts:174

Retrieve a single event by any of its indexed arguments. Can be filtered using parameters

Parameters

ParameterTypeDescription

opts

{ eventArg0?: string; eventArg1?: string; eventArg2?: string; eventId: EventIdEnum; moduleId: ModuleIdEnum; }

opts.eventArg0?

string

event parameter value to filter by in position 0

opts.eventArg1?

string

event parameter value to filter by in position 1

opts.eventArg2?

string

event parameter value to filter by in position 2

opts.eventId

EventIdEnum

type of the event to fetch

opts.moduleId

ModuleIdEnum

type of the module to fetch

Returns

Promise<EventIdentifier | null>

Note

uses the middlewareV2


getEventsByIndexedArgs()

getEventsByIndexedArgs(opts: object): Promise<EventIdentifier[] | null>

Defined in: src/api/client/Network.ts:361

Retrieve a list of events. Can be filtered using parameters

Parameters

ParameterTypeDescription

opts

{ eventArg0?: string; eventArg1?: string; eventArg2?: string; eventId: EventIdEnum; moduleId: ModuleIdEnum; size?: BigNumber; start?: BigNumber; }

opts.eventArg0?

string

event parameter value to filter by in position 0

opts.eventArg1?

string

event parameter value to filter by in position 1

opts.eventArg2?

string

event parameter value to filter by in position 2

opts.eventId

EventIdEnum

type of the event to fetch

opts.moduleId

ModuleIdEnum

type of the module to fetch

opts.size?

BigNumber

page size

opts.start?

BigNumber

page offset

Returns

Promise<EventIdentifier[] | null>

Deprecated

Note

uses the middlewareV2


getLatestBlock()

getLatestBlock(): Promise<BigNumber>

Defined in: src/api/client/Network.ts:60

Retrieve the number of the latest finalized block in the chain

Returns

Promise<BigNumber>


getMiddlewareLag()

getMiddlewareLag(): Promise<BigNumber>

Defined in: src/api/client/Network.ts:516

Get the number of blocks the middleware needs to process to be synced with chain. The lag can be around somewhere upto 15 blocks, but this can increase if the block size being processed by the Middleware is too large. If the lag is too large, its recommended to check the indexer health to make sure the Middleware is processing the blocks.

Returns

Promise<BigNumber>

Note

uses the middleware V2


getMiddlewareMetadata()

getMiddlewareMetadata(): Promise<MiddlewareMetadata | null>

Defined in: src/api/client/Network.ts:505

Retrieve middleware metadata. Returns null if middleware is disabled

Returns

Promise<MiddlewareMetadata | null>

Note

uses the middleware V2


getNetworkProperties()

getNetworkProperties(): Promise<NetworkProperties>

Defined in: src/api/client/Network.ts:81

Retrieve information for the current network

Returns

Promise<NetworkProperties>


getProtocolFees()

getProtocolFees(args: object): Promise<ProtocolFees[]>

Defined in: src/api/client/Network.ts:107

Retrieve the protocol fees associated with running specific transactions

Parameters

ParameterTypeDescription

args

{ tags: TxTag[]; }

args.tags

TxTag[]

list of transaction tags (e.g. [TxTags.asset.CreateAsset, TxTags.asset.RegisterUniqueTicker] or ["asset.createAsset", "asset.registerTicker"])

Returns

Promise<ProtocolFees[]>


getSs58Format()

getSs58Format(): BigNumber

Defined in: src/api/client/Network.ts:74

Retrieve the chain's SS58 format

Returns

BigNumber


getTransactionByHash()

getTransactionByHash(opts: object): Promise<ExtrinsicDataWithFees | null>

Defined in: src/api/client/Network.ts:410

Retrieve a transaction by hash

Parameters

ParameterTypeDescription

opts

{ txHash: string; }

opts.txHash

string

hash of the transaction

Returns

Promise<ExtrinsicDataWithFees | null>

Note

uses the middlewareV2


getTreasuryAccount()

getTreasuryAccount(): Account

Defined in: src/api/client/Network.ts:114

Get the treasury wallet address

Returns

Account


getTreasuryBalance()

Call Signature

getTreasuryBalance(): Promise<BigNumber>

Defined in: src/api/client/Network.ts:127

Get the Treasury POLYX balance

Returns

Promise<BigNumber>

Promise that resolves to the current Treasury balance

Call Signature

getTreasuryBalance(callback: SubCallback<BigNumber>): Promise<UnsubCallback>

Defined in: src/api/client/Network.ts:138

Get the Treasury POLYX balance (with subscription support)

Parameters
ParameterTypeDescription

callback

SubCallback<BigNumber>

Callback function that receives balance updates

Returns

Promise<UnsubCallback>

Promise that resolves to an unsubscribe function

Note

can be subscribed to, if connected to node using a web socket


getVersion()

getVersion(): Promise<string>

Defined in: src/api/client/Network.ts:67

Fetch the current network version (e.g. 3.1.0)

Returns

Promise<string>


submitTransaction()

submitTransaction(txPayload: TransactionPayloadInput, signature: string): Promise<SubmissionDetails>

Defined in: src/api/client/Network.ts:213

Submits a transaction payload with its signature to the chain. signature should be hex encoded

Parameters

ParameterType

txPayload

TransactionPayloadInput

signature

string

Returns

Promise<SubmissionDetails>

Throws

if the signature is not hex encoded


supportsConfidentialAssets()

supportsConfidentialAssets(): boolean

Defined in: src/api/client/Network.ts:533

Returns whether or not the connected chain node as support for confidential assets

Returns

boolean


supportsSubscription()

supportsSubscription(): boolean

Defined in: src/api/client/Network.ts:549

Returns if functions can be subscribed.

Returns

boolean

true if connected over ws(s)://, otherwise false


transferPolyx()

transferPolyx(args: TransferPolyxParams, opts?: ProcedureOpts): Promise<GenericPolymeshTransaction<void, void>>

Defined in: src/api/client/Network.ts:161

Transfer an amount of POLYX to a specified Account

Parameters

ParameterType

args

TransferPolyxParams

opts?

ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>

Note

this method is of type ProcedureMethod, which means you can call transferPolyx.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it