@star-factory/sdk-vault 1.0.1 → 1.0.2

package/dist/idl/vault.json

@@ -316,7 +316,7 @@
         },
         {
           "name": "platform_admin",
-          "address": "8JHcTK5rJNfGLffWbWgmi8yAPjxVz7F4zFC4gUqnVnx6"
+          "address": "381onZFBYxD8vmVV8BUjRKU8R236vDRych4Mu7PqdPXd"
         },
         {
           "name": "quote_token_program"
@@ -341,6 +341,64 @@
         }
       ]
     },
+    {
+      "name": "calculate_allocations",
+      "docs": [
+        "Calculate tier allocations after TGE acceptance.",
+        "Uses priority-fill algorithm: tier 3 (6mo) fills first, then 2, 1, 0.",
+        "Can only be called once."
+      ],
+      "discriminator": [
+        240,
+        205,
+        171,
+        45,
+        96,
+        41,
+        104,
+        89
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "vault.authority",
+                "account": "StarVault"
+              },
+              {
+                "kind": "arg",
+                "path": "seed"
+              }
+            ]
+          }
+        }
+      ],
+      "args": [
+        {
+          "name": "seed",
+          "type": "u64"
+        }
+      ]
+    },
     {
       "name": "claim_dust",
       "docs": [
@@ -1184,6 +1242,11 @@
     },
     {
       "name": "deposit",
+      "docs": [
+        "Deposit funds with vesting tier commitment.",
+        "tier: 0 = no lockup, 1 = 1 month, 2 = 3 months, 3 = 6 months",
+        "First deposit sets the tier; subsequent deposits must match or use upgrade_tier."
+      ],
       "discriminator": [
         242,
         35,
@@ -1407,7 +1470,7 @@
         },
         {
           "name": "platform_admin",
-          "address": "8JHcTK5rJNfGLffWbWgmi8yAPjxVz7F4zFC4gUqnVnx6"
+          "address": "381onZFBYxD8vmVV8BUjRKU8R236vDRych4Mu7PqdPXd"
         },
         {
           "name": "referrer",
@@ -1552,6 +1615,10 @@
         {
           "name": "amount",
           "type": "u64"
+        },
+        {
+          "name": "tier",
+          "type": "u8"
         }
       ]
     },
@@ -2296,7 +2363,7 @@
         },
         {
           "name": "platform_admin",
-          "address": "8JHcTK5rJNfGLffWbWgmi8yAPjxVz7F4zFC4gUqnVnx6"
+          "address": "381onZFBYxD8vmVV8BUjRKU8R236vDRych4Mu7PqdPXd"
         },
         {
           "name": "quote_token_program"
@@ -2538,6 +2605,123 @@
           "type": "u64"
         }
       ]
+    },
+    {
+      "name": "upgrade_tier",
+      "docs": [
+        "Upgrade vesting tier to a higher commitment (cannot downgrade).",
+        "Can only be done while vault is active."
+      ],
+      "discriminator": [
+        122,
+        56,
+        170,
+        60,
+        252,
+        234,
+        190,
+        51
+      ],
+      "accounts": [
+        {
+          "name": "user",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "vault.authority",
+                "account": "StarVault"
+              },
+              {
+                "kind": "account",
+                "path": "vault.seed",
+                "account": "StarVault"
+              }
+            ]
+          }
+        },
+        {
+          "name": "depositor_record",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  100,
+                  101,
+                  112,
+                  111,
+                  115,
+                  105,
+                  116,
+                  111,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "vault"
+              },
+              {
+                "kind": "account",
+                "path": "user"
+              }
+            ]
+          }
+        },
+        {
+          "name": "blacklist_entry",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  98,
+                  108,
+                  97,
+                  99,
+                  107,
+                  108,
+                  105,
+                  115,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "vault"
+              },
+              {
+                "kind": "account",
+                "path": "user"
+              }
+            ]
+          }
+        }
+      ],
+      "args": [
+        {
+          "name": "new_tier",
+          "type": "u8"
+        }
+      ]
     }
   ],
   "accounts": [
@@ -2607,6 +2791,19 @@
     }
   ],
   "events": [
+    {
+      "name": "AllocationsCalculatedEvent",
+      "discriminator": [
+        215,
+        191,
+        219,
+        120,
+        248,
+        220,
+        45,
+        224
+      ]
+    },
     {
       "name": "BlacklistEvent",
       "discriminator": [
@@ -2853,6 +3050,19 @@
         241,
         67
       ]
+    },
+    {
+      "name": "TierUpgradedEvent",
+      "discriminator": [
+        110,
+        162,
+        186,
+        192,
+        67,
+        172,
+        70,
+        140
+      ]
     }
   ],
   "errors": [
@@ -3100,9 +3310,86 @@
       "code": 6048,
       "name": "NoUnclaimedDust",
       "msg": "No unclaimed dust available to sweep"
+    },
+    {
+      "code": 6049,
+      "name": "InvalidTier",
+      "msg": "Invalid tier: must be 0-3"
+    },
+    {
+      "code": 6050,
+      "name": "TierMismatch",
+      "msg": "Tier mismatch: already deposited to a different tier"
+    },
+    {
+      "code": 6051,
+      "name": "CannotDowngradeTier",
+      "msg": "Cannot downgrade tier: only upgrades allowed"
+    },
+    {
+      "code": 6052,
+      "name": "AllocationsAlreadyCalculated",
+      "msg": "Allocations already calculated"
+    },
+    {
+      "code": 6053,
+      "name": "AllocationsNotCalculated",
+      "msg": "Allocations not yet calculated"
+    },
+    {
+      "code": 6054,
+      "name": "NoDepositToUpgrade",
+      "msg": "No deposit to upgrade"
     }
   ],
   "types": [
+    {
+      "name": "AllocationsCalculatedEvent",
+      "docs": [
+        "Emitted when admin calculates tier allocations after TGE"
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "vault",
+            "type": "pubkey"
+          },
+          {
+            "name": "tier_totals",
+            "docs": [
+              "Snapshot of tier totals at allocation time (used for pro-rata refunds)"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "tier_allocated",
+            "docs": [
+              "Allocated amount per tier (priority-fill from tier 6 down)"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "target_raise_amount",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
     {
       "name": "BlacklistEntry",
       "type": {
@@ -3200,6 +3487,10 @@
             "name": "amount",
             "type": "u64"
           },
+          {
+            "name": "tier",
+            "type": "u8"
+          },
           {
             "name": "user_total",
             "type": "u64"
@@ -3232,6 +3523,14 @@
             "name": "vault",
             "type": "pubkey"
           },
+          {
+            "name": "tier",
+            "docs": [
+              "Vesting tier (0-6): 0=immediate, 1=2wk, 2=4wk, 3=6wk, 4=8wk, 5=10wk, 6=12wk",
+              "Set on first deposit, can only be upgraded (not downgraded)"
+            ],
+            "type": "u8"
+          },
           {
             "name": "amount",
             "type": "u64"
@@ -3509,6 +3808,10 @@
             "name": "depositor",
             "type": "pubkey"
           },
+          {
+            "name": "tier",
+            "type": "u8"
+          },
           {
             "name": "original_amount",
             "type": "u64"
@@ -3910,6 +4213,65 @@
           {
             "name": "bump",
             "type": "u8"
+          },
+          {
+            "name": "tier_totals",
+            "docs": [
+              "Total deposits per tier: [tier0..tier6]",
+              "tier0 = immediate (0 weeks), tier1 = 2 weeks, tier2 = 4 weeks,",
+              "tier3 = 6 weeks, tier4 = 8 weeks, tier5 = 10 weeks, tier6 = 12 weeks"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "tier_depositor_counts",
+            "docs": [
+              "Number of unique depositors per tier"
+            ],
+            "type": {
+              "array": [
+                "u32",
+                7
+              ]
+            }
+          },
+          {
+            "name": "tier_allocated",
+            "docs": [
+              "Allocated amount per tier after calculate_allocations (0 until calculated)",
+              "Higher tiers get priority in allocation"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "tier_totals_at_allocation",
+            "docs": [
+              "Snapshot of tier_totals at allocation time (for consistent pro-rata refund calculation)",
+              "Using live tier_totals would cause inconsistent refunds as users claim sequentially"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "allocations_calculated",
+            "docs": [
+              "True once calculate_allocations has been called (prevents re-calculation)"
+            ],
+            "type": "bool"
           }
         ]
       }
@@ -3982,6 +4344,41 @@
         ]
       }
     },
+    {
+      "name": "TierUpgradedEvent",
+      "docs": [
+        "Emitted when a user upgrades their vesting tier commitment"
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "vault",
+            "type": "pubkey"
+          },
+          {
+            "name": "user",
+            "type": "pubkey"
+          },
+          {
+            "name": "old_tier",
+            "type": "u8"
+          },
+          {
+            "name": "new_tier",
+            "type": "u8"
+          },
+          {
+            "name": "amount",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
     {
       "name": "VaultStatus",
       "type": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@star-factory/sdk-vault",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "TypeScript SDK for Star Pro rata fundraise Contract ",
   "license": "MIT",
   "author": "Star star",