solotto 1.1.1 → 1.1.3

package/README.md

@@ -24,6 +24,7 @@ A JavaScript SDK for interacting with the Solotto on-chain lottery program on So
     - [ClaimTicket](#claimticket)
     - [Boost](#boost)
     - [GetBoosters](#getboosters)
+    - [GetMessages](#getmessages)
     - [GetLottery](#getlottery)
     - [GetLotteries](#getlotteries)
     - [GetTicket](#getticket)
@@ -341,6 +342,7 @@ const grouped = await lottery.GetBoosters(authority, lotteryId, true);
     authority: "Pubkey...",     // Lottery authority public key
     amount: 0.5,                // Boost amount in SOL
     message: "Good luck!",     // Optional memo message (empty string if none)
+    time: 1700000000,          // Unix block timestamp of the boost transaction
     signature: "TxSignature...",
   },
   // ...
@@ -353,7 +355,7 @@ const grouped = await lottery.GetBoosters(authority, lotteryId, true);
 {
   "BoosterPubkey...": {
     boost: [
-      { booster: "Pubkey...", lotteryId: 1, authority: "Pubkey...", amount: 0.5, message: "...", signature: "TxSig..." },
+      { booster: "Pubkey...", lotteryId: 1, authority: "Pubkey...", amount: 0.5, message: "...", time: 1700000000, signature: "TxSig..." },
       // ...
     ],
     total: 1.5,    // Sum of all boost amounts in SOL
@@ -365,6 +367,41 @@ const grouped = await lottery.GetBoosters(authority, lotteryId, true);
 
 ---
 
+#### GetMessages
+
+Retrieves boost memo messages from on-chain transaction history. Paginates through program signatures and extracts messages from transactions tagged with `:booster:`. Useful for displaying a feed of booster shoutouts.
+
+```js
+// Get the latest boost messages (up to 1000)
+const messages = await lottery.GetMessages();
+
+// Get up to 200 messages
+const recent = await lottery.GetMessages(200);
+
+// Paginate: get messages until a specific signature
+const older = await lottery.GetMessages(1000, "LastKnownSignature...");
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `limit` | `Number` | `1000` | Maximum number of transactions to scan. Paginates automatically if needed. |
+| `until` | `String \| null` | `null` | Stop scanning at this transaction signature (exclusive). Useful for pagination. |
+
+**Returns:** An array of message objects:
+
+```js
+[
+  {
+    message: "Good luck everyone!",   // The booster's memo text
+    time: 1700000000,                  // Unix block timestamp
+    signature: "TxSignature...",       // Transaction signature
+  },
+  // ...
+]
+```
+
+---
+
 #### GetLottery
 
 Fetches the full on-chain state of a lottery.
@@ -457,7 +494,7 @@ const ticket = await lottery.GetTicket(authority, lotteryId, ticketNumber);
 
 #### GetTickets
 
-Fetches all tickets for a lottery, optionally filtered by buyer and/or grouped by owner.
+Fetches all tickets for a lottery, optionally filtered by buyer, grouped by owner, and/or enriched with purchase timestamps.
 
 ```js
 // Get all tickets
@@ -468,6 +505,9 @@ const myTickets = await lottery.GetTickets(authority, lotteryId, buyer);
 
 // Get all tickets grouped by owner
 const grouped = await lottery.GetTickets(authority, lotteryId, false, true);
+
+// Get all tickets with purchase timestamps
+const withTime = await lottery.GetTickets(authority, lotteryId, false, false, true);
 ```
 
 | Parameter | Type | Default | Description |
@@ -476,6 +516,7 @@ const grouped = await lottery.GetTickets(authority, lotteryId, false, true);
 | `lotteryId` | `Number` | — | The lottery ID. |
 | `buyer` | `{publicKey} \| false` | `false` | Optional buyer to filter by. |
 | `group` | `Boolean` | `false` | If `true`, groups tickets by owner. |
+| `time` | `Boolean` | `false` | If `true`, fetches the block timestamp for each ticket (slower — requires extra RPC calls). |
 
 **Returns (ungrouped):**
 
@@ -492,6 +533,7 @@ const grouped = await lottery.GetTickets(authority, lotteryId, false, true);
       ticketReceipt: "Pubkey...",
       ticketNumber: 42,
       ticketPda: "Pubkey...",
+      time: null,              // Unix timestamp when time=true, null otherwise
     },
     // ... sorted descending by ticket number
   ],
@@ -511,7 +553,7 @@ const grouped = await lottery.GetTickets(authority, lotteryId, false, true);
       owner: "Pubkey...",
       ticketCount: 3,
       tickets: [
-        { owner: "Pubkey...", lottery: "Pubkey...", ticketReceipt: "Pubkey...", ticketNumber: 42, ticketPda: "Pubkey..." },
+        { owner: "Pubkey...", lottery: "Pubkey...", ticketReceipt: "Pubkey...", ticketNumber: 42, ticketPda: "Pubkey...", time: null },
         // ...
       ],
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solotto",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Solana lottery client",
   "type": "module",
   "types": "./solotto.d.ts",

package/solotto.d.ts

@@ -105,6 +105,8 @@ declare module "solotto" {
     ticketReceipt: string;
     ticketNumber: number;
     ticketPda: string;
+    /** Unix block timestamp of ticket purchase, or `null` when `time=false`. */
+    time: number | null;
   }
 
   interface GroupedTicketOwner {
@@ -160,6 +162,8 @@ declare module "solotto" {
     amount: number;
     /** Optional memo message from the booster. */
     message: string;
+    /** Unix block timestamp of the boost transaction. */
+    time: number;
     /** Transaction signature. */
     signature: string;
   }
@@ -177,6 +181,15 @@ declare module "solotto" {
     [boosterAddress: string]: GroupedBooster;
   }
 
+  interface MessageRecord {
+    /** The booster's memo text. */
+    message: string;
+    /** Unix block timestamp of the transaction. */
+    time: number;
+    /** Transaction signature. */
+    signature: string;
+  }
+
   // ── Authority-like objects ────────────────────────────────────────────
 
   /** An object with at least a `publicKey` property (e.g. a Keypair without the secret key). */
@@ -310,12 +323,13 @@ declare module "solotto" {
       ticket: number
     ): Promise<TicketInfo>;
 
-    /** Fetch all tickets for a lottery, optionally filtered by buyer and/or grouped by owner. */
+    /** Fetch all tickets for a lottery, optionally filtered by buyer, grouped by owner, and/or with timestamps. */
     GetTickets(
       authority: HasPublicKey,
       lotteryId: number,
       buyer?: HasPublicKey | false,
-      group?: boolean
+      group?: boolean,
+      time?: boolean
     ): Promise<TicketListResult>;
 
     /**
@@ -362,6 +376,16 @@ declare module "solotto" {
       limit?: number
     ): Promise<BoosterRecord[] | GroupedBoostersResult>;
 
+    /**
+     * Retrieve boost memo messages from on-chain transaction history.
+     * @param limit - Maximum number of transactions to scan (paginates automatically).
+     * @param until - Stop scanning at this transaction signature (exclusive).
+     */
+    GetMessages(
+      limit?: number,
+      until?: string | null
+    ): Promise<MessageRecord[]>;
+
     /** Derive the lottery PDA. */
     DeriveLotteryPDA(
       authority: PublicKey,

package/solotto.js

@@ -441,7 +441,7 @@ class Lottery extends EventEmitter {
      * @param {Number} lotteryId - Lottery Id 
      * @param {PublicKey} buyer - Ticket Buyer Optional
     */
-    async GetTickets(authority, lotteryId, buyer = false, group = false) {
+    async GetTickets(authority, lotteryId, buyer = false, group = false, time = false) {
         const [lotteryPDA] = await this.DeriveLotteryPDA(authority.publicKey, lotteryId);
         const filters = [];
         filters.push({dataSize: 104});
@@ -459,6 +459,11 @@ class Lottery extends EventEmitter {
             newTicket.ticketReceipt = new PublicKey(decoded.ticketReceipt).toString();
             newTicket.ticketNumber = parseInt(new BN(decoded.ticketNumber, 10, "le"));
             newTicket.ticketPda = data.pubkey.toString();
+            newTicket.time = null;
+            if(time){
+                const dat = await this.connection.getSignaturesForAddress(data.pubkey, "finalized");
+                newTicket.time = dat[0].blockTime;
+            }
             tickets.push(newTicket);
             i++;
         }
@@ -732,6 +737,7 @@ class Lottery extends EventEmitter {
                     else if(log.includes("Program log: Memo ")){
                         const parts = log.split(":booster:");
                         item.message = parts[1].slice(0, -1).trim();
+                        item.message = item.message.replace(new RegExp("\\\\", "g"), "");
                     }
                     else if(log.includes("Program log: Authority ")){
                         item.authority = log.replace("Program log: Authority ","").trim();
@@ -741,6 +747,7 @@ class Lottery extends EventEmitter {
                 const matchesAuthority = authority ? (item.authority && authority.publicKey.toString() === item.authority) : true;
                 const matchesLotteryId = lotteryId ? (item.lotteryId !== undefined && lotteryId.toString() === item.lotteryId.toString()) : true;
                 if(matchesAuthority && matchesLotteryId && item.amount >= 0.0001){
+                    item.time = init.blockTime;
                     item.signature = init.signature;
                     result.push(item);
                 }
@@ -767,6 +774,45 @@ class Lottery extends EventEmitter {
         catch (error) {return error;}
     }
 
+    /**
+     * @param {Number} limit - the results to request (max 1000)
+     * @param {String} until - until signature to stop at (optional)
+     * @returns {Array|Object} - Array of booster objects or grouped booster objects if group=true
+    */
+    async GetMessages(limit = 1000, until = null) {
+        try {
+            const result = [];
+            let allSignatures = [];
+            let lastSignature = null;
+            while (allSignatures.length < limit) {
+                const options = {limit: Math.min(1000, limit - allSignatures.length)};
+                if (lastSignature) {options.before = lastSignature;}
+                if (until) {options.until = until;}
+                const signatures = await this.connection.getSignaturesForAddress(this.program, options);
+                if (signatures.length === 0) break;
+                allSignatures.push(...signatures);
+                lastSignature = signatures[signatures.length - 1].signature;
+                if (signatures.length < options.limit) break;
+            }
+            for (const row of allSignatures) {
+                if (!row.err && 
+                    row.confirmationStatus === "finalized" && 
+                    row.memo && 
+                    row.memo.includes(":booster:")) {
+                    const memo = {
+                        message: row.memo.split(":booster:")[1].trim(),
+                        time: row.blockTime,
+                        signature: row.signature
+                    };
+                    result.push(memo);
+                }
+            }
+            return result;
+        } catch (error) {
+            return error;
+        }
+    }
+
 }
 
 class LotteryManager {