Home › Hack Wars Manual › Hackscript API

Banking API

To transfer money between a player’s petty cash and bank, a Banking Application must be installed on a port. Without a banking application a player can’t purchase items or receive money from store sales, other players, or daily pay — this having been said, a banking port can be extremely attractive for opponents to maliciously target.

When programming a banking application the program has three main entry points:

Deposit: Deposit is called when a player is attempting to transfer money from their petty cash to their bank.

Withdraw: Withdraw is called when a player is attempting to transfer money from their bank to their petty cash (funds must be available in the petty cash to perform purchases).

Transfer: Transfer is called when a player attempts to transfer money from themselves to another player.

Method Required Level Compile Price CPU Usage Description
lowerDeposit(string ip,float amount) 1 $10 1 Deposits the amount specified into the bank of the player represented by the IP provided. lowerDeposit() takes the highest percentage in service charges and gives the least experience.
withdraw(string ip,float amount) 1 $10 1 Withdraws the amount specified into the petty cash of the player represented by the IP provided.
lowerTransfer(string targetIP,float amount) 1 $10 1 Transfers the amount specified to the petty cash of the player represented by the IP provided. lowerTransfer() takes the highest percentage in service charges and gives the least experience.
message(string ip,string message) 1 $10 1 Sends a message to the player represented by the IP address provided.
getAmount() 1 $10 1 Returns a float representing the amount that it has been requested be transfered, withdrawn, or deposited. Malicious programs may sometimes ignore this value (this value, however, represents an upper bound on how much can be withdrawn from the bank) .
getSourceIP() 1 $10 1 Returns a string representing the IP of the computer attempting to perform the banking operation.
getTargetIP() 1 $10 1 Returns a string representing the IP of the computer to which a money transfer request has been submitted. (used by the various transfer methods).
getMaliciousIP() 15 $1500 2 Returns the IP address of a computer that has hijacked this banking application. It is up to the programmer of the malicious application to decide how to act upon this information.
mediumDeposit(string ip,float amount) 25 $1500 5 Deposits the amount specified into the bank of the player represented by the IP provided. mediumDeposit() takes a lower percentage in service charges and gives more experience.
mediumTransfer(string ip,float amount) 25 $1500 5 Transfers the amount specified to the petty cash of the player represented by the IP provided. mediumTransfer() takes a lower percentage in service charges and gives more experience.
checkPettyCash() 25 $1500 5 Returns a float representing the amount currently in the petty cash of the player being targeted with this attack.
checkPettyCashTarget() 25 $1500 5 Returns a float value specified at runtime. This value can be used to decide, amongst other things, whether or not we should empty the opponent’s petty cash.
higherDeposit(string ip,float amount) 75 $6000 10 Deposits the amount specified into the bank of the player represented by the IP provided. higherDeposit() takes a lower percentage in service charges and gives more experience.
higherTransfer(string ip,float amount) 75 $6000 10 Transfers the amount specified to the petty cash of the player represented by the IP provided. higherTransfer() takes a lower percentage in service charges and gives more experience.
greaterDeposit(string ip,float amount) 95 $9000 20 Deposits the amount specified into the bank of the player represented by the IP provided. greaterDeposit() takes a lower percentage in service charges and gives more experience.
greaterTransfer(string ip,float amount) 95 $9000 20 Transfers the amount specified to the petty cash of the player represented by the IP provided. greaterTransfer() takes a lower percentage in service charges and gives more experience.