SAMPLED

Sampled The Decentralized Sample Marketplace Where Producers Get Paid Instantly on Stellar

Sampled showcases why Stellar beats Ethereum for marketplaces: instant payments, negligible fees, and real-time settlement. I chose samples because producers feel the pain of slow payments most acutely. But this same architecture works for any digital commerce. Sampled isn't just a marketplace - it's a movement. Every interaction should feel like you're part of the culture. Getting Sampled isn't just selling a beat, it's validation. It's success. It's making it.

Sampled leverages Stellar's speed and low costs to create a peer-to-peer sample marketplace with:

Core Features Implemented:

✅ Instant Payments: 5-second finality with Stellar, producers get paid immediately
✅ 90/10 Revenue Split: Only 10% platform fee vs. industry standard 30-50%
✅ Smart Contract Automation: No intermediaries, no lawyers, no waiting
✅ IPFS Storage: Decentralized file storage ensures content permanence
✅ Commercial Licensing: Automatic license generation with each purchase
✅ Freighter Wallet Integration: Seamless Web3 experience using Stellar Wallet Kit

Technical Implementation:

• Smart Contract: Rust-based Soroban contract handling listings, purchases, and withdrawals
• Frontend: React + TypeScript with Vite, showcasing Scaffold Stellar's rapid development
• Storage: IPFS integration for audio files with on-chain metadata
• Payments: Native XLM transactions with automatic fee splitting

🏗️ Scaffold Stellar Integration

Our submission demonstrates the three key requirements:

1. Deployed Smart Contract

 pub fn __constructor(env: Env, platform_fee: u32, platform_address: Address) {
        let storage = env.storage().instance();
        if storage.has(&PLATFORM_ADDRESS_KEY) {
            panic!("Contract already exists");
        }

        storage.set(&PLATFORM_ADDRESS_KEY, &platform_address);
        storage.set(&PLATFORM_FEE_KEY, &platform_fee);
        storage.set(&TOTAL_SAMPLES_KEY, &0u32);
        storage.set(&TOTAL_VOLUME_KEY, &0i128);

        log!(
            &env,
            "Sample contract deployed with {}% plaform fee",
            platform_fee
        );
    }

• Contract Address: CA7DGEWWS3VH5J2I4I7FFEB5UHK2MJSYWDKDQKXQM7GDNLI2IRATDTLG
• Network: Stellar Testnet
• Written in Rust, compiled to WASM

2. Modern Frontend

• Built with Scaffold Stellar's TypeScript + React template
• Responsive UI with real-time wallet balance updates
• Glassmorphism design inspired by modern Web3 aesthetics
• Component-based architecture for scalability

3. Stellar Wallet Kit Integration

• Freighter wallet connection
• Transaction signing
• Balance display
• Network status indicators

🔧 Technical Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│                 │     │                  │     │                 │
│  React Frontend │────▶│ Soroban Contract │────▶│   IPFS Storage  │
│   (TypeScript)  │     │     (Rust)       │     │    (Pinata)     │
│                 │     │                  │     │                 │
└─────────────────┘     └──────────────────┘     └─────────────────┘
        │                        │                         │
        └────────────────────────┴─────────────────────────┘
                                 │
                        ┌────────▼────────┐
                        │                 │
                        │ Stellar Network │
                        │   (Testnet)     │
                        │                 │
                        └─────────────────┘

Smart Contract Functions:

• upload_sample() - List new samples with metadata
• purchase_sample() - Buy samples with automatic payment splitting
• withdraw_earnings() - Producers withdraw accumulated earnings
• get_sample() - View sample details
• get_earnings() - Check withdrawable balance
• get_stats() - Platform statistics

Tech Stack:

• Blockchain: Stellar (Soroban smart contracts)
• Frontend: React 18, TypeScript, Vite
• Styling: Custom CSS with animations
• Wallet: Freighter via Stellar Wallet Kit
• Storage: IPFS (Pinata gateway)
• Framework: Scaffold Stellar

Scaffold Stellar Frontend

To get started with Scaffold Stellar, visit its repo: github.com/AhaLabs/scaffold-stellar.

Under active development.

A modern, up-to-date toolkit for building Stellar smart contract frontends.

• ⚡️ Vite + React + TypeScript
• 🔗 Auto-generated contract clients
• 🧩 Example components for contract interaction
• 🛠 Hot reload for contract changes
• 🧪 Easy local/testnet deployment

This is the starter frontend generated by stellar scaffold init. See more at Scaffold Stellar.

Requirements

Before getting started, make sure you’ve met the requirements listed in the Soroban documentation and that the following tools are installed :

• Rust
• Cargo (comes with Rust)
• Rust target: install the compilation target listed in the Soroban setup guide
• Node.js (v22, or higher)
• npm: Comes with the node installer or can also be installed package managers such as Homebrew, Chocolatey, apt, etc.
• Stellar CLI
• Scaffold Stellar CLI Plugin

Quick Start

To get started with a fresh Scaffold Stellar project, follow the steps below:

1. Initialize a new project:

stellar scaffold init my-project
cd my-project

2. Set up your development environment:

# Copy and configure environment variables like network and STELLAR_SCAFFOLD_ENV
cp .env.example .env

# Install frontend dependencies
npm install

Have a look at environments.toml for more fined-grained control.

3. Start development environment:

npm run dev

Open the server URL in your web browser.

4. For testnet/mainnet deployment:

When you are ready for testnet, you need to deploy your contract using stellar registry. Some commands to get you started.

#  Note --source-account argument is omitted for clarity

# First publish your contract to the registry
stellar registry publish

# Then deploy an instance with constructor parameters
stellar registry deploy \
  --deployed-name my-contract \
  --published-name my-contract \
  -- \
  --param1 value1

# Can access the help docs with --help
stellar registry deploy \
  --deployed-name my-contract \
  --published-name my-contract \
  -- \
  --help

# Install the deployed contract locally
stellar registry create-alias my-contract

Scaffold Initial Project Structure

When you run stellar scaffold init, it creates a frontend-focused project structure with example contracts:

my-project/                      # Your initialized project
├── contracts/                   # Example smart contracts
├── packages/                    # Auto-generated TypeScript clients
├── src/                         # Frontend React application
│   ├── components/              # React components
│   ├── contracts/               # Contract interaction helpers
│   ├── debug/                   # Debugging contract explorer
│   ├── hooks/                   # Custom React hooks
│   ├── pages/                   # App Pages
│   ├── App.tsx                  # Main application component
│   └── main.tsx                 # Application entry point
├── target/                      # Build artifacts and WASM files
├── environments.toml            # Environment configurations
├── package.json                 # Frontend dependencies
└── .env                         # Local environment variables

This template provides a ready-to-use frontend application with example smart contracts and their TypeScript clients. You can use these as reference while building your own contracts and UI. The frontend is set up with Vite, React, and includes basic components for interacting with the contracts.