# 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](https://docs.soma.org/reference/cli/overview/#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..."
```