@wireio/stake 0.1.0 → 0.1.2

package/src/assets/solana/types/validator_leaderboard.ts

@@ -5,7 +5,7 @@
  * IDL can be found at `target/idl/validator_leaderboard.json`.
  */
 export type ValidatorLeaderboard = {
-  "address": "CYxrJjaraGmdVjnB6EDNyx73pz9Lk2dqpaVtysNo7EXj",
+  "address": "5Nf6jL5B2qkMbnLoN3RTT1sKcBKrrsRnovTBDZXcQnfo",
   "metadata": {
     "name": "validatorLeaderboard",
     "version": "0.1.0",
@@ -14,16 +14,16 @@ export type ValidatorLeaderboard = {
   },
   "instructions": [
     {
-      "name": "initialize",
+      "name": "initializeLeaderboard",
       "discriminator": [
-        175,
-        175,
-        109,
-        31,
-        13,
-        152,
-        155,
-        237
+        47,
+        23,
+        34,
+        39,
+        46,
+        108,
+        91,
+        176
       ],
       "accounts": [
         {
@@ -32,40 +32,39 @@ export type ValidatorLeaderboard = {
           "signer": true
         },
         {
-          "name": "leaderboardHead",
-          "docs": [
-            "HEAD node - points to the highest VPP validator"
-          ],
+          "name": "leaderboardState",
+          "writable": true
+        },
+        {
+          "name": "systemProgram"
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "reallocLeaderboard",
+      "discriminator": [
+        2,
+        70,
+        106,
+        94,
+        81,
+        225,
+        113,
+        152
+      ],
+      "accounts": [
+        {
+          "name": "leaderboardState",
+          "writable": true
+        },
+        {
+          "name": "payer",
           "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  108,
-                  101,
-                  97,
-                  100,
-                  101,
-                  114,
-                  98,
-                  111,
-                  97,
-                  114,
-                  100,
-                  95,
-                  104,
-                  101,
-                  97,
-                  100
-                ]
-              }
-            ]
-          }
+          "signer": true
         },
         {
-          "name": "systemProgram",
-          "address": "11111111111111111111111111111111"
+          "name": "systemProgram"
         }
       ],
       "args": []
@@ -93,124 +92,40 @@ export type ValidatorLeaderboard = {
         },
         {
           "name": "validatorRecord",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  118,
-                  97,
-                  108,
-                  105,
-                  100,
-                  97,
-                  116,
-                  111,
-                  114
-                ]
-              },
-              {
-                "kind": "account",
-                "path": "voteAccount"
-              }
-            ]
-          }
+          "writable": true
         },
         {
-          "name": "systemProgram",
-          "address": "11111111111111111111111111111111"
+          "name": "systemProgram"
         }
       ],
       "args": []
     },
     {
-      "name": "updateTop10Cache",
+      "name": "updateMevCommission",
       "discriminator": [
-        0,
-        35,
-        58,
-        64,
-        74,
-        12,
-        249,
-        209
+        107,
+        65,
+        238,
+        108,
+        183,
+        47,
+        236,
+        203
       ],
       "accounts": [
         {
-          "name": "payer",
-          "writable": true,
+          "name": "signer",
           "signer": true
         },
         {
-          "name": "cache",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  116,
-                  111,
-                  112,
-                  95,
-                  49,
-                  48,
-                  95,
-                  99,
-                  97,
-                  99,
-                  104,
-                  101
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "leaderboardHead",
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  108,
-                  101,
-                  97,
-                  100,
-                  101,
-                  114,
-                  98,
-                  111,
-                  97,
-                  114,
-                  100,
-                  95,
-                  104,
-                  101,
-                  97,
-                  100
-                ]
-              }
-            ]
-          }
+          "name": "validatorRecord",
+          "writable": true
         },
         {
-          "name": "systemProgram",
-          "address": "11111111111111111111111111111111"
+          "name": "tipDistributionAccount"
         }
       ],
-      "args": [
-        {
-          "name": "top10",
-          "type": {
-            "array": [
-              "pubkey",
-              10
-            ]
-          }
-        }
-      ]
+      "args": []
     },
     {
       "name": "updateValidator",
@@ -235,117 +150,40 @@ export type ValidatorLeaderboard = {
         },
         {
           "name": "validatorRecord",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  118,
-                  97,
-                  108,
-                  105,
-                  100,
-                  97,
-                  116,
-                  111,
-                  114
-                ]
-              },
-              {
-                "kind": "account",
-                "path": "voteAccount"
-              }
-            ]
-          }
-        },
-        {
-          "name": "leaderboardHead",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  108,
-                  101,
-                  97,
-                  100,
-                  101,
-                  114,
-                  98,
-                  111,
-                  97,
-                  114,
-                  100,
-                  95,
-                  104,
-                  101,
-                  97,
-                  100
-                ]
-              }
-            ]
-          }
+          "writable": true
         },
         {
-          "name": "insertAfter",
-          "writable": true,
-          "optional": true
+          "name": "leaderboardState",
+          "writable": true
         },
         {
-          "name": "insertBefore",
-          "writable": true,
-          "optional": true
-        },
-        {
-          "name": "currentPrev",
-          "writable": true,
-          "optional": true
-        },
-        {
-          "name": "currentNext",
-          "writable": true,
-          "optional": true
-        },
-        {
-          "name": "systemProgram",
-          "address": "11111111111111111111111111111111"
+          "name": "systemProgram"
         }
       ],
       "args": [
         {
           "name": "vpp",
           "type": "u64"
+        },
+        {
+          "name": "proposedRank",
+          "type": "u16"
         }
       ]
     }
   ],
   "accounts": [
     {
-      "name": "leaderboardHead",
+      "name": "leaderboardState",
       "discriminator": [
-        159,
-        158,
-        16,
-        9,
-        41,
-        114,
-        23,
-        157
-      ]
-    },
-    {
-      "name": "top10Cache",
-      "discriminator": [
-        112,
-        78,
+        211,
+        181,
+        29,
+        120,
         189,
-        26,
-        143,
-        41,
-        15,
-        81
+        4,
+        106,
+        111
       ]
     },
     {
@@ -452,71 +290,207 @@ export type ValidatorLeaderboard = {
       "code": 6017,
       "name": "commissionNotUpdated",
       "msg": "Commission must be updated for current epoch before updating validator"
+    },
+    {
+      "code": 6018,
+      "name": "mevCommissionNotUpdated",
+      "msg": "MEV commission must be updated for current epoch before updating validator"
+    },
+    {
+      "code": 6019,
+      "name": "invalidCurrentNeighbor",
+      "msg": "Current neighbor account doesn't match validator's stored links"
+    },
+    {
+      "code": 6020,
+      "name": "nonAdjacentInsertionPosition",
+      "msg": "Insertion position accounts are not actually adjacent in leaderboard"
+    },
+    {
+      "code": 6021,
+      "name": "staleAccountReference",
+      "msg": "Account reference is outdated due to concurrent update"
+    },
+    {
+      "code": 6022,
+      "name": "invalidStakeAmount",
+      "msg": "Invalid stake amount - exceeds maximum allowed"
+    },
+    {
+      "code": 6023,
+      "name": "invalidTipDistributionAccount",
+      "msg": "Invalid Tip Distribution Account provided"
+    },
+    {
+      "code": 6024,
+      "name": "invalidRankPosition",
+      "msg": "Proposed rank position violates sorted ordering"
+    },
+    {
+      "code": 6025,
+      "name": "leaderboardFull",
+      "msg": "Leaderboard is full - cannot add more validators"
+    },
+    {
+      "code": 6026,
+      "name": "validatorNotInRankings",
+      "msg": "Validator not found in rankings"
+    },
+    {
+      "code": 6027,
+      "name": "arithmeticOverflow",
+      "msg": "Arithmetic overflow"
     }
   ],
   "types": [
     {
-      "name": "leaderboardHead",
+      "name": "leaderboardState",
       "docs": [
-        "Special HEAD node for the linked list"
+        "Central leaderboard state using parallel arrays for efficient ranking and CPI access",
+        "Stores VPP scores and sorted rankings for up to 1024 validators",
+        "Uses zero-copy for efficient access from other programs via CPI"
       ],
+      "serialization": "bytemuck",
+      "repr": {
+        "kind": "c"
+      },
       "type": {
         "kind": "struct",
         "fields": [
           {
-            "name": "nextValidator",
-            "type": "pubkey"
+            "name": "scores",
+            "docs": [
+              "VPP scores indexed by registry_index",
+              "registry_index is assigned on first validator registration and never changes"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                1024
+              ]
+            }
+          },
+          {
+            "name": "sortedIndices",
+            "docs": [
+              "Validator indices sorted by VPP score descending",
+              "sorted_indices[0] = registry_index of highest VPP validator",
+              "sorted_indices[1] = registry_index of 2nd highest VPP validator, etc."
+            ],
+            "type": {
+              "array": [
+                "u16",
+                1024
+              ]
+            }
+          },
+          {
+            "name": "voteAccounts",
+            "docs": [
+              "Vote account pubkeys indexed by registry_index",
+              "Allows CPI callers to get vote accounts for top N validators"
+            ],
+            "type": {
+              "array": [
+                {
+                  "defined": {
+                    "name": "pubkeyBytes"
+                  }
+                },
+                1024
+              ]
+            }
+          },
+          {
+            "name": "numValidators",
+            "docs": [
+              "Number of active validators currently in the leaderboard"
+            ],
+            "type": "u16"
           },
           {
             "name": "bump",
+            "docs": [
+              "PDA bump seed"
+            ],
             "type": "u8"
+          },
+          {
+            "name": "padding",
+            "docs": [
+              "Reserved space for future upgrades"
+            ],
+            "type": {
+              "array": [
+                "u8",
+                5
+              ]
+            }
           }
         ]
       }
     },
     {
-      "name": "top10Cache",
+      "name": "pubkeyBytes",
       "docs": [
-        "Cache for the top 10 validators for fast CPI access"
+        "Fixed-size representation of a `Pubkey` that satisfies Anchor's zero-copy rules.",
+        "Stores the raw 32-byte array and offers helpers to convert to/from `Pubkey`."
       ],
+      "serialization": "bytemuck",
+      "repr": {
+        "kind": "transparent"
+      },
       "type": {
         "kind": "struct",
         "fields": [
           {
-            "name": "validators",
+            "name": "bytes",
             "type": {
               "array": [
-                "pubkey",
-                10
+                "u8",
+                32
               ]
             }
-          },
-          {
-            "name": "lastUpdatedSlot",
-            "type": "u64"
-          },
-          {
-            "name": "bump",
-            "type": "u8"
           }
         ]
       }
     },
     {
       "name": "validatorRecord",
+      "docs": [
+        "Per-validator record account storing commission data and metadata"
+      ],
       "type": {
         "kind": "struct",
         "fields": [
           {
             "name": "voteAccount",
+            "docs": [
+              "The validator's vote account pubkey"
+            ],
             "type": "pubkey"
           },
+          {
+            "name": "registryIndex",
+            "docs": [
+              "Immutable index into LeaderboardState arrays",
+              "Assigned on first registration, never changes"
+            ],
+            "type": "u16"
+          },
           {
             "name": "creditsObserved",
+            "docs": [
+              "Current cumulative credits from vote account"
+            ],
             "type": "u64"
           },
           {
             "name": "commissionHistory",
+            "docs": [
+              "Circular buffer of past 10 commission values (0-100)",
+              "Used to penalize validators who increase commission"
+            ],
             "type": {
               "array": [
                 "u8",
@@ -526,46 +500,77 @@ export type ValidatorLeaderboard = {
           },
           {
             "name": "commissionIndex",
+            "docs": [
+              "Current index in commission_history circular buffer (0-9)"
+            ],
             "type": "u8"
           },
           {
             "name": "lastCommissionUpdate",
+            "docs": [
+              "Last epoch when commission was updated"
+            ],
             "type": "u64"
           },
           {
             "name": "epoch",
+            "docs": [
+              "Last epoch this validator was updated"
+            ],
             "type": "u64"
           },
           {
             "name": "slot",
+            "docs": [
+              "Last slot this validator was updated"
+            ],
             "type": "u64"
           },
           {
-            "name": "performance",
-            "type": "u64"
+            "name": "wireOperator",
+            "docs": [
+              "Whether this validator is a Wire operator (5% bonus)"
+            ],
+            "type": "bool"
           },
           {
-            "name": "stake",
-            "type": "u64"
+            "name": "mevCommission",
+            "docs": [
+              "Current MEV commission in basis points"
+            ],
+            "type": "u16"
           },
           {
-            "name": "registrant",
-            "type": "pubkey"
-          },
-          {
-            "name": "wireOperator",
-            "type": "bool"
+            "name": "mevCommissionHistory",
+            "docs": [
+              "Circular buffer of past 10 MEV commission values"
+            ],
+            "type": {
+              "array": [
+                "u16",
+                10
+              ]
+            }
           },
           {
-            "name": "nextValidator",
-            "type": "pubkey"
+            "name": "mevCommissionIndex",
+            "docs": [
+              "Current index in mev_commission_history circular buffer (0-9)"
+            ],
+            "type": "u8"
           },
           {
-            "name": "prevValidator",
-            "type": "pubkey"
+            "name": "lastMevCommissionUpdate",
+            "docs": [
+              "Last epoch when MEV commission was updated"
+            ],
+            "type": "u64"
           },
           {
             "name": "bump",
+            "docs": [
+              "PDA bump seed"
+            ],
             "type": "u8"
           }
         ]

package/src/index.ts

@@ -1,6 +1,3 @@
-// Export all utilities from the utils module
-export * from './common/utils';
-
 // Staker utilities
 export * from './staker/staker';
 export * from './staker/types';
@@ -13,6 +10,7 @@ export * as ETH from './networks/ethereum/types';
 export * from './networks/solana/solana';
 export * from './networks/solana/constants';
 export * as SOL from './networks/solana/types';
+export * from './networks/solana/utils';
 
 // CLIENTS
 export * from './networks/solana/clients/deposit.client';