# Agama on Stellar

> Deposit a tokenized stock, get more of it back. A holder of a tokenized share can only hold it; Agama turns it into a position that grows: the protocol borrows USDC against it on Blend, puts that USDC to work in a private-credit vault, and permissionless agents turn the yield back into more of the same stock. Live on Stellar testnet, contracts in Soroban, prices from RedStone verified on chain.

What makes it different from a lending front end: a falling price is repaid out of the protocol's own buffer rather than by selling the user's stock, because the collateral is what the user came here to keep. What grows is the share count, not a stablecoin balance.

No tokenized equity exists on Stellar yet, DTCC's is coming, so the shares, gold, BENJI and USDC here are stand-ins this repository deploys and hands out. The prices, the lending, the signature verification and the agents are real.

## Try it

- [Earn](https://app.agama.finance/stellar-rwa): deposit a stock, pick the level the agents hold, the vault yield becomes more stock
- [Amplify](https://app.agama.finance/stellar-rwa/amplify): deposit a stock and hold a multiple of it, capped at 1/(1-LTV), which is 3.33x at 70%
- [Portfolio](https://app.agama.finance/stellar-rwa/portfolio): every position, and what the agents last did to each
- [Faucet](https://app.agama.finance/stellar-rwa/faucet): 10,000 USDC and 10 of each of the ten markets, in one call
- [Snapshot API](https://app.agama.finance/stellar-rwa/api/snapshot): the whole screen as JSON, markets, prices, positions, pool and vault

## Code

- [Repository](https://github.com/agamafinance/agama-stellar): Rust contracts, the keeper, the app, the scripts that verify it
- [README](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/README.md): what it builds, what it reuses, and what testnet forced
- [Core contract](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/contracts/core/src/lib.rs): markets, both products, the buffer, the three agents
- [Position contract](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/contracts/position/src/lib.rs): one contract per owner, market and product; Blend's borrower of record
- [Oracle contract](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/contracts/oracle/src/lib.rs): SEP-40, verifying RedStone signatures on chain
- [Vault contract](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/contracts/vault/src/lib.rs): a deposit lands, a withdrawal queues, which is what a credit book does
- [Keeper](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/keeper/run.py): rebuilds RedStone payloads, pushes prices, runs the agents
- [Nido session keys](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/web/lib/nido/agama.ts): one Perch rule per contract in a call's authorization tree
- [Passkey end to end](https://raw.githubusercontent.com/agamafinance/agama-stellar/main/scripts/nido/e2e.mjs): makes an account, funds it, grants, deposits, closes, loops, unwinds

## On chain, on Stellar testnet

- [Core](https://stellar.expert/explorer/testnet/contract/CBT6PZFSMT7D6K7L25QRFXACF7U5EHZA7II7KIOR7FREF3XB2SAZYAFD): CBT6PZFSMT7D6K7L25QRFXACF7U5EHZA7II7KIOR7FREF3XB2SAZYAFD
- [Oracle](https://stellar.expert/explorer/testnet/contract/CBTNXB4KM4UKW25Z6UF22FOABSYS6AFJP34Y4DXBCLIQNYVPK255PJ6M): CBTNXB4KM4UKW25Z6UF22FOABSYS6AFJP34Y4DXBCLIQNYVPK255PJ6M
- [Vault](https://stellar.expert/explorer/testnet/contract/CCVVFPL5ZUTBEKJYS4AGRPFHLOO42TPTUMACHXBQPUW3YTZ23AIAE5GF): CCVVFPL5ZUTBEKJYS4AGRPFHLOO42TPTUMACHXBQPUW3YTZ23AIAE5GF
- [Blend pool](https://stellar.expert/explorer/testnet/contract/CCNJ6D3ITLT22QCVNTD3AVEY4ANE3FYXSKIQTLFXTLPOSPWLWWTPHCCG): our own instance, because the shared testnet pool can never leave supply-only mode for us

## Optional

- [llms-full.txt](https://app.agama.finance/llms-full.txt): the whole dossier, including the walls this hit and what each one taught
- [Sitemap](https://app.agama.finance/sitemap.xml)
- [Agama](https://agama.finance): the company, and the same product on Solana, X Layer, Monad, Sui and Starknet