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.
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:
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
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
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
npm run build
and interact with the deployed token faucet:
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.
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.