Skip to main content

Wallet Management

Wallet Types

Developer Wallet Setup

For local development and testnet:

MetaMask Setup

  1. Install MetaMask
  2. Add Immutable Chain Testnet:
    • Network Name: Immutable Testnet
    • RPC: https://rpc.testnet.immutable.com
    • Chain ID: 13473
    • Symbol: tIMX
  3. Get test tokens from the Faucet

Hardhat Configuration

Never commit .env files to version control. Add .env and .env.local to your .gitignore file to prevent accidentally exposing private keys or API secrets.

Production Treasury: Multisig

For production funds, use a multisig wallet like Safe.

Why Multisig?

  • No single point of failure: Multiple signatures required
  • Team accountability: Track who approved transactions
  • Recovery: Lost keys don’t mean lost funds

Setting Up Safe

  1. Go to Safe
  2. Connect to Immutable Chain
  3. Create a new Safe with:
    • Multiple owner addresses (team members)
    • Threshold (e.g., 2 of 3 signatures required)
  4. Fund the Safe with IMX for gas

Transaction Flow

Backend Minting Wallet

Your backend needs a wallet for minting operations.

Key Management Options

Using AWS KMS with viem

Rate Limiting & Monitoring

Protect your minting wallet:

Security Checklist

Development

  • Use separate wallet for testnet
  • Never use mainnet private keys in development
  • Clear browser wallet state between projects

Production

  • Treasury in multisig (Safe)
  • Deployer wallet on hardware device
  • Minting wallet keys in secure storage (KMS/Vault)
  • Rate limiting on minting endpoints
  • Monitoring and alerts for unusual activity
  • Regular key rotation schedule
  • Incident response plan documented

Gas Management

Estimating Costs

Maintaining Balance

Set up alerts when wallet balance drops:

Funds Recovery

From Passport Wallet

Players control their Passport wallets. Recovery is through their authentication provider (Google, Apple, etc.).

From Studio Wallets

  • Multisig: Recover with threshold of remaining signers
  • Single-sig: Depends on backup strategy
  • KMS: AWS manages key durability
Always test your recovery procedures before you need them.

Next Steps

Contracts

Deploy contracts from your secure wallet

Minting

Set up backend minting