Networks and Endpoints

The Morpher Oracle is available on both Radix Mainnet and Stokenet (testnet). This page provides the network configurations, API endpoints, and component addresses for both networks.

Oracle Request Flow

The following diagram illustrates the complete flow of a signed price request in the Morpher Oracle system:

Detailed Flow Explanation

1. User Request: The user interacts with the frontend application and initiates a transaction that requires price data.

2. DApp Backend Signing: The DApp backend creates a signed request that includes:

   • Market ID (e.g., “GATEIO:XRD_USDT”)
   • NFT ID (subscription identifier)
   • Public key (stored in the NFT)
   • Signature (signed with the DApp’s private key)

3. Oracle Request: The signed request is sent to the Oracle backend.

4. Oracle Verification: The Oracle backend verifies:

   • The signature is valid (signed by the DApp)
   • The NFT exists and is valid
   • The public key in the request matches the one stored in the NFT

5. Oracle Response: If verification passes, the Oracle:

   • Gets the latest price data
   • Signs it with the Oracle’s private key
   • Returns the signed price data

6. Transaction Creation: The frontend creates a transaction manifest that includes the signed price data.

7. Smart Contract Verification: The process works as follows:

   • The smart contract calls the Oracle component with the signed price data
   • The Oracle component verifies the signature and returns a PriceMessage
   • The smart contract checks that the price data is fresh (not too old)
   • The smart contract executes its business logic (e.g., minting a Gumball token)

For more details on how the Oracle handles timestamp validation, especially for markets with limited trading hours, see our Timestamp Validation guide.

This secure flow ensures that only authorized DApps can access Oracle data and that the data used in transactions is authentic and up-to-date.

Network Configurations

Environment Variables

When integrating the Morpher Oracle into your application, you should use environment variables to configure the network settings. The tables above show the current values for reference, but you should always use the environment variables in your code to ensure you’re using the correct values for your environment.

For a complete implementation example of how to use these environment variables, see the Integration Guide.

API Endpoints

Oracle API

The Oracle API provides endpoints for requesting signed price data:

• Price Endpoint (v2): {API_ENDPOINT}/v2/price/{marketId}/{publicKey}/{nftId}/{signature}
  • marketId: The ID of the market (e.g., “GATEIO:XRD_USDT”)
  • publicKey: Your BLS public key
  • nftId: Your subscription NFT ID
  • signature: Signature of the request

Sample API

The Sample API provides simplified endpoints for demonstration purposes:

• Get Price: {SAMPLE_API_ENDPOINT}/example/getPrice
  • Returns signed price data for a predefined market

Using the Network Configuration

In your application, you can use the network configuration as follows:

import { RadixNetwork } from '@radixdlt/radix-dapp-toolkit';
 
// Network configuration based on selected network
const getNetworkConfig = (network: 'mainnet' | 'stokenet') => {
  return {
    networkId: network === 'mainnet' ? RadixNetwork.Mainnet : RadixNetwork.Stokenet,
    apiEndpoint: network === 'mainnet' 
      ? process.env.NEXT_PUBLIC_RADIX_MAINNET_API_ENDPOINT 
      : process.env.NEXT_PUBLIC_RADIX_STOKENET_API_ENDPOINT,
    sampleApiEndpoint: network === 'mainnet'
      ? process.env.NEXT_PUBLIC_RADIX_MAINNET_SAMPLE_API_ENDPOINT
      : process.env.NEXT_PUBLIC_RADIX_STOKENET_SAMPLE_API_ENDPOINT,
    dappDefinitionAddress: network === 'mainnet'
      ? process.env.NEXT_PUBLIC_RADIX_MAINNET_DAPP_DEFINITION_ADDRESS
      : process.env.NEXT_PUBLIC_RADIX_STOKENET_DAPP_DEFINITION_ADDRESS,
    oracleComponentAddress: network === 'mainnet'
      ? process.env.NEXT_PUBLIC_RADIX_MAINNET_ORACLE_COMPONENT_ADDRESS
      : process.env.NEXT_PUBLIC_RADIX_STOKENET_ORACLE_COMPONENT_ADDRESS,
    // ... other configuration properties
  };
};
 
// Get the configuration for the current network
const networkConfig = getNetworkConfig(currentNetwork);

For a complete implementation example, see the Integration Guide.