Account Setup

Create a Wallet

To interact with the SOMA network, you need an address and its associated key pair. Create one with:

soma wallet new --alias my-wallet

The command returns your new address and a 12-word recovery phrase:

Generated new key pair for address with scheme "ed25519" [0xb9c83a8b40d3263c9ba40d551514fbac1f8c12e98a4005a0dac072d3549c2442]
Secret Recovery Phrase : [cap wheat many line human lazy few solid bored proud speed grocery]

To view your addresses:

soma wallet list

To check which address is currently active:

soma wallet active

Connect to a Network

SOMA has two primary environments:

Testnet — the default public test network
Localnet — a local network for development (requires running soma start localnet, covered in Start a Local Network)

View available environments:

soma env list

Check which environment is currently active:

soma env active

Switch to a different environment:

soma env switch testnet

Fund Your Account

On testnet or localnet, request tokens from the faucet:

soma faucet

Check your balance:

soma balance

Managing Multiple Addresses

You can create additional addresses at any time:

soma wallet new --alias second-wallet

Switch between addresses by alias or address:

soma wallet switch ADDRESS_OR_ALIAS

View all addresses:

soma wallet list

The default key scheme is ed25519. You can specify a different scheme when creating an address if needed.

Recovery and Key Storage

SOMA stores private keys in:

~/.soma/keystore.json

To recover an address from a recovery phrase:

soma keytool import 'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12' ed25519

The entire recovery phrase must be enclosed in single quotation marks. Enter the words in the correct order.