polkadot-js/apps

View on GitHub
packages/page-democracy/src/Overview/Fasttrack.tsx

Summary

Maintainability
A
1 hr
Test Coverage
// Copyright 2017-2024 @polkadot/app-democracy authors & contributors
// SPDX-License-Identifier: Apache-2.0

import type { SubmittableExtrinsic } from '@polkadot/api/types';
import type { Hash, VoteThreshold } from '@polkadot/types/interfaces';
import type { HexString } from '@polkadot/util/types';

import React, { useEffect, useMemo, useState } from 'react';

import { getFastTrackThreshold } from '@polkadot/apps-config';
import { Button, Input, InputAddress, InputNumber, Modal, Toggle, TxButton } from '@polkadot/react-components';
import { useApi, useCall, useCollectiveInstance, useToggle } from '@polkadot/react-hooks';
import { BN, isString } from '@polkadot/util';

import { useTranslation } from '../translate.js';

interface Props {
  imageHash: Hash | HexString;
  members: string[];
  threshold: VoteThreshold;
}

interface ProposalState {
  proposal?: SubmittableExtrinsic<'promise'> | null;
  proposalLength: number;
}

// default, assuming 6s blocks
const ONE_HOUR = (60 * 60) / 6;
const DEF_DELAY = new BN(ONE_HOUR);
const DEF_VOTING = new BN(3 * ONE_HOUR);

function Fasttrack ({ imageHash, members, threshold }: Props): React.ReactElement<Props> | null {
  const { t } = useTranslation();
  const { api } = useApi();
  const [isFasttrackOpen, toggleFasttrack] = useToggle();
  const [accountId, setAcountId] = useState<string | null>(null);
  const [delayBlocks, setDelayBlocks] = useState<BN | undefined>(DEF_DELAY);
  const [votingBlocks, setVotingBlocks] = useState<BN | undefined>(api.consts.democracy.fastTrackVotingPeriod || DEF_VOTING);
  const [{ proposal, proposalLength }, setProposal] = useState<ProposalState>(() => ({ proposalLength: 0 }));
  const [withVote, toggleVote] = useToggle(true);
  const modLocation = useCollectiveInstance('technicalCommittee');
  const proposalCount = useCall<BN>(modLocation && api.query[modLocation].proposalCount);

  const memberThreshold = useMemo(
    () => new BN(
      Math.ceil(
        members.length * getFastTrackThreshold(api, !votingBlocks || api.consts.democracy.fastTrackVotingPeriod.lte(votingBlocks))
      )
    ),
    [api, members, votingBlocks]
  );

  const extrinsic = useMemo(
    (): SubmittableExtrinsic<'promise'> | null => {
      if (!modLocation || !proposal || !proposalCount || !api.tx.utility) {
        return null;
      }

      const proposeTx = api.tx[modLocation].propose.meta.args.length === 3
        ? api.tx[modLocation].propose(memberThreshold, proposal, proposalLength)
        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
        // @ts-ignore Old-type
        : api.tx[modLocation].propose(memberThreshold, proposal);

      return withVote && (members.length > 1)
        ? api.tx.utility.batch([
          proposeTx,
          api.tx[modLocation].vote(proposal.method.hash, proposalCount, true)
        ])
        : proposeTx;
    }, [api, members, memberThreshold, modLocation, proposal, proposalCount, proposalLength, withVote]
  );

  useEffect((): void => {
    const proposal = delayBlocks && !delayBlocks.isZero() && votingBlocks && !votingBlocks.isZero()
      ? api.tx.democracy.fastTrack(imageHash, votingBlocks, delayBlocks)
      : null;

    setProposal({
      proposal,
      proposalLength: proposal?.length || 0
    });
  }, [api, delayBlocks, imageHash, members, votingBlocks]);

  if (!modLocation || !api.tx.utility) {
    return null;
  }

  return (
    <>
      {isFasttrackOpen && (
        <Modal
          header={t('Fast track proposal')}
          onClose={toggleFasttrack}
          size='large'
        >
          <Modal.Content>
            <Modal.Columns hint={t('Select the committee account you wish to make the proposal with.')}>
              <InputAddress
                filter={members}
                label={t('propose from account')}
                onChange={setAcountId}
                type='account'
                withLabel
              />
            </Modal.Columns>
            <Modal.Columns hint={t('The external proposal to send to the technical committee')}>
              <Input
                isDisabled
                label={t('preimage hash')}
                value={isString(imageHash) ? imageHash : imageHash.toHex()}
              />
            </Modal.Columns>
            <Modal.Columns hint={t('The voting period and delay to apply to this proposal. The threshold is calculated from these values.')}>
              <InputNumber
                autoFocus
                isZeroable={false}
                label={t('voting period')}
                onChange={setVotingBlocks}
                value={votingBlocks}
              />
              <InputNumber
                isZeroable={false}
                label={t('delay')}
                onChange={setDelayBlocks}
                value={delayBlocks}
              />
              <InputNumber
                defaultValue={memberThreshold}
                isDisabled
                label={t('threshold')}
              />
            </Modal.Columns>
            {(members.length > 1) && (
              <Modal.Columns hint={t('Submit an Aye vote alongside the proposal as part of a batch')}>
                <Toggle
                  label={t('Submit Aye vote with proposal')}
                  onChange={toggleVote}
                  value={withVote}
                />
              </Modal.Columns>
            )}
          </Modal.Content>
          <Modal.Actions>
            <TxButton
              accountId={accountId}
              extrinsic={extrinsic}
              icon='forward'
              isDisabled={!accountId}
              label={t('Fast track')}
              onStart={toggleFasttrack}
            />
          </Modal.Actions>
        </Modal>
      )}
      <Button
        icon='forward'
        isDisabled={threshold.isSuperMajorityApprove}
        label={t('Fast track')}
        onClick={toggleFasttrack}
      />
    </>
  );
}

export default React.memo(Fasttrack);