solotto 1.1.0 → 1.1.2

package/README.md

@@ -25,6 +25,7 @@ A JavaScript SDK for interacting with the Solotto on-chain lottery program on So
     - [Boost](#boost)
     - [GetBoosters](#getboosters)
     - [GetLottery](#getlottery)
+    - [GetLotteries](#getlotteries)
     - [GetTicket](#getticket)
     - [GetTickets](#gettickets)
     - [WatchDraw](#watchdraw)
@@ -340,6 +341,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...",
   },
   // ...
@@ -352,7 +354,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
@@ -400,6 +402,30 @@ const state = await lottery.GetLottery(authority, lotteryId, fees);
 
 ---
 
+#### GetLotteries
+
+Fetches all lottery accounts from the program, optionally filtered by authority. Returns an array of lottery state objects sorted descending by lottery ID.
+
+```js
+// Get all lotteries across all authorities
+const allLotteries = await lottery.GetLotteries();
+
+// Get all lotteries for a specific authority
+const myLotteries = await lottery.GetLotteries(authority);
+
+// Get all lotteries with raw prize pool (no fee deduction)
+const raw = await lottery.GetLotteries(authority, false);
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `authority` | `{publicKey} \| false` | `false` | Filter by lottery authority. Pass `false` to include all authorities. |
+| `fees` | `Boolean` | `true` | If `true`, `prizePoolBalance` reflects a 10% fee deduction. |
+
+**Returns:** An array of `LotteryState` objects (same shape as `GetLottery`), sorted descending by `lotteryId`.
+
+---
+
 #### GetTicket
 
 Fetches a single ticket by its ticket number.
@@ -432,7 +458,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
@@ -443,6 +469,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 |
@@ -451,6 +480,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):**
 
@@ -467,6 +497,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
   ],
@@ -486,7 +517,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.0",
+  "version": "1.1.2",
   "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;
   }
@@ -292,6 +296,17 @@ declare module "solotto" {
       fees?: boolean
     ): Promise<LotteryState>;
 
+    /**
+     * Fetch all lottery accounts, optionally filtered by authority.
+     * @param authority - Filter by lottery authority, or `false` for all.
+     * @param fees      - If `true`, deduct 10% from prize pool balance.
+     * @returns Array of lottery states sorted descending by lotteryId.
+     */
+    GetLotteries(
+      authority?: HasPublicKey | false,
+      fees?: boolean
+    ): Promise<LotteryState[]>;
+
     /** Fetch a single ticket by its ticket number. */
     GetTicket(
       authority: HasPublicKey,
@@ -299,12 +314,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>;
 
     /**

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++;
         }
@@ -502,6 +507,32 @@ class Lottery extends EventEmitter {
         const account = await this.connection.getAccountInfo(lotteryPDA);
         return await this.DecodeLotteryState(account.data, fees);
     }
+
+    /*** 
+     * @param {PublicKey} authority - Keypair with no secretKey
+     * @param {Boolean} fees - true = prize pool - 10% (for display before drawing)
+    */
+    async GetLotteries(authority=false, fees=true) {
+        try{
+            const result = [];
+            let filters;
+            if(authority){
+                filters = [
+                    {dataSize: 150},
+                    {memcmp:{offset: 0, bytes: authority.publicKey.toString(),},}
+                ];
+            }
+            else{filters = [{dataSize: 150}];}
+            const data = await this.connection.getProgramAccounts(this.program, {filters:filters,});
+            for await (const datum of data) {
+                const decoded = await this.DecodeLotteryState(datum.account.data, fees);
+                result.push(decoded);
+            }
+            return result.sort((a, b) => b.lotteryId - a.lotteryId);
+        }
+        catch(err){return result;}
+    }
+
     async DecodeLotteryState(buffer, fees = true){
         let offset = 0;
         // Helper to handle the 1-byte Option flag
@@ -552,7 +583,7 @@ class Lottery extends EventEmitter {
             releaseTime = readOption(() => {
                 const val = buffer.readBigUInt64LE(offset);
                 offset += 8;
-                return Number(releaseTime);
+                return Number(val);
             });
         }catch{}
         const prizePoolAddress = await this.DerivePrizePoolPDA();
@@ -706,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();
@@ -715,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);
                 }