Testnet Oracles

Operator Contracts

Testnet Operator contracts are deployed and maintained on the following networks:

Testnet	Oracle Address
Ethereum Sepolia	`0x6090149792dAAeE9D1D568c9f9a6F6B46AA29eFD`
Avalanche Fuji	`0x022EEA14A6010167ca026B32576D6686dD7e85d2`
Binance Testnet	`0xCC79157eb46F5624204f47AB42b3906cAA40eaB7`
Fantom Testnet	`0xCC79157eb46F5624204f47AB42b3906cAA40eaB7`

Jobs

Job IDs

To make testing simple, jobs are configured with the following properties:

Each request on a testnet costs 0.1 LINK.
Each oracle will wait for 1 confirmation before processing a request.
Jobs have the same IDs across each testnet.
Parameters are required. See examples for code snippets.

Purpose	Tasks	Job ID	Required Parameters
*GET>bytes: HTTP GET to any public API parse the response return arbitrary-length raw byte data bytes*. The job specs can be found here	Http JsonParse Ethabiencode	`7da2702f37fd48e5b1b9a5715e3509b6`	`get`: string `path`: JSONPath expression with comma(,) delimited string
*GET>uint256: HTTP GET to any public API parse the response multiply the result by a multiplier return an unsigned integer uint256* . The job specs can be found here	Http JsonParse Multiply Ethabiencode	`ca98366cc7314957b8c012c72f05aeeb`	`get`: string `path`: JSONPath expression with comma(,) delimited string `times`: int
*GET>int256: HTTP GET to any public API parse the response multiply the result by a multiplier return a signed integer int256*. The job specs can be found here	Http JsonParse Multiply Ethabiencode	`fcf4140d696d44b687012232948bdd5d`	`get`: string `path`: JSONPath expression with comma(,) delimited string `times`: int
*GET>bool: HTTP GET to any public API parse the response return a boolean bool*. The job specs can be found here	Http JsonParse Ethabiencode	`c1c5e92880894eb6b27d3cae19670aa3`	`get`: string `path`: JSONPath expression with comma(,) delimited string
*GET>string: HTTP GET to any public API parse the response return a sequence of characters string*. The job specs can be found here	Http JsonParse Ethabiencode	`7d80a6386ef543a3abb52817f6707e3b`	`get`: string `path`: JSONPath expression with comma(,) delimited string

Examples

Get > bytes

A full example can be found here.

Request method

function request() public {
  Chainlink.Request memory req = _buildChainlinkRequest('7da2702f37fd48e5b1b9a5715e3509b6', address(this), this.fulfill.selector);
  req._add(
      'get',
      'https://ipfs.io/ipfs/QmZgsvrA1o1C8BGCrx6mHTqR1Ui1XqbCrtbMVrRLHtuPVD?filename=big-api-response.json'
  );
  req._add('path', 'image');
  _sendChainlinkRequest(req, (1 * LINK_DIVISIBILITY) / 10); // 0,1*10**18 LINK
}

Callback method

bytes public data;
string public imageUrl;
function fulfill(bytes32 requestId, bytes memory bytesData) public recordChainlinkFulfillment(requestId) {
    data = bytesData;
    imageUrl = string(data);
}

Get > uint256

A full example can be found here.

Request method

function request() public {
  Chainlink.Request memory req = _buildChainlinkRequest('ca98366cc7314957b8c012c72f05aeeb', address(this), this.fulfill.selector);
  req._add(
      'get',
      'https://min-api.cryptocompare.com/data/pricemultifull?fsyms=ETH&tsyms=USD'
  );
  req._add('path', 'RAW,ETH,USD,VOLUME24HOUR');
  req._addInt('times', 10**18); // Multiply by times value to remove decimals. Parameter required so pass '1' if the number returned doesn't have decimals
  _sendChainlinkRequest(req, (1 * LINK_DIVISIBILITY) / 10); // 0,1*10**18 LINK
}

Callback method

uint256 public volume;
function fulfill(bytes32 _requestId, uint256 _volume) public recordChainlinkFulfillment(_requestId) {
  volume = _volume;
}

Get > int256

Request method

function request() public {
  Chainlink.Request memory req = _buildChainlinkRequest('fcf4140d696d44b687012232948bdd5d', address(this), this.fulfill.selector);
  req._add(
      'get',
      'https://min-api.cryptocompare.com/data/pricemultifull?fsyms=ETH&tsyms=USD'
  );
  req._add('path', 'RAW,ETH,USD,VOLUME24HOUR');
  req._addInt('times', 10**18); // Multiply by times value to remove decimals. Parameter required so pass '1' if the number returned doesn't have decimals
  _sendChainlinkRequest(req, (1 * LINK_DIVISIBILITY) / 10); // 0,1*10**18 LINK
}

Callback method

int256 public volume;
function fulfill(bytes32 _requestId, int256 _volume) public recordChainlinkFulfillment(_requestId) {
  volume = _volume;
}

Get > bool

Request method

function request() public {
  Chainlink.Request memory req = _buildChainlinkRequest('c1c5e92880894eb6b27d3cae19670aa3', address(this), this.fulfill.selector);
  req._add(
      'get',
      'https://app.proofi.com/api/verify/eip155/0xCB5085214B6318aF3dd0FBbb5E74fbF6bf332151?contract=0x2f7f7E44ca1e2Ca1A54db4222cF97ab47EE026F1'
  );
  req._add('path', 'approved');
  _sendChainlinkRequest(req, (1 * LINK_DIVISIBILITY) / 10); // 0,1*10**18 LINK
}

Callback method

bool public approved;
function fulfill(bytes32 _requestId, bool _approved) public recordChainlinkFulfillment(_requestId) {
  approved = _approved;
}

Get > string

A full example can be found here.

Request method

function request() public {
  Chainlink.Request memory req = _buildChainlinkRequest('7d80a6386ef543a3abb52817f6707e3b', address(this), this.fulfill.selector);
  req._add(
      'get',
      'https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&per_page=10'
  );
  req._add('path', '0,id');
  _sendChainlinkRequest(req, (1 * LINK_DIVISIBILITY) / 10); // 0,1*10**18 LINK
}

Callback method

string public id;
function fulfill(bytes32 _requestId, string memory _id) public recordChainlinkFulfillment(_requestId) {
  id = _id;
}

Testnet Oracles

Get the latest Chainlink content straight to your inbox.