@bluxcc/core 0.2.7 → 0.2.9

package/dist/stellar/getTransactionDetails.d.ts

@@ -1,5 +1,5 @@
 declare const getTransactionDetails: (xdr: string, network: string) => {
-    action: "createAccount" | "payment" | "pathPaymentStrictReceive" | "pathPaymentStrictSend" | "createPassiveSellOffer" | "manageSellOffer" | "manageBuyOffer" | "setOptions" | "changeTrust" | "allowTrust" | "accountMerge" | "inflation" | "manageData" | "bumpSequence" | "createClaimableBalance" | "claimClaimableBalance" | "beginSponsoringFutureReserves" | "endSponsoringFutureReserves" | "revokeSponsorship" | "clawback" | "clawbackClaimableBalance" | "setTrustLineFlags" | "liquidityPoolDeposit" | "liquidityPoolWithdraw" | "invokeHostFunction" | "extendFootprintTtl" | "restoreFootprint";
+    action: "accountMerge" | "allowTrust" | "beginSponsoringFutureReserves" | "bumpSequence" | "changeTrust" | "claimClaimableBalance" | "clawbackClaimableBalance" | "clawback" | "createAccount" | "createClaimableBalance" | "createPassiveSellOffer" | "endSponsoringFutureReserves" | "extendFootprintTtl" | "inflation" | "invokeHostFunction" | "liquidityPoolDeposit" | "liquidityPoolWithdraw" | "manageBuyOffer" | "manageData" | "manageSellOffer" | "pathPaymentStrictReceive" | "pathPaymentStrictSend" | "payment" | "restoreFootprint" | "revokeAccountSponsorship" | "revokeClaimableBalanceSponsorship" | "revokeDataSponsorship" | "revokeLiquidityPoolSponsorship" | "revokeOfferSponsorship" | "revokeSignerSponsorship" | "revokeTrustlineSponsorship" | "setOptions" | "setTrustLineFlags";
     operations: number;
     sender: string;
     receiver: string;

package/dist/stellar/handleTransactionSigning.d.ts

@@ -1,3 +1,3 @@
 import { ITransports, IWallet } from '../types';
-declare const handleTransactionSigning: (wallet: IWallet, xdr: string, userAddress: string, network: string, transports: ITransports, shouldSubmit: boolean) => Promise<string | import("@stellar/stellar-sdk/lib/horizon").HorizonApi.SubmitTransactionResponse>;
+declare const handleTransactionSigning: (wallet: IWallet, xdr: string, userAddress: string, network: string, transports: ITransports, shouldSubmit: boolean) => Promise<string | import("../types").ISubmittedTransaction>;
 export default handleTransactionSigning;

package/dist/stellar/submitTransaction.d.ts

@@ -1,5 +1,3 @@
-import { Horizon } from "@stellar/stellar-sdk";
-import { ITransports } from "../types";
-declare function submitTransaction(xdr: string, network: string, transports: ITransports): Promise<// | rpc.Api.GetSuccessfulTransactionResponse
-Horizon.HorizonApi.SubmitTransactionResponse>;
+import { ITransports, ISubmittedTransaction } from '../types';
+declare function submitTransaction(xdr: string, network: string, transports: ITransports): Promise<ISubmittedTransaction>;
 export default submitTransaction;

package/dist/stellar/swapTransaction.d.ts

@@ -1,4 +1,4 @@
-import { HorizonServer } from '@stellar/stellar-sdk/lib/horizon/server';
+import { Horizon } from '@stellar/stellar-sdk';
 import { IAsset } from '../types';
-declare const swapTransaction: (rawFromAmount: string, rawToAmount: string, lastFieldChanged: "from" | "to", fromAsset: IAsset, toAsset: IAsset, path: IAsset[], sourceAddress: string, server: HorizonServer, networkPassphrase: string, isChangeTrustNeeded: boolean) => Promise<string>;
+declare const swapTransaction: (rawFromAmount: string, rawToAmount: string, lastFieldChanged: "from" | "to", fromAsset: IAsset, toAsset: IAsset, path: IAsset[], sourceAddress: string, server: Horizon.Server, networkPassphrase: string, isChangeTrustNeeded: boolean) => Promise<string>;
 export default swapTransaction;

package/dist/store.d.ts

@@ -74,7 +74,9 @@ export interface IStoreProperties {
     signMessage?: ISignMessage;
     signAuthEntry?: ISignAuthEntry;
     login?: ILoginPromise;
+    loginError?: string;
     balances: UseBalancesResult;
+    balanceValues: Record<string, string>;
     transactions: UseTransactionsResult;
     selectAsset: ISelectAsset;
     detailsAsset?: IAsset;
@@ -105,6 +107,7 @@ export interface IStoreMethods {
     setAlert: (alert: AlertType, message: string) => void;
     setDynamicTitle: (title: string) => void;
     setBalances: (balances: UseBalancesResult) => void;
+    setBalanceValues: (balanceValues: Record<string, string>) => void;
     setSelectAsset: (selectAsset: ISelectAsset) => void;
     setDetailsAsset: (asset: IAsset | undefined) => void;
     setTransactions: (transactions: UseTransactionsResult) => void;
@@ -116,6 +119,7 @@ export interface IStoreMethods {
     setAuth: (a: IAuth) => void;
     setIsAuthenticated: (isAuthenticated: boolean) => void;
     setLogin: (loginDetails: ILoginPromise | undefined) => void;
+    setLoginError: (message?: string) => void;
     setLogos: (logos: ILogo[]) => void;
 }
 export interface IStore extends IStoreProperties, IStoreMethods {

package/dist/types.d.ts

@@ -1,41 +1,75 @@
-import { Horizon } from '@stellar/stellar-sdk';
+import { Horizon, rpc } from '@stellar/stellar-sdk';
 import { SupportedWallet } from './enums';
+/** Supported UI language codes (ISO 639-1). */
 export type LanguageKey = 'en' | 'es' | 'pt' | 'fr' | 'de' | 'ru' | 'zh' | 'ja' | 'ko';
+/** Custom RPC endpoints keyed by network passphrase. */
 export type ITransports = Record<string, IServers>;
+/** Block explorer used to build account/transaction links. */
 export type IExplorer = 'steexp' | 'stellarchain' | 'stellarexpert' | 'lumenscan';
+/** Social login providers supported by Blux. */
 export type ISocialProvider = 'google';
+/** Login methods to offer in the modal. */
 export type ILoginMethods = Array<'wallet' | 'sms' | 'email' | 'passkey' | ISocialProvider>;
+/** Canonical names of the wallets Blux can integrate with. */
 export type IWalletNames = Array<'rabet' | 'albedo' | 'freighter' | 'xbull' | 'lobstr' | 'hana' | 'hot' | 'klever' | 'cactuslink' | 'fordefi' | 'trezor'>;
+/** RPC endpoints for a single network. */
 interface IServers {
+    /** Horizon base URL. */
     horizon: string;
+    /** Soroban RPC base URL. */
     soroban: string;
 }
+/** WalletConnect project metadata shown to users during pairing. */
 export interface IWalletConnectMetaData {
+    /** Icon URLs for your app. */
     icons: string[];
+    /** Your app URL. */
     url: string;
+    /** WalletConnect Cloud project id. */
     projectId: string;
+    /** Short description of your app. */
     description: string;
 }
+/** Trezor Connect manifest metadata. */
 export interface ITrezorMetaData {
+    /** Contact email required by Trezor Connect. */
     email: string;
+    /** Optional app URL for the Trezor manifest. */
     appUrl?: string;
 }
+/** Configuration passed to {@link createConfig}. */
 export interface IConfig {
+    /** Your Blux app id, from the Blux dashboard. Required for email/passkey/social login. */
     appId: string;
+    /** Display name of your app, shown in wallet prompts and UI. */
     appName: string;
+    /** Network passphrases your app supports (e.g. from {@link networks}). */
     networks: string[];
+    /** Which of `networks` to start on. Defaults to the first entry. */
     defaultNetwork?: string;
+    /** Theme overrides for the Blux UI. */
     appearance?: Partial<IAppearance>;
+    /** UI language. Defaults to `'en'`. */
     lang?: LanguageKey;
+    /** Block explorer used for links. Defaults to `'stellarchain'`. */
     explorer?: IExplorer;
+    /** Persist the session across reloads. Defaults to `false`. */
     isPersistent?: boolean;
+    /** Show Blux's built-in signing/approval UIs. When `false`, signing happens headlessly. Defaults to `true`. */
     showWalletUIs?: boolean;
+    /** Login methods to offer. Defaults to `['wallet']`. */
     loginMethods?: ILoginMethods | string[];
+    /** Custom Horizon/Soroban endpoints per network; required for custom networks. */
     transports?: ITransports;
+    /** Wallets to hide from the picker. */
     excludeWallets?: IWalletNames;
+    /** Wallets to surface first in the picker, in the given order. */
     orderWallets?: IWalletNames | string[];
+    /** WalletConnect metadata; required to enable WalletConnect. */
     walletConnect?: IWalletConnectMetaData;
+    /** Trezor manifest metadata; required to enable Trezor. */
     trezor?: ITrezorMetaData;
+    /** Prompt the user when their wallet is on a different network. Defaults to `true`. */
     promptOnWrongNetwork?: boolean;
 }
 export interface IInternalConfig extends IConfig {
@@ -49,21 +83,37 @@ export interface IInternalConfig extends IConfig {
     orderWallets?: string[];
     promptOnWrongNetwork: boolean;
 }
+/** Theme tokens for the Blux modal and components. */
 export interface IAppearance {
+    /** Modal or component background color/image. */
     background: string;
+    /** Background color for input fields or UI sections. */
     fieldBackground: string;
+    /** Primary accent or highlight color. */
     accentColor: string;
+    /** Main text color. */
     textColor: string;
+    /** Font family or style. */
     fontFamily: string;
+    /** Outline width (e.g. `'2px'`); falls back to `borderWidth`. */
     outlineWidth?: string;
+    /** Outline color; falls back to `borderColor`. */
     outlineColor?: string;
+    /** Modal corner radius; falls back to `borderRadius`. */
     outlineRadius?: string;
+    /** Corner radius for UI elements. */
     borderRadius: string;
+    /** Border color for elements. */
     borderColor: string;
+    /** Border width (e.g. `'1px'`, `'0'`). */
     borderWidth: string;
+    /** App logo URL. */
     logo: string;
+    /** Blur level for the backdrop (e.g. `'8px'`). */
     backdropBlur: string;
+    /** Backdrop color behind the modal/overlay. */
     backdropColor: string;
+    /** Box shadow style for the modal. */
     boxShadow: string;
 }
 export interface IWallet {
@@ -109,7 +159,26 @@ export interface IAsset {
 export interface ISignOptions {
     network: string;
 }
-export type SendTransactionResult = Horizon.HorizonApi.SubmitTransactionResponse | string;
+/**
+ * Lazily resolves to the value the invoked contract function returned, decoded
+ * to a native JS value. Resolves to `null` for classic transactions and for
+ * Soroban calls whose function returns nothing.
+ */
+export type TransactionReturnValue = () => Promise<unknown>;
+/** A transaction that has been submitted to (and accepted by) the network. */
+export interface ISubmittedTransaction {
+    /** The transaction hash. */
+    hash: string;
+    /** Resolves the invoked contract function's return value; see {@link TransactionReturnValue}. */
+    returnValue: TransactionReturnValue;
+    /**
+     * The underlying response: a Horizon submit response for classic
+     * transactions, or the finalized Soroban RPC transaction for contract calls.
+     */
+    raw: Horizon.HorizonApi.SubmitTransactionResponse | rpc.Api.GetSuccessfulTransactionResponse;
+}
+/** Result of a sign-and-send: the submitted transaction, or the signed XDR when not submitting. */
+export type SendTransactionResult = ISubmittedTransaction | string;
 export interface ISendTransaction {
     xdr: string;
     shouldSubmit: boolean;

package/dist/utils/errors.d.ts

@@ -0,0 +1,6 @@
+export declare const ACCESS_DENIED_FALLBACK = "This account is not allowed to access this app";
+export declare class BluxAccessDeniedError extends Error {
+    constructor(message?: string);
+}
+export declare const isAccessDenied: (error: unknown) => error is BluxAccessDeniedError;
+export declare const looksLikeAccessDenied: (message: string) => boolean;

package/dist/utils/helpers.d.ts

@@ -3,11 +3,9 @@ import translations from '../constants/locales';
 import { Route, SupportedWallet } from '../enums';
 import { IAsset, IWallet, IExplorer, LanguageKey, ITransports, IWalletNames } from '../types';
 import { INetworkTransports } from '../constants/networkDetails';
-import { HorizonApi } from '@stellar/stellar-sdk/lib/horizon';
 export declare const bufferToBase64Url: (buf: ArrayBuffer) => string;
-export declare const base64UrlToBuffer: (value: string) => ArrayBuffer;
-export declare const getAssetTitle: (asset: HorizonApi.BalanceLineNative | HorizonApi.BalanceLineAsset<"credit_alphanum4"> | HorizonApi.BalanceLineAsset<"credit_alphanum12"> | HorizonApi.BalanceLineLiquidityPool) => string;
-export declare const getAssetSubtitle: (asset: HorizonApi.BalanceLineNative | HorizonApi.BalanceLineAsset<"credit_alphanum4"> | HorizonApi.BalanceLineAsset<"credit_alphanum12"> | HorizonApi.BalanceLineLiquidityPool) => string;
+export declare const getAssetTitle: (asset: Horizon.HorizonApi.BalanceLineNative | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum4"> | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum12"> | Horizon.HorizonApi.BalanceLineLiquidityPool) => string;
+export declare const getAssetSubtitle: (asset: Horizon.HorizonApi.BalanceLineNative | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum4"> | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum12"> | Horizon.HorizonApi.BalanceLineLiquidityPool) => string;
 export declare const iAssetToAsset: (asset: IAsset) => Asset;
 export declare const addXLMToBalances: (balances: IAsset[]) => {
     assetIssuer: string;
@@ -42,6 +40,7 @@ export declare const getWalletNetwork: (wallet: IWallet) => Promise<string>;
 export declare const handleLoadWallets: (walletNames: IWalletNames, orderWallets?: string[]) => Promise<IWallet[]>;
 export declare const hexToRgba: (hex: string, alpha?: number) => string;
 export declare const humanizeAmount: (amount: number | string, big?: boolean) => string;
+export declare const formatUsd: (value: number | string) => string;
 export declare const initializeRabetMobile: () => void;
 export declare const isBackgroundDark: (bgColor: string) => boolean;
 export declare const loadWallets: (excludedWallets: IWalletNames, orderWallets?: string[]) => Promise<IWallet[]>;

package/dist/utils/prices.d.ts

@@ -0,0 +1,25 @@
+import { Horizon } from '@stellar/stellar-sdk';
+type BalanceLine = Horizon.HorizonApi.BalanceLine;
+/**
+ * Stable key for a balance line used to index its computed USD value. Native is
+ * `'native'`, liquidity pools use their pool id, every other asset uses
+ * `CODE:ISSUER` — matching {@link assetValueKey} so the UI can look values up.
+ */
+export declare const balanceLineKey: (balance: BalanceLine) => string;
+/** Same key as {@link balanceLineKey} but from an {@link IAsset}-style triple. */
+export declare const assetValueKey: (assetType: string, assetCode: string, assetIssuer: string) => string;
+/**
+ * Computes the realistic USD value of each balance by selling the full held
+ * amount into the live DEX order book (price-impact aware), keyed by
+ * {@link balanceLineKey}.
+ *
+ * Real USD pricing only runs on mainnet, where USDC carries real-world value;
+ * on every other network all values resolve to `'0'`. Per-asset failures are
+ * isolated, so one unpriceable asset never blanks the rest.
+ *
+ * @param balances - The account's balance lines.
+ * @param network - Active network passphrase.
+ * @returns A map of `balanceLineKey` → USD value string (7-dp, never NaN/Infinity).
+ */
+export declare const getBalancesUsdValues: (balances: BalanceLine[], network: string) => Promise<Record<string, string>>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluxcc/core",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "homepage": "https://blux.cc",
   "description": "Blux is a wallet infra for the Stellar network",
   "type": "module",
@@ -42,7 +42,7 @@
     "@ledgerhq/hw-app-str": "^7.2.8",
     "@lobstrco/signer-extension-api": "^1.0.0-beta.0",
     "@stellar/freighter-api": "^5.0.0",
-    "@stellar/stellar-sdk": "^15.1.0",
+    "@stellar/stellar-sdk": "^16.0.0",
     "@walletconnect/core": "^2.21.9",
     "@walletconnect/sign-client": "^2.21.9",
     "qrcode.react": "^4.2.0",
@@ -73,6 +73,7 @@
   "dependencies": {
     "@hot-wallet/sdk": "^1.0.11",
     "@ledgerhq/hw-transport-webusb": "^6.29.12",
-    "@trezor/connect-web": "^10.0.0-alpha.1"
+    "@trezor/connect-web": "^10.0.0-alpha.1",
+    "bignumber.js": "^9.3.1"
   }
 }