165 lines
5.7 KiB
Python
165 lines
5.7 KiB
Python
# # ⚠ Warning
|
|
#
|
|
# 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.
|
|
#
|
|
# [🥭 Mango Markets](https://mango.markets/) support is available at:
|
|
# [Docs](https://docs.mango.markets/)
|
|
# [Discord](https://discord.gg/67jySBhxrg)
|
|
# [Twitter](https://twitter.com/mangomarkets)
|
|
# [Github](https://github.com/blockworks-foundation)
|
|
# [Email](mailto:hello@blockworks.foundation)
|
|
|
|
|
|
import json
|
|
import logging
|
|
import typing
|
|
|
|
from decimal import Decimal
|
|
from solana.publickey import PublicKey
|
|
|
|
from .constants import SOL_DECIMALS, SOL_MINT_ADDRESS
|
|
|
|
|
|
# # 🥭 Token class
|
|
#
|
|
# `Token` defines aspects common to every token.
|
|
#
|
|
|
|
class Token:
|
|
def __init__(self, symbol: str, name: str, mint: PublicKey, decimals: Decimal):
|
|
self.logger: logging.Logger = logging.getLogger(self.__class__.__name__)
|
|
self.symbol: str = symbol.upper()
|
|
self.name: str = name
|
|
self.mint: PublicKey = mint
|
|
self.decimals: Decimal = decimals
|
|
|
|
def round(self, value: Decimal) -> Decimal:
|
|
return round(value, int(self.decimals))
|
|
|
|
def shift_to_decimals(self, value: Decimal) -> Decimal:
|
|
divisor = Decimal(10 ** self.decimals)
|
|
shifted = value / divisor
|
|
return round(shifted, int(self.decimals))
|
|
|
|
def shift_to_native(self, value: Decimal) -> Decimal:
|
|
divisor = Decimal(10 ** self.decimals)
|
|
shifted = value * divisor
|
|
return round(shifted, 0)
|
|
|
|
def symbol_matches(self, symbol: str) -> bool:
|
|
return self.symbol.upper() == symbol.upper()
|
|
|
|
@staticmethod
|
|
def find_by_symbol(values: typing.List["Token"], symbol: str) -> "Token":
|
|
found = [value for value in values if value.symbol_matches(symbol)]
|
|
if len(found) == 0:
|
|
raise Exception(f"Token '{symbol}' not found in token values: {values}")
|
|
|
|
if len(found) > 1:
|
|
raise Exception(f"Token '{symbol}' matched multiple tokens in values: {values}")
|
|
|
|
return found[0]
|
|
|
|
@staticmethod
|
|
def find_by_mint(values: typing.List["Token"], mint: PublicKey) -> "Token":
|
|
found = [value for value in values if value.mint == mint]
|
|
if len(found) == 0:
|
|
raise Exception(f"Token '{mint}' not found in token values: {values}")
|
|
|
|
if len(found) > 1:
|
|
raise Exception(f"Token '{mint}' matched multiple tokens in values: {values}")
|
|
|
|
return found[0]
|
|
|
|
# TokenMetadatas are equal if they have the same mint address.
|
|
def __eq__(self, other):
|
|
if hasattr(other, 'mint'):
|
|
return self.mint == other.mint
|
|
return False
|
|
|
|
def __str__(self) -> str:
|
|
return f"« Token '{self.name}' [{self.mint} ({self.decimals} decimals)] »"
|
|
|
|
def __repr__(self) -> str:
|
|
return f"{self}"
|
|
|
|
|
|
# # 🥭 SolToken object
|
|
#
|
|
# It's sometimes handy to have a `Token` for SOL, but SOL isn't actually a token and can't appear in baskets. This object defines a special case for SOL.
|
|
#
|
|
|
|
|
|
SolToken = Token("SOL", "Pure SOL", SOL_MINT_ADDRESS, SOL_DECIMALS)
|
|
|
|
|
|
# # 🥭 TokenLookup class
|
|
#
|
|
# This class allows us to look up token symbols, names, mint addresses and decimals, all from our Solana static data.
|
|
#
|
|
# The static data is the [Solana token list](https://raw.githubusercontent.com/solana-labs/token-list/main/src/tokens/solana.tokenlist.json) provided by Serum.
|
|
#
|
|
# You can load a `TokenLookup` class by something like:
|
|
# ```
|
|
# with open("solana.tokenlist.json") as json_file:
|
|
# token_data = json.load(json_file)
|
|
# token_lookup = TokenLookup(token_data)
|
|
# ```
|
|
#
|
|
# It's usually easiest to access it via the `Context` as `context.token_lookup`.
|
|
#
|
|
|
|
|
|
class TokenLookup:
|
|
DEFAULT_FILE_NAME = "solana.tokenlist.json"
|
|
|
|
@staticmethod
|
|
def _find_data_by_symbol(symbol: str, token_data: typing.Dict) -> typing.Optional[typing.Dict]:
|
|
for token in token_data["tokens"]:
|
|
if token["symbol"] == symbol:
|
|
return token
|
|
return None
|
|
|
|
def __init__(self, token_data: typing.Dict) -> None:
|
|
self.logger: logging.Logger = logging.getLogger(self.__class__.__name__)
|
|
self.token_data = token_data
|
|
|
|
def find_by_symbol(self, symbol: str) -> typing.Optional[Token]:
|
|
found = TokenLookup._find_data_by_symbol(symbol, self.token_data)
|
|
if found is not None:
|
|
return Token(found["symbol"], found["name"], PublicKey(found["address"]), Decimal(found["decimals"]))
|
|
|
|
return None
|
|
|
|
def find_by_mint(self, mint: PublicKey) -> typing.Optional[Token]:
|
|
mint_string: str = str(mint)
|
|
for token in self.token_data["tokens"]:
|
|
if token["address"] == mint_string:
|
|
return Token(token["symbol"], token["name"], PublicKey(token["address"]), Decimal(token["decimals"]))
|
|
|
|
return None
|
|
|
|
def find_by_symbol_or_raise(self, symbol: str) -> Token:
|
|
token = self.find_by_symbol(symbol)
|
|
if token is None:
|
|
raise Exception(f"Could not find token with symbol '{symbol}'.")
|
|
|
|
return token
|
|
|
|
def find_by_mint_or_raise(self, mint: PublicKey) -> Token:
|
|
token = self.find_by_mint(mint)
|
|
if token is None:
|
|
raise Exception(f"Could not find token with mint {mint}.")
|
|
|
|
return token
|
|
|
|
@staticmethod
|
|
def load(filename: str) -> "TokenLookup":
|
|
with open(filename) as json_file:
|
|
token_data = json.load(json_file)
|
|
return TokenLookup(token_data)
|