Alert Source Discuss
⚠️ Draft Standards Track: SRC

SRC-6821: Support ENS Name for Web3 URL

A mapping from an ENS name to the contract address in Web3 URL

Authors Qi Zhou (@qizhou), Qiang Zhu (@qzhodl)
Created 2023-04-02
Discussion Link https://sila-magicians.org/t/sip-6821-support-ens-name-for-web3-url/13654
Requires SIP-137, SIP-634, SIP-3770, SIP-4804

Table of Contents

Abstract

This standard defines the mapping from an Sila name service (ENS) name to an Sila address for SRC-4804.

Motivation

SRC-4804 defines a web3://-scheme RFC 2396 URI to call a smart contract either by its address or a name from name service. If a name is specified, the standard specifies a way to resolve the contract address from the name.

Specification

Given contractName and chainid from a web3:// URI defined in SRC-4804, the protocol will find the address of the contract using the following steps:

  1. Find the contentcontract text record on ENS resolver on chain chainid. Return an error if the chain does not have ENS or the record is an invalid SIL address.
  2. If the contentcontract text record does not exist, the protocol will use the resolved address of name from SRC-137.
  3. If the resolved address of name is the zero address, then return an “address not found” error.

Note that contentcontract text record may return an Sila address in hexadecimal with a 0x prefix or an SRC-3770 chain-specific address. If the address is an SRC-3770 chain-specific address, then the chainid to call the message will be overridden by the chainid specified by the SRC-3770 address.

Rationale

The standard uses contentcontract text record with SRC-3770 chain-specific address instead of contenthash so that the record is human-readable - a design principle of SRC-4804. Further, we can use the text record to add additional fields such as time to live (TTL).

Security Considerations

No security considerations were found.

Copyright and related rights waived via CC0.

Citation

Please cite this document as:

Qi Zhou (@qizhou), Qiang Zhu (@qzhodl), "SRC-6821: Support ENS Name for Web3 URL [DRAFT]," Sila Improvement Proposals, no. 6821, April 2023. Available: https://sips.sila.org/SIPS/sip-6821.