Update: tzkt v1.16 (#45)

k-karuna · web-flow · commit 6091b958557d · 2025-08-25T20:09:36.000+03:00
* Removed frozen... fields from Delegate account; Added operations test

* Updated cycle fields

* Removed rolls from ballot

* Removed rolls from proposal op.

* Baking op. fields updated

* Updated double baking and double endorsing operations

* Updated DoublePreendorsing

* Updated EndorsingReward and NonceRevelation

* Added staking operation

* Updated VdfRevelation

* Updated Block and Statistics

* Updated ProtocolConstants

* Comments typos fix

* TzKT v1.16.0: updated attestation op

* TzKT v1.16.0: renamed preendorsement to preattestation

* TzKT v1.16.0: renamed EndorsingReward to AttestationReward

* TzKT v1.16.0: renamed UpdateConsensusKey to UpdateSecondaryKey

* TzKT v1.16.0: merged DoubleEndorsing and DoublePreendorsing to DoubleConsensus

* TzKT v1.16.0: fixed incorrect test method naming

* TzKT v1.16.0: added publicKey filed to reveal

* TzKT v1.16.0: updated Delegate

* TzKT v1.16.0: added fields to DoubleBaking

* TzKT v1.16.0: added fields to DoubleConsensus

* TzKT v1.16.0: added fields to NonceRevelation

* TzKT v1.16.0: added fields to AttestationReward
diff --git a/tzkt/api/accounts.go b/tzkt/api/accounts.go
@@ -10,7 +10,7 @@ func (tzkt *API) AccountCounter(ctx context.Context, address string) (uint64, er
 	return tzkt.count(ctx, fmt.Sprintf("/v1/accounts/%s/counter", address), nil)
 }
 
-// AccountCounter - Returns a number of accounts.
+// AccountsCount - Returns a number of accounts.
 func (tzkt *API) AccountsCount(ctx context.Context, filters map[string]string) (uint64, error) {
 	return tzkt.count(ctx, "/v1/accounts/count", filters)
 }
diff --git a/tzkt/api/operations.go b/tzkt/api/operations.go
@@ -9,9 +9,9 @@ import (
 	"github.com/pkg/errors"
 )
 
-// GetEndorsements -
-func (tzkt *API) GetEndorsements(ctx context.Context, filters map[string]string) (operations []data.Endorsement, err error) {
-	err = tzkt.json(ctx, "/v1/operations/endorsements", filters, false, &operations)
+// GetAttestations -
+func (tzkt *API) GetAttestations(ctx context.Context, filters map[string]string) (operations []data.Attestation, err error) {
+	err = tzkt.json(ctx, "/v1/operations/attestations", filters, false, &operations)
 	return
 }
 
@@ -39,9 +39,9 @@ func (tzkt *API) GetDoubleBakings(ctx context.Context, filters map[string]string
 	return
 }
 
-// GetDoubleEndorsings -
-func (tzkt *API) GetDoubleEndorsings(ctx context.Context, filters map[string]string) (operations []data.DoubleEndorsing, err error) {
-	err = tzkt.json(ctx, "/v1/operations/double_endorsing", filters, false, &operations)
+// GetDoubleConsensus -
+func (tzkt *API) GetDoubleConsensus(ctx context.Context, filters map[string]string) (operations []data.DoubleConsensus, err error) {
+	err = tzkt.json(ctx, "/v1/operations/double_consensus", filters, false, &operations)
 	return
 }
 
@@ -102,9 +102,9 @@ func (tzkt *API) GetTransactionsByHash(ctx context.Context, hash string, filters
 	return
 }
 
-// GetPreendorsement -
-func (tzkt *API) GetPreendorsement(ctx context.Context, filters map[string]string) (operations []data.Preendorsement, err error) {
-	err = tzkt.json(ctx, "/v1/operations/preendorsement", filters, false, &operations)
+// GetPreattestation -
+func (tzkt *API) GetPreattestation(ctx context.Context, filters map[string]string) (operations []data.Preattestation, err error) {
+	err = tzkt.json(ctx, "/v1/operations/preattestations", filters, false, &operations)
 	return
 }
 
@@ -174,9 +174,9 @@ func (tzkt *API) GetBakings(ctx context.Context, filters map[string]string) (ope
 	return
 }
 
-// GetEndorsingRewards -
-func (tzkt *API) GetEndorsingRewards(ctx context.Context, filters map[string]string) (operations []data.EndorsingReward, err error) {
-	err = tzkt.json(ctx, "/v1/operations/endorsing_rewards", filters, false, &operations)
+// GetAttestationReward -
+func (tzkt *API) GetAttestationReward(ctx context.Context, filters map[string]string) (operations []data.AttestationReward, err error) {
+	err = tzkt.json(ctx, "/v1/operations/attestation_rewards", filters, false, &operations)
 	return
 }
 
@@ -186,12 +186,6 @@ func (tzkt *API) GetRevelationPenalties(ctx context.Context, filters map[string]
 	return
 }
 
-// GetDoublePreendorsings -
-func (tzkt *API) GetDoublePreendorsings(ctx context.Context, filters map[string]string) (operations []data.DoublePreendorsing, err error) {
-	err = tzkt.json(ctx, "/v1/operations/double_preendorsing", filters, false, &operations)
-	return
-}
-
 // GetVdfRevelations -
 func (tzkt *API) GetVdfRevelations(ctx context.Context, filters map[string]string) (operations []data.VdfRevelation, err error) {
 	err = tzkt.json(ctx, "/v1/operations/vdf_revelations", filters, false, &operations)
@@ -204,9 +198,9 @@ func (tzkt *API) GetIncreasePaidStorage(ctx context.Context, filters map[string]
 	return
 }
 
-// GetUpdateConsensusKey -
-func (tzkt *API) GetUpdateConsensusKey(ctx context.Context, filters map[string]string) (operations []data.UpdateConsensusKey, err error) {
-	err = tzkt.json(ctx, "/v1/operations/update_consensus_key", filters, false, &operations)
+// GetUpdateSecondaryKey -
+func (tzkt *API) GetUpdateSecondaryKey(ctx context.Context, filters map[string]string) (operations []data.UpdateSecondaryKey, err error) {
+	err = tzkt.json(ctx, "/v1/operations/update_secondary_key", filters, false, &operations)
 	return
 }
 
@@ -263,3 +257,9 @@ func (tzkt *API) GetDalPublishCommitment(ctx context.Context, filters map[string
 	err = tzkt.json(ctx, "/v1/operations/dal_publish_commitment", filters, false, &operations)
 	return
 }
+
+// GetStaking -
+func (tzkt *API) GetStaking(ctx context.Context, filters map[string]string) (operations []data.Staking, err error) {
+	err = tzkt.json(ctx, "/v1/operations/staking", filters, false, &operations)
+	return
+}
diff --git a/tzkt/api/operations_test.go b/tzkt/api/operations_test.go
@@ -0,0 +1,44 @@
+package api
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestGetBakings(t *testing.T) {
+	api := New("https://staging.api.tzkt.io")
+
+	bakings, err := api.GetBakings(t.Context(), map[string]string{
+		"level": "9935996",
+	})
+
+	require.NoError(t, err)
+	assert.Len(t, bakings, 1)
+	assert.NotEmpty(t, bakings[0].Level)
+}
+
+func TestGetStaking(t *testing.T) {
+	api := New("https://staging.api.tzkt.io")
+
+	stakings, err := api.GetStaking(t.Context(), map[string]string{
+		"hash": "opEK5fRFrjzyGcXS8Euh9EsxRAATKsEV94m2mejsgWHMHbxTAPo",
+	})
+
+	require.NoError(t, err)
+	assert.Len(t, stakings, 1)
+	assert.Equal(t, uint64(9967034), stakings[0].Level)
+}
+
+func TestGetDoubleConsensus(t *testing.T) {
+	api := New("https://staging.api.tzkt.io")
+
+	doubleConsensus, err := api.GetDoubleConsensus(t.Context(), map[string]string{
+		"level": "554813",
+	})
+
+	require.NoError(t, err)
+	assert.Len(t, doubleConsensus, 1)
+	assert.Equal(t, "ooaLQnmRTDFf2JZa5skBcYVKUTUxrE6gtuejs31YFeRKXpxRawR", doubleConsensus[0].Hash)
+}
diff --git a/tzkt/data/account.go b/tzkt/data/account.go
@@ -9,21 +9,18 @@ type Delegate struct {
 	Address                string    `json:"address"`
 	PublicKey              string    `json:"publicKey"`
 	Balance                int64     `json:"balance"`
-	FrozenDeposits         int64     `json:"frozenDeposits"`
-	FrozenRewards          int64     `json:"frozenRewards"`
-	FrozenFees             int64     `json:"frozenFees"`
 	Counter                int64     `json:"counter"`
 	ActivationLevel        int64     `json:"activationLevel"`
 	StakingBalance         int64     `json:"stakingBalance"`
 	NumContracts           int64     `json:"numContracts"`
 	NumDelegators          int64     `json:"numDelegators"`
 	NumBlocks              int64     `json:"numBlocks"`
-	NumEndorsements        int64     `json:"numEndorsements"`
+	NumAttestations        int64     `json:"numAttestations"`
 	NumBallots             int64     `json:"numBallots"`
 	NumProposals           int64     `json:"numProposals"`
 	NumActivations         int64     `json:"numActivations"`
 	NumDoubleBaking        int64     `json:"numDoubleBaking"`
-	NumDoubleEndorsing     int64     `json:"numDoubleEndorsing"`
+	NumDoubleConsensus     int64     `json:"numDoubleConsensus"`
 	NumNonceRevelations    int64     `json:"numNonceRevelations"`
 	NumRevelationPenalties int64     `json:"numRevelationPenalties"`
 	NumDelegations         int64     `json:"numDelegations"`
diff --git a/tzkt/data/blocks.go b/tzkt/data/blocks.go
@@ -8,24 +8,26 @@ import (
 
 // Block -
 type Block struct {
-	Cycle         int64     `json:"cycle"`
-	Level         uint64    `json:"level"`
-	Hash          string    `json:"hash"`
-	Timestamp     time.Time `json:"timestamp"`
-	Proto         int64     `json:"proto"`
-	Priority      int64     `json:"priority"`
-	Validations   int64     `json:"validations"`
-	BlockRound    uint64    `json:"blockRound"`
-	PayloadRound  uint64    `josn:"payloadRound"`
-	Deposit       int64     `json:"deposit"`
-	Reward        int64     `json:"reward"`
-	Fees          int64     `json:"fees"`
-	Bonus         int64     `json:"bonus"`
-	LbEscapeEma   int64     `json:"lbEscapeEma"`
-	NonceRevealed bool      `json:"nonceRevealed"`
-	LbEscapeVote  bool      `json:"lbEscapeVote"`
-	LbToggleEma   uint64    `json:"lbToggleEma"`
-	Baker         Address   `json:"baker"`
+	Cycle              int64     `json:"cycle"`
+	Level              uint64    `json:"level"`
+	Hash               string    `json:"hash"`
+	Timestamp          time.Time `json:"timestamp"`
+	Proto              int64     `json:"proto"`
+	Validations        int64     `json:"validations"`
+	BlockRound         uint64    `json:"blockRound"`
+	PayloadRound       uint64    `json:"payloadRound"`
+	Deposit            int64     `json:"deposit"`
+	RewardDelegated    int64     `json:"rewardDelegated"`
+	RewardStakedOwn    int64     `json:"rewardStakedOwn"`
+	RewardStakedEdge   int64     `json:"rewardStakedEdge"`
+	RewardStakedShared int64     `json:"rewardStakedShared"`
+	BonusDelegated     int64     `json:"bonusDelegated"`
+	BonusStakedOwn     int64     `json:"bonusStakedOwn"`
+	BonusStakedEdge    int64     `json:"bonusStakedEdge"`
+	BonusStakedShared  int64     `json:"bonusStakedShared"`
+	Fees               int64     `json:"fees"`
+	NonceRevealed      bool      `json:"nonceRevealed"`
+	LbToggleEma        uint64    `json:"lbToggleEma"`
 }
 
 // Head -
diff --git a/tzkt/data/consts.go b/tzkt/data/consts.go
@@ -4,13 +4,12 @@ package data
 const (
 	KindTransaction              = "transaction"
 	KindOrigination              = "origination"
-	KindEndorsement              = "endorsement"
-	KindPreendorsement           = "preendorsement"
+	KindAttestation              = "attestation"
+	KindPreattestations          = "preattestations"
 	KindBallot                   = "ballot"
 	KindProposal                 = "proposal"
 	KindDoubleBaking             = "double_baking"
-	KindDoubleEndorsing          = "double_endorsing"
-	KindDoublePreendorsing       = "double_preendorsing"
+	KindDoubleConsensus          = "double_consensus"
 	KindActivation               = "activation"
 	KindMigration                = "migration"
 	KindNonceRevelation          = "nonce_revelation"
@@ -29,10 +28,10 @@ const (
 	KindSetDepositsLimit         = "set_deposits_limit"
 	KindRevelationPenalty        = "revelation_penalty"
 	KindBaking                   = "baking"
-	KindEndorsingReward          = "endorsing_reward"
+	KindAttestationReward        = "attestation_reward "
 	KindVdfRevelation            = "vdf_revelation"
 	KindIncreasePaidStorage      = "increase_paid_storage"
-	KindUpdateConsensusKey       = "update_consensus_key"
+	KindUpdateSecondaryKey       = "update_secondary_key"
 	KindDrainDelegate            = "drain_delegate"
 	KindSrAddMessages            = "sr_add_messages"
 	KindSrCement                 = "sr_cement"
@@ -42,6 +41,7 @@ const (
 	KindSrRecoverBond            = "sr_recover_bond"
 	KindSrRefute                 = "sr_refute"
 	KindDalPublishCommitment     = "dal_publish_commitment"
+	KindStaking                  = "staking"
 )
 
 // urls
diff --git a/tzkt/data/cylce.go b/tzkt/data/cylce.go
@@ -4,20 +4,20 @@ import "time"
 
 // Cycle -
 type Cycle struct {
-	Index           uint64    `json:"index"`
-	FirstLevel      uint64    `json:"firstLevel"`
-	StartTime       time.Time `json:"startTime"`
-	LastLevel       uint64    `json:"lastLevel"`
-	EndTime         time.Time `json:"endTime"`
-	SnapshotIndex   uint64    `json:"snapshotIndex"`
-	SnapshotLevel   uint64    `json:"snapshotLevel"`
-	RandomSeed      string    `json:"randomSeed,omitempty"`
-	TotalBakers     uint64    `json:"totalBakers"`
-	TotalStaking    uint64    `json:"totalStaking"`
-	TotalDelegators uint64    `json:"totalDelegators"`
-	TotalDelegated  uint64    `json:"totalDelegated"`
-	SelectedBakers  uint64    `json:"selectedBakers"`
-	SelectedStake   uint64    `json:"selectedStake"`
-	Quote           *Quote    `json:"quote,omitempty"`
-	TotalRolls      uint64    `json:"totalRolls"`
+	Index                        uint64    `json:"index"`
+	FirstLevel                   uint64    `json:"firstLevel"`
+	StartTime                    time.Time `json:"startTime"`
+	LastLevel                    uint64    `json:"lastLevel"`
+	EndTime                      time.Time `json:"endTime"`
+	SnapshotLevel                uint64    `json:"snapshotLevel"`
+	RandomSeed                   string    `json:"randomSeed,omitempty"`
+	TotalBakers                  uint64    `json:"totalBakers"`
+	TotalBakingPower             uint64    `json:"totalBakingPower,omitempty"`
+	BlockReward                  uint64    `json:"blockReward,omitempty"`
+	BlockBonusPerSlot            uint64    `json:"blockBonusPerSlot,omitempty"`
+	AttestationRewardPerSlot     uint64    `json:"attestationRewardPerSlot,omitempty"`
+	NonceRevelationReward        uint64    `json:"nonceRevelationReward,omitempty"`
+	VdfRevelationReward          uint64    `json:"vdfRevelationReward,omitempty"`
+	DalAttestationRewardPerShard uint64    `json:"dalAttestationRewardPerShard,omitempty"`
+	Quote                        *Quote    `json:"quote,omitempty"`
 }
diff --git a/tzkt/data/general.go b/tzkt/data/general.go
@@ -78,46 +78,48 @@ type Protocol struct {
 
 // ProtocolConstants -
 type ProtocolConstants struct {
-	RampUpCycles                         int64   `json:"rampUpCycles"`
-	NoRewardCycles                       int64   `json:"noRewardCycles"`
-	PreservedCycles                      int64   `json:"preservedCycles"`
-	BlocksPerCycle                       int64   `json:"blocksPerCycle"`
-	BlocksPerCommitment                  int64   `json:"blocksPerCommitment"`
-	BlocksPerSnapshot                    int64   `json:"blocksPerSnapshot"`
-	BlocksPerVoting                      int64   `json:"blocksPerVoting"`
-	TimeBetweenBlocks                    int64   `json:"timeBetweenBlocks"`
-	EndorsersPerBlock                    int64   `json:"endorsersPerBlock"`
-	HardOperationGasLimit                int64   `json:"hardOperationGasLimit"`
-	HardOperationStorageLimit            int64   `json:"hardOperationStorageLimit"`
-	HardBlockGasLimit                    int64   `json:"hardBlockGasLimit"`
-	TokensPerRoll                        int64   `json:"tokensPerRoll"`
-	RevelationReward                     int64   `json:"revelationReward"`
-	BlockDeposit                         int64   `json:"blockDeposit"`
-	BlockReward                          []int64 `json:"blockReward"`
-	EndorsementDeposit                   int64   `json:"endorsementDeposit"`
-	EndorsementReward                    []int64 `json:"endorsementReward"`
-	OriginationSize                      int64   `json:"originationSize"`
-	ByteCost                             int64   `json:"byteCost"`
-	ProposalQuorum                       int64   `json:"proposalQuorum"`
-	BallotQuorumMin                      int64   `json:"ballotQuorumMin"`
-	BallotQuorumMax                      int64   `json:"ballotQuorumMax"`
-	LbSubsidy                            int64   `json:"lbSubsidy"`
-	LbSunsetLevel                        int64   `json:"lbSunsetLevel"`
-	LbToggleThreshold                    int64   `json:"lbToggleThreshold"`
-	ConsensusThreshold                   int64   `json:"consensusThreshold"`
-	MinParticipationNumerator            int64   `json:"minParticipationNumerator"`
-	MinParticipationDenominator          int64   `json:"minParticipationDenominator"`
-	MaxSlashingPeriod                    int64   `json:"maxSlashingPeriod"`
-	FrozenDepositsPercentage             int64   `json:"frozenDepositsPercentage"`
-	DoubleBakingPunishment               int64   `json:"doubleBakingPunishment"`
-	DoubleEndorsingPunishmentNumerator   int64   `json:"doubleEndorsingPunishmentNumerator"`
-	DoubleEndorsingPunishmentDenominator int64   `json:"doubleEndorsingPunishmentDenominator"`
-	TxRollupOriginationSize              int64   `json:"txRollupOriginationSize"`
-	TxRollupCommitmentBond               int64   `json:"txRollupCommitmentBond"`
-	LbEscapeThreshold                    int64   `json:"lbEscapeThreshold"`
+	RampUpCycles                      int64   `json:"rampUpCycles"`
+	NoRewardCycles                    int64   `json:"noRewardCycles"`
+	ConsensusRightsDelay              int64   `json:"consensusRightsDelay"`
+	DelegateParametersActivationDelay int64   `json:"delegateParametersActivationDelay"`
+	BlocksPerCycle                    int64   `json:"blocksPerCycle"`
+	BlocksPerCommitment               int64   `json:"blocksPerCommitment"`
+	BlocksPerSnapshot                 int64   `json:"blocksPerSnapshot"`
+	BlocksPerVoting                   int64   `json:"blocksPerVoting"`
+	TimeBetweenBlocks                 int64   `json:"timeBetweenBlocks"`
+	AttestersPerBlock                 int64   `json:"attestersPerBlock"`
+	HardOperationGasLimit             int64   `json:"hardOperationGasLimit"`
+	HardOperationStorageLimit         int64   `json:"hardOperationStorageLimit"`
+	HardBlockGasLimit                 int64   `json:"hardBlockGasLimit"`
+	MinimalStake                      int64   `json:"minimalStake"`
+	MinimalFrozenStake                int64   `json:"minimalFrozenStake"`
+	BlockDeposit                      int64   `json:"blockDeposit"`
+	BlockReward                       []int64 `json:"blockReward"`
+	AttestationDeposit                int64   `json:"attestationDeposit"`
+	AttestationReward                 []int64 `json:"attestationReward"`
+	OriginationSize                   int64   `json:"originationSize"`
+	ByteCost                          int64   `json:"byteCost"`
+	ProposalQuorum                    int64   `json:"proposalQuorum"`
+	BallotQuorumMin                   int64   `json:"ballotQuorumMin"`
+	BallotQuorumMax                   int64   `json:"ballotQuorumMax"`
+	LbToggleThreshold                 int64   `json:"lbToggleThreshold"`
+	ConsensusThreshold                int64   `json:"consensusThreshold"`
+	MinParticipationNumerator         int64   `json:"minParticipationNumerator"`
+	MinParticipationDenominator       int64   `json:"minParticipationDenominator"`
+	DenunciationPeriod                int64   `json:"denunciationPeriod"`
+	SlashingDelay                     int64   `json:"slashingDelay"`
+	MaxDelegatedOverFrozenRatio       int64   `json:"maxDelegatedOverFrozenRatio"`
+	MaxExternalOverOwnStakeRatio      int64   `json:"maxExternalOverOwnStakeRatio"`
+	SmartRollupOriginationSize        int64   `json:"smartRollupOriginationSize"`
+	SmartRollupStakeAmount            int64   `json:"smartRollupStakeAmount"`
+	SmartRollupChallengeWindow        int64   `json:"smartRollupChallengeWindow"`
+	SmartRollupCommitmentPeriod       int64   `json:"smartRollupCommitmentPeriod"`
+	SmartRollupTimeoutPeriod          int64   `json:"smartRollupTimeoutPeriod"`
+	DalNumberOfShards                 int64   `json:"dalNumberOfShards"`
+	Dictator                          string  `json:"dictator"`
 }
 
-// ProtocolConstants -
+// ProtocolMetadata -
 type ProtocolMetadata struct {
 	Docs  string `json:"docs"`
 	Alias string `json:"alias"`
@@ -137,6 +139,5 @@ type Statistics struct {
 	TotalBanished     uint64    `json:"totalBanished"`
 	TotalFrozen       uint64    `json:"totalFrozen"`
 	TotalRollupBonds  uint64    `json:"totalRollupBonds"`
-	TotalVested       uint64    `json:"totalVested"`
 	Quote             *Quote    `json:"quote,omitempty"`
 }
diff --git a/tzkt/data/operations.go b/tzkt/data/operations.go
diff --git a/tzkt/events/tzkt.go b/tzkt/events/tzkt.go

Original file line number	Diff line number	Diff line change
`@@ -10,7 +10,7 @@ func (tzkt *API) AccountCounter(ctx context.Context, address string) (uint64, er`
`10`	`10`	`return tzkt.count(ctx, fmt.Sprintf("/v1/accounts/%s/counter", address), nil)`
`11`	`11`	`}`
`12`	`12`
`13`		`-// AccountCounter - Returns a number of accounts.`
	`13`	`+// AccountsCount - Returns a number of accounts.`
`14`	`14`	`func (tzkt *API) AccountsCount(ctx context.Context, filters map[string]string) (uint64, error) {`
`15`	`15`	`return tzkt.count(ctx, "/v1/accounts/count", filters)`
`16`	`16`	`}`