@voltro/plugin-economy 0.0.0-stage → 0.88.0

package/dist/walletEscrow.server.js

@@ -0,0 +1,375 @@
+import { EconomyError as e, economyError as t } from "./errors.js";
+import { dataObject as n, identifier as r } from "./capture.js";
+import { positiveAmount as i } from "./amount.js";
+import { walletHash as a, walletKey as o } from "./walletKeys.server.js";
+import { economyAccountKey as s } from "./ledger.js";
+import { economySubjectsTable as c, economyTransactionsTable as l } from "./tables.entity.js";
+import { captureWalletEscrowInput as u, captureWalletEscrowReserveInput as d, captureWalletEscrowReserveTaxSettleInput as f, captureWalletEscrowSettleInput as p, captureWalletEscrowTaxSettleInput as m } from "./walletEscrow.js";
+import { Effect as h, Result as g } from "effect";
+import { eq as _, queryFor as v } from "@voltro/database";
+import { prepareSqlMutation as y, prepareSqlMutationGroup as b } from "@voltro/database/sql";
+// src/walletEscrow.server.ts
+var x = (x, S) => {
+	let C = new Set(S.allowedServices), w = (n) => h.tryPromise({
+		try: n,
+		catch: (n) => n instanceof e ? n : t("unavailable")
+	}), T = (n) => {
+		try {
+			return n();
+		} catch (n) {
+			return h.fail(n instanceof e ? n : t("invalid_input"));
+		}
+	}, E = (e) => {
+		if (e.type !== "system" && !(e.type === "service" && C.has(e.service))) throw t("forbidden");
+	}, D = (e, t = e.owner) => o("ecs_", e.tenantId, s(t)), O = (e, t) => o("ecq_", t, e.tenantId, D(e), e.reservationId, e.currency), k = (e, t) => o("ect_", e.tenantId, O(e, t)), A = (e) => o("escrow.", e.tenantId, D(e), e.reservationId, e.currency), j = (e, t) => e.tenantId === t.tenantId && e.reservationId === t.reservationId && e.currency === t.currency && s(e.owner) === s(t.owner), M = async (e, n) => {
+		let r = (await e.query(v(c).where(_("id", D(n))).limit(1).descriptor))[0];
+		if (r) {
+			if (r.tenantId !== n.tenantId || r.ownerKind !== n.owner.ownerKind) throw t("invalid_record");
+			if (r.erased === !0) throw t("erased");
+			if (r.erased !== !1 || r.ownerId !== n.owner.ownerId) throw t("invalid_record");
+		}
+	}, N = (e) => {
+		let a = n(e.escrow, ["intent", "close"], "invalid_record"), o = d(a.intent);
+		if (e.tenantId !== o.tenantId || e.id !== k(o, "reserve") || e.state !== "committed") throw t("invalid_record");
+		let s = null;
+		if (a.close !== null) {
+			let c = n(a.close, [
+				"mode",
+				"targetKey",
+				"receipt",
+				"tax"
+			], "invalid_record"), l = r(c.targetKey);
+			if (c.mode !== "release" && c.mode !== "settle" || !/^ecs_[a-f0-9]{56}$/.test(l) || c.mode === "release" != (l === D(o))) throw t("invalid_record");
+			let u = null;
+			if (c.tax !== null) {
+				let a = n(c.tax, [
+					"amount",
+					"account",
+					"receipt"
+				], "invalid_record"), s = i(a.amount).toString(), l = r(a.account);
+				if (c.mode !== "settle" || !l.startsWith("escrow.tax.") || BigInt(s) > BigInt(String(o.amount))) throw t("invalid_record");
+				let d = S.decodeReceipt({
+					id: k(o, "tax"),
+					createdAt: e.createdAt,
+					receipt: n(a.receipt, [
+						"txId",
+						"currency",
+						"amount",
+						"at"
+					], "invalid_record")
+				});
+				if (d.currency !== o.currency || d.amount !== s) throw t("invalid_record");
+				u = Object.freeze({
+					amount: s,
+					account: l,
+					receipt: d
+				});
+			}
+			let d = BigInt(String(o.amount)) - BigInt(u?.amount ?? "0"), f = c.receipt === null ? null : S.decodeReceipt({
+				id: k(o, "close"),
+				createdAt: e.createdAt,
+				receipt: n(c.receipt, [
+					"txId",
+					"currency",
+					"amount",
+					"at"
+				], "invalid_record")
+			});
+			if (d === 0n ? f !== null : !f || f.currency !== o.currency || f.amount !== d.toString()) throw t("invalid_record");
+			s = Object.freeze({
+				mode: c.mode,
+				targetKey: l,
+				receipt: f,
+				tax: u
+			});
+		}
+		return Object.freeze({
+			intent: Object.freeze({
+				...o,
+				amount: i(o.amount).toString()
+			}),
+			close: s
+		});
+	}, P = async (e, n, i, c, l, u, d) => {
+		let f = k(n, i), p = (await S.readEvidence(e, n.tenantId, [f], n.currency)).get(f);
+		if (!p || l.txId !== f || l.currency !== n.currency || l.amount !== c) throw t("invalid_record");
+		let m = p.pair.find((e) => BigInt(String(e.debit)) > 0n), h = p.pair.find((e) => BigInt(String(e.credit)) > 0n);
+		if (!m || !h || String(m.debit) !== c || String(h.credit) !== c || S.ledgerAt(m.at) !== l.at || S.ledgerAt(h.at) !== l.at) throw t("invalid_record");
+		let g = i === "reserve" ? h : m, _ = i === "reserve" ? m : h;
+		if (g.accountKind !== "system" || g.systemAccount !== A(n) || _.accountKind !== "wallet" || g.reason !== (i === "reserve" ? "escrow.reserve" : d === "release" ? "escrow.release" : "escrow.settle")) throw t("invalid_record");
+		if (p.receipt.state === "committed") {
+			if (g.refKind !== "economy.escrow" || g.refId !== n.reservationId) throw t("invalid_record");
+			let e = S.decodeReceipt(p.receipt);
+			if (a(e) !== a(l) || _.ownerKind !== "player" && _.ownerKind !== "guild" || o("ecs_", n.tenantId, s({
+				kind: "wallet",
+				ownerKind: _.ownerKind,
+				ownerId: r(_.ownerId)
+			})) !== (i === "reserve" ? D(n) : u)) throw t("invalid_record");
+		} else if (i === "reserve") throw t("erased");
+	}, F = async (e, n, r) => {
+		let i = (await S.readEvidence(e, n.tenantId, [k(n, "tax")], n.currency)).get(k(n, "tax"));
+		if (!i || r.receipt.txId !== k(n, "tax") || r.receipt.currency !== n.currency || r.receipt.amount !== r.amount) throw t("invalid_record");
+		let o = i.pair.find((e) => BigInt(String(e.debit)) > 0n), s = i.pair.find((e) => BigInt(String(e.credit)) > 0n);
+		if (!o || !s || o.accountKind !== "system" || s.accountKind !== "system" || o.systemAccount !== A(n) || s.systemAccount !== r.account || String(o.debit) !== r.amount || String(s.credit) !== r.amount || o.reason !== "escrow.tax" || S.ledgerAt(o.at) !== r.receipt.at || S.ledgerAt(s.at) !== r.receipt.at || i.receipt.state === "committed" && (a(S.decodeReceipt(i.receipt)) !== a(r.receipt) || o.refKind !== "economy.escrow" || o.refId !== n.reservationId)) throw t("invalid_record");
+	}, I = async (e, n, r) => {
+		if (!r.close) throw t("invalid_record");
+		if (r.close.receipt) await P(e, n, "close", r.close.receipt.amount, r.close.receipt, r.close.targetKey, r.close.mode);
+		else {
+			let r = (await e.query(v(l).where(_("id", k(n, "close"))).limit(1).descriptor))[0];
+			if (r && (r.tenantId !== n.tenantId || r.state !== "pending" || r.receipt !== null || r.digest !== null || r.escrow !== null)) throw t("invalid_record");
+		}
+		if (r.close.tax) await F(e, n, r.close.tax);
+		else {
+			let r = (await e.query(v(l).where(_("id", k(n, "tax"))).limit(1).descriptor))[0];
+			if (r && (r.tenantId !== n.tenantId || r.state !== "pending" || r.receipt !== null || r.digest !== null || r.escrow !== null)) throw t("invalid_record");
+		}
+	}, L = (e, n) => {
+		if (!n.close) throw t("invalid_record");
+		let r = n.intent.amount, i = n.close.tax?.amount ?? "0";
+		return Object.freeze({
+			reservationId: e.reservationId,
+			currency: e.currency,
+			gross: r,
+			net: (BigInt(r) - BigInt(i)).toString(),
+			tax: i,
+			payout: n.close.receipt,
+			taxReceipt: n.close.tax?.receipt ?? null
+		});
+	}, R = async (e, n) => {
+		await M(e, n);
+		let r = (await e.query(v(l).where(_("id", k(n, "reserve"))).limit(1).descriptor))[0];
+		if (!r) return;
+		if (r.tenantId !== n.tenantId) throw t("invalid_record");
+		if (r.state === "pending") {
+			if (r.escrow !== null || r.digest !== null || r.receipt !== null) throw t("invalid_record");
+			return;
+		}
+		if (r.state === "erased") throw t("erased");
+		if (r.escrow === null) throw t("invalid_record");
+		let i = N(r), a = S.decodeReceipt(r);
+		if (!j(n, i.intent) || a.amount !== i.intent.amount || a.currency !== n.currency) throw t("invalid_record");
+		if (await P(e, n, "reserve", i.intent.amount, a), i.close) await I(e, n, i);
+		else for (let r of ["close", "tax"]) {
+			let i = (await e.query(v(l).where(_("id", k(n, r))).limit(1).descriptor))[0];
+			if (i && (i.tenantId !== n.tenantId || i.state !== "pending" || i.escrow !== null || i.digest !== null || i.receipt !== null)) throw t("invalid_record");
+		}
+		return {
+			body: i,
+			receipt: a
+		};
+	}, z = async (e, n, r) => {
+		let i = r && s(r) !== s(n.owner) ? [n.owner, r] : [n.owner];
+		for (let t of i.sort((e, t) => D(n, e) < D(n, t) ? -1 : 1)) await S.fenceWallet(e, n.tenantId, t);
+		if (await S.fenceCurrency(e, n.tenantId, n.currency), await e.updateMany(l.tableName, { admission: 0 }, { where: _("id", k(n, "reserve")) }) !== 1) throw t("not_found");
+	}, B = (e, n) => T(() => {
+		let r = structuredClone(e), i = d(n);
+		return E(r), w(async () => {
+			let e = await x.transactional((e) => R(e, i));
+			if (e) {
+				if (e.body.intent.amount !== String(i.amount)) throw t("conflict");
+				return y(x, async (e) => {
+					await z(e, i);
+					let n = await R(e, i);
+					if (!n || n.body.intent.amount !== String(i.amount)) throw t("conflict");
+					return n.receipt;
+				});
+			}
+			let n = await h.runPromise(h.result(S.prepareTransfer(r, {
+				tenantId: i.tenantId,
+				requestId: O(i, "reserve"),
+				currency: i.currency,
+				amount: i.amount,
+				from: i.owner,
+				to: {
+					kind: "system",
+					id: A(i)
+				},
+				reason: "escrow.reserve",
+				ref: {
+					kind: "economy.escrow",
+					id: i.reservationId
+				}
+			})));
+			if (g.isFailure(n)) throw n.failure;
+			return b(x, [n.success], async (e, [n]) => {
+				let r = (await e.query(v(l).where(_("id", n.txId)).limit(1).descriptor))[0];
+				if (!r || r.state !== "committed") throw t("invalid_record");
+				if (r.escrow !== null) {
+					let e = N(r);
+					if (!j(e.intent, i) || e.intent.amount !== String(i.amount)) throw t("conflict");
+				} else await e.update(l.tableName, n.txId, { escrow: Object.freeze({
+					intent: i,
+					close: null
+				}) });
+				return await P(e, i, "reserve", String(i.amount), n), n;
+			});
+		});
+	}), V = (e, n, r, o, s) => T(() => {
+		let c = structuredClone(e), d = o ? m(n) : r === "settle" ? p(n) : u(n);
+		E(c);
+		let f = r === "settle" ? d.to : d.owner, C = D(d, f), T = o ? d.taxAmount : "0", F = o ? d.taxAccountId : "escrow.tax.default", B = (e) => e.close?.mode === r && e.close.targetKey === C && (e.close.tax?.amount ?? "0") === T && (T === "0" || e.close.tax?.account === F);
+		return w(async () => {
+			let e = await x.transactional((e) => R(e, d));
+			if (!e && s === void 0) throw t("not_found");
+			let n = e?.body.intent.amount ?? i(s).toString();
+			if (s !== void 0 && s !== n) throw t("conflict");
+			if (BigInt(T) > BigInt(n)) throw t("invalid_amount");
+			if (e?.body.close) {
+				if (!B(e.body)) throw t("conflict");
+				return y(x, async (e) => {
+					await z(e, d, f);
+					let n = await R(e, d);
+					if (!n || !B(n.body)) throw t("conflict");
+					return L(d, n.body);
+				});
+			}
+			await S.seedWallet(d.tenantId, f);
+			let o = (BigInt(n) - BigInt(T)).toString(), u = [];
+			if (o !== "0") {
+				let e = await h.runPromise(h.result(S.prepareTransfer(c, {
+					tenantId: d.tenantId,
+					requestId: O(d, "close"),
+					currency: d.currency,
+					amount: o,
+					from: {
+						kind: "system",
+						id: A(d)
+					},
+					to: f,
+					reason: r === "release" ? "escrow.release" : "escrow.settle",
+					ref: {
+						kind: "economy.escrow",
+						id: d.reservationId
+					}
+				})));
+				if (g.isFailure(e)) throw e.failure;
+				u.push(e.success);
+			}
+			if (T !== "0") {
+				let e = await h.runPromise(h.result(S.prepareTransfer(c, {
+					tenantId: d.tenantId,
+					requestId: O(d, "tax"),
+					currency: d.currency,
+					amount: T,
+					from: {
+						kind: "system",
+						id: A(d)
+					},
+					to: {
+						kind: "system",
+						id: F
+					},
+					reason: "escrow.tax",
+					ref: {
+						kind: "economy.escrow",
+						id: d.reservationId
+					}
+				})));
+				if (g.isFailure(e)) throw e.failure;
+				u.push(e.success);
+			}
+			let p = y(x, async (e) => {
+				await z(e, d, f);
+				let r = await R(e, d);
+				if (!r || r.body.intent.amount !== n || r.body.close && !B(r.body)) throw t("conflict");
+			});
+			return b(x, [p, ...u], async (e, [, ...i]) => {
+				await M(e, d);
+				let s = (await e.query(v(l).where(_("id", k(d, "reserve"))).limit(1).descriptor))[0];
+				if (!s) throw t("invalid_record");
+				let c = N(s), u = S.decodeReceipt(s);
+				if (!j(c.intent, d) || c.intent.amount !== n) throw t("invalid_record");
+				await P(e, d, "reserve", c.intent.amount, u);
+				let f = i.find((e) => e.txId === k(d, "close")) ?? null, p = i.find((e) => e.txId === k(d, "tax")) ?? null;
+				if ((o === "0" ? f !== null : !f || f.amount !== o || f.currency !== d.currency) || (T === "0" ? p !== null : !p || p.amount !== T || p.currency !== d.currency)) throw t("invalid_record");
+				let m = Object.freeze({
+					mode: r,
+					targetKey: C,
+					receipt: f,
+					tax: p ? Object.freeze({
+						amount: T,
+						account: F,
+						receipt: p
+					}) : null
+				});
+				if (c.close) {
+					if (!B(c) || a(c.close) !== a(m)) throw t("conflict");
+				} else await e.update(l.tableName, k(d, "reserve"), { escrow: Object.freeze({
+					intent: c.intent,
+					close: m
+				}) });
+				let h = {
+					intent: c.intent,
+					close: m
+				};
+				return await I(e, d, h), L(d, h);
+			});
+		});
+	}), H = (e, n, r) => h.flatMap(V(e, n, r, !1), (e) => h.sync(() => b(x, [e], async (e, [n]) => {
+		if (!n.payout || n.tax !== "0") throw t("invalid_record");
+		return n.payout;
+	}))), U = (e, t) => T(() => {
+		let n = structuredClone(e), r = f(t);
+		E(n);
+		let i = Object.freeze({
+			tenantId: r.tenantId,
+			owner: r.owner,
+			reservationId: r.reservationId,
+			currency: r.currency,
+			amount: r.amount
+		}), a = Object.freeze({
+			tenantId: r.tenantId,
+			owner: r.owner,
+			reservationId: r.reservationId,
+			currency: r.currency,
+			to: r.to,
+			taxAmount: r.taxAmount,
+			taxAccountId: r.taxAccountId
+		});
+		return h.flatMap(B(n, i), (e) => h.map(V(n, a, "settle", !0, r.amount), (t) => b(x, [e, t], async (e, [t, n]) => Object.freeze({
+			reserve: t,
+			settlement: n
+		}))));
+	}), W = (e, t) => T(() => {
+		let n = structuredClone(e), r = u(t);
+		return E(n), w(() => x.transactional(async (e) => {
+			let t = await R(e, r);
+			return Object.freeze(t ? {
+				reservationId: r.reservationId,
+				currency: r.currency,
+				amount: t.body.intent.amount,
+				state: t.body.close?.mode === "release" ? "released" : t.body.close ? "settled" : "held",
+				receipt: t.receipt,
+				closingReceipt: t.body.close?.receipt ?? null,
+				taxReceipt: t.body.close?.tax?.receipt ?? null
+			} : {
+				reservationId: r.reservationId,
+				currency: r.currency,
+				state: "not-observed"
+			});
+		}));
+	}), G = async (e, n, r, i) => {
+		let a = [];
+		for (let o of i) {
+			let i = (await e.query(v(l).where(_("id", o)).limit(1).descriptor))[0];
+			if (!i || i.tenantId !== n) throw t("invalid_record");
+			if (i.escrow === null) continue;
+			let c = N(i);
+			if (c.intent.tenantId !== n || s(c.intent.owner) !== s(r)) throw t("invalid_record");
+			c.close?.tax && (await F(e, c.intent, c.close.tax), a.push(c.close.tax.receipt.txId));
+		}
+		return Object.freeze([...new Set(a)]);
+	}, K = Object.freeze({
+		prepareEscrowReserve: B,
+		prepareEscrowReserveTaxSettle: U,
+		prepareEscrowRelease: (e, t) => H(e, t, "release"),
+		prepareEscrowSettle: (e, t) => H(e, t, "settle"),
+		prepareEscrowTaxSettle: (e, t) => V(e, t, "settle", !0),
+		escrow: W
+	});
+	return Object.freeze({
+		...K,
+		taxTransactionIds: G
+	});
+};
+export { x as walletEscrowParticipant };

package/dist/walletKeys.server.js

@@ -0,0 +1,4 @@
+import { createHash as e } from "node:crypto";
+// src/walletKeys.server.ts
+var t = (t) => e("sha256").update(JSON.stringify(t)).digest("hex"), n = (e, ...n) => e + t(n).slice(0, 56);
+export { t as walletHash, n as walletKey };