Skip to content

Commit 526efb9

Browse files
committed
update
1 parent f1bd859 commit 526efb9

1 file changed

Lines changed: 25 additions & 33 deletions

File tree

README.md

Lines changed: 25 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99

1010
**Example applications for [dstack](https://github.com/Dstack-TEE/dstack) - Deploy containerized apps to TEEs with end-to-end security in minutes**
1111

12-
[Use Cases](#use-cases)[Architecture Walkthrough](#architecture-walkthrough)[Dev Tools](#dev-scaffolding)[Documentation](#documentation)
12+
[Use Cases](#use-cases)[Core Patterns](#core-patterns)[Dev Tools](#dev-scaffolding)[Documentation](#documentation)
1313

1414
</div>
1515

@@ -19,8 +19,6 @@
1919

2020
This repository contains ready-to-deploy examples demonstrating how to build and run applications on [dstack](https://github.com/Dstack-TEE/dstack), the developer-friendly SDK for deploying containerized apps in Trusted Execution Environments (TEE).
2121

22-
The examples are organized to follow the **TEE+EVM design patterns** from [ERC-733](https://erc733.org), walking through the key architectural layers: attestation, gateway/interoperability, key management, and on-chain interaction.
23-
2422
## Prerequisites
2523

2624
- Access to a dstack environment (self-hosted or [Phala Cloud](https://cloud.phala.network))
@@ -37,67 +35,62 @@ cd dstack-examples
3735

3836
## Use Cases
3937

40-
Real-world applications that serve as **reference implementations** for ERC-733 TEE+EVM patterns.
38+
Real-world applications you can build with dstack.
4139

4240
| Example | Description | Status |
4341
|---------|-------------|--------|
44-
| [8004-agent](./8004-agent) | Trustless AI agent (ERC-8004) with on-chain attestation, LLM access via TLS | Coming Soon |
42+
| [8004-agent](./8004-agent) | Trustless AI agent with on-chain attestation and LLM access | Coming Soon |
4543
| [oracle](./oracle) | TEE oracle returning JSON + signature + attestation bundle | Coming Soon |
4644
| [mcp-server](./mcp-server) | Attested MCP tool server behind gateway | Coming Soon |
4745
| [telegram-agent](./telegram-agent) | Telegram bot with TEE wallet and verified execution | Coming Soon |
4846

4947
---
5048

51-
## Architecture Walkthrough
49+
## Core Patterns
5250

53-
These examples teach the **layered TEE+EVM architecture** from ERC-733. Work through them in order to understand how dstack applications are built.
51+
Key building blocks for dstack applications.
5452

55-
### 1. Attestation Layer
53+
### Attestation
5654

57-
The foundation: establish trust by verifying and committing the enclave's code measurement on-chain.
55+
How to get and verify TEE attestations.
5856

59-
| Example | Description |
60-
|---------|-------------|
61-
| [attestation/configid-based](./attestation/configid-based) | ConfigID-based remote attestation verification |
62-
| [timelock-nts](./timelock-nts) | Timelock decryption using NTS (Network Time Security) |
63-
64-
**What you learn:** Code measurement, attestation documents, X.509 verification, secp256k1 enclave keys.
57+
| Example | Description | Status |
58+
|---------|-------------|--------|
59+
| [trust-center](./refs/trust-center) | Full attestation verification platform — **start here** for production attestation patterns | Reference |
60+
| [attestation-sdk](./attestation-sdk) | Using Dstack client SDK to fetch attestations | Coming Soon |
61+
| [timelock-nts](./timelock-nts) | Shows raw `/var/run/dstack.sock` usage (what the SDK wraps) | Available |
62+
| [attestation/configid-based](./attestation/configid-based) | ConfigID-based verification (demonstrates current format) | Available |
6563

66-
### 2. Gateway Layer
64+
### Gateway & Domains
6765

68-
Interoperability: TLS termination inside the enclave, domain routing, external connectivity.
66+
TLS termination, custom domains, external connectivity.
6967

7068
| Example | Description |
7169
|---------|-------------|
72-
| [custom-domain](./custom-domain) | Custom domain with automatic TLS via zt-https (model of dstack gateway) |
73-
74-
**What you learn:** TLS termination in enclave, DNS → TLS → route pattern, reverse proxy.
70+
| [dstack-ingress](./custom-domain/dstack-ingress) | **Complete ingress solution** — auto SSL via Let's Encrypt, multi-domain, DNS validation, evidence generation with TDX quote chain |
71+
| [custom-domain](./custom-domain/custom-domain) | Simpler custom domain setup via zt-https |
7572

76-
### 3. Keys & Replication Layer
73+
### Keys & Persistence
7774

78-
Production reality: persistent keys across machines, crash recovery, upgrades.
75+
Persistent keys across deployments via KMS.
7976

8077
| Example | Description | Status |
8178
|---------|-------------|--------|
82-
| [get-key-basic](./get-key-basic) | `dstack.get_key()` — same key identity across deployments | Coming Soon |
79+
| [get-key-basic](./get-key-basic) | `dstack.get_key()` — same key identity across machines | Coming Soon |
8380

84-
**What you learn:** KMS interaction, secrets replication, upgrade policies, dev-proofness.
81+
### On-Chain Interaction
8582

86-
### 4. On-Chain Interaction Layer
87-
88-
Blockchain integration: light client for reading chain state, coprocessor pattern for anchoring outputs.
83+
Light client for reading chain state, anchoring outputs.
8984

9085
| Example | Description |
9186
|---------|-------------|
9287
| [lightclient](./lightclient) | Ethereum light client (Helios) running in enclave |
9388

94-
**What you learn:** Light client in TEE, verifying on-chain state, coprocessor receipts.
95-
9689
---
9790

9891
## Dev Scaffolding
9992

100-
Development and debugging tools. **Not for production** — useful during development.
93+
Development and debugging tools. **Not for production.**
10194

10295
| Example | Description |
10396
|---------|-------------|
@@ -109,7 +102,7 @@ Development and debugging tools. **Not for production** — useful during develo
109102

110103
## Tech Demos
111104

112-
Interesting demonstrations — cool tech but not yet fully developed use cases with clear security stories.
105+
Interesting demonstrations.
113106

114107
| Example | Description |
115108
|---------|-------------|
@@ -119,7 +112,7 @@ Interesting demonstrations — cool tech but not yet fully developed use cases w
119112

120113
## Details
121114

122-
Implementation details and infrastructure patterns. Not primary use cases.
115+
Implementation details and infrastructure patterns.
123116

124117
| Example | Description |
125118
|---------|-------------|
@@ -134,7 +127,6 @@ Implementation details and infrastructure patterns. Not primary use cases.
134127

135128
- **[dstack Documentation](https://docs.phala.network/dstack)** - Official platform documentation
136129
- **[Main Repository](https://github.com/Dstack-TEE/dstack)** - Core dstack framework
137-
- **[ERC-733](https://erc733.org)** - TEE+EVM design patterns standard
138130
- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute
139131

140132
## Development

0 commit comments

Comments
 (0)