nara-sdk 1.0.64 → 1.0.66

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.64",
+  "version": "1.0.66",
   "description": "SDK for the Nara chain (Solana-compatible)",
   "module": "index.ts",
   "main": "index.ts",

package/src/agent_registry.ts

@@ -411,8 +411,8 @@ export async function getConfig(
   registerFee: number;
   pointsSelf: number;
   pointsReferral: number;
-  referralRegisterFee: number;
-  referralFeeShare: number;
+  referralDiscountBps: number;
+  referralShareBps: number;
   referralRegisterPoints: number;
   activityReward: number;
   referralActivityReward: number;
@@ -422,6 +422,9 @@ export async function getConfig(
   twitterVerificationPoints: number;
   tweetVerifyReward: number;
   tweetVerifyPoints: number;
+  registerFee7: number;
+  registerFee6: number;
+  registerFee5: number;
 }> {
   const pid = new PublicKey(options?.programId ?? DEFAULT_AGENT_REGISTRY_PROGRAM_ID);
   const configPda = getConfigPda(pid);
@@ -439,8 +442,8 @@ export async function getConfig(
   const registerFee = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const pointsSelf = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const pointsReferral = Number(buf.readBigUInt64LE(offset)); offset += 8;
-  const referralRegisterFee = Number(buf.readBigUInt64LE(offset)); offset += 8;
-  const referralFeeShare = Number(buf.readBigUInt64LE(offset)); offset += 8;
+  const referralDiscountBps = Number(buf.readBigUInt64LE(offset)); offset += 8;
+  const referralShareBps = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const referralRegisterPoints = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const activityReward = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const referralActivityReward = Number(buf.readBigUInt64LE(offset)); offset += 8;
@@ -449,8 +452,11 @@ export async function getConfig(
   const twitterVerificationReward = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const twitterVerificationPoints = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const tweetVerifyReward = Number(buf.readBigUInt64LE(offset)); offset += 8;
-  const tweetVerifyPoints = Number(buf.readBigUInt64LE(offset));
-  return { admin, feeVault, pointMint, refereeMint, refereeActivityMint, registerFee, pointsSelf, pointsReferral, referralRegisterFee, referralFeeShare, referralRegisterPoints, activityReward, referralActivityReward, twitterVerifier, twitterVerificationFee, twitterVerificationReward, twitterVerificationPoints, tweetVerifyReward, tweetVerifyPoints };
+  const tweetVerifyPoints = Number(buf.readBigUInt64LE(offset)); offset += 8;
+  const registerFee7 = Number(buf.readBigUInt64LE(offset)); offset += 8;
+  const registerFee6 = Number(buf.readBigUInt64LE(offset)); offset += 8;
+  const registerFee5 = Number(buf.readBigUInt64LE(offset));
+  return { admin, feeVault, pointMint, refereeMint, refereeActivityMint, registerFee, pointsSelf, pointsReferral, referralDiscountBps, referralShareBps, referralRegisterPoints, activityReward, referralActivityReward, twitterVerifier, twitterVerificationFee, twitterVerificationReward, twitterVerificationPoints, tweetVerifyReward, tweetVerifyPoints, registerFee7, registerFee6, registerFee5 };
 }
 
 // ─── Agent CRUD ─────────────────────────────────────────────────
@@ -1004,13 +1010,19 @@ export async function withdrawFees(
 export async function updateRegisterFee(
   connection: Connection,
   wallet: Keypair,
-  newFee: number | BN,
+  fee: number | BN,
+  fee7: number | BN,
+  fee6: number | BN,
+  fee5: number | BN,
   options?: AgentRegistryOptions
 ): Promise<string> {
   const program = createProgram(connection, wallet, options?.programId);
-  const fee = typeof newFee === "number" ? new BN(newFee) : newFee;
+  const f = typeof fee === "number" ? new BN(fee) : fee;
+  const f7 = typeof fee7 === "number" ? new BN(fee7) : fee7;
+  const f6 = typeof fee6 === "number" ? new BN(fee6) : fee6;
+  const f5 = typeof fee5 === "number" ? new BN(fee5) : fee5;
   const ix = await program.methods
-    .updateRegisterFee(fee)
+    .updateRegisterFee(f, f7, f6, f5)
     .accounts({ admin: wallet.publicKey } as any)
     .instruction();
   return sendTx(connection, wallet, [ix]);
@@ -1046,17 +1058,17 @@ export async function updatePointsConfig(
 export async function updateReferralConfig(
   connection: Connection,
   wallet: Keypair,
-  referralRegisterFee: number | BN,
-  referralFeeShare: number | BN,
+  referralDiscountBps: number | BN,
+  referralShareBps: number | BN,
   referralRegisterPoints: number | BN,
   options?: AgentRegistryOptions
 ): Promise<string> {
   const program = createProgram(connection, wallet, options?.programId);
-  const fee = typeof referralRegisterFee === "number" ? new BN(referralRegisterFee) : referralRegisterFee;
-  const share = typeof referralFeeShare === "number" ? new BN(referralFeeShare) : referralFeeShare;
+  const discount = typeof referralDiscountBps === "number" ? new BN(referralDiscountBps) : referralDiscountBps;
+  const share = typeof referralShareBps === "number" ? new BN(referralShareBps) : referralShareBps;
   const pts = typeof referralRegisterPoints === "number" ? new BN(referralRegisterPoints) : referralRegisterPoints;
   const ix = await program.methods
-    .updateReferralConfig(fee, share, pts)
+    .updateReferralConfig(discount, share, pts)
     .accounts({ admin: wallet.publicKey } as any)
     .instruction();
   return sendTx(connection, wallet, [ix]);

package/src/idls/nara_agent_registry.json

@@ -3290,11 +3290,11 @@
       ],
       "args": [
         {
-          "name": "referral_register_fee",
+          "name": "referral_discount_bps",
           "type": "u64"
         },
         {
-          "name": "referral_fee_share",
+          "name": "referral_share_bps",
           "type": "u64"
         },
         {
@@ -3345,7 +3345,19 @@
       ],
       "args": [
         {
-          "name": "new_fee",
+          "name": "fee",
+          "type": "u64"
+        },
+        {
+          "name": "fee_7",
+          "type": "u64"
+        },
+        {
+          "name": "fee_6",
+          "type": "u64"
+        },
+        {
+          "name": "fee_5",
           "type": "u64"
         }
       ]
@@ -4154,6 +4166,32 @@
         74,
         39
       ]
+    },
+    {
+      "name": "TwitterBindRequested",
+      "discriminator": [
+        251,
+        254,
+        188,
+        154,
+        25,
+        126,
+        76,
+        169
+      ]
+    },
+    {
+      "name": "TwitterBindResult",
+      "discriminator": [
+        4,
+        160,
+        91,
+        219,
+        142,
+        73,
+        75,
+        215
+      ]
     }
   ],
   "errors": [
@@ -4386,6 +4424,11 @@
       "code": 6045,
       "name": "TweetAlreadyApproved",
       "msg": "Tweet has already been approved"
+    },
+    {
+      "code": 6046,
+      "name": "AgentIdReserved",
+      "msg": "Agent ID length <= 4 is reserved for admin only"
     }
   ],
   "types": [
@@ -4675,11 +4718,11 @@
             "type": "u64"
           },
           {
-            "name": "referral_register_fee",
+            "name": "referral_discount_bps",
             "type": "u64"
           },
           {
-            "name": "referral_fee_share",
+            "name": "referral_share_bps",
             "type": "u64"
           },
           {
@@ -4718,6 +4761,18 @@
             "name": "tweet_verify_points",
             "type": "u64"
           },
+          {
+            "name": "register_fee_7",
+            "type": "u64"
+          },
+          {
+            "name": "register_fee_6",
+            "type": "u64"
+          },
+          {
+            "name": "register_fee_5",
+            "type": "u64"
+          },
           {
             "name": "_reserved",
             "type": {
@@ -4735,15 +4790,6 @@
                 96
               ]
             }
-          },
-          {
-            "name": "_reserved3",
-            "type": {
-              "array": [
-                "u8",
-                24
-              ]
-            }
           }
         ]
       }
@@ -4907,6 +4953,78 @@
         ]
       }
     },
+    {
+      "name": "TwitterBindRequested",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "agent_id",
+            "type": "string"
+          },
+          {
+            "name": "authority",
+            "type": "pubkey"
+          },
+          {
+            "name": "username",
+            "type": "string"
+          },
+          {
+            "name": "fee",
+            "type": "u64"
+          },
+          {
+            "name": "is_first_bind",
+            "type": "bool"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "TwitterBindResult",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "agent_id",
+            "type": "string"
+          },
+          {
+            "name": "authority",
+            "type": "pubkey"
+          },
+          {
+            "name": "username",
+            "type": "string"
+          },
+          {
+            "name": "approved",
+            "type": "bool"
+          },
+          {
+            "name": "fee_refunded",
+            "type": "u64"
+          },
+          {
+            "name": "reward",
+            "type": "u64"
+          },
+          {
+            "name": "points",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
     {
       "name": "TwitterHandle",
       "serialization": "bytemuck",

package/src/idls/nara_agent_registry.ts

@@ -3296,11 +3296,11 @@ export type NaraAgentRegistry = {
       ],
       "args": [
         {
-          "name": "referralRegisterFee",
+          "name": "referralDiscountBps",
           "type": "u64"
         },
         {
-          "name": "referralFeeShare",
+          "name": "referralShareBps",
           "type": "u64"
         },
         {
@@ -3351,7 +3351,19 @@ export type NaraAgentRegistry = {
       ],
       "args": [
         {
-          "name": "newFee",
+          "name": "fee",
+          "type": "u64"
+        },
+        {
+          "name": "fee7",
+          "type": "u64"
+        },
+        {
+          "name": "fee6",
+          "type": "u64"
+        },
+        {
+          "name": "fee5",
           "type": "u64"
         }
       ]
@@ -4160,6 +4172,32 @@ export type NaraAgentRegistry = {
         74,
         39
       ]
+    },
+    {
+      "name": "twitterBindRequested",
+      "discriminator": [
+        251,
+        254,
+        188,
+        154,
+        25,
+        126,
+        76,
+        169
+      ]
+    },
+    {
+      "name": "twitterBindResult",
+      "discriminator": [
+        4,
+        160,
+        91,
+        219,
+        142,
+        73,
+        75,
+        215
+      ]
     }
   ],
   "errors": [
@@ -4392,6 +4430,11 @@ export type NaraAgentRegistry = {
       "code": 6045,
       "name": "tweetAlreadyApproved",
       "msg": "Tweet has already been approved"
+    },
+    {
+      "code": 6046,
+      "name": "agentIdReserved",
+      "msg": "Agent ID length <= 4 is reserved for admin only"
     }
   ],
   "types": [
@@ -4681,11 +4724,11 @@ export type NaraAgentRegistry = {
             "type": "u64"
           },
           {
-            "name": "referralRegisterFee",
+            "name": "referralDiscountBps",
             "type": "u64"
           },
           {
-            "name": "referralFeeShare",
+            "name": "referralShareBps",
             "type": "u64"
           },
           {
@@ -4724,6 +4767,18 @@ export type NaraAgentRegistry = {
             "name": "tweetVerifyPoints",
             "type": "u64"
           },
+          {
+            "name": "registerFee7",
+            "type": "u64"
+          },
+          {
+            "name": "registerFee6",
+            "type": "u64"
+          },
+          {
+            "name": "registerFee5",
+            "type": "u64"
+          },
           {
             "name": "reserved",
             "type": {
@@ -4741,15 +4796,6 @@ export type NaraAgentRegistry = {
                 96
               ]
             }
-          },
-          {
-            "name": "reserved3",
-            "type": {
-              "array": [
-                "u8",
-                24
-              ]
-            }
           }
         ]
       }
@@ -4913,6 +4959,78 @@ export type NaraAgentRegistry = {
         ]
       }
     },
+    {
+      "name": "twitterBindRequested",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "agentId",
+            "type": "string"
+          },
+          {
+            "name": "authority",
+            "type": "pubkey"
+          },
+          {
+            "name": "username",
+            "type": "string"
+          },
+          {
+            "name": "fee",
+            "type": "u64"
+          },
+          {
+            "name": "isFirstBind",
+            "type": "bool"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "twitterBindResult",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "agentId",
+            "type": "string"
+          },
+          {
+            "name": "authority",
+            "type": "pubkey"
+          },
+          {
+            "name": "username",
+            "type": "string"
+          },
+          {
+            "name": "approved",
+            "type": "bool"
+          },
+          {
+            "name": "feeRefunded",
+            "type": "u64"
+          },
+          {
+            "name": "reward",
+            "type": "u64"
+          },
+          {
+            "name": "points",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
     {
       "name": "twitterHandle",
       "serialization": "bytemuck",

package/src/idls/nara_quest.json

@@ -96,6 +96,136 @@
         }
       ]
     },
+    {
+      "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": "create_question",
       "discriminator": [
@@ -343,6 +473,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 +1802,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 +1915,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 +2043,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,136 @@ 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": "createQuestion",
       "discriminator": [
@@ -349,6 +479,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 +1808,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 +1921,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 +2049,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/idls/nara_skills_hub.json

@@ -977,7 +977,7 @@
     {
       "code": 6000,
       "name": "NameTooShort",
-      "msg": "Name too short: min 5 bytes"
+      "msg": "Name too short: min 4 bytes"
     },
     {
       "code": 6001,
@@ -1359,7 +1359,7 @@
           {
             "name": "name",
             "docs": [
-              "Globally unique name (min 5 bytes, max 32 bytes)."
+              "Globally unique name (min 4 bytes, max 32 bytes)."
             ],
             "type": {
               "array": [

package/src/idls/nara_skills_hub.ts

@@ -983,7 +983,7 @@ export type NaraSkillsHub = {
     {
       "code": 6000,
       "name": "nameTooShort",
-      "msg": "Name too short: min 5 bytes"
+      "msg": "Name too short: min 4 bytes"
     },
     {
       "code": 6001,
@@ -1365,7 +1365,7 @@ export type NaraSkillsHub = {
           {
             "name": "name",
             "docs": [
-              "Globally unique name (min 5 bytes, max 32 bytes)."
+              "Globally unique name (min 4 bytes, max 32 bytes)."
             ],
             "type": {
               "array": [

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,42 @@ 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,
+  options?: QuestOptions
+): Promise<string> {
+  const program = createProgram(connection, wallet, options?.programId);
+  const ix = await program.methods
+    .claimAirdrop()
+    .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]);
+}