nara-sdk 1.0.67 → 1.0.69

package/index.ts

@@ -108,6 +108,10 @@ export {
 
 // Export agent registry functions and types
 export {
+  makeRegisterAgentIx,
+  makeRegisterAgentWithReferralIx,
+  makeSetTwitterIx,
+  makeSubmitTweetIx,
   registerAgent,
   registerAgentWithReferral,
   getAgentRecord,

package/package.json

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

package/src/agent_registry.ts

@@ -461,6 +461,101 @@ export async function getConfig(
 
 // ─── Agent CRUD ─────────────────────────────────────────────────
 
+/**
+ * Build a registerAgent instruction without sending it.
+ */
+export async function makeRegisterAgentIx(
+  connection: Connection,
+  payer: PublicKey,
+  authority: PublicKey,
+  agentId: string,
+  options?: AgentRegistryOptions
+): Promise<TransactionInstruction> {
+  if (/[A-Z]/.test(agentId)) {
+    throw new Error(`Agent ID must not contain uppercase letters: "${agentId}"`);
+  }
+  const program = createProgram(connection, Keypair.generate(), options?.programId);
+  return program.methods
+    .registerAgent(agentId)
+    .accounts({ payer, authority } as any)
+    .instruction();
+}
+
+/**
+ * Build a registerAgentWithReferral instruction without sending it.
+ */
+export async function makeRegisterAgentWithReferralIx(
+  connection: Connection,
+  payer: PublicKey,
+  authority: PublicKey,
+  agentId: string,
+  referralAgentId: string,
+  options?: AgentRegistryOptions
+): Promise<TransactionInstruction> {
+  if (/[A-Z]/.test(agentId)) {
+    throw new Error(`Agent ID must not contain uppercase letters: "${agentId}"`);
+  }
+  const program = createProgram(connection, Keypair.generate(), options?.programId);
+  const pointMint = getPointMintPda(program.programId);
+
+  const { referralAgent, referralAuthority, referralPointAccount } =
+    await resolveReferralAccounts(connection, referralAgentId, program.programId, pointMint);
+
+  const refereeMint = getRefereeMintPda(program.programId);
+  const referralRefereeAccount = getAssociatedTokenAddressSync(
+    refereeMint, referralAuthority, true, TOKEN_2022_PROGRAM_ID
+  );
+
+  return program.methods
+    .registerAgentWithReferral(agentId)
+    .accounts({
+      payer,
+      authority,
+      referralAgent,
+      referralAuthority,
+      referralPointAccount,
+      referralRefereeAccount,
+    } as any)
+    .instruction();
+}
+
+/**
+ * Build a setTwitter instruction without sending it.
+ */
+export async function makeSetTwitterIx(
+  connection: Connection,
+  payer: PublicKey,
+  authority: PublicKey,
+  agentId: string,
+  username: string,
+  tweetUrl: string,
+  options?: AgentRegistryOptions
+): Promise<TransactionInstruction> {
+  const program = createProgram(connection, Keypair.generate(), options?.programId);
+  return program.methods
+    .setTwitter(agentId, username, tweetUrl)
+    .accounts({ payer, authority } as any)
+    .instruction();
+}
+
+/**
+ * Build a submitTweet instruction without sending it.
+ */
+export async function makeSubmitTweetIx(
+  connection: Connection,
+  payer: PublicKey,
+  authority: PublicKey,
+  agentId: string,
+  tweetId: bigint,
+  options?: AgentRegistryOptions
+): Promise<TransactionInstruction> {
+  const program = createProgram(connection, Keypair.generate(), options?.programId);
+  return program.methods
+    .submitTweet(agentId, new BN(tweetId.toString()))
+    .accounts({ payer, authority } as any)
+    .instruction();
+}
+
 /**
  * Register a new agent on-chain (without referral). Charges the program's registration fee.
  */
@@ -468,20 +563,24 @@ export async function registerAgent(
   connection: Connection,
   wallet: Keypair,
   agentId: string,
-  options?: AgentRegistryOptions
+  options?: AgentRegistryOptions,
+  payer?: Keypair
 ): Promise<{ signature: string; agentPubkey: PublicKey }> {
   if (/[A-Z]/.test(agentId)) {
     throw new Error(`Agent ID must not contain uppercase letters: "${agentId}"`);
   }
-  const program = createProgram(connection, wallet, options?.programId);
+  const payerKp = payer ?? wallet;
+  const program = createProgram(connection, payerKp, options?.programId);
 
   const ix = await program.methods
     .registerAgent(agentId)
     .accounts({
+      payer: payerKp.publicKey,
       authority: wallet.publicKey,
     } as any)
     .instruction();
-  const signature = await sendTx(connection, wallet, [ix]);
+  const signers = payer && !payer.publicKey.equals(wallet.publicKey) ? [wallet] : [];
+  const signature = await sendTx(connection, payerKp, [ix], signers);
 
   const agentPubkey = getAgentPda(program.programId, agentId);
   return { signature, agentPubkey };
@@ -496,12 +595,14 @@ export async function registerAgentWithReferral(
   wallet: Keypair,
   agentId: string,
   referralAgentId: string,
-  options?: AgentRegistryOptions
+  options?: AgentRegistryOptions,
+  payer?: Keypair
 ): Promise<{ signature: string; agentPubkey: PublicKey }> {
   if (/[A-Z]/.test(agentId)) {
     throw new Error(`Agent ID must not contain uppercase letters: "${agentId}"`);
   }
-  const program = createProgram(connection, wallet, options?.programId);
+  const payerKp = payer ?? wallet;
+  const program = createProgram(connection, payerKp, options?.programId);
   const pointMint = getPointMintPda(program.programId);
 
   const { referralAgent, referralAuthority, referralPointAccount } =
@@ -515,6 +616,7 @@ export async function registerAgentWithReferral(
   const ix = await program.methods
     .registerAgentWithReferral(agentId)
     .accounts({
+      payer: payerKp.publicKey,
       authority: wallet.publicKey,
       referralAgent,
       referralAuthority,
@@ -522,7 +624,8 @@ export async function registerAgentWithReferral(
       referralRefereeAccount,
     } as any)
     .instruction();
-  const signature = await sendTx(connection, wallet, [ix]);
+  const signers = payer && !payer.publicKey.equals(wallet.publicKey) ? [wallet] : [];
+  const signature = await sendTx(connection, payerKp, [ix], signers);
 
   const agentPubkey = getAgentPda(program.programId, agentId);
   return { signature, agentPubkey };
@@ -1357,14 +1460,17 @@ export async function setTwitter(
   agentId: string,
   username: string,
   tweetUrl: string,
-  options?: AgentRegistryOptions
+  options?: AgentRegistryOptions,
+  payer?: Keypair
 ): Promise<string> {
-  const program = createProgram(connection, wallet, options?.programId);
+  const payerKp = payer ?? wallet;
+  const program = createProgram(connection, payerKp, options?.programId);
   const ix = await program.methods
     .setTwitter(agentId, username, tweetUrl)
-    .accounts({ authority: wallet.publicKey } as any)
+    .accounts({ payer: payerKp.publicKey, authority: wallet.publicKey } as any)
     .instruction();
-  return sendTx(connection, wallet, [ix]);
+  const signers = payer && !payer.publicKey.equals(wallet.publicKey) ? [wallet] : [];
+  return sendTx(connection, payerKp, [ix], signers);
 }
 
 /**
@@ -1376,14 +1482,17 @@ export async function submitTweet(
   wallet: Keypair,
   agentId: string,
   tweetId: bigint,
-  options?: AgentRegistryOptions
+  options?: AgentRegistryOptions,
+  payer?: Keypair
 ): Promise<string> {
-  const program = createProgram(connection, wallet, options?.programId);
+  const payerKp = payer ?? wallet;
+  const program = createProgram(connection, payerKp, options?.programId);
   const ix = await program.methods
     .submitTweet(agentId, new BN(tweetId.toString()))
-    .accounts({ authority: wallet.publicKey } as any)
+    .accounts({ payer: payerKp.publicKey, authority: wallet.publicKey } as any)
     .instruction();
-  return sendTx(connection, wallet, [ix]);
+  const signers = payer && !payer.publicKey.equals(wallet.publicKey) ? [wallet] : [];
+  return sendTx(connection, payerKp, [ix], signers);
 }
 
 /**

package/src/idls/nara_agent_registry.json

@@ -1577,10 +1577,14 @@
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
           "signer": true
         },
+        {
+          "name": "authority",
+          "signer": true
+        },
         {
           "name": "agent",
           "writable": true,
@@ -1669,10 +1673,14 @@
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
           "signer": true
         },
+        {
+          "name": "authority",
+          "signer": true
+        },
         {
           "name": "agent",
           "writable": true,
@@ -2512,8 +2520,12 @@
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
+          "signer": true
+        },
+        {
+          "name": "authority",
           "signer": true,
           "relations": [
             "agent"
@@ -2675,8 +2687,12 @@
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
+          "signer": true
+        },
+        {
+          "name": "authority",
           "signer": true,
           "relations": [
             "agent"

package/src/idls/nara_agent_registry.ts

@@ -1583,10 +1583,14 @@ export type NaraAgentRegistry = {
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
           "signer": true
         },
+        {
+          "name": "authority",
+          "signer": true
+        },
         {
           "name": "agent",
           "writable": true,
@@ -1675,10 +1679,14 @@ export type NaraAgentRegistry = {
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
           "signer": true
         },
+        {
+          "name": "authority",
+          "signer": true
+        },
         {
           "name": "agent",
           "writable": true,
@@ -2518,8 +2526,12 @@ export type NaraAgentRegistry = {
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
+          "signer": true
+        },
+        {
+          "name": "authority",
           "signer": true,
           "relations": [
             "agent"
@@ -2681,8 +2693,12 @@ export type NaraAgentRegistry = {
       ],
       "accounts": [
         {
-          "name": "authority",
+          "name": "payer",
           "writable": true,
+          "signer": true
+        },
+        {
+          "name": "authority",
           "signer": true,
           "relations": [
             "agent"