`ethereum-react-native-boilerplate`

React Native components and hooks for fast building dApps without running own backend

This project is using:

create-react-native-dapp to bootstrap the project.
WalletConnect v1 react-native integration for authenthication (we use a slightly modiefied version, located in ./src/WalletConnect to allow to modify the enable function of Moralis).
react-moralis for react hooks

There are many components in this boilerplate that do not require an active web3 provider, they use Moralis Web3 API. Moralis supports the most popular blockchains and their test networks. You can find a list of all available networks in Moralis Supported Chains

Please check the official documentation of Moralis for all the functionalities of Moralis.

Check the corresponding docs for additional information and help.

App Home	WalletConnect Authentication

Transactions	NFT Screen

⭐️ `Star us`

If this boilerplate helps you build Ethereum mobile dapps faster - please star this project, every star makes us very happy!

🤝 `Need help?`

If you need help with setting up the boilerplate or have other questions - don't hesitate to write in our community forum and we will check asap. Forum link. The best thing about this boilerplate is the super active community ready to help at any time! We help each other.

🚀 Quick Start

📄 Clone or fork ethereum-react-native-boilerplate:

git clone https://github.com/ethereum-boilerplate/ethereum-react-native-boilerplate.git

💿 Install the expo CLI globally:

npm i -g expo-cli

✏ Rename .env.example to .env in the main folder and provide your appId and serverUrl from Moralis (How to start Moralis Server) Example:

REACT_APP_MORALIS_APPLICATION_ID = xxxxxxxxxxxx
REACT_APP_MORALIS_SERVER_URL = https://xxxxxx.grandmoralis.com:2053/server

💿 Install all dependencies:

cd ethereum-react-native-boilerplate
yarn install

🚴‍♂️ Run your App:

IOS: yarn ios for emulator Make sure you have Xcode or atleast Xcode command line tools installed
- For physical IOS Device: Open the moraliscreatereactnativedapp.xcworkspace from ios folder in Xcode. Run the App by choosing your connected physical device.
Android:
- Command yarn start
- Open android folder from source code in Android Studio. Click "Run app" button to open either emulator or physical device. To see if devices are available, run command adb devices in your terminal.

🧭 Table of contents

ethereum-react-native-boilerplate
⭐️ Star us
🤝 Need help?
🚀 Quick Start
🧭 Table of contents
🏗 Ethereum Components
🧰 Ethereum Hooks

🏗 Ethereum Components

🛠 The ready for use react-native-components are located in frontend/Components. They are designed to be used anywhere in your dApp.

`<CryptoAuth />`

📒 <CryptoAuth /> : Easy web3 authentication via WalletConnect.

`<NativeBalance />`

Options:

chain: chain to fetch data from.

`<ERC20Balance />`

📨 <ERC20Balance /> : Displays all ERC20 Balances with Price. Options:

chain: chain to fetch data from.

`<Assets />`

💰 <Assets /> : Screen to display all Chain ERC20 and NAtive Assets with Prices

`<RecentTransactions />`

💰 <RecentTransactions /> : Screen to display all Chain ERC20 Transactions

`<TransactionDetails />`

<TransactionDetails /> : Modal to display all ERC20 Transaction related content

`<Blockie />`

A custom Blockie indenticon generator for React Native.

Options:

address: Address to generate Blockie Icon from.
size: Size of the Icon. For more custom sizes, edit the component as to your liking

`<Address />`

Displays The user address that is copyable

🧰 Ethereum Hooks

`useERC20balance()`

💰 Gets all token balances of a current user or specified address.

Options:

chain (optional): The blockchain to get data from. Valid values are listed on the intro page in the Transactions and Balances section. Default value: current chain.
address (optional): A user address (i.e. 0x1a2b3x...). If specified, the user attached to the query is ignored and the address will be used instead.
to_block (optional): The block number on which the balances should be checked

Returns (Object) : number of tokens and the array of token objects

const { fetchERC20Balance, assets } = useERC20Balance({ chain: "eth" });

`useNativeBalance()`

💰 Gets native balance for a current user or specified address.

Options:

chain (optional): The blockchain to get data from. Default value: current chain.

Example:

import useNativeBalance from "./hooks/useNativeBalance";

function NativeBalance() {
  const { nativeBalance } = useNativeBalance(chain);

return (
    <View style={styles.itemView}>
      <Text style={styles.name}> {nativeBalance} </Text>
    </View>
  );
}

Example return of nativeBalance (string)

'0.1581 BNB'

`useERC20Transfers()`

🧾 Gets ERC20 token transfers of a current user or specified address.

Options:

chain (optional): The blockchain to get data from. Valid values are listed on the intro page in the Transactions and Balances section. Default value: current chain.
address (optional): A user address (i.e. 0x1a2b3x...). If specified, the user attached to the query is ignored and the address will be used instead.
from_date (optional): The date from where to get the transactions (any format that is accepted by momentjs). Provide the param 'from_block' or 'from_date' If 'from_date' and 'from_block' are provided, 'from_block' will be used.
to_date (optional): Get the transactions to this date (any format that is accepted by momentjs). Provide the param 'to_block' or 'to_date' If 'to_date' and 'to_block' are provided, 'to_block' will be used.
from_block (optional): The minimum block number from where to get the transactions Provide the param 'from_block' or 'from_date' If 'from_date' and 'from_block' are provided, 'from_block' will be used.
to_block (optional): The maximum block number from where to get the transactions. Provide the param 'to_block' or 'to_date' If 'to_date' and 'to_block' are provided, 'to_block' will be used.
offset (optional): Offset.
limit (optional): Limit.

Returns (Array) : ERC20 token transfers

`useNativeTransactions()`

🧾 Gets the transactions from the current user or specified address. Returns an object with the number of transactions and the array of native transactions

Options:

chain (optional): The blockchain to get data from. Valid values are listed on the intro page in the Transactions and Balances section. Default value: current chain.
address (optional): A user address (i.e. 0x1a2b3x...). If specified, the user attached to the query is ignored and the address will be used instead.
from_date (optional): The date from where to get the transactions (any format that is accepted by momentjs). Provide the param 'from_block' or 'from_date' If 'from_date' and 'from_block' are provided, 'from_block' will be used.
to_date (optional): Get the transactions to this date (any format that is accepted by momentjs). Provide the param 'to_block' or 'to_date' If 'to_date' and 'to_block' are provided, 'to_block' will be used.
from_block (optional): The minimum block number from where to get the transactions Provide the param 'from_block' or 'from_date' If 'from_date' and 'from_block' are provided, 'from_block' will be used.
to_block (optional): The maximum block number from where to get the transactions. Provide the param 'to_block' or 'to_date' If 'to_date' and 'to_block' are provided, 'to_block' will be used.
offset (optional): Offset.
limit (optional): Limit.

Returns (Array) : native transactions

`useTokenPrice()`

💰 Gets the price nominated in the native token and usd for a given token contract address

Options:

chain (optional): The blockchain to get data from. Valid values are listed on the intro page in the Transactions and Balances section. Default value: current chain (if the chain is not supported it will use the Eth chain).
address (optional): A user address (i.e. 0x1a2b3x...). If specified, the user attached to the query is ignored and the address will be used instead.
exchange (optional): The factory name or address of the token exchange. Possible exchanges, for different chains are: ETH mainnet: uniswap-v3, sushiswap, uniswap-v2, BSC mainnet: pancakeswap-v2, pancakeswap-v1. Polygon mainnet: quickswap. If no exchange is specified, all exchanges are checked (in the order as listed above) until a valid pool has been found. Note that this request can take more time. So specifying the exchange will result in faster responses most of the time.
to_block (optional): Returns the price for a given blocknumber (historical price-data).

Example

import { useTokenPrice } from "./hooks/useTokenPrice";

const TokenPrice = () => {

 const { tokenPrice } = useTokenPrice({chain, tokenAddress});

  return (
    <View>
        <Text>{tokenPrice.usdPrice}</Text>
    </View>
  );
}

Example return (Object)

{
    "exchangeAddress": "0x5757371414417b8C6CAad45bAeF941aBc7d3Ab32",
    "exchangeName": "Quickswap",
    "nativePrice": "0.0003 MATIC",
    "usdPrice": "$1.08"
}

{
    "exchangeAddress": "0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73",
    "exchangeName": "PancakeSwap v2",
    "nativePrice": "0.0005 BNB",
    "usdPrice": "$0.28"
}

`useNFTTransfers()`

`useNFTBalance()`

🎨 Gets all NFTs from the current user or address. Supports both ERC721 and ERC1155. Returns an object with the number of NFT objects and the array of NFT objects.

Options:

chain (optional): The blockchain to get data from. Valid values are listed on the intro page in the Transactions and Balances section. Default value: current chain (if the chain is not supported it will use the Eth chain).
address (optional): A user address (i.e. 0x1a2b3x...). If specified, the user attached to the query is ignored and the address will be used instead.

Example return (Object)

[{
    "amount": "1",
    "block_number": "9449788",
    "block_number_minted": "9449091",
    "contract_type": "ERC1155",
    "frozen": 0,
    "image": "https://nyc-feb-19-2020.s3.amazonaws.com/skin-slip-animation.gif",
    "is_valid": 1,
    "metadata": 
      {
        "description": "On February 19th, we will introduce the future of b̶l̶o̶c̶k̶c̶h̶a̶i̶n̶ gaming. And you’ll see why Kitties were just the start.",
        "external_url": "https://www.nycfeb192020.com/",
        "image": "https://nyc-feb-19-2020.s3.amazonaws.com/skin-slip-animation.gif",
        "name": "NYC Feb 19th 2020"
      },
    "name": "NYC February 19th 2020",
    "owner_of": "0x71a11bc477048cca56d645ffc66ca762f62d1c3c",
    "symbol": "NYCFEB192020",
    "synced_at": "2021-12-06T19:02:12.378Z",
    "syncing": 2,
    "token_address": "0xd193a22224795c43d837a3f3d7394b4d0cc15f60",
    "token_id": "1",
    "token_uri": "https://nyc-feb-19-2020.s3.amazonaws.com/metadata.json"
 }]

MehdiEskandari / ethereum-react-native-boilerplate

`ethereum-react-native-boilerplate`

⭐️ `Star us`

🤝 `Need help?`

🚀 Quick Start

🧭 Table of contents

🏗 Ethereum Components

`<CryptoAuth />`

`<NativeBalance />`

`<ERC20Balance />`

`<Assets />`

`<RecentTransactions />`

`<TransactionDetails />`

`<Blockie />`

`<Address />`

🧰 Ethereum Hooks

`useERC20balance()`

`useNativeBalance()`

`useERC20Transfers()`

`useNativeTransactions()`

`useTokenPrice()`

`useNFTTransfers()`

`useNFTBalance()`

About

Languages

ethereum-react-native-boilerplate

⭐️ Star us

🤝 Need help?

🚀 Quick Start

🧭 Table of contents

🏗 Ethereum Components

<CryptoAuth />

<NativeBalance />

<ERC20Balance />

<Assets />

<RecentTransactions />

<TransactionDetails />

<Blockie />

<Address />

🧰 Ethereum Hooks

useERC20balance()

useNativeBalance()

useERC20Transfers()

useNativeTransactions()

useTokenPrice()

useNFTTransfers()

useNFTBalance()

About

Languages

`ethereum-react-native-boilerplate`

⭐️ `Star us`

🤝 `Need help?`

`<CryptoAuth />`

`<NativeBalance />`

`<ERC20Balance />`

`<Assets />`

`<RecentTransactions />`

`<TransactionDetails />`

`<Blockie />`

`<Address />`

`useERC20balance()`

`useNativeBalance()`

`useERC20Transfers()`

`useNativeTransactions()`

`useTokenPrice()`

`useNFTTransfers()`

`useNFTBalance()`