Aller au contenu principal

Getting Started

info

Cette page n'est pas traduite. S'il vous plaît, participez à sa traduction en suivant le lien en bas de page.

This guide will explore the basics of creating an Alephium dApp project.

Prerequisites:

Creating a new dApp project​

To create the tutorial project, open a new terminal and run:

npx @alephium/cli@latest init alephium-tutorial

This will create a new directory alephium-tutorial and initialize a sample project inside that directory.

Launching a local development network​

To compile and test your contracts, it's necessary to launch a local development network by running:

npx @alephium/cli@latest devnet start

The Typescript SDK is then able to interact with the network through REST endpoints.

Compiling your contract​

Next, change the workspace to the tutorial project:

cd alephium-tutorial

and compile your contracts:

npx @alephium/cli@latest compile

If you take a look at contracts/, you should be able to find token.ral. The compiled artifacts are in the directory artifacts.

Testing your contract​

The sample project comes with tests test/token.test.ts for your contract. You can run your tests with:

npm run test

or

npx @alephium/cli@latest test

Deploying your contract​

Next, to deploy the contract we will use Alephium CLI and a deployment script scripts/0_deploy_faucet.ts. You can run it using:

npx @alephium/cli@latest deploy

This will deploy the token faucet to all of the 4 groups of Devnet. You could configure alephium.config.ts to deploy the contract to different networks.

Interacting with the deployed contract​

Now, you can build the source code src/token.ts with:

npm run build

and interact with the deployed token faucet:

node dist/src/token.js

Connect to the wallets​

dApp requires wallet integration for users of the dApp to authenticate and interact with the Alephium blockchain, such as transactions signing. Currently dApps can be integrated with both Extension Wallet and WalletConnect. Please refer to the respective pages for more details.

Learn more​

To learn more about the web3 SDK, please visit the guide of web3 SDK.

To learn more about Ralph language, please visit the guide of Ralph.

Prototypes​

Here are some well-maintained dApps that can be a great source of inspiration for building new dApps.