Orlance - Smart Contracts

Yield-splitting protocol with fixed-income pools, an auto-roll vault, and a no-loss yield lottery.

• Multi-maturity pool deployment in one run (1M / 2M / 3M by default)
• Principal/Yield token split (TPS / TYS) via OrlanceVault
• Router zap flow (ETH -> stETH -> Vault) for better UX
• Dedicated AMM per maturity (TPS/stETH)
• Optional seeded TVL + AMM liquidity for non-empty demo state
• Auto-roll strategy vault (OrlanceAutoRoller, OAS share token)
• No-loss yield lottery (OrlanceNoLossLottery) with round-based winner draw

• Foundry installed
• Arbitrum Sepolia RPC URL
• Deployer private key funded with testnet ETH

# From workspace root
cd orlance-sc

# Install dependencies (if needed)
forge install

# Build
forge build

# Run all tests
forge test

# Run with gas report
forge test --gas-report

# Verbose mode
forge test -vvv

orlance-sc/
|- src/
|  |- core/
|  |  |- OrlanceVault.sol
|  |  |- OrlanceRouter.sol
|  |  |- OrlanceAutoRoller.sol
|  |  |- OrlanceNoLossLottery.sol
|  |  |- PrincipalToken.sol
|  |  `- YieldToken.sol
|  |- mocks/
|  |  |- MockLido.sol
|  |  `- SimpleAMM.sol
|  |- interfaces/
|  `- libraries/
|- script/
|  `- FullDeploy.s.sol
|- test/
|  |- Orlance.t.sol
|  `- OrlanceLottery.t.sol
|- .env.example
`- foundry.toml

Create your local .env:

cp .env.example .env

PowerShell:

Copy-Item .env.example .env

Minimum required:

• ARB_SEPOLIA_RPC_URL
• PRIVATE_KEY

One-liner (PowerShell):

cd "orlance-sc"; forge script script/FullDeploy.s.sol:FullDeployScript --rpc-url $env:ARB_SEPOLIA_RPC_URL --broadcast

FullDeploy will:

1. Deploy MockLido, OrlanceVault, OrlanceRouter
2. Create 3 maturity pools
3. Deploy AMMs per pool (if enabled)
4. Seed pool TVL + AMM liquidity (if enabled)
5. Deploy auto-roller (if enabled)
6. Deploy lottery (if enabled)
7. Print addresses, maturities, and seeded amounts to logs

If SEED_POOLS=true and seed values are not set, defaults are:

• Pool TVL seed: 12 / 8 / 5 stETH (pool 1/2/3)
• AMM seed: 3 / 2 / 1 stETH (pool 1/2/3)

Override with:

• SEED_POOL_1_TVL_STETH, SEED_POOL_2_TVL_STETH, SEED_POOL_3_TVL_STETH
• SEED_POOL_1_AMM_STETH, SEED_POOL_2_AMM_STETH, SEED_POOL_3_AMM_STETH

Pool generation:

• POOL_NAME_PREFIX
• BASE_MATURITY_OFFSET_DAYS
• MATURITY_STEP_DAYS
• POOL_NAME_1..3
• MATURITY_TIMESTAMP_1..3

Feature flags:

• DEPLOY_AMM
• SEED_POOLS
• DEPLOY_AUTO_ROLLER
• DEPLOY_LOTTERY

Lottery:

• LOTTERY_INITIAL_MATURITY
• LOTTERY_ROUND_DURATION_SECONDS

Optional verification:

• ETHERSCAN_API_KEY

Draw lottery winner (owner only):

cd "orlance-sc"; $seed = cast keccak "draw-$(Get-Date -Format o)"; cast send <LOTTERY_ADDRESS> "drawWinner(bytes32)" $seed --rpc-url $env:ARB_SEPOLIA_RPC_URL --private-key $env:PRIVATE_KEY

Trigger auto-roller roll-over:

cd "orlance-sc"; cast send <AUTO_ROLLER_ADDRESS> "rollOver(uint256)" <NEW_MATURITY_TIMESTAMP> --rpc-url $env:ARB_SEPOLIA_RPC_URL --private-key $env:PRIVATE_KEY

1. Copy deployment logs (addresses + maturities).
2. Update FE env files:

• orlance-fe/.env
• orlance-fe/.env.example

3. Restart FE server.
4. Validate:

• pools and TVL per maturity
• auto-roller next roll-over
• lottery current round and winner history

• Arbitrum Sepolia Explorer
• Foundry Book
• OpenZeppelin Contracts

MIT License.