A blockchain-powered web application for fractional stock ownership and trading using ao and Arweave.
- User authentication with Web3 wallets
- Tokenized stock ownership
- Real-time stock price tracking
- Fractional trading capabilities
- Automatic dividend distribution
- Secondary marketplace for token trading
- Frontend: Next.js, React, TailwindCSS
- Blockchain: ao (Arweave), Polygon (for transactions)
- Storage: Arweave (via Turbo)
- Authentication: Web3Modal, WalletConnect
- Node.js >= 18
- npm or yarn
- A Web3 wallet (MetaMask, etc.)
- WalletConnect Project ID
Create a .env.local file in the root directory with the following variables:
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id
NEXT_PUBLIC_AO_SCHEDULER=your_ao_scheduler_address- Clone the repository:
git clone https://github.com/yourusername/fractional-stocks.git
cd fractional-stocks- Install dependencies:
npm install
# or
yarn install- Run the development server:
npm run dev
# or
yarn dev- Open http://localhost:3000 in your browser.
The platform uses ao smart contracts written in Lua for managing tokenized stocks. The main contract components are:
- Stock token creation and management
- Transfer functionality
- Dividend distribution
- Balance tracking
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.