> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbnb.supply/llms.txt
> Use this file to discover all available pages before exploring further.

# Contracts

> Technical overview of ORB Supply smart contracts

ORB Supply is built on BNB Chain using Solidity smart contracts. The protocol uses Chainlink VRF for provably fair randomness and implements secure, rate-limited token distribution.

## Smart Contracts

### OrbDistributor

**Address:** `0x3676A0684C18dDD2055cef506F7af1A23f19442E`

**Status:** Contract is verified

This contract holds 30% of the total supply (300M ORB) purchased by the dev team. The contract implements rate-limited distribution with a maximum of 3000 ORB per minute (2500 ORB to miners + 500 ORB to Orbload) that can be minted by the Mining contract. The contract includes an emergency withdraw function with a 6-hour timelock for security.

### Token Contract

**Address:** `0x50830cFACbE6A99EE6F243487487B90402Ed4444`

**Status:** Launched on Four Meme

The ORB token contract. 30% of the supply was purchased by the dev team for mining operations and is held in the OrbDistributor contract. The remaining 70% is tradable on PancakeSwap.

### Mining Contract

**Address:** `0x11Cb3f6b7bcabBFfe3f8f7Ce9bc0D5fCe7E75cE9`

**Status:** Not verified (for security purposes)

This is the core contract of the protocol. It handles all mining operations, round management, reward distribution, and Chainlink VRF integration. The contract is intentionally not verified to prevent reverse engineering and maintain protocol security.

### Staking Contract

**Address:** `0x5b0cC690c14E36f12EDee6B5Dcc06Ff1a628Ed1c`

**Status:** Contract is verified

The staking contract allows users to stake ORB tokens and earn yield from protocol revenue. Stakers receive 10% of all ORB purchased through buybacks, providing non-inflationary rewards funded by protocol activity.

### Buyback Contract

**Address:** `0x80c6f76956fe410d4853e10dade68b3de3078153`

**Status:** Contract is verified

The buyback contract automatically executes buybacks using protocol revenue. Every buyback automatically distributes:

* 90% to the OrbDistributor contract to be buried (permanently removed from circulation)
* 10% to the Staking contract as protocol revenue for stakers

This mechanism ensures that buybacks are fully automated and permissionless, with tokens either being permanently removed from supply or distributed to stakers.

## Chainlink VRF

ORB Supply uses Chainlink VRF (Verifiable Random Function) to ensure provably fair randomness for orb selection and Orbload triggers. All randomness is on-chain and verifiable by anyone.

## Buyback & Supply Security

The purchased supply (30%) is stored in a verified, rate-limited proxy contract (OrbDistributor) to prevent rug pulls. The contract enforces maximum emission rates and includes emergency controls with timelocks.

## Security Features

* Chainlink VRF for provable randomness
* Rate-limited token distribution
* Emergency controls with timelocks
* Verified proxy contract for supply management
* Core contract not verified to prevent exploitation