← Back to Developer Resources

Example Projects

Run Example Projects

We've created several example projects to help you understand how to build on the Diamondz Shadow blockchain. These examples demonstrate key concepts and patterns for developing applications on our platform.

Getting Started

To run the example projects, you'll need to clone our examples repository:

git clone https://github.com/diamondz-shadow/examples.git
cd examples

Each example project is contained in its own directory with a README file that explains how to run it.

Example Projects

Token Bridge

A simple application demonstrating how to bridge tokens between Ethereum (L1) and Diamondz Shadow (L2).

Reactethers.jsNext.js
View Example

Contribution Tracker

An application for submitting and tracking contributions to the Diamondz Shadow ecosystem.

ReactTypeScriptHardhat
View Example

YouTube Oracle Integration

A demonstration of how to integrate with the YouTube Oracle to access on-chain YouTube metrics.

ReactSolidityChainlink
View Example

Cross-Domain Messaging

An example showing how to send messages between Ethereum (L1) and Diamondz Shadow (L2).

Solidityethers.jsHardhat
View Example

Full-Stack Applications

Contribution Marketplace

A full-stack application for posting, claiming, and validating contributions to the Diamondz Shadow ecosystem.

Next.jsTypeScriptTailwind CSS
View Example

YouTube Metrics Dashboard

A dashboard for visualizing YouTube metrics from the Diamondz Shadow blockchain.

ReactD3.jsethers.js
View Example

Running the Examples

Each example project includes detailed instructions in its README file. Here's a general overview of how to run them:

  1. Navigate to the example directory:

    cd examples/token-bridge
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Configure environment variables:

    cp .env.example .env
    # Edit .env with your preferred editor
    nano .env
  4. Run the example:

    npm run dev
    # or
    yarn dev

Contributing

We welcome contributions to our example projects! If you have an idea for a new example or want to improve an existing one, please follow these steps:

  1. Fork the repository on GitHub
  2. Create a new branch for your feature
  3. Make your changes
  4. Submit a pull request

Please make sure your code follows our coding standards and includes appropriate documentation.

Need Help?

If you have questions about the examples or need assistance, you can reach out to our developer community:

  • GitHub - Open issues or contribute to our repositories
  • Discord - Join our developer community
  • Email Support - Contact our developer relations team