Function addpeeraddress

src/rpc/net.cpp:984–1042

}

static RPCMethod addpeeraddress()
{
    return RPCMethod{"addpeeraddress",
        "Add the address of a potential peer to an address manager table. This RPC is for testing only.",
        {
            {"address", RPCArg::Type::STR, RPCArg::Optional::NO, "The IP address of the peer"},
            {"port", RPCArg::Type::NUM, RPCArg::Optional::NO, "The port of the peer"},
            {"tried", RPCArg::Type::BOOL, RPCArg::Default{false}, "If true, attempt to add the peer to the tried addresses table"},
        },
        RPCResult{
            RPCResult::Type::OBJ, "", "",
            {
                {RPCResult::Type::BOOL, "success", "whether the peer address was successfully added to the address manager table"},
                {RPCResult::Type::STR, "error", /*optional=*/true, "error description, if the address could not be added"},
            },
        },
        RPCExamples{
            HelpExampleCli("addpeeraddress", "\"1.2.3.4\" 8333 true")
    + HelpExampleRpc("addpeeraddress", "\"1.2.3.4\", 8333, true")
        },
        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
{
    AddrMan& addrman = EnsureAnyAddrman(request.context);

    const std::string& addr_string{request.params[0].get_str()};
    const auto port{request.params[1].getInt<uint16_t>()};
    const bool tried{request.params[2].isNull() ? false : request.params[2].get_bool()};

    UniValue obj(UniValue::VOBJ);
    std::optional<CNetAddr> net_addr{LookupHost(addr_string, false)};
    if (!net_addr.has_value()) {
        throw JSONRPCError(RPC_CLIENT_INVALID_IP_OR_SUBNET, "Invalid IP address");
    }

    bool success{false};

    CService service{net_addr.value(), port};
    CAddress address{MaybeFlipIPv6toCJDNS(service), ServiceFlags{NODE_NETWORK | NODE_WITNESS}};
    address.nTime = Now<NodeSeconds>();
    // The source address is set equal to the address. This is equivalent to the peer
    // announcing itself.
    if (addrman.Add({address}, address)) {
        success = true;
        if (tried) {
            // Attempt to move the address to the tried addresses table.
            if (!addrman.Good(address)) {
                success = false;
                obj.pushKV("error", "failed-adding-to-tried");
            }
        }
    } else {
        obj.pushKV("error", "failed-adding-to-new");
    }

    obj.pushKV("success", success);
    return obj;
},
    };