baking-bad/tzkt v1.13.0

on GitHub

General notes

• added Oxford support;
• switched to Postgresql 16;
• minor improvements.

To update from v1.12.* to v1.13.0 you should drop the indexer database and restore it from the latest snapshot (in case of non-docker setup you may also need to update your Postgresql, see explanation below), or reindex from scratch. This is due to breaking changes in the consensus, that complicate DB migration.

Postgresql 16

We've switched to PostgreSQL 16 with raised performance, improvements to query parallelism, bulk data loading, and logical replication.

In fact, you don't necessarily have to update your Postgresql, because TzKT can work with older versions, however the DB snapshots we provide are created with pg_dump v16, which is not compatible with pg_restore v15 and older, so if you want to restore your DB from our snapshots, then you will have to use Postgresql of the appropriate version.

Changes in the API endpoints

• [BREAKING] /rewards/delegators/{address}/{cycle} was deprecated, because since Oxford a single account can have multiple delegations at the same time, that can lead to multiple delegator reward entities for a single cycle, so use /rewards/delegators/{address}?cycle={cycle} instead;
• [BREAKING] /rewards/bakers/{address}/{cycle} was deprecated, use /rewards/bakers/{address}?cycle={cycle} instead;
• /operations/staking was added;
• /operations/staking/count was added;
• /operations/autostaking was added;
• /operations/autostaking/count was added;
• /accounts/{address}/operations now also returns operations of new types: staking and autostaking.

Changes in the API models

Delegates:

• fields stakedPseudotokens, unstakedBaker, totalStakedBalance, issuedPseudotokens, stakersCount, limitOfStakingOverBaking, edgeOfBakingOverStaking, stakingOpsCount, autostakingOpsCount, and lostBalance were added;
• [BREAKING] field frozenDeposit was deprecated and replaced with stakedBalance, unstakedBalance, externalStakedBalance, and externalUnstakedBalance.

Users:

• fields stakedBalance, stakedPseudotokens, unstakedBalance, unstakedBaker, stakingOpsCount, and lostBalance were added.

Baker rewards:

• field stakersCount was added;
• [BREAKING] field stakingBalance was deprecated and replaced with ownDelegatedBalance, ownStakedBalance, externalDelegatedBalance, and externalStakedBalance;
• [BREAKING] field delegatedBalance was deprecated and replaced with ownDelegatedBalance and externalDelegatedBalance;
• [BREAKING] field activeStake was deprecated and replaced with bakingPower;
• [BREAKING] field selectedStake was deprecated and replaced with totalBakingPower;
• [BREAKING] field numDelegators was deprecated and replaced with delegatorsCount;
• [BREAKING] field blockRewards was deprecated and replaced with blockRewardsLiquid, blockRewardsStakedOwn, and blockRewardsStakedShared;
• [BREAKING] field endorsementRewards was deprecated and replaced with endorsementRewardsLiquid, endorsementRewardsStakedOwn, and endorsementRewardsStakedShared;
• [BREAKING] field doubleBakingLosses was deprecated and replaced with doubleBakingLostStaked, doubleBakingLostUnstaked, doubleBakingLostExternalStaked, and doubleBakingLostExternalUnstaked;
• [BREAKING] field doubleEndorsingLosses was deprecated and replaced with doubleEndorsingLostStaked, doubleEndorsingLostUnstaked, doubleEndorsingLostExternalStaked, and doubleEndorsingLostExternalUnstaked;
• [BREAKING] field doublePreendorsingLosses was deprecated and replaced with doublePreendorsingLostStaked, doublePreendorsingLostUnstaked, doublePreendorsingLostExternalStaked, and doublePreendorsingLostExternalUnstaked;
• [BREAKING] field revelationRewards was deprecated and replaced with vdfRevelationRewardsLiquid, vdfRevelationRewardsStakedOwn, vdfRevelationRewardsStakedShared, nonceRevelationRewardsLiquid, nonceRevelationRewardsStakedOwn, and nonceRevelationRewardsStakedShared;
• [BREAKING] field revelationLosses was deprecated and replaced with nonceRevelationLosses.

Rewards split:

• same changes as for baker rewards, described above.

Rewards split delegator:

• [BREAKING] field balance was deprecated and replaced with delegatedBalance and stakedBalance;
• [BREAKING] field currentBalance was deprecated and replaced with currentDelegatedBalance and currentStakedBalance.

Delegator rewards:

• [BREAKING] field balance was deprecated and replaced with delegatedBalance and stakedBalance;
• [BREAKING] field stakingBalance was deprecated and replaced with bakerDelegatedBalance, bakerStakedBalance, externalDelegatedBalance, and externalStakedBalance;
• [BREAKING] field activeStake was deprecated and replaced with bakingPower;
• [BREAKING] field selectedStake was deprecated and replaced with totalBakingPower;
• [BREAKING] field blockRewards was deprecated and replaced with blockRewardsLiquid, blockRewardsStakedOwn, and blockRewardsStakedShared;
• [BREAKING] field endorsementRewards was deprecated and replaced with endorsementRewardsLiquid, endorsementRewardsStakedOwn, and endorsementRewardsStakedShared;
• [BREAKING] field doubleBakingLosses was deprecated and replaced with doubleBakingLostStaked, doubleBakingLostUnstaked, doubleBakingLostExternalStaked, and doubleBakingLostExternalUnstaked;
• [BREAKING] field doubleEndorsingLosses was deprecated and replaced with doubleEndorsingLostStaked, doubleEndorsingLostUnstaked, doubleEndorsingLostExternalStaked, and doubleEndorsingLostExternalUnstaked;
• [BREAKING] field doublePreendorsingLosses was deprecated and replaced with doublePreendorsingLostStaked, doublePreendorsingLostUnstaked, doublePreendorsingLostExternalStaked, and doublePreendorsingLostExternalUnstaked;
• [BREAKING] field revelationRewards was deprecated and replaced with vdfRevelationRewardsLiquid, vdfRevelationRewardsStakedOwn, vdfRevelationRewardsStakedShared, nonceRevelationRewardsLiquid, nonceRevelationRewardsStakedOwn, and nonceRevelationRewardsStakedShared;
• [BREAKING] field revelationLosses was deprecated and replaced with nonceRevelationLosses.

Cycles:

• fields blockReward, blockBonusPerSlot, endorsementRewardPerSlot, nonceRevelationReward, vdfRevelationReward, and lbSubsidy were added;
• [BREAKING] field totalStaking was deprecated;
• [BREAKING] field selectedStake was deprecated and replaced with totalBakingPower;
• [BREAKING] field selectedBakers was deprecated and replaced with totalBakers;
• [BREAKING] field totalDelegated was deprecated;
• [BREAKING] field totalDelegators was deprecated.

Blocks:

• fields aiToggle, aiToggleEma, stakingOps, and autostakingOps were added.

Blocks and baking operations:

• [BREAKING] field reward was deprecated and replaced with rewardLiquid, rewardStakedOwn, and rewardStakedShared;
• [BREAKING] field bonus was deprecated and replaced with bonusLiquid, bonusStakedOwn, and bonusStakedShared.

Delegation operations:

• fields unstakedPseudotokens, unstakedBalance, and unstakedRewards were added.

Double baking/endorsing/preendorsing operations:

• field slashedLevel was added;
• [BREAKING] field accuserReward was renamed to reward;
• [BREAKING] field offenderLoss was deprecated and replaced with lostStaked, lostUnstaked, lostExternalStaked, lostExternalUnstaked, and roundingLoss.

Endorsing reward operations:

• [BREAKING] field received was deprecated and replaced with rewardLiquid, rewardStakedOwn, and rewardStakedShared.

Migration operations:

• field kind was extended with the new possible value remove_bigmap_key.

Nonce/vdf revelation operations:

• [BREAKING] field reward was deprecated and replaced with rewardLiquid, rewardStakedOwn, and rewardStakedShared.

Smart rollup originate operations:

• [BREAKING] field originationProof was removed.

Protocol constants:

• fields minimalFrozenStake, maxDelegatedOverFrozenRatio, and maxExternalOverOwnStakeRatio were added;
• [BREAKING] field tokensPerRoll was deprecated and replaced with minimalStake;
• [BREAKING] field revelationReward was deprecated, use adaptive issuance values;
• [BREAKING] field lbSubsidy was deprecated, use adaptive issuance values;
• [BREAKING] field frozenDepositsPercentage was deprecated;
• [BREAKING] field doubleBakingPunishment was deprecated;
• [BREAKING] field doubleEndorsingPunishmentNumerator was deprecated;
• [BREAKING] field doubleEndorsingPunishmentDenominator was deprecated;
• [BREAKING] field txRollupOriginationSize was deprecated;
• [BREAKING] field txRollupCommitmentBond was deprecated.

Statistics:

• field totalLost was added.

Changes in the WebSocket API:

• new operation types are available in the operations subscription.

Changes in the DB schema

Basically, DB schema has almost the same changes as the API models, described above.
For more details check out the full diffs at Tzkt.Data/Models.

Commits

• 49452b7: Add Oxford (#162) (Maksim Strebkov) #162
• 103b188: v1.13.0 (Maksim Strebkov)