Krist

https://krist.dev/docs
Admin
Krist is a decentralized network or cryptocurrency, and this documentation provides a reference for...
Tokens:31,766
Snippets:130
Trust Score:6.4
Update:9 months ago
Show doc for...
Tokens:
Raw
### Success Response Example for Subscription Level

Source: https://krist.dev/docs/index

An example of a successful response indicating the user's current subscription level after an operation.

```json
{
    "ok": true,
    "id": 1,
    "subscription_level": [
        "ownTransactions",
        "blocks"
    ]
}
```

--------------------------------

### API Error Response Example (Name Not Found)

Source: https://krist.dev/docs/index

An example of an error response when the specified name does not exist in the system. The API returns `ok: false` and an `error` field indicating `name_not_found`.

```json
{
    "ok": false,
    "error": "name_not_found"
}
```

--------------------------------

### Make a Transaction (Request Body Example)

Source: https://krist.dev/docs/index

This example shows the required JSON request body for making a Krist transaction. It includes the sender's private key, recipient address, amount, and an optional metadata field.

```json
{
    "privatekey": "YOUR_PRIVATE_KEY",
    "to": "RECIPIENT_ADDRESS",
    "amount": 1000,
    "metadata": "Optional metadata here"
}
```

--------------------------------

### GET /names

Source: https://krist.dev/docs/index

Lists all available names, with options for pagination.

```APIDOC
## GET /names

### Description
Lists all available names, with options for pagination.

### Method
GET

### Endpoint
/names

### Parameters
#### Query Parameters
- **limit** (Number) - Optional - The maximum amount of results to return. Must be between 1 and 1000. Default value: `50`.
- **offset** (Number) - Optional - The amount to offset the results, useful to paginate results, and in conjunction with `limit`. Default value: `0`.

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **names** (Array) - An array of name objects. (Structure of name objects is detailed in the 'Get a name' endpoint).

#### Response Example
```json
{
    "ok": true,
    "names": [
        {
            "name": "example",
            "owner": "k123abc",
            "original_owner": "k123abc",
            "registered": "2023-01-01T12:00:00.000Z",
            "updated": "2023-01-01T12:00:00.000Z",
            "unpaid": 0
        }
    ]
}
```
```

--------------------------------

### Get Transaction History (JSON Example)

Source: https://krist.dev/docs/index

This snippet demonstrates the JSON response structure for retrieving a list of Krist transactions. It includes fields like count, total, and an array of transaction objects, each with detailed information.

```json
{
    "ok": true,
    "count": 50,
    "total": 175000,
    "transactions": [
        {
            "id": 153287,
            "from": null,
            "to": "kre3w0i79j",
            "value": 14,
            "time": "2016-02-06T19:22:41.000Z",
            "name": null,
            "metadata": null,
            "sent_metaname": null,
            "sent_name": null,
            "type": "mined"
        },
        {
            "id": 153286,
            "from": "kxxhsp1uzh",
            "to": "name",
            "value": 500,
            "time": "2016-02-06T14:01:19.000Z",
            "name": "exam",
            "metadata": null,
            "sent_metaname": null,
            "sent_name": null,
            "type": "name_purchase"
        }
    ]
}
```

--------------------------------

### Get Specific Transaction (JSON Example)

Source: https://krist.dev/docs/index

This JSON example illustrates the response when fetching a single Krist transaction by its ID. It returns a success status and a detailed transaction object.

```json
{
    "ok": true,
    "transaction": {
        "id": 153282,
        "from": "kh9w36ea1b",
        "to": "kutlg1kzhz",
        "value": 56610,
        "time": "2016-02-03T19:15:32.000Z",
        "name": null,
        "metadata": null,
        "sent_metaname": null,
        "sent_name": null,
        "type": "transfer"
    }
}
```

--------------------------------

### GET /websites/krist_dev/wallet_version

Source: https://krist.dev/docs/index

Retrieves the latest version number for KristWallet.

```APIDOC
## GET /websites/krist_dev/wallet_version

### Description
Retrieves the latest version number for KristWallet.

### Method
GET

### Endpoint
/websites/krist_dev/wallet_version

### Parameters
#### Query Parameters
None

#### Request Body
None

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **walletVersion** (Number) - The latest KristWallet version.

#### Response Example
```json
{
    "ok": true,
    "walletVersion": 14
}
```
```

--------------------------------

### Transfer Name - API Request Example

Source: https://krist.dev/docs/index

Demonstrates how to transfer a name to another owner using the Names API. Requires the name and the recipient's address, along with your private key for authentication. The response includes details of the transferred name.

```javascript
fetch("/api/v2/names/transfer", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "example",
    address: "new_owner_address",
    privatekey: "your_private_key"
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

--------------------------------

### GET /names/cost

Source: https://krist.dev/docs/index

Retrieves the current cost to register a name. This is useful for informing users about registration fees.

```APIDOC
## GET /names/cost

### Description
Retrieves the current cost to register a name. This is useful for informing users about registration fees.

### Method
GET

### Endpoint
/names/cost

### Response
#### Success Response (200)
- **name_cost** (Number) - The cost of a name

#### Response Example
```json
{
    "ok": true,
    "name_cost": 500
}
```
```

--------------------------------

### GET /names/new

Source: https://krist.dev/docs/index

Lists the newest names registered. This endpoint is useful for identifying recently added names.

```APIDOC
## GET /names/new

### Description
Lists the newest names registered. This endpoint is useful for identifying recently added names.

### Method
GET

### Endpoint
/names/new

### Query Parameters
- **limit** (Number) - Optional - The maximum amount of results to return. Must be between 1 and 1000. Default value: `50` Size range: `1-1000`
- **offset** (Number) - Optional - The amount to offset the results, useful to paginate results, and in conjunction with `limit`. Default value: `0`

### Response
#### Success Response (200)
- **count** (Number) - The count of results.
- **total** (Number) - The total amount of new names returned.
- **names** (Object[]) - An array of name objects.
  - **name** (String) - The name, without the `.kst` suffix.
  - **owner** (String) - The address that currently owns this name.
  - **original_owner** (String) - Optional - The address that originally purchased this name.
  - **registered** (Date) - The time this name was registered, as an ISO-8601 string.
  - **updated** (Date) - The time this name was last updated - either the data changed, or it was transferred to a new owner, as an ISO-8601 string.
  - **transferred** (Date) - Optional - The time this name was last transferred to a new owner, as an ISO-8601 string.
  - **a** (String) - The name's data.
  - **unpaid** (Number) - Currently unused.

#### Response Example
```json
{
    "ok": true,
    "count": 50,
    "total": 67,
    "names": [
        {
            "name": "0",
            "owner": "kxxxxxxxxx",
            "original_owner": "kmr20h6bvb",
            "registered": "2015-05-10T20:56:37.000Z",
            "updated": "2020-01-04T05:07:45.000Z",
            "transferred": "2020-01-04T05:07:45.000Z",
            "a": null,
            "unpaid": 0
        }
    ]
}
```
```

--------------------------------

### API Success Response Example (Transfer/Update)

Source: https://krist.dev/docs/index

A typical success response from the Names API after a successful name transfer or data update. It confirms the operation with `ok: true` and provides the updated details of the name, including its owner, registration, and update timestamps.

```json
{
    "ok": true,
    "name": {
        "name": "example",
        "owner": "kre3w0i79j",
        "original_owner": "kre3w0i79j",
        "registered": "2016-02-06T14:01:19.000Z",
        "updated": "2016-02-07T15:30:10.000Z",
        "transferred": "2016-02-06T14:08:36.000Z",
        "a": "krist.dev",
        "unpaid": 0
    }
}
```

--------------------------------

### GET /supply

Source: https://krist.dev/docs/index

Returns the amount of Krist currently in circulation.

```APIDOC
## GET /supply

### Description
Returns the amount of Krist currently in circulation.

### Method
GET

### Endpoint
/supply

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **money_supply** (Number) - The amount of Krist in circulation.

#### Response Example
```json
{
    "ok": true,
    "money_supply": 1013359534
}
```
```

--------------------------------

### GET /websites/krist_dev

Source: https://krist.dev/docs/index

Retrieves general information about the Krist server, including the message of the day (MOTD), server time, public URLs, build details, and configuration constants.

```APIDOC
## GET /websites/krist_dev

### Description
Retrieves general information about the Krist server, including the message of the day (MOTD), server time, public URLs, build details, and configuration constants.

### Method
GET

### Endpoint
/websites/krist_dev

### Parameters
#### Query Parameters
None

#### Request Body
None

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **server_time** (Date) - The current server time, as an ISO-8601 string.
- **motd** (String) - The message of the day.
- **set** (Date) - The date the MOTD was last changed (provided for backwards compatibility).
- **motd_set** (Date) - The date the MOTD was last changed, as an ISO-8601 string.
- **public_url** (String) - The public URL of this Krist node.
- **public_ws_url** (String) - The public URL of the Websocket gateway.
- **mining_enabled** (Boolean) - Indicates if mining is currently enabled.
- **debug_mode** (Boolean) - If the server is running in debug mode, this will be set to `true`.
- **work** (Number) - The current work value for mining.
- **last_block** (Object) - Information about the last block mined.
  - **height** (Number) - The height of the block.
  - **address** (String) - The address associated with the block.
  - **hash** (String) - The hash of the block.
  - **short_hash** (String) - A shortened version of the block hash.
  - **value** (Number) - The value of the block.
  - **time** (Date) - The timestamp of the block.
  - **difficulty** (Number) - The difficulty of the block.
- **package** (Object) - Information related to this build of the Krist source code.
  - **name** (String) - The name of the package (always `krist`).
  - **version** (String) - The version of the Krist server.
  - **author** (String) - The author of the Krist server (always `Lemmmy`).
  - **licence** (String) - The license of the Krist server (e.g., `GPL-3.0`).
  - **repository** (String) - The repository of the Krist server source code.
- **constants** (Object) - Constants related to the Krist server configuration.
  - **wallet_version** (Number) - The latest version of KristWallet.
  - **nonce_max_size** (Number) - The maximum size for a nonce.
  - **name_cost** (Number) - The cost, in KST, of purchasing a new name.
  - **min_work** (Number) - The minimum work required.
  - **max_work** (Number) - The maximum work allowed.
  - **work_factor** (Number) - The work factor.
  - **seconds_per_block** (Number) - The target time in seconds for each block.
- **currency** (Object) - Constants related to the currency that this server represents.
  - **address_prefix** (String) - The character that each address starts with (e.g. `k`).
  - **name_suffix** (String) - The suffix that each name ends with after the dot (e.g. `kst`).
  - **currency_name** (String) - The full long name of this currency (e.g. `Krist`).
  - **currency_symbol** (String) - The shorthand symbol for this currency (e.g. `KST`).
- **notice** (String) - Required copyright notice for the Krist server.

#### Response Example
```json
{
    "ok": true,
    "server_time": "2023-03-22T21:14:29.483Z",
    "motd": "The API URL has changed to https://krist.dev\n\nBlock submission is disabled ([more info](https://discord.sc3.io))",
    "set": "2023-03-22T21:14:06.000Z",
    "motd_set": "2023-03-22T21:14:06.000Z",
    "public_url": "krist.dev",
    "public_ws_url": "ws.krist.dev",
    "mining_enabled": false,
    "debug_mode": false,
    "work": 100000,
    "last_block": {
        "height": 2121616,
        "address": "kristdeath",
        "hash": "00000000009f16ac5ded918793310016ea2d61a29d5a328e244cd8478da6924c",
        "short_hash": "00000000009f",
        "value": 1,
        "time": "2022-07-19T20:43:09.000Z",
        "difficulty": 551
    },
    "package": {
        "name": "krist",
        "version": "3.3.0",
        "author": "Lemmmy",
        "licence": "GPL-3.0",
        "repository": "https://github.com/tmpim/Krist"
    },
    "constants": {
        "wallet_version": 16,
        "nonce_max_size": 24,
        "name_cost": 500,
        "min_work": 100,
        "max_work": 100000,
        "work_factor": 0.025,
        "seconds_per_block": 60
    },
    "currency": {
        "address_prefix": "k",
        "name_suffix": "kst",
        "currency_name": "Krist",
        "currency_symbol": "KST"
    },
    "notice": "Krist was originally created by 3d6 and Lemmmy. It is now owned and operated by tmpim, and licensed under GPL-3.0."
}
```
```

--------------------------------

### GET /names/{name}

Source: https://krist.dev/docs/index

Retrieves details for a specific name, including its owner, registration date, and associated data.

```APIDOC
## GET /names/{name}

### Description
Retrieves details for a specific name, including its owner, registration date, and associated data.

### Method
GET

### Endpoint
/names/{name}

### Parameters
#### Path Parameters
- **name** (String) - Required - The name to retrieve.

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **name** (Object) - An object containing details about the name.
  - **name** (String) - The name, without the `.kst` suffix.
  - **owner** (String) - The address that currently owns this name.
  - **original_owner** (String) - The address that originally purchased this name.
  - **registered** (Date) - The time this name was registered, as an ISO-8601 string.
  - **updated** (Date) - The time this name was last updated - either the data changed, or it was transferred to a new owner, as an ISO-8601 string.
  - **transferred** (Date) - Optional - The time this name was last transferred to a new owner, as an ISO-8601 string.
  - **a** (String) - Optional - The name's data.
  - **unpaid** (Number) - Currently unused.

#### Response Example
```json
{
    "ok": true,
    "name": {
        "name": "00",
        "owner": "k9qyx784k7",
        "original_owner": "k9qyx784k7",
        "registered": "2015-05-14T14:35:40.000Z",
        "updated": "2015-05-24T22:47:56.000Z",
        "transferred": "2015-05-24T22:36:54.000Z",
        "a": null,
        "unpaid": 0
    }
}
```
```

--------------------------------

### API Error Response Example (Not Name Owner)

Source: https://krist.dev/docs/index

This error response is returned when the authenticated user does not own the name they are trying to modify or transfer. The API indicates failure with `ok: false` and the error code `not_name_owner`.

```json
{
    "ok": false,
    "error": "not_name_owner"
}
```

--------------------------------

### Websockets | Get all valid subscription levels

Source: https://krist.dev/docs/index

Retrieves a list of all available subscription levels for the Krist network.

```APIDOC
## POST /websites/krist_dev/websocket

### Description
Retrieves a list of all available subscription levels for the Krist network.

### Method
POST

### Endpoint
/websites/krist_dev/websocket

### Parameters
#### Request Body
- **id** (Number) - Required - Unique identifier for the request.
- **type** (String) - Required - Must be `"get_valid_subscription_levels"`.

### Request Example
```json
{
  "id": 1,
  "type": "get_valid_subscription_levels"
}
```

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **id** (Number) - The request identifier.
- **valid_subscription_levels** (String[]) - An array of strings, where each string is a valid subscription level.

### Response Example
```json
{
    "ok": true,
    "id": 1,
    "valid_subscription_levels": [
        "blocks",
        "ownBlocks",
        "transactions",
        "ownTransactions",
        "names",
        "ownNames",
        "motd"
    ]
}
```
```

--------------------------------

### Get User Info Success Response (Guest)

Source: https://krist.dev/docs/index

This JSON object represents the success response when fetching information for a guest user. It includes a boolean 'ok' field, an 'id', and a 'isGuest' field set to true.

```json
{
    "ok": true,
    "id": 1,
    "isGuest": true
}
```

--------------------------------

### Example Transaction Response (JSON)

Source: https://krist.dev/docs/index

This JSON object represents a successful response from the Lookup API, containing transaction data. It includes the total and returned counts, along with an array of transaction objects, each detailing an ID, sender, recipient, value, timestamp, and type.

```json
{
  "ok": true,
  "count": 20,
  "total": 50,
  "transactions": [
    {
      "id": 892595,
      "from": "khugepoopy",
      "to": "kqxhx5yn9v",
      "value": 7000,
      "time": "2018-12-29T13:02:05.000Z",
      "name": null,
      "metadata": "lignum@switchcraft.kst",
      "type": "transfer"
    },
    {
      "id": 1454706,
      "from": "k5cfswitch",
      "to": "khugepoopy",
      "value": 5050,
      "time": "2020-01-20T00:01:47.000Z",
      "name": null,
      "metadata": "",
      "type": "transfer"
    },
    ...
  ]
}
```

--------------------------------

### GET /names

Source: https://krist.dev/docs/index

Retrieves a list of names, optionally with pagination. This endpoint is useful for browsing available names or checking ownership.

```APIDOC
## GET /names

### Description
Retrieves a list of names, optionally with pagination. This endpoint is useful for browsing available names or checking ownership.

### Method
GET

### Endpoint
/names

### Query Parameters
- **limit** (Number) - Optional - The maximum amount of results to return. Must be between 1 and 1000. Default value: `50` Size range: `1-1000`
- **offset** (Number) - Optional - The amount to offset the results, useful to paginate results, and in conjunction with `limit`. Default value: `0`

### Response
#### Success Response (200)
- **count** (Number) - The count of results.
- **total** (Number) - The total amount of results.
- **names** (Object[]) - An array of name objects.
  - **name** (String) - The name, without the `.kst` suffix.
  - **owner** (String) - The address that currently owns this name.
  - **original_owner** (String) - Optional - The address that originally purchased this name.
  - **registered** (Date) - The time this name was registered, as an ISO-8601 string.
  - **updated** (Date) - The time this name was last updated - either the data changed, or it was transferred to a new owner, as an ISO-8601 string.
  - **transferred** (Date) - Optional - The time this name was last transferred to a new owner, as an ISO-8601 string.
  - **a** (String) - The name's data.
  - **unpaid** (Number) - Currently unused.

#### Response Example
```json
{
    "ok": true,
    "count": 50,
    "total": 570,
    "names": [
        {
            "name": "0",
            "owner": "kxxxxxxxxx",
            "original_owner": "kmr20h6bvb",
            "registered": "2015-05-10T20:56:37.000Z",
            "updated": "2020-01-04T05:07:45.000Z",
            "transferred": "2020-01-04T05:07:45.000Z",
            "a": null,
            "unpaid": 0
        }
    ]
}
```
```

--------------------------------

### GET /names/available

Source: https://krist.dev/docs/index

Checks if a specific name is available for registration. This endpoint helps users verify name availability before attempting to register.

```APIDOC
## GET /names/available

### Description
Checks if a specific name is available for registration. This endpoint helps users verify name availability before attempting to register.

### Method
GET

### Endpoint
/names/available

### Query Parameters
- **name** (String) - Required - The name to check the availability of, without the `.kst` suffix.

### Response
#### Success Response (200)
- **available** (Boolean) - Whether or not the name is available

#### Response Example
```json
{
    "ok": true,
    "available": true
}
```
```

--------------------------------

### Websockets | Get information about the user

Source: https://krist.dev/docs/index

Retrieves information about the currently authenticated user, including their guest status and address details if logged in.

```APIDOC
## POST /websites/krist_dev/websocket

### Description
Retrieves information about the currently authenticated user, including their guest status and address details if logged in.

### Method
POST

### Endpoint
/websites/krist_dev/websocket

### Parameters
#### Request Body
- **id** (Number) - Required - Unique identifier for the request.
- **type** (String) - Required - Must be `"me"`.

### Request Example
```json
{
  "id": 1,
  "type": "me"
}
```

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **id** (Number) - The request identifier.
- **isGuest** (Boolean) - True if the user is a guest, false otherwise.
- **address** (Object) - Address details (only present if `isGuest` is false).
  - **address** (String) - The user's Krist address.
  - **balance** (Number) - The user's current balance.
  - **totalin** (Number) - The total Krist received by the user's address.
  - **totalout** (Number) - The total Krist sent from the user's address.
  - **firstseen** (Date) - The date the address was first seen (ISO-8601 string).

### Response Example (Guest User)
```json
{
    "ok": true,
    "id": 1,
    "isGuest": true
}
```

### Response Example (Authenticated User)
```json
{
    "ok": true,
    "id": 1,
    "isGuest": false,
    "address": {
        "address": "knggsn1d2e",
        "balance": 0,
        "totalin": 0,
        "totalout": 0,
        "firstseen": "2016-06-17T21:09:28.000Z"
    }
}
```
```

--------------------------------

### Websocket Event Message Format

Source: https://krist.dev/docs/index

Example format for event messages received over a websocket connection. It includes an 'ok' status, message type 'event', the specific 'event' name, and the event data.

```json
{
    "ok": "true",
    "type": "event",
    "event": "transaction",
    "transaction": { ... }
  }
```

--------------------------------

### Get Name History by Name (Lookup API)

Source: https://krist.dev/docs/index

Fetches the transaction history for a given name, including name purchases, A record updates, and transfers. Supports ordering and pagination.

```javascript
fetch('/lookup/name_history/ahh11?orderBy=time&order=DESC&limit=10')
  .then(response => response.json())
  .then(data => console.log(data));
```

--------------------------------

### Get Names by Address (Lookup API)

Source: https://krist.dev/docs/index

Retrieves a list of names owned by specified addresses or the entire network if no addresses are provided. Supports filtering and pagination through query parameters.

```javascript
fetch('/lookup/names?addresses=khugepoopy,kreichdyes&orderBy=name&order=ASC&limit=10&offset=0')
  .then(response => response.json())
  .then(data => console.log(data));
```

--------------------------------

### POST /ws/start

Source: https://krist.dev/docs/index

Initiates a websocket connection. Returns a URL to connect to the websocket server. Supports both guest and authenticated sessions.

```APIDOC
## POST /ws/start

### Description
Initiates a websocket connection. Returns a URL to connect to the websocket server. Supports both guest and authenticated sessions.

### Method
POST

### Endpoint
/ws/start

### Parameters
#### Request Body
- **privatekey** (String) - Optional - The privatekey to authenticate with.

### Response
#### Success Response (200)
- **url** (String) - The address to connect to.
- **expires** (Number) - The time in seconds until the URL expires.

#### Response Example
```json
{
    "ok": true,
    "url": "wss://ws.krist.dev/ws/gateway/ba90ad70-cdfa-11e5-8cca-e1d2a26eabaf",
    "expires": 30
}
```

#### Error Response
- **Insufficient Funds**
```json
{
    "ok": false,
    "error": "insufficient_funds"
}
```
```

--------------------------------

### Initiate Websocket Connection (POST /ws/start)

Source: https://krist.dev/docs/index

Initiates a websocket connection by making a POST request to the /ws/start endpoint. The response contains a temporary URL for establishing the websocket connection and its expiration time.

```json
{
    "ok": true,
    "url": "wss://ws.krist.dev/ws/gateway/ba90ad70-cdfa-11e5-8cca-e1d2a26eabaf",
    "expires": 30
}
```

--------------------------------

### Websockets | Login to a wallet (upgrade connection)

Source: https://krist.dev/docs/index

Upgrades the websocket connection by logging into a wallet.

```APIDOC
## POST /websites/krist_dev/websocket

### Description
Upgrades the websocket connection by logging into a wallet.

### Method
POST

### Endpoint
/websites/krist_dev/websocket

### Parameters
#### Request Body
- **id** (Number) - Required - 
- **type** (String) - Required - Allowed values: "login"
- **privatekey** (String) - Required - 

### Response
#### Success Response (200)
- **isGuest** (Boolean) - Whether the current user is a guest or not
- **address** (Object) - 
  - **address** (String) - The address.
  - **balance** (Number) - The amount of Krist currently owned by this address.
  - **totalin** (Number) - The total amount of Krist that has ever gone into this address.
  - **totalout** (Number) - The total amount of Krist that has ever gone out of this address.
  - **firstseen** (Date) - The date this address was first seen (when the first transaction to it was made), as an ISO-8601 string.

### Response Example
{
    "ok": true,
    "isGuest": false,
    "address": {
        "address": "some_address",
        "balance": 100,
        "totalin": 200,
        "totalout": 100,
        "firstseen": "2023-01-01T10:00:00Z"
    }
}
```

--------------------------------

### Update Name Data - POST Request Example

Source: https://krist.dev/docs/index

Shows how to update the data associated with a name using a POST request to the Names API. You provide the name and the new data ('a' field), along with your private key. The success response confirms the update and returns the name's current details.

```javascript
fetch("/api/v2/names/update", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "example",
    a: "new_data_for_example",
    privatekey: "your_private_key"
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

--------------------------------

### GET /transactions/{id}

Source: https://krist.dev/docs/index

Retrieves details for a specific transaction by its ID.

```APIDOC
## GET /transactions/{id}

### Description
Retrieves details for a specific transaction by its ID.

### Method
GET

### Endpoint
/transactions/{id}

#### Path Parameters
- **id** (Number) - Required - The ID of the transaction to get.

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **transaction** (Object) - The transaction object.
  - **id** (Number) - The ID of this transaction.
  - **from** (String) - The sender of this transaction. This may be `null`.
  - **to** (String) - The recipient of this transaction. This may be `"name"` if the transaction was a name purchase, or `"a"` if it was a name's data change.
  - **value** (Number) - The amount of Krist transferred in this transaction. Can be `0`, notably if the transaction was a name's data change.
  - **time** (Date) - The time this transaction was made, as an ISO-8601 string.
  - **name** (String) - The name associated with this transaction, without the `.kst` suffix, or `null`.
  - **metadata** (String) - Transaction metadata, or `null`.
  - **sent_metaname** (String) - The metaname (part before the "@") of the recipient of this transaction, if it was sent to a name.
  - **sent_name** (String) - The name this transaction was sent to, without the `.kst` suffix, if it was sent to a name.
  - **type** (String) - The type of this transaction. May be `mined`, `transfer`, `name_purchase`, `name_a_record`, or `name_transfer`. Note that `name_a_record` refers to a name's data changing.

#### Response Example
```json
{
    "ok": true,
    "transaction": {
        "id": 153282,
        "from": "kh9w36ea1b",
        "to": "kutlg1kzhz",
        "value": 56610,
        "time": "2016-02-03T19:15:32.000Z",
        "name": null,
        "metadata": null,
        "sent_metaname": null,
        "sent_name": null,
        "type": "transfer"
    }
}
```
```

--------------------------------

### GET /websites/krist_dev/changes

Source: https://krist.dev/docs/index

Retrieves information about recent changes to the Krist project.

```APIDOC
## GET /websites/krist_dev/changes

### Description
Retrieves information about recent changes to the Krist project.

### Method
GET

### Endpoint
/websites/krist_dev/changes

### Parameters
#### Query Parameters
None

#### Request Body
None

### Response
#### Success Response (200)
(Response structure not detailed in the provided text, but typically includes a list of changes with version numbers, dates, and descriptions.)

#### Response Example
(Example response not provided in the input text.)
```

--------------------------------

### Websocket Login (Upgrade Connection)

Source: https://krist.dev/docs/index

Manages WebSocket login, upgrading the connection to a wallet. Requires 'id', 'type' ('login'), and 'privatekey'. The success response provides user session details including address, balance, and transaction history.

```json
{
    "id": 1,
    "type": "login",
    "privatekey": "your_private_key"
}
```

--------------------------------

### Websockets | Get the current subscription level

Source: https://krist.dev/docs/index

Retrieves the current subscription level for the user's connection.

```APIDOC
## POST /websites/krist_dev/websocket

### Description
Retrieves the current subscription level for the user's connection.

### Method
POST

### Endpoint
/websites/krist_dev/websocket

### Parameters
#### Request Body
- **id** (Number) - Required - Unique identifier for the request.
- **type** (String) - Required - Must be `"get_subscription_level"`.

### Request Example
```json
{
  "id": 1,
  "type": "get_subscription_level"
}
```

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **id** (Number) - The request identifier.
- **subscription_level** (String) - The current subscription level.

### Response Example
```json
{
    "ok": true,
    "id": 1,
    "subscription_level": "transactions"
}
```
```

--------------------------------

### POST /address

Source: https://krist.dev/docs/index

Converts a private key into a v2 address.

```APIDOC
## POST /address

### Description
Converts a private key into a v2 address.

### Method
POST

### Endpoint
/address

### Parameters
#### Request Body
- **privatekey** (String) - Required - The private key to turn into an address

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **address** (String) - The address derived from the private key.

#### Response Example
```json
{
    "ok": true,
    "address": "kre3w0i79j"
}
```
```

--------------------------------

### GET /transactions

Source: https://krist.dev/docs/index

Retrieves a list of recent transactions. Includes pagination details and a list of transaction objects.

```APIDOC
## GET /transactions

### Description
Retrieves a list of recent transactions. Includes pagination details and a list of transaction objects.

### Method
GET

### Endpoint
/transactions

### Query Parameters
- **page** (Number) - Optional - The page number to retrieve.
- **pageSize** (Number) - Optional - The number of transactions per page.

### Response
#### Success Response (200)
- **ok** (Boolean) - Indicates if the request was successful.
- **count** (Number) - The number of results on the current page.
- **total** (Number) - The total number of transactions available.
- **transactions** (Object[]) - An array of transaction objects.
  - **id** (Number) - The ID of this transaction.
  - **from** (String) - The sender of this transaction. This may be `null`.
  - **to** (String) - The recipient of this transaction. This may be `"name"` if the transaction was a name purchase, or `"a"` if it was a name's data change.
  - **value** (Number) - The amount of Krist transferred in this transaction. Can be `0`, notably if the transaction was a name's data change.
  - **time** (Date) - The time this transaction was made, as an ISO-8601 string.
  - **name** (String) - The name associated with this transaction, without the `.kst` suffix, or `null`.
  - **metadata** (String) - Transaction metadata, or `null`.
  - **sent_metaname** (String) - The metaname (part before the "@") of the recipient of this transaction, if it was sent to a name.
  - **sent_name** (String) - The name this transaction was sent to, without the `.kst` suffix, if it was sent to a name.
  - **type** (String) - The type of this transaction. May be `mined`, `transfer`, `name_purchase`, `name_a_record`, or `name_transfer`. Note that `name_a_record` refers to a name's data changing.

#### Response Example
```json
{
    "ok": true,
    "count": 50,
    "total": 175000,
    "transactions": [
        {
            "id": 153287,
            "from": null,
            "to": "kre3w0i79j",
            "value": 14,
            "time": "2016-02-06T19:22:41.000Z",
            "name": null,
            "metadata": null,
            "sent_metaname": null,
            "sent_name": null,
            "type": "mined"
        },
        {
            "id": 153286,
            "from": "kxxhsp1uzh",
            "to": "name",
            "value": 500,
            "time": "2016-02-06T14:01:19.000Z",
            "name": "exam",
            "metadata": null,
            "sent_metaname": null,
            "sent_name": null,
            "type": "name_purchase"
        }
    ]
}
```
```

--------------------------------

### Update Name Data - PUT Request Example

Source: https://krist.dev/docs/index

Illustrates updating a name's data using a PUT request to the Names API. Similar to the POST method, it requires the name and the new data ('a' field), authenticated with your private key. This method is suitable for idempotent updates.

```javascript
fetch("/api/v2/names/update", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "example",
    a: "updated_data_via_put",
    privatekey: "your_private_key"
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

--------------------------------

### GET /transactions/latest

Source: https://krist.dev/docs/index

Retrieves the latest transactions on the Krist network. This endpoint also supports filtering and pagination.

```APIDOC
## GET /transactions/latest

### Description
Retrieves the latest transactions on the Krist network. This endpoint also supports filtering and pagination.

### Method
GET

### Endpoint
/transactions/latest

### Parameters
#### Path Parameters
None

#### Query Parameters
- **excludeMined** (Boolean, optional) - If specified, transactions from mining will be excluded.
- **limit** (Number, optional) - The maximum amount of results to return. Must be between 1 and 1000. Default value: `50`.
- **offset** (Number, optional) - The amount to offset the results, useful to paginate results. Default value: `0`.

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **count** (Number) - The count of results.
- **total** (Number) - The total amount of transactions.
- **transactions** (Object[]) - An array of transaction objects.
  - **id** (Number) - The ID of this transaction.
  - **from** (String) - The sender of this transaction. This may be `null`.
  - **to** (String) - The recipient of this transaction. This may be `"name"` or `"a`.
  - **value** (Number) - The amount of Krist transferred in this transaction.
  - **time** (Date) - The time this transaction was made, as an ISO-8601 string.
  - **name** (String, optional) - The name associated with this transaction, without the `.kst` suffix, or `null`.
  - **metadata** (String, optional) - Transaction metadata, or `null`.
  - **sent_metaname** (String, optional) - The metaname of the recipient, if sent to a name.
  - **sent_name** (String, optional) - The name this transaction was sent to, without the `.kst` suffix, if sent to a name.
  - **type** (String) - The type of this transaction. May be `mined`, `transfer`, `name_purchase`, `name_a_record`, or `name_transfer`.

#### Response Example
```json
{
    "ok": true,
    "count": 50,
    "total": 175000,
    "transactions": [
        {
            "id": 1,
            "from": null,
            "to": "0000000000",
            "value": 50,
            "time": "2015-02-14T16:44:40.000Z",
            "name": null,
            "metadata": null,
            "sent_metaname": null,
            "sent_name": null,
            "type": "mined"
        },
        {
            "id": 46,
            "from": "71fd7571b9",
            "to": "a5dfb396d3",
            "value": 1000,
            "time": "2015-02-14T23:15:39.000Z",
            "name": null,
            "metadata": null,
            "sent_metaname": null,
            "sent_name": null,
            "type": "transfer"
        }
    ]
}
```
```
Tokens:
Raw