nara-sdk 1.0.49 → 1.0.51

package/index.ts

@@ -17,6 +17,9 @@ export {
   DEFAULT_ALT_ADDRESS,
 } from "./src/constants";
 
+// Export signing utilities
+export { signParams, signUrl } from "./src/sign";
+
 // Export transaction helper
 export { sendTx, setAltAddress, getAltAddress, getRecentPriorityFee } from "./src/tx";
 
@@ -37,6 +40,9 @@ export {
   setRewardConfig,
   setStakeConfig,
   transferQuestAuthority,
+  setQuestAuthority,
+  setQuestInterval,
+  setRewardPerShare,
   getQuestConfig,
   type QuestInfo,
   type StakeInfo,
@@ -63,7 +69,7 @@ export {
   getConfig as getSkillsConfig,
   initConfig as initSkillsConfig,
   updateAdmin as updateSkillsAdmin,
-  updateFeeRecipient as updateSkillsFeeRecipient,
+  withdrawFees as withdrawSkillsFees,
   updateRegisterFee as updateSkillsRegisterFee,
   type SkillRecord,
   type SkillInfo,
@@ -87,6 +93,7 @@ export {
   getConfig as getZkIdConfig,
   initializeConfig as initZkIdConfig,
   updateConfig as updateZkIdConfig,
+  withdrawFees as withdrawZkIdFees,
   ZKID_DENOMINATIONS,
   type ZkIdInfo,
   type ClaimableDeposit,
@@ -113,7 +120,7 @@ export {
   makeLogActivityWithReferralIx,
   initConfig as initAgentRegistryConfig,
   updateAdmin,
-  updateFeeRecipient,
+  withdrawFees as withdrawAgentRegistryFees,
   updateRegisterFee,
   updatePointsConfig,
   setReferral,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nara-sdk",
-  "version": "1.0.49",
+  "version": "1.0.51",
   "description": "SDK for the Nara chain (Solana-compatible)",
   "module": "index.ts",
   "main": "index.ts",
@@ -37,5 +37,6 @@
     "circomlibjs": "^0.1.7",
     "snarkjs": "^0.7.6",
     "tweetnacl": "^1.0.3"
-  }
+  },
+  "packageManager": "pnpm@10.27.0+sha512.72d699da16b1179c14ba9e64dc71c9a40988cbdc65c264cb0e489db7de917f20dcf4d64d8723625f2969ba52d4b7e2a1170682d9ac2a5dcaeaab732b7e16f04a"
 }

package/src/agent_registry.ts

@@ -311,7 +311,7 @@ export async function getConfig(
   options?: AgentRegistryOptions
 ): Promise<{
   admin: PublicKey;
-  feeRecipient: PublicKey;
+  feeVault: PublicKey;
   pointMint: PublicKey;
   refereeMint: PublicKey;
   refereeActivityMint: PublicKey;
@@ -333,7 +333,7 @@ export async function getConfig(
   const buf = Buffer.from(accountInfo.data);
   let offset = 8; // skip discriminator
   const admin = new PublicKey(buf.subarray(offset, offset + 32)); offset += 32;
-  const feeRecipient = new PublicKey(buf.subarray(offset, offset + 32)); offset += 32;
+  const feeVault = new PublicKey(buf.subarray(offset, offset + 32)); offset += 32;
   const pointMint = new PublicKey(buf.subarray(offset, offset + 32)); offset += 32;
   const refereeMint = new PublicKey(buf.subarray(offset, offset + 32)); offset += 32;
   const refereeActivityMint = new PublicKey(buf.subarray(offset, offset + 32)); offset += 32;
@@ -345,7 +345,7 @@ export async function getConfig(
   const referralRegisterPoints = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const activityReward = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const referralActivityReward = Number(buf.readBigUInt64LE(offset));
-  return { admin, feeRecipient, pointMint, refereeMint, refereeActivityMint, registerFee, pointsSelf, pointsReferral, referralRegisterFee, referralFeeShare, referralRegisterPoints, activityReward, referralActivityReward };
+  return { admin, feeVault, pointMint, refereeMint, refereeActivityMint, registerFee, pointsSelf, pointsReferral, referralRegisterFee, referralFeeShare, referralRegisterPoints, activityReward, referralActivityReward };
 }
 
 // ─── Agent CRUD ─────────────────────────────────────────────────
@@ -363,13 +363,11 @@ export async function registerAgent(
     throw new Error(`Agent ID must not contain uppercase letters: "${agentId}"`);
   }
   const program = createProgram(connection, wallet, options?.programId);
-  const config = await getConfig(connection, options);
 
   const ix = await program.methods
     .registerAgent(agentId)
     .accounts({
       authority: wallet.publicKey,
-      feeRecipient: config.feeRecipient,
     } as any)
     .instruction();
   const signature = await sendTx(connection, wallet, [ix]);
@@ -393,7 +391,6 @@ export async function registerAgentWithReferral(
     throw new Error(`Agent ID must not contain uppercase letters: "${agentId}"`);
   }
   const program = createProgram(connection, wallet, options?.programId);
-  const config = await getConfig(connection, options);
   const pointMint = getPointMintPda(program.programId);
 
   const { referralAgent, referralAuthority, referralPointAccount } =
@@ -408,7 +405,6 @@ export async function registerAgentWithReferral(
     .registerAgentWithReferral(agentId)
     .accounts({
       authority: wallet.publicKey,
-      feeRecipient: config.feeRecipient,
       referralAgent,
       referralAuthority,
       referralPointAccount,
@@ -880,17 +876,18 @@ export async function updateAdmin(
 }
 
 /**
- * Update the fee recipient (admin-only).
+ * Withdraw accumulated fees from the fee vault (admin-only).
  */
-export async function updateFeeRecipient(
+export async function withdrawFees(
   connection: Connection,
   wallet: Keypair,
-  newRecipient: PublicKey,
+  amount: number | anchor.BN,
   options?: AgentRegistryOptions
 ): Promise<string> {
   const program = createProgram(connection, wallet, options?.programId);
+  const amt = typeof amount === "number" ? new anchor.BN(amount) : amount;
   const ix = await program.methods
-    .updateFeeRecipient(newRecipient)
+    .withdrawFees(amt)
     .accounts({ admin: wallet.publicKey } as any)
     .instruction();
   return sendTx(connection, wallet, [ix]);

package/src/idls/nara_agent_registry.json

@@ -438,6 +438,28 @@
             ]
           }
         },
+        {
+          "name": "fee_vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
         {
           "name": "point_mint",
           "writable": true,
@@ -1217,8 +1239,26 @@
           }
         },
         {
-          "name": "fee_recipient",
-          "writable": true
+          "name": "fee_vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
         },
         {
           "name": "system_program",
@@ -1291,8 +1331,26 @@
           }
         },
         {
-          "name": "fee_recipient",
-          "writable": true
+          "name": "fee_vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
         },
         {
           "name": "point_mint",
@@ -1961,53 +2019,6 @@
         }
       ]
     },
-    {
-      "name": "update_fee_recipient",
-      "discriminator": [
-        249,
-        0,
-        198,
-        35,
-        183,
-        123,
-        57,
-        188
-      ],
-      "accounts": [
-        {
-          "name": "admin",
-          "signer": true,
-          "relations": [
-            "config"
-          ]
-        },
-        {
-          "name": "config",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  99,
-                  111,
-                  110,
-                  102,
-                  105,
-                  103
-                ]
-              }
-            ]
-          }
-        }
-      ],
-      "args": [
-        {
-          "name": "new_recipient",
-          "type": "pubkey"
-        }
-      ]
-    },
     {
       "name": "update_points_config",
       "discriminator": [
@@ -2161,6 +2172,79 @@
         }
       ]
     },
+    {
+      "name": "withdraw_fees",
+      "discriminator": [
+        198,
+        212,
+        171,
+        109,
+        144,
+        215,
+        174,
+        89
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true,
+          "relations": [
+            "config"
+          ]
+        },
+        {
+          "name": "config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "fee_vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "amount",
+          "type": "u64"
+        }
+      ]
+    },
     {
       "name": "write_to_buffer",
       "discriminator": [
@@ -2357,8 +2441,8 @@
     },
     {
       "code": 6015,
-      "name": "InvalidFeeRecipient",
-      "msg": "Fee recipient does not match config.fee_recipient"
+      "name": "InsufficientFeeVaultBalance",
+      "msg": "Fee vault has insufficient balance for withdrawal"
     },
     {
       "code": 6016,
@@ -2608,7 +2692,7 @@
             "type": "pubkey"
           },
           {
-            "name": "fee_recipient",
+            "name": "fee_vault",
             "type": "pubkey"
           },
           {

package/src/idls/nara_agent_registry.ts

@@ -444,6 +444,28 @@ export type NaraAgentRegistry = {
             ]
           }
         },
+        {
+          "name": "feeVault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
         {
           "name": "pointMint",
           "writable": true,
@@ -1223,8 +1245,26 @@ export type NaraAgentRegistry = {
           }
         },
         {
-          "name": "feeRecipient",
-          "writable": true
+          "name": "feeVault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
         },
         {
           "name": "systemProgram",
@@ -1297,8 +1337,26 @@ export type NaraAgentRegistry = {
           }
         },
         {
-          "name": "feeRecipient",
-          "writable": true
+          "name": "feeVault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
         },
         {
           "name": "pointMint",
@@ -1967,53 +2025,6 @@ export type NaraAgentRegistry = {
         }
       ]
     },
-    {
-      "name": "updateFeeRecipient",
-      "discriminator": [
-        249,
-        0,
-        198,
-        35,
-        183,
-        123,
-        57,
-        188
-      ],
-      "accounts": [
-        {
-          "name": "admin",
-          "signer": true,
-          "relations": [
-            "config"
-          ]
-        },
-        {
-          "name": "config",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  99,
-                  111,
-                  110,
-                  102,
-                  105,
-                  103
-                ]
-              }
-            ]
-          }
-        }
-      ],
-      "args": [
-        {
-          "name": "newRecipient",
-          "type": "pubkey"
-        }
-      ]
-    },
     {
       "name": "updatePointsConfig",
       "discriminator": [
@@ -2167,6 +2178,79 @@ export type NaraAgentRegistry = {
         }
       ]
     },
+    {
+      "name": "withdrawFees",
+      "discriminator": [
+        198,
+        212,
+        171,
+        109,
+        144,
+        215,
+        174,
+        89
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true,
+          "relations": [
+            "config"
+          ]
+        },
+        {
+          "name": "config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "feeVault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "systemProgram",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "amount",
+          "type": "u64"
+        }
+      ]
+    },
     {
       "name": "writeToBuffer",
       "discriminator": [
@@ -2363,8 +2447,8 @@ export type NaraAgentRegistry = {
     },
     {
       "code": 6015,
-      "name": "invalidFeeRecipient",
-      "msg": "Fee recipient does not match config.fee_recipient"
+      "name": "insufficientFeeVaultBalance",
+      "msg": "Fee vault has insufficient balance for withdrawal"
     },
     {
       "code": 6016,
@@ -2614,7 +2698,7 @@ export type NaraAgentRegistry = {
             "type": "pubkey"
           },
           {
-            "name": "feeRecipient",
+            "name": "feeVault",
             "type": "pubkey"
           },
           {