Adrift is a decentralized game built on Syndicate's sequencing infrastructure. The project consists of two main categories of contracts deployed across different chains, along with a complete full-stack application.

Adrift uses a cross-chain architecture to separate game logic from transaction sequencing, enabling high throughput and efficient gas usage.

These contracts handle the core game logic and player interactions:

• Adrift.sol - Main game contract with winner determination
• AdriftForever.sol - Perpetual game version without end conditions
• AdriftFactory.sol - Factory for deploying game instances
• CheckInOutcomes.sol - Manages random outcomes for player check-ins
• CheckInOutcomesFactory.sol - Factory for deploying outcome contracts
• Random.sol - Provides verifiable randomness for the game

These contracts handle transaction sequencing and compression:

• AdriftBundler.sol - Bundles and sequences game transactions
• Decompressor.sol - Decompresses zlib-compressed RLP transaction data
• RLPTxBreakdown.sol - Utilities for decoding RLP transaction data
• RLPReader.sol - RLP decoding utilities

1. Players register by calling register() on the game contract
2. Players must check in every 24 hours to remain active
3. Check-ins have random outcomes that can buff/debuff next check-in times
4. Players who miss check-ins or get negative outcomes are disqualified
5. Last player standing wins (in Adrift.sol) or game continues indefinitely (in AdriftForever.sol)

• Grace Period: 1 hour window before next check-in where players can check in safely
• Risk/Reward: Early check-ins increase both risk of disqualification and potential rewards
• Random Outcomes: Each check-in has a random outcome affecting the next check-in time

The application uses a sophisticated cross-chain architecture to optimize performance and cost:

Game Chain (Pacifica):

• Handles core game logic and state management
• Processes player registrations and check-ins
• Manages game outcomes and disqualifications
• Provides verifiable randomness integration

Sequencing Chain (Risa):

• Bundles multiple transactions into single sequencing transactions
• Compresses transaction data for gas efficiency
• Processes transactions in order with randomness integration
• Handles high-throughput transaction processing

Frontend (Next.js):

• Modern web interface built with React and Tailwind CSS
• Integrates with Para wallet for seamless user experience
• Real-time game state updates via indexer
• Responsive design for mobile and desktop

Indexer (Ponder):

• Monitors blockchain events across both chains
• Stores indexed data in PostgreSQL database
• Provides GraphQL API for frontend consumption
• Handles real-time data synchronization

Database (PostgreSQL):

• Stores game state, player data, and transaction history
• Optimized for read-heavy workloads
• Supports complex queries for leaderboards and analytics

Cron Jobs:

• Automated maintenance and monitoring tasks
• Health checks and system monitoring
• Periodic data cleanup and optimization

Syndicate Transaction Cloud:

• Handles automated transaction processing
• Manages player disqualification automation
• Provides reliable transaction sequencing

Para Wallet:

• Seamless wallet integration for users
• Supports multiple wallet types
• Handles transaction signing and submission

Lit Protocol:

• Programmable Key Pair (PKP) authentication
• Secure key management for automated processes
• Enhanced security for critical operations

adrift/
├── apps/
│   ├── indexer/         # Ponder indexer
│   ├── site/            # Next.js frontend application
│   └── cron/            # Automated tasks
├── contracts/
│   ├── foundry/         # Solidity smart contracts
│   └── stylus-decompressor/  # Rust Stylus contracts
└── package.json         # Monorepo configuration

MIT License - see LICENSE file for details