Rootstock Name Service (RNS) Integration Guide(Hacktivator task)

[Ileolami]

Rootstock Name Service (RNS) Integration Guide

Added a complete guide that walks developers through integrating Rootstock Name Service (RNS) into a React application. The guide covers an overview of RNS and why it matters, setup, domain resolution, reverse lookups, ownership checks, and availability validation using Web3 and the RNS SDK.

Description

This update introduces a detailed, step-by-step guide explaining how to connect a React frontend to the Rootstock Name Service (RNS). The goal is to help developers easily interact with RNS features such as resolving RSK and Bitcoin addresses, checking domain and subdomain availability, retrieving domain owners, and performing reverse lookups.

This change provides clear examples, code snippets, and explanations that simplify RNS integration for developers building dApps or tools on the Rootstock blockchain.

This addition resolves the lack of documentation on practical RNS integration and ensures developers can set up and test RNS functionality locally with minimal configuration.

Checklist

• [ ✅] I have read and understood the contributing guidelines.
• [ ✅] I have followed the style guide and formatting guidelines.
• [ ✅ I have added appropriate comments to explain the changes.
• [ ✅] I have tested my changes thoroughly.

Refs

• Hactivator Task

Please this guide is not completed yet(remaining smart contract integration and registry method). The reason is that when I follow the guide on the Resolver Readme, I'm getting an error of ABI function not available.

Lastly, the task says I should use ethers.js, but the SDK is only comparable with Web3.js.

[vercel]

@Ileolami is attempting to deploy a commit to the IOV Labs Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
devportal-rootstock	Ready	Preview	Comment	Nov 3, 2025 0:56am

[owans]

Thank you @Ileolami for your hacktivator contribution. Left some comments and suggestions on the PR. Please tag me once completed and I will re-review.

Thank you.

[owans]

Hi @Ileolami,

Any reason for the import statement for the Card component here? Just calling the Card component block is sufficient, no need for the import statement, let me know if there's any issues with using the Card block without the import statement.

[Ileolami]

I got this error "targetLinkUnprefixed?.replace is not a function
TypeError: targetLinkUnprefixed?.replace is not a function" when i removed it

[Ileolami]

I got this error "targetLinkUnprefixed?.replace is not a function
TypeError: targetLinkUnprefixed?.replace is not a function" when i removed it

[Ileolami]

@owans I have fixed and improved the guide. The only thing left for me to add the smart contract integration which I'm still waiting for respond from the team.