Skip to content

Commit 92d2028

Browse files
committed
on-chain->onchain, off-chain -> offchain
1 parent eb65a75 commit 92d2028

File tree

1 file changed

+30
-30
lines changed

1 file changed

+30
-30
lines changed

src/content/quickstarts/transmitter.mdx

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Automated Data Relay with Data Streams Transmitter"
3-
description: "Set up and manage a self-hosted, automated relay to push off-chain Data Streams to your smart contracts."
3+
description: "Set up and manage a self-hosted, automated relay to push offchain Data Streams to your smart contracts."
44
githubSourceCodeUrl: "https://github.com/hackbg/chainlink-datastreams-transmitter"
55
image: "QuickStarts-DataStreams-Transmitter.webp"
66
products: ["streams"]
@@ -31,11 +31,11 @@ import DataStreams from "@features/data-streams/common/DataStreams.astro"
3131
Please do your own research and audit the code before using this tool in a production environment.
3232
</Aside>
3333

34-
While [Chainlink Data Streams](/data-streams/index) provide access to low-latency market data off-chain, the process of bringing this data on-chain requires significant engineering. Developers must build, deploy, and maintain a custom infrastructure service that can reliably connect to the Data Streams API, implement robust WebSocket reconnection logic, and manage the on-chain transaction logic for when and how to push updates.
34+
While [Chainlink Data Streams](/data-streams/index) provide access to low-latency market data offchain, the process of bringing this data onchain requires significant engineering. Developers must build, deploy, and maintain a custom infrastructure service that can reliably connect to the Data Streams API, implement robust WebSocket reconnection logic, and manage the onchain transaction logic for when and how to push updates.
3535

36-
The [Data Streams Transmitter][GITHUB_REPO], a community-led solution, provides a foundational framework for the DevOps teams and Infrastructure Managers tasked with building these systems. Transmitter is a configurable service that handles the core logic of monitoring off-chain Data Streams and pushing values to your smart contracts based on predefined conditions, such as time intervals or price deviations. It also includes a web interface to manage your feeds and monitor their status.
36+
The [Data Streams Transmitter][GITHUB_REPO], a community-led solution, provides a foundational framework for the DevOps teams and Infrastructure Managers tasked with building these systems. Transmitter is a configurable service that handles the core logic of monitoring offchain Data Streams and pushing values to your smart contracts based on predefined conditions, such as time intervals or price deviations. It also includes a web interface to manage your feeds and monitor their status.
3737

38-
This guide walks you through deploying a `DataStreamsFeed` consumer contract, setting up the Data Streams Transmitter, and configuring it to monitor a specific Data Stream and relay it to your on-chain contract.
38+
This guide walks you through deploying a `DataStreamsFeed` consumer contract, setting up the Data Streams Transmitter, and configuring it to monitor a specific Data Stream and relay it to your onchain contract.
3939

4040
---
4141

@@ -47,17 +47,17 @@ This guide walks you through deploying a `DataStreamsFeed` consumer contract, se
4747
Architecture](/data-streams/architecture) documentation.
4848
</Aside>
4949

50-
Transmitter relays data from the off-chain Chainlink network to your on-chain contracts in the following sequence:
50+
Transmitter relays data from the offchain Chainlink network to your onchain contracts in the following sequence:
5151

52-
1. **Off-chain | Data Generation:** A Chainlink Decentralized Oracle Network (DON) generates and signs low-latency data reports, making them available in the off-chain Data Streams Aggregation Network.
52+
1. **Offchain | Data Generation:** A Chainlink Decentralized Oracle Network (DON) generates and signs low-latency data reports, making them available in the offchain Data Streams Aggregation Network.
5353

54-
1. **Off-chain | Monitoring:** Transmitter, which you operate, continuously monitors this off-chain network for new reports via a WebSocket connection.
54+
1. **Offchain | Monitoring:** Transmitter, which you operate, continuously monitors this offchain network for new reports via a WebSocket connection.
5555

56-
1. **On-chain | Transmission:** Based on your predefined conditions (such as a time interval or price deviation), Transmitter bundles the latest report into a transaction and submits it to your designated Oracle Contract.
56+
1. **Onchain | Transmission:** Based on your predefined conditions (such as a time interval or price deviation), Transmitter bundles the latest report into a transaction and submits it to your designated Oracle Contract.
5757

58-
1. **On-chain | Verification:** Within that single transaction, your Oracle Contract immediately calls the Chainlink Verifier Contract, which uses its `LINK` allowance to submit the verification request. The Verifier authenticates the report by checking the DON's cryptographic signature. If verification fails, the entire transaction reverts, ensuring no state change occurs.
58+
1. **Onchain | Verification:** Within that single transaction, your Oracle Contract immediately calls the Chainlink Verifier Contract, which uses its `LINK` allowance to submit the verification request. The Verifier authenticates the report by checking the DON's cryptographic signature. If verification fails, the entire transaction reverts, ensuring no state change occurs.
5959

60-
1. **On-chain | Consumption:** Upon successful verification, the data is written to your Oracle Contract's storage. This freshly verified, low-latency data is now available on-chain for your dApp or other smart contracts to consume.
60+
1. **Onchain | Consumption:** Upon successful verification, the data is written to your Oracle Contract's storage. This freshly verified, low-latency data is now available onchain for your dApp or other smart contracts to consume.
6161

6262
<ClickToZoom
6363
src="/images/quickstarts/feature/QuickStarts-DataStreams-Transmitter.webp"
@@ -76,7 +76,7 @@ Before you start this tutorial, ensure you have the following prerequisites:
7676
- **Software Dependencies**: [Foundry][FOUNDRY_INSTALL], [Docker][DOCKER_INSTALL], [Node.js][NODE_INSTALL], and [Redis][REDIS_INSTALL] installed on your deployment host. This guide uses `pnpm` for package management.
7777
- **Development Wallet**: This guide requires a funded development wallet and its **private key** to send transactions.
7878
- **Network Configuration**: This guide uses **Avalanche Fuji**. You can find RPC URLs on [Chainlist](https://chainlist.org).
79-
- **Testnet Funds**: The wallet must be funded with testnet `AVAX` to pay for transaction fees on the **Avalanche Fuji** network. Testnet `LINK` must be provided to the deployed contract to pay for on-chain verification fees. Both are available from the [Chainlink Faucet](https://faucets.chain.link/).
79+
- **Testnet Funds**: The wallet must be funded with testnet `AVAX` to pay for transaction fees on the **Avalanche Fuji** network. Testnet `LINK` must be provided to the deployed contract to pay for onchain verification fees. Both are available from the [Chainlink Faucet](https://faucets.chain.link/).
8080
- **API Credentials**: Access to Data Streams requires API credentials. If you haven't already, [contact us][DATA_STREAMS_CONTACT] to request Data Streams access.
8181
- **Web3 Foundation**: A basic understanding of [smart contracts and blockchain development](/quickstarts/deploy-your-first-contract).
8282

@@ -165,7 +165,7 @@ First, deploy a [`DataStreamsFeed.sol` contract](https://github.com/woogieboogie
165165
</Accordion>
166166
167167
<Accordion title="Set Up Transmitter" number={2}>
168-
With a consumer contract on-chain, you can now set up the Transmitter service to relay data to it.
168+
With a consumer contract onchain, you can now set up the Transmitter service to relay data to it.
169169
170170
1. In a new terminal window, navigate to your development space and clone the [Data Stream Transmitter repository][GITHUB_REPO]:
171171
@@ -204,7 +204,7 @@ With a consumer contract on-chain, you can now set up the Transmitter service to
204204
1. Create the runtime configuration file by copying the example:
205205
206206
```bash
207-
cp config-chainlink-example.yml config.yml
207+
cp config-chainlink-verify-example.yml config.yml
208208
```
209209
210210
1. Open `config.yml` in a text editor. Update the `targetChains` section to point to the contract you deployed on **Avalanche Fuji**.
@@ -287,7 +287,7 @@ With a consumer contract on-chain, you can now set up the Transmitter service to
287287
288288
- Replace `0xYOUR_AVALANCHE_FUJI_CONTRACT_ADDRESS` with the address of the contract you deployed in the previous step.
289289
- The `feedId` should match the one you set in the contract deployment.
290-
- Each target block must keep `skipVerify: false`, `functionName: verifyAndUpdateReport`, and `functionArgs: ["rawReport", "parameterPayload"]` to ensure the Transmitter correctly prepares the transaction for on-chain verification.
290+
- Each target block must keep `skipVerify: false`, `functionName: verifyAndUpdateReport`, and `functionArgs: ["rawReport", "parameterPayload"]` to ensure the Transmitter correctly prepares the transaction for onchain verification.
291291
292292
1. Start the Docker daemon.
293293
@@ -311,7 +311,7 @@ With a consumer contract on-chain, you can now set up the Transmitter service to
311311
312312
## UI Overview
313313
314-
The Transmitter UI lets you manage your feeds, monitor their status, and define how and where data is pushed on-chain. Although we configured the basics in `config.yml`, you can manage the service from this dashboard.
314+
The Transmitter UI lets you manage your feeds, monitor their status, and define how and where data is pushed onchain. Although we configured the basics in `config.yml`, you can manage the service from this dashboard.
315315
316316
<ClickToZoom src="/images/quickstarts/transmitter/transmitter_home.png" alt="The Transmitter home page" />
317317
@@ -321,21 +321,21 @@ The optional sections below provide a detailed overview of the Transmitter UI, e
321321
322322
On the upper-right corner of the page you will find the **Chain** section. Since the default chain is configured to `Avalanche Fuji`, you should see that network listed along with details for your wallet.
323323
324-
| Field | Description |
325-
| :----------------------- | :----------------------------------------------------------------------------------- |
326-
| **Current Chain** | The current chain, which is where data will be pushed. |
327-
| **Chain ID** | The unique numeric identifier for the current chain. |
328-
| **Wallet Address** | Your unique wallet address. |
329-
| **Native Token Balance** | Your native token balance, which is used to pay for on-chain transaction fees (gas). |
330-
| **LINK Balance** | Your `LINK` token balance, used to pay for Chainlink Data Streams transactions. |
324+
| Field | Description |
325+
| :----------------------- | :---------------------------------------------------------------------------------- |
326+
| **Current Chain** | The current chain, which is where data will be pushed. |
327+
| **Chain ID** | The unique numeric identifier for the current chain. |
328+
| **Wallet Address** | Your unique wallet address. |
329+
| **Native Token Balance** | Your native token balance, which is used to pay for onchain transaction fees (gas). |
330+
| **LINK Balance** | Your `LINK` token balance, used to pay for Chainlink Data Streams transactions. |
331331
332332
Your balance should reflect the amount of testnet LINK and AVAX you have in your wallet. If you need more, you can use the [Chainlink Faucet](https://faucets.chain.link/).
333333
334334
</Accordion>
335335
336336
<Accordion title="Logs">
337337
338-
On the top-right corner of the page, you will find the **Logs** section, which contains details for all Transmitter actions. When operating correctly, the log should reflect a clear, step-by-step process for each on-chain update.
338+
On the top-right corner of the page, you will find the **Logs** section, which contains details for all Transmitter actions. When operating correctly, the log should reflect a clear, step-by-step process for each onchain update.
339339
340340
Example log output:
341341
@@ -365,7 +365,7 @@ The **Data Streams** section lists all Data Streams, their status, and any relat
365365
| **Stream** | The name of the stream. This is the name set by the user for easier tracking and feed identification. |
366366
| **Feed ID** | The feed ID. Check [Chainlink Data Streams Documentation](/data-streams/crypto-streams) for a list of supported streams. |
367367
| **Contract** | Target contract for the feed on the current chain. Click to open a configuration page where you can define the target contract, functions, and ABI. |
368-
| **Saved price** | The latest price recorded on-chain. |
368+
| **Saved price** | The latest price recorded onchain. |
369369
| **Last reported** | The latest price reported by the stream. |
370370
| **Status** | Current status of the stream. Possible states include: `Running`, `Connecting`, `Stopping` or `Stopped`. |
371371
| **Remove** | Click to remove the stream. |
@@ -374,19 +374,19 @@ The **Data Streams** section lists all Data Streams, their status, and any relat
374374
375375
<Accordion title="Schedule" >
376376
377-
The **Schedule** section allows you to define how often the Transmitter should push data on-chain, using a cron expression. We have already defined this in the `config.yml` file, but you can change it here.
377+
The **Schedule** section allows you to define how often the Transmitter should push data onchain, using a cron expression. We have already defined this in the `config.yml` file, but you can change it here.
378378
379379
</Accordion>
380380
381381
<Accordion title="Verifier Contracts" >
382382
383-
The **Verifier Contracts** section lets you specify contracts that will verify the data being pushed on-chain. The verifier contract for your current network will be automatically selected based on `config.yml`.
383+
The **Verifier Contracts** section lets you specify contracts that will verify the data being pushed onchain. The verifier contract for your current network will be automatically selected based on `config.yml`.
384384
385385
</Accordion>
386386
387387
<Accordion title="Price Delta" >
388388
389-
The **Price Delta** section lets you define the price change threshold that will trigger an on-chain update. We set this in the `config.yml` file, but you can change this value here.
389+
The **Price Delta** section lets you define the price change threshold that will trigger an onchain update. We set this in the `config.yml` file, but you can change this value here.
390390
391391
</Accordion>
392392
@@ -414,12 +414,12 @@ If you run into issues during setup or operation, refer to these common problems
414414
- **Data is not updating on your contract**
415415
- Review the logs in Transmitter for specific error messages related to the feed or contract interaction.
416416
- **Authentication:** Verify that your `DATASTREAMS_CLIENT_ID` and `DATASTREAMS_CLIENT_SECRET` are correct and do not have extra spaces or characters.
417-
- **LINK Balance:** Ensure the contract holds sufficient `LINK` balance to pay for on-chain verification fees. Top up the contract if needed -- testnet `LINK` can be found at the [Chainlink Faucet](https://faucets.chain.link/).
417+
- **LINK Balance:** Ensure the contract holds sufficient `LINK` balance to pay for onchain verification fees. Top up the contract if needed -- testnet `LINK` can be found at the [Chainlink Faucet](https://faucets.chain.link/).
418418
- **RPC Endpoint:** Confirm the RPC URL in your `config.yml` is correct and the node is reachable.
419419
420420
---
421421
422-
### Contract Deployment & On-Chain Errors
422+
### Contract Deployment & Onchain Errors
423423
424424
- **`Gas estimation too high` error**
425425
@@ -436,7 +436,7 @@ If you run into issues during setup or operation, refer to these common problems
436436
437437
Congratulations! 🎉 You have successfully deployed a `DataStreamsFeed` contract, set up the Data Streams Transmitter, and linked them together.
438438
439-
You can now monitor off-chain Data Streams and push updates to your smart contracts without writing any code or managing your own backend infrastructure. The Transmitter handles all the complexity of connecting to Data Streams, monitoring data changes, and pushing updates on-chain.
439+
You can now monitor offchain Data Streams and push updates to your smart contracts without writing any code or managing your own backend infrastructure. The Transmitter handles all the complexity of connecting to Data Streams, monitoring data changes, and pushing updates onchain.
440440
441441
For more advanced usage, troubleshooting, or to contribute, visit the [GitHub repository][GITHUB_REPO] or check out the [official Data Streams documentation](/data-streams/index).
442442

0 commit comments

Comments
 (0)