// Copyright (c) 2015-present The Bitcoin Core developers

// Distributed under the MIT software license, see the accompanying

// file COPYING or http://www.opensource.org/licenses/mit-license.php.

#include <httprpc.h>

#include <common/args.h>

#include <crypto/hmac_sha256.h>

#include <httpserver.h>

#include <netaddress.h>

#include <rpc/protocol.h>

#include <rpc/server.h>

#include <util/fs.h>

#include <util/fs_helpers.h>

#include <util/log.h>

#include <util/strencodings.h>

#include <util/string.h>

#include <walletinitinterface.h>

#include <algorithm>

#include <iterator>

#include <map>

#include <memory>

#include <optional>

#include <set>

#include <string>

#include <vector>

using util::SplitString;

using util::TrimStringView;

/** WWW-Authenticate to present with 401 Unauthorized response */

static const char* WWW_AUTH_HEADER_DATA = "Basic realm=\"jsonrpc\"";

/* List of -rpcauth values */

static std::vector<std::vector<std::string>> g_rpcauth;

/* RPC Auth Whitelist */

static std::map<std::string, std::set<std::string>> g_rpc_whitelist;

static bool g_rpc_whitelist_default = false;

static UniValue JSONErrorReply(UniValue objError, const JSONRPCRequest& jreq, HTTPStatusCode& nStatus)

{

    // HTTP errors should never be returned if JSON-RPC v2 was requested. This

    // function should only be called when a v1 request fails or when a request

    // cannot be parsed, so the version is unknown.

    Assume(jreq.m_json_version != JSONRPCVersion::V2);

    // Send error reply from json-rpc error object

    nStatus = HTTP_INTERNAL_SERVER_ERROR;

    int code = objError.find_value("code").getInt<int>();

    if (code == RPC_INVALID_REQUEST)

        nStatus = HTTP_BAD_REQUEST;

    else if (code == RPC_METHOD_NOT_FOUND)

        nStatus = HTTP_NOT_FOUND;

    return JSONRPCReplyObj(NullUniValue, std::move(objError), jreq.id, jreq.m_json_version);

}

//This function checks username and password against -rpcauth

//entries from config file.

static bool CheckUserAuthorized(std::string_view user, std::string_view pass)

{

    for (const auto& fields : g_rpcauth) {

        if (!TimingResistantEqual(std::string_view(fields[0]), user)) {

            continue;

        }

        const std::string& salt = fields[1];

        const std::string& hash = fields[2];

        std::array<unsigned char, CHMAC_SHA256::OUTPUT_SIZE> out;

        CHMAC_SHA256(UCharCast(salt.data()), salt.size()).Write(UCharCast(pass.data()), pass.size()).Finalize(out.data());

        std::string hash_from_pass = HexStr(out);

        if (TimingResistantEqual(hash_from_pass, hash)) {

            return true;

        }

    }

    return false;

}

static bool RPCAuthorized(const std::string& strAuth, std::string& strAuthUsernameOut)

{

    if (!strAuth.starts_with("Basic "))

        return false;

    std::string_view strUserPass64 = TrimStringView(std::string_view{strAuth}.substr(6));

    auto userpass_data = DecodeBase64(strUserPass64);

    std::string strUserPass;

    if (!userpass_data) return false;

    strUserPass.assign(userpass_data->begin(), userpass_data->end());

    size_t colon_pos = strUserPass.find(':');

    if (colon_pos == std::string::npos) {

        return false; // Invalid basic auth.

    }

    std::string user = strUserPass.substr(0, colon_pos);

    std::string pass = strUserPass.substr(colon_pos + 1);

    strAuthUsernameOut = user;

    return CheckUserAuthorized(user, pass);

}

UniValue ExecuteHTTPRPC(const UniValue& valRequest, JSONRPCRequest& jreq, HTTPStatusCode& status)

{

    status = HTTP_OK;

    try {

        bool user_has_whitelist = g_rpc_whitelist.contains(jreq.authUser);

        if (!user_has_whitelist && g_rpc_whitelist_default) {

            LogWarning("RPC User %s not allowed to call any methods", jreq.authUser);

            status = HTTP_FORBIDDEN;

            return {};

        // singleton request

        } else if (valRequest.isObject()) {

            jreq.parse(valRequest);

            if (user_has_whitelist && !g_rpc_whitelist[jreq.authUser].contains(jreq.strMethod)) {

                LogWarning("RPC User %s not allowed to call method %s", jreq.authUser, jreq.strMethod);

                status = HTTP_FORBIDDEN;

                return {};

            }

            // Legacy 1.0/1.1 behavior is for failed requests to throw

            // exceptions which return HTTP errors and RPC errors to the client.

            // 2.0 behavior is to catch exceptions and return HTTP success with

            // RPC errors, as long as there is not an actual HTTP server error.

            const bool catch_errors{jreq.m_json_version == JSONRPCVersion::V2};

            UniValue reply{JSONRPCExec(jreq, catch_errors)};

            if (jreq.IsNotification()) {

                // Even though we do execute notifications, we do not respond to them

                status = HTTP_NO_CONTENT;

                return {};

            }

            return reply;

        // array of requests

        } else if (valRequest.isArray()) {

            // Check authorization for each request's method

            if (user_has_whitelist) {

                for (unsigned int reqIdx = 0; reqIdx < valRequest.size(); reqIdx++) {

                    if (!valRequest[reqIdx].isObject()) {

                        throw JSONRPCError(RPC_INVALID_REQUEST, "Invalid Request object");

                    } else {

                        const UniValue& request = valRequest[reqIdx].get_obj();

                        // Parse method

                        std::string strMethod = request.find_value("method").get_str();

                        if (!g_rpc_whitelist[jreq.authUser].contains(strMethod)) {

                            LogWarning("RPC User %s not allowed to call method %s", jreq.authUser, strMethod);

                            status = HTTP_FORBIDDEN;

                            return {};

                        }

                    }

                }

            }

            // Execute each request

            UniValue reply = UniValue::VARR;

            for (size_t i{0}; i < valRequest.size(); ++i) {

                // Batches never throw HTTP errors, they are always just included

                // in "HTTP OK" responses. Notifications never get any response.

                UniValue response;

                try {

                    jreq.parse(valRequest[i]);

                    response = JSONRPCExec(jreq, /*catch_errors=*/true);

                } catch (UniValue& e) {

                    response = JSONRPCReplyObj(NullUniValue, std::move(e), jreq.id, jreq.m_json_version);

                } catch (const std::exception& e) {

                    response = JSONRPCReplyObj(NullUniValue, JSONRPCError(RPC_PARSE_ERROR, e.what()), jreq.id, jreq.m_json_version);

                }

                if (!jreq.IsNotification()) {

                    reply.push_back(std::move(response));

                }

            }

            // Return no response for an all-notification batch, but only if the

            // batch request is non-empty. Technically according to the JSON-RPC

            // 2.0 spec, an empty batch request should also return no response,

            // However, if the batch request is empty, it means the request did

            // not contain any JSON-RPC version numbers, so returning an empty

            // response could break backwards compatibility with old RPC clients

            // relying on previous behavior. Return an empty array instead of an

            // empty response in this case to favor being backwards compatible

            // over complying with the JSON-RPC 2.0 spec in this case.

            if (reply.size() == 0 && valRequest.size() > 0) {

                status = HTTP_NO_CONTENT;

                return {};

            }

            return reply;

        }

        else

            throw JSONRPCError(RPC_PARSE_ERROR, "Top-level object parse error");

    } catch (UniValue& e) {

        return JSONErrorReply(std::move(e), jreq, status);

    } catch (const std::exception& e) {

        return JSONErrorReply(JSONRPCError(RPC_PARSE_ERROR, e.what()), jreq, status);

    }

}

static void HTTPReq_JSONRPC(const std::any& context, HTTPRequest* req)

{

    // JSONRPC handles only POST

    if (req->GetRequestMethod() != HTTPRequestMethod::POST) {

        req->WriteReply(HTTP_BAD_METHOD, "JSONRPC server handles only POST requests");

        return;

    }

    // Check authorization

    std::optional<std::string> auth_header = req->GetHeader("authorization");

    if (!auth_header) {

        req->WriteHeader("WWW-Authenticate", WWW_AUTH_HEADER_DATA);

        req->WriteReply(HTTP_UNAUTHORIZED);

        return;

    }

    JSONRPCRequest jreq;

    jreq.context = context;

    jreq.peerAddr = req->GetPeer().ToStringAddrPort();

    jreq.URI = req->GetURI();

    if (!RPCAuthorized(*auth_header, jreq.authUser)) {

        LogWarning("ThreadRPCServer incorrect password attempt from %s", jreq.peerAddr);

        /* Deter brute-forcing

           If this results in a DoS the user really

           shouldn't have their RPC port exposed. */

        UninterruptibleSleep(std::chrono::milliseconds{250});

        req->WriteHeader("WWW-Authenticate", WWW_AUTH_HEADER_DATA);

        req->WriteReply(HTTP_UNAUTHORIZED);

        return;

    }

    // Generate reply

    HTTPStatusCode status;

    UniValue reply;

    UniValue request;

    if (request.read(req->ReadBody())) {

        reply = ExecuteHTTPRPC(request, jreq, status);

    } else {

        reply = JSONErrorReply(JSONRPCError(RPC_PARSE_ERROR, "Parse error"), jreq, status);

    }

    // Write reply

    if (reply.isNull()) {

        // Error case or no-content notification reply.

        req->WriteReply(status);

    } else {

        req->WriteHeader("Content-Type", "application/json");

        req->WriteReply(status, reply.write() + "\n");

    }

}

static bool InitRPCAuthentication()

{

    std::string user;

    std::string pass;

    if (gArgs.GetArg("-rpcpassword", "") == "")

    {

        std::optional<fs::perms> cookie_perms{std::nullopt};

        auto cookie_perms_arg{gArgs.GetArg("-rpccookieperms")};

        if (cookie_perms_arg) {

            auto perm_opt = InterpretPermString(*cookie_perms_arg);

            if (!perm_opt) {

                LogError("Invalid -rpccookieperms=%s; must be one of 'owner', 'group', or 'all'.", *cookie_perms_arg);

                return false;

            }

            cookie_perms = *perm_opt;

        }

        switch (GenerateAuthCookie(cookie_perms, user, pass)) {

        case AuthCookieResult::Error:

            return false;

        case AuthCookieResult::Disabled:

            LogInfo("RPC authentication cookie file generation is disabled.");

            break;

        case AuthCookieResult::Ok:

            LogInfo("Using random cookie authentication.");

            break;

        }

    } else {

        LogInfo("Using rpcuser/rpcpassword authentication.");

        LogWarning("The use of rpcuser/rpcpassword is less secure, because credentials are configured in plain text. It is recommended that locally-run instances switch to cookie-based auth, or otherwise to use hashed rpcauth credentials. See share/rpcauth in the source directory for more information.");

        user = gArgs.GetArg("-rpcuser", "");

        pass = gArgs.GetArg("-rpcpassword", "");

    }

    // If there is a plaintext credential, hash it with a random salt before storage.

    if (!user.empty() || !pass.empty()) {

        // Generate a random 16 byte hex salt.

        std::array<unsigned char, 16> raw_salt;

        GetStrongRandBytes(raw_salt);

        std::string salt = HexStr(raw_salt);

        // Compute HMAC.

        std::array<unsigned char, CHMAC_SHA256::OUTPUT_SIZE> out;

        CHMAC_SHA256(UCharCast(salt.data()), salt.size()).Write(UCharCast(pass.data()), pass.size()).Finalize(out.data());

        std::string hash = HexStr(out);

        g_rpcauth.push_back({user, salt, hash});

    }

    if (!gArgs.GetArgs("-rpcauth").empty()) {

        LogInfo("Using rpcauth authentication.\n");

        for (const std::string& rpcauth : gArgs.GetArgs("-rpcauth")) {

            std::vector<std::string> fields{SplitString(rpcauth, ':')};

            const std::vector<std::string> salt_hmac{SplitString(fields.back(), '$')};

            if (fields.size() == 2 && salt_hmac.size() == 2) {

                fields.pop_back();

                fields.insert(fields.end(), salt_hmac.begin(), salt_hmac.end());

                g_rpcauth.push_back(fields);

            } else {

                LogWarning("Invalid -rpcauth argument.");

                return false;

            }

        }

    }

    g_rpc_whitelist_default = gArgs.GetBoolArg("-rpcwhitelistdefault", !gArgs.GetArgs("-rpcwhitelist").empty());

    for (const std::string& strRPCWhitelist : gArgs.GetArgs("-rpcwhitelist")) {

        auto pos = strRPCWhitelist.find(':');

        std::string strUser = strRPCWhitelist.substr(0, pos);

        bool intersect = g_rpc_whitelist.contains(strUser);

        std::set<std::string>& whitelist = g_rpc_whitelist[strUser];

        if (pos != std::string::npos) {

            std::string strWhitelist = strRPCWhitelist.substr(pos + 1);

            std::vector<std::string> whitelist_split = SplitString(strWhitelist, ", ");

            std::set<std::string> new_whitelist{

                std::make_move_iterator(whitelist_split.begin()),

                std::make_move_iterator(whitelist_split.end())};

            if (intersect) {

                std::set<std::string> tmp_whitelist;

                std::set_intersection(new_whitelist.begin(), new_whitelist.end(),

                       whitelist.begin(), whitelist.end(), std::inserter(tmp_whitelist, tmp_whitelist.end()));

                new_whitelist = std::move(tmp_whitelist);

            }

            whitelist = std::move(new_whitelist);

        }

    }

    return true;

}

bool StartHTTPRPC(const std::any& context)

{

    LogDebug(BCLog::RPC, "Starting HTTP RPC server\n");

    if (!InitRPCAuthentication())

        return false;

    auto handle_rpc = [context](HTTPRequest* req, const std::string&) { return HTTPReq_JSONRPC(context, req); };

    RegisterHTTPHandler("/", true, handle_rpc);

    if (g_wallet_init_interface.HasWalletSupport()) {

        RegisterHTTPHandler("/wallet/", false, handle_rpc);

    }

    return true;

}

void InterruptHTTPRPC()

{

    LogDebug(BCLog::RPC, "Interrupting HTTP RPC server\n");

}

void StopHTTPRPC()

{

    LogDebug(BCLog::RPC, "Stopping HTTP RPC server\n");

    UnregisterHTTPHandler("/", true);

    if (g_wallet_init_interface.HasWalletSupport()) {

        UnregisterHTTPHandler("/wallet/", false);

    }

}