Secure Token Wallet

A secure token wallet built on the Internet Computer Protocol (ICP) blockchain, utilizing Rust for secure token transfers, minting, and querying balances.

---

Table of Contents

1. Project Overview
2. Features
3. Getting Started
4. Installation
5. Usage
6. Testing
7. File Structure
8. Contributing
9. License

---

Project Overview

The Secure Token Wallet is a blockchain-based wallet application that enables secure, efficient token transactions on the ICP blockchain. Built with Rust, this application allows users to mint tokens, check balances, and perform transfers between accounts.

---

Features

• Mint Tokens: Create tokens for a given account.
• Transfer Tokens: Securely transfer tokens between accounts.
• Query Balance: Check the balance of any account.

---

Getting Started

Prerequisites

To run this project, you will need:

• DFX SDK (Internet Computer SDK)
• Rust programming language and package manager
• Node.js and npm (for front-end testing, if applicable)

---

Installation

Follow these steps to set up and run the project:

1. Clone the Repository:

   git clone https://github.com/Hitesh-jadhav/Secure-Token-Wallet.git
   cd Secure-Token-Wallet

2. Install Dependencies:

   • Install Rust if not already installed:

     curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

   • Install DFX SDK:

     sh -ci "$(curl -fsSL https://internetcomputer.org/docs/current/developer-docs/setup/install)"

3. Start Local Replica:

   dfx start --background

4. Deploy the Canister:

   dfx deploy

---

Usage

Once deployed, you can interact with the canisters using the following methods.

Check Balance

dfx canister call secure_token_wallet_backend get_balance '(principal "<principal_id>")'

Transfer Tokens

dfx canister call secure_token_wallet_backend transfer '(principal "<from_principal>", principal "<to_principal>", <amount>)'

Mint Tokens

dfx canister call secure_token_wallet_backend mint '(principal "<principal_id>", <amount>)'

---

Testing

To run the test suite:

1. Run Tests:

   cargo test

2. Verify Output: Ensure all test cases pass without errors.

---

File Structure

Secure-Token-Wallet/
├── src/
│   ├── secure_token_wallet_backend/
│   │   ├── lib.rs                  # Core backend functionality
│   └── secure_token_wallet_frontend/
│       └── (Optional front-end code for interaction)
├── README.md                       # Documentation
└── Cargo.toml                       # Rust package configuration

---

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements.

---

License

This project is licensed under the MIT License.