initial implementation for claim protocol

Author: Prometheo

Cargo.lock

@@ -11,8 +11,8 @@ repository = "https://github.com/<xxx>/<xxx>"
 [lib]
 crate-type = ["cdylib", "rlib"]
 
-# fields to configure build with WASM reproducibility, according to specs  
-# in https://github.com/near/NEPs/blob/master/neps/nep-0330.md 
+# fields to configure build with WASM reproducibility, according to specs
+# in https://github.com/near/NEPs/blob/master/neps/nep-0330.md
 [package.metadata.near.reproducible_build]
 # docker image, descriptor of build environment
 image = "sourcescan/cargo-near:0.12.1-rust-1.82.0"
@@ -22,7 +22,7 @@ image_digest = "sha256:841e72af53e151e3d8f65ef2e50dcec162699d876348a8ec0e77b6cde
 # in a reproducible manner
 # supported by `sourcescan/cargo-near:0.10.1-rust-1.82.0` image or later images
 passed_env = []
-# build command inside of docker container 
+# build command inside of docker container
 # if docker image from default gallery is used https://hub.docker.com/r/sourcescan/cargo-near/tags,
 # the command may be any combination of flags of `cargo-near`,
 # supported by respective version of binary inside the container besides `--no-locked` flag
@@ -37,6 +37,7 @@ near-sdk = { version = "5.6", features = ["unit-testing"] }
 near-workspaces = { version = "0.15", features = ["unstable"] }
 tokio = { version = "1.12.0", features = ["full"] }
 serde_json = "1"
+chrono = "0.4.40"
 
 [profile.release]
 codegen-units = 1

Cargo.toml

@@ -1,37 +1 @@
 # claim-protocol
-
-cargo-near-new-project-description
-
-## How to Build Locally?
-
-Install [`cargo-near`](https://github.com/near/cargo-near) and run:
-
-```bash
-cargo near build
-```
-
-## How to Test Locally?
-
-```bash
-cargo test
-```
-
-## How to Deploy?
-
-Deployment is automated with GitHub Actions CI/CD pipeline.
-To deploy manually, install [`cargo-near`](https://github.com/near/cargo-near) and run:
-
-```bash
-cargo near deploy <account-id>
-```
-
-## Useful Links
-
-- [cargo-near](https://github.com/near/cargo-near) - NEAR smart contract development toolkit for Rust
-- [near CLI](https://near.cli.rs) - Interact with NEAR blockchain from command line
-- [NEAR Rust SDK Documentation](https://docs.near.org/sdk/rust/introduction)
-- [NEAR Documentation](https://docs.near.org)
-- [NEAR StackOverflow](https://stackoverflow.com/questions/tagged/nearprotocol)
-- [NEAR Discord](https://near.chat)
-- [NEAR Telegram Developers Community Group](https://t.me/neardev)
-- NEAR DevHub: [Telegram](https://t.me/neardevhub), [Twitter](https://twitter.com/neardevhub)

README.md

@@ -0,0 +1,83 @@
+use crate::*;
+
+#[near(serializers=[borsh, json])]
+#[derive(Clone, PartialEq, Eq, PartialOrd, Ord)]
+pub enum ClaimType {
+    Near,
+    FungibleToken {
+        contract_id: AccountId,
+    },
+    NonFungibleToken {
+        contract_id: AccountId,
+        token_id: String,
+    },
+}
+
+#[near(serializers=[borsh, json])]
+#[derive(Clone, PartialEq, Eq, PartialOrd, Ord)]
+pub struct Claim {
+    pub claim_type: ClaimType,
+    pub amount: u128, // For NEAR and FTs. Ignored for NFTs
+    pub tipper: AccountId,
+    pub timestamp: u64,
+    pub expires_at: u64,
+    pub claimed: bool,
+}
+
+impl Claim {
+    pub fn new_near(tipper: AccountId, amount: u128) -> Self {
+        Self {
+            claim_type: ClaimType::Near,
+            amount,
+            tipper,
+            timestamp: env::block_timestamp(),
+            expires_at: env::block_timestamp() + crate::CLAIM_EXPIRATION_PERIOD,
+            claimed: false,
+        }
+    }
+
+    pub fn new_ft(tipper: AccountId, contract_id: AccountId, amount: u128) -> Self {
+        Self {
+            claim_type: ClaimType::FungibleToken { contract_id },
+            amount,
+            tipper,
+            timestamp: env::block_timestamp(),
+            expires_at: env::block_timestamp() + crate::CLAIM_EXPIRATION_PERIOD,
+            claimed: false,
+        }
+    }
+
+    pub fn new_nft(tipper: AccountId, contract_id: AccountId, token_id: String) -> Self {
+        Self {
+            claim_type: ClaimType::NonFungibleToken {
+                contract_id,
+                token_id,
+            },
+            amount: 0, // Not used for NFTs
+            tipper,
+            timestamp: env::block_timestamp(),
+            expires_at: env::block_timestamp() + crate::CLAIM_EXPIRATION_PERIOD,
+            claimed: false,
+        }
+    }
+
+    pub fn is_expired(&self) -> bool {
+        env::block_timestamp() >= self.expires_at
+    }
+
+    pub fn amount(&self) -> u128 {
+        self.amount
+    }
+
+    pub fn tipper(&self) -> &AccountId {
+        &self.tipper
+    }
+
+    pub fn token_type(&self) -> &str {
+        match &self.claim_type {
+            ClaimType::Near => "NEAR",
+            ClaimType::FungibleToken { .. } => "FT",
+            ClaimType::NonFungibleToken { .. } => "NFT",
+        }
+    }
+}