One protocol, layered by function.

35 contracts. Seven layers. One bridge. Every layer has a single job and a single trust boundary.

Deployment is compliance-led: region by region, framework-first.
The RWLY protocol stackSeven layers, deployed bottom-up in dependency order. The bridge is a second chain, drawn apart.L1 · FOUNDATIONRoles, storage, parameters, upgradesL2 · CONTROL & POLICYCompliance tiers, price truth, supply policyL3 · MONEY COREThe token, fees, treasury, economicsL4 · OPERATIONSEscrow, earn-time commitment, conversion, regional settlementL5 · DISTRIBUTIONStaking, vesting, emissions, operator bondsL6 · BUSINESS REGISTRYWho may issue, who may redeem, who holdsL7 · MARKET OPERATIONSInventory crossing and DEX executionBRIDGEArbitrumA second chain. Wrapped RWLYexists only against RWLYlocked on Polygon.DEPLOY ORDER L1 → L735 contracts · seven layers and a bridge · Polygon PoS · exercised end to end on testnet

Tap a block for its contracts and trust boundary.

  • L1FoundationRoles, storage, parameters, upgrades
    AccessManagerBaseModuleStorageProtocolConfigRewardlyProxyManager

    Roles are granted by governance; deployer bootstrap roles are retired before token generation. Upgrades are scheduled, then executed no sooner than 24 hours later.

    Amoy testnet
  • L2Control & PolicyCompliance tiers, price truth, supply policy
    ControlManagerPriceOracleTokenomicsManager

    Policy and price truth for every layer above. A three-level circuit breaker halts settlement on dislocation; compliance tiers are switched per market.

    Amoy testnet
  • L3Money CoreThe token, fees, treasury, economics
    RewardlyToken (RWLY)FeeManagerTreasuryManagerEconomicsManager

    Mints are role-gated and capped per category in the token itself. Emergency can pause; only governance can unpause. No transfer fee at launch; 5% hard ceiling.

    Amoy testnet
  • L4OperationsEscrow, earn-time commitment, conversion, regional settlement
    EscrowManagerEarnCommitmentManagerConversionRouterRegionalSettlementManagerReserveRebalancerUserRelayAdapterBondManager

    The operator records; the router settles. Escrow deposits and withdrawals are gated by different roles, so a coalition's funding wallet cannot drain its own escrow.

    Amoy testnet
  • L5DistributionStaking, vesting, emissions, operator bonds
    StakingManagerVestingManagerMiningManagerCoalitionStaking

    Emissions are capped by supply policy and throttled by an on-chain sustainability ratio. Vesting caps are covenants that cannot drop below existing schedules.

    Amoy testnet
  • L6Business RegistryWho may issue, who may redeem, who holds
    CoalitionRegistryEnterpriseRegistryParticipantRegistryHoldTimeTracker

    A coalition must be registered and active before escrow accepts its funds or its obligations.

    Amoy testnet
  • L7Market OperationsInventory crossing and DEX execution
    InventoryManagerQuickSwapV3ExecutorUniswapV4ExecutorOdosAggregatorExecutorRewardlyHook

    InventoryManager is the sole caller of the swap executors; executors hold no funds between calls and are retired, not upgraded.

    Amoy testnet
  • BridgeBridgeCross-chain representation of RWLY
    BridgeOrchestratorRWLYOFTAdapterRWLYNttAdapterwRWLY (Arbitrum)

    Wrapped RWLY exists only against RWLY locked on Polygon. Bounded per transaction and per day; pauses independently; peer changes are timelocked.

    Arbitrum Sepolia · no mainnet

Coalition trust flows

Earn

A qualifying purchase, shift, visit or action is validated by the operator. The commitment is recorded on-chain with its coalition, its source, the oracle price at that moment, and a unique receipt hash. Once written, the committed amount cannot be reduced by anyone — it can only be settled, or cancelled with an on-chain reason.

Back

The issuing coalition's obligations are counted against stablecoin it holds in escrow. A health factor is recalculated on every change: issue at 1.5×, warning at 1.1×, settlement blocked below 1.0×, insurance fund activates below 0.8×.

Settle

Conversion batches settle against that escrow, inside that coalition. Cross-coalition redemption is possible, fee-bearing, and explicit. Regional settlement can pause one region without touching another.

Seven layers and a bridge.

Each layer has one job. The bridge is detached rather than stacked: a second chain representing RWLY on Arbitrum, not an eighth layer. Open a block in the stack above for the contracts it holds and the trust boundary it draws.

LayerLabelFunction
L1FoundationRoles, storage, parameters, upgrades
L2Control & PolicyCompliance tiers, price truth, supply policy
L3Money CoreThe token, fees, treasury, economics
L4OperationsEscrow, earn-time commitment, conversion, regional settlement
L5DistributionStaking, vesting, emissions, operator bonds
L6Business RegistryWho may issue, who may redeem, who holds
L7Market OperationsInventory crossing and DEX execution
BridgeBridgeCross-chain representation of RWLY

Bridge status

Lock-and-mint: wRWLY on Arbitrum exists only against RWLY locked on Polygon (invariant: locked = wrapped supply). Peer changes are timelocked. Built and tested on Arbitrum Sepolia; not deployed to mainnet.

Four methods, two applications pending.

Earn-time commitment

Value fixed at the moment of earning, not redemption.

Coalition escrow with health factor

Issuance capacity is a function of collateral on-chain, not policy.

Coalition-scoped settlement

Obligations settle where they were created; crossing is explicit.

Earn-origin tagging

Every commitment carries its source class — point-of-sale, validated receipt, workforce sync, impact action, grant.

Two patent applications are pending.

What the code enforces.

  • Upgrades are scheduled by an upgrader role and executed by governance after a mandatory delay of at least 24 hours; emergency upgrades require more than one approval.
  • Asymmetric pause: an emergency role can pause; only governance can unpause.
  • Dual-source price: an independent market feed composed with the protocol's own on-chain time-weighted average, bounded, staleness-checked and guarded against same-block manipulation.
  • Circuit breaker with three levels — warning, throttle, halt — and a minimum halt duration before any reset.
  • Exercised end-to-end on Polygon Amoy testnet, layers 1–7 and bridge.
RWLY is an ERC-20 on Polygon PoS. The network's native gas token is POL.Layer 7 executes against concentrated-liquidity pools on Polygon in its first phase, with further executors built for later phases.

Build on these layers.

Versioned ABIs, a published interface set and reference deployment scripts.