Nonprofit Pizza Maker

    elpackagedejavi
    TypeScript icon, indicating that this package has built-in type declarations

    1.8.0 • Public • Published

    rns-js

    npm version CircleCI

    RNS JavaScript library.

    npm i web3 @rsksmart/rns
    

    Types are exposed under '@rsksmart/rns/types'

    Or just use it directly in your webpage:

    <script src="https://unpkg.com/web3@1.2.6/dist/web3.min.js"></script>
    <script src="https://unpkg.com/@rsksmart/rns@1.7.0/lib/rns.min.js"></script>
    

    Don't forget to specify the desired version of the package!

    Basic usage

    Instance de library:

    import Web3 from 'web3'
    import RNS from '@rsksmart/rns'
    import { ChainId } from '@rsksmart/rns/types'
     
    const web3 = new Web3('https://public-node.rsk.co')
    const rns = new RNS(web3)

    Get an address:

    rns.addr('testing.rsk').then(console.log)

    Get Bitcoin address:

    rns.addr('testing.rsk', ChainId.BITCOIN).then(console.log)

    Check if testing.rsk domain is available:

    rns.available('testing.rsk').then(console.log)

    Check if example.testing.rsk subdomain is available:

    rns.subdomains.available('testing.rsk', 'example').then(console.log)

    Reverse lookup: get name of a given address:

    rns.reverse('0x0000000000000000000000000000000123456789').then(console.log)

    Check out more operations details in the RSK Developers Portal.

    Advanced usage

    Use Web3 Contract directly

    async function myCustomGetOwner(domain) {
      const web3 = new Web3('https://public-node.rsk.co')
      const rns = new RNS(web3)
     
      await rns.compose()
     
      const owner = await rns.contracts.registry.methods.owner(domain).call()
     
      return owner;
    }

    Run for development

    Install dependencies:

    git clone git@github.com:rnsdomains/rns-js.git
    cd rns-js
    npm i
    

    Run tests:

    npm test
    

    Try out your development, create a testing project:

    # in rns-js folder
    npm run build
    npm link
    cd ..
    mkdir rns-js-test
    cd rns-js-test
    npm init
    npm i web3
    npm link @rsksmart/rns
    

    Versioning

    • master branch point to latest release.
    • develop branch contains changes that will apply next release. The first commit after release bumps to next version.
    • Other branches (feature branches) point to develop.

    Find releases scopes in milestones

    Keywords

    Install

    npm i elpackagedejavi

    DownloadsWeekly Downloads

    24

    Version

    1.8.0

    License

    ISC

    Unpacked Size

    2.31 MB

    Total Files

    119

    Last publish

    Collaborators

    • javiesses