Skip to content

Commit 745ef45

Browse files
committed
overview complete
1 parent ea1ec6b commit 745ef45

File tree

5 files changed

+145
-110
lines changed

5 files changed

+145
-110
lines changed

apps/portal/src/app/connect/pay/fees/page.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,6 @@ You can configure who pays the protocol fee for buy or sell transactions by spec
2424

2525
See full reference for [`buy`](https://portal.thirdweb.com/references/typescript/v5/buy/prepare) and [`sell`](https://portal.thirdweb.com/references/typescript/v5/sell/prepare).
2626

27-
2827
#### Setting fees on transfers or purchase mode
2928

3029
You can configure who pays the protocol fee for transfers or purchase mode using the `feePayer` setting. This affects the

apps/portal/src/app/engine/features/backend-wallets/page.mdx

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,24 +2,24 @@ import { createMetadata, Details } from "@doc";
22
import { Callout } from "@doc";
33

44
export const metadata = createMetadata({
5-
title: "Backend Wallets | thirdweb Engine",
5+
title: "Server Wallets | thirdweb Engine",
66
description:
7-
"Engine performs blockchain actions using backend wallets that you own and manage.",
7+
"Engine performs blockchain actions using server wallets that you own and manage.",
88
});
99

10-
# Backend Wallets
10+
# Server Wallets
1111

1212
Engine performs blockchain actions using backend wallets that you own and manage.
1313

1414
There are multiple options for securing backend wallets.
1515

16-
## Smart Backend Wallets
16+
## Smart Server Wallets
1717

18-
Smart backend wallets are the recommended way to perform blockchain operations with Engine. Each smart backend wallet consists of an EOA (managed internally by Engine) and a smart account (using thirdweb's default account implementation).
18+
Smart server wallets are the recommended way to perform blockchain operations with Engine. Each smart server wallet consists of an EOA (managed internally by Engine) and a smart account (using thirdweb's default account implementation).
1919

2020
### Benefits
2121

22-
Smart backend wallets inherit smart account benefits and offer several advantages over traditional EOAs:
22+
Smart server wallets inherit smart account benefits and offer several advantages over traditional EOAs:
2323

2424
- **Gas Management**: Built-in paymaster eliminates the need to maintain gas tokens. This means you never need to hold crypto or top up gas.
2525
- **Better Nonce Management**: Smart accounts use multi-dimensional nonces, which are more efficient than EOAs.
@@ -55,7 +55,7 @@ For AWS and Google Cloud KMS options, follow the setup instructions in the respe
5555

5656
### Pricing
5757

58-
Smart backend wallets have no additional costs to use with your Engine instance. Transactions sent from smart backend wallets follow the [same billing model as regular account abstraction transactions with thirdweb](/connect/account-abstraction/infrastructure#pricing--billing).
58+
Smart server wallets have no additional costs to use with your Engine instance. Transactions sent from smart backend wallets follow the [same billing model as regular account abstraction transactions with thirdweb](/connect/account-abstraction/infrastructure#pricing--billing).
5959
Smart accounts need to be deployed on each chain. This costs gas and is billed to your account like any other transaction.
6060

6161
## Local wallet
@@ -80,7 +80,7 @@ An AWS KMS Wallet is a wallet securely stored in your AWS account. Engine can cr
8080
- `kms:Verify`
8181
1. On the user page, navigate to **Security credentials > Access keys**.
8282
1. Select **Create access key** to get an **Access Key** and **Secret Key**.
83-
1. In the dashboard, navigate to **Configuration > Backend Wallets**.
83+
1. In the dashboard, navigate to **Configuration > Server Wallets**.
8484
1. Select **AWS KMS** and provide the following:
8585
- Access Key (example: `AKIA...`)
8686
- Secret Key (example: `UW7A...`)
@@ -92,7 +92,7 @@ An AWS KMS Wallet is a wallet securely stored in your AWS account. Engine can cr
9292
- Key type: `Asymmetric`
9393
- Key spec: `ECC_SECG_P256K1`
9494
- Key usage: `Sign and verify`
95-
1. In the dashboard, navigate to **Overview > Backend Wallets**.
95+
1. In the dashboard, navigate to **Overview > Server Wallets**.
9696
1. Select **Import** and provide the following:
9797
- AWS KMS Key ID (example: `0489da75-9830-4a5a-97e3-e4a6df7775b3`)
9898
- AWS KMS ARN (example: `arn:aws:kms:us-west-1:632186309261:key/0489da75-9830-4a5a-97e3-e4a6df7775b3`)
@@ -109,7 +109,7 @@ An AWS KMS Wallet is a wallet securely stored in your AWS account. Engine can cr
109109
1. Navigate to the [Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts) page. Select the above service account.
110110
1. Navigate to the **Keys** tab. Select **Add Key > Create new key**.
111111
1. Select **JSON** to download the JSON file. This file contains the key's private key in plaintext.
112-
1. In the dashboard, navigate to **Configuration > Backend Wallets**.
112+
1. In the dashboard, navigate to **Configuration > Server Wallets**.
113113
1. Select **Google KMS** and provide the following:
114114

115115
<Details id="gcpApplicationProjectId" summary="gcpApplicationProjectId">
@@ -175,7 +175,7 @@ An AWS KMS Wallet is a wallet securely stored in your AWS account. Engine can cr
175175
1. Ensure your [keyring is created](https://cloud.google.com/kms/docs/create-key-ring) with the following settings:
176176
- Purpose: `Asymmetric sign`
177177
- Algorithm: `Elliptic Curve P-256 - SHA256 Digest`
178-
1. In the dashboard, navigate to **Overview > Backend Wallets**.
178+
1. In the dashboard, navigate to **Overview > Server Wallets**.
179179
1. Select **Import** and provide the following:
180180
- GCP KMS Key ID (example: `0489da75-9830-4a5a-97e3-e4a6df7775b3`)
181181
- GCP KMS Version ID (example: `1`)
@@ -189,12 +189,12 @@ An AWS KMS Wallet is a wallet securely stored in your AWS account. Engine can cr
189189
1. Create a Circle account at the [Circle Console](https://console.circle.com/signin).
190190
2. Navigate to [API & Client Keys](https://console.circle.com/api-keys).
191191
3. Create an API Key. (Either a standard key or a restricted key scoped to "Programmable Wallets" is required.) Do not enable the IP Allowlist. Store this key, it is not shown again.
192-
4. In the dashboard, navigate to **Configuration > Backend Wallets**.
192+
4. In the dashboard, navigate to **Configuration > Server Wallets**.
193193
5. Select **Circle** and provide the following:
194194
- API Key (example: `API_KEY:...`)
195195

196196
<Callout variant="info">
197-
Circle API Keys are scoped to either Testnet or Mainnet. Backend wallets
197+
Circle API Keys are scoped to either Testnet or Mainnet. Server wallets
198198
created with a testnet key will not work on the mainnet, and vice versa
199199
<br /> If you want to change between testnet and mainnet, you will need to
200200
update the API key configuration in engine, and recreate a wallet with the
@@ -205,7 +205,7 @@ An AWS KMS Wallet is a wallet securely stored in your AWS account. Engine can cr
205205

206206
For AWS or Google Cloud KMS wallets, you must provide your credentials.
207207

208-
1. In the dashboard, navigate to **Overview > Backend Wallets**.
208+
1. In the dashboard, navigate to **Overview > Server Wallets**.
209209
1. Select **Create**.
210210
1. (Optional) Provide a label to organize your wallets.
211211

@@ -215,18 +215,18 @@ Circle wallets require creating a [Credential](/engine/features/wallet-credentia
215215

216216
For AWS or Google Cloud KMS wallets, you must provide your credentials.
217217

218-
1. In the dashboard, navigate to **Overview > Backend Wallets**.
218+
1. In the dashboard, navigate to **Overview > Server Wallets**.
219219
1. Select **Import**.
220220
1. Provide the requested fields.
221221
- See above for instructions for specific wallet types.
222222

223223
## List wallets
224224

225-
In the dashboard, navigate to **Overview > Backend Wallets** to view your wallets created by or imported to Engine.
225+
In the dashboard, navigate to **Overview > Server Wallets** to view your wallets created by or imported to Engine.
226226

227227
## Best practices
228228

229229
- It is recommend to use AWS or Google Cloud KMS wallets for production use. Private keys are never exposed and the wallet is backed up securely by the cloud provider.
230-
- Use labels and multiple backend wallets to organize and track usage.
230+
- Use labels and multiple server wallets to organize and track usage.
231231
- Example: Use one wallet to pay out creators on your platform and another to airdrop NFTs to users.
232232
- If your wallets require topping up gas or ERC20 tokens regularly, consider a separate "funds storage" backend wallet that transfers funds to other wallets via the dashboard UI or API.

apps/portal/src/app/engine/get-started/page.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ import lifecycleImage from "../assets/tx-lifecycle.webp";
55
export const metadata = createMetadata({
66
title: "Getting started with Engine | thirdweb Infrastructure",
77
description:
8-
"Learn how to use Engine to manage your backend wallets and call contract methods",
8+
"Learn how to use Engine to manage your server wallets and call contract methods",
99
});
1010

1111
# Get Started
1212

13-
Once you have Engine set up, learn the basics of Engine.
13+
Learn how to get setup and started with Engine Cloud by setting up a Vault, creating server wallets, and sending your first transaction.
1414

1515
## Learn how transactions work
1616

apps/portal/src/app/engine/page.mdx

Lines changed: 81 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
import OverviewImage from "./assets/engine-overview.png";
2-
import { DocImage, OpenSourceCard } from "@doc";
2+
import { DocImage, FeatureCard, OpenSourceCard, Callout } from "@doc";
33
import { createMetadata } from "@/components/Document";
4+
import { Activity, CircleCheck, RotateCcw, Ban, File, MessageCircle, Wallet, Blocks, ArrowLeftRight, SlidersHorizontal} from "lucide-react";
5+
import SupportedChains from "../_images/supported-chains.png";
6+
47

58
export const metadata = createMetadata({
69
title: "thirdweb Engine",
@@ -9,84 +12,85 @@ export const metadata = createMetadata({
912

1013
# Engine
1114

12-
Engine is an open-source, backend server that reads, writes, and deploys contracts at production scale.
13-
14-
## Why use Engine?
15-
16-
Engine enables your app to:
17-
18-
- Send multiple blockchain transactions at once.
19-
- Resubmit stuck transactions, handling nonce values, gas settings, and RPC errors.
20-
- Avoid duplicate transactions.
21-
- Manage multiple backend wallets and their funds.
22-
- Control access from your backends and team members.
23-
- Sponsor user gas fees.
24-
- Deploy and interact with smart accounts.
25-
- Subscribe to contract events and transactions.
26-
27-
🚀 [Get Engine hosted by thirdweb](https://thirdweb.com/team/~/~/engine/create) or [self-host for free](/engine/self-host).
28-
29-
### Tiers
30-
31-
Engine is available in two tiers: Cloud and Dedicated.
32-
- **Cloud**: thirdweb-hosted Engine with autoscaling and high availability.
33-
- **Dedicated**: Self-hosted Engine with full control over your infrastructure.
34-
35-
36-
<DocImage
37-
src={OverviewImage}
38-
alt="Engine overview"
39-
className="max-w-[500px] mx-auto"
40-
/>
15+
Engine provides a way to read and write to the blockchain at scale through simple API endpoints.
4116

4217
<OpenSourceCard title="Engine" href="https://github.com/thirdweb-dev/engine" />
4318

44-
## Standard Engine
45-
46-
Supports 500 write transactions per second. Great for minting APIs, airdrops, and managing user wallets.
47-
48-
#### Features
49-
50-
- <strong>High transaction throughput</strong> - Transactions batched on the same
51-
block with nonces managed automatically.
52-
- <strong>Secure backend wallets</strong> - Your backend wallets stored locally,
53-
on AWS KMS, or on Google KMS.
54-
- <strong>Any contract on any EVM chain</strong> - Supports contract calls on all <a href="https://thirdweb.com/chainlist">
55-
1700+ EVM blockchains
56-
</a> and private subnets.
57-
- <strong>Contract deployments</strong> - Deploy smart accounts, tokens, NFTs, marketplaces,
58-
and more.
59-
- <strong>Account abstraction</strong> - Use smart accounts and session keys to transact
60-
on behalf of your users.
61-
- <strong>Built-in relayer</strong> - Sponsor gas for your users so reduce user friction.
62-
- <strong>Event webhooks</strong> - Get notified of wallet and contract events to
63-
automate other actions like payments or emails.
64-
- <strong>Contract subscriptions</strong> - Store event logs and transaction receipts
65-
to be queried later.
66-
- <strong>Transaction observability</strong> - Debug transaction failures with detailed
67-
timelines, onchain errors, and gas details.
68-
- <strong>Idempotency</strong> - Prevent costly, duplicate transactions.
69-
- <strong>Production-ready web3 infrastructure</strong> - Includes RPC, IPFS, and
70-
Account Abstraction out of the box.
71-
72-
## Premium Engine
73-
74-
Engine Premium provides added scaling and resilience. It include server autoscaling, server failover, database failover, and 30-day database backups.
75-
76-
#### Features
77-
78-
- **_Everything in Standard Engine_**
79-
- **Autoscaling** - Scale to millions of users with a fleet of Engine instances that scale up along with your traffic.
80-
- **Production-grade Server** - High availability and redundancy.
81-
- **Production-grade Database** - High availability, Multi-AZ.
82-
- **Database backups** - Recoverability and peace of mind for your stored data (30-day database backups).
83-
84-
## Pricing
85-
86-
Cloud-hosting Engine with thirdweb starts at $99 per month. Learn more about [Engine pricing](https://thirdweb.com/team/~/~/engine/create).
87-
88-
Self-hosting Engine is always free.
19+
## Features
20+
21+
<div
22+
className="my-4 grid gap-2 md:grid-cols-2 lg:grid-cols-2 "
23+
>
24+
<FeatureCard
25+
title="Concurrent Transactions"
26+
description="Send multiple transactions at once with automatic nonce management"
27+
iconUrl={<ArrowLeftRight />}
28+
/>
29+
30+
<FeatureCard
31+
title="Avoid Transaction Failures"
32+
description="Resubmits stuck transactions, handling nonce values, gas settings, and RPC errors."
33+
iconUrl={<RotateCcw/>}
34+
/>
35+
36+
<FeatureCard
37+
title="Wallet Management"
38+
description="Manage funds and send transactions without worrying about topping up gas fees."
39+
iconUrl={<Wallet/>}
40+
/>
41+
42+
<FeatureCard
43+
title="Granular Access Control"
44+
description="Control access to server wallets via access tokens with specified permission scopes"
45+
iconUrl={<SlidersHorizontal/>}
46+
/>
47+
48+
<FeatureCard
49+
title="Abstract Blockchain Complexity"
50+
description="Sponsor gas fees using built-in relayers and session keys to transact on behalf of users."
51+
iconUrl={<CircleCheck/>}
52+
/>
53+
54+
<FeatureCard
55+
title="Offchain Integrations"
56+
description="Integrate with existing services to do onchain actions triggered from offchain events."
57+
iconUrl={<Blocks/>}
58+
/>
59+
60+
<FeatureCard
61+
title="Programmatic Deployments"
62+
description="Deploy smart accounts, tokens, NFTs, marketplaces, and more."
63+
iconUrl={<Blocks/>}
64+
/>
65+
66+
<FeatureCard
67+
title="Transaction Observability"
68+
description="Debug transaction failures with detailed timelines, onchain errors, and gas details."
69+
iconUrl={<Activity/>}
70+
/>
71+
</div>
72+
73+
## Engine Cloud vs. Dedicated
74+
75+
<Callout variant="info" title="Engine Cloud (Beta)">
76+
Engine Cloud is currently in beta as we are adding more features, endpoints, and improving performance.
77+
78+
Try it out for free by creating a project on dashboard.
79+
</Callout>
80+
81+
| Feature | Cloud ☁️ | Dedicated (V3), Coming Soon |
82+
|--------------------|-------------------------------------------|------------------------------------------|
83+
| Wallets | Server Wallets | Server Wallets, AWS, GCP, Circle |
84+
| Database Backups || 30 Day Backups |
85+
| Infrastructure | Shared | Isolated |
86+
| Rate Limits | [Limited by RPC Plan](https://thirdweb.com/pricing) | Unlimited |
87+
| Pricing | [See pricing page](https://thirdweb.com/pricing) | [See pricing page](https://thirdweb.com/pricing) |
88+
89+
90+
## Supported Chains
91+
92+
Engine is supported on every EVM compatible chain and private subnets. To view the full list, visit [thirdweb chainlist](https://thirdweb.com/chainlist?service=engine).
93+
94+
<DocImage src={SupportedChains} />
8995

90-
## Get in touch
9196

92-
For dedicated support and feature requests, [contact Sales](https://thirdweb.com/contact-us).

0 commit comments

Comments
 (0)