Skip to content

feat: Add Base deployment guide and examples #9

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ukml wants to merge 7 commits into
base: main
Choose a base branch
from
+31 −0
Open

feat: Add Base deployment guide and examples #9

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
5669e45
feat: Add Base chain deployment guide and examples
ukml Dec 19, 2025
3747b14
fix: Address CodeRabbit feedback - complete Hardhat config and add or…
ukml Dec 19, 2025
64b8ef3
Commit changes
ukml Dec 19, 2025
e278673
Update README.md
ukml Dec 19, 2025
ab0146b
Update README.md
ukml Dec 19, 2025
1a2237a
Update README.md
ukml Dec 19, 2025
c7179f4
style: Use en dash for fee range per nitpick
ukml Dec 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,3 +114,34 @@ Adapters and node toml files to implement the API are available on github
* [Truflation discord developer chat](https://discord.com/channels/967280164071407666/968071680360587264)
* [Network endpoints](network.md)
* [Using solt to get a contract on etherscan](https://blog.jubb.xyz/post/solt-release/)
## Deploying on Base (Coinbase's Layer 2)

Truflation data is fully available on Base, with cross-chain access supported via Chainlink CCIP.

**Note:** As of December 2025, the legacy Chainlink "Any API" style in this quickstart is primarily for testnets. On Base mainnet, Truflation recommends modern **Chainlink Data Streams** or custom streams via the Marketplace.

For the latest configurations:
- [Truflation Marketplace](https://marketplace.truflation.com/) – Select your data stream and Base chain to get custom details.
- [Chainlink Data Streams docs](https://docs.chain.link/data-streams)
- [Chainlink CCIP docs](https://docs.chain.link/ccip)

### Quick Steps for TruflationTester.sol on Base:
1. Use Remix or Hardhat with Base network config (example below).
2. When deploying the contract (constructor: address oracleId_, string jobId_, uint256 fee_, address token_):
- Get oracle address and job ID from the Truflation Marketplace (select index + Base chain).
- Fee: 0.1 – 0.5 LINK (in wei, e.g., 0.1 LINK = 100000000000000000).
- LINK token address (official Chainlink):
- Mainnet: 0x88Fb150BDc53A65fe94Dea0c9BA0a6dAf8C6e196
Copy link

@coderabbitai coderabbitai bot Dec 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

Incorrect Base mainnet LINK token address.

The correct LINK token contract address for Base mainnet is 0xcbc8a9e1073cfac0f5d0e52ff96fe47b2adaf480, not the address currently listed. Using the incorrect address will cause token transfer failures when users attempt to fund their contracts.

🔎 Proposed fix 
-     - Mainnet: 0x88Fb150BDc53A65fe94Dea0c9BA0a6dAf8C6e196
+     - Mainnet: 0xcbc8a9e1073cfac0f5d0e52ff96fe47b2adaf480
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- Mainnet: 0x88Fb150BDc53A65fe94Dea0c9BA0a6dAf8C6e196
- Mainnet: 0xcbc8a9e1073cfac0f5d0e52ff96fe47b2adaf480
🤖 Prompt for AI Agents 
In README.md around line 135, the listed Base mainnet LINK token address is
incorrect (0x88Fb150BDc53A65fe94Dea0c9BA0a6dAf8C6e196); replace it with the
correct address 0xcbc8a9e1073cfac0f5d0e52ff96fe47b2adaf480 so users funding
contracts use the right token contract and avoid transfer failures. Ensure the
address is updated exactly in the Mainnet entry and verify there are no other
occurrences of the old address elsewhere in the README.

- Testnet (Base Sepolia): 0xE4aB69C077896252FAFBD49EFD26B5D171A32410
3. Fund your deployed contract with LINK:
- Testnet: [Chainlink Faucet for Base Sepolia](https://faucets.chain.link/base-sepolia) (provides test LINK + ETH).
- Mainnet: Bridge LINK using the [Base Bridge](https://bridge.base.org/deposit).
4. Call `requestYoyInflation()` to fetch data.
5. Example Hardhat network config (add to your `hardhat.config.js`):
```js
base: {
url: "https://mainnet.base.org",
accounts: [process.env.PRIVATE_KEY],
chainId: 8453 // Use 84532 for Base Sepolia testnet
}