@bluxcc/core 0.2.6 → 0.2.8

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,6 +74,7 @@ export interface IStoreProperties {
     signMessage?: ISignMessage;
     signAuthEntry?: ISignAuthEntry;
     login?: ILoginPromise;
+    loginError?: string;
     balances: UseBalancesResult;
     transactions: UseTransactionsResult;
     selectAsset: ISelectAsset;
@@ -116,6 +117,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;
@@ -135,8 +204,6 @@ export interface ISignAuthEntry {
 export interface ISocialConfigEntry {
     provider: string;
     displayName: string;
-    clientId: string;
-    redirectUri: string;
 }
 export interface AuthenticateApiResponse {
     isValid: boolean;

package/dist/utils/api.d.ts

@@ -7,7 +7,6 @@ type ApiPasskeyChallenge = {
     challenge_id: number;
 };
 export declare const authenticateAppId: (appId: string) => Promise<AuthenticateApiResponse>;
-export declare const apiSocialLogin: (appId: string, provider: string, code: string) => Promise<string>;
 export declare const apiRegisterPasskeyChallenge: (appId: string) => Promise<ApiPasskeyChallenge>;
 export declare const apiRegisterPasskey: (appId: string, challenge: ApiPasskeyChallenge, passkeyResult: PasskeyFlowResult) => Promise<string>;
 export declare const apiSendOtp: (appId: string, authValue: string) => Promise<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,10 +3,10 @@ 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 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 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;
+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;

package/dist/utils/socialLogin.d.ts

@@ -1,11 +1,8 @@
 import CDNFiles from '../constants/cdnFiles';
-import { ILoginMethods, ISocialConfigEntry, AuthenticateApiResponse } from '../types';
+import { ILoginMethods, AuthenticateApiResponse } from '../types';
 type SocialProviderMeta = {
     displayName: string;
-    authUrl: string;
-    scopes: string[];
     icon: CDNFiles;
-    extraParams?: Record<string, string>;
 };
 export declare const SOCIAL_PROVIDERS: Record<string, SocialProviderMeta>;
 export declare const isSocialProvider: (method: string) => boolean;
@@ -13,12 +10,10 @@ export declare const getEnabledSocials: (loginMethods: ILoginMethods | string[],
 export type ISocialSession = {
     provider: string;
     popup: Window | null;
-    state: string;
-    redirectUri: string;
     error?: string;
 };
 export declare const getActiveSocialSession: () => ISocialSession | null;
 export declare const cancelActiveSocialSession: () => void;
-export declare const beginSocialLogin: (provider: string, socialsConfig: ISocialConfigEntry[]) => ISocialSession;
-export declare const awaitSocialAuthCode: (session: ISocialSession) => Promise<string>;
+export declare const beginSocialLogin: (provider: string, appId: string) => ISocialSession;
+export declare const awaitSocialLogin: (session: ISocialSession) => Promise<string>;
 export {};

package/package.json

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