​
Account Types

Grid provides three types of accounts that work together to enable comprehensive stablecoin operations. Each type serves a specific purpose in the overall architecture:

​
Smart Account

The foundation of programmable stablecoin operations. Smart accounts are blockchain-based accounts that enable:
  • Native stablecoin transactions
  • Programmable payment flows
  • On-chain authority management
  • Direct blockchain interactions

​
Virtual Account

A traditional banking account that bridges traditional and stablecoin operations. Virtual accounts:
  • Receive funds from traditional payment rails (ACH, SEPA, etc.)
  • Automatically convert incoming traditional currency to stablecoins
  • Enable withdrawals to traditional banking systems
  • Provide banking infrastructure for stablecoin operations

​
Stablecoin Account

The complete package that combines all components for comprehensive stablecoin management:
  • Smart account for blockchain operations
  • Virtual accounts for traditional finance rails
  • Authority management for access control
  • Payment processing across all rails

​
Smart Accounts

Smart accounts are the foundation of Grid’s architecture. They are programmable accounts that can hold funds and execute transactions based on predefined policies.

​
Creating a Smart Account

Smart account creation is a direct operation that establishes the initial state and authorities for the account.

​
Account Policies

When creating a smart account, you define its policies. For a comprehensive guide on policies, see Policies.
  • Authorities: List of signers with their permissions
  • Threshold: Number of required signatures
  • Time Lock: Optional delay for sensitive operations
{
  "policies": {
    "authorities": [
      {
        "address": "0x...",
        "permissions": ["CAN_INITIATE", "CAN_VOTE", "CAN_EXECUTE"]
      }
    ],
    "threshold": 2,
    "time_lock": 3600
  }
}

​
Virtual Accounts

Virtual accounts provide a way to receive funds from traditional banking systems. They are automatically linked to your smart account.

​
Supported Currencies and Rails

Grid supports a comprehensive set of currencies and payment rails. For detailed information about supported currencies and payment rails, see Supported Currencies and Rails.

​
Account Management

Once created, you can manage your smart account through various operations:

​
Viewing Account Details

GET /smart-accounts/{address}

​
Checking Balances

GET /smart-accounts/{address}/balances

​
Managing Authorities

  • Add new authorities
  • Remove existing authorities
  • Update authority permissions

​
API Reference

For detailed API specifications, see: