stellar/stellar-dev-skill

standards

Stellar standards, ecosystem, and reference.

View source
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

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?".

This file carries the SEP/CAP standards routing map. The other two live alongside it — read the file that matches the task:

TaskFile
Pick the right SEP/CAP, check standard status, map a use case to standards docsthis file
Find DeFi protocols, wallets, dev tools, indexers, oracles, bridges, builder teams, funding programsecosystem.md
Locate official docs, SDKs, CLI tools, testing guides, RPC providers, learning resources, community linksresources.md

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 → ../assets/SKILL.md, ../smart-contracts/SKILL.md
  • Frontend SEP-7 / SEP-10 flows → ../dapp/SKILL.md
  • CAPs for cryptography (BLS, BN254, Poseidon) → ../zk-proofs/SKILL.md
  • x402/MPP protocol context → ../agentic-payments/SKILL.md

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:

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

Auth, identity, and metadata

Anchor and fiat integration

High-value CAPs for smart contract developers

Smart contract foundations

  • CAP-0046: Soroban overview
  • CAP-0046 subdocuments (cap-0046-*.md): runtime, lifecycle, host functions, storage, auth, metering

Frequently used contract capabilities

  • CAP-0051: secp256r1 verification (passkey-related cryptography)
  • CAP-0053: TTL extension behavior
  • CAP-0058: constructors (__constructor)
  • CAP-0059: BLS12-381 primitives
  • CAP-0067: protocol/runtime improvements including asset/event model changes

Newer and draft crypto/features

  • CAP-0074: BN254 host functions (G1 add/mul, pairing check) — Final, Protocol 25+
  • CAP-0075: Poseidon/Poseidon2 permutation primitives — Final, Protocol 25+
  • CAP-0079: muxed-address strkey conversion proposal
  • CAP-0080: BN254 G1 MSM, Fr arithmetic, on-curve checks — Implemented, Protocol 26+

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

from this repository

More skills

All skills
stellar
Community

agentic-payments

Agentic and machine-to-machine payments on Stellar. Covers x402 (HTTP 402 paid APIs via OZ Channels facilitator, fee-sponsored clients) and MPP (Machine Payments Protocol) in both Charge mode (per-request SAC) and Session mode (channel-backed off-chain commits, high-frequency; formerly called Channel mode). Defaults to USDC (SEP-41 SAC) on stellar:testnet/stellar:pubnet (CAIP-2). Use when selling a paid API to AI agents, building an x402 client, or designing a payment-channel architecture for high-frequency agent traffic.

installs
2
GitHub stars
51
Updated
Sep 5
stellar
Community

assets

Stellar Assets (classic) + trustlines + Stellar Asset Contract (SAC) bridge to smart contracts. Covers asset issuance, distribution, authorization flags, clawback, regulated assets, trustline management, and the SAC interop layer that exposes classic assets as SEP-41 contract tokens. Use when tokenizing real-world assets, issuing stablecoins, managing trustlines, or bridging classic assets to smart contracts.

installs
2
GitHub stars
51
Updated
Sep 5
stellar
Community

cross-chain

Cross-chain interoperability for Stellar. Entry point with a rail-selection decision table and shared pitfalls, routing to three companion files — cctp.md (Circle CCTP V2, native USDC burn-and-mint between Stellar and EVM/Solana chains, domain 27, the CctpForwarder requirement for Stellar recipients), axelar.md (Axelar GMP for Soroban contracts calling contracts on other chains, and the Interchain Token Service for multichain tokens), and layerzero.md (LayerZero V2 OApp messaging with configurable DVN security, OFT omnichain tokens, and USDT0 — native USDT on Stellar). Also covers NEAR Intents (intent-based cross-chain swaps into XLM or Stellar USDC) at the routing level. Use when bridging USDC or USDT to or from Stellar, sending messages between a Stellar contract and another blockchain, making a token exist on multiple chains, or adding cross-chain swaps to an app.

installs
2
GitHub stars
51
Updated
Sep 5
stellar
Community

dapp

Stellar dApp / frontend development. Covers the JavaScript stellar-sdk (browser + Node.js), Freighter wallet, Stellar Wallets Kit (multi-wallet), Wallet Standard, smart accounts with passkeys, transaction building / signing / submission, smart contract invocation from the client, simulation, and error handling. Use when building a React/Next.js/Node.js app that talks to Stellar — classic operations or smart contracts.

installs
2
GitHub stars
51
Updated
Sep 5