Skip to content

Commit 51a4851

Browse files
garikbessongagdiezbucanero
authored
Aurora Section (#2681)
* add basic overview of Aurora and EVM compatibility * Update website/sidebars.js * Apply suggestions from code review * Delete docs/aurora/dev-resources.md --------- Co-authored-by: Guille <[email protected]> Co-authored-by: Damián Parrino <[email protected]>
1 parent b92f149 commit 51a4851

File tree

5 files changed

+202
-0
lines changed

5 files changed

+202
-0
lines changed

docs/aurora/build-on-aurora.md

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
id: build-on-aurora
3+
title: Build on Aurora
4+
description: "Overview of building on Aurora and key concepts such as cross-chain compatibility, EVM compatibility, and onboarding users."
5+
---
6+
7+
Developing your Dapp on Aurora is done in the same way as on any other EVM chain. The main steps in this process are:
8+
9+
- Writing and deploying your smart contracts in Solidity by using Hardhat, Foundry, Truffle, or Remix.
10+
- Creating a frontend that interacts with these smart contracts and blockchain.
11+
12+
:::info
13+
This section is an overview of the development process on Aurora. For detailed information, please refer to the [Aurora documentation](https://doc.aurora.dev/build-a-dapp/introduction).
14+
:::
15+
16+
## Deploy Contracts
17+
18+
To deploy your first contract on Aurora, basically you need to:
19+
20+
1. Have a smart contract written in Solidity. If you don't have one, you can use the [Incrementer example contract](https://github.com/aurora-is-near/aurora-examples/tree/main/hardhat/incrementer-example).
21+
22+
2. Get an Aurora Private key (from MetaMask or other Web3 wallet).
23+
24+
3. Deploy the contract using Hardhat, Foundry, Truffle or Remix using the Aurora RPC endpoint. They're preconfigured in the Incrementer example ([hardhat.config.js](https://github.com/aurora-is-near/aurora-examples/blob/main/hardhat/incrementer-example/hardhat.config.js) file).
25+
26+
---
27+
28+
## Build Frontend
29+
30+
Aurora supports major EVM-compatible Connect Wallet modules, such as:
31+
32+
- [Wagmi](https://wagmi.sh/)
33+
- [AppKit (known also as Web3Modal)](https://walletconnect.com/appkit)
34+
- [RainbowKit](https://www.rainbowkit.com/)
35+
- [ConnectKit](https://family.co/docs/connectkit)
36+
- [Dynamic](https://dynamic.xyz/)
37+
- [Privy](https://privy.io/)
38+
39+
:::tip
40+
Code examples and guides on how to connect a wallet and interact with smart contracts from the frontend can be found in the official [Aurora documentation](https://doc.aurora.dev/build-a-dapp/frontend/connect-wallet).
41+
:::
42+
43+
---
44+
45+
## Cross-Chain Applications
46+
47+
Aurora itself is a virtual chain, because it's EVM built as a smart contract. Every virtual chain on top of NEAR protocol can benefit from [Chain Signatures](../chain-abstraction/chain-signatures) technology.
48+
49+
Chain Signatures on virtual chains enable all addresses, both EOAs (Externally Owned Accounts) and smart contracts, to sign and execute transactions across many blockchain protocols.
50+
51+
You can use Chain Signatures on your virtual chain by:
52+
53+
- Deploying [Chain Signatures Signer](https://github.com/aurora-is-near/chain-signatures-signer) contract to your virtual chain.
54+
- Using libs to derive accounts, create and relay transactions ([Chain Signatures JS](https://github.com/aurora-is-near/chain-signatures-js/), [Near Multichain Examples](https://github.com/near-examples/near-multichain/tree/main)).
55+
56+
To learn more about leveraging Chain Signatures on your virtual chain, please refer to the [Aurora documentation](https://doc.aurora.dev/crosschain/chain-signatures).
57+
58+
---
59+
60+
## Onboarding Users
61+
62+
To make onboarding users easier, even ones unfamiliar with the Web3 ecosystem, Aurora provides Aurora Pass, a mobile cryptocurrency wallet that makes your interactions with Aurora or any of the Aurora Chains easier than ever, whether transferring your assets or using a DApp.
63+
64+
**Key Features:**
65+
66+
- Simple and user-friendly interface.
67+
- 50 free transactions for each user per month.
68+
- Secure and non-custodial wallet.
69+
- Send and receive assets on Aurora Mainnet and Aurora Chains.
70+
- View your portfolio balances and recent transactions.
71+
- Connect to DApps via WalletConnect v2.
72+
73+
To learn more about Aurora Pass, please refer to the [Aurora documentation](https://doc.aurora.dev/onboard/introduction).
74+
75+
## Developer Resources
76+
77+
Available developer resources on Aurora:
78+
79+
* [Aurora documentation](https://doc.aurora.dev/) - the official documentation for developers.
80+
* [Aurora Explorer](https://explorer.aurora.dev/) - view transactions, blocks, and accounts on Aurora.
81+
* [Aurora Cloud](https://auroracloud.dev/) - run your own Virtual Chain.
82+
* [Aurora Pass](https://aurorapass.app/) - a mobile cryptocurrency wallet.
83+
* [Dev Tools](https://doc.aurora.dev/dev-tools/quickstart) - a list of tools to help you build on Aurora, including RPC providers, indexers, oracles, and more.

docs/aurora/launch-virtual-chain.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
id: launch-virtual-chain
3+
title: Launch a Virtual Chain
4+
description: "Overview of a virtual chains on Aurora, including its purpose, benefits, and how to launch one."
5+
---
6+
7+
Virtual Chains are a unique innovation from Aurora, providing a dedicated and customized chain, or appchain.
8+
9+
Each Virtual Chain is a copy of the Aurora Engine (the Aurora smart contract) and deployed on Near. This means that they inherit most of the performance and security features from Near:
10+
11+
- 1s block time
12+
- 220+ validators from Near
13+
- ~$0.003 per transaction.
14+
15+
---
16+
17+
## The difference from appchains
18+
19+
Usually, appchains are side chains or rollups, which are completely separate blockchains from the main settlement chain. This has several consequences:
20+
21+
- Each appchain needs to have its own validator set, which can be expensive to set up and run, and affects the decentralization and security of the network. Typically, an appchain requires a minimum of 5 validators (which already comes at a cost)
22+
23+
- Appchains come empty, meaning the team will need to redevelop all the tools they might have wanted to use, such as onramps, oracles, indexers, etc... This involves third parties and can be extremely costly and time consuming.
24+
25+
- Instead, each Virtual Chain automatically gets all the 220 validators from Near
26+
27+
- Because Virtual Chains are smart contracts on Near, this allowed us to build tools and services that automatically support all new Virtual Chain, such as onramp, centralized exchange support, Oracle, etc, so that you don't have to start from scratch.
28+
29+
---
30+
31+
## How to create a Virtual Chain
32+
33+
Aurora has built a platform for running Virtual Chains: [Aurora Cloud](https://auroracloud.dev/).
34+
35+
Aurora Cloud proposes different plans to get your own chain, including free transactions, custom professional services and much more in order to let you focus on building your application, not setting up infrastructure.

docs/aurora/what-is.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
id: what-is
3+
title: What is Aurora?
4+
description: "Overview of Aurora as an EVM (Ethereum Virtual Machine) compatible blockchain and ecosystem, running as a decentralized layer 2 on the NEAR Protocol."
5+
---
6+
7+
[Aurora](https://aurora.dev/) is an EVM (Ethereum Virtual Machine) compatible blockchain and ecosystem, running as a decentralized layer 2 on the NEAR Protocol. It powers innovations such as Aurora Cloud, the infrastructure solution to onboard web2 businesses onto web3.
8+
9+
Aurora is an EVM implemented as a smart contract on NEAR Protocol which provides several advantages:
10+
11+
- Aurora is fully compatible with Ethereum. Applications can be seamlessly deployed on Aurora without the need to re-write smart contracts. All you need is to change the RPC endpoint you interact with.
12+
- Aurora runs on the NEAR Protocol, one of the highest-performance third-generation L1 protocols.
13+
- Transaction fees in Aurora are paid in the base currency, ETH, and are constant (gas price is 0.07 GWei).
14+
- Aurora supports all the Ethereum ecosystem tools — MetaMask, Foundry, Truffle, Hardhat, Remix, etc.
15+
- Aurora has protocol level meta transactions, which enables features such as gasless transactions for end users.
16+
17+
---
18+
19+
## Different Development Paths
20+
21+
As a developer, a user can choose between two different ways to build on Aurora:
22+
- **[Build on Aurora mainnet](./build-on-aurora.md)**: The fastest way to deploy your Ethereum-based dapp with the low fees and high performance of the NEAR Protocol.
23+
24+
- **[Deploy a Virtual Chain](./launch-virtual-chain.md)**: Create your own blockchain in minutes with customizable gas, permissions, and ecosystem integrations.
25+
26+
---
27+
28+
## Rainbow Bridge
29+
30+
As a part of Aurora and NEAR ecosystem, the [Rainbow Bridge](https://doc.aurora.dev/bridge/introduction) is a trustless, permissionless protocol for connecting blockchains. The bridge protocol removes the need to trust anyone except the security of the connected chains. Anyone can deploy a new bridge, use an existing bridge, or join the maintenance of an existing bridge without getting approval from anyone else.
31+
32+
The Rainbow Bridge allows any information that is cryptographically provable on Near and Aurora to be usable in Ethereum contracts and vice versa — including the ability to read the state and schedule calls with callbacks on the other chain.
33+
34+
[Rainbow Bridge dApp](https://rainbowbridge.app/) allows also to:
35+
36+
- Browse your transfers history.
37+
- Restore your transfers by a hash and see the detailed information, in the case you’re using another browser or device.
38+
- Deploy the new tokens for bridging if you’re an ecosystem project or developer.
39+
- Discover if token is already supported by it via Deploy page
40+
41+
---
42+
43+
## Learn More
44+
45+
To learn more about Aurora, you can check out the official documentation at [doc.aurora.dev](https://doc.aurora.dev/).

website/sidebars.js

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -499,6 +499,24 @@ const sidebar = {
499499
},
500500
],
501501
},
502+
{
503+
type: 'category',
504+
label: 'EVM Developers',
505+
collapsed: true,
506+
customProps: {
507+
icon: '/img/icons/ethereum.svg',
508+
},
509+
link: { type: 'doc', id: 'aurora/what-is' },
510+
items: [
511+
{
512+
type: 'link',
513+
label: 'Introduction',
514+
href: '/aurora/what-is',
515+
},
516+
'aurora/build-on-aurora',
517+
'aurora/launch-virtual-chain',
518+
],
519+
}
502520
],
503521
api: [
504522
'api/rpc/introduction',

website/static/img/icons/ethereum.svg

Lines changed: 21 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)