Skip to content

CoinCircle/radian

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

60 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Radian Protocol

Radian protocol is a revolutionary autonomous decentralized protocol that provides a set of economic primitives designed to work with the Radian (RAD) token. Radian protocol's goal is to create a complete sustainable non-zero-sum crypto-economy capable of self-goverened autonomous growth enabling features far beyond what is capable with CeFi systems while maintaining the trustlessness and decentralization of DeFi.

Built on zkSync Era with account abstraction capabilities, Radian enables gasless transactions, smart wallets, and a unified liquidity layer across trading, lending, and synthetic derivatives.

Note: This is the in-progress v2 protocol codebase. The live v1 Radian (RAD) token code (currently deployed on the Ethereum Mainnet) can be found here.

πŸ—οΈ Architecture

This is a monorepo containing all components of the Radian protocol:

radian/
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ contracts/     # Solidity smart contracts (Foundry + Hardhat)
β”‚   └── sdk/          # TypeScript SDK
└── apps/
    β”œβ”€β”€ dapp/         # Next.js web application
    └── docs/         # Docusaurus documentation site

🧩 Core Modules

Radian Token v2 (RAD) & Collector

  • RAD represents the total value locked in the protocol
  • Non-transferable between wallets (only for governance and to/from protocol contracts)
  • Collector aggregates all protocol fees and locked value
  • Backs the USDX stablecoin
  • Multi-token model converts RAD <-> RADX liquidity token 1:1 for exiting protocol

Smart Wallet & Paymaster

  • Account Abstraction: Interact without managing private keys or gas
  • Gasless Transactions: Pay fees in any token with sufficient liquidity
  • Wallet Modules: Extensible "apps" for smart wallets (debit cards, subscriptions, etc.)

Exchange (DEX)

  • Uniswap V3-based AMM with USDX as the common denominator for all pairs
  • Single-hop trading (no multi-hop routing needed)
  • Leveraged trading with protocol as counterparty
  • Shared liquidity with lending markets
  • Alternative price curves support (options, stablecoin pools)

Stablecoin (USDX)

  • Backed by RAD token (which represents all protocol value)
  • Mint using any token with exchange liquidity
  • DAI-like mechanics with liquidations

Lending (Money Market)

  • Overcollateralized and undercollateralized lending
  • Shared liquidity with the exchange
  • No asset whitelist - permissioned mathematically by liquidity
  • Yield boosts via RAD rewards

Synthetic Derivatives (Perpetuals)

  • Create derivatives for any numerical value (not just prices)
  • Based on Paradigm's Power Perpetuals
  • Dynamic funding rates
  • Examples: temperature, volatility indices, sports scores, etc.

πŸ“š Documentation

Full documentation is available at the docs site or by running cd apps/docs && npm start.

Key documentation:

πŸš€ Dev Quick Start

Prerequisites

  • Node.js 16+ and Yarn
  • Foundry (for contracts)

Installation

# Clone the repository
git clone https://github.com/CoinCircle/radian.git
cd radian

# Install dependencies
yarn install

# If you get build errors try running with ignore scripts:
yarn install --ignore-scripts

Running Components

Smart Contracts

See the contracts README for detailed instructions.

cd packages/contracts

# Copy environment variables
cp .env.example .env
# Edit .env with your MNEMONIC and INFURA_API_KEY

# Run tests
forge test

# Run integration tests
npm run test

# Start local blockchain
anvil

# Build
npm run build

# Deploy locally (in another terminal)
npm run deploy

DApp

# From workspace root:
# Option 1: From root (recommended)
yarn workspace dapp dev

# Option 2: From dapp directory
cd apps/dapp
yarn dev

# Open http://localhost:3000

Documentation

# From workspace root:
# Option 1: From root (recommended)
yarn workspace docs start

# Option 2: From docs directory  
cd apps/docs
yarn start

# Open http://localhost:4001

πŸ§ͺ Testing

# Test contracts (Foundry)
cd packages/contracts
forge test

# Integration tests (Hardhat)
cd packages/contracts
npm run test

πŸ“¦ Deployments

Contract deployments are tracked in packages/contracts/deployments.json.

πŸ”§ Development

This project uses:

  • Foundry for Solidity development and testing
  • Hardhat for integration tests and deployments
  • Next.js for the frontend
  • Docusaurus for documentation
  • Yarn Workspaces for repo & dependency management

πŸ“„ License

See LICENSE for details.

🀝 Contributing

This is a work-in-progress development. Contributions welcome!

πŸ”— Links


Status: 🚧 Work in Progress

About

Radian Protocol

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •