Skip to main content

Understanding Workspace Wallets

What is a Workspace Wallet?

A workspace wallet is the default receiving wallet for your Layer4 workspace. It serves as:

  • The default owner for tokens created within your workspace
  • A receiving address for workspace-related transactions
  • The fallback wallet when no specific receiving address is provided

The workspace wallet is separate from wallet connections. While it's the workspace's own wallet, it's not involved in the connections between your workspace and user wallets.

Wallet Connections

Wallet connections are relationships established between:

  • Your workspace (as an organization)
  • Individual user wallets (owned by team members, partners, etc.)

These connections enable:

  • Asset distribution to users via email
  • Simplified token management
  • Secure user-workspace relationships

How Connections Work

  1. Workspace administrators send connection invitations to users via email
  2. Users receive and can approve/decline the connection request
  3. Upon approval, the workspace can send assets to the user's wallet using their email
  4. The user maintains full control of their wallet throughout the connection

Management and Privileges

Admin Capabilities

Workspace owners and administrators can:

  • Manage wallet connections with users
  • Send connection invitations
  • View connected user wallets
  • Distribute assets to connected wallets via email
  • Access connection management via web app or API

Default Wallet Management

The workspace wallet:

  • Automatically receives newly created tokens when no other address is specified
  • Acts as the default receiving address for workspace transactions
  • Requires no connection setup or approval process

Security and Best Practices

Connection Security

  • Connections don't give workspaces access to user wallets
  • Users maintain complete control over their wallets
  • Connection only enables sending assets to user wallets

Best Practices

  • Regularly review and maintain wallet connections
  • Document asset distribution workflows
  • Keep connection records up to date
  • Use descriptive identifiers for connections
  • Specify receiving addresses when creating tokens if you don't want them in the workspace wallet

While the workspace wallet serves as your default token receiving address, wallet connections let you distribute assets to team members and partners using just their email addresses.