@bluxcc/core 0.2.18 → 0.3.1

package/dist/stellar/getTransactionDetails.d.ts

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

package/dist/stellar/handleSignMessage.d.ts

@@ -1,3 +1,3 @@
 import { IWallet } from "../types";
-declare const handleSignMessage: (wallet: IWallet, message: string, address: string, network: string) => Promise<string>;
+declare const handleSignMessage: (wallet: IWallet, message: string, address: string, network?: string) => Promise<string>;
 export default handleSignMessage;

package/dist/stellar/moneygram.d.ts

@@ -0,0 +1,26 @@
+import { Horizon } from '@stellar/stellar-sdk';
+import { IAsset } from '../types';
+export type MoneygramMemoType = 'text' | 'id' | 'hash';
+export type MoneygramSession = {
+    url: string;
+    id: string;
+    token: string;
+    transferServer: string;
+};
+export type MoneygramWithdrawDetails = {
+    amount: string;
+    destination: string;
+    memo: string;
+    memoType: MoneygramMemoType;
+};
+export declare const isMoneygramNetwork: (network: string) => boolean;
+export declare const moneygramUsdc: (network: string) => IAsset;
+export declare const startMoneygramWithdraw: ({ address, network, lang, sign, signal, }: {
+    address: string;
+    network: string;
+    lang?: string;
+    sign: (xdr: string) => Promise<string>;
+    signal?: AbortSignal;
+}) => Promise<MoneygramSession>;
+export declare const waitForMoneygramTransfer: (session: MoneygramSession, signal?: AbortSignal) => Promise<MoneygramWithdrawDetails>;
+export declare const assertHorizon: (horizon?: Horizon.Server) => Horizon.Server;

package/dist/stellar/paymentTransaction.d.ts

@@ -1,4 +1,4 @@
-import { Horizon } from "@stellar/stellar-sdk";
-import { IAsset } from "../types";
-declare const paymentTransaction: (memo: string, amount: string, destinationAddress: string, asset: IAsset, sourceAddress: string, server: Horizon.Server, networkPassphrase: string) => Promise<string>;
+import { Horizon } from '@stellar/stellar-sdk';
+import { IAsset } from '../types';
+declare const paymentTransaction: (memo: string, amount: string, destinationAddress: string, asset: IAsset, sourceAddress: string, server: Horizon.Server, networkPassphrase: string, memoType?: "text" | "id" | "hash") => Promise<string>;
 export default paymentTransaction;

package/dist/stellar/processes/continueLoginProcess.d.ts

@@ -1,3 +1,4 @@
 export declare const completeLoginProcess: () => void;
+export declare const rejectLoginProcess: (reason?: string) => void;
 declare const continueLoginProcess: () => void;
 export default continueLoginProcess;

package/dist/store.d.ts

@@ -1,8 +1,7 @@
 import { Horizon, rpc } from '@stellar/stellar-sdk';
 import { SignClient } from '@walletconnect/sign-client/dist/types/client';
 import { Route } from './enums';
-import { UseBalancesResult } from './hooks/useBalances';
-import { UseTransactionsResult } from './hooks/useTransactions';
+import type { UseBalancesResult } from './hooks/useBalances';
 import Emitter, { BluxEventMap } from './utils/events';
 import { IAsset, IWallet, IAppearance, AssetMetaMap, ICustomToken, ICustomTokens, ISignMessage, IInternalConfig, ISendTransaction, AuthenticateApiResponse, ISignAuthEntry } from './types';
 export type AlertType = 'error' | 'success' | 'warn' | 'none' | 'copy';
@@ -78,7 +77,7 @@ export interface IStoreProperties {
     loginError?: string;
     balances: UseBalancesResult;
     balanceValues: Record<string, string>;
-    transactions: UseTransactionsResult;
+    accountRefreshNonce: number;
     selectAsset: ISelectAsset;
     detailsAsset?: IAsset;
     customTokens: ICustomTokens;
@@ -93,6 +92,7 @@ export interface IStoreProperties {
 }
 export interface IStoreMethods {
     connectEmail: (email: string) => void;
+    connectSms: (phone: string) => void;
     connectSocial: (provider: string) => void;
     connectWallet: (walletName: string) => void;
     connectWalletSuccessful: (publicKey: string, passphrase: string) => void;
@@ -120,7 +120,7 @@ export interface IStoreMethods {
     setCustomTokenBalances: (network: 'mainnet' | 'testnet', balances: Record<number, string>) => void;
     setBalancesTab: (tab: 'assets' | 'tokens') => void;
     setDetailsToken: (token: ICustomToken | undefined) => void;
-    setTransactions: (transactions: UseTransactionsResult) => void;
+    bumpAccountRefresh: () => void;
     setWalletConnectClient: (client: SignClient, connection: any) => void;
     cleanUp: (method: 'sendTransaction' | 'signMessage' | 'signAuthEntry') => void;
     setNetworkSyncDisabled: (isDisabled: boolean) => void;

package/dist/tailwind.css.d.ts

@@ -0,0 +1,2 @@
+declare const styles: Record<string, string>;
+export default styles;

package/dist/types.d.ts

@@ -1,9 +1,12 @@
+import type { ReactNode } from 'react';
 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';
+export type LanguageKey = 'en' | 'es' | 'pt' | 'fr' | 'de' | 'ru' | 'zh' | 'ja' | 'ko' | 'tr';
 /** Custom RPC endpoints keyed by network passphrase. */
 export type ITransports = Record<string, IServers>;
+/** A value TypeScript still treats as a string, while keeping literal unions suggestable. */
+type LooseString = string & {};
 /** Block explorer used to build account/transaction links. */
 export type IExplorer = 'steexp' | 'stellarchain' | 'stellarexpert' | 'lumenscan';
 /** Social login providers supported by Blux. */
@@ -13,7 +16,7 @@ export type ILoginMethods = Array<'wallet' | 'sms' | 'email' | 'passkey' | ISoci
 /** 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 {
+export interface IServers {
     /** Horizon base URL. */
     horizon: string;
     /** Soroban RPC base URL. */
@@ -39,7 +42,7 @@ export interface ITrezorMetaData {
 }
 /** Configuration passed to {@link createConfig}. */
 export interface IConfig {
-    /** Your Blux app id, from the Blux dashboard. Required for email/passkey/social login. */
+    /** Your Blux app id, from the Blux dashboard. Required for email/SMS/passkey/social login. */
     appId: string;
     /** Display name of your app, shown in wallet prompts and UI. */
     appName: string;
@@ -53,18 +56,18 @@ export interface IConfig {
     lang?: LanguageKey;
     /** Block explorer used for links. Defaults to `'stellarchain'`. */
     explorer?: IExplorer;
-    /** Persist the session across reloads. Defaults to `false`. */
+    /** Persist the session across page reloads. Defaults to `false` and should remain `false` in most scenarios. */
     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[];
+    /** Login methods to offer. Defaults to `['wallet']`. `'sms'` is shown only when `/auth/validate` reports a paid plan. */
+    loginMethods?: Array<ILoginMethods[number] | LooseString>;
     /** 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[];
+    orderWallets?: Array<IWalletNames[number] | LooseString>;
     /** WalletConnect metadata; required to enable WalletConnect. */
     walletConnect?: IWalletConnectMetaData;
     /** Trezor manifest metadata; required to enable Trezor. */
@@ -116,9 +119,19 @@ export interface IAppearance {
     /** Box shadow style for the modal. */
     boxShadow: string;
 }
+/** How a wallet proves it controls an address during login. */
+export type WalletProofType = 'signed_transaction' | 'signed_message';
 export interface IWallet {
     name: SupportedWallet;
     website: string;
+    /**
+     * When true, login proves ownership with `signMessage` (SEP-53) instead of a
+     * SEP-10 challenge transaction. Use this for wallets that treat the
+     * unsubmittable challenge as a real payment and block on insufficient XLM
+     * (Freighter, Hana, Rabet, OneKey). Hardware wallets that cannot sign arbitrary messages
+     * must leave this unset so they keep using the challenge transaction.
+     */
+    authenticateWithSignedMessage?: boolean;
     connect: () => Promise<string>;
     disconnect: () => Promise<void>;
     getNetwork: () => Promise<{
@@ -132,7 +145,7 @@ export interface IWallet {
     }) => Promise<string>;
     signMessage: (message: string, options: {
         address: string;
-        network: string;
+        network?: string;
     }) => Promise<string>;
     signTransaction: (xdr: string, options: {
         network: string;
@@ -149,7 +162,7 @@ export interface IAccountData {
     transactions?: Horizon.ServerApi.TransactionRecord[];
 }
 export interface IAsset {
-    logo?: string | React.ReactNode;
+    logo?: string | ReactNode;
     valueInCurrency?: string;
     assetBalance: string;
     assetCode: string;
@@ -233,7 +246,6 @@ export interface ISendTransaction {
 export interface ISignMessage {
     message: string;
     result?: string;
-    options: ISignOptions;
     rejecter: (reason: any) => void;
     resolver: (value: string) => void;
 }
@@ -255,5 +267,9 @@ export interface AuthenticateApiResponse {
     terms: string;
     socials: string[];
     socialsConfig: ISocialConfigEntry[];
+    /** Entitled billing plan of the account that owns this app. */
+    plan: string;
+    /** True when the account is on a paid plan and may offer SMS login. */
+    smsEnabled: boolean;
 }
 export {};

package/dist/utils/api.d.ts

@@ -1,5 +1,5 @@
 import { IUser } from '../store';
-import { AuthenticateApiResponse } from '../types';
+import { AuthenticateApiResponse, WalletProofType } from '../types';
 import { PasskeyFlowResult } from '../pages/Onboarding/Passkey';
 type ApiPasskeyChallenge = {
     user_id: string;
@@ -9,13 +9,18 @@ type ApiPasskeyChallenge = {
 export declare const authenticateAppId: (appId: string) => Promise<AuthenticateApiResponse>;
 export declare const apiPasskeyChallenge: (appId: string, authValue: string) => Promise<ApiPasskeyChallenge>;
 export declare const apiPasskeyVerify: (appId: string, challenge: ApiPasskeyChallenge, passkeyResult: PasskeyFlowResult) => Promise<string>;
-export declare const apiSendOtp: (appId: string, authValue: string) => Promise<boolean>;
+export declare const apiSendOtp: (appId: string, authValue: string, authMethod?: "email" | "sms") => Promise<boolean>;
 type ApiWalletChallenge = {
-    challenge_xdr: string;
+    challenge_xdr?: string;
+    challenge?: string;
     network_passphrase: string;
+    proof_type?: WalletProofType;
 };
-export declare const apiWalletChallenge: (appId: string, walletName: string, walletAddress: string) => Promise<ApiWalletChallenge>;
-export declare const apiVerifyWalletChallenge: (appId: string, signedXdr: string) => Promise<string>;
+export declare const apiWalletChallenge: (appId: string, walletName: string, walletAddress: string, proofType?: WalletProofType) => Promise<ApiWalletChallenge>;
+export declare const apiVerifyWalletChallenge: (appId: string, code: string, options?: {
+    proofType?: WalletProofType;
+    challenge?: string;
+}) => Promise<string>;
 export declare const apiVerifyOtp: (appId: string, user: IUser, otp: string) => Promise<string>;
 type ApiGetUserResponse = {
     auth_method: string;

package/dist/utils/appValidity.d.ts

@@ -15,8 +15,9 @@ export declare const isAppValid: () => boolean;
  */
 export declare const assertAppIsValid: () => void;
 /**
- * Resolves once the SDK has finished initializing (wallets loaded) AND appId
- * validation has settled, so the caller can then assert validity. Polls because
- * both happen asynchronously after createConfig.
+ * Resolves once the SDK has finished initializing AND appId validation has
+ * settled, so the caller can then assert validity. Polls because both happen
+ * asynchronously after createConfig. For apps that do not offer wallet login,
+ * `isReady` does not wait on wallet availability — only appId validation.
  */
 export declare const waitForBluxReady: () => Promise<void>;

package/dist/utils/helpers.d.ts

@@ -1,8 +1,7 @@
 import { Asset, Horizon } from '@stellar/stellar-sdk';
 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 { IAsset, IWallet, IExplorer, LanguageKey, ITransports, IWalletNames, ILoginMethods } from '../types';
 export declare const bufferToBase64Url: (buf: ArrayBuffer) => string;
 export declare const base64UrlToBuffer: (value: string) => ArrayBuffer;
 export declare const getAssetTitle: (asset: Horizon.HorizonApi.BalanceLineNative | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum4"> | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum12"> | Horizon.HorizonApi.BalanceLineLiquidityPool) => string;
@@ -34,8 +33,9 @@ export declare const getExplorerUrl: (networkPassphrase: string, explorerProvide
 export declare const getMappedWallets: (walletNames: IWalletNames) => Promise<IWallet[]>;
 export declare const getRecentConnectionMethod: () => SupportedWallet[];
 export declare const getNetworkByPassphrase: (passphrase: string) => string;
-export declare const getNetworkRpc: (network: string, transports: ITransports) => INetworkTransports;
+export { getNetworkRpc } from './networkRpc';
 export declare const canonicalWalletName: (name: string) => string;
+export declare const loginMethodsIncludeWallet: (loginMethods: ILoginMethods | string[] | undefined) => boolean;
 export declare const getSortedCheckedWallets: (wallets: IWallet[], priorityNames?: string[]) => IWallet[];
 export declare const getWalletNetwork: (wallet: IWallet) => Promise<string>;
 export declare const handleLoadWallets: (walletNames: IWalletNames, orderWallets?: string[]) => Promise<IWallet[]>;
@@ -54,3 +54,4 @@ export declare const getNetworkNamesFromPassphrase: (userNetworks: string[]) =>
 export declare const validateOrderWallets: (orderWallets: string[] | undefined) => string[];
 export declare const validateNetworkOptions: (networks: string[], defaultNetwork: string | undefined, transports: ITransports | undefined) => void;
 export declare const validateInput: (type: string, value: string) => boolean;
+export declare const isUSCanadaPhone: (raw: string) => boolean;

package/dist/utils/networkRpc.d.ts

@@ -0,0 +1,7 @@
+import { ITransports } from '../types';
+import { INetworkTransports } from '../constants/networkDetails';
+/**
+ * Resolves Horizon and Soroban URLs for a passphrase, overlaying any custom
+ * transports from config.
+ */
+export declare const getNetworkRpc: (network: string, transports: ITransports) => INetworkTransports;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluxcc/core",
-  "version": "0.2.18",
+  "version": "0.3.1",
   "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": "^16.2.0",
+    "@stellar/stellar-sdk": "^17.0.1",
     "@walletconnect/core": "^2.21.9",
     "@walletconnect/sign-client": "^2.21.9",
     "qrcode.react": "^4.2.0",