> For the complete documentation index, see [llms.txt](https://atoma.gitbook.io/atoma-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atoma.gitbook.io/atoma-docs/node-operators/atoma-node/atoma-node-daemon/submit-new-node-registration-transaction.md).

# Submit new node registration transaction

Here's the documentation for the Node Registration endpoint following the established schema:

#### Node Registration

**Register Node**

```
POST /register
```

Submits a transaction to register a new node in the network.

**Request Body**

```json
{
    "gas": "0x123",
    "gas_budget": 1000, # optional
    "gas_price": 10 # optional
}
```

**Request Fields**

* `gas` (string): Object ID of the gas object to pay for the transaction
* `gas_budget` (integer): Maximum gas units allowed for the transaction
* `gas_price` (integer): Price per gas unit in MIST (smallest currency unit)

**Response Status Codes**

* `200 OK`: Successfully submitted node registration transaction
* `500 Internal Server Error`: Failed to submit the transaction

**Response**

```json
{
    "tx_digest": "0xabc"
}
```

**Response Fields**

* `tx_digest` (string): Transaction digest that can be used to track the transaction status

**Example Error Response**

```json
{
    "error": "Failed to submit node registration tx"
}
```

**Notes**

* Node registration is required before participating in any network activities
* The gas object must be owned by the wallet submitting the transaction
* The transaction digest can be used to:
  * Track transaction status
  * Verify successful registration
  * Retrieve the node badge object ID
* After successful registration, the node will receive a unique node badge and small ID
* Gas budget should be set appropriately to ensure transaction completion