Reserved funds

import { listReservedSpends } from "@umbra/nimbus-solana-web";

const held = await listReservedSpends(session, {});

for (const spend of held) {
  console.log(spend.kind, spend.amount, spend.state, spend.running);
}

import { releaseReservedNotes } from "@umbra/nimbus-solana-web";

const one = await releaseReservedNotes(session, {}, { spendId });
const everything = await releaseReservedNotes(session, {});

console.log(everything.released.length, everything.settling.length);

import { releaseReservedNotes } from "@umbra/nimbus-solana-web";
import type {
  ReservedSpend,
  ReservedSpendState,
} from "@umbra/nimbus-solana-web";
import { useState } from "react";

const STATE_TEXT: Record<ReservedSpendState, string> = {
  unsent: "Stopped before it was sent. Release returns it now.",
  sent: "May have been sent. Releasing stops new attempts.",
  releasing: "Released. It returns once the sent attempt settles.",
};

export function HeldPayment({ spend }: { spend: ReservedSpend }) {
  const [message, setMessage] = useState("");

  async function release(): Promise<void> {
    const result = await releaseReservedNotes(
      session,
      {},
      { spendId: spend.id },
    );
    if (result.released.length > 0) {
      setMessage("Released. The funds are available again.");
    } else if (result.settling.length > 0) {
      setMessage("It may still land. The funds return once it settles.");
    } else if (result.running.length > 0) {
      setMessage("Another tab is still running it.");
    }
    await refreshBalances();
  }

  if (spend.running) {
    return <p>Still running in another tab. It frees when that tab finishes.</p>;
  }

  return (
    <div>
      <p>{STATE_TEXT[spend.state]}</p>
      {spend.state === "releasing" ? null : (
        <button type="button" onClick={() => void release()}>
          Release
        </button>
      )}
      <p role="status">{message}</p>
    </div>
  );
}