nara-sdk 1.0.65 → 1.0.67

package/index.ts

@@ -47,6 +47,8 @@ export {
   setStakeAuthority,
   makeAdjustFreeStakeIx,
   adjustFreeStake,
+  claimAirdrop,
+  setAirdropConfig,
   getQuestConfig,
   type QuestInfo,
   type StakeInfo,

package/package.json

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

package/src/idls/nara_quest.json

@@ -96,6 +96,164 @@
         }
       ]
     },
+    {
+      "name": "claim_airdrop",
+      "discriminator": [
+        137,
+        50,
+        122,
+        111,
+        89,
+        254,
+        8,
+        20
+      ],
+      "accounts": [
+        {
+          "name": "game_config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "pool",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  112,
+                  111,
+                  111,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "winner_record",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  119,
+                  105,
+                  110,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "user"
+              }
+            ]
+          }
+        },
+        {
+          "name": "airdrop_fund",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  97,
+                  105,
+                  114,
+                  100,
+                  114,
+                  111,
+                  112
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "user",
+          "writable": true
+        },
+        {
+          "name": "payer",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "proof_a",
+          "type": {
+            "array": [
+              "u8",
+              64
+            ]
+          }
+        },
+        {
+          "name": "proof_b",
+          "type": {
+            "array": [
+              "u8",
+              128
+            ]
+          }
+        },
+        {
+          "name": "proof_c",
+          "type": {
+            "array": [
+              "u8",
+              64
+            ]
+          }
+        }
+      ]
+    },
     {
       "name": "create_question",
       "discriminator": [
@@ -244,6 +402,61 @@
         }
       ]
     },
+    {
+      "name": "expand_config",
+      "discriminator": [
+        120,
+        201,
+        195,
+        128,
+        35,
+        202,
+        73,
+        161
+      ],
+      "accounts": [
+        {
+          "name": "game_config",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "additional_size",
+          "type": "u32"
+        }
+      ]
+    },
     {
       "name": "initialize",
       "discriminator": [
@@ -343,6 +556,60 @@
       ],
       "args": []
     },
+    {
+      "name": "set_airdrop_config",
+      "discriminator": [
+        255,
+        181,
+        252,
+        34,
+        155,
+        230,
+        65,
+        227
+      ],
+      "accounts": [
+        {
+          "name": "game_config",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "signer": true
+        }
+      ],
+      "args": [
+        {
+          "name": "airdrop_amount",
+          "type": "u64"
+        },
+        {
+          "name": "max_airdrop_count",
+          "type": "u32"
+        }
+      ]
+    },
     {
       "name": "set_quest_authority",
       "discriminator": [
@@ -1618,6 +1885,31 @@
       "code": 6017,
       "name": "FreeCreditsOverflow",
       "msg": "Free credits overflow"
+    },
+    {
+      "code": 6018,
+      "name": "AirdropNotEligible",
+      "msg": "Not eligible: must answer current round first"
+    },
+    {
+      "code": 6019,
+      "name": "AirdropMaxReached",
+      "msg": "Max airdrop count reached for this address"
+    },
+    {
+      "code": 6020,
+      "name": "AirdropCooldown",
+      "msg": "Must wait 24 hours between airdrop claims"
+    },
+    {
+      "code": 6021,
+      "name": "AirdropDisabled",
+      "msg": "Airdrop is disabled (amount = 0)"
+    },
+    {
+      "code": 6022,
+      "name": "InsufficientAirdrop",
+      "msg": "Airdrop fund has insufficient balance"
     }
   ],
   "types": [
@@ -1706,12 +1998,20 @@
             "name": "stake_authority",
             "type": "pubkey"
           },
+          {
+            "name": "airdrop_amount",
+            "type": "u64"
+          },
+          {
+            "name": "max_airdrop_count",
+            "type": "u32"
+          },
           {
             "name": "_padding",
             "type": {
               "array": [
                 "u8",
-                32
+                20
               ]
             }
           }
@@ -1826,12 +2126,20 @@
             "name": "round",
             "type": "u64"
           },
+          {
+            "name": "airdrop_count",
+            "type": "u32"
+          },
+          {
+            "name": "last_airdrop_ts",
+            "type": "i64"
+          },
           {
             "name": "_padding",
             "type": {
               "array": [
                 "u8",
-                64
+                52
               ]
             }
           }

package/src/idls/nara_quest.ts

@@ -102,6 +102,164 @@ export type NaraQuest = {
         }
       ]
     },
+    {
+      "name": "claimAirdrop",
+      "discriminator": [
+        137,
+        50,
+        122,
+        111,
+        89,
+        254,
+        8,
+        20
+      ],
+      "accounts": [
+        {
+          "name": "gameConfig",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "pool",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  112,
+                  111,
+                  111,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "winnerRecord",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  119,
+                  105,
+                  110,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "user"
+              }
+            ]
+          }
+        },
+        {
+          "name": "airdropFund",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  97,
+                  105,
+                  114,
+                  100,
+                  114,
+                  111,
+                  112
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "user",
+          "writable": true
+        },
+        {
+          "name": "payer",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "systemProgram",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "proofA",
+          "type": {
+            "array": [
+              "u8",
+              64
+            ]
+          }
+        },
+        {
+          "name": "proofB",
+          "type": {
+            "array": [
+              "u8",
+              128
+            ]
+          }
+        },
+        {
+          "name": "proofC",
+          "type": {
+            "array": [
+              "u8",
+              64
+            ]
+          }
+        }
+      ]
+    },
     {
       "name": "createQuestion",
       "discriminator": [
@@ -250,6 +408,61 @@ export type NaraQuest = {
         }
       ]
     },
+    {
+      "name": "expandConfig",
+      "discriminator": [
+        120,
+        201,
+        195,
+        128,
+        35,
+        202,
+        73,
+        161
+      ],
+      "accounts": [
+        {
+          "name": "gameConfig",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "systemProgram",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "additionalSize",
+          "type": "u32"
+        }
+      ]
+    },
     {
       "name": "initialize",
       "discriminator": [
@@ -349,6 +562,60 @@ export type NaraQuest = {
       ],
       "args": []
     },
+    {
+      "name": "setAirdropConfig",
+      "discriminator": [
+        255,
+        181,
+        252,
+        34,
+        155,
+        230,
+        65,
+        227
+      ],
+      "accounts": [
+        {
+          "name": "gameConfig",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "signer": true
+        }
+      ],
+      "args": [
+        {
+          "name": "airdropAmount",
+          "type": "u64"
+        },
+        {
+          "name": "maxAirdropCount",
+          "type": "u32"
+        }
+      ]
+    },
     {
       "name": "setQuestAuthority",
       "discriminator": [
@@ -1624,6 +1891,31 @@ export type NaraQuest = {
       "code": 6017,
       "name": "freeCreditsOverflow",
       "msg": "Free credits overflow"
+    },
+    {
+      "code": 6018,
+      "name": "airdropNotEligible",
+      "msg": "Not eligible: must answer current round first"
+    },
+    {
+      "code": 6019,
+      "name": "airdropMaxReached",
+      "msg": "Max airdrop count reached for this address"
+    },
+    {
+      "code": 6020,
+      "name": "airdropCooldown",
+      "msg": "Must wait 24 hours between airdrop claims"
+    },
+    {
+      "code": 6021,
+      "name": "airdropDisabled",
+      "msg": "Airdrop is disabled (amount = 0)"
+    },
+    {
+      "code": 6022,
+      "name": "insufficientAirdrop",
+      "msg": "Airdrop fund has insufficient balance"
     }
   ],
   "types": [
@@ -1712,12 +2004,20 @@ export type NaraQuest = {
             "name": "stakeAuthority",
             "type": "pubkey"
           },
+          {
+            "name": "airdropAmount",
+            "type": "u64"
+          },
+          {
+            "name": "maxAirdropCount",
+            "type": "u32"
+          },
           {
             "name": "padding",
             "type": {
               "array": [
                 "u8",
-                32
+                20
               ]
             }
           }
@@ -1832,12 +2132,20 @@ export type NaraQuest = {
             "name": "round",
             "type": "u64"
           },
+          {
+            "name": "airdropCount",
+            "type": "u32"
+          },
+          {
+            "name": "lastAirdropTs",
+            "type": "i64"
+          },
           {
             "name": "padding",
             "type": {
               "array": [
                 "u8",
-                64
+                52
               ]
             }
           }

package/src/quest.ts

@@ -853,6 +853,8 @@ export async function getQuestConfig(
   rewardPerShare: number;
   extraReward: number;
   stakeAuthority: PublicKey;
+  airdropAmount: number;
+  maxAirdropCount: number;
 }> {
   const kp = Keypair.generate();
   const program = createProgram(connection, kp, options?.programId);
@@ -875,6 +877,8 @@ export async function getQuestConfig(
     rewardPerShare: Number(config.rewardPerShare.toString()),
     extraReward: Number(config.extraReward.toString()),
     stakeAuthority: config.stakeAuthority,
+    airdropAmount: Number(config.airdropAmount.toString()),
+    maxAirdropCount: config.maxAirdropCount,
   };
 }
 
@@ -930,3 +934,43 @@ export async function adjustFreeStake(
   const ix = await makeAdjustFreeStakeIx(connection, wallet.publicKey, user, delta, reason, options);
   return sendTx(connection, wallet, [ix]);
 }
+
+/**
+ * Claim airdrop for a user. The payer pays for the transaction.
+ * @param user - The user to claim airdrop for
+ */
+export async function claimAirdrop(
+  connection: Connection,
+  wallet: Keypair,
+  user: PublicKey,
+  proof: ZkProof,
+  options?: QuestOptions
+): Promise<string> {
+  const program = createProgram(connection, wallet, options?.programId);
+  const ix = await program.methods
+    .claimAirdrop(proof.proofA as any, proof.proofB as any, proof.proofC as any)
+    .accounts({ user, payer: wallet.publicKey } as any)
+    .instruction();
+  return sendTx(connection, wallet, [ix]);
+}
+
+/**
+ * Set airdrop configuration (authority only).
+ * @param airdropAmount - Amount per airdrop in lamports
+ * @param maxAirdropCount - Maximum number of airdrops per user
+ */
+export async function setAirdropConfig(
+  connection: Connection,
+  wallet: Keypair,
+  airdropAmount: number | BN,
+  maxAirdropCount: number,
+  options?: QuestOptions
+): Promise<string> {
+  const program = createProgram(connection, wallet, options?.programId);
+  const amt = typeof airdropAmount === "number" ? new BN(airdropAmount) : airdropAmount;
+  const ix = await program.methods
+    .setAirdropConfig(amt, maxAirdropCount)
+    .accounts({ authority: wallet.publicKey } as any)
+    .instruction();
+  return sendTx(connection, wallet, [ix]);
+}