Skip to content

Commit eaf9176

Browse files
committed
feat: bridge portal page
1 parent 769019d commit eaf9176

File tree

15 files changed

+1071
-501
lines changed

15 files changed

+1071
-501
lines changed

apps/portal/src/app/Header.tsx

Lines changed: 485 additions & 481 deletions
Large diffs are not rendered by default.
Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
import { createMetadata, Details } from "@doc";
2+
3+
export const metadata = createMetadata({
4+
image: {
5+
title: "Bridge FAQs",
6+
icon: "payments",
7+
},
8+
title: "Bridge FAQs | thirdweb documentation",
9+
description: "Explore FAQs around bridging and swapping assets with thirdweb.",
10+
});
11+
12+
# Payments FAQs
13+
14+
### General
15+
16+
<Details summary="What does Bridge use to operate under the hood?">
17+
Bridge is an asset router that combines thirdweb's own onchain infrastructure with existing bridging and swapping protocols to find the optimal route for any given transaction.
18+
This can include intents, native bridges, third party bridges, cross-chain messaging protocols, thirdweb's custom bridges, and more. All routes are monitored and planned continuously for
19+
health, price, and speed to guarantee the best path every time.
20+
</Details>
21+
22+
<Details summary="Am I able to use Bridge with other wallet infrastructure providers?">
23+
Yes, Bridge is designed to be agnostic to wallet infrastructure. You can use it with any wallet service.
24+
</Details>
25+
26+
### Fees
27+
28+
<Details summary="What are the fees for Buy With Fiat?">
29+
thirdweb does not charge any fees for buy with fiat. Any fees on onramping are based on the onramp provider.
30+
</Details>
31+
32+
<Details summary="What are the fees for Buy With Crypto?">
33+
For buying with crypto or swap fees, thirdweb charges a 0.3% protocol fee. Developers may monetize their application by charging additional fees on swap transactions. To set a fee in your project page, navigate to Payments > Settings to set this fee.
34+
</Details>
35+
36+
<Details summary="What does the term “network fees” refer to?">
37+
Network fees, also referred to as miner fees, are paid to the miner for processing crypto transactions and securing the respective network. These fees do not go to thirdweb.
38+
</Details>
39+
40+
<Details summary="Does thirdweb offer fiat payouts?">
41+
Fiat payouts are not currently available.
42+
</Details>
43+
44+
### Token & Region Support
45+
46+
<Details summary="How can I support a token?">
47+
We're able to support most tokens that meet the following criteria:
48+
49+
- The token must have sufficient liquidity
50+
- The token must be on a [supported Payments Chain](https://thirdweb.com/chainlist?service=pay).
51+
52+
To request support for a token, please visit the Payments tab in your project dashboard > Settings > "Don't see your token listed?" component and fill out the chain and token address information.
53+
54+
The service will automatically kick off the token route discovery process. Please check back the Payments modal after 20-40 minutes for the requested token.
55+
</Details>
56+
57+
<Details summary="What countries does Buy With Fiat support?">
58+
**Buy With Fiat** is available 160+ countries. The following countries are _UNSUPPORTED_:
59+
60+
- Afghanistan
61+
- Africa (All Countries)
62+
- Belarus
63+
- Bolivia
64+
- China
65+
- Cuba
66+
- Colombia
67+
- Haiti
68+
- Honduras
69+
- Iran
70+
- Iraq
71+
- Latvia
72+
- Lebanon
73+
- Myanmar
74+
- Pakistan
75+
- Qatar
76+
- Russia
77+
- Ukraine
78+
- United Arab Emirates
79+
- Venezuela
80+
- Yemen
81+
82+
All United States are supported, excluding Hawaii.
83+
</Details>
84+
85+
<Details summary="What cryptocurrencies does Bridge support?">
86+
Bridge can support any currency on our [supported chains](https://thirdweb.com/chainlist?service=pay).
87+
</Details>
88+
89+
<Details summary="Does Bridge support Apple Pay or Google Pay?">
90+
Apple Pay and Google Pay are supported through the onramp providers depending on region. Coinbase, Stripe, and Transak currently support Apple Pay. Transak supports Google Pay.
91+
</Details>
92+
93+
<Details summary="What are your transaction limits for Buy With Fiat?">
94+
We currently require a $1 minimum purchase for both stablecoin and non-stablecoin purchases through Buy With Fiat.
95+
96+
Our transaction maximum starts from $1500 per week for new users and can increase over time to $10,000 per week.
97+
</Details>
98+
99+
<Details summary="Does thirdweb offer direct onramping to tokens through Buy With Fiat?">
100+
We offer direct onramping **internationally** to the following tokens:
101+
102+
- Mainnet (Ethereum)
103+
- Avalanche
104+
- Polygon
105+
106+
We offer direct onramping to the following tokens in the **US only**:
107+
108+
- ETH (Base)\*
109+
- USDC (Ethereum)
110+
- USDC (Polygon)\*
111+
- USDC (Avalanche)\*
112+
- USDC (Base)\*
113+
114+
All other tokens will require an additional Buy With Crypto step.
115+
116+
\* Not available in New York or the EU.
117+
</Details>
118+
119+
<Details summary="How are cryptocurrency prices set in thirdweb Payments?">
120+
Prices are set depending on the liquidity provider used to route your transaction.
121+
</Details>
122+
123+
### KYC & Compliance
124+
125+
<Details summary="What are the KYC requirements?">
126+
Onramp options all require minimal KYC. This is done to comply with local regulations and to ensure the safety of our users.
127+
Please note: onramping with Coinbase does not require KYC for a purchase below $500 with debit card.
128+
</Details>
129+
130+
<Details summary="How does KYC work with Buy With Fiat">
131+
Users will be required to complete KYC verification for their first purchase using 'Buy with Fiat.' After that, no further KYC will be needed for future purchases on the same platform.
132+
</Details>
133+
134+
135+
569 KB
Loading
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
import { DocImage } from "@doc";
2+
import FeeShare from './assets/fee-dash.png';
3+
4+
5+
# Understanding fees
6+
7+
Understand how protocol, developer, and onramp fees work with Bridge.
8+
9+
### Developer Fee
10+
11+
To monetize applications or games, you are able to set a developer fee on each crypto-to-crypto or swap transaction. You may set this percentage
12+
through Project > Project Settings > Payments > Configure > Settings.
13+
14+
<DocImage src={FeeShare} alt="Developer fee share" />
15+
16+
### Protocol Fee
17+
18+
Our protocol fee is a flat 30 basis points (0.30%) applied on the source token amount.
19+
This fee is independent of network gas fees and does not fluctuate.
20+
21+
#### Setting fees using buy or sell
22+
23+
You can configure who pays the protocol fee for buy or sell transactions by specifying the input amount `sell` or `buy`.
24+
25+
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).
26+
27+
#### Setting fees on transfers or purchase mode
28+
29+
You can configure who pays the protocol fee for transfers or purchase mode using the `feePayer` setting. This affects the
30+
total amount paid by the user and the amount received by the destination (e.g., a seller, app, or partner).
31+
32+
feePayer=buyer (Default) i.e. the user covers the protocol fee.
33+
34+
Example: If the source token is 10 USDC, the user pays 10.30 USDC.
35+
36+
- thirdweb receives: 0.30 USDC
37+
38+
- Receiver receives: 10.00 USDC
39+
40+
feePayer=receiver i.e. the receiver covers the protocol fee.
41+
42+
Example: The user pays 10.00 USDC.
43+
44+
- thirdweb receives: 0.30 USDC
45+
46+
- Receiver receives: 9.70 USDC
47+
48+
[See full reference.](https://bridge.thirdweb.com/reference#tag/transfer/POST/v1/transfer/prepare)
49+
50+
### Onramp Fee
51+
52+
A fee is charged by the third-party provider when onramping. This fee is determined by the provider and is typically a percentage
53+
of the amount being onramped. This fee may vary based on the provider and payment method used.
54+
55+
There are no protocol fees on onramp transactions.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
import { createMetadata } from "@doc";
2+
import { DocLayout } from "@/components/Layouts/DocLayout";
3+
import { sidebar } from "./sidebar";
4+
5+
export default async function Layout(props: { children: React.ReactNode }) {
6+
return (
7+
<DocLayout editPageButton={true} sideBar={sidebar}>
8+
{props.children}
9+
</DocLayout>
10+
);
11+
}
12+
13+
export const metadata = createMetadata({
14+
description: "Bridge and swap tokens across chains with thirdweb Bridge.",
15+
image: {
16+
icon: "payments",
17+
title: "thirdweb Bridge Docs",
18+
},
19+
title: "thirdweb Bridge Documentation",
20+
});
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
import { createMetadata } from "@doc";
2+
3+
export const metadata = createMetadata({
4+
image: {
5+
title: "thirdweb Payments - Onramp Providers",
6+
icon: "thirdweb",
7+
},
8+
title: "thirdweb Payments - Onramp Providers | thirdweb",
9+
description:
10+
"Integrate onramp providers for any onchain transaction and set preferred providers",
11+
});
12+
13+
# Onramp Providers
14+
15+
**Onramp Providers** are services that allow users to buy crypto with fiat. Payments supports the following onramp providers:
16+
17+
- **Coinbase**
18+
- **Transak**
19+
- **Stripe**
20+
21+
## Provider Fees
22+
23+
Each provider has different fees associated with their services which often depend on various factors. Onramp provider fees are set by the provider and are not controlled by thirdweb.
24+
25+
| Provider | Fees |
26+
| -------- | ---- |
27+
| Coinbase | [Learn more about Coinbase Fees](https://help.coinbase.com/en/coinbase/trading-and-funding/pricing-and-fees/fees) |
28+
| Transak | [Learn more about Transak Fees](https://support.transak.com/en/articles/7845942-how-does-transak-calculate-prices-and-fees)|
29+
| Stripe | [Learn more about Stripe Fees](https://stripe.com/legal/crypto-onramp). |
30+
31+
32+
## Provider Regions
33+
34+
Each provider has different regions they support. You can learn more about the supported regions for each provider in the links below.
35+
36+
| Provider | Regions |
37+
| -------- | ------- |
38+
| Coinbase | [View Regions](https://docs.cdp.coinbase.com/onramp/docs/api-configurations) |
39+
| Transak | [View Regions](https://transak.com/global-coverage) |
40+
| Stripe | [View Regions](https://support.stripe.com/questions/crypto-supportability-and-availability-by-region) |

0 commit comments

Comments
 (0)