RemitLend treats remittance history as credit history. Migrant workers prove reliability through monthly transfers, allowing them to receive fair loans without predatory fees. Lenders earn transparent yield on the Stellar testnet.

Migrant workers often lack traditional credit history in host countries, forcing them towards high-interest payday loans. RemitLend bridges this gap by turning consistent remittance records into an on-chain reliability score, unlocking access to affordable capital.

The repository is organized as a monorepo containing the following components:

• backend/: Express.js server providing API support and metadata management.
• frontend/: Next.js web application for borrowers and lenders.
• contracts/: Soroban (Rust) smart contracts covering loans, pools, and NFTs.

• Blockchain: Stellar (Soroban)
• Frontend: Next.js, TypeScript, Tailwind CSS
• Backend: Node.js, Express, TypeScript
• Wallet: Stellar Wallet Kit (Freighter, etc.)

The following diagram illustrates the high-level interaction between RemitLend components:

graph TD
    User([User/Borrower]) <--> Frontend[Next.js Frontend]
    Frontend <--> Backend[Express Backend]
    Frontend <--> Stellar[Stellar/Soroban Network]
    
    subgraph "Soroban Smart Contracts"
        NFT[Remittance NFT]
        LM[Loan Manager]
        LP[Lending Pool]
    end
    
    Stellar --- NFT
    Stellar --- LM
    Stellar --- LP

• Node.js (v18+)
• Docker (Optional, for easy setup)
• Rust & Cargo (For contract development)
• Soroban CLI

1. Clone the repository:

   git clone https://github.com/your-repo/remitlend.git
   cd remitlend

2. Backend Configuration: Create a .env file in the backend/ directory:

   cp backend/.env.example backend/.env # If example exists, else create manually

   Add required variables:

   PORT=3001
   

From the root directory:

docker compose up --build

• Frontend: http://localhost:3000
• Backend: http://localhost:3001

1. Start Backend:

   cd backend
   npm install
   npm run dev

2. Start Frontend:

   cd frontend
   npm install
   npm run dev

3. Compile Contracts:

   cd contracts
   cargo build --target wasm32-unknown-unknown --release

We welcome contributions! Please see our CONTRIBUTING.md for guidelines on how to get started.

This project is licensed under the ISC License.