RedStone oracle

How to use real-time data in TON contracts

RedStone is a pull oracle that uses an alternative design for providing oracle data to smart contracts. Instead of constantly persisting data on the contract’s storage, the information is brought on-chain only when needed by end users. Until that moment, data remains in the decentralized cache layer, powered by RedStone light cache gateways and a stream-based data broadcasting protocol.

Data is transferred to the contract by end users, who attach signed data packages to their function invocations. The information integrity is verified on-chain through signature checking.

Install the RedStone SDK

Install the RedStone TON connector and other necessary dependencies:

npm install @redstone-finance/ton-connector @redstone-finance/sdk

Write code to interact with oracle

Off-chain data fetch and update

The following code snippet demonstrates how to fetch price updates and interact with RedStone contracts on TON:

import { TonPricesContractConnector } from "@redstone-finance/ton-connector";
import { ContractParamsProvider, getSignersForDataServiceId } from "@redstone-finance/sdk";

async function main() {
  // Configure API endpoint
  const apiV2Config = {
    apiEndpoint: "https://testnet.toncenter.com/api/v2/jsonRPC",
    apiKey: "your-api-key-here", // Get your TON Center API key
  };

  // Initialize the connector
  const contractAddress = "EQCMxfukwpP3BI_6Pn3lmOXgxlp3dPabVGOM0UvJCjsDhkdD";
  const prices = new TonPricesContractConnector(network, contractAddress);

  // Configure RedStone data service parameters
  const paramsProvider = new ContractParamsProvider({
    dataServiceId: "redstone-main-demo",
    uniqueSignersCount: 1,
    dataPackagesIds: ["ETH", "BTC"],
    authorizedSigners: getSignersForDataServiceId("redstone-main-demo"),
  });

  // Get prices using on-the-fly processing (doesn't modify contract state)
  const pricesFromPayload = await (await prices.getAdapter()).getPricesFromPayload(paramsProvider);
  console.log("ETH and BTC prices from payload:", pricesFromPayload);

  // Write prices to contract storage (modifies contract state)
  await (await prices.getAdapter()).writePricesFromPayloadToContract(paramsProvider);
  console.log("Prices written to contract storage successfully.");

  // Read prices from contract storage
  const storedPrices = await (await prices.getAdapter()).readPricesFromContract(paramsProvider);
  console.log("Stored prices:", storedPrices);

  // Get timestamp of last update
  const lastUpdateTimestamp = await (await prices.getAdapter()).readTimestampFromContract();
  console.log("Last update timestamp:", lastUpdateTimestamp);
}

main().catch(console.error);

This code snippet does the following:

1. Imports the TonPricesContractConnector and sets up the RedStone SDK.
2. Configures the API endpoint and creates a connector to your deployed contract.
3. Sets up a ContractParamsProvider with the data service ID and feed identifiers.
4. Fetches price data using on-the-fly processing (no gas cost).
5. Writes price data to the contract’s storage (requires gas).
6. Reads stored prices and the last update timestamp from the contract.

On-chain data verification

TODO

Contract types

RedStone provides several contract types for different use cases:

Price Manager

Manages multiple price feeds with signature verification and supports both on-the-fly processing and storage persistence.

Single Feed Manager

Simplified version for handling a single price feed, reducing gas costs for single-feed applications.

Price Feed

An individual feed contract that stores price data for a specific asset.

Sample Consumer

Example consumer contract that demonstrates how to read data from price feeds.

Error handling

Common error codes you might encounter:

• 300+: Insufficient valid signers (less than signer_count_threshold)
• 200+: Timestamp validation failed (data too old or in the future)
• Other codes: See RedStone constants

Additional resources

You may find these additional resources helpful for developing your TON application:

• RedStone documentation
• RedStone TON connector
• RedStone smart contracts
• RedStone showroom