@naculus/connect-appkit-react 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,13 +1,13 @@
1
1
  import * as _naculus_connect_core from '@naculus/connect-core';
2
- import { UniversalWalletSession, WalletCapabilities, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyInfo, ScopeCheckResult, SessionKeyTransaction, Hex, SessionKeyManagerConfig, SessionKeyScope, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
2
+ import { UniversalWalletSession, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyInfo, ScopeCheckResult, SessionKeyTransaction, Hex, SessionKeyManagerConfig, SessionKeyScope, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
3
3
  export { LAMPORTS_PER_SOL, PassphraseCancelledError, PassphraseGate, PassphraseIntent, PassphraseRequest, SolanaBalance, SolanaConfirmationStatus, SolanaRpcError, formatSol, getLatestBlockhash, getSignatureStatus, getSolanaBalance, parseSol } from '@naculus/connect-core';
4
4
  import { PocketConfig, WalletAccount, WalletNamespace, WalletData, StorageSecurityReport } from '@naculus/connector-embedded';
5
5
  export { StorageSecurityFinding, StorageSecurityReport, WalletAccount, WalletData, WalletNamespace } from '@naculus/connector-embedded';
6
6
  import { Web3Client } from './client.cjs';
7
7
  export { ClientConfig, clearClient, createClient, getClient } from './client.cjs';
8
8
  import * as _naculus_connect_appkit_core from '@naculus/connect-appkit-core';
9
- import { Web3State, WalletChain, ChainInfo } from '@naculus/connect-appkit-core';
10
- export { ChainInfo, ConnectionStatus, WalletChain, Web3State } from '@naculus/connect-appkit-core';
9
+ import { Web3State, WalletChain, ChainCapabilities, AtomicSupport, ChainInfo, SolanaRoles, SolanaRolesAbsence, SolanaIdentity, SolanaSigner, SolanaPayer } from '@naculus/connect-appkit-core';
10
+ export { AtomicSupport, ChainCapabilities, ChainInfo, ConnectionStatus, SolanaIdentity, SolanaPayer, SolanaRoles, SolanaRolesAbsence, SolanaSigner, SolanaWalletFeatures, WalletChain, Web3State } from '@naculus/connect-appkit-core';
11
11
  import { Address, PublicClient, WalletClient } from 'viem';
12
12
  import { SimulationResult } from '@naculus/wallet-engine';
13
13
  export { ApprovalChange, BalanceChange, GasInfo, RiskAssessment, RiskLevel, RiskWarning, SimulationResult, SimulationStatus } from '@naculus/wallet-engine';
@@ -433,25 +433,6 @@ interface UseBalanceResult {
433
433
  }
434
434
  declare function useBalance(options?: UseBalanceOptions): UseBalanceResult;
435
435
 
436
- /**
437
- * Whether a wallet can execute a batch atomically.
438
- *
439
- * Three values, not two. A wallet that does not implement
440
- * `wallet_getCapabilities` has not said no — it has said nothing, and EIP-5792
441
- * is explicit that absence is not a denial. Collapsing that into `false` sends
442
- * every such wallet down the sequential path, which is the one where an
443
- * approve can land and the swap it was for can fail.
444
- */
445
- type AtomicSupport = "supported" | "unsupported" | "unknown";
446
- interface ChainCapabilities {
447
- /** CAIP-2 chain this describes. */
448
- chainId: string;
449
- atomic: AtomicSupport;
450
- /** Largest batch the wallet will accept, when it says. */
451
- maxBatchSize?: number;
452
- /** The raw entry, for capabilities this SDK does not model. */
453
- raw: WalletCapabilities;
454
- }
455
436
  interface UseCapabilitiesReturn {
456
437
  /** Per-chain, keyed by CAIP-2. Null until a query has actually returned. */
457
438
  capabilities: Record<string, ChainCapabilities> | null;
@@ -1714,6 +1695,37 @@ interface UseSolanaBalanceReturn {
1714
1695
  */
1715
1696
  declare function useSolanaBalance(options?: UseSolanaBalanceOptions): UseSolanaBalanceReturn;
1716
1697
 
1698
+ interface UseSolanaRolesReturn {
1699
+ /** The roles the connected account can fill, or null with a reason. */
1700
+ roles: SolanaRoles | null;
1701
+ /** Why `roles` is null. Null when it is not. */
1702
+ absence: SolanaRolesAbsence | null;
1703
+ /** Which account this is. Never null while `roles` is present. */
1704
+ identity: SolanaIdentity | null;
1705
+ /**
1706
+ * Signs without submitting. Null when the wallet declared it cannot — a
1707
+ * send-only wallet, the usual shape behind Mobile Wallet Adapter — *and*
1708
+ * null when nothing is known; check `absence` to tell those apart.
1709
+ */
1710
+ signer: SolanaSigner | null;
1711
+ /** Signs and broadcasts itself. Null under the same two conditions. */
1712
+ payer: SolanaPayer | null;
1713
+ }
1714
+ /**
1715
+ * Which roles the connected Solana account can actually fill.
1716
+ *
1717
+ * Ask before building a flow. A multisig proposal, a co-signed escrow or a
1718
+ * relayer-submitted transaction needs `signer`; an ordinary transfer needs
1719
+ * `payer`; filling an `authority` field needs only `identity`. A wallet can
1720
+ * answer yes to one and no to another, and finding out here is what keeps
1721
+ * the answer from arriving at the approval prompt instead.
1722
+ *
1723
+ * Synchronous: the connector recorded what the wallet declared at discovery,
1724
+ * so this never prompts. Recomputed when the session or its accounts change,
1725
+ * which is how an in-wallet account switch reaches `identity.address`.
1726
+ */
1727
+ declare function useSolanaRoles(): UseSolanaRolesReturn;
1728
+
1717
1729
  interface UseSolanaTransactionReturn {
1718
1730
  /**
1719
1731
  * Sign a serialized transaction and return the signed bytes.
@@ -2267,4 +2279,4 @@ declare const AppkitToggleGroup: StencilReactComponent<AppkitToggleGroup$1, Appk
2267
2279
  type AppkitTooltipEvents = NonNullable<unknown>;
2268
2280
  declare const AppkitTooltip: StencilReactComponent<AppkitTooltip$1, AppkitTooltipEvents, Components.AppkitTooltip>;
2269
2281
 
2270
- export { type AddressValidationLevel, type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, type AtomicSupport, type ChainCapabilities, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_EVM_CHAINS, type DelegationPolicyPreview, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecuteRouteResult, type ExecutionPreview, type ExecutionRoute, type Locale, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PreparedPolicyExecution, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, buildDelegationPolicyMessage, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };
2282
+ export { type AddressValidationLevel, type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_EVM_CHAINS, type DelegationPolicyPreview, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecuteRouteResult, type ExecutionPreview, type ExecutionRoute, type Locale, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PreparedPolicyExecution, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaRolesReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, buildDelegationPolicyMessage, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaRoles, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };
package/dist/index.d.ts CHANGED
@@ -1,13 +1,13 @@
1
1
  import * as _naculus_connect_core from '@naculus/connect-core';
2
- import { UniversalWalletSession, WalletCapabilities, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyInfo, ScopeCheckResult, SessionKeyTransaction, Hex, SessionKeyManagerConfig, SessionKeyScope, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
2
+ import { UniversalWalletSession, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyInfo, ScopeCheckResult, SessionKeyTransaction, Hex, SessionKeyManagerConfig, SessionKeyScope, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
3
3
  export { LAMPORTS_PER_SOL, PassphraseCancelledError, PassphraseGate, PassphraseIntent, PassphraseRequest, SolanaBalance, SolanaConfirmationStatus, SolanaRpcError, formatSol, getLatestBlockhash, getSignatureStatus, getSolanaBalance, parseSol } from '@naculus/connect-core';
4
4
  import { PocketConfig, WalletAccount, WalletNamespace, WalletData, StorageSecurityReport } from '@naculus/connector-embedded';
5
5
  export { StorageSecurityFinding, StorageSecurityReport, WalletAccount, WalletData, WalletNamespace } from '@naculus/connector-embedded';
6
6
  import { Web3Client } from './client.js';
7
7
  export { ClientConfig, clearClient, createClient, getClient } from './client.js';
8
8
  import * as _naculus_connect_appkit_core from '@naculus/connect-appkit-core';
9
- import { Web3State, WalletChain, ChainInfo } from '@naculus/connect-appkit-core';
10
- export { ChainInfo, ConnectionStatus, WalletChain, Web3State } from '@naculus/connect-appkit-core';
9
+ import { Web3State, WalletChain, ChainCapabilities, AtomicSupport, ChainInfo, SolanaRoles, SolanaRolesAbsence, SolanaIdentity, SolanaSigner, SolanaPayer } from '@naculus/connect-appkit-core';
10
+ export { AtomicSupport, ChainCapabilities, ChainInfo, ConnectionStatus, SolanaIdentity, SolanaPayer, SolanaRoles, SolanaRolesAbsence, SolanaSigner, SolanaWalletFeatures, WalletChain, Web3State } from '@naculus/connect-appkit-core';
11
11
  import { Address, PublicClient, WalletClient } from 'viem';
12
12
  import { SimulationResult } from '@naculus/wallet-engine';
13
13
  export { ApprovalChange, BalanceChange, GasInfo, RiskAssessment, RiskLevel, RiskWarning, SimulationResult, SimulationStatus } from '@naculus/wallet-engine';
@@ -433,25 +433,6 @@ interface UseBalanceResult {
433
433
  }
434
434
  declare function useBalance(options?: UseBalanceOptions): UseBalanceResult;
435
435
 
436
- /**
437
- * Whether a wallet can execute a batch atomically.
438
- *
439
- * Three values, not two. A wallet that does not implement
440
- * `wallet_getCapabilities` has not said no — it has said nothing, and EIP-5792
441
- * is explicit that absence is not a denial. Collapsing that into `false` sends
442
- * every such wallet down the sequential path, which is the one where an
443
- * approve can land and the swap it was for can fail.
444
- */
445
- type AtomicSupport = "supported" | "unsupported" | "unknown";
446
- interface ChainCapabilities {
447
- /** CAIP-2 chain this describes. */
448
- chainId: string;
449
- atomic: AtomicSupport;
450
- /** Largest batch the wallet will accept, when it says. */
451
- maxBatchSize?: number;
452
- /** The raw entry, for capabilities this SDK does not model. */
453
- raw: WalletCapabilities;
454
- }
455
436
  interface UseCapabilitiesReturn {
456
437
  /** Per-chain, keyed by CAIP-2. Null until a query has actually returned. */
457
438
  capabilities: Record<string, ChainCapabilities> | null;
@@ -1714,6 +1695,37 @@ interface UseSolanaBalanceReturn {
1714
1695
  */
1715
1696
  declare function useSolanaBalance(options?: UseSolanaBalanceOptions): UseSolanaBalanceReturn;
1716
1697
 
1698
+ interface UseSolanaRolesReturn {
1699
+ /** The roles the connected account can fill, or null with a reason. */
1700
+ roles: SolanaRoles | null;
1701
+ /** Why `roles` is null. Null when it is not. */
1702
+ absence: SolanaRolesAbsence | null;
1703
+ /** Which account this is. Never null while `roles` is present. */
1704
+ identity: SolanaIdentity | null;
1705
+ /**
1706
+ * Signs without submitting. Null when the wallet declared it cannot — a
1707
+ * send-only wallet, the usual shape behind Mobile Wallet Adapter — *and*
1708
+ * null when nothing is known; check `absence` to tell those apart.
1709
+ */
1710
+ signer: SolanaSigner | null;
1711
+ /** Signs and broadcasts itself. Null under the same two conditions. */
1712
+ payer: SolanaPayer | null;
1713
+ }
1714
+ /**
1715
+ * Which roles the connected Solana account can actually fill.
1716
+ *
1717
+ * Ask before building a flow. A multisig proposal, a co-signed escrow or a
1718
+ * relayer-submitted transaction needs `signer`; an ordinary transfer needs
1719
+ * `payer`; filling an `authority` field needs only `identity`. A wallet can
1720
+ * answer yes to one and no to another, and finding out here is what keeps
1721
+ * the answer from arriving at the approval prompt instead.
1722
+ *
1723
+ * Synchronous: the connector recorded what the wallet declared at discovery,
1724
+ * so this never prompts. Recomputed when the session or its accounts change,
1725
+ * which is how an in-wallet account switch reaches `identity.address`.
1726
+ */
1727
+ declare function useSolanaRoles(): UseSolanaRolesReturn;
1728
+
1717
1729
  interface UseSolanaTransactionReturn {
1718
1730
  /**
1719
1731
  * Sign a serialized transaction and return the signed bytes.
@@ -2267,4 +2279,4 @@ declare const AppkitToggleGroup: StencilReactComponent<AppkitToggleGroup$1, Appk
2267
2279
  type AppkitTooltipEvents = NonNullable<unknown>;
2268
2280
  declare const AppkitTooltip: StencilReactComponent<AppkitTooltip$1, AppkitTooltipEvents, Components.AppkitTooltip>;
2269
2281
 
2270
- export { type AddressValidationLevel, type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, type AtomicSupport, type ChainCapabilities, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_EVM_CHAINS, type DelegationPolicyPreview, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecuteRouteResult, type ExecutionPreview, type ExecutionRoute, type Locale, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PreparedPolicyExecution, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, buildDelegationPolicyMessage, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };
2282
+ export { type AddressValidationLevel, type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_EVM_CHAINS, type DelegationPolicyPreview, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecuteRouteResult, type ExecutionPreview, type ExecutionRoute, type Locale, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PreparedPolicyExecution, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaRolesReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, buildDelegationPolicyMessage, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaRoles, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };