@bluxcc/core 0.2.17 → 0.3.0

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/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/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. */
@@ -58,13 +61,13 @@ export interface IConfig {
     /** 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[];
+    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;
 }

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;
@@ -11,11 +11,16 @@ export declare const apiPasskeyChallenge: (appId: string, authValue: string) =>
 export declare const apiPasskeyVerify: (appId: string, challenge: ApiPasskeyChallenge, passkeyResult: PasskeyFlowResult) => Promise<string>;
 export declare const apiSendOtp: (appId: string, authValue: string) => 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,7 +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 { IAsset, IWallet, IExplorer, LanguageKey, ITransports, IWalletNames, ILoginMethods } from '../types';
 import { INetworkTransports } from '../constants/networkDetails';
 export declare const bufferToBase64Url: (buf: ArrayBuffer) => string;
 export declare const base64UrlToBuffer: (value: string) => ArrayBuffer;
@@ -36,6 +36,7 @@ export declare const getRecentConnectionMethod: () => SupportedWallet[];
 export declare const getNetworkByPassphrase: (passphrase: string) => string;
 export declare const getNetworkRpc: (network: string, transports: ITransports) => INetworkTransports;
 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[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluxcc/core",
-  "version": "0.2.17",
+  "version": "0.3.0",
   "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",