Docs chevron_right Introduction

Mesa Protocol SDK

Mesa is an open-source workflow orchestration engine built specifically for Stellar fintech applications. It sits between your application logic and the Stellar network, handling multi-step transactions, retries, SEP-10 anchors, and Soroban smart contract calls with durable state safety.

replay

Durable Retries

Ledger congestion or Horizon RPC timeouts trigger automatic exponential backoff retry loops.

save

Postgres Persistence

Checkpoints state transitions to database storage so workflow progress is preserved through restarts.

security

HMAC Webhooks

Webhook callbacks use HMAC-SHA256 signature validation for secure asynchronous state updates.

Docs chevron_right SDK API Reference

Fluent FlowBuilder API

Mesa SDK uses a fluent method-chaining builder to define workflows safely.

.receive(params) Deposit Listener

Suspends flow until an incoming payment matching asset and minimum amount is received.

.receive({ asset: 'XLM', minAmount: 10, toAddress: 'G...' })

.sep10Auth(params) Anchor Authentication

Executes Stellar SEP-10 challenge signing and acquires anchor JWT token.

.sep10Auth({ anchorUrl: 'https://anchor.stellar.org' })

.convert(params) Asset Swap

Swaps assets on Stellar DEX or through an anchor rate query.

.convert({ fromAsset: 'XLM', toAsset: 'USDC' })

.payment(params) Stellar Transfer

Submits a payment operation to Horizon network with automatic sequence management.

.payment({ toAddress: 'GA4U...', amount: 25, horizonUrl: 'https://horizon-testnet.stellar.org' })

Docs chevron_right Interactive Live Playground

SDK Code Playground 🧪

Edit Mesa TypeScript SDK code live, generate AST Definition JSON, export cURL commands, and test flow execution in real-time.

Preset Templates:

edit_note TypeScript SDK Code

data_object Compiled Flow AST JSON

// Compiled AST JSON will appear here...

terminal Equivalent cURL Request

curl -X POST http://localhost:3001/api/v1/flows ...