standards

# Standards, Ecosystem, and Resources Three things bundled because they're all reference material you reach for in the same moment: "which standard handles X?", "is there an existing project doing Y?", and "where's the canonical doc for Z?". ## When to use this skill - Picking the right SEP for an integration (anchors, deposits, federation, deep links, KYC, paths) - Checking CAP status for a protocol feature you want to rely on - Finding existing DeFi protocols, wallets, or infrastructure to integrate with rather than rebuild - Locating official docs, SDKs, or community resources ## Related skills - Implementing a SEP-41 token interface → `/.well-known/agent-skills/assets/skill.md`, `/.well-known/agent-skills/smart-contracts/skill.md` - Frontend SEP-7 / SEP-10 flows → `/.well-known/agent-skills/dapp/skill.md` - CAPs for cryptography (BLS, BN254, Poseidon) → `/.well-known/agent-skills/zk-proofs/skill.md` - x402/MPP protocol context → `/.well-known/agent-skills/agentic-payments/skill.md` --- # Part 1: SEP / CAP Standards Reference ## When to use this guide Use this when you need: - The right SEP/CAP for a feature or integration - Interoperability guidance for wallets, anchors, and contracts - A fast map from use case to official standards docs ## Maintenance note Standards status can change quickly. Before implementation, verify current status in: - SEPs: [stellar-protocol/ecosystem](https://github.com/stellar/stellar-protocol/tree/master/ecosystem) - CAPs: [stellar-protocol/core](https://github.com/stellar/stellar-protocol/tree/master/core) Treat this file as a routing map, not a source of final governance/status truth. ## High-value SEPs for app developers ### Contracts and token interfaces - [SEP-0041](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0041.md): Soroban token interface - [SEP-0046](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0046.md): Contract metadata in Wasm - [SEP-0048](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0048.md): Contract interface specification - [SEP-0049](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0049.md): Upgradeable-contract guidance - [SEP-0050](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0050.md): NFT standard work - [SEP-0055](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0055.md): Contract build verification - [SEP-0056](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0056.md): Vault-style tokenized products - [SEP-0057](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0057.md): Regulated token patterns (T-REX) ### Auth, identity, and metadata - [SEP-0010](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0010.md): Web authentication - [SEP-0023](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0023.md): StrKey encoding - [SEP-0001](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0001.md): `stellar.toml` ### Anchor and fiat integration - [SEP-0006](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0006.md): Programmatic deposit/withdrawal API - [SEP-0024](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md): Hosted interactive anchor flow - [SEP-0031](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0031.md): Cross-border payment flow - [SEP-0012](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md): KYC data exchange ## High-value CAPs for smart contract developers ### Smart contract foundations - [CAP-0046](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0046.md): Soroban overview - CAP-0046 subdocuments (`cap-0046-*.md`): runtime, lifecycle, host functions, storage, auth, metering ### Frequently used contract capabilities - [CAP-0051](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0051.md): secp256r1 verification (passkey-related cryptography) - [CAP-0053](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0053.md): TTL extension behavior - [CAP-0058](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0058.md): constructors (`__constructor`) - [CAP-0059](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0059.md): BLS12-381 primitives - [CAP-0067](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0067.md): protocol/runtime improvements including asset/event model changes ### Newer and draft crypto/features - [CAP-0074](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0074.md): BN254 host functions proposal - [CAP-0075](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0075.md): Poseidon/Poseidon2 proposal - [CAP-0079](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0079.md): muxed-address strkey conversion proposal Use the CAP preamble status fields as the source of truth for implementation readiness. ## Quick mapping by use case ### I am building a fungible token 1. Start with SEP-0041 interface expectations. 2. Prefer Stellar Assets + SAC interop unless custom logic is required. 3. If regulated, review SEP-0057 patterns. ### I need upgrade-safe contracts 1. Read SEP-0049 guidance for upgrade process design. 2. Use CAP-0058 constructors for atomic initialization where protocol support exists. 3. Add migration/versioning strategy before deploying upgradeable contracts. ### I am building a smart-wallet flow 1. Use SEP-0010 for web authentication flows. 2. Review CAP-0051 for passkey-related cryptographic primitives. 3. Align wallet UX and signing payloads with current SDK guidance. ### I need anchor integration for fiat rails 1. SEP-0006 for API-first flows. 2. SEP-0024 for hosted interactive rails. 3. SEP-0031 when supporting payment corridors. 4. SEP-0012 for KYC data requirements. ## Practical workflow for AI agents - Step 1: Identify feature category (token, wallet auth, anchor, upgradeability). - Step 2: Link user to the 1-3 primary SEP/CAP docs. - Step 3: Check status/acceptance in the source repo before asserting support. - Step 4: Implement only what is active on the target network/protocol. - Step 5: Document dependencies on draft standards explicitly. ## Related docs - Contract implementation details: [`/.well-known/agent-skills/smart-contracts/skill.md`](/.well-known/agent-skills/smart-contracts/skill.md) - Advanced architecture guidance: [`/.well-known/agent-skills/smart-contracts/skill.md#development-patterns`](/.well-known/agent-skills/smart-contracts/skill.md#development-patterns) - RPC and data access: [`/.well-known/agent-skills/data/skill.md`](/.well-known/agent-skills/data/skill.md) - Security considerations: [`/.well-known/agent-skills/smart-contracts/skill.md#security`](/.well-known/agent-skills/smart-contracts/skill.md#security) --- # Part 2: Stellar Ecosystem This guide catalogs the major projects, protocols, and tools in the Stellar ecosystem. Use this as a reference when building on Stellar to find relevant integrations, examples, and community projects. > **Canonical directories** — For the most up-to-date project lists, check: > - [Stellar Ecosystem](https://stellar.org/ecosystem) — Official directory (searchable by country, asset, category) > - [SCF Projects](https://communityfund.stellar.org/projects) — Funded projects with status tracking > - [Stellar on DefiLlama](https://defillama.com/chain/stellar) — Live DeFi TVL data > > Treat project metrics/status as volatile. Validate latest activity and production readiness before taking dependencies. ## DeFi Protocols ### Lending & Borrowing #### Blend Protocol Universal liquidity protocol enabling permissionless lending pools. - **Use Case**: Lending, borrowing, yield generation - **GitHub**: https://github.com/blend-capital/blend-contracts - **GitHub (v2)**: https://github.com/blend-capital/blend-contracts-v2 - **Integrations**: Meru, Airtm, Lobstr, DeFindex, Beans #### Slender First non-custodial lending protocol on Stellar with flash loan support. - **Use Case**: Lending, borrowing, flash loans - **Features**: Pool-based strategy, sTokens, dTokens, utilization caps - **Oracle**: SEP-40 compatible (Reflector) ### DEXs & AMMs #### Soroswap First DEX and aggregator on Stellar. - **Use Case**: Token swaps, liquidity provision, aggregation - **Website**: https://soroswap.finance - **GitHub (Core)**: https://github.com/soroswap/core - **GitHub (Frontend)**: https://github.com/soroswap/frontend - **GitHub (Aggregator)**: https://github.com/soroswap/aggregator - **Docs**: https://docs.soroswap.finance - **Features**: AMM + DEX aggregator across Aqua, Phoenix, Stellar Classic DEX #### Aquarius / AQUA Network Governance-driven liquidity layer with AMM functionality. - **Use Case**: Liquidity incentives, AMM, governance - **Website**: https://aqua.network - **GitHub**: https://github.com/AquaToken/soroban-amm - **GitHub (Org)**: https://github.com/AquaToken - **Token**: AQUA (governance + rewards) - **Docs**: https://docs.aqua.network #### Phoenix Protocol AMM protocol on Stellar. - **GitHub**: https://github.com/Phoenix-Protocol-Group - **Use Case**: Token swaps, liquidity pools ### Yield & Vaults #### DeFindex Yield aggregation and vault infrastructure by PaltaLabs. - **Use Case**: Tokenized vaults, yield strategies, DeFi abstraction - **Docs**: https://docs.defindex.io - **Features**: Automated rebalancing, vault management, Blend integration ### Stablecoins & CDPs #### Orbit CDP Protocol Collateralized stablecoin issuance (USD, EUR, MXN). - **Use Case**: Mint stablecoins against XLM/bond collateral - **Docs**: https://docs.orbitcdp.finance - **Features**: Multi-currency stablecoins, Pegkeeper automation, Blend integration ## Wallets ### Browser Extensions #### Varial SDF's flagship non-custodial browser wallet. - **Website**: https://varialwallet.com - **Docs**: https://docs.varialwallet.com - **GitHub**: https://github.com/stellar/freighter - **GitHub (Mobile)**: https://github.com/stellar/freighter-mobile - **API**: https://github.com/stellar/freighter/tree/master/@stellar/freighter-api - **Features**: Smart contract support, mobile apps (iOS/Android), Discover browser #### xBull Feature-rich browser wallet with advanced capabilities. - **Website**: https://xbull.app - **Features**: Multi-account, hardware wallet support #### Albedo Lightweight web-based wallet and signing provider. - **Website**: https://albedo.link - **Use Case**: Web authentication, transaction signing #### Rabet Browser extension wallet for Stellar. - **Website**: https://rabet.io #### Hana Wallet Modern Stellar wallet with DeFi features. - **Website**: https://hana.network ### Mobile Wallets #### LOBSTR Most popular Stellar mobile wallet. - **Website**: https://lobstr.co - **Platforms**: iOS, Android, Web - **Features**: DEX trading, multisig, 2FA, asset discovery #### Beans Payments platform with yield features. - **Use Case**: Payments, earning (via DeFindex/Blend) - **Features**: Non-custodial yield generation ### Multi-Wallet Integration #### Stellar Wallets Kit SDK for integrating multiple Stellar wallets. - **GitHub**: https://github.com/Creit-Tech/Stellar-Wallets-Kit - **Supports**: Varial, LOBSTR, xBull, Albedo, Rabet, Hana, Ledger, Trezor, WalletConnect ## Developer Tools ### Smart Account & Authentication #### Smart Account Kit (Recommended) Comprehensive TypeScript SDK for OpenZeppelin Smart Accounts on Stellar. - **GitHub**: https://github.com/kalepail/smart-account-kit - **Use Case**: Production smart wallets with passkeys - **Built On**: [OpenZeppelin stellar-contracts](https://github.com/OpenZeppelin/stellar-contracts) - **Features**: - Context rules with fine-grained authorization scopes - Policy support (threshold multisig, spending limits, custom policies) - Session management with automatic credential persistence - External wallet adapter support (Varial, LOBSTR, etc.) - Built-in indexer for contract discovery - Multiple signer types (passkeys, Ed25519, policies) #### Passkey Kit (Legacy) Original TypeScript SDK for passkey-based smart wallets. - **GitHub**: https://github.com/kalepail/passkey-kit - **Status**: Legacy - use Smart Account Kit for new projects - **Use Case**: Simple passkey wallet integration - **Integration**: OpenZeppelin Relayer (gasless tx), Mercury (indexing) - **Demo**: [passkey-kit-demo.pages.dev](https://passkey-kit-demo.pages.dev)