primer · onchain

Four Stellar primitives, demystified.

Every idea in this repo leans on one of four Stellar primitives. Each one runs against the Stellar Testnet (a free, real network) so you can ship a verifiable demo with zero hosting and zero fees paid by your users — Privy signs each transaction with an embedded Ed25519 key.

The six secrets

Add these in your Lovable project (Settings → Secrets) before pasting any mega-prompt:

  • STELLAR_DEPLOYER_SECRETS… secret key of a funded Testnet account. Get one at stellarfaucet.lovable.app.open ↗
  • SOROBAN_RPC_URLSoroban RPC endpoint. Public: https://soroban-testnet.stellar.org.open ↗
  • HORIZON_URLHorizon endpoint (account lookups, streaming). https://horizon-testnet.stellar.org.open ↗
  • STELLAR_NETWORK_PASSPHRASE"Test SDF Network ; September 2015" for Testnet.open ↗
  • PRIVY_APP_IDPrivy app ID (public). Provisions the embedded Stellar wallet on email / Google sign-in.open ↗
  • PRIVY_APP_SECRETPrivy app secret (server-only). Verifies the user token and raw-signs the tx hash with the embedded Ed25519 key.open ↗
  • PINATA_JWTPin media / metadata to IPFS.open ↗
onchain logic

Soroban smart contract

250 ideas use this
kernel
a Rust Soroban contract compiled to wasm, deployed to Stellar Testnet with the Stellar CLI, and inspectable on Stellar Expert
drives the UI as
a 'verified onchain' badge with the live contract ID and a Stellar Expert link
decentralized storage

IPFS via Pinata

247 ideas use this
kernel
a Pinata JWT upload that pins images / JSON / manifests to IPFS and returns a permanent CID, stored back into Soroban state
drives the UI as
a 'pinned to IPFS' chip with the CID and a public gateway preview
wallet UX

Lobstr wallet via WalletConnect

249 ideas use this
kernel
Stellar Wallets Kit paired with Lobstr mobile through WalletConnect v2 — a QR pairing modal, phone-side approvals, no seed phrase in the browser
drives the UI as
a single 'Connect Lobstr' button that opens a QR modal and returns a G… Stellar address
onchain authorship

Soroban NFT provenance

250 ideas use this
kernel
a Soroban token contract that mints a creator-owned entry pointing at an IPFS CID and records the author's Stellar address in contract state
drives the UI as
a 'mint to claim authorship' button that returns the token ID, owner address, and Stellar Expert link