Stellar

Stellar Integration

How StellarNotherc uses Stellar's native primitives for payments, FX conversion, and fee management.

Why Stellar

Stellar was designed for cross-border payments. Three properties make it a natural fit for a payment-native agent protocol:

  • Finality in 3–5 seconds. SCP prioritizes safety over liveness. Transactions confirm quickly or fail cleanly. No reorgs.
  • Sub-cent fees. Base fee is 100 stroops (0.00001 XLM). Even during surges, fees are orders of magnitude cheaper than EVM chains.
  • Atomic cross-asset conversion. Path payments route through the built-in SDEX, converting assets in a single operation.

Operations Used

OperationPurpose
paymentNative XLM transfers for tool purchases, refunds, and direct settlement. No trustline required.
pathPaymentStrictReceiveCross-asset atomic conversion via SDEX. Receiver gets exact destination amount.
changeTrustOptional only for destination-side credit assets. Not required for the native XLM payment rail.

Deep Dives

Environment

VariablePurpose
HORIZON_URLStellar Horizon API endpoint
STELLAR_AGENT_SECRETAgent wallet signing key
FX_SERVER_WALLETMarketplace collector wallet that receives native XLM session funding and tool payments
STELLAR_NETWORK_PASSPHRASENetwork passphrase (default: Public Global Stellar Network)