API Documentation

Get DLT Instance Details

GET /api/v1/dlt-instances/{id}

Get comprehensive information about a specific DLT instance (blockchain) including all projects using it and supported DID methods.

Request

Path Parameters

Parameter Type Required Description
id integer Yes DLT instance ID

Example Request

bash 
# Get details for DLT instance ID 2 (Ethereum)
curl -X GET "https://www.weboftrust.org/api/v1/dlt-instances/2" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Response Schema

typescript 
interface DltInstanceDetail {
  // Basic Information
  id: number;
  name: string;
  website?: string;
  logo_url?: string;
  block_explorer?: string;  // Block explorer URL
  
  // Underlying DLT Technology
  dlt?: {
    id: number;
    title: string;
    website?: string;
  };
  
  // Operating Entity
  operator?: {
    id: number;
    name: string;
  };
  
  // AI-generated description
  ai_description?: string;
  
  // Projects using this blockchain
  projects?: Array<{
    project: {
      id: number;
      title: string;
      type?: string;
      website?: string;
    };
    source?: string;  // URL confirming usage
  }>;
  
  // DID methods supported
  did_methods?: Array<{
    did_method: {
      id: number;
      name: string;
      specification_url?: string;
    };
    source?: string;
    archived_source?: string;
  }>;
}

Example Response

json 
{
  "id": 2,
  "name": "Ethereum",
  "website": "https://ethereum.org/en/",
  "logo_url": "https://weboftrust.org/icons-overwrite/ethereum.org.png",
  "block_explorer": "https://etherscan.io/",
  "dlt": {
    "id": 1,
    "title": "Ethereum",
    "website": "https://ethereum.org/en/"
  },
  "operator": null,
  "ai_description": "Ethereum Mainnet is the primary public blockchain for the Ethereum network, launched in July 2015. It serves as the foundation for decentralized applications (dApps) and smart contracts, using Ether (ETH) as its native cryptocurrency.",
  "projects": [
    {
      "project": {
        "id": 108,
        "title": "Rohingya Project",
        "type": "DID Project",
        "website": "https://rohingyaproject.com/r-id/"
      },
      "source": "https://archive.ph/3XRB5#selection-677.194-677.381"
    },
    {
      "project": {
        "id": 237,
        "title": "Hyland Experience Credentials",
        "type": "DID Project",
        "website": "https://www.hyland.com/en/products/hyland-experience-credentials"
      },
      "source": "https://archive.ph/3dNhH#selection-305.0-305.291"
    },
    {
      "project": {
        "id": 118,
        "title": "TradeTrust",
        "type": "DID Project",
        "website": "https://www.tradetrust.io/"
      },
      "source": "https://archive.ph/QD2fF#selection-1831.0-1818.14"
    }
  ],
  "did_methods": [
    {
      "did_method": {
        "id": 1738169371476,
        "name": "ethr",
        "specification_url": "https://github.com/decentralized-identity/ethr-did-resolver/blob/master/doc/did-method-spec.md"
      },
      "source": null,
      "archived_source": null
    }
  ]
}

Error Responses

400 Bad Request

Invalid ID parameter

json 
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid DLT instance ID"
  }
}

404 Not Found

DLT instance not found

json 
{
  "error": {
    "code": "not_found",
    "message": "DLT instance not found"
  }
}

500 Internal Server Error

json 
{
  "error": {
    "code": "internal_error",
    "message": "Failed to fetch DLT instance details"
  }
}

Field Descriptions

  • name: The specific blockchain network name
  • website: Official website of the blockchain
  • block_explorer: URL to the blockchain explorer for viewing transactions
  • dlt: The underlying DLT technology this instance is based on
  • operator: Organization that manages or governs this blockchain
  • ai_description: AI-generated explanation of the blockchain's purpose and features
  • projects: List of all projects building on this blockchain
  • did_methods: DID methods that are compatible with this blockchain

Common DLT Instances

Ethereum-based

  • Ethereum - Main Ethereum network
  • Polygon - Ethereum Layer 2 scaling solution
  • Arbitrum - Ethereum Layer 2 rollup
  • Optimism - Ethereum Layer 2 optimistic rollup

Hyperledger Indy-based

  • Sovrin - Global public identity network
  • IDunion - European identity network
  • Indicio - Professional credentialing network

Other Platforms

  • Bitcoin - Original cryptocurrency blockchain
  • Algorand - High-performance blockchain
  • Stellar - Financial services blockchain
  • Hedera Hashgraph - Enterprise DLT platform

Network Characteristics

Public vs Private

  • Public: Open participation, transparent (Ethereum, Bitcoin)
  • Permissioned: Controlled access, known validators (Sovrin, IDunion)
  • Private: Closed networks for specific organizations

Consensus Mechanisms

  • Proof of Stake (PoS): Ethereum, Polygon
  • Proof of Authority (PoA): Many enterprise networks
  • PBFT variants: Hyperledger Indy networks
  • Proof of Work (PoW): Bitcoin

Use Cases

  • Platform Selection: Choose the right blockchain for your project
  • Compatibility Check: Verify DID method support
  • Project Discovery: Find other projects on the same blockchain
  • Technical Research: Access blockchain specifications and explorers
  • Partnership Opportunities: Connect with projects on shared infrastructure

Performance Notes

  • Response includes all projects using this blockchain
  • DID method associations show blockchain compatibility
  • AI descriptions provide context for decision-making
  • Results are cached for performance