@wireio/stake 0.4.1 → 0.4.2

package/lib/stake.d.ts

@@ -10,7 +10,7 @@ import { BN, AnchorProvider, Program } from '@coral-xyz/anchor';
 
 type StakerConfig = {
     network: ExternalNetwork;
-    provider: BaseSignerWalletAdapter | ethers.providers.Web3Provider;
+    provider?: BaseSignerWalletAdapter | ethers.providers.Web3Provider;
     pubKey?: PublicKey;
 };
 interface IStakingClient {
@@ -24,6 +24,8 @@ interface IStakingClient {
     buy(amount: bigint): Promise<string>;
     /** Fetch the complete user portfolio */
     getPortfolio(): Promise<Portfolio>;
+    getSystemAPY(): Promise<number>;
+    getDepositFee(amount: bigint): Promise<bigint>;
     /**
      * Program-level prelaunch WIRE/tranche snapshot for this chain.
      *
@@ -330,9 +332,9 @@ declare namespace types$1 {
 
 declare class EthereumStakingClient implements IStakingClient {
     private config;
-    readonly pubKey?: PublicKey;
     private readonly provider;
-    private readonly signer;
+    readonly pubKey?: PublicKey;
+    private readonly signer?;
     private readonly contractService;
     private convertClient;
     private pretokenClient;
@@ -388,15 +390,6 @@ declare class EthereumStakingClient implements IStakingClient {
      */
     unstakePrelaunch(tokenId: bigint, recipient: string): Promise<string>;
     buy(amount: bigint): Promise<string>;
-    getOPPMessages(address?: string): Promise<OPPAssertion[]>;
-    getOPPStatus(): Promise<any>;
-    /**
-     * ETH Prelaunch function to list the Stake ReceiptNFTs owned by a specific user
-     * @param address address to query the receipts for
-     * @returns array of receipts
-     */
-    fetchPrelaunchReceipts(address?: string): Promise<preLaunchReceipt[]>;
-    getEthStats(): Promise<any>;
     /**
      * Resolve the user's ETH + liqETH balances.
      *
@@ -405,8 +398,22 @@ declare class EthereumStakingClient implements IStakingClient {
      * tracked = liqETH tracked balance (protocol/accounting view)
      */
     getPortfolio(): Promise<Portfolio>;
+    /**
+     * ETH Prelaunch function to list the Stake ReceiptNFTs owned by a specific user
+     * @param address address to query the receipts for
+     * @returns array of receipts
+     */
+    fetchPrelaunchReceipts(address?: string): Promise<preLaunchReceipt[]>;
+    getOPPMessages(address?: string): Promise<OPPAssertion[]>;
+    private ensureUser;
+    getSystemAPY(): Promise<number>;
+    getDepositFee(amount: bigint): Promise<bigint>;
+    getOPPStatus(): Promise<any>;
+    getEthStats(): Promise<any>;
     /**
      * Program-level prelaunch WIRE / tranche snapshot for Ethereum
+     *
+     * SUPPORTS READ-ONLY ACcESS
      */
     getTrancheSnapshot(options?: {
         chainID?: ChainID;
@@ -7432,6 +7439,13 @@ declare class SolanaStakingClient implements IStakingClient {
      *  - extras: useful internal addresses and raw state for debugging/UX
      */
     getPortfolio(): Promise<Portfolio>;
+    /**
+     * Convenience helper to fetch the distribution userRecord for the current user.
+     * Used by balance-correction flows and debugging.
+     */
+    getUserRecord(): Promise<DistributionUserRecord | null>;
+    getSystemAPY(): Promise<number>;
+    getDepositFee(amount: bigint): Promise<bigint>;
     /**
      * Unified, chain-agnostic tranche snapshot for Solana.
      *
@@ -7447,11 +7461,6 @@ declare class SolanaStakingClient implements IStakingClient {
         windowBefore?: number;
         windowAfter?: number;
     }): Promise<TrancheSnapshot>;
-    /**
-     * Convenience helper to fetch the distribution userRecord for the current user.
-     * Used by balance-correction flows and debugging.
-     */
-    getUserRecord(): Promise<DistributionUserRecord | null>;
     /**
      * Send a signed transaction over HTTP RPC and wait for confirmation.
      * Throws if the transaction fails.
@@ -7479,7 +7488,7 @@ declare class SolanaStakingClient implements IStakingClient {
      * Guard for all write operations (deposit/withdraw/stake/unstake/buy).
      * Ensures we have a Wire pubKey and an Anchor wallet pubKey, and that they match.
      */
-    ensureWriteAccess(): void;
+    ensureUser(): void;
 }
 
 /**

package/lib/stake.js

@@ -8565,7 +8565,7 @@ class SolanaStakingClient {
   }
   deposit(amountLamports) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       if (amountLamports <= BigInt(0)) {
         throw new Error("Deposit amount must be greater than zero.");
       }
@@ -8580,7 +8580,7 @@ class SolanaStakingClient {
   }
   withdraw(amountLamports) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       if (amountLamports <= BigInt(0)) {
         throw new Error("Withdraw amount must be greater than zero.");
       }
@@ -8595,7 +8595,7 @@ class SolanaStakingClient {
   }
   stake(amountLamports) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       if (!amountLamports || amountLamports <= BigInt(0)) {
         throw new Error("Stake amount must be greater than zero.");
       }
@@ -8609,7 +8609,7 @@ class SolanaStakingClient {
   }
   unstake(amountLamports) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       if (!amountLamports || amountLamports <= BigInt(0)) {
         throw new Error("Unstake amount must be greater than zero.");
       }
@@ -8623,7 +8623,7 @@ class SolanaStakingClient {
   }
   buy(amountLamports) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       if (!amountLamports || amountLamports <= BigInt(0)) {
         throw new Error("liqSOL pretoken purchase requires a positive amount.");
       }
@@ -8725,6 +8725,18 @@ class SolanaStakingClient {
       };
     });
   }
+  getUserRecord() {
+    return __async$8(this, null, function* () {
+      if (!this.pubKey) throw new Error("User pubKey is undefined");
+      return this.distributionClient.getUserRecord(this.solPubKey);
+    });
+  }
+  getSystemAPY() {
+    return Promise.resolve(0);
+  }
+  getDepositFee(amount) {
+    return Promise.resolve(BigInt(0));
+  }
   getTrancheSnapshot(options) {
     return __async$8(this, null, function* () {
       const {
@@ -8748,15 +8760,9 @@ class SolanaStakingClient {
       });
     });
   }
-  getUserRecord() {
-    return __async$8(this, null, function* () {
-      if (!this.pubKey) throw new Error("User pubKey is undefined");
-      return this.distributionClient.getUserRecord(this.solPubKey);
-    });
-  }
   sendAndConfirmHttp(signed, ctx) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       const signature = yield this.connection.sendRawTransaction(
         signed.serialize(),
         {
@@ -8783,13 +8789,13 @@ class SolanaStakingClient {
   }
   signTransaction(tx) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       return this.anchor.wallet.signTransaction(tx);
     });
   }
   sendTransaction(signed) {
     return __async$8(this, null, function* () {
-      this.ensureWriteAccess();
+      this.ensureUser();
       return this.anchor.sendAndConfirm(signed);
     });
   }
@@ -8801,7 +8807,7 @@ class SolanaStakingClient {
       return { tx, blockhash, lastValidBlockHeight };
     });
   }
-  ensureWriteAccess() {
+  ensureUser() {
     if (!this.pubKey || !this.anchor.wallet.publicKey) {
       throw new Error("User Authorization required: pubKey is undefined");
     }
@@ -29640,8 +29646,12 @@ class EthereumStakingClient {
   constructor(config) {
     this.config = config;
     try {
-      this.provider = config.provider;
-      this.signer = this.provider.getSigner();
+      if (config.provider) {
+        this.provider = config.provider;
+        this.signer = this.provider.getSigner();
+      } else {
+        this.provider = new ethers.ethers.providers.JsonRpcProvider(config.network.rpcUrls[0]);
+      }
       this.pubKey = config.pubKey;
       this.contractService = new EthereumContractService({
         provider: this.provider,
@@ -29664,6 +29674,7 @@ class EthereumStakingClient {
   }
   deposit(amount) {
     return __async(this, null, function* () {
+      this.ensureUser();
       const amountWei = ethers.BigNumber.isBigNumber(amount) ? amount : ethers.BigNumber.from(amount);
       const result = yield this.convertClient.performDeposit(amountWei);
       return result.txHash;
@@ -29671,6 +29682,7 @@ class EthereumStakingClient {
   }
   withdraw(amount) {
     return __async(this, null, function* () {
+      this.ensureUser();
       const address = yield this.signer.getAddress();
       const amountWei = ethers.BigNumber.from(amount);
       const result = yield this.convertClient.performWithdraw(address, amountWei);
@@ -29679,6 +29691,7 @@ class EthereumStakingClient {
   }
   stake(amount) {
     return __async(this, null, function* () {
+      this.ensureUser();
       const walletAddress = yield this.signer.getAddress();
       const amountWei = ethers.BigNumber.from(amount);
       const result = yield this.stakeClient.performStake(amountWei, walletAddress);
@@ -29692,6 +29705,7 @@ class EthereumStakingClient {
   }
   unstakePrelaunch(tokenId, recipient) {
     return __async(this, null, function* () {
+      this.ensureUser();
       const tokenIdBigNum = ethers.BigNumber.from(tokenId);
       const result = yield this.stakeClient.performWithdrawStake(tokenIdBigNum, recipient);
       return result.txHash;
@@ -29699,44 +29713,17 @@ class EthereumStakingClient {
   }
   buy(amount) {
     return __async(this, null, function* () {
+      this.ensureUser();
       const buyer = yield this.signer.getAddress();
       yield this.updateMockAggregatorPrice();
       let result = yield this.pretokenClient.purchasePretokensWithLiqETH(amount, buyer);
       return result && result.txHash ? result.txHash : "Error - no resulting txHash";
     });
   }
-  getOPPMessages(address) {
-    return __async(this, null, function* () {
-      if (!address) address = yield this.signer.getAddress();
-      return yield this.oppClient.getMessages(address);
-    });
-  }
-  getOPPStatus() {
-    return __async(this, null, function* () {
-      return yield this.oppClient.getStatus();
-    });
-  }
-  fetchPrelaunchReceipts(address) {
-    return __async(this, null, function* () {
-      if (address === void 0) address = yield this.signer.getAddress();
-      return yield this.receiptClient.stakeReceipts(address);
-    });
-  }
-  getEthStats() {
-    return __async(this, null, function* () {
-      let withdrawDelay = yield this.contract.DepositManager.withdrawDelay();
-      let minDeposit = yield this.contract.DepositManager.minDeposit();
-      let rewardCooldown = yield this.contract.DepositManager.rewardCooldown();
-      return {
-        withdrawDelay,
-        minDeposit,
-        rewardCooldown
-      };
-    });
-  }
   getPortfolio() {
     return __async(this, null, function* () {
       var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+      this.ensureUser();
       const walletAddress = yield this.signer.getAddress();
       const nativeBalance = yield this.provider.getBalance(walletAddress);
       const nativeDecimals = (_c = (_b = (_a = this.network) == null ? void 0 : _a.nativeCurrency) == null ? void 0 : _b.decimals) != null ? _c : 18;
@@ -29775,6 +29762,50 @@ class EthereumStakingClient {
       return portfolio;
     });
   }
+  fetchPrelaunchReceipts(address) {
+    return __async(this, null, function* () {
+      this.ensureUser();
+      if (address === void 0) address = yield this.signer.getAddress();
+      return yield this.receiptClient.stakeReceipts(address);
+    });
+  }
+  getOPPMessages(address) {
+    return __async(this, null, function* () {
+      this.ensureUser();
+      if (!address) address = yield this.signer.getAddress();
+      return yield this.oppClient.getMessages(address);
+    });
+  }
+  ensureUser() {
+    if (!this.signer) {
+      throw new Error(
+        "EthereumStakingClient: write operation requires a wallet-connected Web3 provider"
+      );
+    }
+  }
+  getSystemAPY() {
+    return Promise.resolve(0);
+  }
+  getDepositFee(amount) {
+    return Promise.resolve(BigInt(0));
+  }
+  getOPPStatus() {
+    return __async(this, null, function* () {
+      return yield this.oppClient.getStatus();
+    });
+  }
+  getEthStats() {
+    return __async(this, null, function* () {
+      let withdrawDelay = yield this.contract.DepositManager.withdrawDelay();
+      let minDeposit = yield this.contract.DepositManager.minDeposit();
+      let rewardCooldown = yield this.contract.DepositManager.rewardCooldown();
+      return {
+        withdrawDelay,
+        minDeposit,
+        rewardCooldown
+      };
+    });
+  }
   getTrancheSnapshot(options) {
     return __async(this, null, function* () {
       const {