Query Commands

objects

Query objects owned by an address.

list

List all objects owned by an address.

soma objects list [OWNER]

Argument	Type	Required	Description
owner	KeyIdentity	No	Address or alias (defaults to active address)

soma objects list

soma objects list 0x1234...5678

get

Get a specific object by ID.

soma objects get <OBJECT_ID> [OPTIONS]

Argument	Type	Required	Description
object_id	ObjectID	Yes	Object to retrieve
--bcs	flag	No	Output raw BCS bytes

soma objects get 0xABCD...

soma objects get 0xABCD... --bcs

gas

List gas coins owned by an address.

soma objects gas [OWNER]

Argument	Type	Required	Description
owner	KeyIdentity	No	Address or alias (defaults to active address)

soma objects gas

tx

Inspect and execute transactions.

info

Get transaction details by digest.

soma tx info <DIGEST>

Argument	Type	Required	Description
digest	TransactionDigest	Yes	Transaction digest to look up

soma tx info 5Gf8eQ...

execute-serialized

Execute a transaction from serialized transaction bytes.

soma tx execute-serialized <TX_BYTES> [OPTIONS]

Argument	Type	Required	Description
tx_bytes	string	Yes	Base64-encoded BCS-serialized TransactionData

Note

This command also accepts transaction processing arguments.

soma tx execute-serialized "AQAA..."

execute-signed

Execute a transaction using pre-signed transaction bytes and signatures.

soma tx execute-signed --tx-bytes <TX_BYTES> --signatures <SIGS...>

Argument	Type	Required	Description
--tx-bytes	string	Yes	Base64-encoded unsigned transaction data
--signatures	Vec<string>	Yes	Base64-encoded signatures

soma tx execute-signed --tx-bytes "AQAA..." --signatures "c2ln..."

execute-combined-signed

Execute a combined sender-signed transaction.

soma tx execute-combined-signed --signed-tx-bytes <SIGNED_TX_BYTES>

Argument	Type	Required	Description
--signed-tx-bytes	string	Yes	Base64-encoded SenderSignedData

soma tx execute-combined-signed --signed-tx-bytes "AQAA..."