feature/proof-of-stake (#290)

* Add newline to make graphite happy

* Lockups (#299)

* Add transcoder for Register as validator transaction. Add support for approve component for this txn type

* Add transcoder for Unregister as validator txn type. Add support for approve component for this new txn type

* Add transcoder for stake transaction metadata. Add support for approve component for this new txn type.

* Add transcoder for Unstake txn type. Add support for approve component for this new txn type.

* Add transcoder for Unlock stake txn type. Add support for approve UI for this new txn type

* Add transcoder for Unjail Validator txn type. Add approve UI support for this new txn type.

* Add support for coin lockup txn types

---------

Co-authored-by: Lazy Nina <>

* PoS Spending Limits UI (#298)

* Update computation of expiration block height (#300)

* PoS Spending Limits UI

* Update computation of expiration block height

---------

Co-authored-by: Lazy Nina <>
Co-authored-by: Jon Pollock <135658176+poolcoke@users.noreply.github.com>

Author: lazynina

Dockerfile

@@ -8,9 +8,6 @@ COPY ./package.json .
 COPY ./package-lock.json .
 COPY ./.npmrc .
 
-# use yarn to upgrade npm
-RUN yarn global add npm@7
-
 # install frontend dependencies before copying the frontend code
 # into the container so we get docker cache benefits
 RUN npm install

README.md

@@ -17,3 +17,4 @@ After proper configuration of `environment.ts` and `environment.prod.ts`, run `n
 ## Format
 
 Formatting will happen upon commit. Developers can also run `npm run format` or `npx npm run format` if npm isn't installed to format all source files
+

src/app/account.service.ts

@@ -351,8 +351,8 @@ export class AccountService {
     const btcDepositAddress = 'Not implemented yet';
     const ethDepositAddress = 'Not implemented yet';
 
-    // days * (24 hours / day) * (60 minutes / hour) * (1 block / 5 minutes) = blocks
-    const numBlocksBeforeExpiration = (numDaysBeforeExpiration * 24 * 60) / 5;
+    // days * (24 hours / day) * (60 minutes / hour) * (60 seconds / minute) * (1 block / second) = blocks
+    const numBlocksBeforeExpiration = numDaysBeforeExpiration * 24 * 60 * 60;
 
     // By default, we authorize this derived key for 8640 blocks, which is about 30 days.
     const expirationBlock = blockHeight + numBlocksBeforeExpiration;

src/app/app.module.ts

@@ -60,6 +60,8 @@ import { TransactionSpendingLimitDaoCoinLimitOrderComponent } from './transactio
 import { TransactionSpendingLimitNftComponent } from './transaction-spending-limit/transaction-spending-limit-nft/transaction-spending-limit-nft.component';
 import { TransactionSpendingLimitSectionComponent } from './transaction-spending-limit/transaction-spending-limit-section/transaction-spending-limit-section.component';
 import { TransactionSpendingLimitComponent } from './transaction-spending-limit/transaction-spending-limit.component';
+import { TransactionSpendingLimitStakeComponent } from './transaction-spending-limit/transaction-spending-limit-stake/transaction-spending-limit-stake.component';
+import { TransactionSpendingLimitLockupComponent } from './transaction-spending-limit/transaction-spending-limit-lockup/transaction-spending-limit-lockup.component';
 
 @NgModule({
   declarations: [
@@ -107,6 +109,8 @@ import { TransactionSpendingLimitComponent } from './transaction-spending-limit/
     RecoverySecretComponent,
     BackupSeedDialogComponent,
     RemoveAccountDialogComponent,
+    TransactionSpendingLimitStakeComponent,
+    TransactionSpendingLimitLockupComponent,
   ],
   imports: [
     BrowserModule,

src/app/approve/approve.component.ts

@@ -37,6 +37,16 @@ import {
   TransactionMetadataUpdateNFT,
   TransactionMetadataUpdateProfile,
   TransactionSpendingLimit,
+  TransactionMetadataRegisterAsValidator,
+  TransactionMetadataUnregisterAsValidator,
+  TransactionMetadataStake,
+  TransactionMetadataUnstake,
+  TransactionMetadataUnlockStake,
+  TransactionMetadataUnjailValidator,
+  TransactionMetadataCoinLockup,
+  TransactionMetadataUpdateCoinLockupParams,
+  TransactionMetadataCoinLockupTransfer,
+  TransactionMetadataCoinUnlock,
 } from '../../lib/deso/transaction';
 import { ExtraData } from '../../types/identity';
 import { AccountService } from '../account.service';
@@ -304,12 +314,12 @@ export class ApproveComponent implements OnInit {
         );
         publicKeys = [daoCoinPublicKey];
         if (daoCoinMetadata.operationType === 0) {
-          const mintAmount = this.hexNanosToUnitString(
+          const mintAmount = this.hexBaseUnitsToUnitString(
             daoCoinMetadata.coinsToMintNanos
           );
           description = `mint ${mintAmount} ${daoCoinPublicKey} DAO coins`;
         } else if (daoCoinMetadata.operationType === 1) {
-          const burnAmount = this.hexNanosToUnitString(
+          const burnAmount = this.hexBaseUnitsToUnitString(
             daoCoinMetadata.coinsToBurnNanos
           );
           description = `burn ${burnAmount} ${daoCoinPublicKey} DAO coins`;
@@ -322,7 +332,7 @@ export class ApproveComponent implements OnInit {
       case TransactionMetadataTransferDAOCoin:
         const daoCoinTransferMetadata = this.transaction
           .metadata as TransactionMetadataTransferDAOCoin;
-        const daoCoinTransferAmount = this.hexNanosToUnitString(
+        const daoCoinTransferAmount = this.hexBaseUnitsToUnitString(
           daoCoinTransferMetadata.daoCoinToTransferNanos
         );
         const daoCoinTransferPublicKey = this.base58KeyCheck(
@@ -388,6 +398,7 @@ export class ApproveComponent implements OnInit {
             this.hexScaledExchangeRateToFloat(
               daoCoinLimitOrderMetadata.scaledExchangeRateCoinsToSellPerCoinToBuy
             );
+          // TODO: figure out if we need to use hexBaseUnitsToUnitString here.
           const quantityToFill = this.hexNanosToUnitString(
             daoCoinLimitOrderMetadata.quantityToFillInBaseUnits
           );
@@ -588,6 +599,120 @@ export class ApproveComponent implements OnInit {
             description = `unknown messaging action on ${messageType} to ${recipient}`;
         }
         break;
+      case TransactionMetadataRegisterAsValidator:
+        // TODO: Do we want any additional details in the approve component?
+        description = 'register as a validator';
+        break;
+      case TransactionMetadataUnregisterAsValidator:
+        description = 'unregister as a validator';
+        break;
+      case TransactionMetadataStake:
+        const stakeMetadata = this.transaction
+          .metadata as TransactionMetadataStake;
+        const stakeValidatorPublicKey = this.base58KeyCheck(
+          stakeMetadata.validatorPublicKey
+        );
+        publicKeys = [stakeValidatorPublicKey];
+        const stakeAmountNanos = this.hexNanosToUnitString(
+          stakeMetadata.stakeAmountNanos
+        );
+        description = `stake ${stakeAmountNanos} $DESO to ${stakeValidatorPublicKey}`;
+        break;
+      case TransactionMetadataUnstake:
+        const unstakeMetadata = this.transaction
+          .metadata as TransactionMetadataUnstake;
+        const unstakeValidatorPublicKey = this.base58KeyCheck(
+          unstakeMetadata.validatorPublicKey
+        );
+        publicKeys = [unstakeValidatorPublicKey];
+        const unstakeAmountNanos = this.hexNanosToUnitString(
+          unstakeMetadata.unstakeAmountNanos
+        );
+        description = `unstake ${unstakeAmountNanos} $DESO from ${unstakeValidatorPublicKey}`;
+        break;
+      case TransactionMetadataUnlockStake:
+        const unlockStakeMetadata = this.transaction
+          .metadata as TransactionMetadataUnlockStake;
+        const unlockStakeValidatorPublicKey = this.base58KeyCheck(
+          unlockStakeMetadata.validatorPublicKey
+        );
+        publicKeys = [unlockStakeValidatorPublicKey];
+        description =
+          `unlock stake from ${unlockStakeValidatorPublicKey}, ` +
+          `starting from epochs ${unlockStakeMetadata.startEpochNumber} to ${unlockStakeMetadata.endEpochNumber}`;
+        break;
+      case TransactionMetadataUnjailValidator:
+        description = 'unjail your validator';
+        break;
+      case TransactionMetadataCoinLockup:
+        // NOTE: we don't need a special case for DESO right now
+        // as lockups are not allowed for DESO at this time.
+        const coinLockupMetadata = this.transaction
+          .metadata as TransactionMetadataCoinLockup;
+        const lockupAmount = this.hexBaseUnitsToUnitString(
+          coinLockupMetadata.lockupAmountBaseUnits
+        );
+        const lockupProfilePubKey = this.base58KeyCheck(
+          coinLockupMetadata.profilePublicKey
+        );
+        const lockUpRecipientPubKey = this.base58KeyCheck(
+          coinLockupMetadata.recipientPublicKey
+        );
+        publicKeys = [lockupProfilePubKey, lockUpRecipientPubKey];
+        description = `lockup ${lockupAmount} of your ${lockupProfilePubKey} coins`;
+        break;
+      case TransactionMetadataUpdateCoinLockupParams:
+        const updateCoinLockupParamsMetadata = this.transaction
+          .metadata as TransactionMetadataUpdateCoinLockupParams;
+        description =
+          `update your coin lockup params\n` +
+          `${
+            updateCoinLockupParamsMetadata.removeYieldCurvePoint
+              ? 'Remove'
+              : 'Add'
+          } yield curve point with
+          ${
+            updateCoinLockupParamsMetadata.lockupYieldAPYBasisPoints / 100
+          }% APY for a lockup of
+           ${
+             updateCoinLockupParamsMetadata.lockupYieldDurationNanoSecs
+           } nanoseconds
+          ${
+            !updateCoinLockupParamsMetadata.newLockupTransferRestrictions
+              ? ''
+              : 'and update your lockup transfer restrictions'
+          }`;
+
+        break;
+      case TransactionMetadataCoinLockupTransfer:
+        // NOTE: we don't need a special case for DESO right now
+        // as lockups are not allowed for DESO at this time.
+        const coinLockupTransferMetadata = this.transaction
+          .metadata as TransactionMetadataCoinLockupTransfer;
+        const lockupTransferAmount = this.hexBaseUnitsToUnitString(
+          coinLockupTransferMetadata.lockedCoinsToTransferBaseUnits
+        );
+        const lockupTransferProfilePubKey = this.base58KeyCheck(
+          coinLockupTransferMetadata.profilePublicKey
+        );
+        const lockupTransferRecipientPubKey = this.base58KeyCheck(
+          coinLockupTransferMetadata.recipientPublicKey
+        );
+        publicKeys = [
+          lockupTransferProfilePubKey,
+          lockupTransferRecipientPubKey,
+        ];
+        description = `transfer ${lockupTransferAmount} of your locked ${lockupTransferProfilePubKey} coins to ${lockupTransferRecipientPubKey}`;
+        break;
+      case TransactionMetadataCoinUnlock:
+        const coinUnlockMetadata = this.transaction
+          .metadata as TransactionMetadataCoinUnlock;
+        const unlockProfilePubKey = this.base58KeyCheck(
+          coinUnlockMetadata.profilePublicKey
+        );
+        publicKeys = [unlockProfilePubKey];
+        description = `unlock your locked ${unlockProfilePubKey} coins`;
+        break;
     }
 
     // Set the transaction description based on the description populated with public keys.
@@ -608,14 +733,24 @@ export class ApproveComponent implements OnInit {
     return bs58check.encode(Buffer.from([...prefix, ...keyBytes]));
   }
 
+  // uint256 to DESO nano conversions.
   hexNanosToUnitString(nanos: Buffer): string {
     return this.nanosToUnitString(parseInt(nanos.toString('hex'), 16));
   }
 
+  // unit256 to base unit conversions.
+  hexBaseUnitsToUnitString(baseUnits: Buffer): string {
+    return this.baseUnitsToUnitString(parseInt(baseUnits.toString('hex'), 16));
+  }
+
   nanosToUnitString(nanos: number): string {
     return this.toFixedLengthDecimalString(nanos / 1e9);
   }
 
+  baseUnitsToUnitString(baseUnits: number): string {
+    return this.toFixedLengthDecimalString(baseUnits / 1e18);
+  }
+
   hexScaledExchangeRateToFloat(hex: Buffer): number {
     return parseInt(hex.toString('hex'), 16) / 1e38;
   }

src/app/backend-api.service.ts

@@ -147,7 +147,8 @@ export type LimitOperationString =
   | NFTLimitOperationString
   | AssociationOperationString
   | AccessGroupOperationString
-  | AccessGroupMemberOperationString;
+  | AccessGroupMemberOperationString
+  | LockupLimitOperationString;
 export type CreatorCoinOperationLimitMap =
   CoinOperationLimitMap<CreatorCoinLimitOperationString>;
 export type DAOCoinOperationLimitMap =
@@ -236,6 +237,42 @@ export type AccessGroupMemberLimitMapItem = {
   OpCount: number;
 };
 
+export type StakeLimitMapItem = {
+  ValidatorPublicKeyBase58Check: string;
+  StakeLimit: string; // Hex string
+};
+
+export type UnstakeLimitMapItem = {
+  ValidatorPublicKeyBase58Check: string;
+  UnstakeLimit: string; // Hex string
+};
+
+export type UnlockStakeLimitMapItem = {
+  ValidatorPublicKeyBase58Check: string;
+  OpCount: number;
+};
+
+export enum LockupLimitScopeType {
+  ANY = 'AnyCoins',
+  SCOPED = 'ScopedCoins',
+}
+
+export enum LockupLimitOperationString {
+  ANY = 'Any',
+  COIN_LOCKUP = 'CoinLockup',
+  UPDATE_COIN_LOCKUP_YIELD_CURVE = 'UpdateCoinLockupYieldCurve',
+  UPDATE_COIN_LOCKUP_TRANSFER_RESTRICTIONS = 'UpdateCoinLockupTransferRestrictions',
+  COIN_LOCKUP_TRANSFER = 'CoinLockupTransferOperationString',
+  COIN_UNLOCK = 'CoinLockupUnlock',
+}
+
+export type LockupLimitMapItem = {
+  ProfilePublicKeyBase58Check: string;
+  ScopeType: LockupLimitScopeType;
+  Operation: LockupLimitOperationString;
+  OpCount: number;
+};
+
 export interface TransactionSpendingLimitResponse {
   GlobalDESOLimit: number;
   // TODO: make enum for transaction type string
@@ -247,6 +284,10 @@ export interface TransactionSpendingLimitResponse {
   AssociationLimitMap?: AssociationLimitMapItem[];
   AccessGroupLimitMap?: AccessGroupLimitMapItem[];
   AccessGroupMemberLimitMap?: AccessGroupMemberLimitMapItem[];
+  StakeLimitMap?: StakeLimitMapItem[];
+  UnstakeLimitMap?: UnstakeLimitMapItem[];
+  UnlockStakeLimitMap?: UnlockStakeLimitMapItem[];
+  LockupLimitMap?: LockupLimitMapItem[];
   IsUnlimited?: boolean;
   DerivedKeyMemo?: string;
 }

src/app/identity.service.ts

@@ -35,6 +35,16 @@ import {
   TransactionMetadataUpdateGlobalParams,
   TransactionMetadataUpdateNFT,
   TransactionMetadataUpdateProfile,
+  TransactionMetadataRegisterAsValidator,
+  TransactionMetadataUnregisterAsValidator,
+  TransactionMetadataStake,
+  TransactionMetadataUnstake,
+  TransactionMetadataUnlockStake,
+  TransactionMetadataUnjailValidator,
+  TransactionMetadataCoinLockup,
+  TransactionMetadataUpdateCoinLockupParams,
+  TransactionMetadataCoinLockupTransfer,
+  TransactionMetadataCoinUnlock,
 } from '../lib/deso/transaction';
 import { SwalHelper } from '../lib/helpers/swal-helper';
 import { AccessLevel, PublicUserInfo } from '../types/identity';
@@ -518,6 +528,15 @@ export class IdentityService {
       case TransactionMetadataDAOCoin:
       case TransactionMetadataTransferDAOCoin:
       case TransactionMetadataDAOCoinLimitOrder:
+      case TransactionMetadataRegisterAsValidator:
+      case TransactionMetadataUnregisterAsValidator:
+      case TransactionMetadataStake:
+      case TransactionMetadataUnstake:
+      case TransactionMetadataUnlockStake:
+      case TransactionMetadataCoinLockup:
+      case TransactionMetadataUpdateCoinLockupParams:
+      case TransactionMetadataCoinLockupTransfer:
+      case TransactionMetadataCoinUnlock:
         return AccessLevel.Full;
 
       case TransactionMetadataFollow:
@@ -531,6 +550,7 @@ export class IdentityService {
       case TransactionMetadataAccessGroup:
       case TransactionMetadataAccessGroupMembers:
       case TransactionMetadataNewMessage:
+      case TransactionMetadataUnjailValidator:
         return AccessLevel.ApproveLarge;
     }
 

src/app/transaction-spending-limit/transaction-spending-limit-lockup/transaction-spending-limit-lockup.component.html

@@ -0,0 +1,29 @@
+<div class="display--flex justify--between margin-bottom--small">
+  <div class="text--left width--25">
+    <img
+      class="avatar--medium avatar--rounded margin-right--xsmall"
+      [appAvatar]="lockupLimitMapItem?.ProfilePublicKeyBase58Check"
+      *ngIf="
+        lockupLimitMapItem?.ProfilePublicKeyBase58Check &&
+        appUser?.ProfileEntryResponse?.Username
+      "
+    />
+    {{
+      appUser?.ProfileEntryResponse?.Username ||
+        lockupLimitMapItem?.ProfilePublicKeyBase58Check ||
+        (lockupLimitMapItem?.ScopeType === LockupLimitScopeType.ANY
+          ? 'Any Profile'
+          : 'DESO') | truncateAddressOrUsername
+    }}
+  </div>
+  <div class="display-flex justify--center width--50">
+    <code>
+      {{ getOperationString() }}
+    </code>
+  </div>
+  <div class="width--25 text--right">
+    <code>
+      {{ globalVars.formatTxCountLimit(lockupLimitMapItem?.OpCount) }}
+    </code>
+  </div>
+</div>