Soroban smart contracts in Rust — the core on-chain logic of the TheGist protocol.

Every gist posted through TheGist is anchored here. No backend can forge, censor, or silently delete a record stored in these contracts.

The primary contract. Every gist posted to TheGist is an entry in the GistRegistry.

All writes require a valid Stellar signature. The contract emits a GistPosted event on every successful write, which the indexer (TheGist-API) consumes.

An optional tipping vault. Users can send XLM tips to gist authors anonymously via Soroban escrow — no direct wallet-to-wallet transfer required. The author can withdraw accumulated tips at any time. The sender's identity is not linked to the recipient's identity on-chain beyond the transaction itself.

Validates that a submitted geohash falls within an allowed geographic boundary. Used to enforce region-scoped deployments or to prevent spam from coordinates that don't correspond to real locations. Boundary definitions are stored as contract data and can be updated by the contract admin.

• Rust — rustup.rs
• wasm32 target: rustup target add wasm32v1-none
• Soroban CLI: cargo install --locked stellar-cli --features opt

This repo is a Cargo workspace with one crate per contract, so each contract builds to its own .wasm artifact — a single deployed Soroban contract can only export one contract's functions, so the three contracts can't share a build.

cargo build --workspace --target wasm32v1-none --release

Compiled .wasm artifacts are output to target/wasm32v1-none/release/: gist_registry.wasm, gist_vault.wasm, location_verifier.wasm. make build copies them into artifacts/.

cargo test --workspace

Unit and integration tests live alongside each contract crate, under contracts/<contract>/tests/. All new contract logic must be covered before opening a PR.

Use the scripted flow in docs/DEPLOYMENT.md.

These will be populated after the initial testnet deployment.

Each contract is its own crate in a Cargo workspace, so it can be built and deployed as an independent .wasm artifact:

TheGist-contracts/
├── contracts/
│   ├── gist-registry/
│   │   ├── src/lib.rs        # GistRegistry contract
│   │   └── tests/gist_registry_test.rs
│   ├── gist-vault/
│   │   ├── src/lib.rs        # GistVault tipping contract
│   │   ├── src/gist_vault_test.rs
│   │   └── tests/gist_vault_test.rs
│   └── location-verifier/
│       ├── src/lib.rs        # LocationVerifier contract
│       └── tests/location_verifier_test.rs
├── Cargo.toml                 # workspace root
└── README.md

• If you are changing a public contract interface, open an issue in theGist-Meta before implementing — interface changes affect every client.
• All new behaviour must have test coverage in tests/.
• Keep contract functions small, explicit, and free of unnecessary state.

For global contribution rules, see CONTRIBUTING.md.

MIT