@exodus/solana-lib 3.9.4 → 3.9.5

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.9.5](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.9.4...@exodus/solana-lib@3.9.5) (2025-03-25)
+
+
+### License
+
+
+* license: re-license under MIT license (#4814)
+
+
+
 ## [3.9.4](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.9.3...@exodus/solana-lib@3.9.4) (2025-01-02)
 
 

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2024 Exodus Movement, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,21 @@
-# @exodus/solana-lib
+# @exodus/solana-lib · [![npm version](https://img.shields.io/badge/npm-public-blue.svg?style=flat)](https://www.npmjs.com/package/@exodus/solana-lib)
 
-Solana utils, such as for cryptography, address encoding/decoding, transaction building, etc. See [Asset Packages](../../docs/asset-packages.md) for more detail on this package's role.
+**solana-lib** is a comprehensive library designed for seamless interaction with the Solana blockchain. It provides a robust set of functions and classes to facilitate core blockchain operations.
+
+This library encompasses all the essential tools required for cryptographic operations, including key derivation and signing. It also supports transaction serialization and deserialization, data encoding and decoding, and the crafting of various types of transactions such as regular transactions, token transactions, and staking transactions.
+
+---
+
+## Installation
+
+Install the package via `yarn`:
+
+```bash
+yarn add @exodus/solana-lib
+```
+
+## License
+
+This project is licensed under the MIT License.
+You are free to use, modify, and distribute this software under the terms of the MIT License.
+For more details, see the [LICENSE](LICENSE) file.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/solana-lib",
-  "version": "3.9.4",
+  "version": "3.9.5",
   "description": "Solana utils, such as for cryptography, address encoding/decoding, transaction building, etc.",
   "type": "module",
   "main": "src/index.js",
@@ -10,7 +10,7 @@
     "!src/**/__tests__"
   ],
   "author": "Exodus Movement, Inc.",
-  "license": "ISC",
+  "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
@@ -45,5 +45,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "8a6a0d1a70d14e86a9cf4d47b8884939f10be724"
+  "gitHead": "0908ae0c3bd6a7d5bdd91946f88d389037f7d710"
 }

package/src/fee-data/README.md

@@ -0,0 +1,44 @@
+# **Computing Fees and Priority Fees in Solana**
+
+In Solana, **fees** and **priority fees** are influenced by network conditions, making them **not fully deterministic** but still **predictable to some extent**.
+
+---
+
+## **1. Computing Base Transaction Fees**
+
+Solana uses a **fixed fee structure** based on transaction size. The base fee is computed as:
+
+base_fee = num_signatures \* signature_fee
+
+- **Signature Fee**: A fixed amount per signature (historically 5000 lamports per signature, but subject to change).
+- **Num Signatures**: Typically 1 for standard transactions, more if using multi-signature accounts.
+
+Thus, if network parameters remain unchanged, you can **deterministically** compute the **base fee**.
+
+---
+
+## **2. Computing Priority Fee (Not Deterministic)**
+
+The **priority fee** is **market-driven**, meaning it depends on **current network congestion**. Users specify the **compute unit price** in lamports per **compute unit**. The total priority fee is then:
+
+priority_fee = compute_units_used \* compute_unit_price
+
+- **Compute Units Used**: Can be estimated based on the transaction complexity but varies based on program execution.
+- **Compute Unit Price**: Set by the user, competes with others in a bidding system.
+
+### **Why is Priority Fee Not Deterministic?**
+
+- The **compute units used** may vary due to transaction execution conditions.
+- The **compute unit price** is market-driven and changes based on network demand.
+
+Thus, **you can estimate priority fees, but they are not deterministic**.
+
+---
+
+## **3. Can You Precompute Fees?**
+
+| Fee Type         | Deterministic? | Notes                                            |
+| ---------------- | -------------- | ------------------------------------------------ |
+| **Base Fee**     | ✅ Yes         | Fixed per signature and transaction size.        |
+| **Priority Fee** | ❌ No          | Market-driven and depends on network congestion. |
+| **Total Fees**   | ⚠️ Estimated   | Can be predicted but not guaranteed.             |

package/src/fee-data/index.js

@@ -4,9 +4,10 @@ export const createFeeData = ({ asset }) =>
   new FeeData({
     config: {
       fee: `0.000005 ${asset.ticker}`,
+      baseFee: `0.000005 ${asset.ticker}`,
       priorityFee: 1_000_000,
       fuelThreshold: `0.000015 ${asset.ticker}`,
-      computeUnitsMultiplier: 4, // compute units buffer
+      computeUnitsMultiplier: 1, // compute units buffer, increasing to > 1 can cause Dust issues.
     },
     mainKey: 'fee',
     currency: asset.currency,

package/src/helpers/tokenTransfer.js

@@ -63,7 +63,6 @@ function createIx(
 export const createTokenTransferInstruction = (owner, fromTokenAddress, to, amount) => {
   const sourcePubkey = new PublicKey(fromTokenAddress) // the token ADDRESS needed!
   const destinationPubkey = new PublicKey(to)
-  console.log(`destination token address: ${destinationPubkey.toBase58()}`)
   const ownerAccountOrWalletPublicKey = new PublicKey(owner) // the only native SOL address
 
   return Token.createTransferInstruction(