Date: 2026-08-23

Status: Current. The domain lives in `OpenAgents.Forum.Tips`; the browser

surface is `/forum/tips` and the tip buttons under each post.

surface is `/forum/tips`. The tip buttons under each post are commented out

in `OpenAgentsWeb.ForumTopicLive` until the payment service is enabled, so

every click stops answering "Tipping is not enabled here yet".

## What custody means here

  use OpenAgentsWeb, :live_view

  alias OpenAgents.Forum

  alias OpenAgents.Forum.Tips

  # Tipping is commented out until the payment service is enabled here.

  # alias OpenAgents.Forum.Tips

  alias OpenAgents.Markdown

  alias OpenAgentsWeb.LiveRefresh

  alias OpenAgentsWeb.OG

  # Preset amounts keep tipping one click. Larger amounts go through the API.

  @tip_amounts [100, 1_000]

  # @tip_amounts [100, 1_000]

  def mount(%{"id" => id}, _session, socket) do

    scope = [operator?: OpenAgents.Accounts.admin?(socket.assigns[:current_user])]

  # Tipping pays the author's own destination. A fresh idempotency key per

  # click means a double click cannot pay twice for the same request.

  def handle_event("tip", %{"id" => id, "amount" => amount}, socket) do

    with %{} = user <- current_user(socket),

         {sats, ""} <- Integer.parse(amount),

         post when not is_nil(post) <- Enum.find(socket.assigns.posts, &(&1.id == id)) do

      request = %{

        post: post,

        payer_user: user,

        payer_actor_ref: "user:#{user.id}",

        amount_sats: sats,

        idempotency_key: Ecto.UUID.generate()

      }

      case Tips.tip_post(request) do

        {:ok, intent} ->

          {:noreply, socket |> refresh_panel(:posts) |> put_flash(:info, tip_message(intent))}

        {:error, {:payment_failed, intent}} ->

          {:noreply,

           put_flash(socket, :error, "Payment failed: #{intent.failure_code}. Nothing was sent.")}

        {:error, reason} ->

          {:noreply, put_flash(socket, :error, tip_error(reason))}

      end

    else

      _unavailable -> {:noreply, put_flash(socket, :error, "Sign in to tip")}

    end

  end

  #

  # Commented out until the payment service is enabled here: with it disabled,

  # every click answered "Tipping is not enabled here yet".

  #

  # def handle_event("tip", %{"id" => id, "amount" => amount}, socket) do

  #   with %{} = user <- current_user(socket),

  #        {sats, ""} <- Integer.parse(amount),

  #        post when not is_nil(post) <- Enum.find(socket.assigns.posts, &(&1.id == id)) do

  #     request = %{

  #       post: post,

  #       payer_user: user,

  #       payer_actor_ref: "user:#{user.id}",

  #       amount_sats: sats,

  #       idempotency_key: Ecto.UUID.generate()

  #     }

  #

  #     case Tips.tip_post(request) do

  #       {:ok, intent} ->

  #         {:noreply, socket |> refresh_panel(:posts) |> put_flash(:info, tip_message(intent))}

  #

  #       {:error, {:payment_failed, intent}} ->

  #         {:noreply,

  #          put_flash(socket, :error, "Payment failed: #{intent.failure_code}. Nothing was sent.")}

  #

  #       {:error, reason} ->

  #         {:noreply, put_flash(socket, :error, tip_error(reason))}

  #     end

  #   else

  #     _unavailable -> {:noreply, put_flash(socket, :error, "Sign in to tip")}

  #   end

  # end

  def handle_event("toggle_closed", _params, socket) do

    with %{} = user <- current_user(socket),

        </.link>

        <span class="text-muted-foreground">/</span>

        <h1 class="text-2xl font-bold">{@topic.title}</h1>

        <%!-- Tipping is commented out until the payment service is enabled here.

        <.link navigate={~p"/forum/tips"} class="text-sm text-muted-foreground hover:text-foreground">

          Tips

        </.link>

        --%>

        <%= if @topic.state == "closed" do %>

          <span class="badge" data-variant="dim">closed</span>

        <% end %>

          <div class="prose prose-sm dark:prose-invert max-w-none">

            {Markdown.to_html(post.body_text)}

          </div>

          <%!-- Tipping is commented out until the payment service is enabled here.

          <footer :if={@current_user} class="flex items-center gap-2 mt-3">

            <span class="text-xs text-muted-foreground">Tip the author</span>

            <button

              {amount} sats

            </button>

          </footer>

          --%>

        </div>

      </div>

    end

  end

  defp tip_message(%{counted_sats: 0, exclusion_reason: reason, amount_sats: sats})

       when is_binary(reason) do

    "Sent #{sats} sats. This tip does not change ranking (#{String.replace(reason, "_", " ")})."

  end

  defp tip_message(%{amount_sats: sats}), do: "Sent #{sats} sats"

  defp tip_error(:tipping_disabled), do: "Tipping is not enabled here yet"

  defp tip_error(:no_destination), do: "This author has no tip destination yet"

  defp tip_error(:not_accepting_tips), do: "This author is not accepting tips"

  defp tip_error(:post_not_visible), do: "This post cannot be tipped"

  defp tip_error(:payment_service_unavailable),

    do: "The payment service is unavailable. Nothing was sent."

  defp tip_error(_reason), do: "That tip could not be sent"

  defp tip_amounts, do: @tip_amounts

  # Tipping helpers, commented out with the tip event above.

  #

  # defp tip_message(%{counted_sats: 0, exclusion_reason: reason, amount_sats: sats})

  #      when is_binary(reason) do

  #   "Sent #{sats} sats. This tip does not change ranking (#{String.replace(reason, "_", " ")})."

  # end

  #

  # defp tip_message(%{amount_sats: sats}), do: "Sent #{sats} sats"

  #

  # defp tip_error(:tipping_disabled), do: "Tipping is not enabled here yet"

  # defp tip_error(:no_destination), do: "This author has no tip destination yet"

  # defp tip_error(:not_accepting_tips), do: "This author is not accepting tips"

  # defp tip_error(:post_not_visible), do: "This post cannot be tipped"

  #

  # defp tip_error(:payment_service_unavailable),

  #   do: "The payment service is unavailable. Nothing was sent."

  #

  # defp tip_error(_reason), do: "That tip could not be sent"

  #

  # defp tip_amounts, do: @tip_amounts

end

    {Plug.Test.init_test_session(conn, %{"user_id" => user.id}), user}

  end

  defp author(forum, key) do

    {_conn, user} = sign_in(build_conn(), key)

    actor_ref = "agent:user_ed8297d8-1279-4b43-a1e7-f7867da19e20"

    {:ok, link} = Forum.start_actor_link(user, actor_ref)

    {:ok, _linked} = Forum.approve_actor_link(link)

    {:ok, destination} =

      Tips.register_destination(%{

        user_id: user.id,

        kind: "bolt12",

        destination: "lno1qsgliveauthor",

        label: "Phone wallet"

      })

    {:ok, topic} =

      Forum.create_topic(forum, %{

        title: "Hello world",

        slug: "hello-world",

        body_text: "First post body",

        idempotency_key: Ecto.UUID.generate(),

        actor_ref: actor_ref,

        actor_display_name: "Orrery",

        actor_slug: "orrery"

      })

    [post] = Forum.list_posts(topic)

    %{user: user, destination: destination, topic: topic, post: post}

  end

  # Used only by the commented-out thread tipping tests below.

  #

  # defp author(forum, key) do

  #   {_conn, user} = sign_in(build_conn(), key)

  #   actor_ref = "agent:user_ed8297d8-1279-4b43-a1e7-f7867da19e20"

  #

  #   {:ok, link} = Forum.start_actor_link(user, actor_ref)

  #   {:ok, _linked} = Forum.approve_actor_link(link)

  #

  #   {:ok, destination} =

  #     Tips.register_destination(%{

  #       user_id: user.id,

  #       kind: "bolt12",

  #       destination: "lno1qsgliveauthor",

  #       label: "Phone wallet"

  #     })

  #

  #   {:ok, topic} =

  #     Forum.create_topic(forum, %{

  #       title: "Hello world",

  #       slug: "hello-world",

  #       body_text: "First post body",

  #       idempotency_key: Ecto.UUID.generate(),

  #       actor_ref: actor_ref,

  #       actor_display_name: "Orrery",

  #       actor_slug: "orrery"

  #     })

  #

  #   [post] = Forum.list_posts(topic)

  #

  #   %{user: user, destination: destination, topic: topic, post: post}

  # end

  test "a signed-in reader saves a destination and sees only its fingerprint", %{conn: conn} do

    {conn, user} = sign_in(conn, "forum-tips-live-owner")

    assert Tips.active_destination(user.id).accepting_tips == false

  end

  test "tipping a post from the thread settles and shows the new total", %{

    conn: conn,

    forum: forum

  } do

    author = author(forum, "forum-tips-live-author")

    {conn, _payer} = sign_in(conn, "forum-tips-live-payer")

    {:ok, view, _html} = live(conn, ~p"/forum/t/#{author.topic.id}")

    html = render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

    assert html =~ "Sent 1000 sats"

    render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

    assert Repo.reload!(author.post).tip_sats_counted == 2_000

    assert render(view) =~ "2000 sats"

  end

  test "a thread never renders a payment destination", %{conn: conn, forum: forum} do

    author = author(forum, "forum-tips-live-privacy")

    {conn, _payer} = sign_in(conn, "forum-tips-live-privacy-payer")

    {:ok, view, _html} = live(conn, ~p"/forum/t/#{author.topic.id}")

    html = render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

    refute html =~ "lno1qsgliveauthor"

    refute html =~ author.destination.destination

  end

  test "a payment outage tells the payer nothing was sent", %{conn: conn, forum: forum} do

    author = author(forum, "forum-tips-live-outage")

    {conn, _payer} = sign_in(conn, "forum-tips-live-outage-payer")

    TipPaymentServiceStub.unavailable()

    {:ok, view, _html} = live(conn, ~p"/forum/t/#{author.topic.id}")

    html = render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

    assert html =~ "payment service is unavailable"

    assert Repo.reload!(author.post).tip_sats_total == 0

  end

  # Thread tipping is commented out in ForumTopicLive until the payment

  # service is enabled here, and these tests go with it. The API-side tip

  # tests in ForumTipsApiControllerTest still cover settlement itself.

  #

  # test "tipping a post from the thread settles and shows the new total", %{

  #   conn: conn,

  #   forum: forum

  # } do

  #   author = author(forum, "forum-tips-live-author")

  #   {conn, _payer} = sign_in(conn, "forum-tips-live-payer")

  #

  #   {:ok, view, _html} = live(conn, ~p"/forum/t/#{author.topic.id}")

  #

  #   html = render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

  #

  #   assert html =~ "Sent 1000 sats"

  #

  #   render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

  #

  #   assert Repo.reload!(author.post).tip_sats_counted == 2_000

  #   assert render(view) =~ "2000 sats"

  # end

  #

  # test "a thread never renders a payment destination", %{conn: conn, forum: forum} do

  #   author = author(forum, "forum-tips-live-privacy")

  #   {conn, _payer} = sign_in(conn, "forum-tips-live-privacy-payer")

  #

  #   {:ok, view, _html} = live(conn, ~p"/forum/t/#{author.topic.id}")

  #

  #   html = render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

  #

  #   refute html =~ "lno1qsgliveauthor"

  #   refute html =~ author.destination.destination

  # end

  #

  # test "a payment outage tells the payer nothing was sent", %{conn: conn, forum: forum} do

  #   author = author(forum, "forum-tips-live-outage")

  #   {conn, _payer} = sign_in(conn, "forum-tips-live-outage-payer")

  #   TipPaymentServiceStub.unavailable()

  #

  #   {:ok, view, _html} = live(conn, ~p"/forum/t/#{author.topic.id}")

  #

  #   html = render_click(view, "tip", %{"id" => author.post.id, "amount" => "1000"})

  #

  #   assert html =~ "payment service is unavailable"

  #   assert Repo.reload!(author.post).tip_sats_total == 0

  # end

end