api.client.Network - PolymeshAssociation/polymesh-sdk GitHub Wiki

@polymeshassociation/polymesh-sdk / api/client/Network

api/client/Network

Classes

Network

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

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

Methods

getEventByIndexedArgs()

getEventByIndexedArgs(opts): Promise<EventIdentifier | null>

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

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

Parameters
Parameter Type Description
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): Promise<EventIdentifier[] | null>

Defined in: api/client/Network.ts:360

Retrieve a list of events. Can be filtered using parameters

Parameters
Parameter Type Description
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: 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: api/client/Network.ts:514

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: api/client/Network.ts:503

Retrieve middleware metadata. Returns null if middleware is disabled

Returns

Promise<MiddlewareMetadata | null>

Note

uses the middleware V2

getNetworkProperties()

getNetworkProperties(): Promise<NetworkProperties>

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

Retrieve information for the current network

Returns

Promise<NetworkProperties>

getProtocolFees()

getProtocolFees(args): Promise<ProtocolFees[]>

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

Retrieve the protocol fees associated with running specific transactions

Parameters
Parameter Type Description
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: api/client/Network.ts:74

Retrieve the chain's SS58 format

Returns

BigNumber

getTransactionByHash()

getTransactionByHash(opts): Promise<ExtrinsicDataWithFees | null>

Defined in: api/client/Network.ts:408

Retrieve a transaction by hash

Parameters
Parameter Type Description
opts { txHash: string; } -
opts.txHash string hash of the transaction
Returns

Promise<ExtrinsicDataWithFees | null>

Note

uses the middlewareV2

getTreasuryAccount()

getTreasuryAccount(): Account

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

Get the treasury wallet address

Returns

Account

getTreasuryBalance()
Call Signature

getTreasuryBalance(): Promise<BigNumber>

Defined in: 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): Promise<UnsubCallback>

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

Get the Treasury POLYX balance (with subscription support)

Parameters
Parameter Type Description
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: api/client/Network.ts:67

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

Returns

Promise<string>

submitTransaction()

submitTransaction(txPayload, signature): Promise<SubmissionDetails>

Defined in: api/client/Network.ts:212

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

Parameters
Parameter Type
txPayload TransactionPayloadInput
signature string
Returns

Promise<SubmissionDetails>

Throws

if the signature is not hex encoded

supportsConfidentialAssets()

supportsConfidentialAssets(): boolean

Defined in: api/client/Network.ts:531

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

Returns

boolean

supportsSubscription()

supportsSubscription(): boolean

Defined in: api/client/Network.ts:547

Returns if functions can be subscribed.

Returns

boolean

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

transferPolyx()

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

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

Transfer an amount of POLYX to a specified Account

Parameters
Parameter Type
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

⚠️ **GitHub.com Fallback** ⚠️