Open-source RWA lending infrastructure built on Stellar and Soroban.

Deposit tokenized real-world assets, access on-chain liquidity, and manage risk through a modular smart-contract architecture.

About • Architecture • Getting started • Contributing • License

Warning

Alien Protocol is under active development and has not been audited. Do not use these contracts with production funds.

👽 About

Alien Protocol is a modular credit layer for tokenized real-world assets on Stellar. It is designed to make RWA-backed borrowing transparent, programmable, and easier for applications to integrate.

The protocol separates collateral custody, liquidity, pricing, and liquidation into focused Soroban contracts. This keeps responsibilities clear and allows each part of the lending lifecycle to evolve independently.

Why Alien Protocol?

• RWA-focused — lending primitives designed around tokenized real-world collateral.
• Built on Stellar — fast settlement and Soroban-native smart contracts.
• Modular by design — isolated contracts for collateral, liquidity, prices, and liquidations.
• Transparent risk controls — on-chain positions, price freshness checks, pause controls, and liquidation paths.
• Open source — public development with community issues and pull requests welcome.

🛸 Architecture

%%{init: {"theme": "base", "themeVariables": {"background": "#0B1020", "fontFamily": "Inter, ui-sans-serif, system-ui", "lineColor": "#A78BFA", "textColor": "#F8FAFC"}}}%%
flowchart LR
    User([Users]) -->|deposit / withdraw| Vault[Collateral Vault]
    User -->|borrow / repay| Pool[Lending Pool]
    Oracle[Oracle Adapter] -->|asset prices| Vault
    Oracle -->|health data| Engine[Liquidation Engine]
    Pool <-->|debt and liquidity| Vault
    Engine -->|seize unhealthy collateral| Vault

    classDef user fill:#0891B2,stroke:#67E8F9,stroke-width:2px,color:#FFFFFF
    classDef vault fill:#7C3AED,stroke:#C4B5FD,stroke-width:2px,color:#FFFFFF
    classDef pool fill:#2563EB,stroke:#93C5FD,stroke-width:2px,color:#FFFFFF
    classDef oracle fill:#D97706,stroke:#FDE68A,stroke-width:2px,color:#FFFFFF
    classDef engine fill:#DC2626,stroke:#FCA5A5,stroke-width:2px,color:#FFFFFF

    class User user
    class Vault vault
    class Pool pool
    class Oracle oracle
    class Engine engine
    linkStyle default stroke:#A78BFA,stroke-width:2px

Loading

The diagram represents the target protocol flow. Individual modules are being completed incrementally.

Component	Responsibility	Status
collateral-vault	Collateral deposits, withdrawals, asset support, position valuation, and seizure	🟢 In development
oracle-adapter	Asset prices, freshness checks, authorized feeders, and RedStone push/pull models	🟢 In development
lending-pool	Liquidity, borrowing, repayment, and debt accounting	🟡 Scaffolded
liquidation-engine	Position health monitoring and liquidation execution	🟡 Scaffolded
shared	Shared protocol types, errors, constants, and events	🟢 In development

✨ Current capabilities

• Soroban-native Rust workspace with optimized WASM release settings.
• Collateral asset allowlisting and per-user position tracking.
• Deposit, withdrawal, valuation, and collateral-seizure flows.
• Administrative pause and role-transfer controls.
• Oracle price publication with staleness validation.
• RedStone push- and pull-model oracle integration.
• Native contract tests and automated formatting, linting, build, and test checks.

🚀 Getting started

Prerequisites

• Rust with rustup
• Stellar CLI
• Git
• The wasm32v1-none Rust target

1. Clone the repository

git clone https://github.com/Alien-Protocol/Alien-Protocol.git
cd Alien-Protocol

2. Prepare the toolchain

rustup target add wasm32v1-none
stellar --version

3. Run the test suite

cargo test --workspace --all-features

4. Build the contracts

stellar contract build --locked

The Stellar CLI builds every contract crate in the workspace, uses the release profile, and optimizes the generated WASM by default. Compiled contracts are written to target/wasm32v1-none/release/.

🧪 Quality checks

Run the full local verification suite before opening a pull request:

cargo fmt --all --check
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo check --workspace
cargo test --workspace --all-features
stellar contract build --locked

📁 Repository structure

Alien-Protocol/
├── .github/
│   ├── ISSUE_TEMPLATE/       # Contribution templates
│   └── workflows/            # Contract CI
├── contracts/
│   ├── collateral-vault/     # Collateral custody and positions
│   ├── lending-pool/         # Borrowing and liquidity
│   ├── liquidation-engine/   # Unhealthy-position liquidation
│   ├── oracle-adapter/       # Price feeds and RedStone integration
│   └── shared/               # Shared protocol primitives
├── docs/
│   ├── CONTRIBUTING.md       # Contribution workflow and conventions
│   └── LICENSE
├── Cargo.toml                # Rust workspace configuration
└── README.md

🤝 Contributing

Contributions of all sizes are welcome. Read the contribution guide for the complete setup, branch naming, commit-message format, quality checks, and pull-request checklist.

A good first step is to browse the open issues. For larger features or protocol changes, open an issue before implementation so the approach can be discussed with the maintainers.

🔐 Security

If you discover a security vulnerability, please avoid opening a public issue that exposes it. Contact the maintainers privately through the repository owner's GitHub profile until a dedicated security policy and reporting channel are published.

📄 License

Alien Protocol is open-source software licensed under the MIT License.

---

Building the credit layer for tokenized assets on Stellar.

If this project interests you, consider giving it a ⭐ and joining the conversation.