Skip to content

Latest commit

 

History

History
103 lines (81 loc) · 2.2 KB

README.md

File metadata and controls

103 lines (81 loc) · 2.2 KB
Raw

Donations contract for NEAR Protocol

Description

This contract implements donations functional - users can send donations in NEARs to contract, and only contract owner can withdraw this donations.

Contract deployed on testnet address donations.va-an.testnet.

Example Story

  1. Mike deploys contract and sets fundraiser address as mike.near.
  2. Alice and Bob decided to send donation to Mike, they checks that fundraiser is Mike's address.
  3. Alice sends 1 NEAR donations to contract.
  4. Bob sends 1.5 NEAR donations to contract.
  5. Mike sees these donations in history.
  6. Mike withdraws donations (2.5 NEARs) from Alice and Bob to mike.near
  7. Alice and Bob sees in history that Mike withdrew donations.

Build

add build target:

rustup target add wasm32-unknown-unknown

run tests:

cargo test

then build:

cargo build --target wasm32-unknown-unknown --release

API

View methods

pub fn show_history(&self) -> Vec<Record>;
pub fn show_donations_sum(&self) -> Balance;
pub fn show_fundraiser(&self) -> AccountId;
pub fn current_state(&self) -> DebugState;

Call methods

pub fn send_donation(&mut self);
pub fn withdraw_donations(&mut self) -> Promise;

Usage examples for near-cli

Some examples for near-cli below.

deploy and init contract

near deploy \
--account_id donations.va-an.testnet \
--wasmFile target/wasm32-unknown-unknown/release/donations.wasm \
--helperUrl https://near-contract-helper.onrender.com \
--initFunction new \
--initArgs '{"fundraiser": "va-an.testnet"}'

Don't forget change account id and init args!

send donation

near call donations.va-an.testnet send_donation --account_id va-an.testnet --amount 7.77

withdraw

near call donations.va-an.testnet withdraw_donations --account_id v_a.testnet

show donations history

near view donations.va-an.testnet show_history

show donations sum

near view donations.va-an.testnet show_donations_sum

show fundraiser

near view donations.va-an.testnet show_fundraiser

show contract state

near view donations.va-an.testnet current_state