Skip to Content
DocumentationWelsh Street CoreContracts

Contracts

A decentralized exchange (DEX) to support STREET, the world’s first dedicated meme emission token, built on Stacks blockchain. The DEX enables swaps between WELSH Corgi Coin (WELSH) and STREET Token (STREET), liquidity provisioning, and a dedicated emission and distribution system for liquidity providers.

Architecture

The contracts form an integrated DeFi ecosystem where:

  • Users provide WELSH / STREET liquidity and receive CREDIT LP tokens
  • Trading fees and STREET emissions accumulate in the distribution contract
  • LP token holders can claim proportional rewards at any time

Core Contracts

Credit Controller

  • Contract: credit-controller.clar
  • Utility contract to transfer CREDIT between STX Accounts
  • Manages the rewards system adjustments and unclaimed token tracking
  • Contract Links: Mainnet
  • Contract Links: Testnet

Credit Token

  • Contract: credit-token.clar
  • LP Tokens: Manages liquidity provider (LP) token issuance and tracking
  • CREDIT tokens represent proportional ownership of liquidity pools
  • Handles minting and burning to adjust LP positions
  • Contract Links: Mainnet
  • Contract Links: Testnet

Emission Controller

  • Contract: emission-controller.clar
  • Algorithmic Emissions: Permissionless STREET token emission mechanism
  • CREDIT holders trigger emissions at Bitcoin block intervals
  • Immutable emission parameters (10,000 STREET per block, 0.1% bounty)
  • Sybil resistance via 1 BPS CREDIT requirement
  • Back-to-back prevention and block interval enforcement
  • Contract Links: Mainnet
  • Contract Links: Testnet

Street Controller

  • Contract: street-controller.clar
  • Genesis Distribution: NFT-based mint event for initial STREET circulation
  • Distributes 3B STREET across 21,000 NFTs (100k standard, 1M jackpot)
  • Anti-Sybil: 1,000 WELSH donation per mint (flows to rewards pool)
  • Max 2 mints per wallet
  • Immutable mint parameters and distribution logic
  • Contract Links: Mainnet
  • Contract Links: Testnet

Street Market

  • Contract: street-market.clar
  • Core DEX: Automated Market Maker (AMM) for WELSH / STREET trading
  • Supports liquidity provision, including remove, lock and burn.
  • Implements token swaps and fee collection (0.5% per side)
  • Contract Links: Mainnet
  • Contract Links: Testnet

Street NFT

  • Contract: street-nft.clar
  • Welsh Street Genesis NFT: Non-fungible token for genesis distribution
  • 21,000 NFT mint cap
  • 1,000 WELSH donation per NFT mint
  • 100,000 STREET per standard mint (positions 1-20)
  • 1,000,000 STREET jackpot (position 21 in each cycle)
  • Tracks user mint history (max 2 per wallet)
  • Contract Links: Mainnet
  • Contract Links: Testnet

Street Rewards

  • Contract: street-rewards.clar
  • Token Distribution: Distributes trading fees and emissions to LP token holders
  • Tracks rewards system global indices and accumulates tokens per share for fair distribution
  • Supports claiming of both WELSH and STREET token distributions
  • Contract Links: Mainnet
  • Contract Links: Testnet

Street Token

  • Contract: street-token.clar
  • STREET Token: Fungible token with no supply cap
  • Features emission-based minting with epochs
  • Mint authorization granted to controller contracts
  • Contract Links: Mainnet
  • Contract Links: Testnet

Welshcorgicoin

  • Contract: welshcorgicoin.clar
  • WELSH Token: Main fungible token (10B total supply)
  • Replica of the mainnet welshcorgicoin.clar for testing and development purposes
  • Implements SIP-010 standard with transfer, balance, and metadata functions
  • Pre-minted supply allocated to contract creator and distributed to community through CTO
  • Contract Links: Mainnet
  • Contract Links: Testnet

Welsh Faucet

  • Contract: welsh-faucet.clar
  • Testnet-only contract to provide testnet WELSH
  • Contract Links: Mainnet
  • Contract Links: Testnet
Last updated on