Merge pull request #65 from PotLock/feat/donation-ft

Donation contract FT support

Author: lachlanglen

contracts/Cargo.lock

@@ -9,6 +9,7 @@ crate-type = ["cdylib"]
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 [dependencies]
 near-sdk = "4.1.1"
+# near-sdk = "5.0.0-alpha.2"
 # [profile.release] # removed as added to root Cargo.toml
 # codegen-units = 1
 # # Tell `rustc` to optimize for small code size.

contracts/donation/Cargo.toml

@@ -75,6 +75,12 @@ pub struct Donation {
 }
 ```
 
+### Storage
+
+The storage-related methods (`storage_deposit`, `storage_withdraw` and `storage_balance_of`) are utilized for fungible token (FT) donations, where the user must prepay storage on this Donation contract - to cover the storage of the Donation data - before calling `ft_transfer_call` on the FT contract.
+
+This is a simplified version of the [Storage Management standard](https://nomicon.io/Standards/StorageManagement).
+
 ### Contract Source Metadata
 
 _NB: Below implemented as per NEP 0330 (https://github.com/near/NEPs/blob/master/neps/nep-0330.md), with addition of `commit_hash`_
@@ -120,6 +126,13 @@ pub fn donate(
 ) -> Donation
 
 
+// STORAGE
+
+pub fn storage_deposit(&mut self) -> U128
+
+pub fn storage_withdraw(&mut self, amount: Option<U128>) -> U128
+
+
 // OWNER
 
 #[payable]
@@ -145,6 +158,7 @@ pub fn self_set_source_metadata(&mut self, source_metadata: ContractSourceMetada
 
 pub fn get_config(&self) -> Config
 
+
 // DONATIONS
 pub fn get_donations(&self, from_index: Option<u128>, limit: Option<u64>) -> Vec<Donation>
 
@@ -171,10 +185,17 @@ pub fn get_donations_for_ft(
     limit: Option<u64>,
 ) -> Vec<Donation>
 
+
+// STORAGE
+
+pub fn storage_balance_of(&self, account_id: &AccountId) -> U128
+
+
 // OWNER
 
 pub fn get_owner(&self) -> AccountId
 
+
 // SOURCE METADATA
 
 pub fn get_contract_source_metadata(&self) -> Option<ContractSourceMetadata>

contracts/donation/README.md

@@ -1,4 +1,11 @@
+use crate::*;
+
 pub const MAX_PROTOCOL_FEE_BASIS_POINTS: u32 = 1000;
 pub const MAX_REFERRAL_FEE_BASIS_POINTS: u32 = 200;
 
 pub const EVENT_JSON_PREFIX: &str = "EVENT_JSON:";
+
+pub const TGAS: u64 = 1_000_000_000_000; // 1 TGAS
+pub const XCC_GAS_DEFAULT: u64 = TGAS * 10; // 10 TGAS
+pub const NO_DEPOSIT: Balance = 0;
+pub const ONE_YOCTO: Balance = 1;