Stellar Development Skills

Build on Stellar from your terminal

Install the official Stellar development skills, then choose the topics relevant to your project. The API reference and Stellar8004 SDK examples are below.

Stellar development skills

Official skills for Soroban contracts, Stellar apps, assets, data, payments, standards, cross-chain integrations, and zero-knowledge proofs.

REST API v1

API Reference

Public read-only API for indexed agent data and the matching TypeScript SDK for writes plus explorer reads. Base URL: https://stellar8004.com

Endpoints

OpenAPI spec
GET /api/v1/agents

List all agents with pagination and filtering

GET /api/v1/agents/:id

Get agent details including metadata and scores

GET /api/v1/agents/:id/feedback

List feedback for a specific agent

GET /api/v1/accounts/:address/agents

List agents owned by a wallet address

GET /api/v1/search?q=...

Full-text search across agents

GET /api/v1/stats

Aggregate network statistics

GET /api/v1/health

Indexer health status

GET /api/v2/discovery?network=mainnet

Cursor-paged discovery: strict filters, stable score/newest/id order, 0-100 score

Quick Start

TypeScript SDK

SDK Quick Start

The SDK gives you one surface for testnet funding, metadata building, automatic storage selection, Soroban contract writes, and read-only explorer queries. The fastest onboarding path is: fund -> signer -> client -> metadata -> storage -> register.

Prerequisites

Stellar keypairs

Use Keypair.random() for a disposable testnet identity or Keypair.fromSecret(secret) to automate an existing wallet.

Funding

On testnet you can use fundTestnet() or the Stellar Lab faucet. On mainnet you must provide your own XLM and override TESTNET_CONFIG.

Pinata JWT

Optional. AutoStorage only needs PINATA_JWT when metadata grows past the 8KB data URI limit.

Five-step flow

  1. 1

    Install the SDK and tsx for one-file scripts.

  2. 2

    Create or load a Stellar keypair and fund it on testnet.

  3. 3

    Build metadata with buildMetadataJson() and inspect its byte size.

  4. 4

    Upload through AutoStorage so small payloads stay as data URIs.

  5. 5

    Register on Soroban, then verify through the Explorer API.

Minimal register example

Registration Flow

The diagram below shows the happy path from local script or browser app to on-chain registration and indexed discovery.

Example Register Script

Save as register.ts and run npx tsx register.ts.

API Client Examples

Browser and CORS notes

  • ExplorerClient wraps the same public GET endpoints documented above, so it works anywhere fetch is available.
  • For browser apps, point it at https://stellar8004.com for direct public reads.
  • If your own mirror or proxy tightens cross-origin rules, call the explorer from your backend instead and keep the client code unchanged.
  • Writes use the contract binding clients (e.g. IdentityClient), which sign locally and submit directly to Soroban RPC.

Response Format

Rate Limits

Anonymous 30 req/min IP-based, best-effort

Error Responses

400 INVALID_PARAM

Invalid or unknown query parameter

400 MISSING_PARAM

Required parameter missing

400 INVALID_ID

Agent ID is not a number

400 INVALID_ADDRESS

Not a Stellar account address

400 INVALID_CURSOR

Cursor is malformed or from another query

404 NOT_FOUND

Agent or endpoint not found

405 METHOD_NOT_ALLOWED

Only GET is supported

429 RATE_LIMITED

Over 30 requests per minute

500 INTERNAL_ERROR

Server error, retry with backoff

503 INDEX_STALE

Discovery only: the index is behind the chain