bitburner-src/doc/source/remoteapi.rst

Remote API
==========

All versions of Bitburner can use websockets to connect to a server.
That server can then perform a number of actions.
Most commonly this is used in conjunction with an external text editor or API
in order to make writing scripts easier, or even use typescript.

This API uses the JSON RCP 2.0 protocol. Inputs are in the following form:

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": string,
            "params": any
        }

Outputs:

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": any,
            "error": any
        }


Methods
-------

`pushFile`
^^^^^^^^^^
    Create or update a file.

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": "pushFile",
            "params": {
                filename: string;
                content: string;
                server: string;
            }
        }

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": "OK"
        }

`getFile`
^^^^^^^^^
    Read a file and it's content.

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": "getFile",
            "params": {
                filename: string;
                server: string;
            }
        }

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": string
        }

`deleteFile`
^^^^^^^^^^^^
    Delete a file.

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": "deleteFile",
            "params": {
                filename: string;
                server: string;
            }
        }

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": "OK"
        }

`getFileNames`
^^^^^^^^^^^^^^
    List all file names on a server.

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": "getFileNames",
            "params": {
                server: string;
            }
        }

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": string[]
        }

`getAllFiles`
^^^^^^^^^^^^^
    Get the content of all files on a server.

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": "getAllFiles",
            "params": {
                server: string;
            }
        }

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": {
                filename: string,
                content: string
            }[]
        }

`calculateRam`
^^^^^^^^^^^^^^
    Calculate the in-game ram cost of a script.

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": "calculateRam",
            "params": {
                filename: string;
                server: string;
            }
        }

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": number
        }


`getDefinitionFile`
^^^^^^^^^^^^^^^^^^^
    Get the definition file of the API.

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "method": "getDefinitionFile"
        }

    .. code-block:: javascript

        {
            "jsonrpc": "2.0",
            "id": number,
            "result": string
        }