Obscuroscan#2323

tools/obscuroscan_v3/frontend/.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

tools/obscuroscan_v3/frontend/.gitignore

@@ -0,0 +1,36 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

tools/obscuroscan_v3/frontend/README.md

@@ -0,0 +1,62 @@
+# Tenscan: Blockchain Explorer for The Encryption Network (TEN)
+
+Tenscan is a Next.js and Tailwind CSS-powered application that serves as a Blockchain Explorer for The Encryption Network (TEN). This explorer allows users to interact with and explore the blocks, transactions, batches, resources, and personal data on the TEN blockchain. Tenscan is built using the Shadcn-UI Component Library for a consistent and visually appealing user interface.
+
+## Folder Structure
+
+```
+📁 Tenscan
+├── 📁 api - Contains server-side code, such as API routes or server logic
+├── 📁 pages - Typically used for Next.js pages. Each .tsx or .js file in this directory becomes a route in your application
+├── 📁 public - This directory is used to serve static assets. Files inside this directory can be referenced in your code with a URL path
+├── 📁 src - Main source code directory for this project
+│   ├── 📁 components - Contains reusable React components used throughout the application
+│   ├── 📁 hooks - Custom React hooks that can be shared and reused across components
+│   ├── 📁 lib - Utility functions or modules that provide common functionalities across the application
+│   ├── 📁 routes - Route-related logic or configuration can be placed in this directory
+│   ├── 📁 services - Used for services that interact with external APIs or handle other data-related tasks
+│   └── 📁 types - Type definitions (.d.ts files or TypeScript files) for TypeScript, describing the shape of data and objects used in the application
+└── 📁 styles - Global styles, stylesheets, or styling-related configurations for this project
+```
+
+## Getting Started
+
+1. **Clone the Repository:**
+   ```bash
+   git clone https://github.com/ten-protocol/go-ten.git
+   cd go-ten/tools/obscuroscan_v3/frontend
+   ```
+
+2. **Install Dependencies:**
+   ```bash
+   npm install
+   ```
+
+3. **Run the Development Server:**
+   ```bash
+   npm run dev
+   ```
+
+   The application will be accessible at [http://localhost:3000](http://localhost:3000).
+
+## Usage
+
+- Visit the different sections of the explorer through the navigation links in the UI.
+- Explore the different blocks, transactions, batches, resources, and personal data on the TEN.
+- View the details of each batch by their hash.
+
+## Built With
+
+- [Next.js](https://nextjs.org/)
+- [Tailwind CSS](https://tailwindcss.com/)
+- [Shadcn-UI](https://shadcn.com/)
+- [TypeScript](https://www.typescriptlang.org/)
+
+
+## Contributing
+
+Contributions are welcome! Please follow our [contribution guidelines](/docs/_docs/community/contributions.md).
+
+## License
+
+This project is licensed under the [GNU Affero General Public License v3.0](/LICENSE).

tools/obscuroscan_v3/frontend/api/batches.ts

@@ -0,0 +1,41 @@
+import { httpRequest } from ".";
+import { apiRoutes } from "@/src/routes";
+import { pathToUrl } from "@/src/routes/router";
+import { ResponseDataInterface } from "@/src/types/interfaces";
+import {
+  Batch,
+  BatchDetails,
+  BatchResponse,
+} from "@/src/types/interfaces/BatchInterfaces";
+
+export const fetchBatches = async (
+  payload?: Record<string, any>
+): Promise<ResponseDataInterface<BatchResponse>> => {
+  const data = await httpRequest<ResponseDataInterface<BatchResponse>>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getBatches),
+    searchParams: payload,
+  });
+  return data;
+};
+
+export const fetchLatestBatch = async (
+  payload?: Record<string, any>
+): Promise<ResponseDataInterface<Batch>> => {
+  const data = await httpRequest<ResponseDataInterface<Batch>>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getLatestBatch),
+    searchParams: payload,
+  });
+  return data;
+};
+
+export const fetchBatchByHash = async (
+  hash: string
+): Promise<ResponseDataInterface<BatchDetails>> => {
+  const data = await httpRequest<ResponseDataInterface<BatchDetails>>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getBatchByHash, { hash }),
+  });
+  return data;
+};

tools/obscuroscan_v3/frontend/api/blocks.ts

@@ -0,0 +1,15 @@
+import { httpRequest } from ".";
+import { apiRoutes } from "@/src/routes";
+import { pathToUrl } from "@/src/routes/router";
+import { ResponseDataInterface } from "@/src/types/interfaces";
+
+export const fetchBlocks = async (
+  payload?: Record<string, any>
+): Promise<ResponseDataInterface<any>> => {
+  const data = await httpRequest<ResponseDataInterface<any>>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getBlocks),
+    searchParams: payload,
+  });
+  return data;
+};

tools/obscuroscan_v3/frontend/api/contracts.ts

@@ -0,0 +1,27 @@
+import { httpRequest } from ".";
+import { apiRoutes } from "@/src/routes";
+import { pathToUrl } from "@/src/routes/router";
+import { ResponseDataInterface } from "@/src/types/interfaces";
+import { ContractCount } from "@/src/types/interfaces/ContractInterface";
+
+export const fetchContractCount = async (
+  payload?: Record<string, any>
+): Promise<ContractCount> => {
+  const data = await httpRequest<ContractCount>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getContractCount),
+    searchParams: payload,
+  });
+  return data;
+};
+
+export const fetchVerifiedContracts = async (
+  payload?: Record<string, any>
+): Promise<ResponseDataInterface<any>> => {
+  const data = await httpRequest<ResponseDataInterface<any>>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getVerifiedContracts),
+    searchParams: payload,
+  });
+  return data;
+};

tools/obscuroscan_v3/frontend/api/index.ts

@@ -0,0 +1,63 @@
+import axios, { AxiosInstance, AxiosRequestConfig } from 'axios'
+
+type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete'
+
+interface HttpOptions {
+  method?: HttpMethod
+  url: string
+  data?: Record<string, any>
+  params?: Record<string, any>
+  headers?: Record<string, any>
+  timeout?: number
+  responseType?: 'json' | 'arraybuffer' | 'blob' | 'document' | 'text' | undefined
+  download?: boolean
+  searchParams?: Record<string, any>
+}
+
+const baseConfig: AxiosRequestConfig = {
+  // baseURL: process.env.BASE_URL,
+  baseURL: 'http://127.0.0.1:43910',
+  timeout: 10000
+}
+
+export const https: AxiosInstance = axios.create(baseConfig)
+
+export const httpRequest = async <ResponseData>(
+  options: HttpOptions,
+  config: AxiosRequestConfig = {}
+): Promise<ResponseData> => {
+  const {
+    method = 'get',
+    url,
+    data,
+    params,
+    headers,
+    timeout,
+    responseType,
+    searchParams
+  } = options
+  let query = ''
+  if (searchParams) {
+    const filteredParams = Object.fromEntries(
+      Object.entries(searchParams).filter(
+        ([, value]) => value !== undefined && value !== null && value !== ''
+      )
+    )
+    if (Object.keys(filteredParams).length) {
+      query = new URLSearchParams(filteredParams).toString()
+    }
+  }
+
+  const httpConfig: AxiosRequestConfig = {
+    method,
+    url: query ? `${url}?${query}` : url,
+    data,
+    params,
+    headers: { ...(headers || {}) },
+    timeout,
+    responseType: responseType,
+    ...config
+  }
+  const response = await https(httpConfig)
+  return response.data as ResponseData
+}

tools/obscuroscan_v3/frontend/api/rollups.ts

@@ -0,0 +1,28 @@
+import { httpRequest } from ".";
+import { apiRoutes } from "@/src/routes";
+import { pathToUrl } from "@/src/routes/router";
+import { ResponseDataInterface } from "@/src/types/interfaces";
+
+export const fetchRollups = async (
+  payload?: Record<string, any>
+): Promise<ResponseDataInterface<any>> => {
+  const data = await httpRequest<ResponseDataInterface<any>>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getRollups),
+    searchParams: payload,
+  });
+  return data;
+};
+
+export const decryptEncryptedRollup = async ({
+  StrData,
+}: {
+  StrData: string;
+}): Promise<ResponseDataInterface<any>> => {
+  const data = await httpRequest<ResponseDataInterface<any>>({
+    method: "post",
+    url: pathToUrl(apiRoutes.decryptEncryptedRollup),
+    data: { StrData },
+  });
+  return data;
+};

tools/obscuroscan_v3/frontend/api/transactions.ts

@@ -0,0 +1,36 @@
+import { httpRequest } from ".";
+import { apiRoutes } from "@/src/routes";
+import { pathToUrl } from "@/src/routes/router";
+import { ResponseDataInterface } from "@/src/types/interfaces";
+import {
+  TransactionCount,
+  Price,
+  TransactionResponse,
+} from "@/src/types/interfaces/TransactionInterfaces";
+
+export const fetchTransactions = async (
+  payload?: Record<string, any>
+): Promise<ResponseDataInterface<TransactionResponse>> => {
+  const data = await httpRequest<ResponseDataInterface<TransactionResponse>>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getTransactions),
+    searchParams: payload,
+  });
+  return data;
+};
+
+export const fetchTransactionCount = async (): Promise<TransactionCount> => {
+  const data = await httpRequest<TransactionCount>({
+    method: "get",
+    url: pathToUrl(apiRoutes.getTransactionCount),
+  });
+  return data;
+};
+
+export const fetchEtherPrice = async (): Promise<Price> => {
+  const data = await httpRequest<Price>({
+    method: "get",
+    url: apiRoutes.getEtherPrice,
+  });
+  return data;
+};

tools/obscuroscan_v3/frontend/components.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.js",
+    "css": "app/globals.css",
+    "baseColor": "slate",
+    "cssVariables": true
+  },
+  "aliases": {
+    "components": "@/src/components",
+    "utils": "@/src/lib/utils"
+  }
+}

tools/obscuroscan_v3/frontend/next.config.js

@@ -0,0 +1,6 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+}
+
+module.exports = nextConfig