Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions architecture/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,10 @@ One NestJS server deployment with a chain connector registry. The core agent eng

![TEE Server Architecture](/assets/diagrams/tee-server.svg)

The Stellar connector keeps the same high-level stealth payment shape while using Stellar-native primitives: StrKey accounts, Soroban event announcements, ed25519 signing, and fee-bump envelopes where a sponsor pays the outer transaction fee.

![Stellar stealth flow](/assets/diagrams/stellar/stealth-flow-stellar.svg)

## Module Structure

```
Expand Down
39 changes: 39 additions & 0 deletions assets/diagrams/stellar/fee-bump-withdrawal-stellar.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
36 changes: 36 additions & 0 deletions assets/diagrams/stellar/key-derivation-stellar.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 35 additions & 0 deletions assets/diagrams/stellar/name-resolution-stellar.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
45 changes: 45 additions & 0 deletions assets/diagrams/stellar/stealth-flow-stellar.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
44 changes: 44 additions & 0 deletions assets/diagrams/stellar/view-tag-scan-stellar.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 15 additions & 0 deletions sdk/chains/stellar.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,20 @@ Low-level stealth address functions for Stellar using ed25519. Import from `@wra

Most developers should use the [Agent Client](/sdk/agent-client) instead. These primitives are for power users building custom stealth address integrations on Stellar.

## Stellar Flow Diagrams

These diagrams show the Stellar-specific version of the stealth flow: StrKey accounts, Soroban announcements, ed25519 key derivation, view tags, name resolution, and fee-bump withdrawals.

![Stellar stealth flow](/assets/diagrams/stellar/stealth-flow-stellar.svg)

![Stellar key derivation](/assets/diagrams/stellar/key-derivation-stellar.svg)

![Stellar view tag scan](/assets/diagrams/stellar/view-tag-scan-stellar.svg)

![Stellar name resolution](/assets/diagrams/stellar/name-resolution-stellar.svg)

![Stellar fee-bump withdrawal](/assets/diagrams/stellar/fee-bump-withdrawal-stellar.svg)

## Installation

```bash
Expand Down Expand Up @@ -381,6 +395,7 @@ for (const m of matched) {
- **Account creation:** Stellar requires accounts to exist with a minimum balance (1 XLM). Sending to a new stealth address uses `Operation.createAccount`, not `Operation.payment`.
- **Announcements:** Come from Soroban contract events via `sorobanServer.getEvents()`, not a subgraph. Use `fetchAnnouncements("stellar")` to handle this automatically.
- **Signing:** Must use `signWithScalar()` / `signStellarTransaction()` because stealth scalars aren't valid seeds for `Keypair.fromRawEd25519Seed()`.
- **Fee bumps:** Withdrawals can be wrapped in a sponsored fee-bump transaction when the stealth account should not keep extra XLM only for fees.

## Chain Deployments

Expand Down