Skip to main content

Valora + WalletConnect v1

How to use WalletConnect version 1 in a DApp to connect to Valora.

Getting Started

In this example, we will demonstrate how to add WalletConnect to a simple React app.

This is a simple DApp that focuses on demonstrating how to connect WalletConnect to Valora, but also shows how to set up ContractKit and make a simple Mento cUSD stablecoin transfer. You can view the DApp code here.

Add Packages

Add the packages that you need to your project.

yarn add @wallet-connect/web3-provider web3 @celo/contractkit

Import the packages to your project code.

import WalletConnectProvider from '@walletconnect/web3-provider';
import Web3 from 'web3';
import { newKitFromWeb3 } from '@celo/contractkit';


If the DApp does not detect a wallet connect provider, the user will be presented with a button to initiate a wallet connection.

If the DApp is being accessed on a computer or device other than the mobile device with the wallet, the user can connect to the mobile wallet by scanning the presented QR code. If the DApp is being accessed on the same device as the wallet, the connection will be made via the appropriate linking mechanism (iOS and Android are different). You can read more about that here.

When a provider is detected, the DApp will show a button to send Mento cUSD stablecoin.

connect dapp

The connect function sets up the WalletConnect Provider and initializes ContractKit with the provider and user account. It also sets up a listener that will log when the user changes accounts. The DApp then saves the provider and initialized Contractkit in the React component state.

 connect = async() => {
const provider = new WalletConnectProvider({
rpc: {
44787: "",
42220: "",

await provider.enable()
const web3 = new Web3(provider);
let kit = newKitFromWeb3(web3)

kit.defaultAccount = provider.accounts[0]

provider.on("accountsChanged", (accounts) => {

this.setState({provider, kit})


qr code


connect valora

When the provider has been set and the DApp is connected to Valora, the UI will update the button and display the user account address below.

send Mento cUSD stablecoin

Send cUSD

Clicking the new button will prompt the user to send 0.001 Mento cUSD stablecoin to a hard-coded address. The user will have to click Allow to send the transaction. Once the transaction is confirmed, the transaction receipt will be printed in the DApp browser console.

You can code the transaction approval request with just a few lines, demonstrated in the sendMentocUSD function.

  • Get the saved instance of ContractKit from this.state.kit
  • Get the stabletoken (Mento cUSD) contract
  • Call transfer and send with the recipient and amount
 sendMentocUSD = async () => {
let kit = this.state.kit

let amount = kit.web3.utils.toWei('0.001', 'ether')

const stabletoken = await kit.contracts.getStableToken()
const tx = await stabletoken.transfer(this.state.someAddress, amount).send()
const receipt = await tx.waitReceipt()


approve valora

The receipt will be logged once the user approves the transaction and it is confirmed on the network.

Pay Fees in Stable currencies

Specifying the feeCurrency field in the transaction will allow users to pay transaction fees in that currency. Here's how you can have users pay transaction fees in Mento cUSD, for example:

const stabletoken = await kit.contracts.getStableToken()
let tx = await stabletoken.transfer(this.state.someAddress, amount).send({ feeCurrency: stabletoken.address })