dollar-platoon

Peer-to-peer task payroll marketplace on Base L2. Clients create USDC-funded gigs, distribute tasks to gigworkers via email/webhook mailboxes, review proofs of work, and pay out on-chain. Reputation-driven with no dispute resolution. Use when: (1) Creating or joining gigs, (2) Submitting or reviewing proofs, (3) Managing wallets and payouts, (4) Understanding pricing or marketplace dynamics, (5) Integrating via webhook or public submit link. Triggers: dollar platoon, gig payroll, micro-gig, proof review, rollup payout, volunteer mailbox, task distribution, reputation system, treasury contract, recommended prices, how it works.

# Dollar Platoon

## What Is Dollar Platoon?

Peer-to-peer task payroll on Base L2. Reputation-driven marketplace for high-volume, low-ticket work.

Create micro-gigs, distribute tasks to gigworkers, collect proofs, and pay out USDC on Base L2. No contracts, no overhead, no dispute resolution — reputation is the sole enforcement mechanism.

### For Clients

Scale your workforce instantly. Create gigs, distribute tasks to gigworkers, review proofs, and pay out USDC on Base L2.

- **Create Gigs** — Post tasks with USDC funding. Set price per proof, review timeouts, and distribution mode.
- **Review Proofs** — Approve or reject submissions with a single click. Auto-approve after timeout protects gigworkers.
- **Track Payouts** — Monitor funds, trigger payouts, and view on-chain transaction history.

### For Gigworkers

Earn USDC doing tasks. Browse gigs, join ones that match your skills, submit proofs of work, and get paid automatically on Base L2. Build your reputation as you go.

- **Find Work** — Browse the marketplace for gigs that match your skills. Filter by tags and earning potential.
- **Submit Proofs** — Complete tasks, submit evidence, and track your submissions across all your mailboxes.
- **Build Reputation** — Every approved proof builds your on-chain reputation across Volume, Quality, and Social dimensions.

---

## How It Works

Peer-to-peer task payroll on Base L2. Read this before creating or joining a gig.

### Overview

Dollar Platoon is a permissionless, composable on-chain marketplace for micro-gig work. Clients create gigs and fund them with USDC on Base L2. Gigworkers join gigs, receive tasks, submit proofs of completed work, and get paid automatically when proofs are approved.

The platform is designed for high-volume task payroll with no upper limit on price. There is no dispute resolution. Reputation is the sole enforcement mechanism.

**The basic flow:**

1. Client creates a gig with terms, price per task, and USDC funding
2. Gigworkers join and receive a personal mailbox
3. Tasks are distributed to mailboxes via email or webhook
4. Gigworkers submit proofs of completed work
5. Client reviews and approves/rejects proofs (or auto-approve after timeout)
6. Approved proofs trigger USDC payouts on Base L2

### Wallets & Gas

Every user on Dollar Platoon has their own on-chain wallet on Base L2 (an Ethereum Layer 2 network). This wallet holds your USDC (for gig payments) and a small amount of ETH (for gas fees to process transactions).

**Your responsibility:** Fund your wallet with ETH for gas on the Base network. Without ETH, your wallet cannot send transactions (deposits, transfers, or payouts). You typically need only ~0.001 ETH to cover many transactions.

**Key Points:**

- **Gas fees:** Every on-chain action requires a small ETH gas fee. Base L2 fees are typically fractions of a cent.
- **Managed vs External:** Dollar Platoon can generate a managed (hot) wallet with encrypted key storage. Alternatively, link your own external wallet for full self-custody.
- **No recovery:** If you lose access to an external wallet's private keys, those funds are permanently lost. Managed wallets are recoverable through your Dollar Platoon account.

### Reputation System

Reputation is wallet-anchored, multi-dimensional, and event-sourced. Every action generates immutable reputation events tied to wallet addresses. Both clients and gigworkers have reputation.

**Dimensions:**

- **Volume** — Total USDC earned (gigworker) or paid out (client). The most basic measure of activity and trust.
- **Quality** — Approval rate weighted by rejection severity. Fake proofs damage quality 5x more than low-quality work.
- **Recency** — Decay function penalizing inactivity. Recent participants are more trustworthy than dormant ones.
- **Social** — Aggregate star rating from counterparty reviews, weighted by dollar amount exchanged in each gig.

**Key Features:**

- **Wallet-anchored:** Reputation is tied to wallet addresses, not user accounts. Different wallets per gig means independent reputation histories.
- **Permissionless:** Anyone can create a wallet and participate. Reputation must be earned.
- **Gig gating:** Clients can set minimum reputation thresholds (min volume, min quality, min recency) to exclude low-reputation wallets.
- **Informational only:** Reputation indicators are provided as informational aids. They carry no warranty of accuracy.

### Smart Contract & Payments

Dollar Platoon uses a single treasury smart contract deployed on Base L2. The contract handles USDC deposits and payouts. All business logic (reputation, distribution, proof review) lives off-chain.

**Fee Structure:**

| Event | Fee | Detail |
|-------|-----|--------|
| Client deposits USDC | 0% | No deposit fee |
| Gigworker payout | 10% on top | Worker receives full gross; 10% charged additionally from gig balance |

Example: Worker earns $10 → contract charges $11 total ($10 to worker, $1 platform fee).

**Key Features:**

- **Fund isolation:** Each gig has its own on-chain balance. One gig's funds cannot pay out another.
- **No withdrawal:** Once deposited, funds are locked in the gig. No withdrawal function exists.
- **Price lock:** Price per task is locked at the moment of proof submission, protecting gigworkers from mid-gig price changes.
- **Auto-approve timeout:** If a client does not review a proof within the review timeout period, the proof is automatically approved.
- **Minimum payout:** Configurable per gig (default $0). Smaller amounts accumulate until threshold is met.
- **No debt:** Gigs cannot go into debt. Rollups pre-check available_funds before payout.

### Security Tokens

Every gig has a 6-character alphanumeric security token embedded in its email address and webhook URL. This prevents unauthorized submissions from anyone who discovers or guesses a gig ID.

**How it works:**

- **Email:** `{gig_id}_{token}.staging.dollar-platoon@fwd.zoomgtm.com`
- **Webhook:** `/inbound/webhook/{gig_id}?token={token}`
- Inbound requests without a valid token are rejected with 403
- Tokens are generated automatically on gig creation
- Owners can rotate tokens via the dashboard or `POST /gigs/:id/rotate-token`
- Rotating a token invalidates the old email address and webhook URL — update all integrations after rotating
- **Backward compatibility:** Existing gigs without a security token will accept all inbound requests. Generate a token from the dashboard to enable protection.

### Third-Party Publisher Apps

Dollar Platoon does not control task content or delivery. Tasks are generated and delivered by third-party publisher apps (or manually by clients). Every gig generates a token-protected inbound email address and webhook URL. Publisher apps send tasks to these endpoints, and Dollar Platoon distributes them to gigworker mailboxes.

Dollar Platoon has no control over what publisher apps send. Clients are solely responsible for selecting and configuring their publisher apps. Gigworkers should review gig terms carefully before joining.

### Composability & Flexible Workflow

Dollar Platoon handles only the payroll layer: distribution, proof collection, reputation, and payment. Everything else is pluggable:

- **Task generation:** Use any publisher app, email client, or manual workflow
- **Task delivery:** Email forwarding, webhook forwarding, or both
- **Proof validation:** Manual client review, webhook-based automation, AI agents, or timeout auto-approval
- **Distribution modes:** Round robin, random, priority weighted, free-for-all, FIFO queue, or inbound proof
- **Reputation gating:** Set minimums per gig or leave open to all

### Trust & Validation

Trust is earned, not granted. The reputation system provides signals but not guarantees.

**For clients:** Review proofs carefully. Use rejection tags to flag bad work. Set reputation thresholds to filter applicants. Configure proof webhooks for automated validation. Consider requiring member approval for new joiners.

**Fo