Documentation
Build the Future,
Get Paid Instantly.

Stallion is a decentralized bounty platform and talent pipeline. Find bounties, hackathons, gigs, and jobs โ€” or post them. All settled on-chain, instantly.

$2M+
Value Distributed
Directly to contributor wallets.
< 5s
Settlement Time
From approval to payment.
60+
Countries
Earning without borders.

What you can find on Stallion

๐ŸŽฏ

Bounties

Time-boxed tasks with fixed rewards. Complete the brief, get paid on-chain.

โšก

Hackathons

Competitive build events with prize pools. Build fast, ship something real.

๐Ÿ’ผ

Gigs

Short-term freelance work. Scope defined, payment agreed upfront.

๐Ÿข

Jobs

Full-time and part-time roles posted by Web3 teams and companies.

Built on

Soroban Smart Contracts Stellar Network NestJS Next.js PostgreSQL Redis + BullMQ USDC XLM EURC USDGLO

What is Stallion?

Stallion is a decentralized bounty platform and talent pipeline built on the Stellar blockchain. It connects builders, designers, writers, and developers with opportunities โ€” bounties, hackathons, gigs, and jobs โ€” while giving companies and DAOs a verified, on-chain way to source and pay talent.

Two sides of the platform

๐ŸŽฏ Contributor

You find and complete opportunities. You get paid directly to your Stellar wallet โ€” no invoices, no intermediaries.

  • Browse bounties, hackathons, gigs, and jobs
  • Apply, submit work, and get paid on-chain
  • Build a verified on-chain CV over time
  • Earn points and grow your reputation
โœ๏ธ Creator

You post opportunities and source talent. Funds are escrowed on-chain so contributors know payment is guaranteed.

  • Post bounties, hackathons, gigs, and jobs
  • Review submissions and select winners
  • Access a verified talent pipeline
  • Pay instantly via smart contract

Who builds on Stallion?

Stallion is built for contributors of all kinds across the Stellar and broader Web3 ecosystem:

Developers Designers Writers Content Creators Community Managers Marketers Researchers DAOs Web3 Startups Protocols

Supported tokens

TokenSymbolStatus
USD CoinUSDCLive
Stellar LumensXLMLive
Euro CoinEURCLive
USD GloUSDGLOLive

Create an Account

Getting started takes about 3 minutes. Choose your role, register with your email, set up two-factor authentication, and you're ready.

โš ๏ธ

MFA is mandatory. Every Stallion account requires TOTP two-factor authentication. You cannot complete registration without it.

Step 1 โ€” Choose your role

The first thing you do at registration is select your role. This shapes what you see on the platform:

๐ŸŽฏ Contributor

Choose this if you want to earn โ€” by completing bounties, entering hackathons, taking gigs, or applying for jobs.

โœ๏ธ Creator

Choose this if you want to post opportunities, source talent, and pay contributors on-chain.

โ„น๏ธ

You can only select one role at registration. If you need to switch or access both sides, contact admin@stallion.so.

Step 2 โ€” Register

1

Go to Sign Up

Visit stallion.so, click Sign Up, select your role, then enter your email and a strong password.

2

Scan the QR code

Open your authenticator app (Google Authenticator, Authy, etc.) and scan the QR code shown on screen.

3

Enter your 6-digit code

Type the rotating code from your app to confirm MFA setup. Codes refresh every 30 seconds.

4

Save your backup codes

You'll receive 10 backup codes. Store them safely โ€” they're your only recovery option if you lose your authenticator app.

5

You're in

Your account is live. Start browsing opportunities or set up your profile.

Logging in

Every login requires your email, password, and a 6-digit TOTP code from your authenticator app.

๐Ÿ’ก

If your code isn't accepted, check that your phone's clock is synced โ€” TOTP codes are time-sensitive and expire every 30 seconds.

Setting Up MFA

Stallion uses TOTP (Time-based One-Time Password) as a mandatory second factor on every account. Here's how to get set up in minutes.

Recommended apps

AppPlatformNotes
Google AuthenticatoriOS / AndroidSimple and widely used
AuthyiOS / Android / DesktopSupports multi-device sync and backups
1PasswordiOS / Android / DesktopIntegrated with your password manager
Microsoft AuthenticatoriOS / AndroidGreat for enterprise devices

Scanning the QR code

  1. Open your authenticator app and tap Add account or +.
  2. Select Scan QR code and point your camera at the code on the Stallion registration screen.
  3. The app adds a Stallion entry with a rotating 6-digit code.
  4. Enter that code on Stallion to confirm setup.

Backup codes

Stallion generates 10 single-use backup codes when MFA setup completes. Use these to log in if you ever lose access to your authenticator app.

๐Ÿšจ

Store your backup codes offline. In a password manager, printed, or written down. Losing both your authenticator and backup codes means losing account access permanently.

Lost your authenticator app?

On the login screen, click Use a backup code. Once in, go to Settings to re-link a new authenticator app. If you've lost both, email admin@stallion.so for manual recovery.

Wallet & Payments

Every Stallion account has a built-in custodial wallet. Rewards land here automatically. Withdraw to any Stellar wallet whenever you're ready.

Your wallet

Go to Wallet in the navigation to see your balance across all supported tokens and your full transaction history.

Receiving rewards

When you win a bounty, hackathon prize, or complete a gig, the Soroban smart contract processes your payout automatically. Funds appear in your Stallion wallet โ€” no action needed from you.

โ„น๏ธ

Payouts are handled by background job workers (BullMQ) and typically settle in under 5 seconds.

Withdrawing funds

1

Go to Wallet โ†’ Withdraw

Enter the amount and your destination Stellar wallet address.

2

Confirm with TOTP

Withdrawals require your 6-digit authenticator code to authorise.

3

Done

Funds are sent to your Stellar wallet. Track them in your history or on the Stellar explorer.

Supported tokens

TokenSymbolNetworkStatus
USD CoinUSDCStellarLive
Stellar LumensXLMStellarLive
Euro CoinEURCStellarLive
USD GloUSDGLOStellarLive

Bounties

Bounties are time-boxed tasks with a fixed reward pool. A creator defines the work, locks the funds in escrow, and contributors race to deliver the best result.

Bounty statuses

Active

Open for applications. Submit your work before the deadline.

In Review

Deadline has passed. The creator is reviewing submissions.

Completed

Winners selected. Rewards distributed on-chain.

Creating a bounty

Go to Create โ†’ Bounty and fill in:

โ„น๏ธ

Once created, the reward is locked in smart contract escrow. The reward amount cannot be reduced after funding.

Multi-winner payouts

Rewards can be split across multiple winners. Assign each a percentage totalling 100%. Example: 500 USDC โ†’ 1st 60% (300 USDC), 2nd 40% (200 USDC).

Hackathons

Hackathons are competitive, time-limited build events with prize pools. Teams or individuals build a project around a theme or problem statement and compete for rewards โ€” all settled on-chain.

How hackathons work

1

A hackathon is announced

The creator sets the theme, rules, prize pool, start and end dates, and eligibility criteria.

2

You register to participate

Sign up for the hackathon individually or as a team before the registration deadline.

3

Build during the event window

Work on your project within the hackathon timeframe. Collaborate, iterate, and ship.

4

Submit your project

Before the submission deadline, submit your project with a demo, repo link, and description.

5

Judging and prizes

Judges (or community voting) determine winners. Prize pool is distributed on-chain to the winning teams.

Hackathon vs Bounty

BountyHackathon
FormatIndividual taskCompetitive build event
DurationDays to weeksDays to months
TeamSoloSolo or team
Winners1 or more, creator picksRanked prizes, judged
PaymentFixed reward, escrowedPrize pool, distributed on-chain
โšก

Hackathons are a great way to build your on-chain CV fast โ€” shipping a real project under competitive conditions signals a lot to future employers and clients on Stallion.

Projects

Projects on Stallion cover two types of paid work: Gigs (short-term freelance tasks assigned to one contributor) and Jobs (ongoing full-time or part-time roles posted by Web3 teams and companies). Select a type below to learn more.

Gigs are short-term freelance engagements posted by creators who need specific work done quickly. Unlike bounties which are open competitions, a gig is typically assigned to one contributor.

How gigs work

1

Browse open gigs

Filter by skill, token, or duration. Each listing shows the scope, pay rate, and timeline clearly.

2

Apply with your profile

Send an application with your relevant experience. Your on-chain CV gives creators verified proof of your past work.

3

Get selected

The creator reviews applicants and assigns the gig to their chosen contributor.

4

Deliver the work

Complete and submit your deliverable within the agreed timeline.

5

Get paid

On approval, payment is released from escrow directly to your Stallion wallet.

Gig vs Bounty

GigBounty
SelectionCreator picks one personOpen competition, best wins
ScopeDefined upfront, 1-on-1Open brief, multiple submissions
Best forSpecific, scoped tasksCreative or competitive tasks

Applying & Submitting

Whether it's a bounty, hackathon, gig, or job โ€” here's how the application and submission process works on Stallion.

General flow

1

Find an opportunity

Browse by type โ€” bounty, hackathon, gig, or job. Filter by skill, reward size, or deadline.

2

Read the brief carefully

Each listing has specific requirements, deliverables, timelines, and submission criteria. Understand them fully before applying.

3

Apply

Click Apply. Depending on the type, you'll submit your work, a proposal, or your profile.

4

Update before the deadline

For bounties and hackathons, you can revise your submission any time before the deadline. After the deadline, submissions lock.

5

Get selected and paid

If selected, payment is triggered automatically by the smart contract for on-chain opportunities. For jobs, terms are agreed with the employer.

Submission tips

๐Ÿ’ก

One active submission per bounty per user. You can update it before the deadline, but cannot submit multiple separate entries to the same bounty.

Posting Opportunities

As a Creator, you can post bounties, hackathons, gigs, and jobs directly on Stallion. Each type has different settings and payment flows.

What you can post

๐ŸŽฏ

Bounty

Open competition. Reward goes to the best submission.

โšก

Hackathon

Build event with a prize pool. Teams compete over a set window.

๐Ÿ’ผ

Gig

Assign one contributor. Scoped work, payment on delivery.

๐Ÿข

Job

Ongoing role. Full-time or part-time, crypto or fiat comp.

Posting a bounty or gig

Go to Create and select the type. You'll need to provide:

โš ๏ธ

Reward funds are locked in escrow on the Soroban smart contract at the time of posting. You cannot reduce the reward after it's been funded.

Posting a hackathon

Hackathon listings require additional configuration:

Posting a job

Talent Pipeline

Stallion isn't just a place to post tasks โ€” it's a talent discovery engine. Creators can search, filter, and directly reach out to verified contributors based on their on-chain track record.

Why it's different

Traditional hiring relies on self-reported CVs. On Stallion, every contributor's skills and delivery record are verified by the blockchain โ€” you see exactly what they've built, what they've won, and what they've been paid for.

Verified track record

Every bounty win, hackathon placement, and completed gig is permanently recorded on-chain. No inflated CVs.

Filter by skill and reputation

Search contributors by skill type, experience level, and reputation score to find the right person fast.

Direct outreach

Message top contributors directly to offer gigs, jobs, or private bounties without posting publicly.

Emerging regions

Stallion is specifically designed to surface talent from emerging markets โ€” builders and creatives who are underrepresented on traditional hiring platforms.

๐Ÿ”

As a contributor, the best way to be discovered is to consistently complete bounties and hackathons. Every submission you win strengthens your profile and makes you more visible to hiring creators.

Reputation & Points

Every opportunity you complete on Stallion adds to a permanent, blockchain-verified record of your work. This is your On-Chain CV โ€” undeniable proof of your skills to any future employer, partner, or collaborator on the platform.

How points are earned

Why reputation matters

Your Stallion reputation score and history are visible on your public profile. Creators review it when selecting bounty winners, assigning gigs, and shortlisting job applicants. A strong on-chain record is your competitive edge.

โ„น๏ธ

Reputation cannot be purchased or gamed โ€” it is built entirely from real, verified, on-chain completed work.

Smart Contract

Stallion's payment logic runs on a Soroban smart contract deployed on Stellar mainnet. Bounty, hackathon, and gig payments are all handled on-chain โ€” escrowed at creation and released automatically to winners.

What the contract does

Escrow rewards

Locks funds at the time of posting. Creators cannot withdraw them once an opportunity is live.

Record submissions

Logs application and submission events on-chain for full transparency.

Distribute rewards

Automatically pays USDC, XLM, EURC, or USDGLO to winners per the defined split โ€” no intermediaries.

Enforce time-based state

Transitions opportunities through states (Active โ†’ In Review โ†’ Completed) based on deadlines automatically.

Contract architecture

lib.rs
Core contract logic and entry points
storage.rs
On-chain data storage and retrieval
events.rs
On-chain event emission for transparency
types.rs
Data types and enums (BountyStatus, etc.)
utils.rs
Helper functions and validation utilities

Source & verification

๐Ÿ“œ

Mainnet contract address and Soroban explorer verification link are in the stallion-contract GitHub repo.

License

Licensed under Boost Software License 1.0 (BSL-1.0). See the LICENSE file for full terms.

API Reference

The Stallion backend is a REST API built with NestJS. All protected endpoints require a JWT Bearer token. Full interactive Swagger docs are at /api/docs.

โ„น๏ธ

External API access is managed directly by the Stallion team. Partners looking to integrate should contact admin@stallion.so.

Authentication

Include a JWT Bearer token in every protected request:

Authorization: Bearer <your_jwt_token>

Tokens expire after 7 days. Obtain one via POST /auth/login.

Endpoints

Auth
POST/auth/registerRegister (with role selection) + receive MFA QR
POST/auth/verify-totp/:userIdComplete TOTP MFA setup
POST/auth/loginLogin with email, password, TOTP code
Users
POST/usersCreate a new user
GET/users/:idGet user profile by ID
PATCH/users/:idUpdate user profile
Bounties
POST/bountiesCreate a new bounty
GET/bountiesList all bounties
GET/bounties/:idGet bounty by ID
PATCH/bounties/:idUpdate bounty (while Active)
DELETE/bounties/:idDelete bounty (no submissions only)
Submissions
POST/bounties/:id/submissionsSubmit work to a bounty
GET/bounties/:id/submissionsList all submissions for a bounty
Wallet
GET/walletGet wallet balance
GET/wallet/transactionsGet transaction history
POST/wallet/withdrawWithdraw to Stellar wallet
Transactions
GET/transactions/:idGet transaction by ID

Security

Stallion is built with security at every layer โ€” from mandatory MFA on all accounts to on-chain escrow that removes the need to trust any single party with your funds.

Account security

On-chain fund security

Reporting a vulnerability

Email admin@stallion.so. Do not open public GitHub issues for security concerns.

FAQ

We get it โ€” curiosity leads to success. Here are the most common questions.

Platform

How does Stallion differ from traditional job or bounty boards? โ–ผ
For Contributors: You aren't just "hunting" โ€” you're building a verified career. Every task, gig, and hackathon you complete creates an immutable, on-chain record of your skills.

For Companies: We eliminate the "resume noise." Stallion is a decentralized vetting pipeline โ€” you see verified on-chain proof of what candidates have actually built and shipped.
What's the difference between a bounty, hackathon, gig, and job? โ–ผ
Bounty: Open competition. Anyone can submit. Best work wins the reward.
Hackathon: Competitive build event with a prize pool, judging, and a defined time window.
Gig: Short-term freelance work assigned to one contributor by the creator.
Job: Ongoing full-time or part-time role posted by a Web3 team or company.
How do payments and settlements work? โ–ผ
For Contributors: No more chasing invoices. Once your work is approved, smart contracts on Stellar route funds directly to your wallet in under 5 seconds.

For Companies: Full transparency. Funds are held in escrow and only released when milestones are met โ€” your budget is always tied to results.
What is an "On-Chain CV" and why do I need one? โ–ผ
For Contributors: It's your permanent proof of expertise. Every bounty, hackathon, and gig you complete on Stallion is verified on the blockchain โ€” making your skills undeniable to future partners and employers.

For Companies: A trust layer. View a contributor's actual on-chain history of completed work before engaging them โ€” no self-reported claims.
How do you ensure the quality of listings and submissions? โ–ผ
Only high-impact opportunities from verified projects and companies are listed on Stallion. Our vetting process filters out spam and low-quality postings, so contributors spend their time on work that matters.
Is Stallion limited to the Stellar ecosystem? โ–ผ
While Stallion is currently optimised for Stellar to provide the fastest, lowest-cost settlements, our roadmap includes cross-chain support. Stellar gives us the speed and near-zero fees needed at this stage.

Accounts

What's the difference between Contributor and Creator? โ–ผ
Contributors find and complete opportunities โ€” bounties, hackathons, gigs, and jobs โ€” and get paid on-chain. Creators post opportunities, review submissions, and source talent from Stallion's pipeline. You choose your role at registration.
Do I have to use two-factor authentication? โ–ผ
Yes. TOTP MFA is mandatory on every Stallion account. Since your account is connected to real on-chain funds, this is non-negotiable. Setup takes about 2 minutes.
I lost my authenticator app. How do I log in? โ–ผ
Use one of your 10 backup codes. On the login screen, click Use a backup code. Each is single-use. Once in, go to Settings to re-link a new authenticator app.
I lost both my authenticator and backup codes. What now? โ–ผ
Email admin@stallion.so with proof of identity. Manual recovery may take several business days.

Payments

How long do payouts take? โ–ผ
On-chain payouts (bounties, hackathons, gigs) settle in under 5 seconds of approval. The transaction is immediately visible on the Stellar network.
Are there withdrawal fees? โ–ผ
Withdrawals incur standard Stellar network fees โ€” fractions of a cent. Stallion does not charge additional withdrawal fees.

Changelog

Release notes for the Stallion platform.

v1.0.0 โ€” Mainnet Launch
June 2026
๐Ÿš€

Stallion is live on Soroban mainnet. Bounties, hackathons, gigs, and job listings are all available.

Shipped

  • Soroban smart contract deployed and verified on Stellar mainnet
  • Bounty, hackathon, gig, and job listing support
  • Contributor and Creator role system with role selection at registration
  • Full bounty lifecycle: create โ†’ apply โ†’ submit โ†’ review โ†’ payout
  • Hackathon registration, submission, and prize distribution
  • Multi-winner reward distribution with custom percentage splits
  • In-app custodial wallet with USDC, XLM, EURC, and USDGLO support
  • Withdrawal to external Stellar wallets
  • Mandatory TOTP MFA + 10 backup codes on all accounts
  • Points-based on-chain reputation system and On-Chain CV
  • Talent pipeline for Creator discovery of verified contributors
  • Real-time performance monitoring and uptime dashboards
  • Ecosystem partner integrations for grant and DAO bounty feeds
  • Automated payout queue via BullMQ workers
  • Swagger API docs at /api/docs

Notes

  • External self-serve API keys are not available in v1.0. Partner integrations are managed directly by the Stallion team.
  • Cross-chain support is on the roadmap.