tellus-cooperative/sorobounty.xyz

An open-source bounty hunting platform where users create and apply for jobs via Stellar Blockchain wallets. Soroban Smart Contracts written in Rust and NextJS frontend.

Sorobounty.xyz

Overview

The Bounty Hunter Web Application is a platform that facilitates the creation and participation in bounties for various tasks. This application leverages the Stellar blockchain through the Soroban platform to establish an Escrow Smart Contract, ensuring secure fund management, authentication, and a review stage for accepting or rejecting work.

Getting Started

Download Project

Clone the project repository from GitHub:

$ git clone https://github.com/Tellus-Cooperative/sorobounty.xyz

Build & Deploy Smart Contract

Navigate to the contracts directory:

$ cd sorobounty.xyz/contracts

Build and deploy the Smart Contract:

$ soroban contract build
$ soroban contract deploy \
    --wasm target/wasm32-unknown-unknown/release/soroban_token_contract.wasm \
    --source <admin> \
    --rpc-url https://rpc-futurenet.stellar.org:443 \
    --network-passphrase 'Test SDF Future Network ; October 2022'

This process generates a unique contract ID.

Generate Binding Module

To generate the binding module, use the following command, replacing <contract-id> with the contract ID generated in the previous step:

$ soroban contract bindings typescript \
    --wasm target/wasm32-unknown-unknown/release/soroban_escrow_smart_contract.wasm \
    --output-dir ../frontend_vite/bountyhunter_module \
    --contract-id <contract-id> \
    --rpc-url https://rpc-futurenet.stellar.org \
    --network-passphrase 'Test SDF Future Network ; October 2022'

Run Backend

Open a new terminal and navigate to the backend directory:

$ cd sorobounty.xyz/backend

Install the required dependencies and start the backend server:

$ npm install
$ npm run start

Run Frontend

Open another terminal and navigate to the frontend directory:

$ cd sorobounty.xyz/frontend

Install dependencies and start the frontend application:

$ yarn
$ npm run start

Access the BountyHunter Web Application at the following URL: https://localhost:5173/

You are now ready to explore and utilize the Sorobounty.xyz on your local environment.