Borrowhood is a modern, decentralized lending platform built on the Stellar blockchain. It enables users to lend and borrow cryptocurrency assets seamlessly through an intuitive interface with no traditional banking requirements.
- Passkey Authentication: Passwordless login using modern passkey technology
- No Seed Phrases: Forget complicated seed phrases or private keys
- Phishing Resistant: Enhanced security against common attacks
- Earn Interest: Competitive APY rates on deposited assets
- Flexible Loan Terms: Choose from 1 month, 3 months, or custom durations
- Real-time Interest Calculation: See your earnings before you commit
- Multiple Assets: Support for XLM, USDC and more (expandable)
- Asset Dashboard: View all your holdings in one place
- Transaction History: Track your lending, borrowing, and transfer activities
- Send Tokens: Easily transfer assets to other users
- Real-time Balances: Always up-to-date asset information
- Performance Tracking: Monitor your lending and borrowing positions
- Interest Accrual: Watch your earnings grow in real-time
- Detailed Analytics: Understand your crypto portfolio better
Watch our demo videos to see Borrowhood in action:
- Borrowhood - How to Lend & Borrow Crypto! - Learn how to use Borrowhood to lend and borrow cryptocurrency assets on the Stellar blockchain.
- Node.js (v16+)
- npm or yarn
-
Clone the repository
git clone https://github.com/yourusername/borrowhood.git cd borrowhood -
Install dependencies
npm install # or with yarn yarn install -
Set up environment variables Create a
.envfile in the root directory and add:VITE_rpcUrl=https://your-stellar-rpc-url VITE_networkPassphrase=your-network-passphrase VITE_walletWasmHash=your-wallet-wasm-hash VITE_launchtubeUrl=your-launchtube-url VITE_launchtubeJwt=your-launchtube-jwt VITE_mercuryProjectName=your-mercury-project-name VITE_mercuryUrl=your-mercury-url VITE_mercuryJwt=your-mercury-jwt VITE_nativeContractId=your-native-contract-id -
Run the development server
npm run dev # or with yarn yarn dev -
Open your browser Navigate to
http://localhost:5173to see the application.
To create a production build:
npm run build
# or with yarn
yarn buildMeet the team behind Borrowhood:
- Frontend: Svelte 5
- Language: TypeScript
- Build Tool: Vite
- Blockchain: Stellar Network
- Authentication: Passkey-kit for passwordless auth
- Styling: CSS with animation effects
/src: Source code for the application/src/lib: Common utilities and components/src/assets: Static assets
/public: Public assets/screenshots: Application screenshots
To add new features to Borrowhood:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Implement your changes
- Add tests if applicable
- Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
We use ESLint and Prettier for code formatting. Please ensure your code follows our style guidelines:
npm run checkBorrowhood interacts with the Stellar blockchain through the @stellar/stellar-sdk package. Key components:
src/lib/common.ts: Contains blockchain interaction utilities- Authentication is handled through
passkey-kit - Transactions are signed and submitted through the Stellar network
- Click the "Sign Up/Login" button in the top right
- Select "Create a New Account"
- Follow the prompts to create your passkey
- Navigate to the "Lend/Borrow" tab
- Select "LEND" mode
- Choose your asset (XLM, USDC, etc.)
- Enter the amount you wish to lend
- Select a duration (1 month, 3 months, or custom)
- Review the interest you'll earn
- Click the "Lend" button to confirm
- Navigate to the "Lend/Borrow" tab
- Select "BORROW" mode
- Choose your asset
- Enter the amount you wish to borrow
- Select a duration
- Review the interest you'll pay
- Click the "Borrow" button to confirm
- Navigate to the "Wallet" tab
- Click "Send Tokens"
- Select the token to send
- Enter the recipient's address
- Enter the amount
- Click "Send" to confirm the transaction
Contributions are what make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
See the Development Guide section for how to get started with contributing.
Distributed under the MIT License. See below for more information.
MIT License
Copyright (c) 2023-2024 Borrowhood
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
- Stellar Network for providing the blockchain infrastructure
- Passkey-kit for authentication
- Svelte for the reactive UI framework
- Vite for the lightning-fast development experience
- All our contributors and community members!
Borrowhood - Decentralized Lending for Everyone - https://borrowhood.xyz