// Copyright 2017-2021 @polkadot/api-derive authors & contributors // SPDX-License-Identifier: Apache-2.0 import type { ApiInterfaceRx } from '@polkadot/api/types'; import type { Observable } from '@polkadot/x-rxjs'; import type { HeaderExtended } from '../type/types'; import { combineLatest, of } from '@polkadot/x-rxjs'; import { map } from '@polkadot/x-rxjs/operators'; import { createHeaderExtended } from '../type'; import { memo } from '../util'; /** * @name subscribeNewHeads * @returns A header with the current header (including extracted author) * @description An observable of the current block header and it's author * @example *
* * ```javascript * api.derive.chain.subscribeNewHeads((header) => { * console.log(`block #${header.number} was authored by ${header.author}`); * }); * ``` */ export function subscribeNewHeads (instanceId: string, api: ApiInterfaceRx): () => Observable { return memo(instanceId, (): Observable => combineLatest([ api.rpc.chain.subscribeNewHeads(), api.query.session ? api.query.session.validators() : of(undefined) ]).pipe( map(([header, validators]): HeaderExtended => { header.createdAtHash = header.hash; return createHeaderExtended(header.registry, header, validators); }) ) ); }