This is the repository for the NEAR certified developer banksable project
The purpose of this project is to create a banking component that can be added to any NEAR protocol dApp providing banking facilities to secure and manage funds.
This project enables the contract owner to store their funds away from their main dApp
Run the following commands in order, substituting CONTRACT_ACCOUNT for the dev-XXXX-YYYY account and OWNER_ACCOUNT for your account.
yarn
yarn asb
near dev-deploy build/release/nearbankable.wasm
near call DEV_ACCOUNT init '{"owner":"'OWNER_ACCOUNT'"}' --accountId DEV_ACCOUNT
You can then interact with the contract using, for example:
near call --accountId "OWNER_ACCOUNT" DEV_ACCOUNT getBalance
On Windows, replace all the files without the -windows affix with the files with the -windows affix and run the following:
yarn
yarn start
near dev-deploy out/main.wasm
near call DEV_ACCOUNT init '{"owner":"'OWNER_ACCOUNT'"}' --accountId DEV_ACCOUNT
This returns the balance currently held in the NearBankable contract
getBalance(): Balance
This returns a map of all the current deposits that have been made into this contract. This call includes deposits that have been refunded
getDeposits(): PersistentMap<TransactionId, Deposit>
This returns a map containing all the withdrawals that have been made into this contract
getWithdrawals(): PersistentMap<TransactionId, Withdrawal>
This returns a map of all the refunds that have yet to be approved / declined
getPendingRefunds(): PersistentMap<TransactionId, Refund>
Alias for getPendingRefunds
getRefundRequestList(): PersistentMap<TransactionId, Refund>
This returns a map of all the refunds that have been issued from the NearBankable contract
getRefunds(): PersistentMap<TransactionId, Refund>
This returns a map of all the refunds that have been declined by the owner of the NearBankable contract
getDeclinedRefunds(): PersistentMap<TransactionId, Refund>
This deposits the funds sent into the NearBankable contract
depositFunds(depositParams: Deposit): u128
This withdraws the funds sent into the NearBankable contract
withdrawFunds(withdrawParams: Withdrawal): u128
This requests a refund from the Near Bankable contract. The request has to be approved by the NearBankable contract owner
requestRefund(refundParams: Refund): String
This approves the refund request and credits the depositor
approvedRefund(bankTxId: u128): String
This declines the refund request
declinedRefund(bankTxId: u128): String