TrustCart 🛒

The trustless marketplace for digital goods and services — every transaction backed by Soroban escrow.

---

Overview

TrustCart is a peer-to-peer marketplace where every transaction is protected by a Soroban smart contract escrow — no platform holding your money, no chargebacks, no middlemen taking 20%. Buyers pay into escrow. Sellers deliver. Funds release on confirmation.

For the first time, anyone can sell digital goods or services globally and get paid in USDC without trusting a centralized platform.

---

The Problem

The platforms built to help creators and freelancers get paid are now their biggest tax:

• Fiverr takes 20% of every transaction
• PayPal freezes accounts arbitrarily, holds funds for 180 days
• Gumroad takes 10% plus payment processing
• No platform lets you get paid globally in stablecoins without KYC overhead

Meanwhile, buyers have no protection in peer-to-peer transactions without trusting the platform as an intermediary — who charges for that privilege.

---

The Solution

TrustCart replaces the platform intermediary with a Soroban smart contract. The contract holds funds, enforces delivery conditions, and releases payment — without anyone's permission and without taking a cut beyond the Stellar network fee.

Buyer posts order  →  USDC locked in Soroban escrow
Seller delivers    →  Buyer confirms receipt
                   →  Escrow releases USDC to seller instantly
                   →  Or dispute opens if buyer raises issue

Platform fee: 1% flat. The contract takes 1% on release to fund protocol development. Everything else goes to the seller.

---

What You Can Buy and Sell

Digital Products

• Design assets (Figma files, icon packs, UI kits)
• Code templates, plugins, boilerplates
• eBooks, guides, and courses
• Stock photos and video assets
• Music and audio files

Freelance Services

• Smart contract development
• Design and branding work
• Writing and copywriting
• Consulting sessions
• Code reviews and audits

Subscriptions and Access

• Community access passes
• Ongoing retainer arrangements (milestone-based)
• API access and SaaS licenses

---

How the Escrow Works

Standard Purchase Flow

1. Buyer browses listing → adds to cart → initiates purchase
2. Buyer deposits USDC into escrow contract (includes 1% fee)
3. Seller is notified → delivers the goods or service
4. Buyer confirms delivery → escrow releases USDC to seller
5. Both parties leave on-chain reviews

Dispute Resolution Flow

If buyer disputes within delivery window:
→ Dispute contract opens a 72-hour resolution window
→ Seller submits proof of delivery
→ Buyer submits reason for dispute
→ If no resolution: community arbitrator panel votes
→ Funds released or refunded based on outcome

Contract States

PENDING   → Buyer has initiated, waiting for deposit
LOCKED    → USDC held in escrow, seller notified
DELIVERED → Seller marked as delivered, waiting buyer confirm
RELEASED  → USDC sent to seller ✅
DISPUTED  → Buyer opened dispute, resolution pending
REFUNDED  → Buyer received USDC back ↩
EXPIRED   → Delivery window passed, auto-refund triggered

---

Smart Contract Interface

// Initialize a new escrow for a purchase
fn create_escrow(
    env: Env,
    buyer: Address,
    seller: Address,
    amount: i128,
    delivery_deadline: u64,
    item_hash: BytesN<32>,   // IPFS hash of item description
) -> EscrowId;

// Buyer confirms delivery — releases funds to seller
fn confirm_delivery(env: Env, buyer: Address, escrow_id: u64);

// Seller marks item as delivered
fn mark_delivered(env: Env, seller: Address, escrow_id: u64, proof_hash: BytesN<32>);

// Buyer opens a dispute
fn open_dispute(env: Env, buyer: Address, escrow_id: u64, reason: String);

// Auto-refund if deadline passes without delivery
fn claim_refund_expired(env: Env, buyer: Address, escrow_id: u64);

// Get full escrow state
fn escrow_info(env: Env, escrow_id: u64) -> EscrowInfo;

---

Listing a Product

import { TrustCartSDK } from '@trustcart/sdk';

const cart = new TrustCartSDK({ network: 'mainnet' });

// Create a listing
const listing = await cart.createListing({
  title: 'Soroban Smart Contract Template Pack',
  description: 'Production-ready templates for escrow, token, and multisig contracts.',
  price: '49.00',          // USDC
  currency: 'USDC',
  category: 'code',
  deliveryMethod: 'download',
  deliveryWindow: 86400,   // 24 hours (in seconds)
  files: ['./templates.zip'],  // Uploaded to IPFS
});

console.log(`Listed: ${listing.id} | URL: ${listing.url}`);

---

Seller Dashboard

TrustCart gives sellers full visibility into their business:

• Active Escrows: Live view of all pending transactions and their states
• Earnings: Total released, pending, and disputed amounts in USDC
• Delivery Queue: Orders awaiting fulfillment with countdown timers
• Review Score: On-chain reputation built from confirmed transactions
• Payout History: Every payment is a Stellar transaction with a permanent receipt

---

On-Chain Reputation

Every completed transaction adds to a seller's on-chain reputation score stored in a Soroban contract. Reputation cannot be deleted, transferred, or faked. Buyers can verify seller history directly from the contract before purchasing.

Seller Address: GXXX...
Completed Transactions: 147
Average Rating: 4.91 / 5
Dispute Rate: 0.7%
Total Volume: 12,450 USDC
Member Since: Stellar Ledger #48,291,000

---

Getting Started

For Sellers

# 1. Connect Freighter wallet
# 2. Create your seller profile
# 3. List your first product (free)
# 4. Share your store link
# 5. Get paid in USDC

For Developers

git clone https://github.com/your-org/trustcart
cd trustcart

# Install dependencies
npm install

# Set up environment
cp .env.example .env

# Build Soroban contracts
cd contracts
cargo build --target wasm32-unknown-unknown --release

# Deploy contracts to testnet
./scripts/deploy-testnet.sh

# Start frontend
cd ../frontend
npm run dev

---

Roadmap

v1.0 — Beta (Current)

• Digital product listings
• Soroban escrow for all purchases
• Dispute resolution (arbitrator panel)
• On-chain reputation

v1.1

• Service listings with milestone payments
• Seller storefronts with custom URLs
• Buyer/seller messaging (encrypted)
• IPFS file delivery integration

v2.0

• Subscription and recurring payments
• Physical goods with shipping confirmation
• DAO governance for arbitrator selection
• TrustCart token for fee discounts and governance

---

Contributing

TrustCart needs contributors across smart contract development, frontend React, dispute resolution logic, IPFS integration, and UX design.

See CONTRIBUTING.md for open issues. Good first issues are labeled — no prior blockchain experience required for frontend contributions.

---

License

MIT © TrustCart Contributors

---

TrustCart smart contracts are unaudited. Use at your own risk during beta. Audit scheduled before mainnet v1.0 launch.