📂 Functions

# Overview

Table of Contents

RrpBeaconServer.sol (opens new window) serves Beacon values sourced from Airnode. A Beacon is a live data point associated with a beaconId which is derived from a templateId and additional parameters. This is suitable where the more recent data point is always more favorable, e.g., in the context of an asset price data feed.

Another definition of Beacons are single-Airnode data feeds that can be used individually or combined to build decentralized data feeds or dAPIs.

# Creating a starter project

# Using a CLI tool

The easiest way to create a new project is by running a CLI tool, which generates the minimal project files that will get you started with building your application based on beacons. Simply run:

npm exec --package @api3/services --call create-beacon-reader-app
1

The CLI tool will ask you for path in which to initialize the project and template on which the project files are based. As of now, there is only one template to choose (using javascript + hardhat), but there will be more templates in the future. You can also show help or pass the arguments directly:

# To show help
npm exec --package @api3/services --call "create-beacon-reader-app --help"
# To provide the path and template directly through CLI
npm exec --package @api3/services --call "create-beacon-reader-app  --path=./my-app --template=javascript-ethers-hardhat"
1
2
3
4

Git needed

In order to install the @api3/services repository you need to have git installed.

# Clone or download an existing repo

Alternatively, you can clone or download the beacon-reader-example (opens new window) repository from GitHub. This project was created by the services CLI tool mentioned above.

This starter project steps through reading a Beacon value from a smart contract. Be sure to read through the README.md (opens new window) and some of the example code such as the BeaconReaderExample.sol (opens new window) smart contract.

# RrpBeaconServer Contract Addresses

See the Contract Addresses doc for a list of addresses available on specific networks.

# Solidity Videos

The following short videos are relevant to smart contracts when calling other contracts such as RrpBeaconServer.sol.

Last Updated: 5/15/2022, 11:04:51 AM