@bluxcc/core 0.2.12 → 0.2.14

package/dist/pages/Profile/Balances/TokenDetails/index.d.ts

@@ -0,0 +1,2 @@
+declare const TokenDetails: () => import("react/jsx-runtime").JSX.Element | null;
+export default TokenDetails;

package/dist/store.d.ts

@@ -4,7 +4,7 @@ import { Route } from './enums';
 import { UseBalancesResult } from './hooks/useBalances';
 import { UseTransactionsResult } from './hooks/useTransactions';
 import Emitter, { BluxEventMap } from './utils/events';
-import { IAsset, IWallet, IAppearance, ISignMessage, IInternalConfig, ISendTransaction, AuthenticateApiResponse, ISignAuthEntry } from './types';
+import { IAsset, IWallet, IAppearance, AssetMetaMap, ICustomToken, ICustomTokens, ISignMessage, IInternalConfig, ISendTransaction, AuthenticateApiResponse, ISignAuthEntry } from './types';
 export type AlertType = 'error' | 'success' | 'warn' | 'none' | 'copy';
 export type WaitingStatus = 'login' | 'sendTransaction' | 'signMessage' | 'signAuthEntry';
 export interface ILogo {
@@ -49,6 +49,7 @@ export interface ILoginPromise {
 }
 export interface IStoreProperties {
     logos: ILogo[] | null;
+    assetMeta: AssetMetaMap | null;
     emitter: Emitter<BluxEventMap>;
     auth?: IAuth;
     config: IInternalConfig;
@@ -80,6 +81,9 @@ export interface IStoreProperties {
     transactions: UseTransactionsResult;
     selectAsset: ISelectAsset;
     detailsAsset?: IAsset;
+    customTokens: ICustomTokens;
+    balancesTab: 'assets' | 'tokens';
+    detailsToken?: ICustomToken;
     walletConnect?: {
         connection: any;
         client: SignClient;
@@ -110,6 +114,12 @@ export interface IStoreMethods {
     setBalanceValues: (balanceValues: Record<string, string>) => void;
     setSelectAsset: (selectAsset: ISelectAsset) => void;
     setDetailsAsset: (asset: IAsset | undefined) => void;
+    setCustomTokens: (customTokens: ICustomTokens) => void;
+    addCustomToken: (token: ICustomToken) => void;
+    removeCustomToken: (network: 'mainnet' | 'testnet', id: number) => void;
+    setCustomTokenBalances: (network: 'mainnet' | 'testnet', balances: Record<number, string>) => void;
+    setBalancesTab: (tab: 'assets' | 'tokens') => void;
+    setDetailsToken: (token: ICustomToken | undefined) => void;
     setTransactions: (transactions: UseTransactionsResult) => void;
     setWalletConnectClient: (client: SignClient, connection: any) => void;
     cleanUp: (method: 'sendTransaction' | 'signMessage') => void;
@@ -121,6 +131,7 @@ export interface IStoreMethods {
     setLogin: (loginDetails: ILoginPromise | undefined) => void;
     setLoginError: (message?: string) => void;
     setLogos: (logos: ILogo[]) => void;
+    setAssetMeta: (assetMeta: AssetMetaMap) => void;
 }
 export interface IStore extends IStoreProperties, IStoreMethods {
 }

package/dist/types.d.ts

@@ -156,6 +156,49 @@ export interface IAsset {
     assetType: string;
     assetIssuer: string;
 }
+/**
+ * Display metadata for a single asset, sourced from curated SEP-42 asset lists
+ * (Lobstr, StellarExpert, Soroswap) and served as a gzipped blob from R2.
+ */
+export interface IAssetMeta {
+    code: string;
+    issuer: string | null;
+    contract: string | null;
+    name: string;
+    org: string | null;
+    domain: string | null;
+    /** HTTPS (or IPFS gateway) URL of the asset logo. */
+    icon: string;
+    decimals: number;
+    /** Which curated list this entry came from. */
+    source: string;
+}
+/** Asset metadata keyed by `${network}:${code}:${issuer}` (e.g. `pubnet:USDC:GA5Z...`). */
+export type AssetMetaMap = Record<string, IAssetMeta>;
+/**
+ * A custom Stellar Asset Contract (SAC) / SEP-41 token the user added to their
+ * preferred list. The id/contract/name/symbol/decimals come from the Blux API
+ * (`TokenView`); `balance` is read on-chain for the logged-in account (the API
+ * does not store balances). The API only buckets tokens by `mainnet`/`testnet`.
+ */
+export interface ICustomToken {
+    /** Server-side id, used for the DELETE route. */
+    id: number;
+    /** Token contract id (`C...`). */
+    contractAddress: string;
+    /** API network bucket this token belongs to. */
+    network: 'mainnet' | 'testnet';
+    name: string;
+    symbol: string;
+    decimals: number;
+    /** Human-readable on-chain balance for the logged-in account; `'0'` until read. */
+    balance: string;
+}
+/** Custom tokens grouped by the two network buckets the Blux API supports. */
+export interface ICustomTokens {
+    mainnet: ICustomToken[];
+    testnet: ICustomToken[];
+}
 export interface ISignOptions {
     network: string;
 }

package/dist/utils/api.d.ts

@@ -25,4 +25,21 @@ type ApiGetUserResponse = {
 export declare const apiGetUser: (JWT: string) => Promise<ApiGetUserResponse>;
 export declare const apiSignMessage: (JWT: string, message: string) => Promise<string>;
 export declare const apiSignTransaction: (JWT: string, xdr: string, network: string) => Promise<string>;
+/** Mirrors the API's `TokenView`. The API only buckets tokens mainnet/testnet. */
+export type ApiTokenView = {
+    id: number;
+    contract_address: string;
+    network: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+};
+/** GET /tokens result: the user's tokens grouped per network bucket. */
+export type ApiGroupedTokens = {
+    mainnet: ApiTokenView[];
+    testnet: ApiTokenView[];
+};
+export declare const apiGetTokens: (JWT: string) => Promise<ApiGroupedTokens>;
+export declare const apiAddToken: (JWT: string, contractAddress: string, network: "mainnet" | "testnet") => Promise<ApiTokenView>;
+export declare const apiDeleteToken: (JWT: string, tokenId: number) => Promise<boolean>;
 export {};

package/dist/utils/customTokens.d.ts

@@ -0,0 +1,78 @@
+import { ICustomToken } from '../types';
+import { ApiTokenView } from './api';
+/**
+ * Maps a network passphrase to the API's token bucket. The Blux API only stores
+ * tokens for mainnet/testnet, so every non-public network maps to `'testnet'`
+ * (matching the curated-asset-meta convention in {@link networkSlug}).
+ */
+export declare const apiNetworkSlug: (activeNetwork?: string) => "mainnet" | "testnet";
+/**
+ * Converts a raw i128 token amount (as returned by `balance`) into a
+ * human-readable decimal string, without floating-point precision loss.
+ */
+export declare const formatTokenAmount: (raw: string, decimals: number) => string;
+/** A classic Stellar asset that a SAC wraps, derived from its on-chain `name()`. */
+export type SacClassicAsset = {
+    type: 'native';
+} | {
+    type: 'credit';
+    code: string;
+    issuer: string;
+};
+/**
+ * Derives the classic asset a Stellar Asset Contract wraps from its on-chain
+ * `name()`: a SAC reports `"native"` for XLM and `"CODE:ISSUER"` for credit
+ * assets (e.g. `"USDC:GBBD…"`). Returns `null` for a non-SAC custom token, whose
+ * `name()` is a free-form string. Used both to show a short name and to detect a
+ * token the user already holds as a classic asset.
+ */
+export declare const sacToClassicAsset: (name: string) => SacClassicAsset | null;
+/**
+ * A short, layout-safe display name for a token. SAC-wrapped classic assets
+ * report `name()` as the long `"CODE:ISSUER"`, so fall back to the symbol; XLM
+ * reports `"native"`.
+ */
+export declare const tokenDisplayName: (name: string, symbol: string) => string;
+/**
+ * The `(code, issuer)` to feed AssetLogo so a SAC-wrapped classic asset resolves
+ * its real curated logo; non-classic tokens get an empty issuer and fall back to
+ * the generic icon. Never resolves to the native XLM / Stellar glyph.
+ */
+export declare const tokenLogoAsset: (name: string, symbol: string) => {
+    code: string;
+    issuer: string;
+};
+/** The on-chain shape of a SAC / SEP-41 token, read by {@link readTokenOnChain}. */
+export interface TokenOnChain {
+    name: string;
+    symbol: string;
+    decimals: number;
+    /** Raw i128 balance for `accountAddress`; `'0'` when no account was given. */
+    rawBalance: string;
+    /** Human-readable balance (`rawBalance` scaled by `decimals`). */
+    balance: string;
+    /** admin() (SACs) or owner() (custom tokens), whichever the contract exposes. */
+    adminOrOwner?: string;
+}
+/**
+ * Reads a token contract's on-chain state by simulating its read-only
+ * entrypoints — no account, signing, or fees required. `name`/`symbol`/
+ * `decimals` are the standard SEP-41 interface; `balance` is read for
+ * `accountAddress` when given; `adminOrOwner` is best-effort.
+ *
+ * @throws If `contractAddress` is not a contract id, or it is missing the
+ *   standard `name`/`symbol`/`decimals` entrypoints (i.e. not a token).
+ */
+export declare const readTokenOnChain: (contractAddress: string, accountAddress?: string, network?: string) => Promise<TokenOnChain>;
+/**
+ * Reads just a token's `balance` for an account in a single simulation and
+ * formats it with an already-known `decimals` — far lighter than
+ * {@link readTokenOnChain} for the periodic balance refresh. Returns `'0'` on
+ * any failure so a single unreachable token can't break the others.
+ */
+export declare const readTokenBalance: (contractAddress: string, accountAddress: string, decimals: number, network?: string) => Promise<string>;
+/**
+ * Maps an API `TokenView` to the store's {@link ICustomToken}, attaching a
+ * (separately read) on-chain balance.
+ */
+export declare const apiTokenToCustomToken: (view: ApiTokenView, balance?: string) => ICustomToken;

package/dist/utils/preloadAssetMeta.d.ts

@@ -0,0 +1,5 @@
+/** `pubnet` for Mainnet, `testnet` otherwise. The curated blob is Mainnet-only. */
+export declare const networkSlug: (activeNetwork?: string) => string;
+/** Lookup key into the asset-meta map, e.g. `pubnet:USDC:GA5Z...`. */
+export declare const assetMetaKey: (activeNetwork: string | undefined, code: string, issuer: string) => string;
+export declare const preloadAssetMeta: () => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluxcc/core",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "homepage": "https://blux.cc",
   "description": "Blux is a wallet infra for the Stellar network",
   "type": "module",