Package com.patelheet.capitalengine.api

Interface TransactionBuilder

public interface TransactionBuilder

Builds a multi-leg transaction that applies completely or not at all.

Method Summary

Modifier and Type	Method	Description
TransactionBuilder	actor(UUID playerId)	The player who caused this, for audits.
CompletableFuture<TxResult>	commit()	Validates and applies in memory now; the future completes once the transaction is in the database.
TransactionBuilder	destroy(Account from, long amount)	Destroys coins (from → Mint).
TransactionBuilder	issue(Account to, long amount)	Creates coins (Mint → to).
TransactionBuilder	move(Account from, Account to, long amount)	Moves coins between two accounts.
TransactionBuilder	reference(String reference)	Idempotency key, unique per plugin.
TransactionBuilder	serverPay(Account to, long amount)	Pays from the server: Treasury first, newly created coins for any shortfall, within the caller's limits.

Method Details

move

TransactionBuilder move(Account from,
 Account to,
 long amount)

Moves coins between two accounts. Moving out of the Treasury is not allowed here; use serverPay(com.patelheet.capitalengine.api.Account, long).

issue

TransactionBuilder issue(Account to,
 long amount)

Creates coins (Mint → to). Counts against the caller's issue limit.

destroy

TransactionBuilder destroy(Account from,
 long amount)

Destroys coins (from → Mint).

serverPay

TransactionBuilder serverPay(Account to,
 long amount)

Pays from the server: Treasury first, newly created coins for any shortfall, within the caller's limits.

reference

TransactionBuilder reference(String reference)

Idempotency key, unique per plugin. A repeat commit fails with Failure.DUPLICATE_REFERENCE.

actor

TransactionBuilder actor(UUID playerId)

The player who caused this, for audits. Optional.

commit

CompletableFuture<TxResult> commit()

Validates and applies in memory now; the future completes once the transaction is in the database.