Wallet

Overview

The Wallet module provides a secure and easy way to create, manage, and use blockchain wallets through FSCOs API. It abstracts away the complexity of blockchain key management and transaction signing while maintaining enterprise-grade security.

Key Features

• Wallet Creation & Management: Create and manage wallets with different custody options
• Transaction Signing: Sign blockchain transactions securely
• Message Signing: Sign arbitrary messages for blockchain verification
• Flexible Custody Options: Choose between FSCO-native custody or external providers like DFNS
• Cross-Chain Compatibility: Wallet addresses work across all supported EVM chains

How It Works

Wallet Creation

1. Create a wallet by providing a name and choosing a custody provider
2. FSCO generates a secure wallet and returns a unique walletId
3. The same wallet address works across all supported EVM chains
4. All wallet operations are scoped to your organization

Wallet Operations

You can interact with wallets in several ways:

• Lookup: Find wallets by ID, address, or list all organization wallets
• Sign Transactions: Submit transaction data for automatic signing and broadcasting
• Sign Messages: Sign arbitrary messages for blockchain verification
• Management: Update wallet names or disable wallets when needed

Security Model

• Each wallet has a unique walletId for secure reference
• Private keys are never exposed or transmitted
• All signing operations happen securely within FSCO’s infrastructure
• Automatic transaction broadcasting prevents key exposure

Common Use Cases

• Smart Contract Interaction: Sign transactions to interact with smart contracts
• Asset Management: Create wallets for managing digital assets
• Message Authentication: Sign messages to prove wallet ownership
• Multi-Chain Operations: Use the same wallet across different EVM chains

Getting Started

1. Create your first wallet
2. Learn how to lookup wallets
3. Sign your first transaction
4. Sign messages

API Reference

For detailed API specifications, see the Wallet API Reference.

Best Practices

• Store walletId values securely - they’re needed for all wallet operations
• Use descriptive wallet names for easy identification
• Choose FSCO-native custody unless you have specific requirements
• Keep track of which wallets are used for what purpose
• Monitor wallet activity through your FSCO dashboard

Limitations

• Wallets are currently limited to EVM-compatible chains
• DFNS custody requires additional setup in your FSCO dashboard