Documentation

Docs are being assembled

The protocol is documented in full inside the repository — eight build checkpoints written to be read cold. This page is where that material is being published, section by section. Nothing below is a placeholder for work that has not happened; the entries marked written already exist in the repo today.

Precompile

0x0FD2

Source chain

Ethereum Sepolia

Destination

Creditcoin Testnet

Token

rUSD · 6 decimals

Protocol

  • The one-sentence pitch

    What riya does, in dollars, with a worked example.

    Written

    walkthrough/01-aave-v4-adapter.md

  • How value and proofs move

    The full path from a USDC deposit on Ethereum to a debt decrement on Creditcoin.

    Written

    research/how-value-and-proofs-move.md

  • Build plan

    How the system is put together, in build order.

    Written

    research/build-plan.md

Contracts

  • RiyaEscrow

    Custody only. One function, one event, no mutable state.

    Written

    walkthrough/03-riya-escrow.md

  • AaveV4Adapter

    Turns Aave's silently-rebasing balance into discrete, provable harvest events.

    Written

    walkthrough/01-aave-v4-adapter.md

  • RiyaASC

    Proof verification: receipt status, per-event address pinning, replay protection.

    Written

    walkthrough/06-riya-asc.md

  • LoanLedger

    Collateral, protocol fee, yield accumulator, credit score, LTV ladder, debt.

    Written

    walkthrough/08-loan-ledger.md

  • RiyaUSD

    The borrowable dollar. Six decimals, mint and burn gated to the ledger.

    Written

    walkthrough/07-riya-usd.md

Integrating

  • Deployed addresses

    Sepolia and Creditcoin Testnet addresses, with verified source links.

    Planned

    Pending deployment

  • Accepting rUSD

    Adding rUSD to a Creditcoin contract, wallet or pool.

    Planned

    Not written yet

  • Reading a riya credit score

    Using riya's on-chain score as a signal in your own protocol.

    Planned

    Not written yet

In the meantime

The landing page explains the mechanism end to end, and the dashboard shows the position it produces.

How it worksOpen the app