proof-of-take-sdk 3.0.17 → 3.1.1

package/dist/idl/proof_of_take.json

@@ -2053,7 +2053,96 @@
         },
         {
           "name": "user_token_account",
-          "writable": true
+          "docs": [
+            "User MIZD ATA (canonical). Created if missing; root admin pays."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "user"
+              },
+              {
+                "kind": "const",
+                "value": [
+                  6,
+                  221,
+                  246,
+                  225,
+                  215,
+                  101,
+                  161,
+                  147,
+                  217,
+                  203,
+                  225,
+                  70,
+                  206,
+                  235,
+                  121,
+                  172,
+                  28,
+                  180,
+                  133,
+                  237,
+                  95,
+                  91,
+                  55,
+                  145,
+                  58,
+                  140,
+                  245,
+                  133,
+                  126,
+                  255,
+                  0,
+                  169
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "mizd_mint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
         },
         {
           "name": "user",
@@ -2089,6 +2178,10 @@
         {
           "name": "referrer_tier",
           "type": "u8"
+        },
+        {
+          "name": "star",
+          "type": "bool"
         }
       ]
     },
@@ -3560,6 +3653,11 @@
       "code": 6050,
       "name": "InvalidSignupRewardsVaultTokenAccount",
       "msg": "Invalid signup rewards vault token account"
+    },
+    {
+      "code": 6051,
+      "name": "StarOnlyForCopperTier",
+      "msg": "Star join is only allowed for Copper tier"
     }
   ],
   "types": [
@@ -4465,6 +4563,13 @@
             ],
             "type": "u64"
           },
+          {
+            "name": "is_star",
+            "docs": [
+              "Star membership flag (admin-sponsored join flow)"
+            ],
+            "type": "bool"
+          },
           {
             "name": "total_penalties_paid",
             "docs": [

package/dist/instructions/joinSeason.d.ts

@@ -8,7 +8,6 @@ import { StandardInstructionResultWithPdas } from "../types/instructionResults";
 export interface JoinSeasonOptions {
     connection: Connection;
     user: PublicKey;
-    userTokenAccount: PublicKey;
     seasonNumber: BN;
     /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
     tier: TierNumber;
@@ -16,6 +15,8 @@ export interface JoinSeasonOptions {
     referrer?: PublicKey;
     /** Referrer's tier (required if referrer is provided; must match the tier they joined with) */
     referrerTier?: TierNumber;
+    /** If true, root admin funds join fee + deposit (currently only allowed for tier=0 on-chain). */
+    star?: boolean;
     /** Optional injected timestamp (seconds) for optimistic state calculation */
     now?: BN;
     feePayer?: PublicKey;

package/dist/instructions/joinSeason.js

@@ -36,6 +36,7 @@ async function joinSeason(options) {
         tier: options.tier,
     });
     const rootAdminTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, constants_1.ADMIN_PUBLIC_KEY);
+    const userMizdAta = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, options.user);
     const accounts = {
         seasonSettings: pdas.seasonSettings,
         season: pdas.season,
@@ -45,7 +46,8 @@ async function joinSeason(options) {
         mizdMint: constants_1.MIZD_TOKEN_MINT,
         rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
         rootAdminTokenAccount,
-        userTokenAccount: options.userTokenAccount,
+        // Always pass the canonical ATA; it may not exist yet (created on-chain with root admin as payer).
+        userTokenAccount: userMizdAta,
         user: options.user,
         associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
         tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
@@ -68,7 +70,7 @@ async function joinSeason(options) {
     const methodBuilder = program.methods
         // Anchor expects BN for u64 args.
         // referrerTier defaults to 0 if no referrer (ignored on-chain)
-        .joinSeason(options.seasonNumber, options.tier, referrer, options.referrerTier ?? 0)
+        .joinSeason(options.seasonNumber, options.tier, referrer, options.referrerTier ?? 0, options.star ?? false)
         .accounts(accounts);
     if (remainingAccounts.length > 0) {
         methodBuilder.remainingAccounts(remainingAccounts);
@@ -113,7 +115,7 @@ async function joinSeason(options) {
         }
         const depositEscrowed = perWindowPenalty.mul(joinedWindowNumber);
         const depositActive = depositFull.sub(depositEscrowed);
-        newSeasonMembership = (0, optimistic_1.initializeSeasonMembership)(options.user, options.seasonNumber, depositTier, options.referrer ?? web3_js_1.PublicKey.default, depositActive, depositEscrowed, now, joinedWindowNumber, bump);
+        newSeasonMembership = (0, optimistic_1.initializeSeasonMembership)(options.user, options.seasonNumber, depositTier, options.referrer ?? web3_js_1.PublicKey.default, depositActive, depositEscrowed, now, joinedWindowNumber, bump, options.star ?? false);
         if (curr.season) {
             updatedSeason = (0, optimistic_1.updateSeasonForJoin)(curr.season, depositActive, depositTier, joinedWindowNumber, totalWindows);
         }

package/dist/types/proof_of_take.d.ts

@@ -2059,7 +2059,96 @@ export type ProofOfTake = {
                 },
                 {
                     "name": "userTokenAccount";
+                    "docs": [
+                        "User MIZD ATA (canonical). Created if missing; root admin pays."
+                    ];
                     "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            },
+                            {
+                                "kind": "const";
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mizdMint";
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ];
+                        };
+                    };
                 },
                 {
                     "name": "user";
@@ -2095,6 +2184,10 @@ export type ProofOfTake = {
                 {
                     "name": "referrerTier";
                     "type": "u8";
+                },
+                {
+                    "name": "star";
+                    "type": "bool";
                 }
             ];
         },
@@ -3566,6 +3659,11 @@ export type ProofOfTake = {
             "code": 6050;
             "name": "invalidSignupRewardsVaultTokenAccount";
             "msg": "Invalid signup rewards vault token account";
+        },
+        {
+            "code": 6051;
+            "name": "starOnlyForCopperTier";
+            "msg": "Star join is only allowed for Copper tier";
         }
     ];
     "types": [
@@ -4471,6 +4569,13 @@ export type ProofOfTake = {
                         ];
                         "type": "u64";
                     },
+                    {
+                        "name": "isStar";
+                        "docs": [
+                            "Star membership flag (admin-sponsored join flow)"
+                        ];
+                        "type": "bool";
+                    },
                     {
                         "name": "totalPenaltiesPaid";
                         "docs": [

package/dist/types.d.ts

@@ -180,6 +180,12 @@ export interface SeasonMembership {
     joinedWindowNumber: BN;
     successfulPostsCount: BN;
     totalRewardsClaimed: BN;
+    /** Total signup referral rewards accrued for this membership. */
+    totalSignupRewards: BN;
+    /** Remaining (unclaimed) signup referral rewards for this membership. */
+    remainingSignupRewards: BN;
+    /** Star membership flag (admin-sponsored join flow). */
+    isStar: boolean;
     totalPenaltiesPaid: BN;
     /** Whether the user has already withdrawn their season deposit (prevents double-withdraw). */
     depositWithdrawn: boolean;

package/dist/utils/accountConverters.js

@@ -102,6 +102,9 @@ function toSdkSeasonMembership(a) {
         joinedWindowNumber: a.joinedWindowNumber,
         successfulPostsCount: a.successfulPostsCount,
         totalRewardsClaimed: a.totalRewardsClaimed,
+        totalSignupRewards: a.totalSignupRewards,
+        remainingSignupRewards: a.remainingSignupRewards,
+        isStar: a.isStar,
         totalPenaltiesPaid: a.totalPenaltiesPaid,
         depositWithdrawn: a.depositWithdrawn,
         isActive: a.isActive,

package/dist/utils/accountUpdates.d.ts

@@ -134,7 +134,7 @@ export declare function updateMiztakeForSeasonUse(miztake: Miztake, seasonNumber
  * @param joinedWindowNumber - Window number when joined
  * @returns Initialized SeasonMembership object
  */
-export declare function initializeSeasonMembership(user: PublicKey, seasonNumber: BN, depositTier: SeasonDepositTier, referrer: PublicKey, depositAmount: BN, depositEscrowedAmount: BN, joinedAt: BN, joinedWindowNumber: BN, bump: number): SeasonMembership;
+export declare function initializeSeasonMembership(user: PublicKey, seasonNumber: BN, depositTier: SeasonDepositTier, referrer: PublicKey, depositAmount: BN, depositEscrowedAmount: BN, joinedAt: BN, joinedWindowNumber: BN, bump: number, isStar?: boolean): SeasonMembership;
 /**
  * Update Season after a user joins
  * Mirrors the update from join_season.rs (lines 98-104)

package/dist/utils/accountUpdates.js

@@ -264,7 +264,7 @@ function updateMiztakeForSeasonUse(miztake, seasonNumber, windowNumber) {
  * @param joinedWindowNumber - Window number when joined
  * @returns Initialized SeasonMembership object
  */
-function initializeSeasonMembership(user, seasonNumber, depositTier, referrer, depositAmount, depositEscrowedAmount, joinedAt, joinedWindowNumber, bump) {
+function initializeSeasonMembership(user, seasonNumber, depositTier, referrer, depositAmount, depositEscrowedAmount, joinedAt, joinedWindowNumber, bump, isStar = false) {
     return {
         owner: user,
         referrer,
@@ -277,6 +277,9 @@ function initializeSeasonMembership(user, seasonNumber, depositTier, referrer, d
         joinedWindowNumber,
         successfulPostsCount: new anchor_1.BN(0),
         totalRewardsClaimed: new anchor_1.BN(0),
+        totalSignupRewards: new anchor_1.BN(0),
+        remainingSignupRewards: new anchor_1.BN(0),
+        isStar,
         totalPenaltiesPaid: new anchor_1.BN(0),
         depositWithdrawn: false,
         isActive: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proof-of-take-sdk",
-  "version": "3.0.17",
+  "version": "3.1.1",
   "description": "TypeScript SDK for Proof of Take Solana program",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",