nara-sdk 1.0.68 → 1.0.70

package/index.ts

@@ -108,6 +108,10 @@ export {
 
 // Export agent registry functions and types
 export {
+  makeRegisterAgentIx,
+  makeRegisterAgentWithReferralIx,
+  makeSetTwitterIx,
+  makeSubmitTweetIx,
   registerAgent,
   registerAgentWithReferral,
   getAgentRecord,
@@ -136,6 +140,7 @@ export {
   unbindTwitter,
   verifyTwitter,
   rejectTwitter,
+  approveRejectedTwitter,
   approveTweet,
   rejectTweet,
   // Admin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nara-sdk",
-  "version": "1.0.68",
+  "version": "1.0.70",
   "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.
  */
@@ -1483,6 +1578,53 @@ export async function rejectTwitter(
   return sendTx(connection, wallet, [ix]);
 }
 
+/**
+ * Approve a previously rejected twitter verification (verifier-only).
+ * Awards verification reward and points to the agent owner.
+ * @param freeStakeDelta - If provided, also adjusts free stake credits for the agent owner in the same tx.
+ */
+export async function approveRejectedTwitter(
+  connection: Connection,
+  wallet: Keypair,
+  agentId: string,
+  username: string,
+  options?: AgentRegistryOptions,
+  freeStakeDelta?: number,
+  freeStakeReason?: string
+): Promise<string> {
+  const program = createProgram(connection, wallet, options?.programId);
+  const agentPda = getAgentPda(program.programId, agentId);
+
+  const accountInfo = await connection.getAccountInfo(agentPda);
+  if (!accountInfo) throw new Error(`Agent "${agentId}" not found`);
+  const authority = new PublicKey(accountInfo.data.subarray(8, 40));
+
+  const pointMint = getPointMintPda(program.programId);
+  const authorityPointAccount = getAssociatedTokenAddressSync(
+    pointMint, authority, true, TOKEN_2022_PROGRAM_ID
+  );
+
+  const ix = await program.methods
+    .approveRejectedTwitter(agentId, username)
+    .accounts({
+      verifier: wallet.publicKey,
+      authority,
+      authorityPointAccount,
+    } as any)
+    .instruction();
+
+  const ixs = [ix];
+  if (freeStakeDelta !== undefined && freeStakeDelta !== 0) {
+    const { makeAdjustFreeStakeIx } = await import("./quest");
+    const freeStakeIx = await makeAdjustFreeStakeIx(
+      connection, wallet.publicKey, authority, freeStakeDelta, freeStakeReason ?? ""
+    );
+    ixs.push(freeStakeIx);
+  }
+
+  return sendTx(connection, wallet, ixs);
+}
+
 /**
  * Approve a tweet verification (verifier-only).
  * Awards tweet verify reward and points to the agent owner.

package/src/idls/nara_agent_registry.json

@@ -7,6 +7,306 @@
     "description": "Nara Agent Registry - AI agent registration center"
   },
   "instructions": [
+    {
+      "name": "approve_rejected_twitter",
+      "discriminator": [
+        119,
+        20,
+        181,
+        34,
+        178,
+        73,
+        81,
+        50
+      ],
+      "accounts": [
+        {
+          "name": "verifier",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "agent",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  97,
+                  103,
+                  101,
+                  110,
+                  116
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "agent_id"
+              }
+            ]
+          }
+        },
+        {
+          "name": "twitter",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  105,
+                  116,
+                  116,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "agent"
+              }
+            ]
+          }
+        },
+        {
+          "name": "twitter_handle",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  105,
+                  116,
+                  116,
+                  101,
+                  114,
+                  95,
+                  104,
+                  97,
+                  110,
+                  100,
+                  108,
+                  101
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "username"
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "writable": true
+        },
+        {
+          "name": "twitter_verify_vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  105,
+                  116,
+                  116,
+                  101,
+                  114,
+                  95,
+                  118,
+                  101,
+                  114,
+                  105,
+                  102,
+                  121,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "treasury",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  114,
+                  101,
+                  97,
+                  115,
+                  117,
+                  114,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "point_mint",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  112,
+                  111,
+                  105,
+                  110,
+                  116,
+                  95,
+                  109,
+                  105,
+                  110,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "mint_authority",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  109,
+                  105,
+                  110,
+                  116,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  111,
+                  114,
+                  105,
+                  116,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority_point_account",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "authority"
+              },
+              {
+                "kind": "account",
+                "path": "token_program"
+              },
+              {
+                "kind": "account",
+                "path": "point_mint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          "name": "token_program",
+          "address": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          "name": "associated_token_program",
+          "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "agent_id",
+          "type": "string"
+        },
+        {
+          "name": "username",
+          "type": "string"
+        }
+      ]
+    },
     {
       "name": "approve_tweet",
       "discriminator": [
@@ -4445,6 +4745,11 @@
       "code": 6046,
       "name": "AgentIdReserved",
       "msg": "Agent ID length <= 4 is reserved for admin only"
+    },
+    {
+      "code": 6047,
+      "name": "TwitterNotRejected",
+      "msg": "Twitter binding is not in rejected status"
     }
   ],
   "types": [

package/src/idls/nara_agent_registry.ts

@@ -13,6 +13,306 @@ export type NaraAgentRegistry = {
     "description": "Nara Agent Registry - AI agent registration center"
   },
   "instructions": [
+    {
+      "name": "approveRejectedTwitter",
+      "discriminator": [
+        119,
+        20,
+        181,
+        34,
+        178,
+        73,
+        81,
+        50
+      ],
+      "accounts": [
+        {
+          "name": "verifier",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "agent",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  97,
+                  103,
+                  101,
+                  110,
+                  116
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "agentId"
+              }
+            ]
+          }
+        },
+        {
+          "name": "twitter",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  105,
+                  116,
+                  116,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "agent"
+              }
+            ]
+          }
+        },
+        {
+          "name": "twitterHandle",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  105,
+                  116,
+                  116,
+                  101,
+                  114,
+                  95,
+                  104,
+                  97,
+                  110,
+                  100,
+                  108,
+                  101
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "username"
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "writable": true
+        },
+        {
+          "name": "twitterVerifyVault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  105,
+                  116,
+                  116,
+                  101,
+                  114,
+                  95,
+                  118,
+                  101,
+                  114,
+                  105,
+                  102,
+                  121,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "treasury",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  114,
+                  101,
+                  97,
+                  115,
+                  117,
+                  114,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "pointMint",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  112,
+                  111,
+                  105,
+                  110,
+                  116,
+                  95,
+                  109,
+                  105,
+                  110,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "mintAuthority",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  109,
+                  105,
+                  110,
+                  116,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  111,
+                  114,
+                  105,
+                  116,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "authorityPointAccount",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "authority"
+              },
+              {
+                "kind": "account",
+                "path": "tokenProgram"
+              },
+              {
+                "kind": "account",
+                "path": "pointMint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          "name": "tokenProgram",
+          "address": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          "name": "associatedTokenProgram",
+          "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
+        {
+          "name": "systemProgram",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "agentId",
+          "type": "string"
+        },
+        {
+          "name": "username",
+          "type": "string"
+        }
+      ]
+    },
     {
       "name": "approveTweet",
       "discriminator": [
@@ -4451,6 +4751,11 @@ export type NaraAgentRegistry = {
       "code": 6046,
       "name": "agentIdReserved",
       "msg": "Agent ID length <= 4 is reserved for admin only"
+    },
+    {
+      "code": 6047,
+      "name": "twitterNotRejected",
+      "msg": "Twitter binding is not in rejected status"
     }
   ],
   "types": [