Welcome
Developer documentation for the Nolus Protocol.
Nolus is a spot margin protocol with cross-chain reach - longs or shorts at a fixed rate, backed by the asset itself. IBC connects positions to Osmosis today; Solray brings Solana next. This site is the developer reference for everything in and around the protocol.
Where to start
Protocol overview
The mental model: leases, the money market, oracle, treasury.
Borrowing flow
Open, service, repay, and close a leveraged position.
SDK getting started
Use nolus.js to read protocol state and submit transactions.
Run a node
Build, run, and operate a Nolus full node or validator.
Source code
Everything in this documentation is backed by open source code under the
nolus-protocol GitHub organization.
The most relevant repositories:
| Repository | Language | Role |
|---|---|---|
| nolus-core | Go | The chain itself - Cosmos SDK + CometBFT, custom modules. |
| nolus-money-market | Rust | CosmWasm contracts: Lease, Leaser, LPP, Oracle, Profit, Reserve, Treasury, TimeAlarms. |
| nolus.js | TypeScript | Application SDK. |
| oracle-price-feeder | Rust | Price feeder daemon for the on-chain oracle. |
| nolus-networks | Shell | Network configurations and seed/peer lists. |