JumpMarket System Documentation
Complete guide to the JumpMarket secure escrow marketplace with smart contract protection, automated email notifications, and robust dispute resolution system built on Base.
Table of Contents
System Overview
JumpMarket is a secure, escrow-based marketplace built on the Base network where all transactions are conducted using $JUMPBOX.ETH tokens. The system provides complete buyer and seller protection through smart contract-based escrow, automated email notifications, and a robust dispute resolution system. Every transaction is protected by multiple layers of security and verification.
Smart Contract Escrow
Funds secured in auditable smart contract with immutable protection
Email Notifications
Complete order lifecycle tracking with automated updates
Base Network
Low gas fees and fast transactions on Coinbase L2
Token-Gated Access
Requires 100M+ $JUMPBOX.ETH tokens for participation
Key Features
- • Zero-Trust Security with multi-layer validation and cryptographic verification
- • Participant-only access for each order with strict identity verification
- • Real-time updates across all touchpoints including email and platform notifications
- • Automated dispute resolution system with clear timelines and procedures
- • Complete audit trail of all transactions stored immutably on-chain
- • Integration with clanker tokens for expanded payment options
Core Architecture
Technical Stack
- Blockchain: Base (Coinbase Layer 2)
- Token Standard: $JUMPBOX.ETH ERC-20 token
- Database: Supabase PostgreSQL with RLS
- Email Service: Resend API for notifications
- Frontend: Next.js with wagmi/viem integration
- Smart Contracts: Solidity with OpenZeppelin libraries
System Components
Smart Contract Layer
Handles fund escrow, order state management, and automated releases
Database Layer
Tracks order metadata, user profiles, and service listings
Email Service Layer
Automated notifications for all order events and updates
Frontend Layer
User interface for buyers, sellers, and order management
Data Flow Architecture
User Actions
Frontend captures user interactions and validates them before submission
Smart Contract
Processes transactions, manages escrow, and enforces business rules
Notifications
Database updates trigger email notifications to relevant parties
Order Flow Process
Order Created
Order has been created and both parties have been notified via email with complete order details
Email Notifications Sent:
- • Buyer receives order confirmation with requirements summary
- • Seller receives new order notification with buyer details
- • Both parties get next steps guidance and timeline information
Funds Escrowed
Buyer has deposited funds into smart contract escrow and seller is notified to begin work
Security Features Active:
- • Funds locked in smart contract escrow
- • Only buyer and seller can interact with this order
- • Automatic refund protection if deadline passes
Work Started
Seller has confirmed work has started and delivery timeline is now active
Delivery Submitted
Seller has submitted completed work for review and buyer has 7 days to approve or dispute
Order Completed
Buyer has approved work and payment has been released to seller automatically
Security at Every Step
Every step in the order flow is protected by smart contract validations, email confirmations, and database consistency checks. Funds can only move through the designated escrow paths, ensuring complete security for both parties. The system maintains a complete audit trail of all actions and state changes.
Buyer Experience
Protection Benefits
- Funds completely secure in smart contract escrow with immutable protection
- 7 days to review all delivered work with dispute resolution available
- Dispute resolution system for unsatisfactory deliveries with platform mediation
- Auto-refund if seller doesn't deliver by agreed deadline
- Email notifications for every order status change and update
- Complete transparency with blockchain-verified transactions
Your Responsibilities
- Provide clear, detailed requirements when ordering services
- Have sufficient $JUMPBOX.ETH balance (price + 2.5% platform fee + gas)
- Review delivered work within 7-day dispute window
- Communicate clearly if issues arise during delivery
- Approve token spending for escrow contract before ordering
- Maintain valid email address for order notifications
Buyer Tips for Success
Writing Requirements
Be as specific as possible in your requirements. Include examples, references, deadlines, and any special considerations. The more detail you provide upfront, the better the seller can deliver exactly what you need.
During Delivery
Stay engaged during the delivery process. Respond promptly to seller questions and provide feedback when requested. This helps ensure the final delivery meets your expectations.
Seller Experience
Payment Guarantees
- Payment is guaranteed once funds are escrowed in smart contract
- Auto-payment release if no disputes raised within 7 days
- Protection against unfair payment disputes with platform mediation
- Instant payment release upon buyer approval
- Complete protection from chargebacks or payment reversals
- Immutable record of work requirements and delivery proof
Your Responsibilities
- Review order requirements carefully before accepting
- Deliver work by the agreed deadline with quality standards
- Provide clear delivery messages and comprehensive documentation
- Communicate proactively about progress and any potential issues
- Use platform tools to update order status and track delivery
- Maintain professional standards and responsive communication
Seller Tips for Success
Order Management
Always confirm work has started using the platform's "Start Work" button - this notifies the buyer and starts the delivery timeline. Keep buyers updated on progress and ask questions early if requirements are unclear.
Delivery Best Practices
When submitting your delivery, include detailed explanations of what you've completed and how it meets the requirements. Provide all necessary files, documentation, and usage instructions.
Email Integration System
Automated Notification System
JumpMarket features a comprehensive email notification system that keeps both buyers and sellers informed throughout the entire order lifecycle. Email notifications are sent automatically for every major order event, ensuring both parties always know the current status and next steps.
Email Triggers
- Order Created - Both parties notified
- Funds Escrowed - Seller can start work
- Work Started - Buyer notified of progress
- Delivery Submitted - Buyer review required
- Order Completed - Payment released
- Dispute Raised - Platform mediation begins
Email Features
- Personalized content for buyers vs sellers
- Transaction hash links to BaseScan explorer
- Clear next steps guidance and timelines
- Complete order details and status updates
- Professional branded templates with Jumpbox branding
- Mobile-responsive design for all email clients
Email Requirements
Valid Email Address
Users must have valid email addresses in their profiles to receive notifications
Spam Folder Check
Check spam folders if emails are not received and whitelist jumpbox.tech domain
Email Preferences
Critical order notifications cannot be disabled for security and legal protection
Email Content Examples
Order Created
"Your order for [Service] has been created. Next step: Deposit funds to escrow."
Work Started
"[Seller] has started work on your order. Estimated completion: [Date]."
Delivery Submitted
"Your order has been delivered. Please review within 7 days."
Smart Contract Security
Participant-Only Access
Only the specific buyer and seller can interact with their order through cryptographic verification
Exact Amount Verification
Every token transfer is verified before and after to ensure exact amounts with zero tolerance for errors
Immutable Fund Protection
Escrowed funds can only be released through designated smart contract functions with multiple validation layers
Cryptographic Integrity
Requirements and delivery proofs are hashed and stored on-chain for tamper-proof records
Zero-Trust Security Model
The JumpMarket escrow contract operates on a zero-trust, participant-only security model. Every function has multiple layers of validation, and only the buyer and seller of each specific order can interact with their funds. The system assumes no trust between parties and enforces all rules through immutable smart contract logic.
Immutable Funds
Once deposited, funds can only be released through three designated paths: work approval, dispute resolution, or order cancellation. No other mechanism can access escrowed funds.
State Machine Logic
Orders follow strict state progression with validation at each step. Functions only work in valid states, preventing manipulation and ensuring proper order flow.
Access Controls
Multiple modifier layers ensure only authorized participants can interact with specific orders. Each function verifies caller identity and permissions.
Contract Audit & Verification
Security Measures
- • OpenZeppelin security libraries and patterns
- • Reentrancy guards on all external calls
- • Integer overflow protection with SafeMath
- • Comprehensive event logging for transparency
- • Emergency pause functionality for critical issues
Verification
- • Contract source code verified on BaseScan
- • Public audit trail of all transactions
- • Open source for community review
- • Comprehensive test coverage with edge cases
- • Gas optimization for cost efficiency
Important Gotchas
Minimum Token Requirements
Both buyers and sellers must hold 100M+ $JUMPBOX.ETH tokens to participate in marketplace activities
Gas Fee Requirements
You need sufficient ETH for gas fees even though payments are in $JUMPBOX.ETH tokens (Base network fees)
Email Dependency
Email notifications require valid email addresses in user profiles for order lifecycle updates
Dispute Window
Buyers have only 7 days after delivery to raise disputes, after which payment auto-releases
Token Approval Required
Buyers must approve the escrow contract to spend tokens before creating orders
Critical Reminders
Before Using the System
- • Always test with small amounts first
- • Ensure you understand token approval process
- • Have sufficient ETH for gas fees
- • Verify your email address works
- • Read and understand dispute resolution process
During Orders
- • Keep email notifications enabled
- • Respond promptly to communications
- • Document all important communications
- • Report issues immediately to support
- • Follow platform guidelines and terms
Technical Specifications
Contract Details
Troubleshooting
Transaction Failed - Insufficient Funds
This usually means you don't have enough ETH for gas fees, even though you're paying in $JUMPBOX.ETH tokens. Base network requires ETH for transaction fees.
Solution:
- • Ensure you have at least 0.001 ETH in your wallet for gas fees
- • Check current Base network gas prices on BaseScan
- • Try again during lower network congestion periods
- • Consider increasing gas limit if using advanced wallets
Token Approval Not Working
If the token approval transaction isn't showing up or failing, this can be caused by wallet connectivity issues or insufficient gas.
Solution Steps:
- • Refresh the page and reconnect your wallet
- • Clear browser cache and try again
- • Disconnect and reconnect wallet in wallet app
- • Try increasing gas limit manually (advanced users)
- • Switch to a different wallet if problem persists
Email Notifications Not Received
Email notifications require a valid email address in your user profile and proper email delivery settings.
Troubleshooting Steps:
- • Update your profile with a valid email address
- • Check your spam/junk folder for jumpbox.tech emails
- • Add jumpbox.tech to your email whitelist
- • Verify email delivery by testing with a different address
- • Contact support if emails still not received after 5 minutes
Can't Create Orders - Minimum Token Requirement
Both buyers and sellers must hold at least 100M $JUMPBOX.ETH tokens to participate in marketplace activities.
Solutions:
- • Acquire more $JUMPBOX.ETH tokens through DEX exchanges
- • Check token balance displays correctly in your wallet
- • Ensure tokens are on Base network, not other chains
- • Wait for token balance to be detected (may take a few minutes)
- • Contact support if balance shows incorrectly on platform
Order Status Not Updating
Sometimes order status updates may be delayed due to blockchain confirmation times or database synchronization.
Resolution:
- • Wait 2-3 minutes for blockchain confirmations
- • Refresh the page to check for updates
- • Check transaction hash on BaseScan for confirmation
- • Clear browser cache if status appears stuck
- • Contact support if status doesn't update after 10 minutes
When to Contact Support
Immediate Support Needed
- • Funds stuck in escrow beyond normal timeframe
- • Email notifications completely stopped
- • Order status stuck for more than 1 hour
- • Unable to access account or orders
- • Suspected security issues or unauthorized access
Contact Information
- • Discord: #support in official Jumpbox server
- • Email: support@jumpbox.tech
- • Twitter: @_seehad (DM for urgent issues)
- • Platform: Use in-app support chat when available
- • Response time: Usually within 24 hours
Ready to Start Trading?
Questions about the system? Check out our community channels or contact our support team for assistance.