stellar-skills — Готовые навыки для разработки смарт-контрактов

--- name: stellar-skills description: Stellar blockchain and Soroban smart contract development. SDKs, wallets, DeFi protocols, and ecosystem tools. Use when building dApps on Stellar, writing Soroban contracts, integrating wallets, or working with Horizon/Soroban RPC. --- # Stellar & Soroban Development ## Quick Reference ### Networks | Network | Horizon | Soroban RPC | Explorer | |---------|---------|-------------|----------| | **Mainnet** | `horizon.stellar.org` | `soroban-rpc.mainnet.stellar.gateway.fm` | stellar.expert | | **Testnet** | `horizon-testnet.stellar.org` | `soroban-testnet.stellar.org` | stellar.expert/explorer/testnet | | **Futurenet** | `horizon-futurenet.stellar.org` | `rpc-futurenet.stellar.org` | stellarchain.io | ### Faucet (Testnet) ```bash curl "https://friendbot.stellar.org?addr=YOUR_PUBLIC_KEY" ``` --- ## CLIs & Scaffolds | Tool | Use | |------|-----| | **stellar CLI** | Build, deploy, invoke contracts, generate TS bindings | | **Scaffold Stellar** | Full project (Soroban + frontend + local network) → scaffoldstellar.org | | **Stellar Lab** | Web tool for network experiments → lab.stellar.org | --- ## SDKs | Library | Purpose | |---------|---------| | `@stellar/stellar-sdk` | Official JS/TS SDK (classic + Soroban) | | `soroban-sdk` (Rust) | Write Soroban smart contracts | | `@stellar/freighter-api` | Direct Freighter wallet integration | | `@creit.tech/stellar-wallets-kit` | Multi-wallet abstraction → stellarwalletskit.dev | --- ## Workflows ### Workflow 1: Connect Wallet (Stellar Wallets Kit) ```typescript import { StellarWalletsKit, WalletNetwork, allowAllModules } from '@creit.tech/stellar-wallets-kit'; const kit = new StellarWalletsKit({ network: WalletNetwork.TESTNET, selectedWalletId: 'freighter', modules: allowAllModules(), }); // Open modal to select wallet await kit.openModal({ onWalletSelected: async (option) => { kit.setWallet(option.id); const { address } = await kit.getAddress(); console.log('Connected:', address); } }); ``` ### Workflow 2: Deploy Contract (stellar CLI) ```bash # Build contract stellar contract build # Deploy to testnet stellar contract deploy --wasm target/wasm32-unknown-unknown/release/my_contract.wasm --source alice --network testnet # Generate TypeScript bindings stellar contract bindings typescript --contract-id CXXXXX... --output-dir ./src/contracts/my-contract --network testnet ``` ### Workflow 3: Invoke Contract ```typescript import * as StellarSdk from '@stellar/stellar-sdk'; const server = new StellarSdk.SorobanRpc.Server('https://soroban-testnet.stellar.org'); const contract = new StellarSdk.Contract('CXXXXX...'); // Build transaction const tx = new StellarSdk.TransactionBuilder(account, { fee: '100' }) .addOperation(contract.call('method_name', ...args)) .setTimeout(30) .build(); // Simulate const simulated = await server.simulateTransaction(tx); // Sign with wallet kit const { signedTxXdr } = await kit.signTransaction(tx.toXDR()); // Submit const result = await server.sendTransaction( StellarSdk.TransactionBuilder.fromXDR(signedTxXdr, StellarSdk.Networks.TESTNET) ); ``` ### Workflow 4: Sign & Submit with Wallet Kit ```typescript // For Soroban transactions that need simulation const signedTx = await kit.signTransaction(tx.toXDR(), { networkPassphrase: StellarSdk.Networks.TESTNET, }); // Submit and poll for result const sendResponse = await server.sendTransaction( StellarSdk.TransactionBuilder.fromXDR(signedTx.signedTxXdr, StellarSdk.Networks.TESTNET) ); if (sendResponse.status === 'PENDING') { let result = await server.getTransaction(sendResponse.hash); while (result.status === 'NOT_FOUND') { await new Promise(r => setTimeout(r, 1000)); result = await server.getTransaction(sendResponse.hash); } } ``` --- ## OpenZeppelin Contracts (Soroban) Audited contracts. **Check before writing custom logic.** | Category | Includes | |----------|----------| | **Tokens** | Fungible, NFT, RWAs, Stablecoin, Vault (SEP-56) | | **Access** | Ownable, Role-Based Access Control | | **Utils** | Pausable, Upgradeable, Merkle Distributor | Wizard: https://wizard.openzeppelin.com Docs: https://docs.openzeppelin.com/stellar-contracts --- ## Security | Tool | Use | |------|-----| | **Scout Audit** | Static analysis for Soroban → github.com/CoinFabrik/scout-soroban | | **scout-actions** | GitHub Action for PR checks | ```bash # Run Scout locally cargo install scout-audit scout-audit --path ./contracts ``` --- ## Ecosystem ### DeFi & Protocols | Project | What | |---------|------| | **Soroswap** | AMM/DEX → soroswap.finance | | **Defindex** | Yield aggregator → defindex.io | | **Allbridge** | Cross-chain bridge → allbridge.io | | **Reflector** | Oracles (SEP-40) → reflector.network | ### Infrastructure & Services | Project | What | |---------|------| | **Trustless Work** | Programmable escrows → trustlesswork.com | | **Mercury** | Custom indexer (Retroshades, Zephyr) → mercurydata.app | | **Horizon API** | Official API for network queries | | **Anchor Platform** | On/off-ramps (SEP-10, SEP-24, SEP-31) | | **Stellar Disbursement Platform** | Mass payouts infrastructure | | **MoneyGram Ramps** | USDC on/off-ramp at retail locations | ### Block Explorers | Explorer | Networks | |----------|----------| | **StellarExpert** | Mainnet, Testnet → stellar.expert | | **StellarChain** | Mainnet, Testnet, Futurenet → stellarchain.io | | **Stellar Explorer** | All networks | ### RPC Providers | Provider | Notes | |----------|-------| | SDF (public) | Default, rate limited | | Validation Cloud | Free + premium | | Ankr | Horizon + Soroban RPC | | QuickNode | Performance tiers | --- ## SEPs (Stellar Ecosystem Proposals) | SEP | Purpose | |-----|---------| | **SEP-10** | Web Authentication | | **SEP-24** | Interactive deposits/withdrawals | | **SEP-41** | Soroban token interface | | **SEP-56** | Tokenized Vault Standard | All SEPs: github.com/stellar/stellar-protocol/tree/master/ecosystem --- ## Decision Framework ``` What are you building? │ ├─ **Smart Contract** (Soroban) │ ├─ Token? → Check OpenZeppelin first │ ├─ DeFi? → Integrate with Soroswap/Defindex │ └─ Custom logic → Use soroban-sdk + Scout audit │ ├─ **Frontend dApp** │ ├─ Wallet connection → Stellar Wallets Kit │ ├─ Contract interaction → @stellar/stellar-sdk │ └─ Full scaffold → Scaffold Stellar │ ├─ **Backend/Indexing** │ ├─ Simple queries → Horizon API │ ├─ Custom indexing → Mercury │ └─ Real-time → Soroban RPC subscriptions │ └─ **Payments/Ramps** ├─ On/off-ramp → Anchor Platform └─ Mass payouts → Stellar Disbursement Platform ``` --- ## Docs - https://developers.stellar.org - https://soroban.stellar.org/docs - https://stellarwalletskit.dev **Principle**: Check for existing tools/protocols before writing custom code.