solotto 1.2.2 → 1.3.0

package/package.json

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

package/solotto.d.ts

@@ -6,6 +6,14 @@ declare module "solotto" {
 
   type PriorityLevel = "Low" | "Medium" | "High" | "VeryHigh" | "Extreme";
 
+  /** Per-call overrides for transaction priority and compute tolerance. */
+  interface TxOptions {
+    /** Priority fee level. Overrides instance default. */
+    priority?: PriorityLevel;
+    /** Compute unit safety multiplier. Overrides instance default. */
+    tolerance?: number;
+  }
+
   interface TxParams {
     /** Payer public key as a base-58 string. */
     account: string;
@@ -257,6 +265,10 @@ declare module "solotto" {
     connection: Connection;
     wss: string | false;
     program: PublicKey;
+    /** Default priority fee level for all transactions. Defaults to `"Low"`. */
+    priority: PriorityLevel;
+    /** Default compute unit safety multiplier for all transactions. Defaults to `1.2`. */
+    tolerance: number;
 
     constructor(connection: Connection, wss: string | false, program: PublicKey);
 
@@ -277,13 +289,15 @@ declare module "solotto" {
      * @param lotteryId - Lottery numeric identifier.
      * @param amount    - Number of tickets to buy (1–4, default `1`).
      * @param encoded   - If `true`, return a base64-encoded transaction.
+     * @param options   - Per-call overrides for priority and tolerance.
      */
     BuyTickets(
       buyer: Keypair,
       authority: HasPublicKey,
       lotteryId: number,
       amount?: number,
-      encoded?: boolean
+      encoded?: boolean,
+      options?: TxOptions
     ): Promise<string | TxResult>;
 
     /**
@@ -292,12 +306,14 @@ declare module "solotto" {
      * @param lotteryId - Lottery numeric identifier.
      * @param winner    - The winning ticket owner's keypair.
      * @param encoded   - If `true`, return a base64-encoded transaction.
+     * @param options   - Per-call overrides for priority and tolerance.
      */
     ClaimTicket(
       authority: HasPublicKey,
       lotteryId: number,
       winner: Keypair,
-      encoded?: boolean
+      encoded?: boolean,
+      options?: TxOptions
     ): Promise<string | string[] | TxResult>;
 
     /** Fetch the on-chain state of a lottery. */
@@ -343,6 +359,7 @@ declare module "solotto" {
      * @param amount    - Amount of SOL to boost (e.g. `0.5` for 0.5 SOL).
      * @param message   - Optional memo string attached to the transaction.
      * @param encoded   - If `true`, return a base64-encoded transaction.
+     * @param options   - Per-call overrides for priority and tolerance.
      */
     Boost(
       authority: HasPublicKey,
@@ -350,7 +367,8 @@ declare module "solotto" {
       booster: Keypair,
       amount: number,
       message?: string | false,
-      encoded?: boolean
+      encoded?: boolean,
+      options?: TxOptions
     ): Promise<string | TxResult | undefined>;
 
     /**
@@ -412,6 +430,10 @@ declare module "solotto" {
   export class LotteryManager {
     connection: Connection;
     program: PublicKey;
+    /** Default priority fee level for all transactions. Defaults to `"Low"`. */
+    priority: PriorityLevel;
+    /** Default compute unit safety multiplier for all transactions. Defaults to `1.2`. */
+    tolerance: number;
 
     constructor(connection: Connection, program: PublicKey);
 
@@ -421,12 +443,14 @@ declare module "solotto" {
      * @param ticketPrice - Ticket price in lamports.
      * @param lotteryId   - A unique numeric lottery identifier.
      * @param encoded     - If `true`, return a base64-encoded transaction.
+     * @param options     - Per-call overrides for priority and tolerance.
      */
     Initialize(
       authority: Keypair,
       ticketPrice: number,
       lotteryId: number,
-      encoded?: boolean
+      encoded?: boolean,
+      options?: TxOptions
     ): Promise<string | TxResult>;
 
     /**
@@ -434,11 +458,13 @@ declare module "solotto" {
      * @param authority - The lottery authority keypair.
      * @param lotteryId - Lottery numeric identifier.
      * @param encoded   - If `true`, return a base64-encoded transaction.
+     * @param options   - Per-call overrides for priority and tolerance.
      */
     RandomDraw(
       authority: Keypair,
       lotteryId: number,
-      encoded?: boolean
+      encoded?: boolean,
+      options?: TxOptions
     ): Promise<LotteryState | string | TxResult | undefined>;
 
     /**
@@ -447,12 +473,14 @@ declare module "solotto" {
      * @param lotteryId - Lottery numeric identifier.
      * @param lockState - `0` to lock (stop sales), `1` to unlock.
      * @param encoded   - If `true`, return a base64-encoded transaction.
+     * @param options   - Per-call overrides for priority and tolerance.
      */
     LockLottery(
       authority: Keypair,
       lotteryId: number,
       lockState: 0 | 1,
-      encoded?: boolean
+      encoded?: boolean,
+      options?: TxOptions
     ): Promise<LotteryState | string | TxResult | undefined>;
 
     /**
@@ -460,11 +488,13 @@ declare module "solotto" {
      * @param authority - The lottery authority keypair.
      * @param lotteryId - Lottery numeric identifier.
      * @param encoded   - If `true`, return a base64-encoded transaction.
+     * @param options   - Per-call overrides for priority and tolerance.
      */
     ClaimExpired(
       authority: Keypair,
       lotteryId: number,
-      encoded?: boolean
+      encoded?: boolean,
+      options?: TxOptions
     ): Promise<LotteryState | string | TxResult | undefined>;
   }
 }

package/solotto.js

@@ -188,6 +188,8 @@ class Lottery extends EventEmitter {
         this.connection=connection;
         this.wss=wss;
         this.program=program;
+        this.priority="Low";
+        this.tolerance=1.2;
         this.TICKET_STATE = BufferLayout.struct([
             publicKey("owner"),
             publicKey("lottery"),
@@ -260,7 +262,7 @@ class Lottery extends EventEmitter {
      * @param {PublicKey} winner - Keypair with no secretKey
      * @param {Boolean} encoded - true returns encoded transaction
     */
-    async ClaimTicket(authority, lotteryId, winner, encoded = false){
+    async ClaimTicket(authority, lotteryId, winner, encoded = false, options = {}){
         async function claimData() {
             const buffer = Buffer.alloc(1);
             buffer.writeUInt8(INSTRUCTIONS.CLAIM_PRIZE, 0);
@@ -284,11 +286,11 @@ class Lottery extends EventEmitter {
         _tx_.instructions = [ix];                      // array  : required
         _tx_.signers = false;                          // array  : default false
         _tx_.table = false;                            // array  : default false
-        _tx_.tolerance = 1.2;                          // int    : default 1.1    
+        _tx_.tolerance = options.tolerance ?? this.tolerance ?? 1.2;
         _tx_.compute = true;                           // bool   : default true
         _tx_.fees = true;                              // bool   : default true
-        _tx_.priority = "Low"; 
-        if(encoded){
+        _tx_.priority = options.priority ?? this.priority ?? "Low";
+if(encoded){
             _tx_.serialize = true;                        
             _tx_.encode = true;  
         }
@@ -316,7 +318,7 @@ class Lottery extends EventEmitter {
      * @param {Number} amount - Ticket Qty 1-4
      * @param {Boolean} encoded - true returns encoded transaction
     */
-    async BuyTickets(buyer, authority, lotteryId, amount = 1, encoded = false){
+    async BuyTickets(buyer, authority, lotteryId, amount = 1, encoded = false, options = {}){
         const network = new LotteryNetwork(this.connection);
         const result = await this.BundleTickets(authority, buyer, lotteryId, amount);
         const _tx_ = {};
@@ -324,11 +326,11 @@ class Lottery extends EventEmitter {
         _tx_.instructions = result.ixs;                // array  : required
         _tx_.signers = result.signers;                 // array  : default false
         _tx_.table = false;                            // array  : default false
-        _tx_.tolerance = 1.2;                          // int    : default 1.1    
+        _tx_.tolerance = options.tolerance ?? this.tolerance ?? 1.2;
         _tx_.compute = true;                           // bool   : default true
         _tx_.fees = true;                              // bool   : default true
-        _tx_.priority = "Low"; 
-        if(encoded){
+        _tx_.priority = options.priority ?? this.priority ?? "Low";
+if(encoded){
             _tx_.serialize = true;                        
             _tx_.encode = true;  
         }
@@ -636,7 +638,7 @@ class Lottery extends EventEmitter {
      * @param {Number} amount - The amount of sol to boost
      * @param {Boolean} encoded - true returns encoded transaction
     */
-    async Boost(authority, lotteryId, booster, amount, message = false, encoded = false) {
+    async Boost(authority, lotteryId, booster, amount, message = false, encoded = false, options = {}) {
         try{
             async function boostData(lotId, amount) {
                 const lamports = parseInt(amount * LAMPORTS_PER_SOL);
@@ -664,10 +666,11 @@ class Lottery extends EventEmitter {
             _tx_.instructions = [ix];                      // array  : required
             _tx_.signers = false;                          // array  : default false
             _tx_.table = false;                            // array  : default false
-            _tx_.tolerance = 1.2;                          // int    : default 1.1    
+            _tx_.tolerance = options.tolerance ?? this.tolerance ?? 1.2;
             _tx_.compute = true;                           // bool   : default true
             _tx_.fees = true;                              // bool   : default true
-            _tx_.priority = "Low";                         // string : default Low
+            _tx_.priority = options.priority ?? this.priority ?? "Low";
+
             _tx_.memo = message;
             if(encoded){
                 _tx_.serialize = true;                        
@@ -821,7 +824,7 @@ class LotteryManager {
     * @param {Connection} connection - Solana connection
     * @param {PublicKey} program - Lottery Program Id 
     */
-    constructor(connection, program){this.connection=connection;this.program=program;}
+    constructor(connection, program){this.connection=connection;this.program=program;this.priority="Low";this.tolerance=1.2;}
     
     /*** 
      * @param {Keypair} authority - Keypair
@@ -829,7 +832,7 @@ class LotteryManager {
      * @param {String} lotteryId - String 
      * @param {Boolean} encoded - true returns encoded transaction
     */
-    async Initialize(authority, ticketPrice, lotteryId, encoded = false){
+    async Initialize(authority, ticketPrice, lotteryId, encoded = false, options = {}){
         const lottery = new Lottery(this.connection, false, this.program);
         const network = new LotteryNetwork(this.connection);
         async function initializeData(tketPrice, lotId) {
@@ -857,10 +860,11 @@ class LotteryManager {
         _tx_.instructions = [ix];                      // array  : required
         _tx_.signers = false;                          // array  : default false
         _tx_.table = false;                            // array  : default false
-        _tx_.tolerance = 1.2;                          // int    : default 1.1    
+        _tx_.tolerance = options.tolerance ?? this.tolerance ?? 1.2;
         _tx_.compute = true;                           // bool   : default true
         _tx_.fees = true;                              // bool   : default true
-        _tx_.priority = "Low";                         // string : default Low
+        _tx_.priority = options.priority ?? this.priority ?? "Low";
+
         if(encoded){
             _tx_.serialize = true;                        
             _tx_.encode = true;  
@@ -885,7 +889,7 @@ class LotteryManager {
      * @param {String} lotteryId - The lottery id
      * @param {Boolean} encoded - true returns encoded transaction
     */
-    async RandomDraw(authority, lotteryId, encoded = false) {
+    async RandomDraw(authority, lotteryId, encoded = false, options = {}) {
         try{
             async function randomnessData() {
                 const buffer = Buffer.alloc(1);
@@ -908,10 +912,11 @@ class LotteryManager {
             _tx_.instructions = [ix];                      // array  : required
             _tx_.signers = false;                          // array  : default false
             _tx_.table = false;                            // array  : default false
-            _tx_.tolerance = 1.2;                          // int    : default 1.1    
+            _tx_.tolerance = options.tolerance ?? this.tolerance ?? 1.2;
             _tx_.compute = true;                           // bool   : default true
             _tx_.fees = true;                              // bool   : default true
-            _tx_.priority = "Low";                         // string : default Low
+            _tx_.priority = options.priority ?? this.priority ?? "Low";
+
             _tx_.memo = "draw";
             if(encoded){
                 _tx_.serialize = true;                        
@@ -946,7 +951,7 @@ class LotteryManager {
      * @param {Number} lockState - 0 = lock ticket sales, 1 = unlock (requires authority)
      * @param {Boolean} encoded - true returns encoded transaction
     */
-    async LockLottery(authority, lotteryId, lockState, encoded = false) {
+    async LockLottery(authority, lotteryId, lockState, encoded = false, options = {}) {
         try{
             async function lockData(lock) {
                 const buffer = Buffer.alloc(2); // 1 byte discriminator + 1 bytes lock status
@@ -967,10 +972,11 @@ class LotteryManager {
             _tx_.instructions = [ix];                      // array  : required
             _tx_.signers = false;                          // array  : default false
             _tx_.table = false;                            // array  : default false
-            _tx_.tolerance = 1.2;                          // int    : default 1.1    
+            _tx_.tolerance = options.tolerance ?? this.tolerance ?? 1.2;
             _tx_.compute = true;                           // bool   : default true
             _tx_.fees = true;                              // bool   : default true
-            _tx_.priority = "Low";                         // string : default Low
+            _tx_.priority = options.priority ?? this.priority ?? "Low";
+
             _tx_.memo = false;
             if(encoded){
                 _tx_.serialize = true;                        
@@ -1004,7 +1010,7 @@ class LotteryManager {
      * @param {String} lotteryId - The lottery id
      * @param {Boolean} encoded - true returns encoded transaction
     */
-    async ClaimExpired(authority, lotteryId, encoded = false) {
+    async ClaimExpired(authority, lotteryId, encoded = false, options = {}) {
         try{
             async function expiredData() {
                 const buffer = Buffer.alloc(1); // 1 byte discriminator + 1 bytes lock status
@@ -1026,10 +1032,11 @@ class LotteryManager {
             _tx_.instructions = [ix];                      // array  : required
             _tx_.signers = false;                          // array  : default false
             _tx_.table = false;                            // array  : default false
-            _tx_.tolerance = 1.2;                          // int    : default 1.1    
+            _tx_.tolerance = options.tolerance ?? this.tolerance ?? 1.2;
             _tx_.compute = true;                           // bool   : default true
             _tx_.fees = true;                              // bool   : default true
-            _tx_.priority = "Low";                         // string : default Low
+            _tx_.priority = options.priority ?? this.priority ?? "Low";
+
             _tx_.memo = false;
             if(encoded){
                 _tx_.serialize = true;