Skip to main content

Configuration

Before you can create electronic Bills of Lading, you must complete the configuration process. This involves connecting your wallet, creating a token registry, and setting up DNS records.

1. Connect Wallet​

The first step is to connect your blockchain wallet to easyBL.

Why Connect a Wallet?​

Your wallet is required to:

  • Sign and issue electronic Bills of Lading
  • Transfer eBLs securely on the blockchain
  • Verify document authenticity
  • Maintain cryptographic proof of ownership

Steps to Connect Wallet​

  1. Click on Connect Wallet from the left sidebar
  2. Select your preferred wallet type:
    • MetaMask
    • WalletConnect
    • Other Web3 wallets
  3. Follow the wallet connection prompts
  4. Approve the connection request in your wallet
  5. Once connected, your wallet address will be displayed

Connect Wallet

💡 Tip: Make sure you're connected to the correct network (Ethereum, Polygon, or other supported chains).

2. Create Token Registry​

After connecting your wallet, you need to create a token registry. The token registry is a smart contract that manages your eBLs on the blockchain.

What is a Token Registry?​

A token registry is:

  • A blockchain-based smart contract
  • The issuer of your electronic Bills of Lading
  • The authority that validates your eBLs
  • Required for MLETR compliance

Steps to Create Token Registry​

  1. Navigate to Config from the sidebar
  2. Click on Create Token Registry button
  3. Review the gas fees
  4. Click Create and confirm the transaction in your wallet
  5. Wait for the blockchain confirmation (may take 1-2 minutes)

Create Token Registry

⚠️ Important: Save your token registry address. You'll need it for DNS configuration.

3. Configure DNS Records​

After creating your token registry, you'll receive DNS records that must be added to your domain.

Why DNS Configuration?​

DNS records:

  • Link your domain to your token registry
  • Prove ownership of your company domain
  • Enable verification of your eBLs by third parties
  • Required for TradeTrust interoperability

DNS Record Information​

After creating your token registry, you'll see DNS record details like:

Type: TXT Name: _tradetrust-dns.yourdomain.com Value: tradetrust-dns-hash=0x1234567890abcdef...

Steps to Add DNS Records​

  1. Copy the DNS record details provided by easyBL
  2. Log in to your domain registrar or DNS provider:
    • GoDaddy
    • Namecheap
    • Cloudflare
    • AWS Route 53
    • etc.
  3. Navigate to DNS management section
  4. Add a new TXT record with the provided details:
    • Type: TXT
    • Name/Host: _tradetrust-dns (or full subdomain)
    • Value: The hash value provided
    • TTL: 3600 (or default)
  5. Save the DNS record
  6. Wait for DNS propagation (can take 15 minutes to 48 hours)

DNS Configuration

Verify DNS Configuration​

  1. Return to the Config page in easyBL
  2. Click Verify DNS button
  3. The system will check if your DNS records are properly configured
  4. Once verified, you'll see a success message

💡 Tip: Use online DNS lookup tools to check if your DNS records have propagated.

4. Add Domain​

After your DNS records are verified, you need to add your domain to easyBL.

Steps to Add Domain​

  1. In the Config page, locate the Add Domain section
  2. Enter your domain name (e.g., yourdomain.com)
  3. Click Add Domain
  4. The system will verify that:
    • DNS records are properly configured
    • Domain ownership is confirmed
    • Token registry is linked correctly
  5. Once verified, your domain will be added successfully

Add Domain

5. Configuration Complete​

Once you've completed all the above steps, your configuration is complete! You'll see:

  • ✅ Wallet connected
  • ✅ Token registry created
  • ✅ DNS records configured
  • ✅ Domain added

You can now start creating electronic Bills of Lading.

✅ Next: Proceed to create your first Standard eBL, FIATA eBL, or BIMCO eBL.