OGC is a trustless group travel savings & governance app on Algorand — trips go from text to takeoff with smart contract vaults.
⸻
Out The Group Chat (OGC) is a Web3-powered group travel savings and governance platform built on Algorand. It solves a common problem: most trip ideas die in the group chat because no one commits money early, coordination is messy, and trust breaks down.
With OGC, friends pool funds into on-chain vaults, contribute consistently, and unlock money only when group approvals are met. Funds are transparent, trustless, and governed directly in smart contracts.
🔑 How It Works 1. Create a Trip Pool (e.g., Italy 2025 with a $3,000 goal). 2. Invite Friends – connect Algorand wallets or join via link. 3. Set Contributions – weekly fixed amounts until the trip date. 4. Funds Locked On-Chain – escrow in Algorand USDCa (ASA). 5. Group Approvals – 75% quorum required to release/refund. 6. Exit Rules – members can leave only with full group consent. 7. Book When Ready – release funds to wallets or trigger booking flows.
This makes OGC the first trustless, social, and automated group travel savings app.
OGC leverages Algorand’s unique AVM (Algorand Virtual Machine) and low-fee design to make group savings practical and scalable: • Smart Contracts: Written in PyTeal/Beaker, deployed on TestNet. • ASA Integration: OGC Token (1B supply) + USDCa for stable-value escrow. • Wallet Support: Pera & Defly via WalletConnect. • Transaction Costs: ~0.001 ALGO — effectively free. • SDKs: py-algorand-sdk, beaker-pyteal, algokit. • Indexing: Algorand Indexer tracks contributions and approvals.
Algorand Features that Enable OGC: • ✅ Atomic Transfers for grouped payments + app calls. • ✅ Stateful Smart Contracts for quorum governance and vault rules. • ✅ Algorand Standard Assets (ASA) for USDCa and custom tokens. • ✅ Deterministic Fees (~$0.0003) allow micro-contributions.
⸻
✨ OGC Smart Contract Ecosystem • 🪙 OGC Token – Custom ASA (1B supply, 6 decimals). • 🏦 Advanced Vault – Goal-based crowdfunding w/ deadlines. • 📤 Sender Contract – Distribute ALGO from vault → wallets. • 🔄 Echo Contract – Risk-free testing, auto bounce-back. • 💳 Multi-Wallet Support – 3 wallets configured for TestNet demos. • 🎭 Interactive Demos – Choose-your-own-adventure testing CLI.
# Navigate to project
cd ~/OGC
# Activate virtual environment
source ogc-contracts/projects/ogc-contracts/venv/bin/activate
# Install dependencies (if needed)
pip install -r requirements.txt# Check wallet balances
python check_any_balance.py
# Choose option 5: Check all wallets
# Get TestNet ALGO from dispenser:
# https://testnet.algoexplorer.io/dispenser
# Fund these addresses with 5+ ALGO each:
# - 63W3II7K5X2OYPMX4DSMNOK4HY33UFJRI2MQ2OFDUHF47LFLUNIUJTDN4U
# - SXIEIE2D7FOKUNQXUFUZIRYKE75RYD5KBN5BOYZFXLIL7LOTFX4VK3U7CE
# - TR5YH6EHNKNE24OSMCOXK7B4DKL6DYBGIZAYZUORAOL2C5ILR2ASVOYAPQ# Run interactive demo
python ogc_demo.py
# Choose option 5: Full Ecosystem Demopython create_ogc_token.py # Create OGC token
python advanced_vault.py # Deploy vault (goal: 2 ALGO, 24 hours)
python sender_contract.py # Deploy sender (fund with 5 ALGO)
python echo_contract.py # Deploy echo (fund with 3 ALGO)# Token testing
python token_interact.py # Opt-in, transfer tokens
# Vault testing
python vault_interact.py # Contribute, check status, release
# Sender testing
python sender_interact.py # Send ALGO from contract
# Echo testing
python echo_interact.py # Test bounce-back (send 1 ALGO, get 0.999 back)
# Simple contract testing
python simple_deploy_multi.py # Deploy simple
python simple_deposit.py optin # Opt-in
python simple_deposit.py deposit 2 # Trigger refundpython check_any_balance.py # Check all balances
python ogc_demo.py # Choose option 7: Deployment status
python full_demo.py # Automated demo of all featuresOGC/
├── README.md # This file
├── TESTING_GUIDE.md # Comprehensive testing docs
├── wallets.json # TestNet wallet configurations
├── create_ogc_token.py # OGC token creation
├── advanced_vault.py # Crowdfunding vault
├── sender_contract.py # ALGO sender contract
├── echo_contract.py # Auto bounce-back contract
├── ogc_demo.py # Interactive demo
├── full_demo.py # Automated ecosystem demo
├── check_any_balance.py # Balance utilities
└── *_interact.py # Contract interaction scripts
- Supply: 1,000,000,000 OGC
- Decimals: 6
- Features: Standard Algorand asset with opt-in required
- Purpose: Goal-based crowdfunding
- Features: Deadline enforcement, automatic release
- Usage: Set goal + deadline, contributors fund, auto-release when conditions met
- Purpose: Send ALGO from contract to any wallet
- Features: Owner-controlled, tracks total sent
- Usage: Fund contract, then send to any address
- Purpose: Risk-free testing and demos
- Features: Automatically bounces ALGO back (minus 0.001 fee)
- Usage: Send ALGO, get it back immediately
- Purpose: Basic deposit/refund mechanism
- Features: Auto-refund at 2 ALGO threshold
- Usage: Opt-in, deposit, automatic refund
- Blockchain: Algorand TestNet
- SDK: py-algorand-sdk 2.6.0
- Smart Contracts: PyTeal/TEAL
- Language: Python 3.7+
- Network: TestNet via Algonode API
python full_demo.py
# Showcases all features in sequencepython ogc_demo.py
# Choose specific features to testpython ogc_demo.py
# Choose option 6: Custom Demo
# Select multiple features: 1,2,4- Dispenser: https://testnet.algoexplorer.io/dispenser
- Explorer: https://testnet.algoexplorer.io/
- API: https://testnet-api.algonode.cloud
When everything works correctly:
- ✅ All contracts deploy successfully
- ✅ Tokens transfer between wallets
- ✅ Vault accepts contributions and releases funds
- ✅ Echo contract bounces ALGO back
- ✅ Sender contract sends to any address
- ✅ Demo shows "Success Rate: 100%"
- "Insufficient Balance": Fund wallets with TestNet ALGO
- "Contract Not Found": Deploy contracts first
- "Opt-in Required": Run opt-in commands before interactions
# Check what's deployed
python ogc_demo.py → option 7
# Check wallet balances
python check_any_balance.py → option 5
# Get help
python ogc_demo.py → follow menu options- Setup environment (activate venv, install deps)
- Fund wallets (get TestNet ALGO)
- Run demo (
python ogc_demo.py) - Deploy contracts (follow prompts)
- Test features (use interaction scripts)
Ready to explore the OGC ecosystem! 🚀✨
Built for Algorand Hackathon - Complete DeFi ecosystem on TestNet