ƒxyzƒxyz Network
User Guides

Wallets & Assets

Manage embedded wallets, connect external wallets, and understand multi-chain support on fXYZ Network.

Wallets & Assets

fXYZ Network provides a seamless multi-chain wallet experience powered by Privy embedded wallets alongside support for external wallet connections.


Embedded Wallets

Every user receives embedded wallets automatically upon account creation:

ChainPurposeToken Support
EVM (Ethereum)Multi-chain operations, DeFi, bridgesETH, USDC, USDT, and ERC-20 tokens
SolanaFlorin tokens, membership NFTs, on-chain dataSOL, FLR, SPL tokens

Key Features

  • Self-Custodial: Only you control your private keys
  • Seamless UX: No wallet popups or transaction approvals needed
  • Multi-Chain: One account, multiple blockchain networks
  • Secure Storage: Keys secured by Privy's infrastructure
  • Export Capability: Export private keys if needed

Why Embedded Wallets?

Traditional Web3:
User → MetaMask popup → Approve → Wait → Confirm → Another popup

fXYZ Network:
User → Action complete (embedded wallet signs automatically)

Florin Operations: The Solana embedded wallet is essential for Florin token operations, including confidential balance decryption and token transfers.


Viewing Your Wallets

Navigate to Wallets from the sidebar to see:

Portfolio Overview

  • Total Balance: Aggregated value across all wallets
  • Chain Breakdown: Assets per blockchain
  • Recent Activity: Latest transactions

Wallet Addresses

Your wallets page displays:

EVM Wallet:    0x1234...abcd (Ethereum, Polygon, Base, etc.)
Solana Wallet: ABC123...xyz (Solana mainnet-beta)

Click any address to copy it or view on block explorer.


Creating Missing Wallets

If your embedded wallets weren't created during signup:

Go to app.fxyz.network/wallets

Check Status

You'll see badges indicating:

  • EVM: (checkmark or X)
  • Solana: (checkmark or X)

Create Wallets

Click the appropriate button:

  • Create Both EVM & Solana Wallets - Creates both at once
  • Create EVM Wallet - EVM only
  • Create Solana Wallet - Solana only

Verify Success

After creation, you'll see:

  • Green success banner
  • Both wallet types showing checkmarks
  • "Embedded Wallets Ready" confirmation

External Wallets

You can also connect external wallets for additional flexibility:

Supported Wallets

WalletChainsFeatures
MetaMaskEVMBrowser extension, mobile app
PhantomSolana, EVMPopular Solana wallet
Coinbase WalletEVMIntegrated with Coinbase
RainbowEVMMobile-first design
LedgerEVM, SolanaHardware security

Connecting External Wallet

  1. Navigate to Account SettingsConnected Accounts
  2. Click Add next to "External Wallet"
  3. Select your wallet from the popup
  4. Approve the connection in your wallet
  5. Wallet appears in your linked accounts

Important: External wallets are for authentication and identity. Day-to-day transactions use embedded wallets for better UX.


Multi-Chain Support

fXYZ Network operates across multiple blockchains:

Primary Chains

ChainStatusUse Cases
SolanaPrimaryFlorin tokens, membership NFTs, fast transactions
EthereumSupportedHigh-value assets, DeFi integrations
BaseSupportedLow-cost EVM transactions
PolygonSupportedScaling solution, low fees

Bridge Integration

The platform integrates with Bridge.xyz for:

  • Fiat on-ramps (USD → Crypto)
  • Fiat off-ramps (Crypto → USD)
  • Cross-chain transfers
  • Stablecoin conversions

See Bridge API documentation for details.


Florin Token (FLR)

Florin is the primary utility token on fXYZ Network:

Features

FeatureDescription
Token StandardSolana SPL Token with Token-2022 extensions
Confidential TransfersBalance encryption for privacy
Voucher SystemOff-chain vouchers redeemable for FLR
Membership IntegrationStake FLR for tier benefits

Viewing Florin Balance

Your Florin balance appears on the dashboard with:

  • Encrypted Balance: Privacy-preserving display
  • Decrypt Option: View actual amount (requires Solana wallet signature)
  • Pending Vouchers: Unredeemed Florin vouchers

Florin Operations

// Example: Florin balance is shown as encrypted by default
Encrypted Balance: ████████████

// After decryption (requires wallet signature)
Balance: 1,500.00 FLR

Transactions

Viewing History

Navigate to WalletsTransactions to see:

  • All blockchain transactions
  • Fiat on/off-ramp history
  • Voucher redemptions
  • NFT mints

Transaction Types

TypeDescription
TransferToken sends/receives
SwapToken exchanges
MintNFT or token minting
BridgeCross-chain transfers
On-RampFiat → Crypto
Off-RampCrypto → Fiat

Analytics

Navigate to WalletsAnalytics for:

  • Portfolio Charts: Historical value over time
  • Asset Allocation: Breakdown by token/chain
  • Activity Metrics: Transaction frequency and volume
  • Performance: Gains/losses tracking

Security

Embedded Wallet Security

Privy embedded wallets provide:

  • MPC (Multi-Party Computation): Keys never exist in one place
  • No Browser Storage: Private keys not stored in localStorage
  • Recovery: Account recovery via your login method
  • Audit Trail: All transactions logged

Best Practices

  1. Don't share seed phrases - Embedded wallets don't expose seed phrases
  2. Verify transactions - Review before confirming high-value transfers
  3. Use hardware wallets - For large holdings, connect Ledger
  4. Enable notifications - Get alerts for wallet activity

Troubleshooting

Wallet Not Loading

Symptoms: Wallet shows "loading" indefinitely
Fix:
1. Clear browser cache
2. Try incognito/private mode
3. Check network connection
4. Refresh page

Missing Balance

Symptoms: Balance shows 0 but should have funds
Fix:
1. Check correct network (mainnet vs devnet)
2. Wait for blockchain confirmation
3. Verify transaction on block explorer
4. Contact support if persists

Transaction Failed

Symptoms: Transaction shows error
Common causes:
- Insufficient gas/SOL for fees
- Network congestion
- Invalid recipient address
Fix: Check error message, ensure sufficient balance for fees