solotto 1.1.2 → 1.1.4

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)
@@ -311,7 +312,7 @@ const result = await lottery.Boost(authority, lotteryId, booster, 1.0, "Good luc
 
 #### GetBoosters
 
-Retrieves boost history by scanning on-chain program logs for boost transactions. Filters out errored and non-finalized transactions, and only includes boosts of at least 0.0001 SOL. Can filter by authority, lottery ID, or both, and optionally group results by booster wallet address.
+Retrieves boost history by scanning on-chain program logs for boost transactions. Filters out errored and non-finalized transactions. Can filter by authority, lottery ID, or both, and optionally group results by booster wallet address.
 
 ```js
 // Get all boosters for a specific lottery
@@ -366,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.

package/package.json

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

package/solotto.d.ts

@@ -181,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). */
@@ -367,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

@@ -746,7 +746,7 @@ class Lottery extends EventEmitter {
                 // Apply filters with safety checks
                 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){
+                if(matchesAuthority && matchesLotteryId){
                     item.time = init.blockTime;
                     item.signature = init.signature;
                     result.push(item);
@@ -774,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 {