Skip to Content
DocumentationWelsh Street CoreContracts

Contracts

Welsh Street is a decentralized exchange (DEX) to support STREET, and the Meme Rewards Protocol, built on Stacks blockchain. The DEX enables swaps between Welsh Corgi Coin (WELSH) and Street Token (STREET), liquidity provisioning, and a dedicated emission and rewards 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 rewards contract
  • LP token holders can claim proportional rewards at any time

Addresses

These are the official deployer addresses.

Mainnet: SP2A7PT3DMWVT2BHHMKQ2T0Y4AA05NST96SDM2FCE 

Testnet: STY3JHZ0EKRC8BCRV4YQGA1CHN47M6Y4XQ240RVQ 

Core Contracts

credit-controller

  • Contract: credit-controller.clar
  • Utility contract to transfer CREDIT tokens between accounts
  • Manages CREDIT transfers with authorization controls and balance validation
  • Enables user-to-user LP token transfers outside of liquidity operations
  • Maintains accurate rewards accounting during LP token transfers
  • Contract Links: Testnet  Mainnet 

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, burning, and balance management for LP positions
  • Implements SIP-010 fungible token standard
  • Contract Links: Testnet  Mainnet 

emission-controller

  • Contract: emission-controller.clar
  • Emission System: Controls fixed-emission STREET minting for rewards distribution
  • Mints STREET tokens on a per-block schedule to maintain perpetual rewards
  • Enforces emission intervals and eligibility requirements
  • Automatically routes emissions to the rewards contract
  • Contract Links: Testnet  Mainnet 

street-controller

  • Contract: street-controller.clar
  • Genesis NFT Controller: Manages the Genesis NFT mint event
  • Coordinates STREET distribution and NFT minting during genesis event
  • Collects WELSH donations for the rewards pool (1,000 WELSH per mint)
  • Enforces mint cap (21,000 NFTs) and per-user limits (2 NFTs)
  • Contract Links: Testnet  Mainnet 

street-market

  • Contract: street-market.clar
  • Core DEX: Automated Market Maker (AMM) for WELSH/STREET trading
  • Supports five liquidity functions: initial, provide, remove, lock, and burn
  • Implements token swaps with fee collection (0.5% per side)
  • Features locked liquidity tracking and withdrawal tax (1%)
  • Contract Links: Testnet  Mainnet 

street-nft

  • Contract: street-nft.clar
  • Genesis NFT: Commemorative NFT collection for genesis event participants
  • Mints 21,000 unique NFTs with token type and background attributes
  • Tracks user ownership (max 2 per user) and supports transfers
  • Non-fungible token representing participation in STREET distribution
  • Contract Links: Testnet  Mainnet 

street-rewards

  • Contract: street-rewards.clar
  • Rewards Distribution: Distributes trading fees and emissions to LP token holders
  • Implements zero-debt cumulative distribution with global index accounting
  • Supports claiming of both WELSH and STREET token rewards
  • Handles cleanup of dust amounts and donation mechanisms
  • Contract Links: Testnet  Mainnet 

street-token

  • Contract: street-token.clar
  • STREET Token: Rewards token with fixed-emission issuance
  • Initial supply: 2B STREET for liquidity + 3B for genesis distribution
  • Minted by emission-controller and street-controller only
  • Implements SIP-010 fungible token standard
  • Contract Links: Testnet  Mainnet 

welsh-faucet

  • Contract: welsh-faucet.clar
  • Testnet Faucet: Provides testnet WELSH for development and testing
  • Implements cooldown period between requests
  • Testnet-only contract, not deployed to mainnet
  • Contract Links: Testnet 

welshcorgicoin

  • Contract: welshcorgicoin.clar (testnet) welshcorgicoin-token (mainnet)
  • WELSH Token: Fixed-supply community token (10B total)
  • Exact replica of mainnet welshcorgicoin for testing purposes
  • Implements SIP-010 standard with transfer, balance, and metadata functions
  • Contract Links: Testnet  Mainnet 
Last updated on