Deploying Token Registry (Code)

For the current step, you can either opt to use the CLI or Code.

The token registry is a smart contract on the blockchain network that records the ownership and holdership information of a transferable record.

The Token Registry is a Soulbound Token (SBT) tied to the Title Escrow. The SBT implementation is loosely based on OpenZeppelin's implementation of the ERC721 standard. An SBT is used in this case because the token, while can be transferred to the registry, is largely restricted to its designated Title Escrow contracts.

In this guide, we will deploy a token registry smart contract on the Ethereum blockchain, sepolia network which is a test network that does not require actual ethers for transactions.

Installation

npm install --save @tradetrust-tt/tradetrust-core

Usage

To use the package, you will need to provide your own Web3 provider or signer (if you are writing to the blockchain).

Refer to the pre-requisite on setup instructions.

Deploy a token registry

import {
    TDocDeployer__factory,
    TOKEN_REG_CONSTS,
    DeploymentEvent,
    encodeInitParams,
    getEventFromReceipt,
} from '@tradetrust-tt/tradetrust-core'
import { Wallet, ethers } from 'ethers'

    // preparing the wallet
    const unconnectedWallet = new Wallet('<your_private_key>')
    const provider = new ethers.providers.JsonRpcProvider('<your_provider_url>')
    const wallet = unconnectedWallet.connect(provider)
    const walletAddress = await wallet.getAddress()
    const chainId = await wallet.getChainId()

    // deploy standard token registry
    const { TokenImplementation, Deployer } = TOKEN_REG_CONSTS.contractAddress
    const deployerContract = TDocDeployer__factory.connect(
        Deployer[chainId],
        wallet
    )
    const initParam = encodeInitParams({
        name: 'DemoTokenRegistry',
        symbol: 'DTR',
        deployer: walletAddress,
    })
    const tx = await deployerContract.deploy(
        TokenImplementation[chainId],
        initParam
    )
    const receipt = await tx.wait()
    const registryAddress = getEventFromReceipt<DeploymentEvent>(
        receipt,
        deployerContract.interface.getEventTopic('Deployment')
    ).args.deployed

console.log(`Contract Address: ${registryAddress}`); // Contract Address: 0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72
console.log(`Transaction: ${JSON.stringify(receipt)}`);

// Transaction:
{
  "to": "0x9eBC30E7506E6Ce36eAc5507FCF0121BaF7AeA57",
  "from": "0xE94E4f16ad40ADc90C29Dc85b42F1213E034947C",
  "contractAddress": null,
  "transactionIndex": 16,
  "gasUsed": { "type": "BigNumber", "hex": "0x049f18" },
  "logsBloom": "0x00000004000000800000000000008000000001000004000000000001000000000000000022000000000002000000004100000000000000000000000000000000000000000000000000000000000000000000000018000000000000000001000000000000020000000000000000000800001000001000000000000000001000000000000000000000000000000000000000000000000000000000000800800080000000800000000000000000000000000000000000001000001100800000000000000000000000000000000000000000001000000000000100000000000020000000000000000000000000400100000000400000004400400000000000000000",
  "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0",
  "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
  "logs": [
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0x0000000000000000000000000000000000000000000000000000000000000000",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 22,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 23,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0x4aca127bf16f434830a404b92851a3555910944351935eae88740d1cef5ffaad",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 24,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0xe5fe4715ff8709ff44f5e6bb664620f9349f5f6ae81a532eba2a43b9598ba7eb",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 25,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x9eBC30E7506E6Ce36eAc5507FCF0121BaF7AeA57",
      "topics": [
        "0x3588ebb5c75fdf91927f8472318f41513ee567c2612a5ce52ac840dcf6f162f5",
        "0x0000000000000000000000007ae2ae35f66ace6671cb2bfb985011b0a2d9cf72",
        "0x000000000000000000000000c78ba1a49663ef8b920f36b036e91ab40d8f26d6",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c"
      ],
      "data": "0x0000000000000000000000005aa71cc9559bc5e54e9504a81496d9f8454721f5000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c00000000000000000000000000000000000000000000000000000000000000135465737420546f6b656e2052656769737472790000000000000000000000000000000000000000000000000000000000000000000000000000000000000000035454520000000000000000000000000000000000000000000000000000000000",
      "logIndex": 26,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    }
  ],
  "blockNumber": 4748754,
  "confirmations": 1,
  "cumulativeGasUsed": { "type": "BigNumber", "hex": "0x2a1f57" },
  "effectiveGasPrice": { "type": "BigNumber", "hex": "0x95cf50f7" },
  "status": 1,
  "type": 2,
  "byzantium": true,
  "events": [
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0x0000000000000000000000000000000000000000000000000000000000000000",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 22,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 23,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0x4aca127bf16f434830a404b92851a3555910944351935eae88740d1cef5ffaad",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 24,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
      "topics": [
        "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
        "0xe5fe4715ff8709ff44f5e6bb664620f9349f5f6ae81a532eba2a43b9598ba7eb",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c",
        "0x0000000000000000000000009ebc30e7506e6ce36eac5507fcf0121baf7aea57"
      ],
      "data": "0x",
      "logIndex": 25,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0"
    },
    {
      "transactionIndex": 16,
      "blockNumber": 4748754,
      "transactionHash": "0x8d4dcd3ca9880b0d3766f10f4d18624f4bbd6f24dca0164224fef8c828ac5b02",
      "address": "0x9eBC30E7506E6Ce36eAc5507FCF0121BaF7AeA57",
      "topics": [
        "0x3588ebb5c75fdf91927f8472318f41513ee567c2612a5ce52ac840dcf6f162f5",
        "0x0000000000000000000000007ae2ae35f66ace6671cb2bfb985011b0a2d9cf72",
        "0x000000000000000000000000c78ba1a49663ef8b920f36b036e91ab40d8f26d6",
        "0x000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c"
      ],
      "data": "0x0000000000000000000000005aa71cc9559bc5e54e9504a81496d9f8454721f5000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c00000000000000000000000000000000000000000000000000000000000000135465737420546f6b656e2052656769737472790000000000000000000000000000000000000000000000000000000000000000000000000000000000000000035454520000000000000000000000000000000000000000000000000000000000",
      "logIndex": 26,
      "blockHash": "0x4f4690291896d3fa81bd89d89c58a923629ed967acef960f9c3c497d253db7f0",
      "args": [
        "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72",
        "0xC78BA1a49663Ef8b920F36B036E91Ab40D8F26D6",
        "0xE94E4f16ad40ADc90C29Dc85b42F1213E034947C",
        "0x5aA71Cc9559bC5e54E9504a81496d9F8454721F5",
        "0x000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000e94e4f16ad40adc90c29dc85b42f1213e034947c00000000000000000000000000000000000000000000000000000000000000135465737420546f6b656e2052656769737472790000000000000000000000000000000000000000000000000000000000000000000000000000000000000000035454520000000000000000000000000000000000000000000000000000000000"
      ],
      "event": "Deployment",
      "eventSignature": "Deployment(address,address,address,address,bytes)"
    }
  ]
}

Save your token registry address for future reference!

Connecting to token registry

import { TradeTrustToken__factory } from "@tradetrust-tt/tradetrust-core";

const privateKey = "";
const tokenRegistryAddress = "0x7Ae2aE35f66ACE6671CB2bfb985011b0a2d9cf72";

// preparing the wallet
const unconnectedWallet = new Wallet("<your_private_key>");
const provider = new ethers.providers.JsonRpcProvider("<your_provider_url>");
const wallet = unconnectedWallet.connect(provider);

const connectedRegistry = TradeTrustToken__factory.connect(tokenRegistryAddress, wallet);
console.log(await connectedRegistry.name()); // Test Token Registry

Congratulations! You have successfully deployed a token registry.

Next we take a look at configuring the DNS.