Creditra Contracts

Soroban smart contracts for the Creditra adaptive credit protocol on Stellar.

About

This repo contains the credit contract: it will maintain credit lines, track utilization, enforce limits, and expose methods for opening lines, drawing, repaying, and updating risk parameters. The current code is a stub with the correct API and data types; full logic (storage, token transfers, interest) is to be implemented.

Contract data model:

• CreditStatus: Active, Suspended, Defaulted, Closed
• CreditLineData: borrower, credit_limit, utilized_amount, interest_rate_bps, risk_score, status

Methods: init, open_credit_line, draw_credit, repay_credit, update_risk_parameters, suspend_credit_line, close_credit_line.

Tech Stack

• Rust (edition 2021)
• soroban-sdk (Stellar Soroban)
• Build target: wasm32 for Soroban

Prerequisites

• Rust 1.75+ (recommend latest stable)

• wasm32 target:

  rustup target add wasm32-unknown-unknown

• Stellar Soroban CLI for deploy and invoke (optional for local build).

Setup and build

cd creditra-contracts
cargo build --release -p creditra-credit

WASM build (release profile, size-optimized)

The workspace uses a release profile tuned for contract size (opt-level "z", LTO, strip symbols). To build the contract for Soroban:

rustup target add wasm32-unknown-unknown
cargo build --release --target wasm32-unknown-unknown -p creditra-credit

WASM output is at target/wasm32-unknown-unknown/release/creditra_credit.wasm. Size is kept small by:

• opt-level = "z" (optimize for size)
• lto = true (link-time optimization)
• strip = "symbols" (no debug symbols in release)
• codegen-units = 1 (better optimization)

Avoid large dependencies; prefer minimal use of the Soroban SDK surface to stay within practical Soroban deployment limits.

Run tests

cargo test -p creditra-credit

Deploy (with Soroban CLI)

Once the Soroban CLI and a network are configured:

soroban contract deploy --wasm target/wasm32-unknown-unknown/release/creditra_credit.wasm --source <identity> --network <network>

See Stellar Soroban docs for details.

Project layout

• Cargo.toml — workspace and release profile (opt for contract size)
• contracts/credit/ — credit line contract
  • Cargo.toml — crate config, soroban-sdk dependency
  • src/lib.rs — contract types and impl (stubs)

Merging to remote

This repo is a standalone git repository. After adding your remote:

git remote add origin <your-creditra-contracts-repo-url>
git push -u origin main