Skip to content

feat(tefnut): add Djed Tefnut Sepolia testnet configuration and setup#159

Open
sameezy667 wants to merge 1 commit into
DjedAlliance:mainfrom
sameezy667:sameezy667/tefnut-sepolia-integration
Open

feat(tefnut): add Djed Tefnut Sepolia testnet configuration and setup#159
sameezy667 wants to merge 1 commit into
DjedAlliance:mainfrom
sameezy667:sameezy667/tefnut-sepolia-integration

Conversation

@sameezy667

@sameezy667 sameezy667 commented Dec 14, 2025

Copy link
Copy Markdown

… guides (fix #155)Summary: Adds frontend configuration and setup tooling to connect the dashboard to the Djed Tefnut protocol deployed on Sepolia testnet.

What I added:

sepolia-tefnut.env — Environment configuration for Djed Tefnut on Sepolia with updated branding (DJED/SHEN instead of SOD/SOR)
setup-env.sh and setup-env.bat — Interactive scripts to easily switch between deployment configurations
TEFNUT_SEPOLIA_SETUP.md — Comprehensive setup guide with wallet configuration, faucet links, and troubleshooting
Updated README.md — Added Tefnut to known deployments and environment configuration instructions
Why: Issue #155 requested adapting the frontend to work with the new Djed Tefnut smart contract deployed on Sepolia. This PR provides all the configuration and tooling needed to connect to the Tefnut deployment.

Summary by CodeRabbit

Release Notes

  • New Features

    • Added support for Djed Tefnut on Sepolia Testnet.
    • Introduced interactive setup scripts to easily switch between deployment environments.
  • Documentation

    • Added comprehensive Sepolia setup guide with wallet configuration and troubleshooting instructions.
    • Updated README with Sepolia deployment information and environment configuration details.

✏️ Tip: You can customize this high-level summary in your review settings.

@vercel

vercel Bot commented Dec 14, 2025

Copy link
Copy Markdown

@sameezy667 is attempting to deploy a commit to the djed-solidity Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai

coderabbitai Bot commented Dec 14, 2025

Copy link
Copy Markdown

Walkthrough

This PR adds Sepolia testnet deployment support for Djed Tefnut by introducing environment configuration files, interactive setup scripts, and comprehensive documentation to enable developers to configure and deploy the application across multiple network environments.

Changes

Cohort / File(s) Change Summary
Documentation & Deployment Information
README.md, docs/TEFNUT_SEPOLIA_SETUP.md
Added Djed Tefnut Sepolia deployment entry to Known Deployments section and new Configure Environment section with setup instructions. Introduced comprehensive Sepolia deployment guide including wallet setup, test ETH acquisition, contract addresses, and troubleshooting.
Environment Configuration
env/sepolia-tefnut.env
Added environment configuration file for Sepolia deployment containing blockchain URI, chain ID, contract addresses (Djed, reserve coin, stablecoin), explorer URL, token metadata, and React app feature flags.
Environment Setup Scripts
setup-env.sh, setup-env.bat
Added interactive environment switcher scripts for Unix/Linux/macOS and Windows, respectively, enabling users to select from predefined deployment environments and automatically copy the corresponding configuration to .env.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

  • Verify environment variable naming conventions and correctness (especially contract addresses and URIs in sepolia-tefnut.env)
  • Confirm setup scripts correctly map selections to environment files and handle edge cases (invalid input, missing files)
  • Validate that documentation accurately reflects the setup process and network parameters

Possibly related issues

Poem

🐰 A new testnet blooms on Sepolia's shore,
With scripts and configs we couldn't ignore,
Setup and docs in a tidy embrace,
Djed Tefnut finds its happy place! ✨

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly describes the main change: adding Djed Tefnut Sepolia testnet configuration and setup, which aligns with all major file additions.
Linked Issues check ✅ Passed The PR successfully delivers all coding objectives from issue #155: environment configuration for Tefnut on Sepolia, refactored dashboard connectivity, and protocol-specific setup including DJED/SHEN branding.
Out of Scope Changes check ✅ Passed All changes are in-scope: environment files, setup scripts, and documentation directly support Tefnut Sepolia integration without introducing unrelated modifications.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 0

♻️ Duplicate comments (1)
setup-env.bat (1)

1-52: Verify all referenced environment files exist in the repository.

Like setup-env.sh, this script references six environment files but only sepolia-tefnut.env is included in this PR. Users selecting options 5 or 6 (Ethereum Classic or Mordor) will encounter a "file not found" error.

🧹 Nitpick comments (4)
setup-env.sh (1)

55-55: Consider adding a backup of existing .env file.

The script directly overwrites .env without backing up any existing configuration. If a user has customized their .env file, those changes will be lost.

Consider adding a backup step:

+if [ -f .env ]; then
+  cp .env .env.backup
+  echo "📦 Existing .env backed up to .env.backup"
+fi
 cp "$ENV_FILE" .env
README.md (1)

81-81: Provide URL or deployment status for Tefnut Sepolia.

The entry for Djed Tefnut notes it's "configured in env/sepolia-tefnut.env" while the other deployments list live URLs. Consider either adding a URL when available or clarifying this is a local/development-only configuration.

setup-env.bat (1)

47-47: Consider adding a backup of existing .env file.

Similar to the bash version, the script directly overwrites .env without backing up any existing configuration.

Consider adding a backup step:

+if exist .env (
+  copy .env .env.backup >nul
+  echo.
+  echo Existing .env backed up to .env.backup
+)
 copy "%ENV_FILE%" .env >nul
env/sepolia-tefnut.env (1)

7-8: Clarify the purpose of REACT_APP_UI address.

The variable REACT_APP_UI is set to 0x0232556C83791b8291E9b23BfEa7d67405Bd9839 while REACT_APP_FEE_UI is 0. Consider adding a comment explaining what this address represents (e.g., UI fee recipient, admin address, or other protocol role).

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e46b850 and 11a1abb.

📒 Files selected for processing (5)
  • README.md (2 hunks)
  • docs/TEFNUT_SEPOLIA_SETUP.md (1 hunks)
  • env/sepolia-tefnut.env (1 hunks)
  • setup-env.bat (1 hunks)
  • setup-env.sh (1 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.18.1)
README.md

117-117: Bare URL used

(MD034, no-bare-urls)


118-118: Bare URL used

(MD034, no-bare-urls)


119-119: Bare URL used

(MD034, no-bare-urls)


120-120: Bare URL used

(MD034, no-bare-urls)

🔇 Additional comments (12)
README.md (2)

109-120: LGTM! Clear environment configuration instructions.

The new Configure Environment section provides clear, actionable steps for setting up different network environments. The instructions align well with the new setup scripts and environment files introduced in this PR.


117-120: Static analysis false positive: URLs in code blocks are intentional.

The markdownlint warnings about "bare URLs" at lines 117-120 are false positives. These are file paths in shell commands within code blocks (e.g., cp env/sepolia.env .env), not bare URLs that need formatting.

setup-env.bat (1)

19-40: LGTM! Correct Windows batch syntax and logic.

The if-else chain correctly implements the environment selection logic with proper Windows path separators (backslashes). The script is functionally equivalent to the bash version.

docs/TEFNUT_SEPOLIA_SETUP.md (4)

1-136: LGTM! Comprehensive and well-structured setup guide.

The documentation is thorough and provides clear instructions for setting up the Tefnut Sepolia deployment, including wallet configuration, faucet information, features, troubleshooting, and resources.


60-63: The Sepolia RPC URL in the documentation (https://ethereum-sepolia.publicnode.com/) matches the REACT_APP_BLOCKCHAIN_URI configuration in env/sepolia-tefnut.env exactly. No action needed.


49-51: No action needed. All contract addresses in the documentation are consistent with those in env/sepolia-tefnut.env:

  • Djed Contract: 0x624FcD0a1F9B5820c950FefD48087531d38387f4
  • Stablecoin Address: 0x6b930182787F346F18666D167e8d32166dC5eFBD
  • Reserve Coin Address: 0xc61ac381F4F585fd194D3C5cE20B76826b960e5E

70-72: All faucet URLs are currently accessible and return HTTP 200 responses. No action required.

env/sepolia-tefnut.env (4)

1-21: LGTM! Environment configuration is well-structured.

The environment file contains all necessary configuration variables for the Sepolia Tefnut deployment with clear naming conventions and proper formatting.


21-21: No action needed. The file Logo_symbol.png exists at public/Logo_symbol.png, which is the correct location for React static assets referenced by the REACT_APP_LOGO_PATH environment variable.


4-6: Verify the Djed contract is deployed on Sepolia at the specified address.

Confirm that 0x624FcD0a1F9B5820c950FefD48087531d38387f4 is actually deployed on Sepolia (chain ID 11155111). You can verify this by querying the RPC endpoint at https://ethereum-sepolia.publicnode.com/ using an eth_getCode call, checking a block explorer like Sepolia Etherscan, or reviewing the deployment logs for this contract address.


18-19: Verify reserve and stablecoin token contracts are deployed on Sepolia testnet.

The following contract addresses should be confirmed as deployed and functional:

  • Reserve Coin (SHEN): 0xc61ac381F4F585fd194D3C5cE20B76826b960e5E
  • Stablecoin (DJED): 0x6b930182787F346F18666D167e8d32166dC5eFBD

This can be verified by checking the addresses on Sepolia block explorers (e.g., Etherscan Sepolia) to ensure contract code exists at these locations.

setup-env.sh (1)

1-59: The review comment is based on an incorrect premise. All six environment files referenced in the setup-env.sh script exist in the repository:

  • env/sepolia-tefnut.env ✓
  • env/sepolia.env ✓
  • env/milkomeda.env ✓
  • env/milkomeda-testnet.env ✓
  • env/ethereum-classic.env ✓
  • env/mordor.env ✓

Users will not encounter "file not found" errors when selecting any menu option. The script functions as intended.

Likely an incorrect or invalid review comment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Adapting Djed Tefnut frontend to work with deployed Djed Tefnut on Sepolia

1 participant