Turn unpaid invoices into instant liquidity on-chain, on Stellar.

Invoice Liquidity Network (ILN) is an open-source, decentralised invoice factoring protocol built on Stellar using Soroban smart contracts. Freelancers, creators, and SMEs unlock the value of outstanding invoices immediately, while DeFi liquidity providers earn yield by funding them at a discount.

No banks. No credit checks. No 60-day waits.

Freelancer                  ILN Contract              Liquidity Provider
    |                            |                            |
    |--- submit_invoice() ------>|                            |
    |    (amount, payer,         |                            |
    |     due_date, discount)    |                            |
    |                            |<--- fund_invoice() --------|
    |                            |    (sends USDC at          |
    |<-- receives USDC -------   |     discounted amount)     |
    |   (amount - discount)      |                            |
    |                            |                            |
   ...    invoice due date       ...                          |
    |                            |                            |
  Payer --- mark_paid() -------->|                            |
                                 |--- releases full amount -->|
                                      (LP earns the spread)

1. Submit — A freelancer calls submit_invoice() with amount, payer, due date, and discount rate
2. Fund — A liquidity provider calls fund_invoice(), sending USDC. The freelancer receives funds immediately
3. Pay — The payer settles the invoice, releasing the full amount to the LP
4. Earn — The LP earns the discount spread as yield

Mainnet deployment coming after audit. Do not use with real funds until then.

This is the organisation root — it contains shared infrastructure used across all ILN sub-projects:

A typed JavaScript/TypeScript SDK with browser Freighter signing and Node.js keypair support.

npm install @invoice-liquidity/sdk

See sdk/README.md for full API documentation.

A command-line tool for interacting with the ILN contract on testnet and mainnet.

npm install -g @invoice-liquidity/cli

iln submit --payer G... --amount 100 --due 2025-12-31 --rate 300
iln fund --id 1
iln pay --id 1
iln status --id 1

See cli/README.md for setup and usage.

A Node.js service that indexes contract events and exposes a REST API for the frontend.

A webhook-based notification service for invoice lifecycle events.

See docs/notifications.md for setup.

Deployment and development helper scripts.

.
├── cli/                    # CLI package (@invoice-liquidity/cli)
├── docs/                   # Shared protocol documentation
├── indexer/                # On-chain event indexer service
├── notifications/          # Webhook notification service
├── scripts/                # Deployment & dev scripts
├── sdk/                    # TypeScript SDK (@invoice-liquidity/sdk)
├── tests/                  # E2E integration tests
├── .github/workflows/      # CI/CD pipelines
├── docker-compose.yml      # Local dev environment
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
└── README.md               # You are here

Frontend and Smart Contract source code lives in their own dedicated repositories (linked above as git submodules).

• Node.js 18+
• Rust 1.74+
• Stellar CLI
• Docker (for E2E tests)

git clone --recurse-submodules https://github.com/Invoice-Liquidity-Network/Invoice-Liquidity-Network.git
cd Invoice-Liquidity-Network

# Or if already cloned:
git submodule update --init --recursive

docker-compose up -d          # Start local Stellar node
npm run test:e2e              # Run E2E integration tests

• Core Soroban contract (submit, fund, mark_paid)
• Testnet deployment
• Frontend dApp for freelancers
• LP dashboard with yield analytics
• TypeScript SDK + CLI
• Multi-token support (USDC, EURC, XLM)
• Off-chain payer verification oracle
• Formal security audit
• Mainnet deployment
• DAO governance for protocol parameters

We welcome contributions of all kinds — smart contract improvements, documentation, frontend, tests, and research.

See CONTRIBUTING.md for the full process.

MIT — see LICENSE

Built on Stellar and Soroban.