new sign transaction event

Essentials/src/main/java/com/earth2me/essentials/signs/SignBuy.java

@@ -3,6 +3,7 @@
 import com.earth2me.essentials.ChargeException;
 import com.earth2me.essentials.Trade;
 import com.earth2me.essentials.User;
+import net.ess3.api.events.SignTransactionEvent;
 import net.ess3.api.IEssentials;
 import net.ess3.api.MaxMoneyException;
 import org.bukkit.inventory.ItemStack;
@@ -45,6 +46,19 @@ protected boolean onSignInteract(final ISign sign, final User player, final Stri
         }
 
         charge.isAffordableFor(player);
+        final SignTransactionEvent signTransactionEvent = new SignTransactionEvent(
+                sign,
+                this,
+                player,
+                items.getItemStack(),
+                SignTransactionEvent.TransactionType.BUY,
+                charge.getMoney()
+        );
+
+        ess.getServer().getPluginManager().callEvent(signTransactionEvent);
+        if (signTransactionEvent.isCancelled()) {
+            return true;
+        }
         if (!items.pay(player)) {
             throw new ChargeException("inventoryFull");
         }

Essentials/src/main/java/com/earth2me/essentials/signs/SignSell.java

@@ -4,6 +4,7 @@
 import com.earth2me.essentials.Trade;
 import com.earth2me.essentials.Trade.OverflowType;
 import com.earth2me.essentials.User;
+import net.ess3.api.events.SignTransactionEvent;
 import net.ess3.api.IEssentials;
 import net.ess3.api.MaxMoneyException;
 import org.bukkit.inventory.ItemStack;
@@ -47,6 +48,21 @@ protected boolean onSignInteract(final ISign sign, final User player, final Stri
         }
 
         charge.isAffordableFor(player);
+
+        final SignTransactionEvent signTransactionEvent = new SignTransactionEvent(
+                sign,
+                this,
+                player,
+                charge.getItemStack(),
+                SignTransactionEvent.TransactionType.SELL,
+                money.getMoney()
+
+        );
+        ess.getServer().getPluginManager().callEvent(signTransactionEvent);
+        if (signTransactionEvent.isCancelled()) {
+            return false;
+        }
+
         money.pay(player, OverflowType.DROP);
         charge.charge(player);
         Trade.log("Sign", "Sell", "Interact", username, charge, username, money, sign.getBlock().getLocation(), player.getMoney(), ess);

Essentials/src/main/java/net/ess3/api/events/SignTransactionEvent.java

@@ -0,0 +1,86 @@
+package net.ess3.api.events;
+
+import com.earth2me.essentials.signs.EssentialsSign;
+import net.ess3.api.IUser;
+import org.bukkit.event.Cancellable;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+import java.math.BigDecimal;
+
+/**
+ * Fired when a player either buys or sells from an essentials sign
+ */
+public final class SignTransactionEvent extends SignInteractEvent implements Cancellable {
+    private final ItemStack itemStack;
+    private final TransactionType transactionType;
+    private final BigDecimal transactionValue;
+    private boolean isCancelled = false;
+
+    public SignTransactionEvent(EssentialsSign.ISign sign,
+                                EssentialsSign essSign,
+                                IUser user,
+                                @NotNull ItemStack itemStack,
+                                @NotNull TransactionType transactionType,
+                                BigDecimal transactionValue) {
+        super(sign, essSign, user);
+        this.itemStack = itemStack;
+        this.transactionType = transactionType;
+        this.transactionValue = transactionValue;
+    }
+
+    /**
+     *
+     * @return if the event should be cancelled.
+     */
+
+    @Override
+    public boolean isCancelled() {
+        return this.isCancelled;
+    }
+
+    /**
+     *
+     * @param cancelled sets the event to be cancelled, this will cancel the transaction.
+     */
+
+    @Override
+    public void setCancelled(boolean cancelled) {
+        this.isCancelled = cancelled;
+    }
+
+    /**
+     *
+     * @return a copy of the itemstack in the current transaction.
+     */
+
+    public @NotNull ItemStack getItemStack() {
+        return itemStack.clone();
+    }
+
+    /**
+     *
+     * @return the type of transaction executed.
+     */
+    public @NotNull TransactionType getTransactionType() {
+        return transactionType;
+    }
+
+    /**
+     *
+     * @return how much was either sold or bought through the sign.
+     */
+
+    public BigDecimal getTransactionValue() {
+        return transactionValue;
+    }
+
+    /**
+     * Transaction type of the event
+     */
+
+    public enum TransactionType {
+        BUY,
+        SELL
+    }
+}