nara-sdk 1.0.62 → 1.0.63

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/nara-chain/nara-web/main/public/favicon.png" width="48" />
+  <img src="https://raw.githubusercontent.com/nara-chain/nara-web/main/public/favicon-v3.svg" width="48" />
 </p>
 
 <h3 align="center">Nara SDK</h3>

package/index.ts

@@ -126,6 +126,7 @@ export {
   // Twitter verification
   getAgentTwitter,
   getTweetVerify,
+  getTweetRecord,
   getPendingTwitterVerifications,
   getPendingTweetVerifications,
   setTwitter,
@@ -152,6 +153,7 @@ export {
   type AgentInfo,
   type AgentTwitterInfo,
   type TweetVerifyInfo,
+  type TweetRecordInfo,
   type MemoryMode,
   type AgentRegistryOptions,
 } from "./src/agent_registry";

package/package.json

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

package/src/agent_registry.ts

@@ -65,7 +65,13 @@ export interface TweetVerifyInfo {
   status: number;
   submittedAt: number;
   lastRewardedAt: number;
-  tweetUrl: string;
+  tweetId: bigint;
+}
+
+export interface TweetRecordInfo {
+  agent: PublicKey;
+  approvedAt: number;
+  tweetId: bigint;
 }
 
 export type MemoryMode = "new" | "update" | "append" | "auto";
@@ -295,9 +301,8 @@ function parseTweetVerifyData(data: Buffer | Uint8Array): TweetVerifyInfo {
   const status = Number(buf.readBigUInt64LE(offset)); offset += 8;
   const submittedAt = Number(buf.readBigInt64LE(offset)); offset += 8;
   const lastRewardedAt = Number(buf.readBigInt64LE(offset)); offset += 8;
-  const tweetUrlLen = Number(buf.readBigUInt64LE(offset)); offset += 8;
-  const tweetUrl = buf.subarray(offset, offset + tweetUrlLen).toString("utf-8");
-  return { agentId, status, submittedAt, lastRewardedAt, tweetUrl };
+  const tweetId = buf.readBigUInt64LE(offset) | (buf.readBigUInt64LE(offset + 8) << 64n); offset += 16;
+  return { agentId, status, submittedAt, lastRewardedAt, tweetId };
 }
 
 /**
@@ -1214,6 +1219,34 @@ export async function getTweetVerify(
   return parseTweetVerifyData(accountInfo.data);
 }
 
+/**
+ * Read a tweet record by tweet ID.
+ * Returns null if no record exists.
+ */
+export async function getTweetRecord(
+  connection: Connection,
+  tweetId: bigint,
+  options?: AgentRegistryOptions
+): Promise<TweetRecordInfo | null> {
+  const pid = new PublicKey(options?.programId ?? DEFAULT_AGENT_REGISTRY_PROGRAM_ID);
+  const tweetIdBuf = Buffer.alloc(16);
+  tweetIdBuf.writeBigUInt64LE(tweetId & 0xFFFFFFFFFFFFFFFFn, 0);
+  tweetIdBuf.writeBigUInt64LE(tweetId >> 64n, 8);
+  const [pda] = PublicKey.findProgramAddressSync(
+    [Buffer.from("tweet_record"), tweetIdBuf],
+    pid
+  );
+  const accountInfo = await connection.getAccountInfo(pda);
+  if (!accountInfo) return null;
+
+  const buf = Buffer.from(accountInfo.data);
+  let offset = 8; // skip discriminator
+  const agent = new PublicKey(buf.subarray(offset, offset + 32)); offset += 32;
+  const approvedAt = Number(buf.readBigInt64LE(offset)); offset += 8;
+  const recordTweetId = buf.readBigUInt64LE(offset) | (buf.readBigUInt64LE(offset + 8) << 64n);
+  return { agent, approvedAt, tweetId: recordTweetId };
+}
+
 /** Batch getMultipleAccountsInfo in chunks of 100 (RPC limit). */
 async function batchGetMultipleAccounts(
   connection: Connection,
@@ -1329,12 +1362,12 @@ export async function submitTweet(
   connection: Connection,
   wallet: Keypair,
   agentId: string,
-  tweetUrl: string,
+  tweetId: bigint,
   options?: AgentRegistryOptions
 ): Promise<string> {
   const program = createProgram(connection, wallet, options?.programId);
   const ix = await program.methods
-    .submitTweet(agentId, tweetUrl)
+    .submitTweet(agentId, new anchor.BN(tweetId.toString()))
     .accounts({ authority: wallet.publicKey } as any)
     .instruction();
   return sendTx(connection, wallet, [ix]);
@@ -1370,7 +1403,7 @@ export async function verifyTwitter(
   username: string,
   options?: AgentRegistryOptions,
   freeStakeDelta?: number,
-  tweetUrl?: string
+  freeStakeReason?: string
 ): Promise<string> {
   const program = createProgram(connection, wallet, options?.programId);
   const agentPda = getAgentPda(program.programId, agentId);
@@ -1398,7 +1431,7 @@ export async function verifyTwitter(
   if (freeStakeDelta !== undefined && freeStakeDelta !== 0) {
     const { makeAdjustFreeStakeIx } = await import("./quest");
     const freeStakeIx = await makeAdjustFreeStakeIx(
-      connection, wallet.publicKey, authority, freeStakeDelta, tweetUrl ?? ""
+      connection, wallet.publicKey, authority, freeStakeDelta, freeStakeReason ?? ""
     );
     ixs.push(freeStakeIx);
   }
@@ -1432,9 +1465,10 @@ export async function approveTweet(
   connection: Connection,
   wallet: Keypair,
   agentId: string,
+  tweetId: bigint,
   options?: AgentRegistryOptions,
   freeStakeDelta?: number,
-  tweetUrl?: string
+  freeStakeReason?: string
 ): Promise<string> {
   const program = createProgram(connection, wallet, options?.programId);
   const agentPda = getAgentPda(program.programId, agentId);
@@ -1450,7 +1484,7 @@ export async function approveTweet(
   );
 
   const ix = await program.methods
-    .approveTweet(agentId)
+    .approveTweet(agentId, new anchor.BN(tweetId.toString()))
     .accounts({
       verifier: wallet.publicKey,
       authority,
@@ -1462,7 +1496,7 @@ export async function approveTweet(
   if (freeStakeDelta !== undefined && freeStakeDelta !== 0) {
     const { makeAdjustFreeStakeIx } = await import("./quest");
     const freeStakeIx = await makeAdjustFreeStakeIx(
-      connection, wallet.publicKey, authority, freeStakeDelta, tweetUrl ?? ""
+      connection, wallet.publicKey, authority, freeStakeDelta, freeStakeReason ?? ""
     );
     ixs.push(freeStakeIx);
   }

package/src/idls/nara_agent_registry.json

@@ -93,6 +93,35 @@
             ]
           }
         },
+        {
+          "name": "tweet_record",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  101,
+                  101,
+                  116,
+                  95,
+                  114,
+                  101,
+                  99,
+                  111,
+                  114,
+                  100
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "tweet_id"
+              }
+            ]
+          }
+        },
         {
           "name": "authority",
           "writable": true
@@ -305,6 +334,10 @@
         {
           "name": "agent_id",
           "type": "string"
+        },
+        {
+          "name": "tweet_id",
+          "type": "u128"
         }
       ]
     },
@@ -2804,6 +2837,34 @@
             ]
           }
         },
+        {
+          "name": "tweet_record",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  101,
+                  101,
+                  116,
+                  95,
+                  114,
+                  101,
+                  99,
+                  111,
+                  114,
+                  100
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "tweet_id"
+              }
+            ]
+          }
+        },
         {
           "name": "system_program",
           "address": "11111111111111111111111111111111"
@@ -2815,8 +2876,8 @@
           "type": "string"
         },
         {
-          "name": "tweet_url",
-          "type": "string"
+          "name": "tweet_id",
+          "type": "u128"
         }
       ]
     },
@@ -4040,6 +4101,19 @@
         63
       ]
     },
+    {
+      "name": "TweetRecord",
+      "discriminator": [
+        13,
+        25,
+        5,
+        236,
+        64,
+        149,
+        72,
+        215
+      ]
+    },
     {
       "name": "TweetVerify",
       "discriminator": [
@@ -4302,6 +4376,16 @@
       "code": 6043,
       "name": "TwitterAlreadyVerified",
       "msg": "Twitter is already verified, unbind first"
+    },
+    {
+      "code": 6044,
+      "name": "InvalidTweetUrlFormat",
+      "msg": "Invalid tweet URL format"
+    },
+    {
+      "code": 6045,
+      "name": "TweetAlreadyApproved",
+      "msg": "Tweet has already been approved"
     }
   ],
   "types": [
@@ -4664,6 +4748,53 @@
         ]
       }
     },
+    {
+      "name": "TweetRecord",
+      "docs": [
+        "Records an approved tweet to prevent duplicate submissions.",
+        "Seeds: [SEED_TWEET_RECORD, &tweet_id.to_le_bytes()]"
+      ],
+      "serialization": "bytemuck",
+      "repr": {
+        "kind": "c",
+        "packed": true
+      },
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "agent",
+            "docs": [
+              "The agent PDA that submitted this tweet"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "approved_at",
+            "docs": [
+              "Unix timestamp when this tweet was approved"
+            ],
+            "type": "i64"
+          },
+          {
+            "name": "tweet_id",
+            "docs": [
+              "Tweet ID (Twitter snowflake ID)"
+            ],
+            "type": "u128"
+          },
+          {
+            "name": "_reserved",
+            "type": {
+              "array": [
+                "u8",
+                64
+              ]
+            }
+          }
+        ]
+      }
+    },
     {
       "name": "TweetVerify",
       "docs": [
@@ -4672,7 +4803,8 @@
       ],
       "serialization": "bytemuck",
       "repr": {
-        "kind": "c"
+        "kind": "c",
+        "packed": true
       },
       "type": {
         "kind": "struct",
@@ -4712,17 +4844,14 @@
             "type": "i64"
           },
           {
-            "name": "tweet_url_len",
+            "name": "tweet_id",
             "docs": [
-              "Actual byte length of tweet_url"
+              "Tweet ID (Twitter snowflake ID)"
             ],
-            "type": "u64"
+            "type": "u128"
           },
           {
-            "name": "tweet_url",
-            "docs": [
-              "Tweet URL (max 256 bytes)"
-            ],
+            "name": "_reserved",
             "type": {
               "array": [
                 "u8",
@@ -4731,7 +4860,7 @@
             }
           },
           {
-            "name": "_reserved",
+            "name": "_reserved2",
             "type": {
               "array": [
                 "u8",
@@ -4740,11 +4869,38 @@
             }
           },
           {
-            "name": "_reserved2",
+            "name": "_reserved3",
             "type": {
               "array": [
                 "u8",
-                128
+                64
+              ]
+            }
+          },
+          {
+            "name": "_reserved4",
+            "type": {
+              "array": [
+                "u8",
+                32
+              ]
+            }
+          },
+          {
+            "name": "_reserved5",
+            "type": {
+              "array": [
+                "u8",
+                16
+              ]
+            }
+          },
+          {
+            "name": "_reserved6",
+            "type": {
+              "array": [
+                "u8",
+                8
               ]
             }
           }

package/src/idls/nara_agent_registry.ts

@@ -99,6 +99,35 @@ export type NaraAgentRegistry = {
             ]
           }
         },
+        {
+          "name": "tweetRecord",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  101,
+                  101,
+                  116,
+                  95,
+                  114,
+                  101,
+                  99,
+                  111,
+                  114,
+                  100
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "tweetId"
+              }
+            ]
+          }
+        },
         {
           "name": "authority",
           "writable": true
@@ -311,6 +340,10 @@ export type NaraAgentRegistry = {
         {
           "name": "agentId",
           "type": "string"
+        },
+        {
+          "name": "tweetId",
+          "type": "u128"
         }
       ]
     },
@@ -2810,6 +2843,34 @@ export type NaraAgentRegistry = {
             ]
           }
         },
+        {
+          "name": "tweetRecord",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  119,
+                  101,
+                  101,
+                  116,
+                  95,
+                  114,
+                  101,
+                  99,
+                  111,
+                  114,
+                  100
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "tweetId"
+              }
+            ]
+          }
+        },
         {
           "name": "systemProgram",
           "address": "11111111111111111111111111111111"
@@ -2821,8 +2882,8 @@ export type NaraAgentRegistry = {
           "type": "string"
         },
         {
-          "name": "tweetUrl",
-          "type": "string"
+          "name": "tweetId",
+          "type": "u128"
         }
       ]
     },
@@ -4046,6 +4107,19 @@ export type NaraAgentRegistry = {
         63
       ]
     },
+    {
+      "name": "tweetRecord",
+      "discriminator": [
+        13,
+        25,
+        5,
+        236,
+        64,
+        149,
+        72,
+        215
+      ]
+    },
     {
       "name": "tweetVerify",
       "discriminator": [
@@ -4308,6 +4382,16 @@ export type NaraAgentRegistry = {
       "code": 6043,
       "name": "twitterAlreadyVerified",
       "msg": "Twitter is already verified, unbind first"
+    },
+    {
+      "code": 6044,
+      "name": "invalidTweetUrlFormat",
+      "msg": "Invalid tweet URL format"
+    },
+    {
+      "code": 6045,
+      "name": "tweetAlreadyApproved",
+      "msg": "Tweet has already been approved"
     }
   ],
   "types": [
@@ -4670,6 +4754,53 @@ export type NaraAgentRegistry = {
         ]
       }
     },
+    {
+      "name": "tweetRecord",
+      "docs": [
+        "Records an approved tweet to prevent duplicate submissions.",
+        "Seeds: [SEED_TWEET_RECORD, &tweet_id.to_le_bytes()]"
+      ],
+      "serialization": "bytemuck",
+      "repr": {
+        "kind": "c",
+        "packed": true
+      },
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "agent",
+            "docs": [
+              "The agent PDA that submitted this tweet"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "approvedAt",
+            "docs": [
+              "Unix timestamp when this tweet was approved"
+            ],
+            "type": "i64"
+          },
+          {
+            "name": "tweetId",
+            "docs": [
+              "Tweet ID (Twitter snowflake ID)"
+            ],
+            "type": "u128"
+          },
+          {
+            "name": "reserved",
+            "type": {
+              "array": [
+                "u8",
+                64
+              ]
+            }
+          }
+        ]
+      }
+    },
     {
       "name": "tweetVerify",
       "docs": [
@@ -4678,7 +4809,8 @@ export type NaraAgentRegistry = {
       ],
       "serialization": "bytemuck",
       "repr": {
-        "kind": "c"
+        "kind": "c",
+        "packed": true
       },
       "type": {
         "kind": "struct",
@@ -4718,17 +4850,14 @@ export type NaraAgentRegistry = {
             "type": "i64"
           },
           {
-            "name": "tweetUrlLen",
+            "name": "tweetId",
             "docs": [
-              "Actual byte length of tweet_url"
+              "Tweet ID (Twitter snowflake ID)"
             ],
-            "type": "u64"
+            "type": "u128"
           },
           {
-            "name": "tweetUrl",
-            "docs": [
-              "Tweet URL (max 256 bytes)"
-            ],
+            "name": "reserved",
             "type": {
               "array": [
                 "u8",
@@ -4737,7 +4866,7 @@ export type NaraAgentRegistry = {
             }
           },
           {
-            "name": "reserved",
+            "name": "reserved2",
             "type": {
               "array": [
                 "u8",
@@ -4746,11 +4875,38 @@ export type NaraAgentRegistry = {
             }
           },
           {
-            "name": "reserved2",
+            "name": "reserved3",
             "type": {
               "array": [
                 "u8",
-                128
+                64
+              ]
+            }
+          },
+          {
+            "name": "reserved4",
+            "type": {
+              "array": [
+                "u8",
+                32
+              ]
+            }
+          },
+          {
+            "name": "reserved5",
+            "type": {
+              "array": [
+                "u8",
+                16
+              ]
+            }
+          },
+          {
+            "name": "reserved6",
+            "type": {
+              "array": [
+                "u8",
+                8
               ]
             }
           }