Skip to content

exponentlabshq/toktok

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TokTok (A Stacks AI Guild Submission)

Created for the Dora Hacks Stacks sBTC Hackathon September 4, 2025.

Think Global, Act LOCAL - Onboarding the next million Nigerian Bitcoin millionaires in their native tongue: Pidgin.

Special thanks to PeaceLoveMusic, GPSC, 3Hunna, Hero, Haddy, JackbinSwitch, CryptoDude, Rocky and the entire Stacks AI Guild for making this possible

👥 Team 🇳🇬🇨🇦🇬🇾

  • tomm_yblack.btc
  • tinderlyonx.btc
  • Jrmaya.btc
  • Blockface.btc

🚀 Live Demo

Try TokTok Now → http://pidginonstacks.carrd.co

TokTok App Screenshot

sBTC Payment Demo


💼 THE BUSINESS PART

ℹ️ About

According to a 2020 online survey, 32% of participating Nigerians used cryptocurrencies. With a total cryptocurrency transaction volume amounting to $400M, Nigeria ranks third after the United States and Russia according to 2020 estimates.

TokTok is reimagining what it truly means to think globally and act locally. Our mission is to bridge the gap between traditional financial systems and Bitcoin adoption by providing an intuitive, culturally-appropriate interface that speaks to users in Pidgin English.

🌍 Think Global, Act LOCAL

Onboarding the next million Nigerian Bitcoin millionaires in their native tongue: Pidgin.

❓ Problem-Worth Solving | Job-to-be-Done

What we have is a problem to communicate.

Do you know how Mr. Beast blew up? By thinking globally and acting locally.

Mr. Beast blew up because he hired well-known actors to re-dub his voice on his videos. There are stories of him hiring the voice actor for Spider-Man to re-dub his voice in different countries.

🧩 Solution

What the learner learns is a function of what they already know.

  • The Kullback-Leibler Divergence

Acting globally and thinking locally is how we onboard the next million Nigerian millionaires to the Stacks ecosystem. Nigeria already houses a large percentage of the world's bitcoin millionaires...it's time to zero to n this achievement by reimaigining and onboarding and UI/UX interface that speaks in the native Nigerian tongue: pidgin.

🔍 Political Legal Regulatory & Compliance Climate

  • Nigeria's adoption of Bitcoin is driven by factors such as economic instability, inflation, and currency devaluation, making it a vital resource for youth and businesses.

  • The country's regulatory environment and the increasing number of crypto exchanges have facilitated the growth of cryptocurrency adoption and investment.

✨ Key Features

  • 🌍 Pidgin English Interface: Native language support for Nigerian users
  • 💰 sBTC Integration: Seamless Bitcoin-to-Stacks transactions
  • 🔒 Secure Smart Contracts: Built on Stacks blockchain with Clarity via sbtcpay.org
  • 💳 Payment Gateway: Powered by sBTCpay.org for simple Bitcoin payments
  • 📱 Mobile-First Design: Optimized for smartphone usage via Carrd, an affordable solution for Nigerian Developers to get their apps off the ground without breaking the bank
  • 🧪 Testnet Ready: Safe testing environment for development

🛠️ THE TECHNICAL PART - PAYMENT GATEWAY DEEP DIVE

🧰 Technology Stack

  • Blockchain: Stacks (Bitcoin Layer 2)
  • Smart Contracts: Clarity
  • Payment Processing: sBTC Pay
  • Token Standard: SIP-010 compliant fungible tokens
  • Cross-Chain: Bitcoin ↔ Stacks bridge functionality

TokTok is powered by sBTC Pay (http://www.sbtcpay.org), a revolutionary Bitcoin payment gateway that enables simple Bitcoin payments for developers.

🔗 Powered by sBTC Pay

sBTC Pay Merchant Backend

🔧 Technical Implementation

sBTC Clarity Contract (author: @kai_builder on X | http://www.sbtcpay.org)

TokTok is built on the Stacks blockchain using a custom Clarity smart contract (smart-contracts/sbtcpayorg.clar) that implements sBTC (Stacks Bitcoin) functionality:

Key Features:

  • Dual Token System: Implements both sbtc-token (available) and sbtc-token-locked (locked) fungible tokens
  • Protocol Functions: Secure minting, burning, locking, and unlocking operations with protocol-level authorization
  • SIP-010 Compliance: Full compatibility with Stacks Improvement Proposal 010 for fungible tokens
  • Batch Operations: Efficient bulk transfers and minting for improved user experience
  • Security: Contract-caller validation ensures only authorized protocols can perform critical operations

Core Functions:

  • protocol-lock: Locks sBTC tokens for Bitcoin bridge operations
  • protocol-unlock: Unlocks sBTC tokens back to available state
  • protocol-mint: Mints new sBTC tokens to recipients
  • transfer-many: Batch transfer functionality for multiple recipients
  • get-balance: Retrieves total, available, and locked token balances

The contract integrates with the sBTC registry for secure cross-chain Bitcoin operations, enabling seamless Bitcoin-to-Stacks transactions in Pidgin English.

📱 Usage

See TokTok in action with our comprehensive usage demonstrations:

TokTok Usage Demo

TokTok Usage Screenshot

These demonstrations show the complete user journey through TokTok's Pidgin English interface, showcasing how Nigerian users can seamlessly interact with Bitcoin and sBTC through our intuitive, culturally-appropriate design.

⚠️ Important Notice

TESTNET ONLY - This application currently supports testnet wallets only. Do not use mainnet wallets or send real Bitcoin.

Get sBTC faucet: sBTC Faucet

🚀 Quick Start Features

API Endpoints

  • Base URL: https://sbtcpay.org/api/v1
  • Authentication: Bearer token authentication
  • Test API Key: sk_test_....

Core Functionality

  • Product Management: Create, update, and manage products for sale
  • Payment Intents: Generate payment intents for customers
  • Payment Links: Create shareable payment links with customization
  • Customer Management: Track customers and their transaction history
  • Webhook Support: Real-time payment notifications

Key API Endpoints

  • POST /products - Create new products
  • POST /payment_intents - Create payment intents
  • POST /payment-links - Generate payment links
  • GET /customers - List customers with successful payments
  • GET /payment_intents - Retrieve payment intents

🔧 Integration Benefits

  • Simple Bitcoin Payments: Streamlined sBTC payment processing
  • Developer-Friendly: RESTful API with comprehensive documentation
  • Testnet Support: Safe testing environment for development
  • Real-time Updates: Webhook integration for payment status updates
  • Customer Tracking: Complete transaction and customer management

🚀 BONUS: Haute Couture with sBTC: https://haute-portrait-boutique.lovable.app/

About

TokTok - Bitcoin payment app for Nigerian users with Pidgin English interface, sBTC integration, and Stacks blockchain

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors