<!-- Generated from the function registry (sdk/src/functions) by `cd sdk && npm run gen`. Do not edit. -->

# Accounts

> **Status:** Current (generated)

Balances and sequence numbers, and testnet MUR from the faucet.

| Function | Kind | Description |
|---|---|---|
| [`account.get`](#accountget) | read | An account's next sequence number and native MUR balance (base units; 9 decimals) |
| [`account.faucet`](#accountfaucet) | write | Testnet MUR for an address, sent by the gateway's faucet account (limited per address and per IP) |

## account.get

An account's next sequence number and native MUR balance (base units; 9 decimals).

- **Kind:** read
- **Runs:** JSON-RPC `mox_account` (`POST /`) on the gateway

**Input**

| Field | Type | Required | Description |
|---|---|---|---|
| `address` | hex32 | yes | Address: 32 bytes, 0x hex |

**Output**

An object.

| Field | Type | Required | Description |
|---|---|---|---|
| `next_seq` | integer |  | The sequence number its next transaction takes |
| `balance` | decimal string |  | MUR, base units |

**Example**

```json
{
  "name": "account.get",
  "input": {
    "address": "0x8c1f6a3e5b2d4c7f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f"
  }
}
```

```json
{
  "next_seq": 3,
  "balance": "99998200000"
}
```

## account.faucet

Testnet MUR for an address, sent by the gateway's faucet account (limited per address and per IP).

- **Kind:** write: acts at once (no wallet signature)
- **Runs:** `POST /faucet` on the gateway

**Input**

| Field | Type | Required | Description |
|---|---|---|---|
| `address` | hex32 | yes | Recipient: 32 bytes, 0x hex |

**Output**

An object.

| Field | Type | Required | Description |
|---|---|---|---|
| `hash` | hex |  | The faucet's transfer: 0x hex |
| `amount` | decimal string |  | Sent |
| `from` | hex |  | Faucet account: 0x hex |

**Example**

```json
{
  "name": "account.faucet",
  "input": {
    "address": "0x8c1f6a3e5b2d4c7f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f"
  }
}
```

```json
{
  "hash": "0x3b7d0f5c9e2a4b6c8d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e",
  "amount": "100000000000"
}
```