solotto 1.1.4 → 1.1.5

package/README.md

@@ -494,7 +494,7 @@ const ticket = await lottery.GetTicket(authority, lotteryId, ticketNumber);
 
 #### GetTickets
 
-Fetches all tickets for a lottery, optionally filtered by buyer, grouped by owner, and/or enriched with purchase timestamps.
+Fetches all tickets for a lottery, optionally filtered by buyer, grouped by owner, and/or enriched with purchase timestamps and transaction signatures.
 
 ```js
 // Get all tickets
@@ -508,6 +508,9 @@ 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);
+
+// Get all tickets with timestamps and signatures
+const full = await lottery.GetTickets(authority, lotteryId, false, false, true, true);
 ```
 
 | Parameter | Type | Default | Description |
@@ -516,7 +519,10 @@ const withTime = await lottery.GetTickets(authority, lotteryId, false, false, tr
 | `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). |
+| `time` | `Boolean` | `false` | If `true`, includes the block timestamp for each ticket. |
+| `signature` | `Boolean` | `false` | If `true`, includes the transaction signature for each ticket. |
+
+> **Note:** The `time` and `signature` options share a single RPC call per ticket, so enabling both does not double the number of requests.
 
 **Returns (ungrouped):**
 
@@ -534,6 +540,7 @@ const withTime = await lottery.GetTickets(authority, lotteryId, false, false, tr
       ticketNumber: 42,
       ticketPda: "Pubkey...",
       time: null,              // Unix timestamp when time=true, null otherwise
+      signature: "TxSig...",   // Present only when signature=true
     },
     // ... sorted descending by ticket number
   ],

package/package.json

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

package/solotto.d.ts

@@ -107,6 +107,8 @@ declare module "solotto" {
     ticketPda: string;
     /** Unix block timestamp of ticket purchase, or `null` when `time=false`. */
     time: number | null;
+    /** Transaction signature. Present only when `signature=true`. */
+    signature?: string;
   }
 
   interface GroupedTicketOwner {
@@ -323,13 +325,14 @@ declare module "solotto" {
       ticket: number
     ): Promise<TicketInfo>;
 
-    /** Fetch all tickets for a lottery, optionally filtered by buyer, grouped by owner, and/or with timestamps. */
+    /** Fetch all tickets for a lottery, optionally filtered by buyer, grouped by owner, and/or with timestamps and signatures. */
     GetTickets(
       authority: HasPublicKey,
       lotteryId: number,
       buyer?: HasPublicKey | false,
       group?: boolean,
-      time?: boolean
+      time?: boolean,
+      signature?: 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, time = false) {
+    async GetTickets(authority, lotteryId, buyer = false, group = false, time = false, signature = false) {
         const [lotteryPDA] = await this.DeriveLotteryPDA(authority.publicKey, lotteryId);
         const filters = [];
         filters.push({dataSize: 104});
@@ -460,10 +460,10 @@ class Lottery extends EventEmitter {
             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;
-            }
+            let dat = null;
+            if(time || signature){dat = await this.connection.getSignaturesForAddress(data.pubkey, "finalized");}
+            if(time){newTicket.time = dat[0].blockTime;}
+            if(signature){newTicket.signature = dat[0].signature;}
             tickets.push(newTicket);
             i++;
         }