nara-sdk 1.0.83 → 1.0.84

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nara-sdk",
-  "version": "1.0.83",
+  "version": "1.0.84",
   "description": "SDK for the Nara chain (Solana-compatible)",
   "module": "index.ts",
   "main": "index.ts",

package/src/idls/nara_quest.json

@@ -761,6 +761,10 @@
         {
           "name": "max_reward_count",
           "type": "u32"
+        },
+        {
+          "name": "free_stake_multiplier",
+          "type": "u32"
         }
       ]
     },
@@ -1910,6 +1914,11 @@
       "code": 6022,
       "name": "InsufficientAirdrop",
       "msg": "Airdrop fund has insufficient balance"
+    },
+    {
+      "code": 6023,
+      "name": "InvalidMultiplier",
+      "msg": "Multiplier must be >= 1"
     }
   ],
   "types": [
@@ -2006,12 +2015,16 @@
             "name": "max_airdrop_count",
             "type": "u32"
           },
+          {
+            "name": "free_stake_multiplier",
+            "type": "u32"
+          },
           {
             "name": "_padding",
             "type": {
               "array": [
                 "u8",
-                20
+                16
               ]
             }
           }
@@ -2049,15 +2062,15 @@
             "type": "u64"
           },
           {
-            "name": "reward_count",
+            "name": "stake_reward_count",
             "type": "u32"
           },
           {
-            "name": "reward_per_winner",
+            "name": "stake_reward_per_winner",
             "type": "u64"
           },
           {
-            "name": "winner_count",
+            "name": "stake_winner_count",
             "type": "u32"
           },
           {
@@ -2080,12 +2093,24 @@
             "name": "avg_participant_stake",
             "type": "u64"
           },
+          {
+            "name": "free_reward_count",
+            "type": "u32"
+          },
+          {
+            "name": "free_reward_per_winner",
+            "type": "u64"
+          },
+          {
+            "name": "free_winner_count",
+            "type": "u32"
+          },
           {
             "name": "_padding",
             "type": {
               "array": [
                 "u8",
-                64
+                48
               ]
             }
           }

package/src/idls/nara_quest.ts

@@ -767,6 +767,10 @@ export type NaraQuest = {
         {
           "name": "maxRewardCount",
           "type": "u32"
+        },
+        {
+          "name": "freeStakeMultiplier",
+          "type": "u32"
         }
       ]
     },
@@ -1916,6 +1920,11 @@ export type NaraQuest = {
       "code": 6022,
       "name": "insufficientAirdrop",
       "msg": "Airdrop fund has insufficient balance"
+    },
+    {
+      "code": 6023,
+      "name": "invalidMultiplier",
+      "msg": "Multiplier must be >= 1"
     }
   ],
   "types": [
@@ -2012,12 +2021,16 @@ export type NaraQuest = {
             "name": "maxAirdropCount",
             "type": "u32"
           },
+          {
+            "name": "freeStakeMultiplier",
+            "type": "u32"
+          },
           {
             "name": "padding",
             "type": {
               "array": [
                 "u8",
-                20
+                16
               ]
             }
           }
@@ -2055,15 +2068,15 @@ export type NaraQuest = {
             "type": "u64"
           },
           {
-            "name": "rewardCount",
+            "name": "stakeRewardCount",
             "type": "u32"
           },
           {
-            "name": "rewardPerWinner",
+            "name": "stakeRewardPerWinner",
             "type": "u64"
           },
           {
-            "name": "winnerCount",
+            "name": "stakeWinnerCount",
             "type": "u32"
           },
           {
@@ -2086,12 +2099,24 @@ export type NaraQuest = {
             "name": "avgParticipantStake",
             "type": "u64"
           },
+          {
+            "name": "freeRewardCount",
+            "type": "u32"
+          },
+          {
+            "name": "freeRewardPerWinner",
+            "type": "u64"
+          },
+          {
+            "name": "freeWinnerCount",
+            "type": "u32"
+          },
           {
             "name": "padding",
             "type": {
               "array": [
                 "u8",
-                64
+                48
               ]
             }
           }

package/src/quest.ts

@@ -45,11 +45,18 @@ export interface QuestInfo {
   round: string;
   question: string;
   answerHash: number[];
-  rewardPerWinner: number;
+  /** Total reward pool for the round (stake + free), in NARA */
   totalReward: number;
-  rewardCount: number;
-  winnerCount: number;
-  remainingSlots: number;
+  /** Stake-gated reward bucket */
+  stakeRewardCount: number;
+  stakeWinnerCount: number;
+  stakeRewardPerWinner: number;
+  stakeRemainingSlots: number;
+  /** Credit (free-stake) reward bucket — consumed by stakeInfo.freeCredits */
+  creditRewardCount: number;
+  creditWinnerCount: number;
+  creditRewardPerWinner: number;
+  creditRemainingSlots: number;
   difficulty: number;
   deadline: number;
   timeRemaining: number;
@@ -323,16 +330,25 @@ export async function getQuestInfo(
     stakeHigh, stakeLow, createdAtMs, decayMs, nowMs
   );
 
+  const stakeRewardCount = pool.stakeRewardCount;
+  const stakeWinnerCount = pool.stakeWinnerCount;
+  const creditRewardCount = pool.freeRewardCount;
+  const creditWinnerCount = pool.freeWinnerCount;
+
   return {
     active,
     round: pool.round.toString(),
     question: pool.question,
     answerHash: Array.from(pool.answerHash),
-    rewardPerWinner: pool.rewardPerWinner.toNumber() / LAMPORTS_PER_SOL,
     totalReward: pool.rewardAmount.toNumber() / LAMPORTS_PER_SOL,
-    rewardCount: pool.rewardCount,
-    winnerCount: pool.winnerCount,
-    remainingSlots: Math.max(0, pool.rewardCount - pool.winnerCount),
+    stakeRewardCount,
+    stakeWinnerCount,
+    stakeRewardPerWinner: pool.stakeRewardPerWinner.toNumber() / LAMPORTS_PER_SOL,
+    stakeRemainingSlots: Math.max(0, stakeRewardCount - stakeWinnerCount),
+    creditRewardCount,
+    creditWinnerCount,
+    creditRewardPerWinner: pool.freeRewardPerWinner.toNumber() / LAMPORTS_PER_SOL,
+    creditRemainingSlots: Math.max(0, creditRewardCount - creditWinnerCount),
     difficulty: pool.difficulty,
     deadline,
     timeRemaining: secsLeft,
@@ -758,17 +774,21 @@ export async function initializeQuest(
 
 /**
  * Set the reward config (authority only).
+ *
+ * @param freeStakeMultiplier - Multiplier for users answering with free credits
+ *                              vs stake-based winners (must be >= 1).
  */
 export async function setRewardConfig(
   connection: Connection,
   wallet: Keypair,
   minRewardCount: number,
   maxRewardCount: number,
+  freeStakeMultiplier: number,
   options?: QuestOptions
 ): Promise<string> {
   const program = createProgram(connection, wallet, options?.programId);
   const ix = await program.methods
-    .setRewardConfig(minRewardCount, maxRewardCount)
+    .setRewardConfig(minRewardCount, maxRewardCount, freeStakeMultiplier)
     .accounts({ authority: wallet.publicKey } as any)
     .instruction();
   return sendTx(connection, wallet, [ix]);
@@ -888,6 +908,7 @@ export async function getQuestConfig(
   stakeAuthority: PublicKey;
   airdropAmount: number;
   maxAirdropCount: number;
+  freeStakeMultiplier: number;
 }> {
   const kp = Keypair.generate();
   const program = createProgram(connection, kp, options?.programId);
@@ -912,6 +933,7 @@ export async function getQuestConfig(
     stakeAuthority: config.stakeAuthority,
     airdropAmount: Number(config.airdropAmount.toString()),
     maxAirdropCount: config.maxAirdropCount,
+    freeStakeMultiplier: config.freeStakeMultiplier,
   };
 }